# Devices developer_board

This page manages the devices connected to the platform and provides interface with this system.

device
Device

# Side panel

The configured devices are listed on the left, with their name and a switch to control their power-on status.

The icon and the label take on color

  • blue, to identify the device currently selected and displayed in the view;
  • otherwise
    • grey, to identify a device that is off (and not currently selected);
    • green, to identify a device that is on (and not currently selected);
    • red, to identify a device that is switched on, but which is not responding (it can be timeout or network connection interruption); in this regard, check the power on status of the device, and that the connection in the network is active with the correct IP address.

There is always a button to reorder the list of devices, labeled "Edit Order": Clicking it opens a popup in which you can drag the elements into the desired order and then save, or possibly cancel the changes.

# Add a device

Adding a new device is done by clicking on the button labeled "ADD DEVICE", which opens a modal with the following elements

  • Name, the descriptive label to be assigned to the device, which must comply with the Plexus nomenclature criteria
  • Device IP address, the IPv4 address configured for the device on the network.
  • Device type, the type of device connected.

# Types of devices

To date, PlexusLAB offers the possibility to add one or more devices among the following types

Name Information
PlexusPOD 0-10V 🤒 POD which allows operation with elements at 0-10V
PlexusPOD 4-20mA 🤒 POD which allows operation with elements at 4-20mA
PlexusPOD C1 🤩 Future version of the POD in production from Q3 2021, which allows the possibilities to switch individually the analog / digital channels operate at 0-10V or 4-20mA
Plexus_1 🤒 Old version of the POD dated 2016, being discontinued
Plexus_Bridge Virtual, to connect another PlexusLAB Web Server and interface with the sections of the latter, which acts as a bridge; in the “Bridge Password” field it is necessary to enter the password to authenticate the connection to the target PlexusLAB. Refer to this paragraph for more informations
Mod Bus An industrial automation systems already on the market. Modbus uses several communication protocol, to name one, PLC. The addition of a device of this type involves the insertion of additional values that indicate the ranges of registers with which to interface in reading / writing to the system that uses Modbus, in the four fields “ModBus Read Register”, “ModBus Read Interval Range”, “ModBus Write Register”, “ModBus Write Interval Range”

# Command the status of the device

Each device has a switch next to the name, which controls its status.

When a device is turned off (gray switch) its status is Not active in the view and all values will be shown at 0.

When a device is turned on (green switch) the following conditions may occur in the view:

  • State in Green with indication of the milliseconds measured as response time. In this case the device is up and running, the view shows information on the channels in real time;
  • State in Timeout!, status indicating that the device is not responding, so all values will be 0 in the view. Investigate one of the possible causes of the problem, which are usually:
    • misconfigured IP address
    • lost connection
    • worst case scenario, device failure.

# Re-ordering the devices

It is done by clicking on the "Edit Order" button at the bottom of the device list; note that the button is shown only when there are at least 2 devices configured.

When clicked, a modal window is displayed that allows you to drag the rows and, if necessary, save the new order in order to see the list with the desired structure.

# View

The View is the portion of the screen dedicated to the detail of the currently selected device (blue icon and label in the list).

The name of the device is shown at the top, a badge which indicates its type, the IP address configured and clickable for it (to access the configuration screen inside the device itself) and finally an info button that allows you to modify the configuration that are previously set when adding the device.

# Edit a device

You can edit the device IP Address and Device Name by clicking on the info button at the top right.

# Remove a device

You can delete a device by clicking on the info button at the top right and click on delete.

# API

You can read and write PlexusLAB through RESTful API. Make sure you enable API mode on System Page first.

POST REQUEST

IPADDRESS/plexus/api/api.php?json={"psw":"aaa"} 
IPADDRESS/plexus/api/api.php?json={"psw":"aaa","write":["FOO"]}

GET REQUEST

IPADDRESS/plexus/api/api.php?json={"psw":"aaa"} 
IPADDRESS/plexus/api/api.php?json={"psw":"aaa","read":["FOO"]}

# Plexus Bridge

Plexus Bridge allows you to interconnect two or more PlexusLAB(s) together; this may be useful when there is more than one single network in the enviroment and you want to control all your PlexusLAB(s) from a Master machine without moving between them.

PlexusLAB must be installed on each machine you need to link, of course. For example, you can have:

  • an Ubuntu OS machine (A) on a private subnet, connected directly to a PlexusPOD
  • a second Ubuntu OS machine (B) exposed to the public network, with no PlexusPOD connected directly to it
bridge
Bridge

You're able to retrieve the variable/data from (A) if you register and connect (B) to it.

To start, make sure both PlexusLAB(s) have the API/Bridge Mode turned on in the System page.

q2w6MV1DwBAwBAwBQ6A+ETCyqk90rW9DwBAwBAyBnCDwf2m5qTVHuHusAAAAAElFTkSuQmCC
API/Bridge Mode ON
api_password
Copy this API Password From The PlexusLAB that you want to connect to

# Bridge configuration steps

The following steps refer to (A) and (B) from the previous example:

  1. Add a Bridge Device in PlexusLAB (B)
  2. Copy the password from the PlexusLAB (A), the one you want to connect to
  3. Paste the password into PlexusLAB (B) that will be your Master machine
  4. Add a bridge variable in PlexusLAB (B) that you want to read / write from the PlexusLAB (A)
adding_bridge
API Password

For a video explanation you can also refer to this video (opens new window)

Last Updated: 8/3/2021, 1:02:24 PM