Avisaro 4.0 Series User manual

Technical User Manual
Avisaro 4.0 Product Series
including “PC Companion” Software
RS232 – CAN – 4..20mA – Analog
Version / Date 2019-10-12

1. TABLE OF CONTENT
Hint: Use <cntrl> key with mouse click within the table of content and on links within the document
to jump to the destination.
1. Table of Content 2
2. This Document 5
2.1. Document links 5
2.2. Current document version 5
2.3. History 6
3. Quick-Guide 7
3.1. Power Supply 7
3.2. Configuration 7
3.3. Connect your device 7
3.4. Add storage or Connect wirelessly 7
4. User Interface 8
4.1. Blink-Codes 8
4.2. Start and stop operation 8
5. USB storage stick 9
5.1. Choosing the right size 9
6. Using the RS232 interfaces 10
6.1. RS232 Data logging 10
6.2. Merge (“Sniffing”) data from two RS232/RS485 into one file 10
6.2.1. More details 10
6.2.2. Configuration 10
7. Using the CAN bus interfaces 13
7.1. CAN Data logging example 13
7.1.1. More details 13
7.1.2. Quick configuration guide 13
7.1.3. Initial Operating 15
Navigate to TOC Page: 2

7.2. CAN filter options 16
7.2.1. Filter CAN ID range 16
7.2.2. Filter single CAN IDs with interval 16
8. Data storage options 17
8.1. Storing 4..20mA data 17
9. Wireless Option 18
9.1. WPA Enterprise 18
10. Cloud, local access and streaming 19
10.1. FTP Client (Upload data to server) 19
10.1.1. Suitable FTP server 19
10.1.2. Required products 19
10.1.3. Avisaro configuration 20
10.1.4. Background information 22
10.1.5. Remote Firmware Update 22
10.2. FTP Server (Download data from logger) 23
10.2.1. Recommended FTP client and settings 23
10.2.2. How to download files from the logger 24
Typical error messages 25
11. PC Companion Software 26
11.1. Software Installation (“Security warning”) 26
11.2. Driver installation 27
11.3. Concept of operation 27
11.4. Initial Set-Up 28
11.5. Using the PC Companion Tool 28
11.6. Device Configuration ⇨ General Settings 29
11.7. Device Configuration ⇨ Global HW Settings 29
11.8. Interfaces ⇨ (1st) RS232/RS485 and (2nd) RS232/RS485 30
11.9. Interfaces ⇨ (1st) CAN and (2nd) CAN 31
11.10. Data Processing ⇨ Serial data (generic) 32
11.11. Data Processing ⇨ CAN data (generic) 33
11.12. Data Endpoints ⇨ USB Stick 33
11.13. Data Endpoints ⇨ Network (IP) 35
Page: 3 Navigate to TOC

11.14. Data Endpoints ⇨ Cloud Settings 36
11.15. Backup and Recover Configuration 37
12. Interface description and Pin Layout 38
12.1. Power (Barrel) 38
12.2. RS232 Interface 38
12.2.1. Default RS232 settings 38
12.2.2. Signal levels 38
12.2.3. D-Sub Connector 38
12.2.4. 2x RS232 Interface (“M41124” / “C41124”) 39
12.2.5. 1x RS232 “SILVER” ( “M41076”, “C41076” ) 40
12.3. RS485 Bus Interface 41
12.3.1. WAGO Connector 41
12.3.2. 1x RS485 “SILVER” ( “M42076”, “C42076” ) 41
12.4. CAN Bus Interface 42
12.4.1. CAN configuration and default settings 42
12.4.2. Signal Levels 42
12.4.3. D-Sub Connector (“M43014”, “C43014”) 42
12.4.4. WAGO Connector (“M43324” / “C43324”) 43
12.4.5. Screw type connector (“M43076”, “C43076”) 44
12.5. Analog Current loop (4..20 mA) Interface 45
12.5.1. WAGO Connector 45
12.5.2. Screw type connector 46
12.5.3. Electrical Characteristics 46
12.5.4. Recommended settings 47
12.6. Analog 10V Interface 48
12.6.1. Electrical Characteristics 48
12.7. Analog Resistive Sensor Input 49
12.7.1. 4x Analog Board Interface (“M4AB24”) 49
12.8. Analog 2V Interface 50
12.8.1. Electrical Characteristics 50
13. Internal and external options 51
13.1. Internal GPS receiver 51
13.2. Internal & external UMTS modem 52
Navigate to TOC Page: 4

