| 1 |
The Olimex RT1011 board is delivered without firmware. The best option to |
| 2 |
install MicroPython is installing a UF2 bootstrap loader first, which then can be |
| 3 |
used to install and update MicroPython. The bootloader has to be installed |
| 4 |
only once. |
| 5 |
|
| 6 |
For initial deployment of the bootloader a few preparation steps are required, which |
| 7 |
have to be done once. |
| 8 |
|
| 9 |
1. Get the NXP program sdphost for your operating system, e.g. from |
| 10 |
https://github.com/adafruit/tinyuf2/tree/master/ports/mimxrt10xx/sdphost. |
| 11 |
You can also get them from the NXP web sites. |
| 12 |
|
| 13 |
2. Get the UF2 boot-loader package https://github.com/adafruit/tinyuf2/releases/tag/0.21.0/tinyuf2-imxrt1010_evk-0.20.1.zip and extract the files `tinyuf2-imxrt1010_evk-0.21.0.bin` |
| 14 |
. You may as well go for a newer release. |
| 15 |
|
| 16 |
Now you have all files at hand that you will need for updating. |
| 17 |
|
| 18 |
1. Get the firmware file you want to upload with the .uf2 extension from the MicroPython download page. |
| 19 |
|
| 20 |
2. Push and hold the "Boot" button, then press "Reset", and release both buttons. |
| 21 |
|
| 22 |
3. Run the commands: |
| 23 |
|
| 24 |
``` |
| 25 |
sudo ./sdphost -u 0x1fc9,0x0145 -- write-file 0x20206400 tinyuf2-imxrt1010_evk-0.21.0.bin |
| 26 |
sudo ./sdphost -u 0x1fc9,0x0145 -- jump-address 0x20207000 |
| 27 |
``` |
| 28 |
Wait until a drive icon appears on the computer (or mount it explicitly). Then the UF2 bootloader |
| 29 |
is permanently installed. |
| 30 |
|
| 31 |
Using sudo is Linux specific. You may not need it at all, if the access rights are set properly, |
| 32 |
and you will not need it for Windows. |
| 33 |
|
| 34 |
4. Once the upload of the bootloader is finished, push Reset twice. |
| 35 |
|
| 36 |
The bootloader should start and show a drive icon. |
| 37 |
|
| 38 |
5. Copy the .uf2 version of MicroPython to this drive to install or update MicroPython. |
| 39 |
|
| 40 |
A LED on the board will start flickering, indicating that the upload is ongoing. Once the upload |
| 41 |
is complete, the drive icon will disappear. Wait until the LED stops flickering. In rare cases there |
| 42 |
may be an error message coming up, especially when there are only few or no changes in |
| 43 |
the firmware file. Then just repeat the copy. |
| 44 |
|
| 45 |
Once the UF2 bootloader is installed, only steps 4 and 5 are required to deploy MicroPython. If |
| 46 |
MicroPython is already installed, the bootloader can as well be invoked by calling |
| 47 |
`machine.bootloader()`. |
| 48 |
|
| 49 |
If at any time the flash content is corrupted you can always start over from the beginning. |