Wilmers blueberry COMPACT User manual
Manual
Data Logger
blueberry COMPACT
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 3 -
IMPRINT
Copyright:
Wilmers Messtechnik GmbH
Hammer Steindamm 35
D-22089 Hamburg / Germany
phone: +49(0)40-75 66 08 98
fax: +49(0)40-75 66 08 99
mail: info@wilmers.com
Internet: www.wilmers.com
WAsP is a software product of RISØ National Laboratory, Denmark. WindPRO is a software product of
EMD, Denmark. Microsoft, Windows, Excel and Internet Explorer are trademarks or registered trade-
marks of Microsoft Corporation, USA.
This manual relates to firmware release 3.2.6 of the data logger blueberry COMPACT (partNo. 0141).
All rights reserved. No part of this document may be reproduced or transmitted in any form or by any
means, electronic or mechanical, for any purpose other than for the purchaser’s personal use, without
written permission. All information in this document subject to change at any time without prior notice
and do not represent a commitment on the part of the manufacturer.
2014-03-03
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 3 -
Contents
Introduction . . . . . . . . . . . . . . . . . . . . 5
Getting Started . . . . . . . . . . . . . . . . . . 5
Scope of Delivery . . . . . . . . . . . . . . . . . . 5
Installation . . . . . . . . . . . . . . . . . . . . . 6
LED Display . . . . . . . . . . . . . . . . . . . . . 8
QR Code (Infos + Manual) . . . . . . . . . . . . . 8
Web Interface . . . . . . . . . . . . . . . . . . . 9
Introduction . . . . . . . . . . . . . . . . . . . . 9
Data Display . . . . . . . . . . . . . . . . . . . . 9
Displaying Actual Measured Values . . . . . . . . 9
Data Transfer . . . . . . . . . . . . . . . . . . . 10
Downloading Measured Data . . . . . . . . . . . 10
Data Format . . . . . . . . . . . . . . . . . . . . 10
Transmitting Measured Data via E-Mail . . . . . 12
Site Description . . . . . . . . . . . . . . . . . 12
Measurement Setup . . . . . . . . . . . . . . . 13
Measurement Parameters . . . . . . . . . . . . 13
Measurement Functions (Standard Setup) . . . 13
Function Names . . . . . . . . . . . . . . . . 13
Digital Measurement Inputs (DIN1..10) . . . 14
Analogue Measurement Inputs (AIN1..6) . . 15
Measurement Functions (Expert Setup) . . . . . 15
Arithmetic Operators . . . . . . . . . . . . . 15
Rounding Operators . . . . . . . . . . . . . . 18
Other Operators . . . . . . . . . . . . . . . . 18
Operator Summary . . . . . . . . . . . . . . . 19
Variables . . . . . . . . . . . . . . . . . . . . 19
Predefined Variables (internal Sensors) . . . 20
Predefined Variables (Time Info) . . . . . . . 20
Data Polling . . . . . . . . . . . . . . . . . . . . 21
Digital Outputs (DOUT1..4) . . . . . . . . . . . . 23
Alarm E-Mails . . . . . . . . . . . . . . . . . . . 23
Date and Time . . . . . . . . . . . . . . . . . . 24
Network Interface . . . . . . . . . . . . . . . . 24
Network Parameters . . . . . . . . . . . . . . . 24
Internet Integration . . . . . . . . . . . . . . . 25
GPRS Connection . . . . . . . . . . . . . . . . . 25
Remote Access via Internet . . . . . . . . . . . 26
Creating a DynDNS Access . . . . . . . . . . . 26
Accessing the blueberry COMPACT via Internet 28
Accessing the blueberry COMPACT from a Mobile
Phone . . . . . . . . . . . . . . . . . . . . . . 28
Remote Access via GSM . . . . . . . . . . . . . . 29
Setting up the GSM Connection . . . . . . . . 29
Accessing the blueberry COMPACT via GSM . . 31
Password Protection . . . . . . . . . . . . . . . 31
User Password . . . . . . . . . . . . . . . . . . 32
Help Function . . . . . . . . . . . . . . . . . . 32
Rebooting the blueberry COMPACT . . . . . . . 32
FTP Access . . . . . . . . . . . . . . . . . . . . 33
Installing FileZilla . . . . . . . . . . . . . . . . 33
Deleting Measured Data . . . . . . . . . . . . . 34
Updating the Firmware . . . . . . . . . . . . . 34
Adapting the PC Network Settings . . . . . . . 35
Displaying Diagrams . . . . . . . . . . . . . . . 36
Transmitting Measured Data via FTP . . . . . . 37
ANNEX . . . . . . . . . . . . . . . . . . 38
Technical Specifications (compared to NDL 485) .
38
CE Compliancy Declaration . . . . . . . . . . . 40
Index . . . . . . . . . . . . . . . . . . . . . . . 41
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 4 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 5 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 4 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 5 -
Introduction
The blueberry COMPACT is an all-in-one data logger
system. It features digital and analogue measure-
ment inputs for the connection of sensors providing
pulses, voltage or current signals. A serial RS485
bus interface allows the connection of sonic an-
emometers and other sensors with RS485 interface.
The blueberry COMPACT is integrated into the Inter-
net via GSM/GPRS or DSL. It sends measured data
automatically via E-Mail and FTP. The Ethernet port
and the integrated web interface provide fast data
transmission to a PC or a LAN and easy access via a
web browser.
Getting Started
Scope of Delivery
The following components are supplied with the
data logger blueberry COMPACT:
• Data logger in a rugged weatherproof enclosure
• Crosspatch Ethernet cable for local data connec-
tion
BUSY indicator
flashes every 2 seconds
in normal operation
RS232
serial port for connection
to the integrated GSM/
GPRS modem or to an
external modemry GSM
module
LAN
Ethernet port for connec-
tion to a PC, a router or a
PC network
POW + GND
solar power supply
connection
POW = (+), GND = (–)
DIN1 .. DIN10
digital measure-
ment inputs for TTL
or small AC signals
AIN1 .. AIN6
analogue measurement
inputs for 0..10V signals,
potentiometric wind vanes,
Pt100 temperature sensors,
thermopile pyranometers
RS485 port + excitation
pin 1 = n.c.
pin 2 = EXC (+)
pin 3 = GND
pin 4 = RS485+
pin 5 = RS485–
QR code
Scan the QR code with a
smartphone to get fur-
ther information about
the
blueberry COMPACT
(manual, data sheet, bro-
chures, wiring diagrams,
firmware updates)
Display button
press the but-
ton to activate
the LED display
for 3 minutes
LED display
indicate the status of the
measurement inputs and
of the power supply
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 6 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 7 -
5. Plug the crosspatch cable into the LAN connec-
tion at the front plate of the blueberry COMPACT.
Connect the crosspatch cable to the Ethernet in-
terface of a PC or notebook.
6. Adapt the network settings of the PC to the IP
address of the blueberry COMPACT. The network
parameters are indicated on a label at the bot-
tom of the housing of the data logger.
7. Start your Internet browser, enter the IP address
of the data logger into the address field and type
<enter>. Enter the access code into the login
dialog:
user: admin
password: **** (=admin password)
8. You should now see a screen similar to the image
below.
9. Connect sensors or test signals to the terminals
at DIN1 .. DIN10 and AIN1 .. AIN6. Enter the
measurement functions according to chapter
Measurement Setup of this manual.
Delivered within a complete measurement system
the blueberry COMPACT usually provides a wiring
diagram attached to the lid of the shelter box. The
blueberry COMPACT includes built-in overvoltage
protection for all terminals. The following image
shows the blueberry COMPACT data logger with
backup batteries connected, the GSM module that
integrates the data logger into the Internet via
GPRS.
Installation
Please proceed as follows to install and to test the
blueberry COMPACT data logger:
1. Install the blueberry COMPACT to the mast.
2. Remove the battery cover plate and insert the
two sealed lead batteries and connect them
to BAT1 and BAT2. Please use only the battery
types stated on the label in the data logger shel-
ter box.
3. Insert the battery cover plate and tighten the
fixing screw.
NOTE: Never disconnect the backup batteries from
the data logger when a solar module is connect-
ed. This may damage the data logger.
4. Connect a 12V solar module (60 Wp) to the POW
(+) and GND (–) terminals of the terminal strip.
The BUSY indicator LED is steadily alight. The
boot process takes approx. 2 minutes. The data
logger is fully operating when the BUSY LED
flashes in regular intervals of 2 seconds.
NOTE: Never connect a solar module to the data
logger before batteries are connected. This may
damage the data logger.
Optionally, a 24 VDC (15..30 VDC / max. 5A) pow-
er supply can be connected instead of the solar
module. The integrated charge controller will
charge the backup batteries working as a UPS.
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 6 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 7 -
Infos + Manual
LAN
RS232
BUSYEXC
RS485DISPLAY
POW
GND POW
BUSY
1
2
3
4
5
6
BAT1
BAT2
POUT
1
2
3
4
5
6
8
9
10
AIN CC DIN
BAT1+
BAT1–
BAT2+
BAT2–
POUT
GND
DOUT1
DOUT2
DOUT3
DOUT4
GND
GND
GND
GND
GN
WH
WH
WH
GN
YE
BN
YE
YE
BN
BN
RD
BU
RD
BU
BN
BU
GN
WH
BN
GN
WH
BN
GN
WH
BN
GN
WH
BN
GN
WH
BN
GN
WH
BN
GN
WH
BN
GN
WH
BN
BN
WH
GN
YE
BN
WH
GN
YE
BU
RD
YE
GN
YE
WH
BN
GN
0°360°
YE
WH
BN
GN
0°360°
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 8 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 9 -
QR Code (Infos + Manual)
Scan the QR code with your smartphone in order
to get further information about the blueberry
COMPACT. The QR code links to a website that pro-
vides technical data, manual, wiring schemes, bro-
chure, application notes and firmware updates for
the data logger. The website is also available under
the following link:
http://wilmers.com/blueberry-compact
LED Display
The blueberry COMPACT provides an array of LEDs
that indicate the status of the measurement inputs
and of the power supply. Press the DISPLAY button
to activate the LEDs for 3 minutes.
Significance of the LEDs
LED Off Red Green
POW Supply
Voltage
<11 V
Supply
Voltage
11..16 V
Supply
Voltage
>16 V
BUSY - Received
an invalid
telegram
Received
a valid
telegram
AIN (top) - Analogue
Excitation
On
Analogue
Excitation
Off
CC (top) - Constant
Current On
Constant
Current Off
DIN (top) - Digital
Excitation
On
Digital
Excitation
Off
AIN1..6 <0.05 V 0.05..0.5 V >0.5 V
CC1..6 <0.1 mA 0.1..0.9 mA >0.9 mA
DIN1..10 - High Low
BAT1 <11 V 11..13 V >13 V
BAT2 <11 V 11..13 V >13 V
POUT - On Off
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 8 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 9 -
Web Interface
Introduction
The user surface of the data logger
blueberry COMPACT is a web interface. Configura-
tion of the data logger, display and download of
measured data requires a web browser (e.g., Firefox,
Opera, Internet Explorer, Safari). The data logger is
connected to the PC via local Ethernet connection
or via remote data transmission (GSM, GPRS, UMTS,
CDMA, DSL, Satellite).
Start the browser, enter the IP address of the data
logger into the address field and type <enter>.
Enter the access code into the login dialog. The
blueberry COMPACT provides two user levels:
The user guest is allowed to display actual measured
values and configuration settings and to down-
load measured data. He cannot delete any data or
change configuration settings. He is only allowed to
set date and time.
The user admin has all rights. In addition to the
guest rights he is allowed to delete measured data
and to change the configuration.
Data Display
Displaying Actual Measured Values
The left part of the screen displays in a table all
actual measured values. When the data logger is
connected locally these values are automatically
updated. At remote connections, please click on
Refresh Data View below the data table in order to
update the display. Measured values are displayed
as floating point numbers with the significant
number of characters after the decimal point.
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 10 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 11 -
Data Transfer
Downloading Measured Data
The blueberry COMPACT contains two ring buffer
data memories; one for the statistics, one for the
samples. Actual data overwrite the oldest data lines
which makes the deletion of the memory unneces-
sary.
Select Archive in order to display a list of all stored
statistics files. The blueberry COMPACT creates
one statistics file per day. These files contain time
series of the statistical evaluations of the samples.
The file name contains the index of the actual meas-
urement, the date and the tag stat for ‚statistics‘.
The data logger increments the index every time
the configuration is changed or the data logger
reboots.
Example: 000024_2004-03-19_stat.csv
Select HighRes in order to display a list of all stored
samples files. The blueberry COMPACT creates one
CSV file per hour. These files contain time series of
all measured samples. The file name contains the in-
dex of the actual measurement, date and time, and
the tag meas for ‚measurement‘.
Example: 000024_2004-03-19_15_meas.csv
Downloading measured data works like a download
from an Internet site: click with the right mouse
button on a file, select Save file as... from the pull-
down menu, enter the destination path and click
OK.
CSV files can be imported into data analysis soft-
ware like WAsP or WindPRO. Double-clicking on the
CSV file opens it directly in MS-Excel.
Data Format
The blueberry COMPACT stores measured data as
comma separated ASCII files (CSV). Each data file
contains a header which indicates information
about the data logger and the measurement config-
uration: serial number of the data logger, index of
the measurement, site info, measurement functions
and parameter settings. The header is followed by
an empty line and a line with column headers. The
measured data lines have the format: date, time,
period, measured values. Decimal delimiter is a dot
(e.g., 2.564), columns are separated by a comma.
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 10 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 11 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 12 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 13 -
Transmitting Measured Data
via E-Mail
The blueberry COMPACT sends measured data auto-
matically via e-mail every day at 0:00. The CSV data
file of the previous day is attached to the e-mail. If
several files have been created since last e-mailing
(e.g., because of configuration changes or reboot-
ing of the data logger) all closed files are send. Each
file is attached to a separate e-mail. Please first
setup the Internet integration via GPRS or DSL.
To setup the e-mail data transfer select
Setup > FTP/Mail.
Enter the URL of your mail server (SMTP server) in
the field Mail Server. If your mail server requires
authorization enter the user name and password.
Enter the mail addresses in the field Recipient(s).
Separate more than one mail address by space char-
acters.
Select yes at Test Mail Transfer now.
Click OK to save the settings. If the Test Mail option
is active the blueberry COMPACT now sends a test
mail to all recipients. A message displays the result
of the test mailing. Please check whether the mail
has been sent without errors. Otherwise, please
check the correctness of your mail settings.
Site Description
The blueberry COMPACT saves information about
the measurement. They are stored in the header of
each CSV data file for proper documentation of the
measurement process.
To enter the information about the measurement
select Setup > Site Description.
Documentation of the measurement includes the
following information:
Name Name of the measurement site
Description Description of the measurement lo-
cation and its environment. Please
enter here orography, roughness,
obstacles and other elements hav-
ing an impact on the measurement
result.
Geographical Position Enter here latitude, lon-
gitude and elevation of the meas-
urement site.
Other Information Use these universal input
fields to enter all supplementary
information about the measure-
ment:
e.g., geographical coordinate
system, mast type, mast dimen-
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 12 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 13 -
sions, type, serial numbers and
calibration numbers of the sensors,
dimensions and alignment of sen-
sor mounting booms
Measurement Setup
Measurement Parameters
To define measurement parameters or sensor char-
acteristics select Setup > Measurement.
Measure Period Measure period is the time interval
in which the data logger records actual measu-
red values (samples) from all sensors.
Statistic Interval Statistic interval is the time
interval in which the data logger performs a
statistical evaluation of the samples and stores
the results in the memory. The variables a1..an
correspond to the first to nth value of the data
line sent by the first sensor. The variables b1..bn
correspond to the values sent by the second sen-
sor and so further.
Excitation defines how long the sensor constant
current source (CC) is switched on before the
blueberry COMPACT sends a poll command. Se-
lecting always on switches the excitation voltage
continuously on. The blueberry INPUT Module
requires this setting as it needs a warm-up time
of approx. 5 seconds.
Measurement Functions (Standard
Setup)
To add a new measurement function enter a func-
tion name in the field Name, check the required
statistical evaluations and enter the measurement
function. Type <enter> to transmit the settings to
the data logger.
Function Names
Variable names may principally contain umlauts
(ä, ö, ü) and special characters like comma (,) and
period (.). If function names are used as variables
in further measurement functions the first part of
the function name may however only contain the
following characters: A..Z, a..z, 0..9, _. The second
part, i.e. the part after the first space character is
used as axis label for realtime diagrams. We rec-
ommend to use the following syntax for function
names: Value (unit).
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 14 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 15 -
Frequency AC for small AC frequency signals
[Hz], from wind sensors like R.M.Young Wind
Monitor
Counter if you want to count pulses, e.g., from a
tipping bucket rain gauge.
Select the Slope and Offset for the transfer func-
tion of the respective input. Take these values from
the sensor data sheet or from the calibration certi-
cate for individually calibrated sensors.
Select the option from the Option list:
--- if no option required.
no offset when zero suppresses the offset for
0 Hz frequency signals. Select this option for
anemometers because otherwise wind speed
will record the anemometer offset value at
zero wind speed.
Example:
vWind80m (m/s) = 0.04727 * b10 + 0.264 * (b10>0)
The rst part of the function name can be used as
variable vWind80m in further measurement func-
tions.
The diagram title for this function is vWind80m, the y
axis label is (m/s).
Digital Measurement Inputs (DIN1..10)
The table Digital Inputs provides one line for each
of the 10 digital measurement inputs DIN1..10.
Enter the function name into the eld Name.
Select the signal type from the Type list:
--- if the input is not used.
Frequency TTL for TTL pulse frequency signals
[Hz], from anemometers like Thies First Class,
Vector A100, Heval ECONOMY or RISØ reed
switch anemometer with external pullup re-
sistor.
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 14 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 15 -
Analogue Measurement Inputs (AIN1..6)
The table Analog Inputs provides one line for each
of the 6 analogue measurement inputs AIN1..6.
Enter the function name into the eld Name.
Select the signal type from the Type list:
--- if the input is not used.
Voltage provides the voltage between AIN+ and
AIN– of the respective analogue input. If the
sensor does not provide a reference for the
measurement signal AIN– must be connected
to GND.
Temperature (Pt100) for passive Pt100 temper-
ature sensors connected in 4-wire technique.
The blueberry COMPACT automatically con-
verts the voltage into temperature according
to IEC751.
Potentiometer 0..1 provides the dimensionsless
value of a potentiometer.
Direction 0..360° provides the 0..360° wind
direction of a potentiometric wind vane con-
nected in 4-wire technique. Direction value
increases when the vane rotates clockwise.
Direction 360..0° provides the 0..360° wind
direction of a potentiometric wind vane con-
nected in 4-wire technique. Direction value
increases when the vane rotates anti-clock-
wise.
Resistance provides the electrical resistance
[Ω] of a resistor connected in 4-wire tech-
nique. Use this option for PTC or NTC tem-
perature sensors.
Select the Slope and Offset for the transfer func-
tion of the respective input. Take these values from
the sensor data sheet or from the calibration certi-
cate for individually calibrated sensors.
Measurement Functions (Expert
Setup)
The Expert Setup allows input of virtual measure-
ment functions similar to the data logger blue-
berry NDL485.
To add a new measurement function enter a func-
tion name in the field Name, check the required
statistical evaluations and enter the measurement
function. Type <enter> to transmit the settings to
the data logger.
Maximum length of the measurement function
including function name and statistics options is
1023 characters or 64 elements. Each variable or
operator counts as one element. Please use the
following elements to built the measurement func-
tion:
Arithmetic Operators
+ Addition
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 16 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 17 -
Example: Vector Component
vWind (m/s) = 0.04752 * b8 + 0.224 * (b8>0)
dirWind (°) = (360 * (a1-a2)/a1) % 360
vEast (m/s) = vWind * sin (dirWind)
The multiplication of the wind speed with
the sine of the wind direction results in
the eastern component of the total wind
speed vector.
cos Cosine function. The angle must be defined in
degrees.
Example: Vector Component
vWind (m/s) = 0.04752 * b8 + 0.224 * (b8>0)
dirWind (°) = (360 * (a1-a2)/a1) % 360
vNorth (m/s) = vWind * cos (dirWind)
The multiplication of the wind speed with the
sine of the wind direction results in the north-
ern component of the total wind speed vector.
ln Natural logarithm
Example: log = ln c7
Boolean Operators
> Comparison superior to. The result is 1, if the
condition is true, otherwise it is 0.
Example: Calibrated Cup Anemometer
ws30m (m/s)= 0.04827 * c2 + 0.19 * (c2 > 0)
This function suppresses the wind speed offset
when the frequency is 0. Otherwise, even at to-
tal calm the data logger would indicate a wind
speed of 0.19 m/s.
< Comparison inferior to. The result is 1, if the
condition is true, otherwise it is 0.
– Subtraction or minus sign. If a – is used to
characterize a negative number at the begin-
ning of a measurement function or after an-
other operator the number must be put into
parenthesis.
Example: Negative Numbers
HumAir (%RF) = (–25) + 62.5 * a5
vSonic (m/s) = e2 else (–9999)
* Multiplication
/ Division
^ Exponent, real number
Example: Length of a Vector
uSonic (m/s)= d2
vSonic (m/s)= d3
wsHorizontal (m/s)=(uSonic^2 + vSonic^2)^0.5
This function converts the u and v components
of a sonic anemometer to horizontal wind
speed.
% Modulo division. This operator provides
the positive residue of a division. Unlike
the general modulo operator defined for
integer numbers, the blueberry COMPACT
modulo operator is based on real (floating
point) numbers for parameters and for the
result. The second parameter of the % func-
tion must be positive (a % b with b>0).
Example: Wind Direction
Dir (°) = (360 * b1 / b0 + 126) % 360
The measured wind direction value with an
offset correction of 126 degrees is projected
into the range of 0..360°.
sin Sine function. The angle must be defined in
degrees.
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 16 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 17 -
Example: Status from Threshold Value
Temperature (Celsius) = 20 * a4 - 40
Frost = Temperature < 0
The comparison with a threshold value creates
the status signal 1 = frost / 0 = no frost.
== Comparison equal. The result is 1, if the con-
dition is true, otherwise it is 0.
Example:
identic (1=equal) = (0.2 * a2) == 1.2
This function compares a measured value with
a constant.
!= Comparison not equal. The result is 1, if the
condition is true, otherwise it is 0.
Example:
differentStatus (1=different) = c1 != c2
with third poll command: DIN
This function compares the status of digital
inputs DIN1 and DIN2.
>= Comparison superior or equal. The result is 1,
if the condition is true, otherwise it is 0.
Example:
condensation = Humidity >= 100.1
Relative humidity of more than 100 %RH is con-
sidered as condensation.
<= Comparison inferior or equal. The result is 1,
if the condition is true, otherwise it is 0.
! NOT operator. This operator inverts the logi-
cal level of a boolean value.
Example:
DOUT2 = ! a1
with rst poll command: DIN
Switching output DOUT2 is set active if the sta-
tus signal at digital input DIN1 is low.
valid This operator checks whether a value is a
valid number. The result is 0, if the value is
nan, otherwise it is 1.
Examples: Validity Check
checkValue (1=Ok) = valid (2.45 * a1)
error (1=invalid) = ! valid (2.45 * a1)
if This operator checks whether a value is not 0
or nan. The if operator is typically combined
with the else operator.
Example: Output Limitation
Hum (%RH) = 100*a4 if (100*a4<=100) else 100
In case of condensation, some thermo
hygro sensors show measured values above
100 %RH. This function limits the output of
relative humidity to 100 %RH.
Example: Validity Check
vCup (m/s) = 0.253 * b8 + 0.22 * (b8>0)
vValid (m/s) = vCup if ((vCup>=0)*(vCup<90))
This function denes a range of 0 to 90 m/s for
valid wind speed values. The result of vValid is
vCup if vCup is within this range, otherwise it
is nan.
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 18 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 19 -
else replaces a value if the value is nan.
Example: Filtering of invalid Samples
uSonic (m/s) = d2 else #uSonic else 0
If the sonic anemometer returns an invalid
value, the data logger will keep the previous
value. If the previous value is also invalid the
result is set to 0.
Example: Marking of invalid Samples
relHum (%RH) = 100*a2 else (–9999)
Invalid samples (nan) are stored as –9999.
Combining boolean Results:
The multiplication operator * corresponds to the logical
AND operator. The addition operator + corresponds to
the non exclusive OR operator.
Example: AND, non exclusive OR and exclusive OR
AND = (a2>=0) * (a2<=100)
OR = (a2<0) + (a5<0)
XOR = ((a2<0) + (a5<0)) == 1
Rounding Operators
abs provides the unsigned floating point value of
a signed value.
Example:
alwaysPositive = abs (125 * g7 –75)
int removes the decimal part of the floating
point value.
Example:
intValue = int (–2.45 * d2 + 100)
round rounds the floating point value to the nearest
integer (up or down).
Example: Display without Decimals
LowResDir (deg) = round((360 * a2/a1) % 360)
This function displays the wind direction with-
out decimals.
Example: Fixed Number of Decimals
Radiation = 0.01 * round(100 * (2.645*a2–25))
The oating point function result is reduced to
2 decimals.
Other Operators
( ) Parantheses structure the function elements
and determine the calculation sequence.
# provides the previous value of the measure-
ment function.
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 18 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 19 -
Example: Cumulated Rainfall
actualRain (mm) = 0.1 * b3
cumulRain (mm) =
(#cumulRain + (actualRain else 0))
else actualRain else 0
These two functions record actual and cumu-
lated rainfall. cumulRain adds the actual rain-
fall to the previous cumulated rainfall. When
the measurement starts #cumulRain is invalid
because no previous value exists. The result
is then replaced by actualRain. If this value is
also invalid the result is set to 0. The else op-
erator denes the starting value and prevents
the cumulative value from being reset in case
of an invalid value of actualRain.
Example: Low Pass Filter
noisy = 62.5 * a6 – 55
damped = (0.1 * noisy + 0.9 * #damped) else noisy
This function implements a low pass lter that
smooths a noisy value. damped provides a
damped value of the actual measurement value
provided by noisy.
Operator Summary
The following table lists examples of results based
on the operators with different parameters.
Results for: a = ...
–2.7183 0 +2.7183 nan
a else b –2.7183 0 2.7183 b
b if a b nan b nan
b if a else c b c b c
valid a 1 1 1 0
! a 0 1 0 0
a > 0 0 0 1 nan
a < 0 1 0 0 nan
a == 0 0 1 0 nan
a != 0 1 0 1 nan
a >= 0 0 1 1 nan
a <= 0 1 1 0 nan
a % 1 0.2817 0 0.7183 nan
a % 0.01 0.0017 0 0.0083 nan
a–(a%0.01) –2.72 0 2.71 nan
abs a 2.7183 0 2.7183 nan
int a –2 0 2 nan
round a –3 0 3 nan
ln a nan nan 1.0000 nan
Variables
Variables The variables a1..an correspond to the
first to nth value inside the data line
sent by the first sensor. The blueberry
INPUT module supplies the voltages
of all inputs in Volt as well as the fre-
quency in Hertz and the counted puls-
es. In addition to the variables, oth-
er function names can be used inside
a measurement function. They must
be defined former to the function in
which they are used as a variable. A #
character in front of a function name
provides the measurement value of the
previous measurement.
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 20 -
Data Logger blueberry COMPACT Wilmers Messtechnik GmbH
- 21 -
Example: Temperature Gradient
Temp (°C) = 100 * a3 – 30
deltaTemp (K/s) = (Temp – #Temp) else 0
deltaTemp provides the temperature
gradient between 2 samples.
Predened Variables (internal Sensors)
The following predefined variables provide val-
ues from the senors that are integrated into the
blueberry COMPACT.
PAIR1..2 provides the barometric pressure and
internal temperature measured by the
integrated pressure sensor.
Example: Barometric Pressure
pBaro (hPa) = PAIR1
TempShelterbox (°C) = PAIR2
POWER1..4 provides infos about the power supply.
Example: Power Supply
uSolar (V) = POWER1
uBattery1 (V) = POWER2
uBattery2 (V) = POWER3
iSolar (A) = POWER4
PSolar (W) = POWER1 * POWER4
This functions provide voltages of the
solar module and the two backup bat-
teries. Multiplication of voltage and
current calculates the charging power of
the solar module.
Predened Variables (Time Info)
The following predefined variables provide time
information.
PERIOD provides the actual measurement pe-
riod in seconds.
Example: Integration over Time
ow (m3/s) = 125 * b2
volume (m3) = ow * PERIOD
The function volume uses PERIOD to
intergrate actual ow into a volume.
TIME provides the time in seconds since
1.1.1970 00:00:00.
DAYTIME provides the time in
seconds since 00:00:00 of the current
day.
Example: Flashing Light
DOUT3 (ash) = ! (DAYTIME % 10)
This function ashes a signal lamp every
10 seconds.
YEAR provides the actual calendar year as 4
digit integer (e.g., 2007).
MONTH provides the actual calendar month as
integer (January = 1 .. December = 12).
Example: Season dependent Factors
factor = 0.26*(MONTH<4) +
0.22*(MONTH==4) + 0.25*(MONTH>4)
This function selects a factor depend-
ing on the month. Some algorithms for
determination of potential evaporation
(e.g., HAUDE) use empirical factors that
vary with the season.
Table of contents