14. Firmware Update 54
14.1. Firmware Update via USB stick 54
14.2. Firmware Update via PC Software 55
14.3. Firmware Update via FTP server / internet 55
15. Appendix 56
15.1. Understanding product serial numbers 56
15.2. CAN Storage Format Example “Text (CSV)” 56
15.3. CAN Storage Format Example “Vector CANalyzer” 57
2. THIS DOCUMENT
2.1. DOCUMENT LINKS
Links within the document are active - click to jump back and forth.
The document is read best online with a PDF reader.
2.2. CURRENT DOCUMENT VERSION
Check for the latest document version the following link:
http://www.avisaro.de/de/40_Dokumentation.html (German site)
Active links:
This document has active links. Click within the PDF on internal and external references to navigate
quickly to the target.
Page: 5 Navigate to TOC

2.3. HISTORY
2019-10-22
Added:
UMTS
FTP Upload information
Remote Firmware Update
2019-01-12
Added:
CAN Single ID filter
External GPS settings
Analog electrical limits
2018-12-01
Added:
RS232 details
2018-11-14
Added:
FTP download information
CAN example use case and storage format
2018-10-01
Added:
More details and error corrections
2018-03-06
Added:
More interfaces
2018-03-01
Added:
Initial version
Navigate to TOC Page: 6

3. QUICK-GUIDE
This should get you started in 5 minutes:
3.1. POWER SUPPLY
To operate the logger, connect regular power (6..32V) to the appropriate connector. Quite a few
functions (i.e. analog converter) need the regular power supply to work properly.
For configuration, a micro USB cable can be used to power the device, however for normal operation
a regular power supply is mandatory.
3.2. CONFIGURATION
Download the “PC Companion Tool” from the Avisaro website.
http://www.avisaro.de/de/40-PC-Software.html (German)
This tool is used to make all the settings - like baudrate and sample rates depending on your
interface. All products are shipped pre-configured, thus only a few settings are necessary if at all.
3.3. CONNECT YOUR DEVICE
Connect your device to the Avisaro product. The interface description is found further down in this
documentation.
3.4. ADD STORAGE OR CONNECT WIRELESSLY
Plug in a USB memory stick to the appropriate slot.
… That’s it. The device starts automatically with data logger or transfer.
Page: 7 Navigate to TOC

4. USER INTERFACE
4.1. BLINK-CODES
There is one multicolor LED to signal states of the Avisaro device.
Code
What is means
Action
Green & blue fading
All is fine
Idle state, no data arriving
None
Green flashing
Data are coming in
(RS232, CAN interface)1)
Red flashing
No USB stick
or button was pushed
Insert USB stick
Or press button again
1) On analog loggers (e.g. 4…20mA) and similar interfaces, data are read continuously, thus no green
flashing is shown
4.2. START AND STOP OPERATION
The Avisaro 4.0 starts with operation right after power on if an USB stick is inserted. Also, after
re-inserting a USB stick, the operation start automatically.
Navigate to TOC Page: 8

5. USB STORAGE STICK
Regular USB memory sticks can be used:
●From 4 to 256 GByte
●Formatted as FAT or FAT32 (preferred)
5.1. CHOOSING THE RIGHT SIZE
●Larger USB memory sticks tend to become more sensitive to hardware faults. Thus, estimate
the amount of data per day, multiply by the number of days between USB stick reads and
add some slack.
●If using the “ring buffer” setting, old data is deleted when the stick becomes full. “Full”
means, if free spaces drops below 100MB. Please note, that in this configuration, the last
two days are not deleted. Therefor, choose an USB stick which holds at least 2 days of data.
Page: 9 Navigate to TOC

