Skip to main content
Sign in

Create custom input events for Cellocator devices

Marisa Potgieter

In On-Road IoT, Cellocator devices support native third-party input line events and custom event authoring.

You can create an input peripheral, calibrate it, define a custom parameter, assign the peripheral to an input line in a Cellocator mobile device template, and use that parameter as a trigger condition in custom notification and detailed events.

1. Create new input peripheral

  1. Click Manage.
  2. Under Config Admin, click Libraries.
  3. Click the Peripheral library tab.
  4. Click Add peripheral.
  5. Enter a mandatory description for the peripheral.
  6. Choose the peripheral type from the dropdown list.

Parameters represent the values returned by connected devices (e.g. road speed from a speed sender, latitude from a GPS receiver). When adding a new peripheral, if the required parameter does not already exist, you can create one at the same time

  1. Select an existing parameter name, or check the box to Create new parameter and complete the parameter details.

2. Calibrating the Peripheral

Calibration behavior depends on the input type selected.

  1. Enter the relevant calibration values, if relevant. The input type determines whether the input reading units of measure are in mV or Hz, etc.
  2. For Frequency and Pulse types, there is an additional Peripheral Configuration Setting for the tacho resolution, which must be set when creating a custom peripheral.
  3. Click Save.

!!! note "" Note: When you make a peripheral available on the organization, it also automatically populates the Parameter Library with its associated parameters. These parameters can then be used when defining events (e.g. an over-speeding event that reads the road speed value from a speed sender).

3. Assign the peripheral to an input line in a Cellocator mobile device template

  1. Click Manage.
  2. Under Config Admin, click Templates.
  3. Click on Mobile device template.
  4. Click on the Cellocator template for which the input line configuration is required.
  5. Next to the required I line (I1 through I8), click on Not connected.
  6. In the dropdown, select the peripheral device to be connected to that I line (e.g. anti tamper, blue lights on, Cold chain - temperature sensor, etc.).

  7. Click Save.

    If a required peripheral device does not appear in the dropdown list, you may first need to make it available via the Peripheral Library. This is done by finding the peripheral in the library and selecting Make available. You can also refresh the peripheral list.

You can now create a custom notification or detailed event using the parameter as a trigger condition.

RECOMMENDED READING

Peripheral library

Parameter library

Create a new parameter for a peripheral

Adding new peripherals on the organization

Create event notification