32
 BeanAir 1, 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/2010 Document Internal Reference : BGT_RS232_DO Page : 1 / 31 BeanGateway – RS232 Data Output V1.2R5

Be an Gateway - RS232 Data Output V1

  • Upload
    beanair

  • View
    222

  • Download
    0

Embed Size (px)

Citation preview

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:

[email protected] 

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