6. USING THE RS232 INTERFACES
6.1. RS232 DATA LOGGING
To record a RS232 data stream, configure the logger as follows:
using the PC companion, navigate to:
General Stetting:
Global function: Generic Device
1st / 2nd RS232:
Protocoll: "Regular RS232"
Stream to "generic RS232"
select the baudrate you like and click 'Write config"
Commands
Device Control -> Reboot
Now you are ready to go
Insert a USB Stick. When data are received, the LED is flashing green and data are stored on USB
stick. You can stop the logging by pressing the button (and restart with it).
Extract the USB drive to read the data you logged.
6.2. MERGE (“SNIFFING”) DATA FROM TWO RS232/RS485 INTO ONE FILE
Merging data from two RS232/RS485 interfaces into one file is often useful for debugging the
communication with a device
6.2.1. More details
See paragraph “12.2. RS232 Interface” on information for the hardware interface description.
6.2.2. Configuration
“Device Configuration” ⇨ “Global HW setting”:
Navigate to TOC Page: 10

“Interfaces” ⇨ “(1st) RS232/RS485” / “(2nd) RS232/485”:
Configure the baudrate and interface setting to your application. Select the “char” field to match the
end of line field. In this case it is Hex 20 which translates into a “space” as text.
“Data Processing” ⇨ “Serial data (generic)”:
“Data Endpoints” ⇨ “USB Stick”
Select “1st file” to “Every hour” and set the other one to “Off”
Last but not least, reboot the Logger:
“Commands” ⇨ “Simple CMDs”
Page: 11 Navigate to TOC

Navigate to TOC Page: 12

7. USING THE CAN BUS INTERFACES
7.1. CAN DATA LOGGING EXAMPLE
7.1.1. More details
See paragraph “CAN Bus Interface” on information for the hardware interface description.
See paragraph “PC Companion Software” for all the configuration details.
See paragraph “CAN Storage Format Example “Text (CSV)”” on the text storage format.
7.1.2. Quick configuration guide
To configure the Logger for basic CAN Bus data logging, follow the steps:
Use PC Companion Software to enable the CAN interface (which usually are already enabled):
“Device Configuration” ⇨ “Global HW setting”:
Click on “Write Config” to store send the setting to the Logger.
Set the proper CAN baud rate - which depends on your application:
“Interfaces” ⇨ “(1st) CAN” / “(2nd) CAN”:
Page: 13 Navigate to TOC

To start with you initial testing, disable Filter setting (= “off”), select Collect time to “100” ms which
is a good starting value and select “Stream to Generic CAN”. Click on “Write Config”.
“Data Processing” ⇨ “CAN data (generic)”:
Select “Storage format” to “Text (CSV) data” which gives to you readable text file to check whether
data arrived. Select “Storage endpoint” to “Generic file (A).
“Data Endpoints” ⇨ “USB Stick”
Navigate to TOC Page: 14

Select “1st file” to “Every hour” and set the other one to “Off”
Last but not least, reboot the Logger:
“Commands” ⇨ “Simple CMDs”
7.1.3. Initial Operating
Plug in USB stick into logger, the LED should switch from red flashing to green/blue fading.
Send CAN data from you application. The LED should flash green/blue with data coming in.
Extract the USB stick and connect to a PC. Read the file generated in the “logs_1” folder - this is a
text file which can be opened with any editor:
See “CAN Storage Format Example “Text (CSV)”” on reading the format of stored CAN data.
There are more options - check this documentation table of content for all the details.
Page: 15 Navigate to TOC

