diff --git a/Binary-file-nomenclature.md b/Binary-file-nomenclature.md index bcddb19..9db2f0f 100644 --- a/Binary-file-nomenclature.md +++ b/Binary-file-nomenclature.md @@ -1,44 +1,81 @@ -## For ESP32 binarys (excluding C6), the filename consists of: +## ESP32 binaries +For ESP32 binaries (excluding C6), the filename consists of: +~~~ +PIOenvname[_full].bin +~~~ -*** - -**PIOenvname(_full).bin** - -*** - - -the _full designator is optional. The file with this designator can be flased to the ESP directly and is used by [install.openepaperlink.de](https://install.openepaperlink.de/). Files without this designator are used for OTA updates. +the `_full` designator is optional. The file with this designator can be flashed to the ESP directly and is used by [install.openepaperlink.de](https://install.openepaperlink.de/). Files without this designator are used for over the air (OTA) updates. Examples: +~~~ +OpenEPaperLink_Nano_AP_full.bin +# used to flash via USB OpenEPaperLink_Mini_AP.bin +# used for OTA updates +~~~ -OpenEPaperLink_Nano_AP_full.bin +## Tag binaries -## For Tag binarys (ap and non ap) the filename consists of: +For Tag binaries as found in `binaries/Tag` the filename consists of: +~~~ +_[]_.bin +~~~ -*** - -**nameoftag-tagorap-fullorota-version.bin** - -*** - -Nameoftag: The name of the tag as found in tag_types.h - -Tagorap: If this is firmware for tag operation, this field is "tag", if it is used as an AP, it should be "AP". If the ESP firmware(excluding C6) gets converted to this nomenclature down the line, it could be "esp" for that - -Fullorota: Some tags have different files for OTA and direct to tag flashing. If this this is the case, this part can be "full" or "ota". If not, this field is not present - -Version: The version of the firmware in hex format, always 2 digit - +### Nameoftag +The name of the tag as found in tag_types.h +Which follows the scheme +~~~ +___ +~~~ Examples: +~~~ SOL_M2_29_SSD_15.bin - -Firmware for a 2.9" ZBS based tags with no mods to be put on the tag with version 15 +# Firmware for a 2.9" ZBS based tags with no mods to be put on the tag with version 15 SOL_M3_Uni_full_16.bin +# Firmware to flash a M3 2.9" tag with version 16 +~~~ + +#### Manufacturer +- SOL => SOLUM +- TLSR => ? + +#### Brand +- M2 => Solum M2 Model +- M3 => Solum M3 Model + +#### Display Size +- 154 => 1.54″ +- 29 => 2.9″ +- 42 => 4.2″ +- 29 => 2.9″ +- 75 => 7.5″ + +#### Display Controller + +- SSD => used for most common "normal" tags: ST‐GR16000, ST-GR29000 +- LT => used for low temperature tags +- UC => used for nfc enabled tags + +| Model | MAC ID | Firmware | +| ----- | ------ | -------- | +|ST-GR16000 | 341 | `SOL_M2_154_SSD_.bin` | +|ST-GR160BN | 343 | ? | +|ST-GR1600N | 163 | ? | +|ST-GR29000 | 3B1 | `SOL_M2_29_SSD_.bin` | +|ST-GR2900N | 3B3 | `SOL_M2_29_UC_.bin` | +|ST-GM29XXF | 2D1 | `SOL_M2_29_LT_.bin` | +|ST-GR42003N2| 483 | `SOL_M2_42_SSD_.bin` ? | +|ST-GR750BN | 743 | `SOL_M2_75__.bin` | + +### Full or OTA +Some tags have different files for OTA and direct to tag flashing. If this this is the case, this part can be `full` or `ota`. +If not, this field is not present. + +### Version +The version of the firmware in hex format, always 2 digits. -Firmware to flash a M3 2.9" tag with version 16 \ No newline at end of file