background image

Time Server:  

Specify the DNS name or IP address of your time server.  The default “time.obvius.com” can be used if the 

AcquiLite has a connection to the Internet.  The AcquiLite will attempt to synchronize time with the time server every 
upload session.  This will ensure that the clock is checked and adjusted at a minimum of once per day.  Typically, the 
synchronization will align the clock to -1 second of the internet time source or atomic clock.  You may need to 
verify if your firewall will allow NTP or Rdate packets to pass through.  Generally, it is better to use a local time server if 
possible.  The time server time.obvius.com supports both NTP and Rdate time protocols.   If you use a GSM-connected 
system, you will probably need to use Rdate.  NTP is blocked by many cellular service carriers.  

Universal Time Is Your Friend

Log data is stored in UTC time.  This allows data collection services such as BMO to collect data from multiple sites in 
different time zones.  If you are operating your own database system to store log data from the AcquiLite, it is best to store 
the data in UTC time in the database as well, and only convert it to local time when generating the final report or graph for 
the user. 

If you store data in Local time, you will have the following issues. 

1) Local time is relative.  Is Local the time where the AcquiLite exists, or Local to where the data is stored? If local to the 

AcquiLite, you must shift each AcquiLite data set depending on its location. 

2) There are about 11 time zones in the US. Some observe DST, others do not.   These include Alaska, Aleutian, Arizona, 

Central, Eastern, Hawaii, Indiana, Michigan, Mountain, Pacific, and Samoa.

3) When converting to local time, there will be one hour of overlapping data in the fall when the time is adjusted for 

Daylight Savings time.  In other words, log entries run 12:45, 1:00, 1:15, 1:30, 1:45, 1:00, 1:15, 1:30, 1:45, 2:00am. 
This will prevent you from sorting your data by time in your database.

4) In the spring, you will have a gap in the data from 1:59 to 3:00am.  This can cause problems if you are calculating 

demand values based on consumption. 

5) Converting Local time to any other timezone usually involves converting it to UTC first. 

Using UTC time solves these problems elegantly.   The best practice is to store data in the database in UTC format and then 
convert the information when generating a report for the user.  

For example, if you wish to draw a graph of KW over Time, prompt the user for a date range, say Jan 1 midnight  to Jan 2 
midnight.  Take the user specified end points and convert these times from Local time to UTC.  Next, create an SQL query 
using the new UTC formatted data as your select statement. ie:

SELECT * from TABLE where time > '2003-01-01 08:00:00' and time < '2003-01-02 08:00:00'

Note that the time is 8 hours ahead of local time. This example is for Pacific which is 8 hours off from UTC. This will return 
a list of data points between the two specified time ranges.  Next, plot the data on a graph, using the UTC times for start and 
end points.  Lastly, when drawing the 'time' legend on the graph, convert the values back to Local time before displaying. For 
example, 2003-01-01 00:00:00 to 2003-01-02 00:00:00.  Any division lines on the time axis can be handled the same way. 
The advantage of using this technique is that it will properly draw a graph across DST change boundaries.  The graph axis is 
based on UTC time with no DST, and will not show a gap or overlap a the time of the change.  The axis labeling will be 
correct as well, matching the UTC times precisely.  

Another way to handle the conversion is to query and convert all the returned timestamps to local time before drawing the 
graph.  This is useful if you do not have detailed control over the graph legend drawing process. This technique will not 
properly graph across DST changes as the graph is based on local time including DST changes.

System logs

The AcquiLite can keep several log files that report the general operation of the system, not related to the normal data logs. 
These include the following:

Debug Messages:

 The AcquiLite can run a “syslog” process to record more detailed information about its operations, 

however this log consumes vast quantities of memory quickly, and is disabled by default.  Click the “start log” button to 
enable the feature.  Click the “end log” button to disable.  Note: when the AcquiLite is rebooted, the debug log will be 
disabled on startup.

Kernel Boot log

:  Startup messages about the Linux operating system startup.  This log shows what hardware items were 

detected and initialized. 

Ftp Connection log: 

This log shows a list of files transferred by FTP on the AcquiLite.  

Page 19

A7810 AcquiLite – Data Acquisition Server

www.calcert.com

[email protected]

1.800.544.2843

0

5

10

15

20

25

30

Summary of Contents for AcquiLite A7810

Page 1: ...B Data Acquisition Server Obvius LLC Installation and Operation Manual Model A7810 Date Aug 10 2011 Page 1 A7810 AcquiLite Data Acquisition Server www calcert com sales calcert com 1 800 544 2843 0 5 10 15 20 25 30 ...