7.2. CAN FILTER OPTIONS
7.2.1. Filter CAN ID range
.. to be filled in later..
7.2.2. Filter single CAN IDs with interval
Single CAN IDs can be filtered on both channels. To activate single CAN IDs:
To define the CAN IDs and the intervals, a configuration file is placed on USB stick. The file names are
“can1flt.txt” for CAN 1 and “can2flt.txt” for CAN 2.
The content of the file is (example):
218000622, 500
1616, 1000
1626, 1000
1813, 500
1620, 5000
419363367, 5000
Use a regular text editor to create the files. The first number is the CAN ID in decimal format, the
second number is the time interval in millisecond. I.e. 500 - the CAN ID is stored once every 500 ms.
Maximal 50 entries are allowed.
Navigate to TOC Page: 16

8. DATA STORAGE OPTIONS
8.1. STORING 4..20MA DATA
Example:
$ADC, 2018/04/19,17:17:23,753, 13.195 mA, 13.194 mA
$ADC, 2018/04/19,17:17:24,753, 13.192 mA, 13.195 mA
$ADC, 2018/04/19,17:17:25,753, 13.194 mA, 13.195 mA
$ADC, 2018/04/19,17:17:26,753, 13.195 mA, 13.195 mA
Storage time
With roughly 50 Bytes per entry and assuming one entry per second, it is 4.3 Mbyte per day. A 4
GByte USB drive would store roughly 930 days or 2.5 years worth of data.
See interface pin layout: “Analog Current loop (4..20 mA) Interface”
Page: 17 Navigate to TOC

9. WIRELESS OPTION
Getting started
Basic settings
AvisaroSoftAP
192.168.0.1
9.1. WPA ENTERPRISE
The server certificate needs to be updated.
The system clock needs to be up to dated.
Navigate to TOC Page: 18

10. CLOUD, LOCAL ACCESS AND STREAMING
To access the data, the following concepts are supported:
●FTP upload
●FTP download
●MQTT broker communication
●TCP/IP & UDP/IP live data stream
10.1. FTP CLIENT (UPLOAD DATA TO SERVER)
Locally stored data can be uploaded to a FTP Server in the Internet or within the company network.
This allows to collect data automatically in one central storage place.
10.1.1. Suitable FTP server
Any regular FTP server will be fine. The server can be placed in the company’s local area network or
in the Internet. The connection is not encrypted - “FTP” and not “sFTP” is used.
Avisaro provides a test server accessible in the Internet to get started. All products shipped are
preconfigured to access this server. Be aware, that data on this server is deleted on a regular base
and without any prior notice. The password is also changed on a regular base, so check newer
versions of this document:
Recommendations:
●Create a user for each Avisaro Logger - this way, there is no security breach if one logger gets
in wrong hands
●Create a subdirectory on the FTP server for each Avisaro Logger and have the corresponding
FTP user point to this directory. This way, data can be separated and, more important,
remote firmware updates can be addressed to one particular Logger
10.1.2. Required products
To allow FTP upload, a Avisaro Data Logger Serie 4.0 with network interface is required. A Wifi or
LAN interface allows connection into the local network and - if those network allow access - also
access to the internet. On a remote site, a “Mobile Network to WiFi” bridge can be used - also
available from Avisaro.
Page: 19 Navigate to TOC

10.1.3. Avisaro configuration
Make sure, the Avisaro Data Logger is connected to the network or Internet.
Use the “PC Companion Software” to activate “FTP” in the cloud setting section (see also the
summary in paragraph “12.14. Data Endpoints ⇨ Cloud Settings”):
Set the storage policy in “USB Storage Configuration” to “Every hour”, “Every hour with ringbuffer”
or “Every day”. “Ringbuffer” is the recommended configuration:
The FTP upload is happening in the same rate - as soon as a new file is created, the last file is
uploaded to the server.
Please note the limitation, that only “1st file” is uploaded.
Each file uploaded to the FTP server has a user definable prefix. This prefix is the “Device name”
which can be changed in the “General Settings” section:
Navigate to TOC Page: 20