{"id":2437,"date":"2022-08-18T07:40:34","date_gmt":"2022-08-18T07:40:34","guid":{"rendered":"http:\/\/lora.vsb.cz\/?page_id=2437"},"modified":"2024-12-15T09:40:31","modified_gmt":"2024-12-15T09:40:31","slug":"cayenne-lpp","status":"publish","type":"page","link":"https:\/\/lora.vsb.cz\/index.php\/cayenne-lpp\/","title":{"rendered":"Cayenne LPP"},"content":{"rendered":"\n\n\n\n
TTN version:<\/strong><\/td>\nTTNv3 \/ TTS SANDBOX<\/span><\/strong><\/td>\n<\/tr>\n
Last revision:<\/strong><\/td>\nDecember 14, 2024<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The Cayenne Low Power Payload (LPP)<\/strong> provides a convenient and easy way to send data over LPWAN networks such as LoRaWAN. The Cayenne LPP is compliant with the payload size restriction, which can be lowered down to 11 bytes, and allows the device to send multiple sensor data at one time. Cayenne LPP has several specific functions for some types of data, such as humidity, temperature, pressure, GPS and more.<\/p>\n

 <\/p>\n

Original LPPv1 data types<\/strong><\/h5>\n
uint8_t addDigitalInput<\/strong>(uint8_t channel, uint8_t value);\r\nuint8_t addDigitalOutput<\/strong>(uint8_t channel, uint8_t value);\r\nuint8_t addAnalogInput<\/strong>(uint8_t channel, float value);\r\nuint8_t addAnalogOutput<\/strong>(uint8_t channel, float value);\r\nuint8_t addLuminosity<\/strong>(uint8_t channel, uint16_t lux);\r\nuint8_t addPresence<\/strong>(uint8_t channel, uint8_t value);\r\nuint8_t addTemperature<\/strong>(uint8_t channel, float celsius);\r\nuint8_t addRelativeHumidity<\/strong>(uint8_t channel, float rh);\r\nuint8_t addAccelerometer<\/strong>(uint8_t channel, float x, float y, float z);\r\nuint8_t addBarometricPressure<\/strong>(uint8_t channel, float hpa);\r\nuint8_t addGyrometer<\/strong>(uint8_t channel, float x, float y, float z);\r\nuint8_t addGPS<\/strong>(uint8_t channel, float latitude, float longitude, float meters);\r\n<\/pre>\n
 <\/p>\n
Additional data types<\/strong><\/h5>\n
\n
uint8_t addUnixTime<\/strong>(uint8_t channel, uint32_t value);\r\nuint8_t addGenericSensor<\/strong>(uint8_t channel, float value);\r\nuint8_t addVoltage<\/strong>(uint8_t channel, float value);\r\nuint8_t addCurrent<\/strong>(uint8_t channel, float value);\r\nuint8_t addFrequency<\/strong>(uint8_t channel, uint32_t value);\r\nuint8_t addPercentage<\/strong>(uint8_t channel, uint32_t value);\r\nuint8_t addAltitude<\/strong>(uint8_t channel, float value);\r\nuint8_t addPower<\/strong>(uint8_t channel, uint32_t value);\r\nuint8_t addDistance<\/strong>(uint8_t channel, float value);\r\nuint8_t addEnergy<\/strong>(uint8_t channel, float value);\r\nuint8_t addDirection<\/strong>(uint8_t channel, float value);\r\nuint8_t addSwitch<\/strong>(uint8_t channel, uint32_t value);\r\nuint8_t addConcentration<\/strong>(uint8_t channel, uint32_t value);\r\nuint8_t addColour<\/strong>(uint8_t channel, uint8_t r, uint8_t g, uint8_t b);<\/pre>\n<\/div>\n
 <\/p>\n
More information can be found in the Cayenne LPP documentation<\/a><\/strong>.<\/p>\n
 <\/p>\n
Arduino IDE setup<\/span><\/strong><\/h2>\n
    \n
  1. Run Arduino IDE.<\/li>\n
  2. In the Arduino IDE Library Manager<\/strong>\u00a0search CayenneLPP<\/strong> by Electronic Cats and install it.<\/li>\n<\/ol>\n
     <\/p>\n
    Cayenne LPP in program<\/strong><\/span><\/h2>\n
    As an example, we will use a program for a Temperature and Humidity<\/strong><\/a> sensor using Adafruit Feather 32u4 RFM95 LoRa Radio<\/strong> and DHT22<\/strong>.<\/p>\n
      \n
    1. At the top of the program you can see:\n
      #include <\/span><<\/span>CayenneLPP.h><\/span><\/span>      \/\/ Cayenne Low Power Payload (LPP)<\/span>\r\nCayenneLPP lpp<\/span>(51<\/span>);<\/pre>\n<\/li>\n
    2. In the function void do_send(osjob_t* j)<\/em><\/strong> you can see that first the lpp is reset, which deletes the previously added data (temperature and humidity). Then the current measured temperature is added to lpp in channel 1 and humidity in channel 2. When you have all the data you want to send in the lpp, put the lpp buffer and its size in the LMIC_setTxData2<\/em> function call.<\/span><\/span>\n
      lpp.reset<\/span>();\r\nlpp.addTemperature<\/span>(1<\/span>, temp);                                \/\/ Add the current temperature into channel 1\r\nlpp.addRelativeHumidity<\/span>(2<\/span>, humi);                           \/\/ Add the current humidity into channel 2\r\nLMIC_setTxData2<\/span>(1<\/span>, lpp.getBuffer<\/span>(), lpp.getSize<\/span>(), 0<\/span>);      \/\/ Prepare upstream data transmission at the next possible time\r\n<\/span><\/pre>\n<\/li>\n<\/ol>\n
       <\/p>\n
      The Things Stack setup<\/strong><\/span><\/h2>\n
      \u00a0Original LPPv1 data types<\/strong><\/span><\/h5>\n
        \n
      1. In\u00a0TTS -> Applications -> YourAppName -> Payload formatters -> Uplink<\/strong>\u00a0change\u00a0Formatter type<\/strong>\u00a0to\u00a0CayenneLPP<\/strong>.<\/li>\n
      2. Save changes<\/strong>.\"\"<\/li>\n<\/ol>\n
         <\/p>\n
        Additional data types and <\/strong><\/span>Original LPPv1 data types<\/strong><\/span><\/h5>\n
          \n
        1. In\u00a0TTS -> Applications -> YourAppName -> Payload formatters -> Uplink<\/strong>\u00a0change\u00a0Formatter type<\/strong> to Custom Javascript formatter<\/strong>.\"\"<\/li>\n
        2. To the Formatter code<\/strong> field copy and paste Cayenne LPP Decoder<\/a><\/strong>.<\/li>\n
        3. Scroll down and delete the dot on line 166 and 167.\"\"<\/li>\n
        4. Save changes<\/strong>.\"\"<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
          TTN version: TTNv3 \/ TTS SANDBOX Last revision: December 14, 2024 The Cayenne Low Power Payload (LPP) provides a convenient and easy way to send data over LPWAN networks such as LoRaWAN. The Cayenne LPP is compliant with the payload size restriction, which can be lowered down to 11 bytes, and allows the device to […]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2437","page","type-page","status-publish","hentry","post"],"_links":{"self":[{"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/pages\/2437","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/comments?post=2437"}],"version-history":[{"count":62,"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/pages\/2437\/revisions"}],"predecessor-version":[{"id":8417,"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/pages\/2437\/revisions\/8417"}],"wp:attachment":[{"href":"https:\/\/lora.vsb.cz\/index.php\/wp-json\/wp\/v2\/media?parent=2437"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}