Trail Sheevaplug OpenBSD
From Tmplab
(→Stub de cross-compilation pour sheevaplug) |
(→patches pour libusb) |
||
| Line 120: | Line 120: | ||
== patches pour libusb == | == patches pour libusb == | ||
| - | L'acces au port serie et au port JTAG du sheevaplug se fait via la libftdi, qui utilise la libusb. Pour utiliser simultanément ces deux ports, il faut d'abord récupérer l'arborescence des ports tel qu'indiqué dans la FAQ, puis contruire la libusb de la facon suivante : | + | L'acces au port serie et au port JTAG du sheevaplug se fait via la libftdi, qui utilise la libusb. Pour utiliser simultanément ces deux ports, il faut d'abord récupérer l'arborescence des ports tel qu'indiqué dans la FAQ, récupérer le patch [[Image:Libusb.tgz]] et le décompresser, puis contruire la libusb de la facon suivante : |
<pre> | <pre> | ||
cd /usr/ports/devel/libusb | cd /usr/ports/devel/libusb | ||
make patch | make patch | ||
cd `make show=WRKSRC` | cd `make show=WRKSRC` | ||
| - | patch -Np1 -i ~/libusb | + | patch -Np1 -i ~/libusb.diff |
cd - | cd - | ||
make install | make install | ||
| - | </pre> | ||
| - | |||
| - | voici le patch pour la libusb : | ||
| - | |||
| - | <pre> | ||
| - | diff -Naur a/bsd.c b/bsd.c | ||
| - | --- a/bsd.c Sun Aug 8 22:54:10 2010 | ||
| - | +++ b/bsd.c Sun Aug 8 22:57:16 2010 | ||
| - | @@ -139,7 +139,6 @@ | ||
| - | { | ||
| - | int i; | ||
| - | struct bsd_usb_dev_handle_info *info; | ||
| - | - char ctlpath[PATH_MAX + 1]; | ||
| - | |||
| - | info = malloc(sizeof(struct bsd_usb_dev_handle_info)); | ||
| - | if (!info) | ||
| - | @@ -147,20 +146,23 @@ | ||
| - | dev->impl_info = info; | ||
| - | |||
| - | #ifdef __FreeBSD_kernel__ | ||
| - | - snprintf(ctlpath, PATH_MAX, "%s", dev->device->filename); | ||
| - | + snprintf(dev->ctlpath, PATH_MAX, "%s", dev->device->filename); | ||
| - | #else | ||
| - | - snprintf(ctlpath, PATH_MAX, "%s.00", dev->device->filename); | ||
| - | + snprintf(dev->ctlpath, PATH_MAX, "%s.00", dev->device->filename); | ||
| - | #endif | ||
| - | - dev->fd = open(ctlpath, O_RDWR); | ||
| - | + dev->fd = open(dev->ctlpath, O_RDWR); | ||
| - | if (dev->fd < 0) { | ||
| - | - dev->fd = open(ctlpath, O_RDONLY); | ||
| - | + dev->fd = open(dev->ctlpath, O_RDONLY); | ||
| - | if (dev->fd < 0) { | ||
| - | free(info); | ||
| - | USB_ERROR_STR(-errno, "failed to open %s: %s", | ||
| - | - ctlpath, strerror(errno)); | ||
| - | + dev->ctlpath, strerror(errno)); | ||
| - | } | ||
| - | } | ||
| - | |||
| - | + close(dev->fd); | ||
| - | + dev->fd = -1; | ||
| - | + | ||
| - | /* Mark the endpoints as not yet open */ | ||
| - | for (i = 0; i < USB_MAX_ENDPOINTS; i++) | ||
| - | info->ep_fd[i] = -1; | ||
| - | @@ -199,6 +201,17 @@ | ||
| - | { | ||
| - | int ret; | ||
| - | |||
| - | + if (dev->fd <= 0) { | ||
| - | + dev->fd = open(dev->ctlpath, O_RDWR); | ||
| - | + if (dev->fd < 0) { | ||
| - | + dev->fd = open(dev->ctlpath, O_RDONLY); | ||
| - | + if (dev->fd < 0) { | ||
| - | + USB_ERROR_STR(-errno, "failed to open %s: %s", | ||
| - | + dev->ctlpath, strerror(errno)); | ||
| - | + } | ||
| - | + } | ||
| - | + } | ||
| - | + | ||
| - | ret = ioctl(dev->fd, USB_SET_CONFIG, &configuration); | ||
| - | if (ret < 0) | ||
| - | USB_ERROR_STR(-errno, "could not set config %d: %s", configuration, | ||
| - | @@ -206,6 +219,9 @@ | ||
| - | |||
| - | dev->config = configuration; | ||
| - | |||
| - | + close(dev->fd); | ||
| - | + dev->fd = -1; | ||
| - | + | ||
| - | return 0; | ||
| - | } | ||
| - | |||
| - | @@ -230,6 +246,17 @@ | ||
| - | int ret; | ||
| - | struct usb_alt_interface intf; | ||
| - | |||
| - | + if (dev->fd <= 0) { | ||
| - | + dev->fd = open(dev->ctlpath, O_RDWR); | ||
| - | + if (dev->fd < 0) { | ||
| - | + dev->fd = open(dev->ctlpath, O_RDONLY); | ||
| - | + if (dev->fd < 0) { | ||
| - | + USB_ERROR_STR(-errno, "failed to open %s: %s", | ||
| - | + dev->ctlpath, strerror(errno)); | ||
| - | + } | ||
| - | + } | ||
| - | + } | ||
| - | + | ||
| - | if (dev->interface < 0) | ||
| - | USB_ERROR(-EINVAL); | ||
| - | |||
| - | @@ -243,6 +270,9 @@ | ||
| - | |||
| - | dev->altsetting = alternate; | ||
| - | |||
| - | + close(dev->fd); | ||
| - | + dev->fd = -1; | ||
| - | + | ||
| - | return 0; | ||
| - | } | ||
| - | |||
| - | @@ -442,6 +472,17 @@ | ||
| - | struct usb_ctl_request req; | ||
| - | int ret; | ||
| - | |||
| - | + if (dev->fd <= 0) { | ||
| - | + dev->fd = open(dev->ctlpath, O_RDWR); | ||
| - | + if (dev->fd < 0) { | ||
| - | + dev->fd = open(dev->ctlpath, O_RDONLY); | ||
| - | + if (dev->fd < 0) { | ||
| - | + USB_ERROR_STR(-errno, "failed to open %s: %s", | ||
| - | + dev->ctlpath, strerror(errno)); | ||
| - | + } | ||
| - | + } | ||
| - | + } | ||
| - | + | ||
| - | if (usb_debug >= 3) | ||
| - | fprintf(stderr, "usb_control_msg: %d %d %d %d %p %d %d\n", | ||
| - | requesttype, request, value, index, bytes, size, timeout); | ||
| - | @@ -468,6 +509,9 @@ | ||
| - | if (ret < 0) | ||
| - | USB_ERROR_STR(-errno, "error sending control message: %s", | ||
| - | strerror(errno)); | ||
| - | + | ||
| - | + close(dev->fd); | ||
| - | + dev->fd = -1; | ||
| - | |||
| - | return UGETW(req.ucr_request.wLength); | ||
| - | } | ||
</pre> | </pre> | ||
Revision as of 20:39, 9 September 2010
Contents |
Objectif
- Faire démarrer un kernel ramdisk OpenBSD sur un Sheevaplug, et afficher le dmesg sur le port série.
- Se familiariser avec
- l'architecture physique des ordinateurs
- l'architecture propriétaire ARM
- le debugging JTAG
- la chaine de compilation et le systeme OpenBSD
Modus operandi
Le Code Trail proprement dit commencera le vendredi 1 oct. au soir et se terminera le dimanche 3 oct dans l'apres-midi. Chaque personne qui a des tutos et des docs intéressantes est fortement invitée à les publier ou les référencer sur cette page.
Participants
- dermiste
- James
- phantez
- nizox
Docs
Cross-compilation sur OpenBSD
Il faut d'abord récupérer l'arborescence des sources tel qu'indiqué dans la FAQ 5.3.3, et upgrader le système au snapshot le plus récent (FAQ 5.1 et FAQ 5.3.2).
Il faut ensuite construire la chaine de compilation. Il existe pour cela une infrastructure complète, bien que non documentée. Voici par exemple la procedure a suivre pour une chaine ciblant les machines mvme88k :
# cd /usr/src # TARGET=mvme88k make -f Makefile.cross cross-tools
Vous pouvez aller vous prendre un ou plusieurs café en attendant la fin de la compilation. Votre chaine se retrouvera dans /usr/cross/$TARGET.
Cross-compiler un noyau se fait alors de la meme maniere qu'une compilation standard, à une différence près : il faut rajouter /usr/cross/${TARGET}/usr/${TARGET_ARCH}-unknown-openbsd/bin en tête du PATH. Ce répertoire contient les liens symboliques vers les versions cross- des outils de compilation classiques.
Stub de cross-compilation pour sheevaplug
OpenBSD dispose deja de ports sur ARM. Les headers du port armish semblent convenir pour générer des executables pour le sheevaplug.
# cp -R /usr/src/sys/arch/armish /usr/src/sys/arch/sheeva
Il faut ensuite éditer le fichier /usr/src/Makefile.cross et rajouter ${TARGET} == "sheeva" dans le test qui énumère les différentes cibles basées sur ARM.
Dans un premier temps, il est possible de juste générer la chaine de cross-compilation armish et de l'utiliser telle quelle pour générer des binaires pour sheevaplug.
patches pour omconsole
omconsole est un petit utilitaire écrit par matthieu@ qui permet d'accéder au port série du neo freerunner via la libftdi. Le sheevaplug a le meme circuit que le neo freerunner, il suffit donc de rajouter les options kivonbien (c).
--- omconsole.c.orig Tue Apr 6 23:41:29 2010
+++ omconsole.c Fri Jun 11 11:46:33 2010
@@ -66,18 +66,49 @@ interrupt(int sig)
done = 1;
}
+void
+usage()
+{
+ extern char * __progname;
+
+ fprintf(stderr, "usage: %s [-v vid] [-p pid] [-s speed]\n", __progname);
+ exit(1);
+}
+
int main(int argc, char **argv)
{
struct termios tio, saved_tio;
int ret;
+ int ch;
+ int vid = 0x1457;
+ int pid = 0x5118;
+ int speed = 115200;
+ while ((ch = getopt(argc, argv, "v:p:s:")) != -1) {
+ switch (ch) {
+ case 'v':
+ vid = (int)strtol(optarg, NULL, 0);
+ break;
+ case 'p':
+ pid = (int)strtol(optarg, NULL, 0);
+ break;
+ case 's':
+ speed = (int)strtol(optarg, NULL, 0);
+ break;
+ default:
+ usage();
+ /* NOTREACHED */
+ }
+ }
+
ftdi_init(&ftdic);
- if((ret = ftdi_usb_open(&ftdic, 0x1457, 0x5118)) < 0)
+ fprintf(stderr, "opening %d:%d\n", vid, pid);
+ if((ret = ftdi_usb_open(&ftdic, vid, pid)) < 0)
errx(2, "unable to open ftdi device: %d (%s)\n",
ret, ftdi_get_error_string(&ftdic));
ftdi_set_interface(&ftdic, INTERFACE_B);
- ftdi_set_baudrate(&ftdic, 115200);
+ ftdi_set_baudrate(&ftdic, speed);
tcgetattr(fileno(stdin), &tio);
memcpy(&saved_tio, &tio, sizeof(struct termios));
configuration d'OpenOCD
source [find board/sheevaplug.cfg] gdb_port 4453 tcl_port 4456 telnet_port 4454 arm7_9 fast_memory_access enable
patches pour libusb
L'acces au port serie et au port JTAG du sheevaplug se fait via la libftdi, qui utilise la libusb. Pour utiliser simultanément ces deux ports, il faut d'abord récupérer l'arborescence des ports tel qu'indiqué dans la FAQ, récupérer le patch Image:Libusb.tgz et le décompresser, puis contruire la libusb de la facon suivante :
cd /usr/ports/devel/libusb make patch cd `make show=WRKSRC` patch -Np1 -i ~/libusb.diff cd - make install
test de la chaine
Installez, à l'aide des documents ci dessus, la chaine de cross-compilation pour sheevaplug, la libusb patchée, omconsole patché, et openocd.
Récupérez Image:Test chaine sheeva.tgz et décompressez l'archive. Elle devrait contenir les fichiers suivants :
- init.S
- main.c
- ldscript
- Makefile
Cette commande devrait compiler l'ensemble :
PATH=/usr/cross/armish/usr/arm-unknown-openbsd`uname -r`/bin:$PATH make
Maintenant branchez le sheevaplug, et lancez OpenOCD depuis le repertoire contenant les binaires juste produits. Connectez vous sur la console telnet et chargez l'image elf avec les commandes suivantes :
reset halt load_image bare.elf resume 0x15000000
Normalement, la LED bleue du sheevaplug devrait clignoter.
Vous pouvez changer la valeur de delay. Pour cela récupérez l'adresse mémoire de delay avec readelf -s, et utilisez la console telnet d'OpenOCD pour changer sa valeur.
mww <adresse de delay en hexadécimal> <nouvelle valeur de delay en hexadecimal>
Datasheets
Dans la mesure du possible, épluchez un peu ces docs avant le trail.
- hardware 88f6281
- programmation du 88f6281
- reference design du sheevaplug
- schemas du sheevaplug
- manuel de reference ARMv5 ATTENTION, enregistrement nécessaire.

