Trail Sheevaplug OpenBSD

From Tmplab

(Difference between revisions)
Jump to: navigation, search
(more docs)
(test de la chaine)
Line 40: Line 40:
# cp -R /usr/src/sys/arch/gumstix /usr/src/sys/arch/sheeva
# cp -R /usr/src/sys/arch/gumstix /usr/src/sys/arch/sheeva
 +
 +
Il faut ensuite éditer le fichier <tt>/usr/src/Makefile.cross</tt> et rajouter <tt>${TARGET} == "sheeva"</tt> dans le test qui énumère les différentes cibles basées sur ARM.
== patches pour omconsole ==
== patches pour omconsole ==
Line 254: Line 256:
}
}
</pre>
</pre>
 +
 +
== 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. Dans un répertoire, créez les fichiers suivants :
 +
* init.S
 +
 +
.text
 +
.globl _start
 +
_start:
 +
mov sp, #0x10000000
 +
add sp, sp, #0xa00000
 +
 +
b cstart
 +
 +
* main.c
 +
#define MPPCTL6 *((volatile unsigned long *)0xF1010018)
 +
#define GPIODOH *((volatile unsigned long *)0xF1010140)
 +
#define GPIODOECH *((volatile unsigned long *)0xF1010144)
 +
 +
void setup_window() {
 +
*((volatile unsigned long *)0xD0020080) = 0xF1000000;
 +
}
 +
 +
void cstart(void)
 +
{
 +
int i;
 +
MPPCTL6 &= 0xffffff0f; /* set mpp49 as GPIO */
 +
GPIODOECH &= 0xfffdffff ; /* set GPIO49 as output */
 +
while (1) {
 +
GPIODOH ^= 0x00020000; /* toggle GPIO49 state */
 +
for (i = 0; i < delay; i++); /* wait */
 +
}
 +
}
 +
 +
* ldscript
 +
SECTIONS
 +
{
 +
. = 0x15000000;
 +
}
 +
 +
* Makefile
 +
bare.bin: bare.elf
 +
objcopy -O binary $> $@
 +
 +
bare.elf: init.S main.c
 +
${CC} -g -Wall -nostdlib $> -o $@ -T ldscript
 +
 +
Cette commande devrait compiler l'ensemble :
 +
PATH=/usr/cross/sheeva/usr/arm-unknown-openbsd`uname -r`/bin:$PATH make
 +
 +
Maintenant branchez le sheevaplug, et lancez OpenOCD depuis le repertoire contenant les binaires juste produits.
 +
reset halt
 +
load_image bare.elf
 +
resume 0x15000000
 +
 +
Normalement, la LED du sheevaplug devrait clignoter.
== Datasheets ==
== Datasheets ==

Revision as of 18:41, 11 August 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 gumstix semblent convenir pour générer des executables pour le sheevaplug.

# cp -R /usr/src/sys/arch/gumstix /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.

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, puis contruire la libusb de la facon suivante :

cd /usr/ports/devel/libusb
make patch
cd `make show=WRKSRC`
patch -Np1 -i ~/libusb-ft2232.diff
cd -
make install

voici le patch pour la libusb :

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);
 }

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. Dans un répertoire, créez les fichiers suivants :

  • init.S
.text
.globl _start
_start:
        mov     sp, #0x10000000
        add     sp, sp, #0xa00000

        b       cstart
  • main.c
#define MPPCTL6 *((volatile unsigned long *)0xF1010018)
#define GPIODOH *((volatile unsigned long *)0xF1010140)
#define GPIODOECH *((volatile unsigned long *)0xF1010144)

void setup_window() {
        *((volatile unsigned long *)0xD0020080) = 0xF1000000;
}

void cstart(void)
{
        int i;
        MPPCTL6 &= 0xffffff0f; /* set mpp49 as GPIO */
        GPIODOECH &= 0xfffdffff ; /* set GPIO49 as output */
        while (1) {
                GPIODOH ^= 0x00020000; /* toggle GPIO49 state */
                for (i = 0; i < delay; i++); /* wait */
        }
}
  • ldscript
SECTIONS
{
  . = 0x15000000;
}
  • Makefile
bare.bin: bare.elf
        objcopy -O binary $> $@

bare.elf: init.S main.c
        ${CC} -g -Wall -nostdlib $> -o $@ -T ldscript

Cette commande devrait compiler l'ensemble :

PATH=/usr/cross/sheeva/usr/arm-unknown-openbsd`uname -r`/bin:$PATH make

Maintenant branchez le sheevaplug, et lancez OpenOCD depuis le repertoire contenant les binaires juste produits.

reset halt
load_image bare.elf
resume 0x15000000

Normalement, la LED du sheevaplug devrait clignoter.

Datasheets

Dans la mesure du possible, épluchez un peu ces docs avant le trail.


Personal tools