User Guide

Knowledge Base

Configure Sensor Scripts


The X2 data logger uses predefined sensor scripts to automatically detect connected sensors. By default, only a subset of the available sensor scripts are activated on a new X2 unit. This includes logger internal diagnostic sensors and the most commonly integrated third-party sensors. Before running sensor detection, use CONNECT software to configure the X2 sensor script list (including any custom scripts). Activating only the scripts of the connected sensors will reduce the time it takes to complete detection.

Show Enabled Sensors

  1. Connect the X2 logger to a PC and launch the CONNECT software. Test connection by reading the RTC clock of the logger in the CONFIG tab.
  2. On the CONFIG tab, click the Read Script List button.
    1. All of the sensor detection scripts loaded onto the SD card of the X2 will appear.
    2. Scripts enabled to run by default will have a checkmark in the box.
Configure X2 sensor scripts

Figure 1: Script list from the X2.

 

Modify Sensor Detection List

  1. As desired, enable or disable detection scripts using the check-boxes to the left of each listed sensor.
    1. Note: Always check the 0001-NexSens X2 Internal Diagnostic sensor. This supplies vital system diagnostic information.
    2. The more scripts that are enabled, the longer the sensor detection process will take. It is advised to select only the sensors which will be connected to the X2.

Figure 2: Configure X2 sensor scripts.

 

  1. After making any changes, click the drop-down arrow to the right of the Read Script List button and select Write script autodetect enable flags.

Figure 3: Save the enabled detection scripts to the X2.

 

  1. A prompt will appear indicating that the selected sensor scripts have been enabled to run.

Figure 4: Script enable confirmation.

 

  1. Following any changes, confirm successful update of the script list by clicking the Read Script List button again.

 

Add/Update Sensor Scripts

Certain situations may require adding a new or updated sensor script to the X2. In such cases, NexSens will provide the script file, which is transferrable to the X2 through CONNECT.

  1. Copy the .lua script file provided by NexSens locally to the PC running the CONNECT software.
  2. Select the drop-down arrow to the right of the Read Script List button and select the Transfer script file to X2 option.

Figure 5: Select Transfer script file to X2.

 

  1. Locate and select the script file to add using Windows explorer.

Figure 6: Select the new/updated script file to add to the X2.

 

  1. A confirmation prompt will appear identifying whether the selected script is an updated version of an existing file or a new file altogether. Click Yes to proceed with uploading the new script.
    1. The script upload will take approximately 10 seconds (potentially longer depending on the script size) before a prompt will appear indicating a successful transfer.

Figure 7: Confirm the script transfer.

Figure 8: Script transfer success.

 

  1. Select the Read Script List option.
  2. Check the box next to the newly added script, then click the Write script autodetect enable flags option to enable it to run.
    1. Note that any 9000-series script will supersede all other standard script options and will run automatically.

Figure 9: Enable the new script to run.

 

  1. Following the next sensor detection request or logger power cycle (if no sensors have been detected yet), the new script will run.