commit | 5224167a0d0e32bad28c40b3182f5219641aa472 | [log] [tgz] |
---|---|---|
author | Jim Schaad <ietf@augustcellars.com> | Sat May 02 16:16:17 2020 -0700 |
committer | Jim Schaad <ietf@augustcellars.com> | Mon May 04 11:19:27 2020 -0700 |
tree | 6efe4f097c16dc61cc6bf918133def53bcfa8e92 | |
parent | 90540a87ec50fed575e28d9ec50887d708b3c05e [diff] |
Need to fix this.
Below is the original README for cn-cbor, a Proof of Concept implementation of CBOR that I wrote in 2013. People have been sending me fixes and updates to make this implementation more useful for actual use, and for a while I have occasionally integrated them. Jim Schaad now is so far ahead of this repo that you are most likely better off using his repo as your upstream.
If you are here looking for experimental CBOR implementations for constrained nodes, there are many, some of which are listed at cbor.io. One more: I have recently extracted the implementation from ARM-mbed's SUIT manifest generator (Apache 2.0). SUIT implementers report (CBOR-specific) code sizes in the low hundreds of bytes. Thank you, ARM.
This is a constrained node implementation of CBOR in C that I threw together in 2013, before the publication of RFC 7049, to validate certain implementability considerations.
Its API model was inspired by nxjson. It turns out that this API model actually works even better with the advantages of the CBOR format.
This code has been used in a number of research implementations on constrained nodes, with resulting code sizes appreciably under 1 KiB on ARM platforms.
I always meant to improve the interface some more with certain API changes, in order to get even closer to 0.5 KiB, but I ran out of time. So here it is. If I do get around to making these changes, the API will indeed change a bit, so please be forewarned.
There is a Simple-Makefile
for playing around, as well as a complete cmake
-based build environment. (You can choose what fits your needs better.)
Building with cmake
:
mkdir build cd build cmake .. cmake --build . -- all
Generating a test coverage report (requires lcov[^1]; result in build/lcov/index.html
):
rm -rf build mkdir build cd build cmake .. -DCN_CBOR_COVERALLS_SEND=ON cmake --build . -- all coveralls coverage_report
[^1]: Installation with homebrew: brew install lcov
find_package
find_package(cn-cbor) add_executable(myapp main.cpp) target_link_libraries(myapp cn-cbor::cn-cbor)
add_subdirectory
add_subdirectory(vendor/cn-cbor) add_executable(myapp main.cpp) target_link_libraries(myapp cn-cbor::cn-cbor)
This package is available in the conan center
add cn-cbor/[>=1.0.0]
to you conan file
License: MIT