2 releases

0.1.1 Apr 16, 2021
0.1.0 Apr 16, 2021

#2115 in Encoding

Download history 4/week @ 2024-02-11 9/week @ 2024-02-18 47/week @ 2024-02-25 18/week @ 2024-03-03 29/week @ 2024-03-10 14/week @ 2024-03-17 19/week @ 2024-03-24 49/week @ 2024-03-31 15/week @ 2024-04-07 31/week @ 2024-04-14 22/week @ 2024-04-21 9/week @ 2024-04-28

83 downloads per month
Used in 6 crates (2 directly)

MIT/Apache

14KB
131 lines

rcobs

Documentation

Reverse-COBS encoding (rCOBS) is a variant of COBS encoding designed to allow encoding with zero lookahead.

COBS and rCOBS are useful for framing a stream of messages for transmission over a pipe of bytes (like UART or TCP). COBS encoding ensures encoded messages don't contain 0x00 bytes, so the 0x00 byte can then be used as a message separator.

Standard COBS splits the input into zero-byte-separated chunks of up to 254 bytes, and prefixes them with a length byte. This requires a lookahead of up to 254 bytes when doing streaming encoding.

rCOBS outputs the length byte at the end of the chunk instead of at the start, completely eliminating the lookahead requirement for encoding. The tradeoff is decoding now has to be done starting from the end of the message backwards, so no lookahead is possible. The message has to be read in its entirety before it can be decoded.

This makes rCOBS ideal for situations where data is encoded in constrained, embedded systems and decoded in more capable systems, where the full buffering requirement is not a problem.

Examples

Chunks are delimited by double-spaces for your convenience.

Message:        11 22 33 44
COBS-encoded:   05 11 22 33 44
rCOBS-encoded:  11 22 33 44 05

Message:        11 22 00  33
COBS-encoded:   03 11 22  02 33
rCOBS-encoded:  11 22 03  33 02

Message:        11 00  00  00  42 42 42
COBS-encoded:   02 11  01  01  04 42 42 42
rCOBS-encoded:  11 02  01  01  42 42 42 04

License

This work is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps