TCR LoRaWAN® Payload Description

V2.2 | V2.1 | V2.0 | V1.3

This document describes LoRaWAN® payload formats of Parametric TCR Traffic Counters introduced with Firmware V1.3

Application Payload

TCR devices send the application payload in regular intervals using port 15.

(*) These field values are ignored by the device when downlinking this payload.

Ports used

Application Payload Example (Hexstring)

be02021cc0000000a0000108000000000000000000000000000000000000000000

Configuration Payload

This payload is sent once after a successful join. It is recommended to save the information for tracking the devices settings over time.

You could use the same format for creating a configuration downlink to port 190. Once received the device will restart and re-join.

() These fields values are ignored by the device when downlinking this payload (*) Speed class 2 and 3 is not used on TCR-LS, TCR-LSS devices

Ports used

Configuration Payload Example (Hexstring)

be020300010300000001000a05a00000005a00fa00fa0107082800000000040100

Payload Decoder

Best Practice

Please check the port number and header of the payload to be backward compatible

   if(bytes[0] == 0xbe && bytes[1] == 0x02)
   {
       // its a TCR

       if(port == 15)
       {
           // it's an Application Payload

           if(bytes[2] == 0x01)    // V1
           {
               obj = app_payload_v1_decoder(bytes, port);
           }
           if(bytes[2] == 0x02)    // V2
           {
               obj = app_payload_v2_decoder(bytes, port);
           }
       }

       if(port == 190)
       {
           // it's a Configuration Payload

           if(bytes[2] == 0x01)    // V1
           {
               obj = config_payload_v1_decoder(bytes, port);
           }
           if(bytes[2] == 0x02)    // V2
           {
               obj = config_payload_v2_decoder(bytes, port);
           }
           if(bytes[2] == 0x03)    // V3
           {
               obj = config_payload_v3_decoder(bytes, port);
           }
       }
   }

Find more example code in our public repository.

Disclaimer

ALL PRODUCT, PRODUCT SPECIFICATIONS AND DATA ARE SUBJECT TO CHANGE WITHOUT NOTICE TO IMPROVE RELIABILITY, FUNCTION OR DESIGN OR OTHERWISE.

PMY Systems AG, its affiliates, agents, and employees, and all persons acting on its or their behalf (collectively, "PMX"), disclaim any and all liability for any errors, inaccuracies or incompleteness contained in any datasheet or in any other disclosure relating to any product.

PMX makes no warranty, representation or guarantee regarding the suitability of the products for any particular purpose or the continuing production of any product. To the maximum extent permitted by applicable law, PMX disclaims (i) any and all liability arising out of the application or use of any product, (ii) any and all liability, including without limitation special, consequential or incidental damages, and (iii) any and all implied warranties, including warranties of fitness for particular purpose, non-infringement and merchantability.

Statements regarding the suitability of products for certain types of applications are based on PMX's knowledge of typical requirements that are often placed on Paramtric products in generic applications. Such statements are not binding statements about the suitability of products for a particular application. It is the customer's responsibility to validate that a particular product with the properties described in the product specification is suitable for use in a particular application. Parameters provided in datasheets and / or specifications may vary in different applications and performance may vary over time. All operating parameters, including typical parameters, must be validated for each customer application by the customer's technical experts. Product specifications do not expand or otherwise modify Paramtric's terms and conditions of purchase, including but not limited to the warranty expressed therein.

Hyperlinks may direct users to third-party websites. These links are provided as a convenience and for informational purposes only. Inclusion of these hyperlinks does not constitute an endorsement or an approval by PMX of any of the products, services or opinions of the corporation, organization or individual associated with the third-party website. PMX disclaims any and all liability and bears no responsibility for the accuracy, legality or content of the third-party website or for that of subsequent links.

Except as expressly indicated in writing, PMX products are not designed for use in medical, life-saving, or life-sustaining applications or for any other application in which the failure of the PMX product could result in personal injury or death. Customers using or selling PMX products not expressly indicated for use in such applications do so at their own risk. Please contact authorized PMX personnel to obtain written terms and conditions regarding products designed for such applications.

No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document or by any conduct of PMX. Product names and markings noted herein may be trademarks of their respective owners