Skip to main content

Managing Devices

The Devices page is used to view and manage an organisation's devices. By default the device table will show all devices.

Device table​

Each device shows:

  • Identifier: Unique identifier for the device
  • Status: Shows the current status of the device, e.g. if it is Online, Offline, Busy etc.
  • Tag: Friendly name or information. This can contain any text or be left blank.
  • Address: The TCP/IP address that can be used to connect to the device for the currently selected gateway. If all gateways are selected this will be blank.
  • Site: The site the device is in.
  • Service status: Whether the device is in service or not. This status does not reflect how a device is operating in any way, it is simply to allow the user to filter out devices that have not yet been deployed (i.e. are not in service).

Filtering and searching​

It is possible to filter by a devices tag, identifier and address by typing it (or part of it) into the filter box.

In addition it is possible to filter device by Site, Type, Status and Service Status by selecting them from the appropriate lists.

Device details​

By clicking on a device in the table the user will be taken to the device details page.

The details page consists of the following tabs.

Device details​

All device information.

Gateway Access​

Lists all gateways that have permission to connect to the site the device belongs to.

Configuration History​

Lists all user actions performed on the device.

Status Changes​

Lists all recent status changes of the device to assist troubleshooting.

Editing Device​

The user may edit the following details of the device by clicking the The Edit Device button:

  • Tag
  • Serial settings
  • Device type
  • Service status

Fetch Config​

The user may fetch the settings from the remote device by clicking the The Fetch Config button. The user may edit the following settings and save them back to the device:

  • DHCP settings
  • Proxy server settings
warning

Changing these settings can stop the device communicating with SAP if they are not correct.

It is recommended that these are not changed without consulting with Coherent Research.

Device Actions​

Adding a new device​

Only devices of type IDC and SIM can be created via the SAP user interface. ISA devices are added automatically before delivery.

  1. Click New button

  2. Fill in required fields:

    • Device Type: Select IDC or SIM
    • Tag: An optional descriptive name
    • Identifier: For IDCs the identifier is the device's MAC address with the format 00:17:BF:XX:XX:XX. For SIM devices the identifier is the SIM's ICCID with the format 89xxxxxxxxxxxxxxxxx
    • Serial Settings [IDC only]: The serial settings used when the IDC connects to the meter, e.g. 9600, 8N1
    • Remote address [SIM only]: The remote TCP endpoint of the SIM device in the format ipaddress:port, e.g. 12.34.56.78:9999
    • Service Status: Initial service status
    • Site: Select from dropdown

  3. Click Save

Adding a range of new IDC devices​

This is only applicable for IDC devices

  1. Click Bulk Create
  2. Enter:
    • Site
    • Starting MAC address
    • *Serial settings
    • Number of devices
  3. Click Create

Importing SIM devices from CSV​

This is only applicable for SIM devices

A CSV file can be imported to add a group of SIM devices.

The CSV file must have the following header:

MPAN,IP,Port,ICCID

The MPAN field should contain the meter's MPAN. This will be used as the Tag for the device.

The IP field must contain the IP address of the SIM device.

The Port field must contain the TCP port of the SIM device. The IP and Port fields will be used as the Remote Address for the device.

The ICCID must contain the ICCID of the SIM. This will be used as the Identifier for the device.

An example file would look like:

MPAN,IP,Port,ICCID
1591123456789,111.75.22.123,9999,89111111111111111111
1201111111111,111.75.22.12,9999,89222222222222222222
1423233333333,111.75.22.123,9999,89333333333333333333
  1. Click Import
  2. Enter:
    • Site
    • CSV file
  3. Click Create

Moving Devices​

Move multiple devices to a different site:

  1. Select devices by ticking the box for the desired rows in the device table.
  2. Click Move
  3. Choose destination:
    • Site
  4. Click "Move"

Setting Service Status​

Update service status for multiple devices:

  1. Select devices by ticking the box for the desired rows in the device table.
  2. Click Set Service Status
  3. Choose new status:
    • Service status
  4. Click *Save"

Deleting Devices​

Delete multiple devices:

  1. Select devices by ticking the box for the desired rows in the device table.
  2. Click Delete