Awesome
Mgogo
A library to convert Adafruit Macropad RP4020 settings to and from binary for read and write to micro-controller non-volatile memory.
Inspired by the Redis serialization protocol specification (RESP)
Basic types
| type | length | prefix | notes |
|---|---|---|---|
| SWORD | 3 bytes | # | short word |
| WORD | 7 bytes | _ | |
| LWORD | 15 bytes | $ | long word |
| PCODE | 1 byte | + | push code |
| RCODE | 1 byte | - | release code |
| (END) | 1 byte | \n | signals end of binary array in NVM. |
Complex types
| type | prefix | notes |
|---|---|---|
| ARRAY | *n | of length n; may only hold a single type |
| KCODE | +- | union of PCODE | RCODE |
| COMM | < | WORD (label) + SWORD (LED color) + ARRAY<KCODE> |
| PAGE | [ | LWORD (label) + ARRAY<COMM> |
Intended limitations
Strings beyond 15 characters in length are not supported. In actuality the display UI cannot handle strings longer than this anyway.
Unicode is not supported by the default Circuit Python font, so one byte per character should be sufficient.
About the name
Mgogo is Swahili for woodpecker, a bird with a sense of rhythm.