Mirrored_Repos/free-dmo-stm32
1
0
Fork 0
mirror of https://github.com/free-dmo/free-dmo-stm32 synced 2024-08-30 18:12:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

Improve README.md

Browse Source 
typo fixes,  grammar improvements, layout improvements
This commit is contained in:
Bruno Rohée 2022-04-01 10:50:56 +02:00 committed by GitHub
parent 1f5f3666a9
commit 487c5bf4bf
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 28 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
README.md
View File

@ -6,13 +6,13 @@ Endless freedom for D.MO 550 series label writer printer.
Components needed: Components needed:
* 1x STM32F103 bluepill<br/> * 1 × STM32F103 bluepill<br/>
search for: `STM32F103 bluepill` / `STM32F103 bluepill with STLinkV2` search for: `STM32F103 bluepill` / `STM32F103 bluepill with STLinkV2`
* 2x cable<br/> * 2 × cable<br/>
search for: `6 pin 1.25 mm` / `6pin 1.25mm Wire To Board Connector` / `JST ZH 6pin` search for: `6 pin 1.25 mm` / `6pin 1.25mm Wire To Board Connector` / `JST ZH 6pin`
* 2x resistor `4.7kΩ` * 2 × resistor `4.7kΩ`
## Assembly ## Assembly
@ -34,9 +34,9 @@ Connection to main board:
## Firmware ## Firmware
Option 1: Install required ARM toolchain from distribution Option 1: Install the required ARM toolchain from distribution
* install ARM toolchain from distribution (e.g. on Debian-based GNU/Linux install the gcc-arm-none-eabi and libnewlib-arm-none-eabi packages) * install the ARM toolchain from distribution (e.g. on Debian-based GNU/Linux install the gcc-arm-none-eabi and libnewlib-arm-none-eabi packages)
* run `make` to compile the firmware * run `make` to compile the firmware
@ -44,17 +44,17 @@ Option 2: Install required ARM toolchain GNU Arm Embedded Toolchain from ARM:
* download and unpack from here: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads * download and unpack from here: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads
* open Makefile and modify first line `GCC_PATH` to point to the GNU ARM embedded Toolchain `bin` folder<br/> * open the Makefile and modify the first line `GCC_PATH` to point to the GNU ARM embedded toolchain `bin` folder<br/>
e.g. `GCC_PATH = ../gcc-arm-none-eabi-10.3-2021.07` e.g. `GCC_PATH = ../gcc-arm-none-eabi-10.3-2021.07`
* run `make` to compile the firmware * run `make` to compile the firmware
Option 3: Use the precompiled firmware Option 3: Use the precompiled firmware
* a precompiled firmware binary is avalibale in the `COMPILED_FIRMWARE` folder * a precompiled firmware binary is available in the `COMPILED_FIRMWARE` folder
##Download firmware to STM32F103 bluepill ## Download the firmware to the STM32F103 bluepill board
* after compilation you can find the firmware file `freedmo.bin` in the `build` folder * after compilation you can find the firmware file `freedmo.bin` in the `build` folder
@ -65,7 +65,7 @@ Option 3: Use the precompiled firmware
or or
- Serial download using an UART adapter and ST's `FlashLoader Demonstrator`<br/> - Serial download using an UART adapter and ST's `FlashLoader Demonstrator`<br/>
This is the same procedure as downloading a USB bootloader to the bluepill board:<br/> This is the same procedure as downloading an USB bootloader to the bluepill board:<br/>
https://www.electronicshub.org/how-to-upload-stm32f103c8t6-usb-bootloader<br/> https://www.electronicshub.org/how-to-upload-stm32f103c8t6-usb-bootloader<br/>
Just select the file `freedmo.bin` in "Download from file" (2) Just select the file `freedmo.bin` in "Download from file" (2)
@ -87,26 +87,29 @@ If the original RFID board is also connected and a spool with D.MO RFID tag is f
**Please consider dumping this data and providing it here for others** (see: https://github.com/free-dmo/free-dmo-tag-dump). **Please consider dumping this data and providing it here for others** (see: https://github.com/free-dmo/free-dmo-tag-dump).
D.MO uses it's own Originality Signature (own signing key) which is used to sign the UID of the tag. D.MO uses it's own Originality Signature (own signing key) which is used to sign the UID of the tag.
This is used to only allow D.MO's own SLIX2 tags. However when you can emulate the UID you also can emulate the coressponding signature bytes, you just need to dump them from a valid tag.<br/>(see: https://github.com/free-dmo/free-dmo-tag-dump). This is used to only allow D.MO's own SLIX2 tags. However when you can emulate the UID you also can emulate the corresponding signature bytes, you just need to dump them from a valid tag.<br/>(see: https://github.com/free-dmo/free-dmo-tag-dump).
The firmware contains some D.MO SLIX2 tag dumps which you can choose from: <br/> The firmware contains some D.MO SLIX2 tag dumps which you can choose from: <br/>
file: `Src/main.c` file: `Src/main.c`
`#define SLIX2_TAG_EMU 1` <br/> ~~~ C
`//#define SLIX2_TAG_EMU 2` <br/> #define SLIX2_TAG_EMU 1
`//#define SLIX2_TAG_EMU 3` <br/> //#define SLIX2_TAG_EMU 2
//#define SLIX2_TAG_EMU 3
~~~
It does not matter which TAG_EMU you use. All of them will work for now. Maybe... in future D.MO will release new printer / firmware which might block those UIDs... but then we only need to dump a new spool of labels to get a new and valid UID+signature. It does not matter which TAG_EMU you use. All of them will work for now. Maybe... in future D.MO will release new printer / firmware which might block those UIDs... but then we only need to dump a new spool of labels to get a new and valid UID+signature.
The data about the labels (SKU, size, count, ...) is encoded in the standard SLIX2 data blocks. The data about the labels (SKU, size, count, ...) is encoded in the standard SLIX2 data blocks.
**Inside of this data is no dependency to the UID or signature**. This enables a "mix and match" of SLIX2 tag (UID+signature) and the media data used from the printer. Unfortunately the encoded data uses an unknown CRC32 algorithm which limits us to use exisiting dumped label formats only. **Inside of this data is no dependency to the UID or signature**. This enables a "mix and match" of SLIX2 tag (UID+signature) and the media data used from the printer. Unfortunately the encoded data uses an unknown CRC32 algorithm which limits us to use existing dumped label formats only.
You can choose from the list of included label data by selecting the SKU: <br/> You can choose from the list of included label data by selecting the SKU: <br/>
file: `Src/main.c` file: `Src/main.c`
`#define DMO_SKU S0722430 // 54 x 101 mm, 220 pcs.`<br/> ~~~ C
`//#define DMO_SKU S0722550 // 19 x 51 mm, 500 pcs.` <br/> #define DMO_SKU S0722430 // 54 x 101 mm, 220 pcs.
`//#define DMO_SKU S0722400 // 36 x 89 mm, 50 pcs.` <br/> //#define DMO_SKU S0722550 // 19 x 51 mm, 500 pcs.
//#define DMO_SKU S0722400 // 36 x 89 mm, 50 pcs.
~~~
Happy printing... 😈 Happy printing... 😈