From 275d04b03272ca69c1fa32a2dff2de17decd2836 Mon Sep 17 00:00:00 2001 From: "Ben V. Brown" Date: Thu, 31 Dec 2020 12:43:47 +1100 Subject: [PATCH] Destroyed Logo Editor (markdown) --- Logo-Editor.md | 61 -------------------------------------------------- 1 file changed, 61 deletions(-) delete mode 100644 Logo-Editor.md diff --git a/Logo-Editor.md b/Logo-Editor.md deleted file mode 100644 index 4047290..0000000 --- a/Logo-Editor.md +++ /dev/null @@ -1,61 +0,0 @@ -With this software build, the built in USB flash drive emulation was removed. This mostly driven by the use of open source compilers that could not quite fit the emulated flash disk on the image. As well as the drive being made mostly redundant by the menu structure being added to the iron. - -The big loss when removing the USB flash drive was the loss of the custom boot up logo that users loved. This allows you to brand your unit as yours and have a nice logo. - -To bring back the logo support without having to code a smaller version of the USB drive optimization, the software automatically looks in the second last sector of flash to see if a bootup image is programmed there and if so the software will display this on startup. The only catch to this is, how to get the image in the right location initially. - -## Existing Designs - -In the repository there are some community created logos that you are free to use. As well as a logo file to remove the logo from your unit, turning off the logo functionality. [Available Here](https://github.com/Ralim/ts100/tree/master/Bootup%20Logo/Logos) - -## The Logo Editor - -This is a small application written in C# that allows you to load up an image, and it will convert the image to B&W and export a .HEX file. This file can then be programmed to your iron using the DFU mode, the same as upgrading your firmware. - -### Windows - -The .exe file can be downloaded from the releases page and should run on a modern windows machine without any issue. It requires .Net 4.0 which most newer windows OS's include. - -### Linux - -The GUI can be launched directly with mono (`mono TS100.Logo.Editor.exe`). You can also compile it from the sources with `xbuild "TS100 Logo Editor.csproj"`. Depending on your Mono version, if you get `The predefined type ... is not defined or imported` errors, you will have to change `TargetFrameworkVersion` in `TS100 Logo Editor.csproj` to match yours, e.g. from 4.0 to 4.5. - -Wine can also be used to run the executable as well. - -Further information is discussed in issue [41](https://github.com/Ralim/ts100/issues/41) - -### Mac - -The logo editor should run under mono on Mac, similar to Linux. -It does however need to be started in 32 bit mode : -`mono --arch=32 TS100.Logo.Editor.exe` - -### Using the Software - -1. On the [releases page](https://github.com/Ralim/ts100/releases) you will need to download the latest copy of the GUI Tool (*TS100.Logo.Editor.exe*). -2. Launch the TS100 Logo Editor, see above -3. On the tool open the source image that you would like to use as your bootup screen. A resolution of 96x16 is ideal, but you can fill or stretch your logo to fit -4. Colour images are okay, the software will convert them to B&W for you. -5. You can also invert colours if you would prefer. -6. Save the created file as a *.hex* file somewhere. -7. Connect your iron to your computer in DFU mode (same as you would to upgrade firmware — hold A when connecting). -8. Drag the created .hex file for the logo onto the iron to update it with the file. -9. You should be good to go. -10. The image will stay through future updates, but if it ever won't I will put a large warning in the update download on the releases page. This will only occur if the firmware grows significantly larger than it currently is. - -## The Python Logo Converter -The [Python script](https://github.com/Ralim/ts100/blob/master/Bootup%20Logo/python_logo_converter/img2ts100.py) converts an image passed into it on the command line to a HEX file to be uploaded to the iron in DFU mode (similar to the process described above). The image can be in color and any size, but it will be resized and converted to 1-bit color. However, it looks best if you create a 96x16 image in an image editor and color the pixels black or white manually. - -The converter requires at least Python 3 and Pillow (if you don't have it, it will tell you to install PIL, which is an old version of the same thing). See [this page](https://stackoverflow.com/a/20061019/6705343) on StackOverflow about installing it. - -What works can vary, but this command may work: - -`python3 -m pip install Pillow` - -Then, to convert an image: - -`python3 img2ts100.py infile.png outfile.hex` - -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. - -Run `python3 img2ts100.py --help` to see available options. \ No newline at end of file