{"id":1775,"date":"2022-05-17T21:42:31","date_gmt":"2022-05-17T19:42:31","guid":{"rendered":"http:\/\/www.fabienm.eu\/wordpress\/?p=1775"},"modified":"2022-09-22T21:41:12","modified_gmt":"2022-09-22T19:41:12","slug":"rust-sur-longan-nano","status":"publish","type":"post","link":"http:\/\/www.fabienm.eu\/wordpress\/2022\/05\/17\/rust-sur-longan-nano\/","title":{"rendered":"Rust sur Longan Nano"},"content":{"rendered":"\n

La Longan Nano<\/a> est une petite carte de la taille d’un pouce munie d’un microcontr\u00f4leur \u00e0 c\u0153ur RISC-V le GD32VF103CBT6<\/a>. Processeur qui est un clone du fameux stm32 de chez ST, MAIS avec un c\u0153ur RISC-V (alors que le stm32 est \u00e0 base de ARM).<\/p>\n\n\n\n

Ce qui est bien avec la Longan Nano c’est que pour $4.90<\/a> il y a absolument tout pour faire du d\u00e9veloppement embarqu\u00e9<\/a>: en plus de l’\u00e9cran oled couleurs et la LED RGB il y a une interface USB (connecteur usb-c) qui permet d’alimenter la carte, la programmer et communiquer par UART. Pour le JTAG par contre il faut un adaptateur externe qui peut cependant \u00eatre tr\u00e8s pratique pour utiliser un debugger<\/a>.<\/p>\n\n\n\n

Ce qui est moins bien par contre c’est qu’elle semble en rupture de stock depuis longtemps.<\/a><\/p>\n\n\n\n

Bref, c’est une \u00abvieille\u00bb carte mais qui est parfaite pour faire du d\u00e9veloppement embarqu\u00e9 sans rien d’autre qu’un PC et un c\u00e2ble USB. <\/p>\n\n\n\n

Pourquoi ne pas tenter de faire du Rust avec alors ? En plus il semble exister des projets de support du langage pour cette carte<\/a>. Voila qui pourrait d\u00e9mystifier rust pour l’embarqu\u00e9<\/a> !<\/p>\n\n\n\n

Codons mon bon<\/h2>\n\n\n\n

La documentation officielle<\/a> de la cagette nous demande de v\u00e9rifier la version de rust :<\/p>\n\n\n

$ rustup default<\/span> stable\ninfo<\/span>: using existing install for<\/span> 'stable-x86_64-unknown-linux-gnu'<\/span>\ninfo<\/span>: default<\/span> toolchain set<\/span> to 'stable-x86_64-unknown-linux-gnu'\n\n  stable-x86_64-unknown-linux-gnu unchanged - rustc 1.58.0 (02072b482 2022-01-11)\n<\/code><\/span>Langage du code\u00a0:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Version 1.58, c’est bon on est sup\u00e9rieur \u00e0 la 1.36 requise. Comme je veux travailler avec juste le c\u00e2ble usb j’utiliserais (ou tenterais d’utiliser) dfu-util <\/em>pour programmer le micro. <\/p>\n\n\n\n
Il faut juste se compiler une version des binutils comme indiqu\u00e9 dans la doc pour avoir l’utilitaire objcopy<\/code> :<\/p>\n\n\n
$ git clone https:\/\/github.com\/sifive\/riscv-binutils-gdb.git<\/span>\n$ cd riscv-binutils-gdb\n$ .\/configure --target=riscv64-unknown-elf --disable-werror --with<\/span>-python=no --disable-gdb --disable-sim --disable-libdecnumber --disable-libreadline --with<\/span>-expat=yes --with<\/span>-mpc=no --with<\/span>-mpfr=no --with<\/span>-gmp=no\n$ make<\/code><\/span>Langage du code\u00a0:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
On aura \u00e9galement besoin d’une toolchain riscv:<\/p>\n\n\n
$ wget https:\/\/static.dev.sifive.com\/dev-tools\/riscv64-unknown-elf-gcc-8.1.0-2019.01.0-x86_64-linux-ubuntu14.tar.gz<\/span>\n$ tar zxvf riscv64-unknown-elf-gcc-8.1<\/span>.0<\/span>-2019.01<\/span>.0<\/span>-x86_64-linux-ubuntu14.tar.gz<\/code><\/span>Langage du code\u00a0:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
$ git clone<\/span> https:\/\/github.com\/riscv-rust\/longan-nano.git<\/span>\n$ cd longan-nano\n$ rustup target add riscv32imac-unknown-none-elf<\/code><\/span>Langage du code\u00a0:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Puisque visiblement j’ai une version B du microcontr\u00f4leur il faut modifier le fichier de configuration .cargo\/config.<\/p>\n\n\n\n
Et c’est parti mamie :<\/p>\n\n\n
$ cargo build --examples --release --all-features<\/code><\/span><\/pre>\n\n\n
On extrait maintenant l’huile essentiel de notre binaire avec objcopy que l’on appelera firmware.bin<\/em> :<\/p>\n\n\n
..\/riscv64-unknown-elf-gcc-8.1.0-2019.01.0-x86_64-linux-ubuntu14\/bin\/riscv64-unknown-elf-objcopy -O binary target\/riscv32imac-unknown-none-elf\/release\/examples\/blinky firmware.bin<\/code><\/span><\/pre>\n\n\n
Puis on le t\u00e9l\u00e9charge dans la carte au moyen de dfu-util en ayant bien pris soin de mettre le microcontr\u00f4leur en mode \u00abbootstrap\u00bb ( appui sur reset tout en gardant boot0 press\u00e9).<\/p>\n\n\n
$  dfu-util -a 0 -s 0x08000000:leave -D firmware.bin\ndfu-util 0.10-dev\n\nCopyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.\nCopyright 2010-2021 Tormod Volden and Stefan Schmidt\nThis program is Free Software and has ABSOLUTELY NO WARRANTY\nPlease report bugs to http:\/\/sourceforge.net\/p\/dfu-util\/tickets\/\n\ndfu-util: Warning: Invalid DFU suffix signature\ndfu-util: A valid DFU suffix will be required in a future dfu-util release\ndfu-util: Cannot open DFU device 0a5c:21e6 found on devnum 3 (LIBUSB_ERROR_ACCESS)\nOpening DFU capable USB device...\nDevice ID 28e9:0189\nDevice DFU version 011a\nClaiming USB DFU Interface...\nSetting Alternate Interface #0 ...\nDetermining device status...\nDFU state(2) = dfuIDLE, status(0) = No error condition is present\nDFU mode device DFU version 011a\nDevice returned transfer size 2048\nDfuSe interface name: \"Internal Flash  \"\nFound GD32VF103, which reports a bad page size and count for its internal memory.\nFixed layout based on part number: page size 1024, count 128.\nDownloading element to address = 0x08000000, size = 9388\nErase   \t[=========================] 100%         9388 bytes\nErase    done.\nDownload\t[=========================] 100%         9388 bytes\nDownload done.\nFile downloaded successfully\n<\/code><\/span><\/pre>\n\n\n
Et la led clignote \\o\/ !<\/p>\n\n\n\n
Le code<\/h2>\n\n\n\n
Le code \u00e0 proprement parler du clignotement de led est donn\u00e9 dans le fichier examples\/blinky.rs<\/a><\/p>\n\n\n\n
Et le c\u0153ur de la boucle de clignotement est donn\u00e9e ci-dessous :<\/p>\n\n\n
    let<\/span> mut i = 0<\/span>;\n    loop {\n        let<\/span> inext = (i + 1<\/span>) % leds.len();\n        leds[i].off();\n        leds[inext].on();\n        delay.delay_ms(500<\/span>);\n\n        i = inext;\n    }<\/code><\/span>Langage du code\u00a0:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Il y a trois leds (RGB), on se sert de l’index i pour parcourir le tableau de leds. On \u00e9teint la led courante puis on allume la suivante et on attend 500ms.<\/p>\n\n\n\n
De cette mani\u00e8re, la led va changer de couleur toutes les demi-seconde et nous offrir un clignotement tricolore. <\/p>\n\n\n\n
Si l’on trouve le clignotement on\/off un peu trop violent, on peut, comme exercice faire en sorte que la couleurs s’allume et s’\u00e9teigne progressivement avec un code de ce genre :<\/p>\n\n\n
    leds[0<\/span>].off();\n    leds[1<\/span>].off();\n    leds[2<\/span>].off();\n\n    let<\/span> count_max:u32 = 1000<\/span>;\n    let<\/span> mut count:u32 = 0<\/span>;\n    let<\/span> mut decount: bool = true<\/span>;\n    let<\/span> mut i:usize = 0<\/span>;\n\n    loop {\n        leds[i].on();\n        delay.delay_us(count);\n        leds[i].off();\n        delay.delay_us(count_max - count);\n        if<\/span> decount {\n            if<\/span> count == 0<\/span> {\n                decount = false<\/span>;\n                i = (i + 1<\/span>) % leds.len();\n            } else<\/span> {\n                count = count - 1<\/span>;\n            }\n        } else<\/span> {\n            if<\/span> count < count_max {\n                count = count + 1<\/span>;\n            }else<\/span>{\n                decount = true<\/span>;\n            }\n        }\n    }<\/code><\/span>Langage du code\u00a0:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Voila un clignotement plus doux des LEDs. Et on se rend compte par la m\u00eame occasion que la LED verte est nettement plus puissante que les deux autres.<\/p>\n\n\n\n
On aura bien pris soin de descendre la granularit\u00e9 du d\u00e9lais \u00e0 la microseconde puisque c’est disponible dans le HAL du microcontr\u00f4leur<\/a> (GD32VF103).<\/p>\n\n\n\n
Et bien entendu, il faudra \u00abdescendre\u00bb le projet git hub d’exemples<\/a>:<\/p>\n\n\n
\u00c7a prend un peut de temps avec ma vieille machine (T430<\/a>) mais \u00e7a marche.<\/p>\n\n\n\n