WRTU Client User Manual
Contents
1. WRTU Client User Manual Date 29 May 2014 Document Revision 1 05 Wireless Solutions for the Real World 2014 by BiPOM Electronics Inc All rights reserved WRTU Client User Manual No part of this work may be reproduced in any manner without written permission of BiPOM Electronics All trademarked names in this manual are the property of respective owners www bipom com Page 2 TABLE OF CONTENTS 1 Introduction 2 Hardware Setup 3 Software Setup 4 Windows WRTU Client 4 1 Run Client 4 2 WRTU Client Options 4 3 Online Help 4 4 Information about WRTU Client 4 5 Checking for software updates 4 6 Save Load Project 4 7 Communications settings 4 8 ADC Calibration 4 9 DAQ2543 Self Test Values 4 10 LCD Options 4 11 System Information 4 12 Tags 4 12 1 Adding New Tags 4 12 2 Adding New Tags General Settings 4 12 3 Adding New Tags Values Map Settings 4 12 4 Adding New Tags Calculations amp Scaling Settings 4 12 5 Adding New Tags Alarm Settings 4 12 6 Editing Tags 4 13 Contacts 4 13 1 Excel Import Contacts 4 13 2 Adding New Contacts 4 14 Logged Data 4 15 Software Log Appendix A Sources of Firmware Reset Appendix B Error Codes Appendix C Internal MODBUS Registers www bipom com Page 3 1 Introduction This document describes how to setup and configure Wireless Remote Terminal Unit WRTU Software and BiPOM Web Portal WRTU allows monitoring and logging different physica2. 4 7 Communications settings All communications options are grouped on Communications tab Peripherals Tags Contacts Logged Data Software Log General Name WRTU RTU Number 1 GPRS APN Settings C Cell Communications SMS Time Limit 15 minute s RS485 Port Baudrate Parity None UART1 RS232 Port Baudrate 115200 Parity None Figure 15 Communications Settings Name The device name Any text up to 31 characters RTU Number A number from 1 to 255 this is used in MODBUS communication Only requests with this RTU Number will be processed by the device Cell Communications Enable disable cell communications If this option is disabled no SMS alarms or request through GPRS will be processed www bipom com Page 20 Wireless Solutions for Server APN server name Used for initializing cell modem GPRS internet This comes from SIM card plan Username Password These are username and password required by APN server If they are not required leave these fields blank RS485 Port Settings RS485 serial port communications options for communicating with other MODBUS devices UART1 RS232 Port Settings RS232 serial port communication options This port is used for processing incoming MODBUS requests IMPORTANT RS485 and RS232 port settings are applied only after a firmware restart www bipom com Page 21 Wireless Solutions f
3. Export Data 1667 05 07 2 1668 05 07 2014 16 49 01 TAG 1 1 1 1669 05 07 2014 16 49 58 TEST 2 2 1670 05 07 2014 16 50 01 TAG 1 1 1 1671 05 07 2014 16 50 58 TEST 2 2 Figure 35 Number of records in tab titles www bipom com Page 50 Export Data All read log records can be exported to an Excel or a CSV comma delimited file Click Export Data button to open the Export Data Window File M Temp Data csv Records Format Data CSV File Alarms Excel File Events i v vi 2 VI v vi vi vi M Figure 36 Export Data Window File Path to file to save log records Records These checkboxes allow saving only the desired type s of records Format Output file format Excel Microsoft Excel 2010 file format CSV Comma delimited text CSV file format Fields These checkboxes allow selecting only the required fields for each record Each record type on separate sheet This option is available only for Excel file format If this option is checked then Data Alarm and Event records are grouped in 3 separate Excel sheets in the same Excel workbook If this option is unchecked all records are put on the same Excel sheet Colorize records This option is available only for Excel file format If this option is checked then Data Alarm and Event records have different background colors This makes viewing easier when all the records are places on the same Excel sheet www bip
4. If DAQ2543 board has a hardware problem then the values may range from 0 to 4095 www bipom com Page 23 4 10 LCD Options Screens Delay this option controls how fast screens on LCD will be switched LCD shows information on several screens Main screen show general information about device Modem Status screen shows information about modem current status Tags data screen shows information about current values of configured tags if a lot of tags added system will have more than 1 tag s screen Screens Delay option allows you change delay between screens Than larger delay than longer each screen will be presented on LCD www bipom com Page 24 Wireless Solutions for the Real World 4 11 System Information System information is displayed on System tab The available actions and presented information depended on current mode of WRTU Client The System tab in Offline Modeis shown on Figure 15 File Tools Help Communications Peripherals Tags Contacts Logged Data Software Log System Information Connect State Disconnect Hardware Type nanoWiPOM Start Logger Firmware Version UNKNOWN Stop Logger Firmware Status Upgrade status unknown DAQ 2543 UNKNOWN Cell Modem UNKNOWN Date Time UNKNOWN Restart Firmware Logger State UNKNOWN Upgrade Firmware Figure 17 System tab Offline Mode In Offline Mode the only available actions are Conne
5. Import Contacts Contacts can be imported to the project from an Excel spreadsheet file using the following format Column Value First Name Last Name Phone 1 Country Code Phone 1 Phone Number without country code Phone 2 Country Code Phone 2 Phone Number without country code Email 1 Email 2 Title SG JOTUN RAO ROR Table 3 Contacts Excel File Format Sample of valid Excel spreadsheet file for contacts A B C D E F G H 1 Some User 1 555 555 7802 1 555 555 7803 some useri wipom net some user2 wipom net 2 Another User 1 555 555 7804 another user wipom net 3 Third User 1 555 555 7805 third user wipom net 4 5 Figure 31 Contacts Excel File Sample www bipom com Page 47 Mr Wireless Solutions for the Real World 4 13 2 Adding New Contacts Click Add button on Contacts tab to open Add New Contacts window Add New Conatct Figure 32 Adding New Contacts Fill only the required fields and click Add button to add contacts to project Only the First Name field is mandatory other fields can be blank To be able to send SMS messages at least one phone number and the corresponding country code field should be filled Phone number can contain only digits and dashes Phone number cannot have dashes at the beginning or at the end www bipom com Page 48 Wireless Solutions for the Real World 4 14 Logged Data L
6. Search action already started 1013 Find end of log records 1014 Sector number is incorrect UART1 Driver 1101 UART1 driver is not initialized 1102 Failed to clear RX buffer 1103 Failed to clear TX buffer 1104 Read Timeout 1105 Write Timeout 1106 No data to read USB Driver 1201 UART1 driver is not initialized 1202 Failed to clear RX buffer 1203 Failed to clear TX buffer 1204 Read Timeout 1205 Write Timeout 1206 No data to read Communication Protocol Code Description 1301 Unknown command received www bipom com Page 58 Appendix C Internal MODBUS Registers Digital Inputs 10001 Digital Input 1 10002 Digital Input 2 10003 Digital Input 3 10004 Digital Input 4 Digital Inputs Frequency Counter Code Description 40113 Digital Input 1 40114 Digital Input 2 Digital Inputs Pulses Counter Code Description 40128 Digital Input 4 High 2 bytes of LONG value 40129 Digital Input 4 40122 Digital Input 1 High 2 bytes of LONG value 40123 Digital Input 1 Low 2 bytes of LONG value 40124 Digital Input 2 High 2 bytes of LONG value 40125 Digital Input 2 Low 2 bytes of LONG value 40126 Digital Input 3 High 2 bytes of LONG value 40127 Digital Input 3 Low 2 bytes of LONG value Low 2 bytes of LONG value NOTE Bytes placed in following order High b
7. WRTU Client is available on BiPOM web site Do yo want to download and install it now NOTE Update will be downloaded in background You can continue work with software Figure 13 Window when software updates are available If a new version is found click Yes and WRTU Client downloads and installs the new version in the background www bipom com Page 17 Wireless Solutions for the Real World When the download completes the following window is shown New version of WRTU Client is downloaded Do you want to install it now IMPORTANT WRTU Client will be closed All changes will be saved Figure 14 Warning window when starting software update If you click Yes then current WRTU Client software is closed and all project changes will be saved automatically If changes done in new project then software will prompt to select file where save changes After this system will start update installer If you click No then the window is closed and no further action is taken www bipom com Page 18 4 6 Save Load Project All changes in device configuration can be saved as a Project This is helpful for creating a configuration once and using it for several devices When WRTU Client starts it creates a new project with default values You can edit and change the project configuration even when the nanoWiPOM board is not connected to the PC Any changes can be saved to Project file Also you can load previously save
8. device to restart firmware WRTU Client will be switched to offline mode automatically Upgrade Firmware Start firmware upgrading www bipom com Page 28 Wireless Solutions for the Real World 4 12 Tags WRTU uses tags to monitor inputs control outputs and to describe logging options and alarm settings for each input Tags are entered by the user and they are typically assigned meaningful names when they are first created The tags in the current configuration are displayed under the Tags tab Type Log Period sec Add 60 Edit Delete Figure 19 Tags tab On this tab user can add new tag s edit existing tag s and remove tag s Add This button opens Adding New Tags where a new tag can be created and configured Edit This button opens Editing Tags where existing tags can be configured Delete This button deletes all the selected tags from the project Delete All This button deletes all the tags from the project www bipom com Page 29 BIP M Electronics InG Wireless Solutions for the Real World 4 12 1 Adding New Tags When user clicks button Add then Adding New Tags is opened Enable Logging Log Period sec RS485 Modbus Slave Parameters RTU Number Register Type Modbus Register Figure 20 Add New Tag Window This window has 4 tabs General Values Map Calculations amp Scaling Alarms www bipom com Page 30
9. level When Limit type of alarm is selected WRTU can check several thresholds Low Low Low Normal High and High High Only the desired thresholds can be enabled using the checkboxes to the right side of each alarm level General Values Map Calculations amp Scaling Alarms Alarm Info Type Limit Timeout Deadband gogan Low Low ggi Only Low Low and Low Low levels enabled ag High High High Alarm Condition SetMessage Low Set Contacts L Figure 25 Adding New Tags Enabling Alarm Levels WRTU Client checks that all the alarm thresholds have correct values according to the rule Low Low lt Low lt High lt High High If Deadband is not zero then Deadband is also used for checking the entered threshold values according to the rules Low Low Deadband lt Low Low Deadband lt High High Deadband lt High High www bipom com Page 40 Alarm Condition This list is used for assigning SMS messages and Contact s to each alarm condition configured for the tag Assign SMS message To assign an SMS message to the alarm condition e Select desired alarm condition in the list e Click the Set Message button This opens the Message window Message Alarm Message Device DN Tag TN Raw value RV Conv value CV U Figure 26 Adding New Tags Message Window Using the Message wind
10. raw value to PSI Bars or other values www bipom com Page 38 Wireless Solutions for the Real World 4 12 5 Adding New Tags Alarm Settings General Values Map Calculations Scaling Alarm Info Type None Timeout Deadband Low Low Low High High High Alarm Condition Set Message Set Contacts Figure 24 Adding New Tags Alarm Settings This tab allows configuring alarm conditions for a tag Each tag can have an alarm condition and WRTU will check the tag s value to see if it matches the configured alarm condition When an alarm condition is detected WRTU sends the configured SMS message to assigned Contact s Type Type of alarm System supports 2 types of alarm conditions Limit and Value Changed Limit Alarm is generated when the tag s value crosses a preset level Value Changed Alarm is generated when the tag s value is changed Timeout The alarm condition should be present during this Timeout period number of seconds before the system will generate an alarm This prevents the system from generating false alarms when the value is quickly varying around the preset alarm level www bipom com Page 39 Wireless Solutions for the Real World Deadband Tag s value should cross the Deadband zone before system will generate an alarm This prevents the system from generating false alarms when the value is quickly varying around the preset alarm
11. W has assigned message but do not have assigned contact s No message will be sent Do you want edit these settings before save add tag Figure 29 Warning message when alarm condition configuration is not completed When tag s configuration is completed click the Save button to save the configuration in the current project Correctly configured tag will be saved and added to the tags list www bipom com Page 44 4 12 6 Editing Tags Tags can be edited using the Edit button Editing Tags window is the same as Adding New Tags but all fields are filled with tag s configuration data when the window is opened See section 4 12 1 Adding New Tags topic for more information about tag window controls www bipom com Page 45 Wireless Solutions for the Real World 4 13 Contacts WRTU can have contact entries that describe the people who will receive the alarms that are generated by the tags The contacts included in the current configuration are displayed under the Contacts tab File Tools Help System Communications Peripherals Tags Figure 30 Contacts Tab Import Imports contacts from an Excel file Add Adds a new contact Edit Edits the selected contact Delete Deletes the selected contacts from the project Delete All Deletes all contacts from the project www bipom com Page 46 Wireless Solutions for 4 13 1 Excel
12. Wireless Solutions for the Real World 4 12 2 Adding New Tags General Settings General Values Map Calculations amp Scaling Alarms General Info Name Enable Logging Log Period RS485 Modbus Slave Parameters RTU Number Register Type Modbus Register Figure 21 Adding New Tags General Settings This tab provides general information about tag Name Descriptive name of the tag Type Type of data source for the tag Address MODBUS address of the tag Depending on the selected Type the list of available MODBUS registers will be updated Units Units for the tag s value when the value is shown somewhere on the display in Logged Data table in WRTU Client or when exported to a file www bipom com Page 31 Enable Logging Flag to enable disable data logging for the tag This is typically used when the tag is used only to generate alarm s and there is no need to log the data for the tag Log Period Data logging period in number of seconds for the tag 0 means log data as fast as possible www bipom com Page 32 RS485 MODBUS Slave Parameters If tag s Type is selected as RS485 MODBUS then RS485 MODBUS Slave Parameters list is shown to specify RS485 tag addressing RS485 MODBUS is a special tag type that is used when tag s data is read from a slave MODBUS RS485 device using MODBUS RTU protocol To communicate with a MODBUS devic
13. are Reset 40108 Last System Error Code See Appendix B for list of possible errors 40109 Uptime in seconds low word 40110 Uptime in seconds high word 40111 Hardware Status Please see Note C 1 below 40112 Firmware Version Please see Note C 2 below 40115 Total MODBUS Errors counter reset on system start 40116 Total MODBUS Exceptions counter reset on system start 40117 Total DATAFLASH Write Errors counter reset on system start 40118 Total DATAFLASH Read Errors counter reset on system start 40119 Total SD card Write Errors counter reset on system start 40120 Total SD card Read Errors counter reset on system start Cell Modem Type 0 Unknown 40121 1 WMP50 2G 2 HE910D 3G 3 CloudGate nanoWiPOM used as peripheral board on CloudGate device Read only Registers www bipom com Page 61 Hardware Status Bit Description 0 Core system initialized 1 UARTO driver initialized 2 UART1 driver initialized 3 UART2 driver initialized 4 UART3 driver initialized 5 USB driver initialized 6 IO driver initialized 7 ADC driver initialized 8 UARTO service initialized 9 RS485 service initialized 10 Cell modem service initialized 11 USB service initialized 12 Display driver initialized 13 DAQ2543 driver initialized 14 Cell modem detected If bit set to 0 it means that device driver subsystem was not initialized some issues detected If bit set t
14. ct and Upgrade Firmware Connect When you click Connect button you run Connection Wizard which help connect to the board and switch client to Online Mode Also device information is not available in Offline Mode It will be updated only when WRTU Client will be switched to Online Mode Upgrade Firmware When you click Upgrade Firmware button you can select WRTU firmware HEX file and upload it to the device This will works even when WRTU Client is not connected to device www bipom com Page 25 Wireless Solutions for the Real World The System tab in Online Mode is shown on Figure 18 File Tools Help System Communications Peripherals Tags Contacts Logged Data Software Log System Information Synchronize State Disconnect Hardware Type nanoWiPOM Start Logger Firmware Version Stop Logger Firmware Status DAQ 2543 Synchronize Time Cell Modem Date Time 05 07 2014 15 39 05 Restart Firmware Logger State Figure 18 System tab Online Mode When WRTU Client changes to Online Mode the following information is updated State Current state of WRTU Client it can be ONLINE or OFFLINE ONLINE client is connected to device OFFLINE client is not connected to device Hardware Type The board name in hardware setup Depending on the board WRTU client may have different features and capabilities Possibl
15. d project file into WRTU Client File menu has all the operations related to project management Load Project Opens dialog to select previously saved project file and load it into WRTU Client Save Project Saves changes to the project Save Project As Allows saving the project using a different file name Reset Project Resets the configuration to its default values Note that project file does NOT contain and save the following values Status of logger modem peripherals date time firmware version These values available only when the nanoWiPOM board is connected to PC and WRTU Client is in Online mode All values from Peripherals tab These values are hardware related and available only in Online mode Logged data is also not saved In order to save a project Run WRTU Client Make the required changes to configuration Go to File menu and click Save Project Select file in opened dialog or enter new name and click OK In order to load a project Run WRTU Client Go to File menu and click Load Project Select file in opened dialog and click OK In order set default values to project Go to File menu and click Reset Project IMPORTANT All changes made in current project will be applied to the board only during connection to the board or when synchronization is started manually using the Synchronize button on System tab www bipom com Page 19 Wireless Solutions for the Real World
16. ding Register www bipom com Page 34 Add Add button creates a new entry in the values map Each entry contains 2 values Value A number tag s value Text A string which will be shown instead of the number in value column Delete Deletes the selected entry Delete All Deletes all entries www bipom com Page 35 Wireless Solutions for the Real World Type Value A Value B Scaling O Enable Scaling Current Counts 476 Zero Scale Counts 0 Full Scale Counts 65535 Zero Scale Output 0 000 Full Scale Output 65535 000 Figure 23 Adding New Tags Calculations amp Scaling Settings This tab provides controls to configure Calculations and Scaling rules on tag s value WRTU can convert the raw numeric value to a more meaningful value using predefined equations and or scaling rules www bipom com Page 36 Wireless Solutions for Calculations Raw tag s data can be converted using one of predefined equations Type Supported equation types No Calculations Value is not converted Linear Value is converted using the linear equation Y A X B Quadratic Value is converted using the quadratic equation Y A X B Where X Tag s raw value Y Tag s converted value A and B Constant coefficients entered in Value A and Value B fields Multiplication operation A Power operation For example the tag fo
17. e over RS485 using MODBUS RTU WRTU has to know the RTU Number of the slave device and MODBUS register address RS485 MODBUS Slave Parameters provides set of controls which allow configuring these parameters RTU Number RTU Number of slave device Register Type The type of target MODBUS register This helps to accurately check if register address is entered correctly MODBUS Register Address of target MODBUS register WRTU will check if the address is correct depending on the selected Register Type www bipom com Page 33 Wireless Solutions for the Real World 4 12 3 Adding New Tags Values Map Settings General Values Map Enable Values Map Text WDT Figure 22 Adding New Tags Values Map Settings This tab provides controls to configure Values To Text mapping for some types of tags This is useful when a tag s values are limited to a set of constants which can be mapped to text After such mapping the tag s value can be displayed as text instead of a number For example register 40107 returns the reason for the latest board reset as an integer constant Since this register returns a limited set of values 0 to 6 each value can be mapped to a corresponding text Enable Values Map This flag enables disables this feature Only the following tag types support values map feature Analog Input Holding Register DAQ2543 ADC RS485 Modus when Register Type set to Hol
18. e values UNKNOWN WiPOM nanoWiPOM CG9101 nanoWiPOM UNKNOWN hardware type is unknown is shown when client not connected to hardware WiPOM hardware has installed WiPOM board nanoWiPOM hardware has installed nanoWiPOM board CG9101 nanoWiPOM Cloudgate version of nanoWiPOM www bipom com Page 26 More information about WiPOM board htip www bipom com products us 4379874 html More information about nanoWiPOM board http www bipom com products us 4357735 html More information about CG9101 nanoWiPOM board hiip www bipom com products us 4380902 html Firmware Version The version of the firmware running on the device Firmware Status Each WRTU Client release also includes the latest firmware binary file When the Client connects to device it checks if the current firmware is an older version If so the Client shows a prompt to upgrade the firmware to the latest version Possible messages Upgrade not required This means that the device has the latest firmware Upgrade button will be disabled New version is available This means that the client has a more recent version of the firmware than the one on the device Upgrade button will be enabled NOTE It is recommended to upgrade to the latest firmware when it is available WRTU Client may have features available only for latest firmware Also latest firmware may include bug fixes and other improvements DAQ2543 This status field shows information about DAQ2543
19. ent device configuration including tags configuration Configure device name date time hardware calibration RS485 port settings Add edit delete tags Configure alarms conditions individually for each tags Configure conversion parameters for tag value Start stop logger Upgrade firmware Read collected data from device to server database periodically period is configurable by user Export collected data events and alarms to Excel compatible format Read tag s state in real time Draw charts for selected tags www bipom com Page 4 2 Hardware Setup 2 1 Using nanoWiPOM Before powering set the jumpers on the nanoWiPOM as needed for your application Refer to nanoWiPOM User Manual for the details of jumper settings The simplest way to power nanoWiPOM and communicate with the Windows PC is the mini USB cable Figure 1 Power nanoWiPOM with USB connection www bipom com La Page 5 Figure 2 Inserting MicroSD card The LED s should both turn on and then the bi color LED should remain solid green while the other LED will blink orange Solid green means power level is good and nanoWiPOM is ready for use Orange LED shows communications Blinking Orange LED indicates that nanoWiPOM is trying to establish communications Solid Orange LED indicates that the communications is established If the bi color LED turns red this shows a fault If the bi color LED turns solid red or blinks red contact BIPOM Elect
20. essage record index 213 Unsupported version of message record 214 Unsupported version of tag configuration www bipom com Page 55 Core MODBUS Subsystem Code Description 401 Unsupported register address 402 Unknown function ID 403 RTU is incorrect in reply 404 Function ID is incorrect in reply 405 CRC16 is incorrect in reply MODBUS RTU Subsystem Code Description 501 Request data is not complete broken 502 Too big request data no space in internal buffer 503 Unknown function ID 504 Bad CRC16 of MODBUS request reply 505 Processing MODBUS request failed MODBUS TCP Subsystem Code Description 601 Request data is not complete broken 602 Too big request data no space in internal buffer 603 Unknown function ID 604 Processing MODBUS request failed 605 Unknown Protocol ID 606 Length in MODBUS TCP header is incorrect RS485 Driver Code Description 701 RS485 driver is not initialized 702 Failed to clear RX buffer 703 Failed to clear TX buffer 704 Read Timeout 705 Write Timeout 706 No data to read 707 Echo not received www bipom com Page 56 Cell Modem Driver Code Description 801 Cell Modem Driver is not initialized 802 Failed to clear RX buffer 803 Failed to clear TX buffer 804 Read Timeout 805 Write Timeout 806 Read operation d
21. he selected contact from Assigned Contacts to Available Contacts lt lt Moves all contacts from Assigned Contacts to Available Contacts The assigned SMS message will be sent only to the contacts that are in Assigned Contacts list To save the selected contacts in tag s configuration click the Save button Click Cancel button to exit without saving www bipom com Page 42 Wireless Solutions for the Real World Note that when the alarm condition has an assigned SMS message then letter M is added to the list item When alarm condition has an assigned Contact then letter C is added to the list item General Values Map Calculations amp Scaling Alarm Info Type Limit R E amp ODO Set Message Set Contacts Figure 28 Adding New Tags Alarm Condition List In this screenshot the tag has 3 alarm conditions Low Low Low and Normal Low Low alarm condition has only an SMS Message assigned Low alarm condition does not have either SMS message or Contact s assigned Normal alarm condition has both an SMS message and Contact s assigned www bipom com Page 43 Wireless Solutions for the Real World Note that if an alarm condition item has only an SMS message assigned or only a Contact assigned WRTU Client detects this as incorrect configuration and shows a warning You have not completed alarm messages LOW LO
22. idn t return any data 807 No incoming TCP connection 808 No reply for AT command 809 Unknown reply for AT command 810 Data to read is available Hardware Subsystem Code Description 901 Hardware subsystem not initialized 902 DAQ2543 ADC self test failed 903 DAQ2543 ADC not initialized 904 Incorrect ADC channel number 905 Incorrect DI pin number 906 Incorrect DO pin number 907 Write DO failed 908 Read DI failed 909 LCD Contrast adjustment failed 910 LCD Backlight adjustment failed 911 LCD initialization failed 912 Incorrect LCD line number 913 Configure Cell Modem input port failed 914 DATAFLASH initialization failed 915 SD card initialization failed 916 No storage device detected no SD card and no DATAFLASH 917 Incorrect frequency channel number 918 Incorrect DAQ2543 channel number www bipom com Page 57 Data Storage Subsystem Code Description 1001 Unknown storage device ID 1002 Storage device not initialized 1003 Version structure has incorrect signature byte 1004 Version structure has incorrect version byte 1005 Version structure has incorrect LRC byte 1006 Data block has incorrect CRC16 1007 No data available to read 1008 Deep data check failed read data is different from wrote data 1009 Read operation failed 1010 Write operation failed 1011 Find structure not initialized 1012
23. l and environmental values like voltages currents temperature humidity and many others remotely WRTU uses either BiPOM s nanoWiPOM or CloudGate nanoWiPOM CG9101 nanoWiPOM board as the hardware platform nanoWiPOM is a miniature wireless remote monitoring computer based on STM32 Cortex ARM processor CG9101 nanoWiPOM is the same as regular nanoWiPOM except that it is designed as a plug in peripheral card for the CloudGate cellular gateway Software includes a Windows WRTU Client for configuring the system and read the logged data and the BiPOM Web Portal that allows remote access to nanoWiPOM boards for configuring the system and accessing the logged data Windows WRTU Client features Connect to device over RS232 serial port RS485 serial port or USB Read current device configuration including tags configuration Configure device name date time hardware calibration RS485 port settings Check hardware status and health information Add edit delete tags Configure alarm conditions individually for each tags including SMS and email capability Manage contact list for SMS and email support Configure conversion parameters for tag value Start stop logger Upgrade firmware Read collected data events and alarms Export collected data events and alarms to Excel compatible format Web Portal features Add edit delete WiPOM nanoWiPOM devices into customer account Communicate with device remotely through GSM modem GPRS Read curr
24. lient has to be in ONLINE state to be able to read the logged data from device Read All Records Read all logged records from device Read New Records Read only new records added from last time the records were read Clear Logged Records Clear all logged records on device Export Data Export read records to Excel or CSV comma delimited file www bipom com Page 49 Wireless Solutions for the Real World Read All Records Click Read All Records button to start reading log records from device While records are being read Reading Data window is shown Reading logged data from device can take time When all the data is read this dialog window will disappear 900 e ee Records Read 10080 Last Record Date Time 04 25 2014 18 05 17 Figure 34 Reading Data Window Reading Data window shows current status of data reading operation Number of read records and date of last read record All read records can be viewed under 3 different tabs Tag Values Alarms and Events On each tab the number of records in that tab is shown File Tools Help Tag Values 2001 Alarms 39300 Events 936 Read All Records Date Tag Name Raw Value Calculated Value a Er NE 1661 05 07 2014 i TEST 2 2 1662 05 07 2014 EE TAG 1 1 1 1663 05 07 2014 TEST 2 2 Clear Logged Records 1664 05 07 2014 TAG 1 1 1 1665 05 07 2 tees osoz Number of records 1
25. list www bipom com Page 53 Wireless Solutions for Appendix A Sources of Firmware Reset UNKNOWN Unknown source of system restart POR Power on Reset EXTERNAL A low level on Reset pin LOW PWR Low power management reset WDT Independent watchdog timed out WIN WDT Windowed watchdog timed out SOFTWARE Software Reset www bipom com Page 54 Appendix B Error Codes General Internal errors not shown on LCD Code Description 1 Invalid Argument Some function received wrong input data 2 Queue is empty when trying to read next alarm event from queue 3 Alarm event queue is locked 4 Timeout on wait operation Application Subsystem Code Description 101 Starting main task failed 102 Starting cell modem task failed 103 Starting RS485 server task failed 104 Starting USB server task failed 105 Starting UARTO server task failed 106 Starting data logger task failed Configuration Subsystem Code Description 201 No space for new tags 202 Load device configuration failed 203 Load tag s configuration failed 204 No space for new contact record 205 Invalid contact record ID 206 Invalid contact record index 207 Unsupported version of contact record 208 Load contact records failed 209 Load message records failed 210 No space for new message record 211 Invalid message record ID 212 Invalid m
26. o 1 it means that device driver subsystem was initialized Firmware Version Firmware version is encoded as an integer value It contains 2 parts Major version number and minor version number To get correct version it should be processed as Major VALUE 100 Minor VALUE 100 integer divide modulus For example if register returns value 211 decimal this means Major 211 100 2 Minor 211 100 11 Version 2 11 www bipom com Page 62
27. o change WRTU Client options do following steps Run WRTU Client Go to main menu Tools and click Options Check for software update on start Check for firmware update on Connect Auto Synchronize Changes Figure 10 WRTU Client Options There are 3 options which can be enabled or disabled Check for software update on start If this option is enabled then WRTU Client checks for available updates on BiPOM website every time the WRTU client is started Check for firmware update on Connect If this option is enabled then WRTU Client checks if the firmware on the connected nanoWiPOM board is older than the firmware available in WRTU Client setup If the board has old firmware WRTU Client will prompt to upgrade the firmware to the latest one Auto Synchronize Changes If this option is enabled then all changes made by user in device configuration will be synchronized immediately with the connected board The changes will be synchronized automatically only when WRTU Client is connected to the board in ONLINE mode If WRTU Client is not connected to the board OFFLINE mode then any changes will not be synchronized If this options is disabled then only way to write device configuration to the board manually click Synchronize button on the main screen of WRTU Client when it is in ONLINE mode www bipom com Page 14 4 3 Online Help In order to get help about WRTU Client online Run WRTU Client Go to Help men
28. ogged Data tab allows uploading log records from device to the computer clearing log records and exporting log records File Tools Help System Communications Peripherals Tags Contacts Logged Data Software Log Tag Values 1887 Alarms 35874 Events 892 Read All Records h hic cain Read New Records 1636 05 07 2014 16 33 01 TAG 1 05 07 2014 16 33 58 TEST 1638 05 07 2014 16 34 01 TAG 1 05 07 2014 16 34 58 TEST 1640 05 07 2014 16 35 01 TAG 1 05 07 2014 16 35 58 TEST 05 07 2014 16 36 01 TAG 1 05 07 2014 16 36 58 TEST 05 07 2014 16 37 01 TAG 1 05 07 2014 16 37 58 TEST 05 07 2014 16 38 01 TAG 1 05 07 2014 16 38 58 TEST 05 07 2014 16 39 01 TAG 1 05 07 2014 16 39 58 TEST 05 07 2014 16 40 01 TAG 1 05 07 2014 16 40 58 TEST 05 07 2014 16 41 01 TAG 1 05 07 2014 16 41 58 TEST 05 07 2014 16 42 01 TAG 1 05 07 2014 16 42 58 TEST 05 07 2014 16 43 01 TAG 1 05 07 2014 16 43 58 TEST 05 07 2014 16 44 01 TAG 1 05 07 2014 16 44 58 TEST 05 07 2014 16 45 01 TAG 1 05 07 2014 16 45 58 TEST 05 07 2014 16 46 01 TAG 1 05 07 2014 16 46 58 TEST 05 07 2014 16 47 01 TAG 1 Clear Logged Records Export Data er PE ek IND PN eet IND NE RE PN NE ND cet NE ND EP EN es eet PE gt ND N N nt LIND md LIND amt FIND AND ek LIND mb IND IND ek ND ad IND ad ND ad Figure 33 Logged Data Tab Note WRTU C
29. om com Page 51 Wireless Solutions for the Real World 4 15 Software Log Software Log tab shows all the messages generated by WRTU Client This is useful information for troubleshooting any problems File Tools Help System Communications Peripherals Tags Contacts Logged Data Date Time Message 05 07 2014 12 53 25 Software Started 05 07 2014 12 53 25 Configuration loaded 05 07 2014 12 53 25 Default Device Configuration created 05 07 2014 12 53 25 Changed to OFFLINE state 05 07 2014 12 53 25 Begin check for available software updates 05 07 2014 12 53 26 You have the latest WRTU Client version 05 07 2014 15 39 03 Changed to ONLINE state 05 07 2014 15 39 03 Device Features changes were written to device successf 05 07 2014 15 39 03 RS485 Configuration changes were written to device succ Figure 37 Software Log tab Clear button removes all messages from the list In this window a right click menu is also available this menu includes standard commands to copy text messages to Windows Clipboard Select All This command selects all the messages in the list Copy Selected This command copies selected message s to Windows Clipboard Copy All This command copies all messages selected or not selected to Windows Clipboard www bipom com Page 52 Wireless Solutions for the Real World Clear Messages This command removes all messages from the
30. or the Real World 4 8 ADC Calibration When tags with types Voltage RMS are used it is recommended to calibrate zero level on AN2 and AN3 ADC inputs to minimize errors These options are under the Peripherals tab Tools Help ADC Calibration LCD AN2 Zero Level Volts Calibrate ScreensDelay 2 sec AN3 Zero Level Calibrate DAQ 2543 ADC Bottom Point Middle Point Top Point Figure 16 Peripherals information The current calibration levelsis shown in read only text fields if calibration was done previously In order to save new zero level the WRTU Client must be in Online mode After this apply zero level signals to ADC input and when signal is stabilized click Calibrate button This will force hardware read current ADC input value and save it as Zero Level in configuration on device www bipom com Page 22 4 9 DAQ2543 Self Test Values Each DAQ2543 peripheral board has 3 inputs for self test These inputs setup to always return bottom middle and top values These values are shown on Peripherals tab Please see Figure 8 If DAQ2543 board is installed and accessible then these values should be very close to following Point Value Bottom 0 Middle 2047 Top 4095 Table 1 Good DAQ2543 Self Test Values If the DAQ2543 board is missing then values will be Point Value Bottom 4095 Middle 4095 Top 4095 Table 2 Bad DAQ2543 Self Test Values
31. ow enter the desired text that will be sent out when alarm the condition is detected Note that the message can contain some embedded keywords for substitution DN Substituted with device name TN Substituted with tag name RV Substituted with the tag s raw value CV Substituted with the tag s value after calculations or scaling U Substituted with Units text The buttons on the left side of the window allow quickly inserting these substitution keywords into message text When the message is composed click the Save button to save the message in the tag s configuration or click Cancel to exit without saving www bipom com Page 41 Assign Contact s In order to assign Contact s to the alarm condition e Select desired alarm condition in the list e Click the Set Message button This opens Alarm Contacts window Available Contacts Assigned Contacts Some User Figure 27 Adding New Tags Contacts Window This window has two lists Available Contacts and Assigned Contacts Available Contacts The list of contacts that were added to the project and not assigned to this alarm condition Assigned Contacts The list of contacts that were assigned to this alarm condition There are 4 buttons in the middle gt Moves the selected contact from Available Contacts to Assigned Contacts gt gt Moves all contacts from Available Contacts to Assigned Contacts lt Moves t
32. peripheral board If firmware detected this board then text will be DETECTED If firmware didn t detect this board then text will be NOT DETECTED FAILED Cell Modem This status field shows information about Cell Modem If firmware detected the modem then text will be DETECTED If firmware didn t detect the modem then text will be NOT DETECTED FAILED Also it shows type of detected modem WMP50 2G HE910 D 3G Unknown a modem was detected but it is an unsupported model Date Time This field shows the current date and time from the device and updates this information every second Logger State This status field shows information about data logger state The data logger state can be in 2 modes started and stopped If data logger is started then device shows text STARTED Also when data logger is stopped it shows text STOPPED When WRTU Client in Online Mode it can do following actions Synchronize Write current configuration loaded in the client to the connected device www bipom com Page 27 Wireless Solutions for Disconnect Switch WRTU Client to offline mode Start Logger Start Data Logger on connected device This means that device will watch inputs log data and generate alarms Stop Logger Stop Data Logger on connected device This means that device will not watch inputs so no logged data and no alarms will be generated Synchronize Time Set current PC time to RTC on device Restart Firmware Send command to
33. r MODBUS register 30005 returns the on board 5 Volt line voltage reading as the number of milliVolts To convert the value to Volts select Linear as the type of calculations Then enter Value A 0 001 Value B 0 As result if the tag has a raw value of 5000 the converted value will be 5 0 after the calculations www bipom com Page 37 Scaling Scaling allows scale raw tag value according to calibrated values Enable Scalin This flag enables or disables the scaling feature Current Counts This field shows the current raw value for the selected tag This value is updated every second when the WRTU Client is in ONLINE state This value is not updated when the WRTU Client is in OFFLINE state Zero Scale Counts Tag s raw value for bottom zero level To simplify the calibration WRTU client has the Set button that copies the Current Counts value to this field Full Scale Counts Tag s raw value for top full level To simplify the calibration WRTU client has the Set button that copies the Current Counts value to this field Zero Scale Output Output value which maps to bottom zero level Full Scale Output Output value which maps to top full level Software use 2 points linear scaling logic of value between zero and full points This feature is useful when the displayed logged value needs to be scaled to a meaningful physical value instead of the raw value One of possible application is converting pressure sensor
34. r name and click Install WRTU Client Setup 5 Completing the WRTU Client Setup Wizard WRTU Client has been installed on your computer Click Finish to dose this wizard Run WRTU Client lt Back i Finish Cance After all files are installed the last window of installation has the option to start WRTU Client after installation is completed Click Finish to complete installation WRTU Client will be installed on your PC www bipom com Page 9 Wireless Solutions for the Real World 4 Windows WRTU Client 4 1 Run WRTU client On Windows XP and 7 go to Start Menu open All Programs gt WRTU Client gt WRTU Client On Windows 8 open Start Screen and click WRTU Client icon After WRTU client starts System status window is displayed File Tools Help Communications Peripherals Tags Contacts Logged Data Software Log System Information Connect State OFFLINE Disconnect Hardware Type nanoWiPOM Start Logger Firmware Version UNKNOWN Stop Logger Firmware Status Upgrade status unknown DAQ 2543 UNKNOWN Synchronize Time CellModem UNKNOWN Date Time UNKNOWN Restart Firmware Logger State Upgrade Firmware Figure 5 Main window of WRTU Client in OFFLINE state www bipom com Page 10 BIP M Hlectronics InG Wireless Solutions for the Real World Power board Connect USB cable from board to PC Click the Connect bu
35. ronics for technical support www bipom com Page 6 Wireless Solutions for 2 2 Using CloudGate nanoWiPOM Part CG9101 nanoWiPOM Set the jumpers on the CG9101 nanoWiPOM as needed for your application Refer to CG9101 nanoWiPOM User Manual for the details of jumper settings Insert the optional MicroSD card on the CG9101 nanoWiPOM Figure 3 Inserting MicroSD card Insert the CG9101 nanoWiPOM into CloudGate front peripheral slot as shown Figure 4 Inserting CG9101 nanoWiPOM into CloudGate Power CloudGate through the power connector using the CloudGate Adapter or any other power source that is capable of powering CloudGate The LED s should both turn on and then Green LED should remain solid while the other LED will blink orange When power is applied Green LED turns ON Green LED shows power status Solid green means power level is good and nanoWiPOM is ready for use Orange LED shows communications Blinking Orange LED indicates that CG9101 nanoWiPOM is trying to establish communications Solid Orange LED indicates that the communications is established Red LED shows a fault If the Red LED turns on or blinks contact BiPOM Electronics for technical support www bipom com Page 7 3 Software Setup Download and run the latest WRTU software setup from BiPOM web site http www bipom com files wipom W RT UClientSetup exe WRTU Client Setup oe Welcome to the WRTU Client Setup Wizard Thi
36. s wizard will guide you through the installation of WRTU Client It is recommended that you close all other applications before starting Setup This will make it possible to update relevant system files without having to reboot your computer Click Next to continue Next gt Cancel Click Next on Welcome window WRTU Client Setup Choose Install Location PN Choose the folder in which to install WRTU Client a Setup will install WRTU Client in the following folder To install in a different folder dick Browse and select another folder Click Next to continue Destination Folder C Program Files x86 BiPOM Electronics WRTU Browse Space required 1 9MB Space available 159 8GB WRTU Client lt Back Next gt Cancel www bipom com Page 8 Either use default install location or chose a different location and click Next ng WRTU Client Setup Choose Start Menu Folder e Choose a Start Menu folder for the WRTU Client shortcuts SN Select the Start Menu folder in which you would like to create the program s shortcuts You can also enter a name to create a new folder WRTU Client 3piRobotControlPanel A ABBYY Lingvo 12 Accessibility Accessories Administrative Tools Adobe Advanced Installer 10 0 Advanced Serial Port Monitor Ashampoo Bitvise SSH Client Cain bs _ Do not create shortcuts WRTU Client lt Back Install Cancel Use the default Start Menu Folde
37. tton on WRTU client System tab Select COM port for USB nanoWiPOM USB port appears as a serial COM port to Windows It is typically a higher port number such as COM27 e WRTU Connection Wizard Select Communication Port Figure 6 Selecting COM port window Click Next QW WRTU Connection Wizard Options Synchronize Time to PC Time C Backup Device Configuration Path to Backup File Read Configuration from Device Write Configuration to Device C Go Offline After Wizard Completed Figure 7 Set synchronization options www bipom com Page 11 Wireless Solutions for the Real World Click Start Connection Wizard lt lt Previous Figure 8 Synchronization progress window When software read all information from the board it will show current status of device on main window www bipom com Page 12 BIP M Hlectronics InG Wireless Solutions for the Real World File Tools Help System Communications Peripherals Tags Contacts Logged Data Software Log System Information State Synchronize Disconnect Hardware Type Start Logger Firmware Version Stop Logger Firmware Status DAQ 2543 Synchronize Time Cell Modem Date Time 05 07 2014 11 32 53 Logger State Figure 9 WRTU Client in ONLINE state www bipom com Page 13 4 2 WRTU Client Options In order t
38. u and click Online Help This will open online help in default Internet browser Online help available at the web address http help bipom com index 4379895 html www bipom com Page 15 Wireless Solutions for the Real World 4 4 Information about WRTU Client To get information about WRTU Client installed on your PC Run WRTU Client Go to main menu Help and click About QW WRTU Windows Client Version 1 38 Release Date April 9 2014 BiPOM Electronics Inc All Rights Reserved Copyright 2013 2014 www bipom com Figure 11 WRTU Client About Dialog The main information is Version and Release Date This information is helpful for troubleshooting and technical support www bipom com Page 16 Wireless Solutions for the Real World 4 5 Checking for software updates By default WRTU Client software checks for new updates on every start This option can be disabled to check for new updates manually In order to check for new updates Start WRTU Client Select Help menu and select Check New Version WRTU Client then accesses BiPOM web site www bipom com and checks if a new version of WRTU Client is available If there is no new version on the web the following window is shown Gp You have the latest WRTU Client version Figure 12 Window when no software updates available If anew version of WRTU Client exists on BiPOM web the following window is shown The new version of
39. yte Low byte High byte i High register High bytes For example read values for DI 1 in Pulses Counter mode Register 40122 returns 0xA102 Register 40123 returns 0x0C15 The result unsigned long value will be 0xA1020C15 www bipom com Page 59 Digital Outputs Code Description 1 Digital Output 1 2 Digital Output 2 Analog Inputs Code Description 30001 Analog Input 1 AN2 30002 Analog Input 2 AN3 30003 Analog Input 3 PC3 30004 Analog Input 4 Battery voltage 30005 Analog Input 5 5V Analog Inputs RMS mode Code Description 30006 Analog Input 1 AN2 30007 Analog Input 2 AN3 DAQ 2543 Inputs 30008 Channel 0 30009 Channel 1 30010 Channel 2 30011 Channel 3 30012 Channel 4 30013 Channel 5 30014 Channel 6 30015 Channel 7 30016 Channel 8 30017 Channel 9 30018 Channel 10 www bipom com Page 60 Holding Registers Code Description 40001 Hardware Id 0 nanoWiPOM 1 WiPOM 1 unknown device 40100 RTU number 40101 RTC Year 40102 RTC Month 40103 RTC Day 40104 RTC Hour 40105 RTC Minutes 40106 RTC Seconds RESET Reason 1 POR Power On Reset 2 External Pin Reset 40107 3 Low Power Reset 4 Watchdog Reset 5 Window Watchdog Reset 6 Softw
Download Pdf Manuals
Related Search