1
0
forked from me/IronOS

Update Pinecil logo flashing docs

This commit is contained in:
Ben V. Brown
2020-12-31 12:58:00 +11:00
parent e842f8d292
commit 1b4610c8df
3 changed files with 13 additions and 9 deletions

View File

@@ -1,4 +1,4 @@
name: CI Build all
name: CI
on: [push,pull_request]

View File

@@ -134,13 +134,6 @@ First, check the USB cable your using has the data pins; test it on another devi
Secondly, try other USB ports. Often different USB controllers will interact with the units differently due to design quirks in the miniware design.
## [Miniware] Setting a custom bootup image
This firmware uses a different method of updating the bootup image.
This removes the need for emulating a USB drive on the iron just to allow for a bootup image to be setup.
There are further instructions on the [wiki](https://github.com/Ralim/ts100/wiki/Logo-Editor).
Instructions are kept on the wiki so that users can update the information if they find extra helpful information.
## [Miniware] Alternative bootloader
If you are an advanced user, and you have used `usb-dfu` tools before, or you would like to learn; there is an alternative bootloader for these irons.

View File

@@ -26,4 +26,15 @@ Run `python3 img2ts100.py --help` to see available options.
Upload the HEX file to the iron in DFU mode and, if the file's extension changes to .RDY, your custom splash screen should show up on startup.
You perform this the same way as if you were flashing a new firmware, and all of the existing notes around this apply.
### Pinecil
### Pinecil
For the Pinecil, we require to flash the logo using dfu-util instead, which will only take `.bin` files rather than `.hex`.
To flash the logo, use the following steps:
- `python3 img2ts100.py input.png logo.hex`
- `riscv-nuclei-elf-objcopy -I ihex -O binary logo.hex logo.bin`
- `dfu-util -d 28e9:0189 -a 0 -D logo.bin -s 0x0800f800`
This will use the objcopy tool to convert the hex to a binary file, and then use dfu-util to flash it in the right location.
If you do not have `riscv-nuclei-elf-objcopy` installed, you can generally use any objcopy tool from any toolchain you do have.