Page 2: ...outside of Obvius s authorized facilities 4 has not been sold subject to other warranty terms specified at the time of sale and 5 is still owned by the original purchaser This warranty provides specific legal rights that may be varied by state law Obvius s products are not designed for life or safety applications Product Application Limitation Obvius products are not intended for use in critical a...

Page 3: ...ooting Ethernet Problems 18 System Options 18 Status 18 Processes 18 Date and Time 18 Universal Time Is Your Friend 19 System logs 19 Firmware Update 20 Diagnostics 20 Host Lookup 20 Connection Test 20 LCD Console 21 Log File Data 23 Log File Status 23 Log File Format 23 Log Storage Capacity 25 Uploading data to the BMO website 25 Retrieving Data From the AcquiLite 26 HTTP Direct from the AcquiLit...

Page 4: ...bit connection point hub or switch IP address and Netmask check with system administrator Gateway address check with system administrator DNS server address check with system administrator HTTP Proxy address optional may be required if the AcquiLite is behind a firewall check with system administrator 3 Insulation connected to meters inside high voltage panels should have an insulation rating in e...

Page 5: ...ms Pulse rate option 100hz minimum pulse width 5ms Contact closure threshold 100Ω to 2 5kΩ user selectable Pulse count values are stored in non volatile memory Isolation2 The RJ45 Ethernet is isolated to 1500VDC from the main board Power input Pulse inputs and USB port and are non isolated Environmental Pollution Degree 2 Altitude up to 2000M For indoor and outdoor use when used in an appropriate ...

Page 6: ...gerous if wire scraps come into contact with high voltage wires Step 4 Power up and diagnostics A power supply is not provided with the AcquiLite EMB therefore it is up to the installer to provide the required 24VDC After power is applied the green Alive light in the upper right of the AcquiLite should come on and the LCD display will display a series of diagnostic screens ending with the followin...

Page 7: ...he AcquiLite or Dynamic Host Configuration Protocol DHCP address this process assigns an IP address dynamically to the AcquiLite when it is connected to the network from a host DHCP server or Direct connection between the AcquiLite and a single temporary computer such as a laptop primary connection will be dialin or dialout by modem You will need the following information from your network adminis...

Page 8: ...tained automatically Simply select the Enable DHCP from the first TCP IP configuration menu Step 4 After the address information has been set you must reboot the AcquiLite Select the Previous Menu option after step B above The menu will then state that the AcquiLite must be rebooted to take effect Press the Select button to allow the AcquiLite to reboot Once the AcquiLite has rebooted the new IP a...

Page 9: ...nd the scope of this document however A From the Windows start menu select the Settings Network Connections option Double click the Local Area network connection icon in the network folder then click the Properties button B In the network setup dialog there should be a list of items including adapters clients and protocols Locate the item labeled Internet Protocol TCP IP Note If you have multiple ...

Page 10: ...e steps for each Modbus device Step 7 Select the Modbus Setup menu option Specify the Modbus Loop Name This will become the name of the AcquiLite This is the name that will appear on the BMO website service if subscribed Specify the data logging period The default is 15 minutes Step 8 Decide upon a method of data transfer see section later in this document If you select the HTTP Post method to sen...

Page 11: ...word for read only access Log information is stored in var log modbus For read write delete access use the login name root and the admin password The three usernames specified are not able to be changed or renamed nor can arbitrary usernames be added to the AcquiLite Access is only controlled by setting the password for the three existing usernames noted above The operator and user accounts are di...

Page 12: ... used to configure a Modbus device that is not presently connected to the system add a framework configured device or add a Modbus TCP connected device See the section on manually adding a device below Troubleshoot The AcquiLite will review the devices connected and offer suggestions about any problems found Rename all devices This option allows you to edit all the device names in one configuratio...

Page 13: ...f the page several buttons are present Done returns you to the device list page Log File This icon will display a table view of the most recent data in the current log file Use the log file export page for complete log data access XML This icon will show the current data from the Modbus device in an XML format The URL from this icon can be copied and used to gather xml data for client side Javascr...

Page 14: ...ata points are rotated about every 10 seconds The values on the LCD console are updated when the next log interval occurs Point Config Some devices have configurable point features Most data points are automatically configured and this option may not be displayed Advanced At the lower right corner of the page an advanced configuration button may be present depending on the Modbus device features A...

Page 15: ...ddress already listed in the device list page Modbus TCP Gateway IP This option allows the AcquiLite to log data from a remote Modbus device that is attached to the LAN via a Modbus TCP gateway device such as an EGX or Moxa gateway Modbus TCP Gateway Port If a remote Modbus TCP gateway is used the tcp port of the remote gateway must be specified The default TCP port is 502 on most gateways Device ...

