myDevices Cayenne allows you to quickly design, prototype, and visualize IoT solutions. You can use Cayenne as a tool to visualize real-time and historical data, sent over The Things Network.
Change the payload to Cayenne LPP
In order to display your content in the Cayenne dashboard, the payload has to be encoded with the Cayenne Low Power Payload (Cayenne LPP).
CayenneLPP contains metadata for Cayenne to understand what data comes into their dashboard. As part of each data value, we need to define the identifier and what type of data it is. The first byte is the identifier, the
Channel ID. The second byte is the data type
Data Type. Please have a look here to find more information on the Cayenne LPP.
Documentation about altering your Arduino Sketch to encode data with
CayenneLPP can be found here.
TheThingsNetwork ttn(loraSerial, debugSerial, freqPlan); CayenneLPP lpp(51); // create a buffer of 51 bytes to store the payload lpp.reset(); // clear the buffer lpp.addTemperature(1, 22.5); // on channel 1, add temperature, value 22.5°C lpp.addBarometricPressure(2, 1073.21); // channel 2, pressure lpp.addGPS(3, 52.37365, 4.88650, 2); // channel 3, coordinates ttn.sendBytes(lpp.getBuffer(), lpp.getSize());
In order to send data to your device as downlink message, you need to make an output channel available as part of an uplink message. You only need to do that once. Both digital and analog are available.
lpp.addDigitalOutput(4, 1); // channel 4, set digital output high lpp.addAnalogOutput(5, 120.0); // channel 5, set analog output to 120
For digital outputs, a switch will appear to set the output high or low. For analog outputs, you get a slider to set the analog value. Changes in these controls trigger a downlink message.
Set the Payload Format in the Console
After encoding data with CayenneLPP, have a look at the console to change the Payload Formats
- Go to your Application in The Things Network Console and click Payload Formats
- In the dropdown menu select Cayenne LPP instead of Custom
Set up your myDevices account
- Create an account on myDevices
Log-in and click on LoRa
- Select The Things Network at the bottom of the left menu bar, click on Cayenne LPP and fill in your DevEUI of your device (which you can find in the Console)
Add the myDevices Cayenne integration in the Console
Go to your application in the Console and add the Cayenne integration via Add Integration
- Think of a name for your Process ID
- Add the integration
Build your Cayenne dashboard
Click the device on the left side of your dashboard in Cayenne and your data as well as the actions buttons are shown right away. After a bit of editing you can make quite some fancy stuff.
🎉 Now impress some folks with this amazing dashboard you built on Twitter, using @thethingsntwrk @CayenneIoT