github.com/simpleiot/simpleiot@v0.18.3/docs/user/particle.md (about)

     1  # Particle.io
     2  
     3  SIOT provides a client for pulling data from
     4  [Particle.io](https://www.particle.io/). Particle provide modules to quickly
     5  implement cellular connected MCU based IoT systems. They take care of managing
     6  the device (cellular connection, firmware deployments, etc.), and you only need
     7  to write the application.
     8  
     9  The Particle cloud
    10  [event API](https://docs.particle.io/reference/cloud-apis/api/#events) is used
    11  to obtain the data. A connection is made from the SIOT instance to the Particle
    12  Cloud and then data is sent back to SIOT using Server Sent Events (SSE). The
    13  advantage of this mechanism is that complex web hooks are not needed on the  
    14  SIOT side, which requires additional firewall/web server configuration.
    15  
    16  A Particle API key is needed which can be generated using the `particle token`
    17  [CLI command](https://docs.particle.io/getting-started/developer-tools/cli/).
    18  
    19  ![particle](images/particle.png)
    20  
    21  The above example shows data provided by the Particle based
    22  [Simple IoT Particle Gateway](https://github.com/simpleiot/hardware) and 1-wire
    23  temperature sensors, and
    24  [SIOT firmware](https://github.com/simpleiot/firmware/tree/master/siot-fw).
    25  
    26  Data is is published to Particle in the following format:
    27  
    28  ```json
    29  [
    30  	{
    31  		"id": "4B03089794485728",
    32  		"type": "temp",
    33  		"value": 15.25
    34  	}
    35  ]
    36  ```
    37  
    38  The SIOT Particle client populates the point `key` field with the 1-wire device
    39  ID.
    40  
    41  _(In the future, we will likely change the format slightly to be named `points`,
    42  instead of `sample`)_
    43  
    44  ![gw](images/gw.jpg)
    45  
    46  ![temp](images/node-tmp.jpg)