YDOC ML-2013 Manual

Ml-x15 series; wdl-x14 series. low power 2g/3g data loggers
Hide thumbs Also See for ML-2013:
Table of Contents

Advertisement

Quick Links

Type ML-2013, ML-x15, WDL-x14
Low power 2G/3G data loggers
Title
:
User Manual ML-2013, ML-x15, WDL-x14
Version
:
FW 3.0B1
Manufacturers of low power instruments
DATA LOGGER MANUAL
page 1
Date
:
Sep-2017

Advertisement

Table of Contents
loading

Summary of Contents for YDOC ML-2013

  • Page 1 DATA LOGGER MANUAL Type ML-2013, ML-x15, WDL-x14 Low power 2G/3G data loggers Title Date User Manual ML-2013, ML-x15, WDL-x14 Sep-2017 Version FW 3.0B1 Manufacturers of low power instruments page 1...
  • Page 2 We recommend reading this manual carefully before installation of the data logger. Warranty All YDOC instruments are warranted for 3 years against defective materials and workmanship. Any questions with respect to the warranty mentioned above should be taken up with your YDOC Distributor. Manufacturers of low power instruments page 2...
  • Page 3: Table Of Contents

    DATA LOGGER MANUAL Table of Contents Product Description ............................ 10 Models and Editions ..........................11 ML-2013 .............................. 11 ML-x15 ..............................12 WDL-x14 .............................. 14 Getting started ............................16 Vibration ..............................16 Do’s and Don’ts ........................... 16 Inserting the SIM-card ..........................16 Power on for the First time ........................
  • Page 4 DATA LOGGER MANUAL APN login test ............................34 NTP time update ............................. 34 Time Update ............................34 Update interval ............................ 34 Server ..............................34 NTP Port .............................. 34 Time update test ..........................34 Alarm messages ............................. 34 System Alarm ............................34 Data Alarm ............................
  • Page 5 DATA LOGGER MANUAL Calculation Channels ..........................43 Syntax ..............................43 Functions ............................. 43 Example 1 ............................44 Example 2 ............................44 Supported mathematical functions with one argument: ..............44 abs(x) ............................... 44 sqrt(x) ............................... 44 ln(x) ..............................44 exp(x) ............................... 44 sin(radians) ............................
  • Page 6 DATA LOGGER MANUAL Field position ............................ 50 Field type ............................50 Example: ............................50 Generic NMEA............................. 50 GPS ..............................51 RS485 ..............................51 SDI-12 ..............................51 Measurement command ........................51 Parameters ............................51 Accessory port ............................. 52 Radio ..............................52 .................................
  • Page 7 Analog Differential Inputs (ML-2013 only) ....................79 Differential input ports theory of operation ..................79 Common mode noise rejection ......................79 Using Load Cells With the ML-2013 ....................80 Bridge of Wheatstone .......................... 80 Manufacturers of low power instruments page 7...
  • Page 8 Rate ..............................99 Power supply ............................100 Internal RTC backup battery ......................100 Power consumption & Battery Life ....................100 Pin configuration ............................101 ML-2013 ..............................101 ML-x15 ..............................102 WDL-x14 ............................... 103 Pin descriptions ............................. 104 Analog Inputs............................. 104...
  • Page 9 DATA LOGGER MANUAL Analog Input 1 to 4 (ML-2013) or 1 to 2 (ML-x15AD/ADS/TFT, WDL-x14AD) ......104 Analog Input 3 to 4 (ML-x15AD/ADS/TFT only) ................104 Analog Input 5 (ML-x15AD/ADS/TFT) ................... 104 Analog Input 5 to 8 (ML-2013 only) ....................104 RS485 A &...
  • Page 10: Product Description

    Remote FW-upgrade & Configuration update by HTTP(S), secure TCP or MQTT Internal voltage convertor for supplying 12 VDC power to the connected sensor(s), Stable excitation voltage to power Wheatstone bridged sensors (ML-2013 only), Firmware upgrade over the air for adding new features to your device.
  • Page 11: Models And Editions

    Models and Editions ML-2013 The ML-2013 data logger is a small, ultra-low power, high-end data logger with built-in QUAD-band GPRS- modem. This small data logger, is further provided with an internal temperature sensor, 4GB micro SD card and an 2FF SIM card slot. The logger can be powered by an internal 3.6 Volt Lithium battery that will last for years when the logger is configured in a low-power mode.
  • Page 12: Ml-X15

    DATA LOGGER MANUAL ML-x15 The ML-x15 data logger is a small, ultra-low power, cost effective data logger with built-in cellular modem available for the EMEA, APAC and NA regions. This small data logger, is further provided with an internal temperature sensor, 4GB micro SD card and an 2FF SIM card slot. The logger can be powered by an internal 3.6 Volt Lithium battery that will last for years when the logger is configured in a low-power mode.
  • Page 13 DATA LOGGER MANUAL 1) Analog inputs 2) RS232/RS-485/SDI-12 connector 3) Digital inputs 4) 12V Power switch and alarm output 5) Accessory port (TFT, CAM, BT4.0, etc.) 6) Cellular MODEM 7) Internal/External antenna selection jumper 8) U.FL connector for external antenna 9) Internal antenna 10) Connector for optional external waterproof USB connector 11) Internal USB connector...
  • Page 14: Wdl-X14

    DATA LOGGER MANUAL WDL-x14 The WDL-x14 is a small, battery powered, cost effective data logger with built-in cellular modem available for the EMEA, APAC and NA regions. The IP68 rated well data logger enclosure is slim enough to fit a 2" borehole and is designed to fit a www.prohydroinc.com lockable well cap.
  • Page 15 DATA LOGGER MANUAL 1) Waterproof 7-pole female Hirschmann connector (see chapter: Pin configuration) 2) Rubber O-ring (30x3mm NBR SHa 70) 3) RTC clock battery 4) SIM (2FF) & SD-card Holder 5a) Magnetic activated deployment suspension switch. 5b) Marker to put magnetic tape for suspending deployment (e.g. during transport) 6) Rubber O-ring (41x3.5mm NBR SHa 70) 7) SAFT LSH20-CNR 3.7V D-Size Lithium battery 8) 3V6 power supply connector (Max 3.7V!)
  • Page 16: Getting Started

    DATA LOGGER MANUAL Getting started Vibration At all times the data logger must be protected against vibrations. These vibrations can harm the performance of the data logger. Especially the real time clock can be harmed by long-lasting vibrations Do’s and Don’ts Do’s Always provide a dry and clean environment when you open the case of a data logger, When you open the case, use a Philips screwdriver of 2mm for loosening the screws,...
  • Page 17: Power On For The First Time

    Connect to a PC OS compatibility: The data logger can be connected to any PC with USB 2.0 running on Microsoft Windows XP, W7, W8 or W10. The USB virtual COM-port driver is installed when installing ‘YDOC- terminal’. ‘YDOC-terminal’ can be downloaded from www.your-data-our-care.com...
  • Page 18: Operating Basics

    Connect the logger to a free USB port on your computer and open with a terminal emulator the virtual COM-port (e.g. COM7) as assigned by Windows to the logger. The first time Windows will ask (if not already installed) for an USB-driver, which can be installed by installing ‘YDOC-Terminal’. When the terminal emulator has opened the COM-port, press: <Ctrl>A<Shift>M<Ctrl>D to enter the configuration menu.
  • Page 19 DATA LOGGER MANUAL You’ll see this screen: Configuration setup First Rename your Device by [0] Exit Selecting option 1 [1] General settings >> YDOC (General Settings) [2] Modem settings [3] NTP time update >> Not used [4] Alarm SMS >> Not used [5] SMS commands >>...
  • Page 20 DATA LOGGER MANUAL Next type 7 for Analog sensors Analog sensors [0] Exit [1] Port 1 (mA) >> Analog1 [2] Port 2 (mA) >> Not used [3] Port 3 (V) >> Not used [4] Port 4 (V) >> Not used [5] Potentiometer >>...
  • Page 21 DATA LOGGER MANUAL Your screen will look similar to the one underneath: Analog sensor [0] Exit [1] Name >> Water height [2] Sensor power switch >> Enabled; Warm up 00:00:02 [3] Sample interval >> Data log interval [4] Port mode >>...
  • Page 22 DATA LOGGER MANUAL Attention: Because this is a digital sensor, it takes a little bit more time to measure than an analog sensor. So don’t set the sample interval of digital sensors too short. 1 second is possible, but probably not ¼ sec. Just to be sure we choose to sample at the data log interval.
  • Page 23 [7] Password >> ******** address is valid. [8] Originator address >> r.kleine@provider.com [9] Destination address >> your@provider.com [A] Subject >> YDOC upper stream [B] Data Format >> Native (txt) [R] Remove [T] EMAIL test >> Not Done > Now perform an Email test and check if it is working right.
  • Page 24 DATA LOGGER MANUAL A sample interval of 1 second is fine. All internal sensors are very fast. Set the “Battery Replaced” to “Yes”, only when you installed a new lithium battery. Select the items you like to be informed about. See the reference for a complete description of the items.
  • Page 25: Reference

    Reference Principle of Operation Your YDOC data logger is capable of collecting and storing data of multiple sensors. To accomplish this, many tasks are performed. These “tasks” are scheduled and executed on their specified time. The timing of this process is very important and is determined by the internal scheduler. This scheduler keeps track of all the internal states of the various tasks and assigns processor time to the different tasks.
  • Page 26: Example

    DATA LOGGER MANUAL Example Let’s evaluate the following settings of the data logger: Sample Interval: 5 seconds Data Log Interval: 10 minutes Send Interval: 3 hours When the configuration is ready and the user disconnects the USB-Cable; 1. Data logger is switched into sleep-mode, and current draw is reduced to a minimum level. 2.
  • Page 27: Parameters

    DATA LOGGER MANUAL Parameters All through the configuration-settings of the data logger, you will encounter parameters to setup your logger. They are used on all ports (analog, digital, serial) and are generic in use. This section describes the use and properties of parameters. Below a screenshot of some parameter-settings are shown. Parameter Settings [0] Exit [1] Name...
  • Page 28: Data Transpond

    DATA LOGGER MANUAL Data transpond It’s only enabled if you have installed a Radio or Satellite modem. If you want this parameter to be transmitted by the Radio or the Satellite modem, put it to “ON”. Alarm message Here, the user can select whether he wants to receive an alarm message on this parameter (in alarming conditions) or not.
  • Page 29: Configuration Menu Settings

    Configuration Menu Settings This Chapter describes the details of the configuration-settings of your data logger. The configuration menu is entered by using YDOC-terminal and typing <Ctrl>A<Shift>M<Ctrl>D. Date & Time This section allows you to set date and time manually. If pressed enter, the existing system data/time is displayed.
  • Page 30: Configuration Setup

    DATA LOGGER MANUAL Configuration Setup This menu-section allows you to configure your data logger for your specific task. This section is divided into logical items, which contains more settings will be discussed next: Below a screenshot of the configuration setup is displayed: Configuration setup [0] Exit [1] General settings...
  • Page 31: General Settings

    DATA LOGGER MANUAL General Settings Here you enter your global settings, like datalog interval etc. These are the settings: Exit Exits the menu System Name Allows the user to give a name to the data logger (up to 32 characters). This name will be used in the data files, produced by the logger.
  • Page 32: Alarm Output Port

    (ML-x15/WDL-x14) or the “module power switch” collector [1] Disabled (ML-2013). When in “Continuous state” the output will be activated [2] Continuous state as long as an alarm situation exists. If you only want to trigger an [3] One-time pulse...
  • Page 33: Modem Settings

    This section allows the user to setup the communication with the 2G/3G network, according to the settings, received from the service provider. Please consult your service provider for the right setting, before consulting your YDOC dealer. Provider Selection This is an automated procedure which gives the user the overview of networks in the vicinity of the logger.
  • Page 34: Ntp Time Update

    DATA LOGGER MANUAL APN login test You should test the APN login after changing some settings, in order to verify the network connection. NTP time update This feature enables the automatic synchronization of the internal clock, by means of a Network Time Protocol (NTP) server on the internet.
  • Page 35: Sms Commands

    DATA LOGGER MANUAL SMS Commands ACVA SMS This feature enables the user to “call” for the last readings. When this feature is enabled, the user can send an SMS with the word ”ACVA” (stands for actual values) to the mobile number of the data logger, and the data logger will send an SMS, containing the last readings to the mobile phone of the user.
  • Page 36: Casing Pressure (Wdl-X14 Only)

    DATA LOGGER MANUAL Casing Pressure (WDL-x14 only) The WDL-x14 is provided with an internal pressure sensor ranging from 300 to 1200mBar, because the casing is provided with a venting plug the measured casing pressure will equal the atmospheric barometric pressure. When you have connected an absolute water level pressure sensor you can use a calculated channel to subtract the casing pressure from the absolute measured water level pressure to calculate the relative pressure (water column height).
  • Page 37: Analog Sensors (Ma/V)

    DATA LOGGER MANUAL Analog sensors (mA/V) This section covers the settings of analog sensors. The logger supports 3 types of analog sensors: Current sensors (mA) Voltage sensors (Volts) (ML-x15 only) Potentiometer sensors (ML-x15 only) Analog sensor [0] Exit [1] Name >>...
  • Page 38: Digital Sensors- Pulse Input

    DATA LOGGER MANUAL Digital Sensors- pulse input This section describes the operation of digital sensors, NOT to be confused with serial sensors, which also is a digital technique. A digital input is an input which measures the digital value of the input signal. This is a discrete value “0”...
  • Page 39: Pull Down

    DATA LOGGER MANUAL Pull down In this mode, a resistor is connected (from the input) to the ground of the data logger. So, in order to create an event, the external device must drive the input with a positive voltage. So, use this mode when you have a “positive switching”...
  • Page 40: Digital Sensors- Alarm Input

    DATA LOGGER MANUAL Digital Sensors- Alarm input This feature uses the same electrical input as the previous (digital sensor: pulse input), but it handles the signal differently. When the input is configured as an alarm input, instead of a pulse input, it has another menu and the purpose of the measurements is different.
  • Page 41: Network Signal Sensor

    DATA LOGGER MANUAL Network Signal Sensor This is an internal sensor that measures the quality of the 2G/3G network signal. This is a very important status measurement, because it is directly related to the connectivity of the data logger. We advise to include this sensor in your configuration, and to monitor this parameter regularly.
  • Page 42: Aggregation Channels

    DATA LOGGER MANUAL Aggregation Channels The logger is equipped with 8 aggregation channels which can be used to record aggregated values (average, minimum, maximum, gust and standard deviation) calculated over a period of your choosing. The number of samples taken into account during the aggregation period is depending on the period duration and the ‘Sample interval’...
  • Page 43: Calculation Channels

    DATA LOGGER MANUAL Choose which aggregation results you want to record, being average, minimum, maximum, standard deviation and/or gust. A gust is the highest 3 sample average occurred in an aggregation period. Calculation Channels Besides the different Physical channels the data logger contains, it also has a number of “calculation channels”.
  • Page 44: Example 1

    DATA LOGGER MANUAL Example 1 A measured tank liquid level could be compensated with temperature and passed thru an equation to calculate the contents of the tank in kg. Within the data logger each sensed parameter/channel has a parameter code chosen by the user (e.g. TEMPC for a temperature in Celsius).
  • Page 45: Sin(Radians)

    DATA LOGGER MANUAL sin(radians) returns the sinus of radians cos(radians) returns the cosine of radians tan(radians) returns the tangent of radians asin(x) returns the arc sinus of x in radians acos(x) returns the arc cosine of x in radians atan(x) returns the arc tangent of x in radians torad(degrees) converts degrees to radians...
  • Page 46: Supported Comparisons With 2 Arguments

    DATA LOGGER MANUAL Supported comparisons with 2 arguments: lt(x;y) returns x if x smaller than y else return y Example: lt(10;11) returns 10; Synonym: If (x<y) return x; else return y le(x;y) returns x if x smaller or equal than y else return y Example: le(10;11) returns 10;...
  • Page 47: Serial Port

    DATA LOGGER MANUAL Serial Port The serial port of your data logger provides different forms of serial communications. This chapter describes the details of this communication. RS232 This mode allows to connect to RS232 sensors, see RS232 for details of the electrical properties. Below a menu-settings screen is shown, for an RS232 sensor.
  • Page 48: Start Command

    DATA LOGGER MANUAL Start command If your sensor does not start measuring automatically after power on, but requires a start command. Please specify which register and value should be written to inform the sensor to start measuring. Ready status If sensor values are not immediate valid after a power on or after issuing a start command, it would be ideal when a sensor is equipped with a status ready register, if so please specify its register address and the value it contains when sensor values are supposed valid.
  • Page 49: Generic Serial

    DATA LOGGER MANUAL Generic Serial This is based upon a serial device that autonomous outputs sentences of data, like an GPS device. The user can capture this data, split it into various parameters, by specifying a separator character and by specifying the start and stop characters of a data sentence.
  • Page 50: Field Position

    DATA LOGGER MANUAL Parameters These are the values you want to get recorded from the data sentence(s). Each parameter has 3 properties. Serial parameter input settings [0] Exit [1] Sentence filter >> MWV [2] Field position >> 1 [3] Field type >>...
  • Page 51: Gps

    DATA LOGGER MANUAL $GPGGA,172814.0,3723.46587704,N,12202.26957864,W,2,6,1.2,18.893,M,-25.669,M,2.0,0031*4F When using the ‘Generic NMEA’ driver instead of the ‘GPS’ driver to input GPS coordinates you might need to do a conversion from dddmm.mmmm N/S/E/W format to +/- ddd.dddddd format. This can be accomplished by using a calculated channel for both the latitude and the longitude. Latitude formula: (floor(:GGA2/100)+((: GGA2/100)-floor(:GGA2/100))/60)*eq(:GGA3;83;-1;1) Longitude formula:...
  • Page 52: Accessory Port

    DATA LOGGER MANUAL Accessory port This is a serial port which is used for supporting special serial devices, called accessory port modules. The accessory port is only equipped on the MLx15-ADS models, and the ML2013 data logger. Below a list of supported accessories is shown. Accessory port modules These are the accessory modules that can be connected to the [0] Exit...
  • Page 53: Iridium Satellite

    DATA LOGGER MANUAL Iridium Satellite This option is for using satellite communication for data transfer. Not all satellite modems can be used on the data logger. It is designed to work with modems based on Iridium SBD 960x transceivers. We recommend the: http://www.your-data-our-care.com/datalogger-EDGE-satellite-transceiver.html as it...
  • Page 54: Settings Menu

    DATA LOGGER MANUAL When using ydocInsights you should ask your Iridium provider to use IPDirect and pass SBD messages to the same IP-address/domain and TCP-port as used for 2G/3G TCP-output from common YDOC data loggers. Settings menu Iridium Satellite settings...
  • Page 55: Gps

    This is the driver for a standard NMEA-GPS. Some settings are discussed below. Although every standard NMEA-GPS can be used, it is convenient to use an YDOC–GPS, because it can be powered from the accessory port also. YDOC GPS is found on: http://your-data-our-care.com/data logger-GPS-...
  • Page 56: Calculate Alarm Limits On Deployment

    DATA LOGGER MANUAL Calculate alarm limits on deployment This feature helps the user to set up a region which will be guarded by the data logger. This region can be setup at the office, far away from the installation site. The region is setup by defining the size of a rectangular, in which the buoy is supposed to operate.
  • Page 57: Camera

    DATA LOGGER MANUAL Camera This is used to connect an YDOC camera only. It shoots a picture and stores it on the SD-card for transmission to the host. More info on this camera’s is found here: http://your-data-our-care.com/data logger-accessories.html Below the settings are shown...
  • Page 58: Display

    DATA LOGGER MANUAL Display This driver is intended for the operation of an YDOC display unit. With this display unit, the measurements can be consulted, locally, in a graphical way. The YDOC display unit is a 3.5” color resistive touch screen display with a resolution of 320*240 pixels.
  • Page 59: Dtu Connection

    Our DTU (sometimes referred to as RTU) is not a separated product, but an integral part of our ML- 215/ML-315/ML-2013 Low Power Data Logger functionality. Because our Data Loggers are low power and self-sustaining, the RTU function can be used to monitor "legacy" serial devices at remote locations with no access to a power grid or external power source.
  • Page 60: Port Settings

    DATA LOGGER MANUAL Port Settings The port settings of the serial port of the DTU (data logger) Adapt this settings to you legacy device you like to connect to remotely. Sensor Power Switch Use the sensor power switch in this case, for powering you legacy device, so it powers up when you are connecting to it.
  • Page 61: Email Output

    DATA LOGGER MANUAL Email output This output driver is used to send the collected data from the SD Card to a mailbox of the user. The data is included in an attachment of the email. Below the settings are shown: Some of its settings are commented below, other settings are generic and covered before in this manual.
  • Page 62: Ftp Output

    [4] Server >> your-data-our-care.com [5] Port >> 21 [6] FTP mode >> Active [7] Security >> TLS(explicit) [8] Username >> YDOC [9] Password >> ***** [A] Directory >> logfiles [B] Omit timestamp >> No [C] Data format >> Native(txt) [R] Remove [T] FTP test >>...
  • Page 63: Remote Configuration

    DATA LOGGER MANUAL Remote configuration If the logger has FW V3.0B1 or newer, remote configuration with the data logger can be scheduled by ydocTerminal V3.0. using our secure tunnel server (tunnel.your-data-our-care.com). Note: The data logger should be configured to use NTP time synchronization. Within ydocTerminal click: File->New->Schedule a remote connection.
  • Page 64: Http Output

    [2] Send interval >> 01:00:00 [3] Send delay >> Not used [4] Server >> your-data-our-server.com/datacollector/ [5] HTTP port >> 80 [6] Username >> YDOC [7] Password >> ****** [8] Security >> Basic [9] Data format >> JSON [R] Remove [T] HTTP test >>...
  • Page 65: Remote Configuration

    DATA LOGGER MANUAL Remote configuration If the logger has FW V3.0B1 or newer, remote configuration with the data logger can be scheduled by ydocTerminal V3.0. using our secure tunnel server (tunnel.your-data-our-care.com). Note: The data logger should be configured to use NTP time synchronization. Within ydocTerminal click: File->New->Schedule a remote connection.
  • Page 66: Mqtt Output

    IoT monitoring system or smart phone apps supporting generic MQTT. When using ydoc-Insights we recommend to use TCP output, as TCP-output has far less overhead with less data payload (costs) and less transfer time (power consumption).
  • Page 67: Security

    <root>/data/jsn to publish the "Log data" in JSON format. • <root>/data/csv to publish the "Log data" in CSV file format. • <root>/data/txt to publish the "Log data" in YDOC native text format. • <root>/alarm/sys to publish "System alarms" in plain text, e.g. about a failing sensor. •...
  • Page 68: Remote Configuration

    DATA LOGGER MANUAL Remote configuration If the logger has FW V3.0B1 or newer, remote configuration with the data logger can be scheduled by ydocTerminal V3.0. using our secure tunnel server (tunnel.your-data-our-care.com). Note: The data logger should be configured to use NTP time synchronization. Within ydocTerminal click: File->New->Schedule a remote connection.
  • Page 69: Tcp Output

    Port on which the TCP-server is listening, which is 37 by default. When running your own TCP-server for data collection (e.g. the one that comes with ydoc-Insights) make sure that the chosen port is forwarded by your internet router to the local IP-address of the system/computer running your TCP-server.
  • Page 70: Configuration Review

    DATA LOGGER MANUAL Configuration Review The configuration review is used to generate an overview of the configuration. It enables the user to evaluate the settings of the logger in an easy way. It consists of multiple lists: Parameter list Measurement list Alarm list Alarm limits Parameter list...
  • Page 71: Alarm List

    DATA LOGGER MANUAL Alarm list This gives an overview of all alarms used. See example below: Alarm list Code Alarm SMS Alarm log Alarm output Alarm samples Disabled Disabled Disabled Disabled Disabled Disabled Disabled MINVi Disabled Disabled Disabled Disabled Disabled Disabled Disabled Disabled...
  • Page 72: Maintenance Menu

    DATA LOGGER MANUAL Maintenance Menu This menu is used to perform several diagnostic tests and includes tools for the maintenance of the data logger. Below the maintenance menu is shown: It is recommended that the user first consult this menu and run Maintenance some tests, before deployment.
  • Page 73: Sd Card Test

    DATA LOGGER MANUAL SD card test Use this feature to test the SD card. There will be data written on the card, and afterwards erased. Below a screenshot is given: SD card test Data log file size = 4578 KB The information from this test is very important.
  • Page 74: Data Download

    (which is a static property of the data logger). A very practical method of configuring YDOC data loggers is to use one configuration-file to configure the data logger, and afterwards personalize the logger with a unique system name.
  • Page 75: Firmware Upgrade

    DATA LOGGER MANUAL Firmware Upgrade Select this option for upgrading firmware. More on FW upgrade see: Firmware Upgrade Modem Maintenance This feature allows the testing of the modem and also supports modem firmware upgrade. This is a seldom used feature, but it is important in some rare occasions. For more info see: Modem Firmware Upgrade Bootloader Menu...
  • Page 76: Hardware

    SDI-12 The ML-2013 is provided with an SDI-12 port. This port is connected to port 2 and is shared with the normal RS232 operation. This means that the user has to select whether he wants to use RS232 or SDI-12.
  • Page 77: Rs232

    RS232 is not a bus system, and therefore it is only allowed for one device to be connected to a RS232 port. So, the maximum number of serial devices to connect to your ML-2013 is 2. RS232 sensors should be connected to the data logger with their signals crossed. That is RX  TX.
  • Page 78 10. The maximum amount of slaves, defined by EIA/RS485 is 32). For the exact number of sensors you can connect to your ML-2013 see chapter Firmware Driver limitations We recommend using twisted pair cable to connect to the sensors.
  • Page 79: Analog Inputs (4

    DATA LOGGER MANUAL Analog Inputs (4..20mA) The ML-2013 is equipped with four and the ML-x15/WDL-x14 (except the DS edition) with two analog mA 12 bits AD-Conversion inputs. The input signal must be a 4..20 mA current loop. The impedance of the system is 150 ohms.
  • Page 80: Using Load Cells With The Ml-2013

    Excitation output for this purpose. Excitation Output. The ML-2013 has an Excitation output for powering load cells, or other devices. It is a single output with a fixed precision voltage output. This Excitation output is driven by the Power Switch of the ML-2013.The default, fixed, Excitation Voltage is 5.000 Volts.
  • Page 81: Analog Differential Input 5

    0 .. 500mV 0 .. 1000mV 0 .. 2000mV Analog Differential input 6 Analog input 6 is the most sensitive differential input of the ML-2013. With exception of this sensitivity, the channel is similar to channel 5. Input 6 ranges Port mode Voltage 0 ..
  • Page 82: Potentiometer Input (Ml-X15 Only)

    DATA LOGGER MANUAL Potentiometer input (ML-x15 only) The ML-x15 (except the DS edition) is equipped with a potentiometer input. This input is a 0..3300mV voltage input. It is designed especially for potentiometers, like the ones in winddirection meters and angle meters.
  • Page 83: Digital Inputs

    Coil input Input #4 (ML-2013 only) is a special digital input. It is a so called “coil input”. This is a very sensitive digital input. From point of functionality, the input is exact the same as the other inputs, but electrically there are differences.
  • Page 84: Alarming

    DATA LOGGER MANUAL Alarming In some circumstances, normal data-logging is not sufficient for managing your process. For keeping track of certain, often critical, conditions, the data logger is equipped with direct alarming options. Alarming-limits and hysteresis are used to manage these special events. The table below shows the different types of alarming-limits.
  • Page 85 DATA LOGGER MANUAL So, the entry of an alarm state is NOT affected by a hysteresis. Hysteresis is only used for switching back to the normal mode. The amount of hysteresis has an effect on the “sensibility” of the alarming. It is strongly advised to use a certain amount of hysteresis to prevent from multiple alarming warnings.
  • Page 86: Advanced Alarming

    DATA LOGGER MANUAL Advanced Alarming From firmware-version V2.1B1 and above, we implemented an extended alarming feature that enables the use of calculated channels. This feature was implemented to calculate meaningful engineering values derived from raw sensor input values, however they could also be used for advanced alarming using multiple input conditions.
  • Page 87: Firmware Upgrade

    In time however, the need for additional features may arise. For example, a new serial sensor is introduced on the market and a customer wants to connect this sensor to the data logger. When YDOC has extended the firmware to support that sensor, a new version of the firmware is released. After the user has performed the firmware upgrade, his “old”...
  • Page 88: Power Switch Limitations

    DATA LOGGER MANUAL A user wants to connect a large number of INW CT2X sensors to an ML-2013. This sensor measures temperature and conductivity. So each sensor “uses” two parameters. Also he likes to send the data via FTP, and he enables the following internal sensors: Rest Capacity, Battery Voltage, and Current. So,...
  • Page 89: Inserting An Sd-Card

    DATA LOGGER MANUAL Inserting an SD-card At the factory, the SD-card is already installed, but when the cards need to be re-inserted, pay attention to the orientation of it. It should be inserted with the (gold-plated) terminals up. Native TXT Data Format The log file data format uses different records for data output.
  • Page 90: D-Records

    DATA LOGGER MANUAL D-Records Most of the data is logged into D-records. D-records stand for Data records. The syntax of this record is; <’D’> <’;’>,<Timestamp> <’;’> [ <Parameter Code> <’;’> < Parameter Value >[<Data Modifier>] <’;’>] So, the D-record consists of a ‘D’ character followed by a timestamp, and after that, one or more series of parameter code and parameter name.
  • Page 91: Data Modifiers

    DATA LOGGER MANUAL Example S-records: S;110922202054;CFG_RESET S;110922202054;CFG_CHANGED;Brasil_3002389 S;110922202124;MODEM_WDT;STATE 10 Data Modifiers Normally a data value, presented in D-records is recorded without a Data Modifiers, but in case of a malfunction, or rare circumstances, a Data Modifier is added to the data value. See table below: Data Description Remarks...
  • Page 92: Json Data Format

    DATA LOGGER MANUAL JSON Data Format The JSON Data Format contains about the same info as our native TXT data format, but formatted in JavaScript Object Notation (JSON) format. This format is preferred by web developers as the data can be easily accessed by JavaScript or other scripting languages like PHP.
  • Page 93: Compacted Data Format

    DATA LOGGER MANUAL Compacted Data Format The compacted data format is meant for use in case of message size constrained or payload expensive communication, like satellite communication. Compacting is required to get sufficient measurements in a size constrained message or to reduce expensive payload costs.
  • Page 94: Records

    DATA LOGGER MANUAL Records A record can have a length from one to 6 bytes. First byte of record Bit 7 Type of record Sign bit Scaling bits The most significant nibble of the first byte describes the type of record, the least significant nibble its scaling and sign.
  • Page 95: Time-Record

    DATA LOGGER MANUAL Time-record Bit 7 Type of record=0 Sign Single byte Scaling value When the most significant nibble of the first record byte equals 0, then the record specifies a change in timestamp for all following value records. Bit 0 & 1 indicates the scaling of the “Time”-record: 00= Day, 01=Hour, 10=Minute and 11=Second. Bit 2, When this bit is set to “1”...
  • Page 96: Input-Drivers

    Analog sensors The ML-2013 is provided with 4 factory-calibrated analog inputs with 12 bit ADC resolution. Analog input 5 and 6 are factory pre-calibrated amplified differential inputs with 16 bit ADC resolution.
  • Page 97: Digital Pulse Sensor

    DATA LOGGER MANUAL The ML-x15 (except the DS edition) is provided with 5 factory-calibrated analog inputs with 12 bit ADC resolution. Input Range Accuracy Impedance 4 .. 20mA <0.1% FS 150 Ohm 4 .. 20mA <0.1% FS 150 Ohm 0 .. 10V <0.1% FS 0 ..
  • Page 98: Counter

    DATA LOGGER MANUAL Digital pulse sensor [0] Exit [1] Name >> Rain [2] Sample interval >> Data log interval [3] Port mode >> Port 1; Internal pull up [4] Register mode >> Pulse (low frequency) [5] Units per pulse >> 0.2 [6] Register value >>...
  • Page 99: Rate

    DATA LOGGER MANUAL Rate The parameter Rate is defined as the time between the last two pulses applied to the data logger, scaled to one hour. For rain-measurement, the parameter rate can be used for calculating “rain intensity”. It allows you to differentiate a rain-shower from drizzling rain. Example: So, when two pulses, with a delay of 5 seconds between them, are send to the data logger, and every pulse represents 0.2 mm rain, the rate is: 1 mm per 25 seconds = 144 mm / hour...
  • Page 100: Power Supply

    The data logger PCB is designed to work with a power supply of minimum 0.8 to maximum 5V DC The ML-2013, ML-x15-LI and WDL-x14-LI are powered with a D-size battery holder for a 3.7V Lithium cell. The ML-2013 and ML-x15 can optional be provided with a cover with integrated NiMH AA solar charger, 8..30V DC-adapter with NiMH AA charger.
  • Page 101: Pin Configuration

    DATA LOGGER MANUAL Pin configuration ML-2013 The arrows are pointing to the #1 pin Connector Pin# Name Description RS485 A +RS485 positive terminal RS485 B -RS485 negative terminal Ground Ground RS232 TX1 Transmit line RS232 port 1 RS232 RX1 Receive line RS232 port 1...
  • Page 102: Ml-X15

    DATA LOGGER MANUAL ML-x15 Connector Pin# Name Description 0..20mA, input 1 Positive terminal analog input 1 0..20mA, input 2 Positive terminal analog input 2 0..10V, input 3 Positive terminal analog input 3 0..10V, input 4 Positive terminal analog input 4 Ground 0..100% (0..3300mV), input 5 Positive terminal potentiometer/analog input 5...
  • Page 103: Wdl-X14

    DATA LOGGER MANUAL WDL-x14 Connector Pin# Name Description Internal USB connector USB connector for local configuration UF.L connector To connect UF.L antenna signal cable to main pcb Ground Alarm output Open collector (max 100mA sink current) Flex cable connector Power and data signals to main pcb +VBAT (3.6V DC) Positive terminal for power source -VBAT (3.6V DC)
  • Page 104: Pin Descriptions

    Pin descriptions Analog Inputs Analog Input 1 to 4 (ML-2013) or 1 to 2 (ML-x15AD/ADS/TFT, WDL-x14AD) These are Current-inputs, with an input impedance of 15 ohms. The range is 4 .. 20 mA. The circuits are equipped with over current-protection. To use this input connect the + of the sensor to the + of the power switch and the –...
  • Page 105: Digital Inputs

    DATA LOGGER MANUAL Digital inputs These are interrupt-driven inputs, with an internal pull-down or pull-up resistor. To use it, connect a switch between the 3V6 or the GND respectively and this terminal. It is suitable for energy meters, water meters and rain-gauges.
  • Page 106: Maintenance And Repair

    –support. The real time clock is also calibrated during the manufacturing process, and has very good long life stability (see spec. sheet). Also, when operating in a harsh environment, the need for a recalibration can be applicable. YDOC can perform overall calibrations any time you like. XRAY In the uncommon event of exposure to XRAY, extra precautions are needed.
  • Page 107: Safety

    DATA LOGGER MANUAL Safety Don’t work on the wiring of the data logger when powered from an external supply. Power supply The data logger is protected against reversed polarity of the battery power. The mains power supply is protected by a 4AT fuse type TR5. The data logger is equipped with an ESD (Electronic Static Discharge) protection on all “outside world”...
  • Page 108: Environment And Disposal

    DATA LOGGER MANUAL Environment and disposal The data logger is manufactured in compliance with the RoHS directive (Reduction of Hazardous Substances) EU directive 2002/95/EC, which means in popular terms that the product is “lead-free”. When the data logger is taken out of service, dispose the data logger in accordance to the local regulations at the time the product is disposed.
  • Page 109: Transport And Storage

    DATA LOGGER MANUAL Transport and Storage The following requirements are applicable for transport and storage of the data logger. Storage: Humidity < 95% (Non condensing) Temp 10 .. 30 °C Transport: Humidity < 95% (Non condensing) Temp 10 .. 30 °C If the data logger is delivered in its standard protecting enclosure, it is strongly recommended to use this case for all transportation, until the final location of operation.
  • Page 110: Appendix

    GPS Option Module Option: not included . See manual Dimensions PCB W x H 148 x 72 mm (ML-2012), 110 x 90 mm (ML-2013) Weight PCB Netto Weight 70 Grams (ML-2012), 52 grams (ML-2013) * The Power consumption in sleep mode is when Datalogger is idle, and no tasks performing. Only the RTC is running...
  • Page 111: Ce Declarations Of Conformity

    DATA LOGGER MANUAL CE Declarations of Conformity Manufacturers of low power instruments page 111...
  • Page 112 DATA LOGGER MANUAL Manufacturers of low power instruments page 112...
  • Page 113 DATA LOGGER MANUAL Manufacturers of low power instruments page 113...
  • Page 114: Supported Serial Sensor Devices

    DATA LOGGER MANUAL Supported serial sensor devices Device Brand Interface Remarks ASCII Generic RS232/485 Sensors outputting lines of ASCII MODBUS/RTU Generic RS232/485 SDI-12 Generic SDI-12 NMEA-0183 Generic RS232 Sensors outputting NMEA sentences Connection of a PT-1000 thermistor to the potentiometer-input Although we recommend to use smart (a/o SDI-12) or current loop temperature probes for remote data logging applications, it is possible to use cheap PT1000 thermistors as well.
  • Page 115 DATA LOGGER MANUAL *) Using a thermistor is not recommended for Lithium powered data loggers as it draws a 1.5mA current continuously. On the next page this example is continued with screenshots of the data logger’s configuration menu. Note: Because of power consumption we recommend to use PT1000 thermistors only. Before you can measure temperature with a PT1000 you have to perform the following calibration/configuration steps: 1) Use a 10M potentiometer to do a 2 point user calibration of the potentiometer input.
  • Page 116 DATA LOGGER MANUAL Example: Manufacturers of low power instruments page 116...
  • Page 117: Open Collector Output

    The user can choose his own voltage level, because the transistor only acts as a switch and NOT supplying any voltage. In your YDOC data logger the maximum “supply voltage” for the o.c. switch is limited to 40 volts DC.
  • Page 118: Trouble Shooting

    Trouble shooting If you encounter problems with the data logger, you can start checking the following. First try to set up a connection, via USB, and use the program, YDOC-terminal, to communicate with it. If that doesn’t work, you have to check the battery-power, so you have to open the case. Do this in a dry and clean environment, NOT in the field.
  • Page 119: System Messages

    DATA LOGGER MANUAL System messages Meaning of the System messages (S-records in TXT and CSV or $Msg-lines in JSON data log files) A System message contains a message code, an optional supplemental code/text and an optional explanatory text. Please find below a list with possible System messages. Message code Supplemental code/text Meaning...
  • Page 120 DATA LOGGER MANUAL APN_OPEN Error while trying to find an APN access point name wrong internet access point APN_LOGIN Error while trying to login to the APN user or password wrong, or internet access point authentication failure SERVER_LOGIN Error while trying to login to the Server not available or credentials wrong Email/FTP/TCP/HTTP server FILE_OPEN...

This manual is also suitable for:

Ml-2013-pvMl-2013-dcMl-2013-tft

Table of Contents