Skip to content

Commit

Permalink
Update Pinecil logo flashing docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Ralim committed Dec 31, 2020
1 parent e842f8d commit 1b4610c
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 9 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/push.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: CI Build all
name: CI

on: [push,pull_request]

Expand Down
7 changes: 0 additions & 7 deletions Documentation/Flashing.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
13 changes: 12 additions & 1 deletion Documentation/Logo.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

0 comments on commit 1b4610c

Please sign in to comment.