How to perform configuration of TCW122B-CM with the SNMP Manаger LoriotPro. TCW122B-CM is a general purpose Ethernet controller for remote monitoring and control. It can be managed by WEB interface or SNMP Manager programs. Its I/O interface is suitable for solving problems like remote control, alarm systems, home process automation, control and management of computer networks etc.
Input Output feature of the TCW122B-CM:
- 2 digital inputs with “logic level” and “dry contact” modes;
- 2 analog inputs with input range from 0 to 60VDC;
- 2 relays with NO and NC contacts.
Before reading this document read the user manual of TCW122B-CM.
After configuring LoriotPro and TCW122B-CM the Active View dashboard will then be used to have a synthetic view of the device. Example below:
TERACOM SNMP Configuration
To be able to control the Teracom device with Loriotpro the configuration of the SNMP level is required. You must perform a WEB access on the device and configure the SNMP setup below.
Enable SNMP Configuration first and then select the SNMP community. These communities are a kind of shared password between the SNMP Manager and the Teracom SNMP agent. The same values should be defined in the agent and in the manager.
When done in the LoriotPro SNMP Manager you can add the TERACOM device. Select the network where your device is connected (if the network is not there add it manually or launch a discover – read the LoriotPro documentation for more details about network discovery option and IP Scanner)
The Insert Host screen pops up.
Enter the IP address of the Teracom device, the same Read-Only Community, and Read-Write Community. If the device is responding to SNMP the Name will automatically be assigned with the Name of the device defined in the SNMP configuration (the sysname object).
The new device is now visible in the directory tree.
The green indicate that the device is well responding to SNMP Ping. If the color is not green you should verify step by step that the following points are respected.
Your device should be at least blue, it means that LoriotPro SNMP Manger is able to communicate with the device and doing simple PING. Else check the network connectivity, remove firewall filter etc.
You should verify that the SNMP agent is enabling on TCW122B-CM and that the community strings READ ONLY and READ WRITE are set with the same values on LoriotPro and on TCW122B-CM.
You should let the SNMP version to V1 and port to 161
Check that no firewall is blocking port 161 between LoriotPro and TCW122B-CM.
After changing Host parameters must click button Refresh to display changes.
Adding the Teracom MIB inside LoriotPro
If the device is in the Green state you should now add the MIB file inside LoriotPro. The MIB file can be downloaded from the product page.
The MIB file should be placed into the directory Program Files\LUTEUS\loriotpro V6\ bin\mibs.
Then open the MIB compiler of LoriotPro Menu->MIB -> MIB Compiler
Browse the directory and select the MIB. Click on the “Compile This MIB File” button to perform the compilation.
When done you should have the Teracom entry in the MIB tree of LoriotPro.
You can select the Teracom object and then click right mouse button and select SNMP Walker to perform a WALK on the MIB object. Beware that the Teracom device should be first selected in the directory.
All the objects in the Teracom branch are collected with the SNMP GET NEXT command.
If you get a clean list of the object and their values you are ready to exploit the device with LoriotPro.
Using the SNMP Trap sent by the TERACOM device
The TERACOM device is able to send SNMP traps to the SNMP Manager LoriotPro. In the initial configuration of the TERACOM device, we specifically add the IP address of the LoriotPro. Thus we should receive this trap.
SNMP traps are sent if:
- event occurs (status change) on Digital Input 1 or Digital Input 2;
- measured voltage on Analog Input 1 or Analog Input 2 goes outside the range;
- measured temperature goes outside the range;
- measured humidity goes outside the range;
- restart condition.
To check that the configuration is well done and that LoriotPro will receive traps, you can simply:
1 -Perform a physical power off power on of the device then a restart device Trap should be displayed in LoriotPro in the TRAP log windows.
2 -You can also select the device in the directory and call the Tool option of the contextual menu and select the Plugin Sample: SetSNMP Value/
Enter the “restartdevice/(IN)1” and click send.
How to trigger an action when a threshold is reached
On trap reception, it could be necessary to trigger an action. LoriotPro provides a bunch of filtering and action options. You may look at the trap filter documentation to discover all of them.
In the case of the Teracom device, only one trap type can be received. The different types of Teracom TRAP can be identified with contains the Varbind 1. Varbind is an optional field that can be provided by the device constructor.
To create a filter on a Trap in LoriotPro you have to possibilities:
You can select the trap received in the trap log (of course you should be able to generate the trap manually) and call the contextual menu and select the TrapFilter Wizard option.
The second possibility consists of selecting the Event Trap Filter tab and then New Trap Filter.
A new window is displayed.
In the trap, type select the Enterprise / Notification option
In the Trap/ Notification name enter the word Teracom
And finish by clicking OK.
Using the dashboard for TERACOM device TCW122B-CM
Now that you have a responding device you can monitor it, why not using a very simple dashboard created with the LoriotPro Active View concept. Here under the result of such implementation with a working device. This view can be used with any Edition of LoriotPro.
The Relays can be managed from there too. When you click right on the Status box then the contextual menu is displayed.
On our example, the Relay is “on” and we select “off”. The SNMP SET screen is displayed.
Just click on the Set button to confirm.
How to install the Teracom Simple Dashboard
This chapter explains how to install the dashboard that we presented in the previous chapter.
Copy this file in the loriotpro directory /bin/config/active view/.
Select the Teracom Device in the LoriotPro directory tree and click right to open the contextual menu. Select the Insert Task option, then The Active View option.
A new popup is displayed asking you to select a template.
The file list of available ActiveView is displayed; select the TeracomSimpleActiveViewTemplate.cmp file that you have previously copied to this directory.
You are in edit mode and you can modify what you want. Read the LoriotPro documentation and the Active View chapter for understanding the Active View feature and configuration.
Click on the Process button to switch to the monitoring mode (blue arrow).
Teracom complex Dashboard for TCW122B-CM
The following dashboard for the Teracom TCW122B-CM provides more information and action capabilities.
You can see for each sensor the threshold set for alarm generation.
You can change the threshold by a double click on the value box.
You can reset the device with the rest button
This template can be downloading and used as is.
To install it, follow the same procedure as the one use for the previous simple dashboard.
Using Active View threshold to trigger event and action
The Teracom device offers the internal capabilities for sending alarm on a threshold. You can also set threshold and action within LoriotPro Active View.
We will see how to define that in a new Active View.
Add first an empty Active View attached to the Teracom device but these times don’t select the Active View template option. A new empty active will be created.
Drag and drop a text object and open its properties.
You can add rules base on the threshold that you want to set like in the configuration below.
When the thresholds are reached and an event is fired to LoriotPro and receives in the Event tab.
The Event can then be used to trigger Action like sending e-mail launching programs etc …
Refer to the Event chapter of the documentation of LoriotPro.
Courtesy of LUTEUS.