Page 16: ... control based on the IP address of the system making the request The Modbus TCP protocol does not have provisions for any authentication password or other methods of security By default the gateway feature is disabled and set to No Access The Modbus TCP gateway is a feature that allows the AcquiLite to share the attached Modbus RS485 devices with other systems such as PCs with software and buildi...

Page 17: ... the wireless diagnostics options will be present in the AcquiLite Please refer to the AcquiSuite A8812 or A8810 user manuals for further details on the wireless diagnostic features Networking Network Status This page displays the current status of the AcquiLite network connections Several interfaces may be shown if both Ethernet and ppp dialin dialout are active at the same time Each interface wi...

Page 18: ...ommon mistake is configuring the Laptop IP to the same address as the IP address of the AcquiLite In order for the laptop and AcquiLite to communicate the IP addresses should not be identical see the basic network config for suggested IP addresses Use the LCD console to run the Network Status test This will attempt a number of things including a ping query to the gateway address If the AcquiLite c...

Page 19: ... data in the database in UTC format and then convert the information when generating a report for the user For example if you wish to draw a graph of KW over Time prompt the user for a date range say Jan 1 midnight to Jan 2 midnight Take the user specified end points and convert these times from Local time to UTC Next create an SQL query using the new UTC formatted data as your select statement ie...

Page 20: ...les will be displayed If any firmware updates are available a button to the right will be shown labeled Download The firmware files are asarm cramfs The main AcquiLite firmware file including the modbus and data logging software usrarm cramfs High level system support files such as FTP and timezone information ramdisk gz Low level system files and system libraries zImage The Linux operating system...

Page 21: ... failure is due to the password not being correct LCD Console The AcquiLite has an LCD console and two push buttons labeled Menu and Select These can be used to configure some of the basic features of the AcquiLite The intended purpose of the console is to configure the AcquiLite to a point where a computer can communicate with it for further detailed configuration When the AcquiLite is running it...

Page 22: ...ing requests This test does not verify if the DNS servers can actually resolve DNS names to IP addresses For a more complete test use the Connection Test web page in the AcquiLite diagnostics menu Modbus Status This option will report the number of devices currently detected by the AcquiLite The display will show a device count for Devices OK New and Failed These are as follows Devices OK The numb...

Page 23: ...name starts with mb xxx where xxx is the Modbus device address number One file with the log extension is the file where the most recent data is being stored Other log files have a gz extension These are older log data files that have been compressed to save space The file name will be a link that will open up a browser window to view the contents of the single log file Clicking on the single log f...

Page 24: ...8 No space left on device 32 Broken pipe 52 Invalid Exchange 101 Network is unreachable 110 Connection timed out 111 Connection refused 113 No route to host 129 Illegal Function function was not allowed by the slave device 130 Illegal Data Address the data address is not allowed by the slave device 131 Illegal Data Value 132 Illegal Response Length 138 Gateway Path Unavailable the Modbus TCP gatew...

Page 25: ... log files to your server you must manually delete them To delete log files refer to the FTP method of downloading log files One step detailed in the FTP section is how to delete a log file from the AcquiLite Uploading data to the BMO website After the AcquiLite has been configured and has logged some data you will want to collect the data for analysis There are several ways of collecting the data...

Page 26: ...information about the transfer process use the Connection Test page in the Testing Diags menu on the AcquiLite for a full report of the data upload progress Retrieving Data From the AcquiLite Overview of how the system was designed to work Now that you have installed your AcquiLite and configured it to collect data from your meters and sensors you will want to collect the data from your AcquiLite ...

Page 27: ...is uploaded Designed for integration with existing energy reporting systems Contact Obvius technical support for further details and sample scripts Removing Data From the AcquiLite When using an HTTP Post method to allow the AcquiLite to push data to a database server the AcquiLite will automatically remove log files from its flash memory once the AcquiLite has confirmed that the file was received...

Page 28: ...l be shown on that dialog Simply copy paste this URK into your link The AcquiLite can provide Modbus device data in XML format This feature coupled with browser based AJAX Javascript can provide a very powerful tool to allow the creation of custom web pages Further examples of XML and its uses are available on the Obvius website in the Documentation Technotes section Page 28 A7810 AcquiLite Data A...

Page 29: ...proximately 4 x 4 25 x 2 deep The AcquiLite has 4 mounting holes for use with a 6 screw The drawing above shows the relative position of the mounting holes Page 29 A7810 AcquiLite Data Acquisition Server www calcert com sales calcert com 1 800 544 2843 0 5 10 15 20 25 30 ...

Reviews: