Network Server Configuration

Steps:

1. Access the Network Server Dashboard:

   • Log in to your LoRaWAN Network Server’s management interface.
   • Navigate to the section for managing applications or integrations (e.g., “Applications” or “Data Converters”).

2. Create a New Data Converter:

   • Find the option to add a new data converter (e.g., “Add Data Converter” or “Create Function”).
   • Name the converter (e.g., “LocusDataConverter”).
   • Select the scripting language supported by your NS (e.g., JavaScript).

3. Implement the Decoder:

   • In the decoder section, input the following JavaScript code to handle uplink data from devices:

     // Decoder for uplink data
     // Input object structure:
     // - bytes - int[]
     // - fPort - int
     // - recvTime - Date (needs type check)
     // - tektelicMetadata - Object
     function decodeUplink(input) {
         if (input.recvTime instanceof Date) {
             // Date operations can be performed if needed
         }
     // Output object structure:
     // - data - Object
     // - errors - string[]
     // - warnings - string[]
     // - tektelicMetadata - Object
     return {
         "data": {"bytes": input.bytes},
         "errors": [],
         "warnings": [],
         "tektelicMetadata": input.tektelicMetadata
     };
     

This decoder processes the incoming data, preserves the tektelicMetadata, and returns the data in a format compatible with Locus.

4. Implement the Encoder:

   • In the encoder section, input the following JavaScript code to handle downlink data to devices:

     // Encoder for downlink data
     // Input object structure:
     // - data - Object (customer-defined)
     
     function encodeDownlink(input) {
         // Output object structure:
         // - fPort - int
         // - bytes - int[]
         // - errors - string[]
         // - warnings - string[]
         return {
             "fPort": input.data.fPort,
             "bytes": input.data.bytes,
             "errors": [],
             "warnings": []
         };
     }
     

5. Save the Data Converter:

   • Save the data converter configuration on the Network Server.
   • Verify that the converter is active and associated with your application on the NS.

Expectations: The data converter is configured on the Network Server, ensuring that uplink and downlink data are correctly formatted for Locus integration.

Steps:

1. Access the Network Server Dashboard:

   • Log in to your LoRaWAN Network Server’s management interface.
   • Navigate to the section for managing integrations (e.g., “Integrations” or “Application Integrations”).

2. Add a New Integration:

   • Find the option to add a new integration (e.g., “Add Integration”).
   • Select the integration type as HTTPv2.

3. Configure Integration Settings:

   • Name: Provide a name for the integration (e.g., “LocusIntegration”).

   • Type: Ensure the type is set to HTTPv2.

   • Data Converter: Select the data converter created earlier (e.g., “LocusDataConverter”).

   • Application Address: Specify the application address for Locus. Contact the support engineer to obtain the correct URL (e.g., https://tenant-specific.locus.tektelic.com).

   • Port: Set the port to 443.

   • Base Path: Set the base path to /v2/integration.

   • HTTPS: Enable HTTPS to ensure secure communication.

   • Request Headers:

     • Add the following header: ApiKey: ApiKey.
     • Note: Replace ApiKey with the actual API key provided by the Locus development team.

4. Save and Test the Integration:

   • Save the integration configuration on the Network Server.
   • Test the integration by sending a sample message from a device to verify that data is successfully transmitted to Locus (e.g., check the Locus dashboard for incoming data).

Expectations: The Network Server is now integrated with Locus, and device data is transmitted to the Locus platform via the configured HTTPv2 endpoint.

Stork and Chickadee devices require Semtech LoRa Cloud integration for GNSS/outdoor tracking. In case client plans to use Stork or Chickadee please contact TEKTELIC Support https://knowledgehub.tektelic.com/