From 1b4610c8df32afc354cf0ab6746342518719e059 Mon Sep 17 00:00:00 2001 From: "Ben V. Brown" Date: Thu, 31 Dec 2020 12:58:00 +1100 Subject: [PATCH] Update Pinecil logo flashing docs --- .github/workflows/push.yml | 2 +- Documentation/Flashing.md | 7 ------- Documentation/Logo.md | 13 ++++++++++++- 3 files changed, 13 insertions(+), 9 deletions(-) diff --git a/.github/workflows/push.yml b/.github/workflows/push.yml index 2cc00616..7731cbe3 100644 --- a/.github/workflows/push.yml +++ b/.github/workflows/push.yml @@ -1,4 +1,4 @@ -name: CI Build all +name: CI on: [push,pull_request] diff --git a/Documentation/Flashing.md b/Documentation/Flashing.md index 2a13a6dd..86fccc2d 100644 --- a/Documentation/Flashing.md +++ b/Documentation/Flashing.md @@ -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. diff --git a/Documentation/Logo.md b/Documentation/Logo.md index 1581d518..500c1832 100644 --- a/Documentation/Logo.md +++ b/Documentation/Logo.md @@ -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 \ No newline at end of file +### 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.