Initial commit

docs/cli/raw.md

@@ -0,0 +1,23 @@
+# raw — произвольный payload
+
+## Аргументы `raw`
+
+### `hexstr`
+
+Payload до 64 байт (пробелы допустимы).
+Короче 64 — дополняется нулями, длиннее — обрезается.
+Первые байты: `[0]` режим, `[1..3]` RGB, `[8]` flag, `[9]` яркость, `[10]` скорость, `[11]` подрежим, `[14..15]` = `aa 55`.
+
+### `--no-save`
+
+Не писать во флеш (см. `mode --no-save` в [COLOR-MODES.md](../COLOR-MODES.md)).
+По умолчанию save выполняется.
+
+```
+./katana.py raw <64 байта hex> [--no-save]
+```
+
+Payload отправляется внутри штатной транзакции `begin → data → commit → save`.
+Для экспериментов с неописанными байтами.
+
+Формат payload'ов и назначение байтов — в [PROTOCOL.md](../PROTOCOL.md).