ArduinoJson 0,0,2,4,0,11 travis-ci

ArduinoJson - C++ JSON library for IoT

Build status Build Status Coverage Status Star this project

An elegant and efficient JSON library for embedded systems.

It's designed to have the most intuitive API, the smallest footprint and is able to work without any allocation on the heap (no malloc).

It has been written with Arduino in mind, but it isn't linked to Arduino libraries so you can use this library in any other C++ project. For instance, it supports Aduino's String and Stream, but also std::string, std::istream and std::ostream.

Features

  • JSON decoding (comments are supported)
  • JSON encoding (with optional indentation)
  • Elegant API, very easy to use
  • Fixed memory allocation (zero malloc)
  • No data duplication (zero copy)
  • Portable (written in C++98)
  • Self-contained (no external dependency)
  • Small footprint
  • Header-only library
  • MIT License

Works on

  • Arduino boards: Uno, Due, Mini, Micro, Yun...
  • ESP8266, ESP32
  • Teensy
  • RedBearLab boards (BLE Nano...)
  • Intel Edison and Galileo
  • WeMos boards: D1...
  • Computers: Windows, Linux, OSX...
  • PlatformIO
  • Particle
  • Energia

Quick start

Decoding / Parsing

char json[] = "{\"sensor\":\"gps\",\"time\":1351824120,\"data\":[48.756080,2.302038]}";

StaticJsonBuffer<200> jsonBuffer;

JsonObject& root = jsonBuffer.parseObject(json);

const char* sensor = root["sensor"];
long time          = root["time"];
double latitude    = root["data"][0];
double longitude   = root["data"][1];

See JsonParserExample.ino

Encoding / Generating

StaticJsonBuffer<200> jsonBuffer;

JsonObject& root = jsonBuffer.createObject();
root["sensor"] = "gps";
root["time"] = 1351824120;

JsonArray& data = root.createNestedArray("data");
data.add(48.756080);
data.add(2.302038);

root.printTo(Serial);
// This prints:
// {"sensor":"gps","time":1351824120,"data":[48.756080,2.302038]}

See JsonGeneratorExample.ino

Documentation

The documentation is available online in the ArduinoJson Website.

The ArduinoJson Assistant helps you get started with the library.

Donators

Special thanks to the following persons and companies who made generous donations to the library author:

  • Robert Murphy USA
  • Surge Communications USA
  • Alex Scott United Kingdom
  • Firepick Services LLC USA
  • A B Doodkorte Netherlands
  • Scott Smith USA
  • Johann Stieger Austria
  • Gustavo Donizeti Gini Brazil
  • Charles-Henri Hallard France
  • Martijn van den Burg Netherlands
  • Nick Koumaris Greece
  • Jon Williams USA
  • Kestutis Liaugminas Lithuania
  • Darlington Adibe Nigeria
  • Yoeri Kroon Netherlands
  • Andrew Melvin United Kingdom
  • Doanh Luong Vietnam
  • Christoph Schmidt Germany
  • OpenEVSE LLC USA
  • Prokhoryatov Alexey Russia

Found this library useful? Please star this project or help me back with a donation! :smile:

Related Repositories

Sming

Sming

Sming - Open Source framework for high efficiency native ESP8266 development ...

awesome-iot

awesome-iot

Awesome IoT. A collaborative list of great resources about IoT Framework, Librar ...

awesome-json

awesome-json

A curated list of awesome JSON libraries and resources. ...

nativejson-benchmark

nativejson-benchmark

C/C++ JSON parser/generator benchmark ...

awesome-cpp

awesome-cpp

A curated list of awesome C++ frameworks, libraries and software. ...


Top Contributors

bblanchon ivankravets Eriatolc marvinroger ulion

Releases

-   v5.6.7 zip tar
-   v5.6.6 zip tar
-   v5.6.5 zip tar
-   v5.6.4 zip tar
-   v5.6.3 zip tar
-   v5.6.2 zip tar
-   v5.6.1 zip tar
-   v5.6.0 zip tar
-   v5.5.1 zip tar
-   v5.5.0 zip tar
-   v5.4.0 zip tar
-   v5.3.0 zip tar
-   v5.2.0 zip tar
-   v5.1.1 zip tar
-   v5.1.0 zip tar
-   v5.1.0-beta.2 zip tar
-   v5.1.0-beta.1 zip tar
-   v5.0.8 zip tar
-   v5.0.7 zip tar
-   v5.0.6 zip tar
-   v5.0.5 zip tar
-   v5.0.4 zip tar
-   v5.0.3 zip tar
-   v5.0.2 zip tar
-   v5.0.1 zip tar
-   v5.0.0 zip tar
-   v5.0-beta-5 zip tar
-   v5.0-beta-4 zip tar
-   v5.0-beta-3 zip tar
-   v5.0-beta-2 zip tar