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 LOCUS application address. You can find this value in the LOCUS web application under:

     Settings → Uplink Delivery

     Copy the value from the LOCUS Application URL field and paste it into the Application Address field on the TEKTELIC Network Server.

     ⚠️ Important: Paste only the hostname — without https:// and without /v2/integration.

     Example:

     Field	Value
     LOCUS Application URL (from Settings tab)	https://locus-pc.tektelic.com/v2/integration
     What to paste into Application Address	locus-pc.tektelic.com

     The /v2/integration part will be added separately to the Base Path field.

     (Screenshot example below — from LOCUS → Settings → Uplink Delivery, showing the “LOCUS Application URL” field.)

     
     

   • 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.

Configuring Downlinks (Optional)
If you need to configure downlink delivery from LOCUS to the TEKTELIC Network Server, refer to the Downlink Configuration section.

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/