Be an Gateway - RS232 Data Output V1
Transcript of Be an Gateway - RS232 Data Output V1
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 1/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 1 / 31
BeanGateway – RS232 Data Output
V1.2R5
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 2/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 2 / 31
DOCUMENT
Document number V_SES_20 Version V1.2R5
External Reference BGT_RS232_DO Publication date 05/11/2010
Author Philippe FROMON
Internal Reference BGT_RS232_DO Project Code N.A.
Document Name BeanGateway® – RS232 Data Output
VALIDATION
Function Recipients ForValidation Forinformation
Reader Jonathan DINIS, Technical support engineer X
Author Philippe FROMON, embedded software engineer X
MAILING LIST
Function Recipients For action For Info
Staffer 1 Jonathan DINIS X
Staffer 2 Damon PARSY X
Updates
Version Date Author Evolution & Status
V1.0 07 /25/2009 Ph. FROMON First version of the document
V1.1 03/17/2010 Ph. FROMON Math mode measurement added
V1.2 05/11/2010 Ph. FROMON Streaming data frame added
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 3/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 3 / 31
Contents
1. TECHNICAL SUPPORT .................................................................................................................................... 5
2. VISUAL SYMBOLS DEFINITION ...................................................................................................................... 6
3. ACRONYMS AND ABBREVIATIONS ............................................................................................................... 7
4. RELATED DOCUMENTS .................................................................................................................................. 8
5. DUAL LINK RS232/ETHERNET NETWORK ARCHITECTURE ....................................................................... 9
6. RS232 PINOUT ............................................................................................................................................... 12
7. MEASUREMENT DATA GENERAL FRAME FORMAT .................................................................................. 14
1. Long Frame Data – Header Field ............................................................................................................ 14
2. Short Frame Data – Header Field ........................................................................................................... 15
3. Payload Data (Low Duty Cycle Measurement) ....................................................................................... 16
4. Payload Data (Packet math mEASUREMENT) ...................................................................................... 17
5. Payload data – « Streaming Mode » ...................................................................................................... 19
1. BEANGATEWAY DATA COMMUNICATION IN ASCII MODE (ISO/IEC 8859-1:1998) ................................. 21
8. BEANDEVICE SPECIFICATIONS .................................................................................................................. 27
1. BeanDevice version ................................................................................................................................ 27
2. Data Conversion on the DTE EQUIPMENT ............................................................................................ 28
a. BeanDevice® AN-V ................................................................................................................................. 28
b. BeanDevice® AN-420 ............................................................................................................................. 28
c. BeanDevice® T-Si ................................................................................................................................... 29
d. BeanDevice® T-H ................................................................................................................................... 29
e. BeanDevice TOR .................................................................................................................................... 29
f. BeanDevice® AX-3D ............................................................................................................................... 30
g. BeanDevice® Hi-INC .............................................................................................................................. 30 h. BeanDevice® SUN-T .............................................................................................................................. 31
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 4/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 4 / 31
Disclaimer
The information contained in this document is the proprietary information of Beanair.
The contents are confidential and any disclosure to persons other than the officers, employees,agents or subcontractors of the owner or licensee of this document, without the prior writtenconsent of Beanair Ltd, is strictly prohibited.
Beanair makes every effort to ensure the quality of the information it makes available.
Notwithstanding the foregoing, Beanair does not make any warranty as to the informationcontained herein, and does not accept any liability for any injury, loss or damage of any kindincurred by use of or reliance upon the information.
Beanair disclaims any and all responsibility for the application of the devices characterized in thisdocument, and notes that the application of the device must comply with the safety standards ofthe applicable country, and where applicable, with the relevant wiring rules.
Beanair reserves the right to make modifications, additions and deletions to this document due totypographical errors, inaccurate information, or improvements to programs and/or equipment atany time and without notice.
Such changes will, nevertheless be incorporated into new editions of this document.Copyright: Transmittal, reproduction, dissemination and/or editing of this document as well asutilization of its contents and communication thereof to others without express authorization areprohibited. Offenders will be held liable for payment of damages. All rights are reserved.
Copyright © Beanair Ltd. 2010.
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 5/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 5 / 31
1. TECHNICAL SUPPORT
For general contact, technical support, to report documentation errors and to order manuals,contact Beanair Technical Support Center (BTSC) at:
For detailed information about where you can buy the Beanair equipment/software or forrecommendations on accessories and components visit:
www.beanair.com
To register for product news and announcements or for product questions contact Beanair’s Technical Support Center (BTSC).
Our aim is to make this user manual as helpful as possible. Keep us informed of your commentsand suggestions for improvements.Beanair appreciates feedback from the users of our information.
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 6/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 6 / 31
2. VISUAL SYMBOLS DEFINITION
Visuel Définition
Caution or Warning – Alerts the user to important points about
Beanair wireless sensor networks (WSN), if these points are not
followed, the equipment /software may fail or malfunction.
Danger – This information MUST be followed or catastrophic
equipment failure or bodily injury may occur.
Tip or Information – Provides advice and suggestions that may be
useful when installing Beanair Wireless Sensor Networks.
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 7/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 7 / 31
3. ACRONYMS AND ABBREVIATIONS
AES Advanced Encryption Standard
CSMA/CA Carrier Sense Multiple Access/Collision Avoidance
GTS Guaranteed Time-Slot
LLC Logical Link Control
LQI Link Quality Indicator
MAC Media Access Control
PAN Personal Area Network
PER Packet Error Rate
RF Radio Frequency
WSN Wireless Sensor Networks
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 8/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 8 / 31
4. RELATED DOCUMENTS
BeanDevice User Manual V1.4
BeanGateway User Manual V1.5
BeanScape User Manual V1.6
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 9/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 9 / 31
5. DUAL LINK RS232/ETHERNET NETWORK ARCHITECTURE
Data coming from the wireless network is redirected as follows:
For Measurement Data: A RS232 with ASCII or RTU frame format can be used;
For Network Diagnostic Data (Battery Charge/Discharge, Battery Voltage value, PER, LQI):
All these information are displayed on the BeanScape® through the Ethernet Link;
Although displaying Network Diagnostic Data on your BeanScape® is optional, it helps youto configure and manage easily your Wireless Sensor Network (WSN).
The BeanScape® offers the possibility to configure and manage over-the-air a BeanDevice®. The
following configurations are possible:
Radio TX Power in dBm ;
Measurement mode (Low Duty Cycle measurement, Math, Alarm, Streaming … ) ;
Duty Cycle, Sampling frequency and duration ;
Anti-aliasing Filter configuration;
Idle/Active Power mode
The following RS232 functionalities available on the BeanGateway® can be configured through the
BeanScape®:
RTU or ASCII Format;
RS232 Data Rate;
RS232 for LAN Network configuration (IP, DNS & DHCP configuration) or for Measurement
Data output;
cf. the BeanScape® User Manual for more information about the WSN configuration
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 10/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 10 / 31
Two types of network configuration are possible:
Dual Link RS232/Ethernet Network configurationSingle Link RS232 Network configuration
Dual link RS232/Ethernet configuration
Ethernet –TCP/IP
RS232
- RTU or ASCII
Wireless Network
Measurement Data
Network Diagnostic Data
Network
Configuration Data
BeanScape
Network configuration : Single link RS232 configuration
Ethernet –TCP/IP
RS232 - RTU or ASCII
Wireless Network
Network Configuration
Data frame
Single Link: RS232
First Step: Configure and Manage your WSN through the BeanScape®
Data Acquisition frame
BeanScape®
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 11/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 11 / 31
RS232 - RTU or ASCII
Wireless Network
Single Link: RS232
Second Step: Start logging on your DTE equipment all the data acquisition
Data Acquisition frame
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 12/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 12 / 31
6. RS232 PINOUT
The RS232 standard is defined by the EIA/TIA (Electronic Industries Alliance / Telecommunications
Industry Associations). The standard defines an asynchronous serial data transfer mechanism, as
well as the physical and electrical characteristics of the interface.
RS232 uses serial bit streams transmitted at a predefined baud rate. The information is separated
into characters of 5 to 8 bits lengths. Additional start and stop bits are used for synchronization
and a parity bit may be included to provide a simple error detection mechanism.
The electrical interface includes unbalanced line drivers, i.e. all signals are represented by avoltage with reference to a common signal ground. RS232 defines two states for the data signals:
mark state (or logical 1) and space state (or logical 0).
Definitions
DCE Data Communications Equipment. The terms DCE and DTE refer to
the serial devices on each side of an RS232 link. The BeanGateway®
is a typical example of a DCE device. The BeanGateway® isequipped with a female SUB D9.
DTE Data Terminal Equipment. The terms DCE and DTE refer to the
serial devices on each side of an RS232 link. A PC or a terminal are
examples of a typical DTE device. DTE are commonly equipped with
a male SUB D9 or SUB D25 connector. All pinout specifications are
written from a DTE perspective
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 13/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 13 / 31
SUBD9 - PIN Configuration for RS232
communication Protocol
Pin 1 : Not UsedPin 2: RX Data (DTE), TX Data (DCE)Pin 3: TX Data (DTE), RX Data (DCE)Pin 4: Not UsedPin 5: Signal groundPin 6: Not UsedPin 7: Not UsedPin 8: Not Used
Pin 9: Not UsedRTS & CTS Signals are not used
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 14/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 14 / 31
7. MEASUREMENT DATA GENERAL FRAME FORMAT
Header Payload Data Frame Check Sequence
Header Field: contains all the information about the BeanDevice® status & current configuration.
Payload Data Field: Contains all the data acquisition performed by the BeanDevice®;
Frame Check Sequence Field: Contains the extra checksum characters added to the RS232 frame for error detection
and correction;
Two kinds of measurement frame format are available:
A long Data frame, is fully dedicated to low duty cycle measurement, it includes the date of a measurement
A short Data frame is fully dedicated to high stream measurement;
1. LONG FRAME DATA – HEADER FIELD
Long Frame Data is only available with the following measurement mode:
« LDCM- Low Duty Cycle Measurement»
« Alarm »
« Packet Math One Shot »
« Packet Math »
“Streaming”: First Frame only;
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 15/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 15 / 31
Cf. the BeanDevice® user manual for more information about the measurement mode
Long Frame Header
Field name Description length Index
Full Data Length Full Data Length : Header + Payload Data +Checksum
(This field is not included in the Full Data Length)
1 byte 0
Command ID Corresponds to Long Frame Message
Fixed Value: 0x1F
1 byte 1
BeanDevice IDcomponents
MAC Address 8-bytes 3
Network Address 2-bytes 11
PAN ID 2-bytes 13
Measurement mode 0x11 -> « Low Duty Cycle» Mode
0x22 -> « Alarm » Mode
0x55 -> « Packet Math One Shot » Mode
0x66 -> « Packet Math » Mode
0x99 -> « Streaming » Mode
1-byte 15
Payload Data Length Payload data length in bytes 1 byte 16
2. SHORT FRAME DATA – HEADER FIELD
Short Frame Data is only available with the following measurement mode:
Streaming : Measurement data;
Short Frame Header
Field name Description length Index
Full Data Length Full Data Length : Header + Payload Data +Checksum
(This field is not included in the Full Data Length)
1 byte 0
Command ID Corresponds to a short frame message
GATEWAY_ID_SENSORS_VIEW_LONG_MESS
Fixed value: 0xAF
1 byte 1
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 16/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 16 / 31
BeanDevice IDcomponents
Network Address 2-bytes 2
PAN ID 2-bytes 4
PER-Packet ErrorRate
0 to 10 000 pts
To obtain this value in %, you have to divide it by100.
Example: 56 corresponds to a PER of 0,56%
0 to 10 000 pts 3
Link QualityIndicator (LQI)
0 to 255 pts 0 to 255 pts 5
Payload DataLength
Payload data length in bytes 1 byte 17
3. PAYLOAD DATA (LOW DUTY CYCLE MEASUREMENT)
This frame is compliant only with command ID : GATEWAY_ID_SENSORS_VIEW_LONG_MESS
Payload Data – Long Frame
Field name Description length Index
Date of a dataacquisition
Year 2 bytes 17
Month 1 byte 19
Day 1 byte 20
Hour 1 byte 21
Minute 1 byte 22
Seconds 1 byte 23
Number of activatedsensors
Indicates the number of activatedsensors on a BeanDevice®
1 byte 24
Sensor Channel 1 -ID
Sensor Channel 1 - Identity 1 byte 25
Sensor Channel 1
Data acquisitionvalue
Sensor Data acquisition
See the list of the BeanDevice versionfor data conversion
See chapter
1-4 bytes ….
Sensor Channel 2 -ID
Sensor Channel 2 - Identity 1 byte …
Sensor Channel 2Data acquisitionvalue
Sensor Data acquisition
See the list of the BeanDevice versionfor data conversion
1-4 bytes ….
------------------- ---------------------- ------------------------------
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 17/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 17 / 31
Sensor Channel N -ID
Sensor Channel N - Identity 1 byte
Sensor Channel NData acquisitionvalue
Sensor Data acquisition
See the list of the BeanDevice versionfor data conversion
1-4 bytes
Exception : In case of TOR sensor technology
In this case there is not possible to enable or disable 1 of the eight logic inputs
All the eight logic inputs are transmitted into one byte, each bit of this byte means one logic input.
Bit0 => channel 1 …. Bit7 => channel 8
4. PAYLOAD DATA (PACKET MATH MEASUREMENT)
Frame only compliant with command Id : GATEWAY_ID_SENSORS_VIEW_LONG_MESS
Payload Data – Long Frame
Field name Description length Index
Date of a dataacquisition
Year 2 bytes 17
Month 1 byte 19
Day 1 byte 20
Hour 1 byte 21
Minute 1 byte 22
Seconds 1 byte 23
Data acquisitionresolution
Data acquisition resolution is expressedin bits : 8, 16, 24 bits
1 byte 24
Acquisition Duration Acquisition duration in second unit 4 bytes 25
AcquisitionFrequency (en Hz)
Sensor acquisition frequency in Hz unit
Maximum value is 10kHz
2 bytes 27
Number of activatedsensors
Indicates the number of activatedsensors on a BeanDevice®
1 byte 28
Sensor Id 1 1st
ID BeanDevice sensor 1 byte 30
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 18/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 18 / 31
Sensor 1 AverageValue
Sensor 1 average value of samples 3 bytes maximum 31
Sensor 1 MaximumValue
Sensor 1 maximum value of samples 3 bytes maximum
Sensor 1 MinimumValue
Sensor 1 minimum value of samples 3 bytes maximum
Sensor 1 StandardDeviation
Sensor 1 standard deviation value ofsamples
3 bytes maximum
Sensor Id 2 2n
ID BeanDevice sensor 1 byte
Sensor 2 AverageValue
Sensor 2 average value of samples 3 bytes maximum
Sensor 2 MaximumValue
Sensor 2 maximum value of samples 3 bytes maximum
Sensor 2 MinimumValue
Sensor 2 minimum value of samples 3 bytes maximum
Sensor 2 StandardDeviation
Sensor 2 standard deviation value ofsamples
3 bytes maximum
------------------- ---------------------- ------------------------------
Identifiant du capteurN
Nth
ID BeanDevice sensor 1 byte
Sensor N AverageValue
Sensor N average value of samples 3 bytes maximum
Sensor N MaximumValue
Sensor N maximum value of samples 3 bytes maximum
Sensor N MinimumValue
Sensor N minimum value of samples 3 bytes maximum
Sensor N StandardDeviation
Sensor N standard deviation value ofsamples
3 bytes maximum
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 19/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 19 / 31
5. PAYLOAD DATA – « STREAMING MODE »
First Frame format
This Frame is only compliant with command Id: GATEWAY_ID_SENSORS_VIEW_LONG_MESS
Payload Data – Short Frame
Field name Description length Index
Date of a dataacquisition
Year 2 bytes
Month 1 byte
Day 1 byte
Hour 1 byte
Minute 1 byte
Seconds 1 byte
Data acquisitionresolution
Data acquisition resolution is expressedin bits : 8, 16, 24 bits
1 byte
Low Duty CycleMeasurement value(Ct)
Low Duty Cycle measurement, unit : s 4 bytes
Data sampling Time(Dst)
Sampling Time (unit : s) 4 bytes
Data samplingFrequency (Dsf)
Sampling Frequency in Hertz
The maximum sampling frequency is10 KHz.
2 bytes
Latency time betweenfirst frame andsecond frame (Tr)
Latency time between first frame andsecond frame (Tr)
Unit in millisecond (ms)
2 bytes
Number of activesensor
Active sensor available 1 byte
Sensor ID 1 1st
ID BeanDevice sensor
1 byte
Sensor ID 2 2n ID BeanDevice sensor 1 byte
------------------- ---------------------- ------------------------------
Sensor ID N Nth
ID BeanDevice sensor 1 byte
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 20/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 20 / 31
Next Frame
This Frame is only compliant with command Id: GATEWAY_ID_SENSORS_SHORT_MESS
Payload Data – Short Frame
Field name Description length Index
Sequence Number Sequence number of the currentframe
1 byte
Data Acquisition
SensorChannel1
Sensor channel 1 acquisition 1 -4 bytes
SensorChannel2
Sensor channel 2 acquisition 1 -4 bytes
Sensor
Channel3
sensor channel 3 acquisition 1 -4 bytes
SensorChannel3
Sensor channel 4 acquisition 1 -4 bytes
Exception: If the sensor technology is a BeanDevice® TOR (All or Nothing Measurement).In this case there is no notion of sensor activation / inhibition.
In the measurement frame, each byte will represent the state of digital inputs regardless the number ofentries available on this BeanDevice®:
Sensor Channel Channel 1 Channel 2 Channel 3 Channel 4 Channel 5 Channel 6 Channel 7
Bit Position Bit 1 Bit 2 Bit 3 Bit 4 Bit 5 Bit 6 Bit 7
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 21/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 21 / 31
1. BEANGATEWAY DATA COMMUNICATION IN ASCII MODE (ISO/IEC
8859-1:1998)
Frame Format:
<Start Word> <Message > <End Word>
Symbol Definition:
<Start Word> : SW
<End Word> : <LF> <CR> : new line
<CR> : Carriage return char
<LF> : Linefeed char
Note : In ASCII mode, any data begins by the <Start Word> and ends by <End Word>
Message Definition:
General Format:
<Message> :
<Command> [ : <Argument1> [ , <Argument2> [ , … , <ArgumentN> ] ] ]
Note: arguments between square bracket are optional.
Message with “MEAS” command:
< MEAS Message >
MEAS : <Mac Id> , <Network Id> , <Pan Id> , <Measure Mode> , <Measure Data>
<Mac Id> format :
XXXXXXXXXXXXXXXX : where X can be the char between 0 and 9 and between A and F(hexadecimal representation)
It the unique identifier of the WSN device.
<Network Id> format :
XXXX : where X can be the char between 0 and 9 and between A and F (hexadecimalrepresentation)
It the current network identifier of the WSN device (useless for the final user).
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 22/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 22 / 31
<Pan Id> format:
XXXX : where X can be the char between 0 and 9 and between A and F (hexadecimal
representation)It is WSN identifier.
<Measure Mode> format:
Define the kind of measure mode and define the following data into the message
<Measure Data> format is functions of the previous field <Measure Mode>
- Low Duty Cycle “A”
- Alarm “B”
<Date> , <Active Sensor Number> , <1st Sensor Id> , <1st Sensor Measure> [ , <2nd Sensor Id> , <2nd Sensor Measure> [ , … , <Nth Sensor Id> , <Nth Sensor Measure> ] ]
- Packet Math One Shot “C”
- Packet Math “D”
<Date> , <Acquisition Duration> , <Acquisition Frequency> , <Active Sensor Number> , <1st Sensor Id> , <1st Sensor Math Measure> [ , <2nd Sensor Id> , <2nd Sensor Math Measure> [ , … , <Nth Sensor Id> , <Nth Sensor Math Measure> ] ]
- Streaming “F”
- First Frame:
<Date> , <Low Duty Cycle Measure> , <Data Sampling Time> , <Acquisition Frequency> , <Latency Frame> , <Active Sensor Number> , <1st Sensor Id> [ , <2nd Sensor Id> [ , … , <Nth Sensor Id> ] ]
- Next Frames:
(see SHORT command)
Measure Mode Value Functional Measure Mode
A Low Duty Cycle
B Alarm
C Packet Math One ShotD Packet Math
F Streaming
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 23/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 23 / 31
Message with “SHORT” command:
< SHORT Message >
SHORT : <Network Id> , <Pan Id> , <PER> , <LQI> , <Stream Measure Data>
<Stream Measure Data>
<Sequence Number> , <1st Sensor Measure> [ , <2nd Sensor Measure> [ , … , <Nth Sensor Measure> ] ]
Fields explanations:
<Date> :
YYYYMMDDHHWWSS where
YYYY is the year with Y as numeric char
MM is the month with M as numeric char
DD is the day with D as numeric char
HH is the hour with H as numeric char
WW is minute with W as numeric char
SS is the seconds with S as numeric char
<Active Sensor Number> :
X where X is one numeric char between 1 and 8, define the number of active sensor into themeasure message.
<Nth Sensor Id> :
X where X is one numeric char between 0 and 7, define the zero indexed sensor id.
<Nth Sensor Measure> :
Numeric value between 0 and 65535, define the raw data measure for the previous sensor id
<Acquisition Duration> :
Numeric value that defines the sampling duration in second unit (Math Mode) , the field lengthvaries
<Acquisition Frequency> :
Numeric value that define the sampling frequency in Hz unit, the field length varies
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 24/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 24 / 31
<Nth Sensor Math Measure> format:
<Average Value> , <Maximum Value> , <Minimum Value> , <Standard Deviation Value>
These four values are numeric value
<Low Duty Cycle Measure> :
Numeric value in second unit, the field length varies
<Data Sampling Time> :
Numeric value in second unit, the field length varies
<Latency Frame> :Numeric value in second unit, the field length varies
Frame Examples:
Low Duty Cycle example:
Measure data from a BeanDevice in “Low Duty Cycle” measure mode which:
- Mac Id is 01 02 03 04 05 06 07 08
- Network Id is 0003
- Pan Id is 1234
- The current measure mode is “Low Duty Cycle” mode
- Measure date is 2008/08/31 10:03:25
- 3 activated sensors
sensor id 0 has a raw value = 12750
sensor id 1 has a raw value = 25632
sensor id 2 has a raw value = 35187
“SWMEAS:0102030405060708,0003,1234,A,20100831100325,3,0,12750,1,25632,2,35187<LF><CR>”
Streaming example:
Measure data from a BeanDevice in “Streaming” measure mode which:
- Mac Id is 01 02 03 04 05 06 07 08
- Network Id is 0003
- Pan Id is 1234
- The current measure mode is “Streaming” mode
- Measure date is 2008/08/31 10:03:44
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 25/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 25 / 31
- Low Duty Cycle is 3780 sec = 1:03:00
- Data Sampling Time is 3600 sec = 1 hour
- Acquisition Frequency is 200Hz
- The latency Frame is 150ms
- 2 activated sensors
sensor id 1
sensor id 3
The first frame which describe this measure mode is
“SWMEAS:0102030405060708,0003,1234,F,20100831100344,3780,3600,200,150,2,1,3<LF><CR>”
Then the following measure frames are generated like that :“SWSHORT:0003,1234,0,210,112,13758,38258<LF><CR>”
“SWSHORT:0003,1234,0,209,113,13759,38256<LF><CR>”
“SWSHORT:0003,1234,0,210,114,13758,38257<LF><CR>”
Three continuous measure frames from the same device: Network Id = 0003.
Packet Math Mode example:
Measure data from a BeanDevice in “Low Duty Cycle” measure mode which:
- Mac Id is 01 02 03 04 05 06 07 08
- Network Id is 0003
- Pan Id is 1234
- The current measure mode is “Packet Math” mode
- Measure date is 2008/08/31 10:03:25
- Acquisition duration is 30 seconds, for an acquisition frequency of 500Hz
- 3 activated sensors
sensor id 0 has values
•
avg : 5000• max : 6000
• min : 4000
• std dev : 1000
sensor id 1 has values
• avg : 500
• max : 750
• min : 250
• std dev : 250
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 26/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 26 / 31
“SWMEAS:0102030405060708,0003,1234,D,20100831100325,30,500,2,0,5000,6000,4000,1000,1,500,750,250,250<LF><CR>”
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 27/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 27 / 31
8. BEANDEVICE SPECIFICATIONS
1. BEANDEVICE VERSION
This following table describes succinctly the different BeanDevice® version available:
BeanDevice® Version
Description Measurement range (in points)
AN-420 Wireless acquisition system for currentLoop 4-20 mA signal
0-65535
AN-mV Wireless acquisition system for lowvoltage +/- 20mV signal
0-65535
AN-V Wireless acquisition system for +/- 5V or+/-10V signal
0-65535
AX-3D Wireless tri-axial accelerometer
+/-2g and +/-10g
0-65535
AX-HD Wireless mono-axial accelerometer
+/-10g
0-65535
HI-INC Wireless inclinometer:
+/-90°, +/-30°, +/-15°
0-65535
TSI Wireless temperature sensor 0-65535
TH Wireless Temperature/humidity sensors 0-65535
TOR Wireless “All or Nothing” measurement 0-255
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 28/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 28 / 31
2. DATA CONVERSION ON THE DTE EQUIPMENT
All the raw data received by your DTE equipment must be converted into a unit reflecting your measurementtechnology.
For each type of BeanDevice®, the conversion equation is different.
A. BEANDEVICE® AN-V
The following conversion equation must be performed:
Converted_Data = Offset + Ratio* Raw_Data(bits)
Measure Range Bipolar/Unipolar
Measure
Offset Ratio Unit to display
If measure range = 0-10V Unipolar 0 10/65535 V
If measure range = -5V-5V Bipolar -5 10/65535 V
If measure range = 0-20V Unipolar 0 20/65535 V
If measure range = -10-10V
Bipolar -10 20/65535 V
Example : For a raw data value of 55000 points.
The converted value is: 55000*10/65535 = 8,39 Volts in unipolar measurement, and 3,39Volts in bipolarmeasurement.
B. BEANDEVICE® AN-420
The following conversion equation must be performed:
Converted_Data = Offset + Ratio* Raw_Data(bits)
Measurement range for
converted measurement
Offset Ratio Converted unit
Current Loop : 4-20 mA 0 20/65535 mA
Example : For a raw data value of 57000 points.
The converted value is: 57000*20/65535 = 17,395 mA
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 29/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 29 / 31
C. BEANDEVICE® T-SI
The following conversion equation must be performed:
Converted_Data = Offset + Ratio*Raw_Data(bits)
Measurement range forconverted data
Offset Ratio Unit
Temperature : -50°C-150°C -50 200/2047 °C
Example : For a raw data value: 1200 bits.
The converted value is: 1200*200/2047 - 50 = 67, 25 °C
D. BEANDEVICE® T-H
The following conversion equation must be applied:
Converted_Data = Offset + Ratio*RX_Data(bits)
Measurement range forconverted data Offset Ratio Unit
Temperature :
-40° to +125°C
-40 165/32767 °C
Humidity :
0 to 100%RH
0 100/32767 %RH
Example : For a raw data value of 22000 pts for temperature and 5000 pts for Humidity.
The converted value is: 22000*165/32767 = 110, 78 °C
5000*100/32767 = 15,26 % RH
E. BEANDEVICE TOR
No conversion
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 30/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
Ref: BeanDevice User Manual Publication date : 12/06/2010Document Internal Reference :
BGT_RS232_DO Page : 30 / 31
F. BEANDEVICE® AX-3D
The following conversion equation must be performed:
Converted_Data = Offset + Ratio*RX_Data(bits)
Measurement range for converteddata
Offset Ratio Unit
Acceleration : +/- 2g -2 2/65535 g
Acceleration : +/- 10g -10 10/65535 g
Example : For a raw data value: 2500 bits.
The converted value is (for a +/- 2g accelerometer): 2500*2/65535 - 2 = -1,923g
G. BEANDEVICE® HI-INC
The following conversion formula must be performed:
where: Offset = output of the device at 0° inclination position, Sensitivity is the sensitivity of thesensor and VDout is the sensor raw data value in bits. The nominal offset is 32765 bits and the sensitivity is :
Inclinometer version Sensitivity ( in bits)
+/-90° 26208
+/-30° 52416
+/-15° 104864
Angles close to 0° inclination can be estimated quite accurately with straight line conversion but for the bestpossible accuracy, arcsine conversion is recommended to be used. The following table shows the anglemeasurement error if straight line conversion is used.Straight line conversion equation:
8/2/2019 Be an Gateway - RS232 Data Output V1
http://slidepdf.com/reader/full/be-an-gateway-rs232-data-output-v1 31/31
BeanAir1, mail Gay Lussac
95000 Neuville-Sur-Oise
France
Document Version : 1.2 R5
BeanGateway® – RS232 Data Output
R f B D i U M l P bli i d 12/06/2010Document Internal Reference :
P 31 / 31
H. BEANDEVICE® SUN-T
The following conversion formula must be performed:
Converted_Data = Offset + Ratio*RX_Data(bits)
Measurement range forconverted data
Offset Ratio Unit
Sunshine :
0 to 65000 Lux
0 1/100 Lux
Example : For a raw data value: 2200 bits.
The converted value is 2200/100 = 22 Lux