From 1c7a9923ad5ffcea97ce501936d6d712d1706956 Mon Sep 17 00:00:00 2001
From: MultiMote <contact@mmote.ru>
Date: Thu, 5 Dec 2024 12:22:53 +0300
Subject: [PATCH] Add image data packets docs

---
 docs/documents/niimbot_proto.md |  88 ++++++++++++++++++++++++++++----
 docs/documents/proto/pixels.png | Bin 0 -> 46540 bytes
 typedoc.json                    |   1 +
 3 files changed, 80 insertions(+), 9 deletions(-)
 create mode 100644 docs/documents/proto/pixels.png

diff --git a/docs/documents/niimbot_proto.md b/docs/documents/niimbot_proto.md
index d7f2a1b..b557710 100644
--- a/docs/documents/niimbot_proto.md
+++ b/docs/documents/niimbot_proto.md
@@ -41,9 +41,9 @@ WIP
 | 0x59 | CalibrateHeight | 0x69 | |
 | 0x5a | PrintTestPage | 0x6a |✅|
 | 0x70 | WriteRFID | 0x71 | |
-| 0x83 | PrintBitmapRowIndexed | ⚠ one way | |
-| 0x84 | PrintEmptyRow | ⚠ one way | |
-| 0x85 | PrintBitmapRow | ⚠ one way | |
+| 0x83 | [PrintBitmapRowIndexed](#printbitmaprowindexed) | ⚠ one way | |
+| 0x84 | [PrintEmptyRow](#printemptyrow) | ⚠ one way | |
+| 0x85 | [PrintBitmapRow](#printbitmaprow) | ⚠ one way | |
 | 0x8e | LabelPositioningCalibration | 0x8f |✅|
 | 0xa3 | PrintStatus | 0xb3 |✅|
 | 0xa5 | PrinterStatusData | 0xb5 |✅|
@@ -66,14 +66,84 @@ Example (RfidInfo):
 
 ```
 55 55 1a 01 01 1a aa aa
-      │  │  │  │
-      │  │  │  └─ Checksum (h1a^h01^h01)
-      │  │  └─ Data
-      │  └─ Data length
-      └─ RfidInfo command
+       │  │  │  │
+       │  │  │  └─ Checksum (1a^01^01)
+       │  │  └─ Data
+       │  └─ Data length
+       └─ RfidInfo command
 ```
 
-## Packets example
+## Packet details (image data packets)
+
+See [print tasks](niimbot_print_tasks.md) to understand how to images are printed.
+
+### PrintEmptyRow
+
+Used to fill row with blank (white) pixels.
+
+Example:
+
+```
+55 55 84 03 00 04 02 81 aa aa
+       │  │  └──┤  │  │
+       │  │     │  │  └─ Checksum
+       │  │     │  └─ Repeat count (repeat row two times)
+       │  │     └─ Row number is 4
+       │  └─ Data length
+       └─ PrintEmptyRow command
+```
+
+### PrintBitmapRowIndexed
+
+Used when black pixel count is less than 7. Data is encoded with pixel indexes (unsigned 16-bit integers).
+
+`Black pixel count` segment is a mystery. It encoded with 3 bytes. Sum all of them equals total count of current row black pixels.
+
+Algorithm of this segment calculation you can see in {@link API.Utils.countPixelsForBitmapPacket} source code.
+Sometimes result match the original packets, sometimes not.
+
+Usually printer prints without problems when all of 3 bytes are zeros.
+
+Example:
+
+```
+55 55 83 0a 00 03 02 00 00 02 00 0a 01 40 c1 aa aa
+       │  │  └──┤  └──┴──┤  │  └──┤  └──┤  │
+       │  │     │        │  │     │     │  └─ Checksum
+       │  │     │        │  │     │     └─ Draw pixel at x=320
+       │  │     │        │  │     └─ Draw pixel at x=10
+       │  │     │        │  └─ Repeat count (repeat row two times)
+       │  │     │        └─ Black pixel count (see above)
+       │  │     └─ Row number is 3
+       │  └─ Data length
+       └─ RfidInfo command
+```
+
+### PrintBitmapRow
+
+Used to send full row segment that includes both black and white pixels.
+
+Image row example:
+
+![pixels](proto/pixels.png)
+
+Packet example:
+
+```
+55 55 85 0a 00 00 13 00 00 01 ff 00 df 0f b2 aa aa
+       │  │  └──┤  └──┴──┤  │  └──┴──┴──┤  │
+       │  │     │        │  │           │  └─ Checksum
+       │  │     │        │  │           │
+       │  │     │        │  │           └─ Draw 32 pixels
+       │  │     │        │  └─ Repeat count (repeat row 1 time)
+       │  │     │        └─ Black pixel count
+       │  │     └─ Row number is 0
+       │  └─ Data length
+       └─ RfidInfo command
+
+```
+
+## Other packets example
 
 * `55 55 40 01 0b 4a aa aa` - get device serial number
 * `55 55 1a 01 01 1a aa aa` - get rfid data
diff --git a/docs/documents/proto/pixels.png b/docs/documents/proto/pixels.png
new file mode 100644
index 0000000000000000000000000000000000000000..989c2ff97e58a7b8b79b7b39cb168d99696fdf42
GIT binary patch
literal 46540
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

literal 0
HcmV?d00001

diff --git a/typedoc.json b/typedoc.json
index b5f9b95..755e9b9 100644
--- a/typedoc.json
+++ b/typedoc.json
@@ -8,6 +8,7 @@
   "treatValidationWarningsAsErrors": true,
   "excludeReferences": true,
   "out": "./docs/html",
+  "sortEntryPoints": false,
   "projectDocuments": [
     "docs/documents/niimbot_hardware_interfacing.md",
     "docs/documents/niimbot_proto.md",