Brio Briosens User manual

Rev. 1.0

04/07/2017

BrioSens™ Gateway

User Manual

BrioSens™ Gateway – User Manual

Table of Contents

1. Document revision history .................................................................................................................... 5

2. Overview ............................................................................................................................................... 5

2.1. BrioSens™ Mo els ......................................................................................................................... 5

2.2. Device Overview ........................................................................................................................... 6

2.3. Package Content ........................................................................................................................... 6

3. Har ware Setup an Installation .......................................................................................................... 7

3.1. SIM Car Installation ..................................................................................................................... 7

3.2. Antenna Installation (mo els with external antennas only)....................................................... 10

3.3. Power an Sensors Connections ................................................................................................. 11

Terminal Block Pinout ......................................................................................................... 11

3.3.1.

Si e Connectors Pinout (some mo els only) ...................................................................... 12

3.3.2.

Power Connection ............................................................................................................... 12

3.3.3.

Sensors Connection ............................................................................................................. 13

3.3.4.

3.4. Mounting Instructions ................................................................................................................ 13

4. Partitions an Filesystem .................................................................................................................... 16

4.1. Secon ary bootloa er ................................................................................................................. 16

4.2. Storage ........................................................................................................................................ 16

4.3. Filesystem ................................................................................................................................... 16

4.4. OverlayFS .................................................................................................................................... 17

4.5. Up ating the file system ............................................................................................................. 17

USB rive ............................................................................................................................. 17

4.5.1.

Permanent storage ............................................................................................................. 17

4.5.2.

Over-The-Air (OTA) up ate ................................................................................................. 17

4.5.3.

4.6. Customizing the file system ........................................................................................................ 18

5. system ............................................................................................................................................... 19

5.1. Basic system comman s ........................................................................................................... 19

5.2. journal ....................................................................................................................................... 19

Basic log viewing ................................................................................................................. 20

5.2.1.

6. Peripheral access ................................................................................................................................ 21

6.1. USB .............................................................................................................................................. 21

6.2. FTDI ............................................................................................................................................. 21

6.3. Serial RS-232 ............................................................................................................................... 21

6.4. GPIO ............................................................................................................................................ 21

GPIO example ...................................................................................................................... 22

6.4.1.

6.5. ADC .............................................................................................................................................. 23

Gain configuration .............................................................................................................. 23

6.5.1.

BrioSens™ Gateway – User Manual

ADC rea ings ....................................................................................................................... 24

6.5.2.

ADC as a 4-20mA sensor input ............................................................................................ 25

6.5.3.

ADC example ....................................................................................................................... 26

6.5.4.

6.6. Wi-Fi ............................................................................................................................................ 27

WiFi operation .................................................................................................................... 27

6.6.1.

6.7. Bluetooth .................................................................................................................................... 28

6.8. Ra io wireless connectivity ......................................................................................................... 28

7. Application evelopment .................................................................................................................... 29

7.1. Buil ing an application with a Makefile ...................................................................................... 29

Cross-compiler an its path ................................................................................................ 29

7.1.1.

Inclu es an libraries .......................................................................................................... 30

7.1.2.

Sources an executable Name ............................................................................................ 30

7.1.3.

Buil ing the application ...................................................................................................... 30

7.1.4.

7.2. Qt preparation ............................................................................................................................ 31

7.3. Buil ing an application with Qt ................................................................................................... 31

7.4. Qt Bluetooth examples ............................................................................................................... 32

7.5. Running the application .............................................................................................................. 32

7.6. Testing the Qt Bluetooth heartrate server example ................................................................... 33

8. Specifications ...................................................................................................................................... 34

8.1. Absolute Maximum Rating .......................................................................................................... 34

8.2. Processing Unit ........................................................................................................................... 34

8.3. Programming & Management .................................................................................................... 34

8.4. Cellular RF Compatibility (part numbers with -32G) ................................................................... 34

8.5. Cellular RF Compatibility (part numbers with -43G1) ................................................................. 34

8.6. Cellular Interfaces ....................................................................................................................... 35

8.7. Wi-Fi & Bluetooth ....................................................................................................................... 35

8.8. USB .............................................................................................................................................. 35

8.9. Serial RS-232 Interface ................................................................................................................ 35

8.10. Input Power ............................................................................................................................. 35

8.11. Digital Inputs ........................................................................................................................... 36

8.12. Analog Inputs .......................................................................................................................... 37

8.13. Sensors (Built-in) ..................................................................................................................... 38

8.14. Status In icators ..................................................................................................................... 38

8.15. Environmental ......................................................................................................................... 38

8.16. Physical .................................................................................................................................... 38

8.17. Regulator Approvals & Compliance ........................................................................................ 40

9. Optional Accessories ........................................................................................................................... 41

9.1. Power Supply – North America ................................................................................................... 41

BrioSens™ Gateway – User Manual

9.2. Mounting Bracket ....................................................................................................................... 41

10. Regulatory Notices .......................................................................................................................... 42

10.1. RF Ra iation Exposure Notice ................................................................................................. 42

10.2. FCC Mo ification Notice ......................................................................................................... 42

10.3. FCC Class A Notice ................................................................................................................... 42

10.4. In ustry Cana a Notice ........................................................................................................... 42

10.5. CE Conformity ......................................................................................................................... 42

CE RoHS Directive ................................................................................................................ 42

10.5.1.

CE WEEE Directive ............................................................................................................... 42

10.5.2.

11. Support............................................................................................................................................ 43

BrioSens™ Gateway – User Manual

1. Document revision history

Revision Date Comments

1.0 2017-07-04 First release

2. Overview

BrioSens™ is a fully integrate sensor monitoring an communications gateway incorporating a

powerful processor, certifie WWAN an WLAN technologies an multiple user configurable analog &

igital inputs, is also available with an IP65 enclosure esigne for tough environments. BrioSens™ is

easy to program & eploy an uniquely suite for real or interval time in ustrial sensing applications.

2.1. BrioSens™ Models

The table below shows the ifferent BrioSens™ mo els, an the correspon ing features.

Features BSNS-NA-

BIW

BSNS-32G-

W-BIW

BSNS-43G1-

US-BIW

BSNS-NA-

BUWX

BSNS-32G-

W-BUWX

BSNS-43G1-

US-BUWX

Wi-Fi

•

Bluetooth

•

IP65 ingress

protection

•

Integrate cellular

antenna(s)

•

SMA connector(s)

for external cellular

antenna(s)

•

USB connector

•

A itional power

connector

•

3G (UMTS) / 2G

(GSM/GPRS) cellular

ra io

•

4G-LTE Cat. 1 /

fallback to 3G

(UMTS) cellular ra io

•

BrioSens™ Gateway – User Manual

2.2. Device Overview

2. . Package Content

BrioSens™ evice ships with the following content:

• BrioSens™ unit

• Rubber feet (4x)

Refer to Section for available optional accessories.

USB and side

power connector

(some models only)

SMA antenna connectors

(some models only)

Status LED

Screw terminal

cover

Power LED

User LED

BrioSens™ Gateway – User Manual

. Hardware Setup and Installation

This section etails how to setup an connect the BrioSens™ Gateway before use.

.1. SIM Card Installation

The SIM car installation must be one in an electrostatic ischarge (ESD) safe environment.

Failure to o so can amage the evice.

Step 1 – Remove the screw terminals cover screw using a Philips screw river.

Step 2 – Flip back the unit an remove the five bottom screws using a Philips screw river.

BrioSens™ Gateway – User Manual

Step 3 – Flip back the evice an carefully remove the top cover.

While removing the top

cover

, take care not to pull the coaxial cables. Excessive forces on the

coaxial cables can amage them or their mating connectors.

Step 4 – Insert the Micro-SIM car into the BitPipe™ SIM car hol er in the orientation shown. Press the

car until it clicks-in.

BrioSens™ Gateway – User Manual

Step 5 – Reinstall the top cover, the bottom five screws an the screw terminals cover screw. Do not

over-tighten the screws. Stripping the screw mounts may compromise the IP65 rating on associate

mo els.

For IP65

protecte mo els

, the gaskets must be clean to ensure proper sealing of the evice.

Inspect the gaskets before reassembling the unit, an clean them using a lint-free cloth if

necessary.

BrioSens™ Gateway – User Manual

.2. Antenna Installation (models with external antennas only)

One or two antenna(s) must be connecte to the evice, epen ing on mo el, to the SMA connectors

locate on the rear si e of the unit. Goo quality coaxial extension cable may be use if nee e to

position the antenna(s) farther from the evice. The SMA connectors have stan ar polarity (i.e. are

not reverse polarity).

The

SMA connectors

must be mate

carefully an fasten until snug; recommen e

torque

80 to 110 N·cm (7 to 10 Ibf·in). Do not overtighten as this may amage the connectors an

cause unreliable RF performances.

Below are the antenna(s) requirements:

Models with 3G (UMTS) / 2G (GSM/GPRS) cellular radio (part numbers with -32G):

• 850, 900, 1800, 1900 MHz ban s for GSM/GPRS/EDGE (2G) communication

• 800, 850, 900, 1900, 2100 MHz ban s for UMTS/HSPA+ (3G) communication

• Maximum antenna gain, inclu ing cable loss, of 1.27 Bi at 850 MHz

• Maximum antenna gain, inclu ing cable loss, of 2.51 Bi at 1900 MHz

Models with 4G-LTE Cat. 1 / fallback to 3G (UMTS) cellular radio (part numbers with -43G1):

• 850, 1700/2100 (AWS), 1900 MHz ban s for UMTS/HSPA+ (3G) communication

• 700, 850, 1700/2100 (AWS), 1900 MHz ban s for LTE-Cat1 (4G) communication

• Maximum antenna gain, inclu ing cable loss, of 2.15 Bi at 700, 850, 1700 an 1900 MHz

Using a higher gain antenna(s)

voi the user’s authority to operate this equipment

Main Antenna

(3G and LTE)

RX Diversity Antenna

(LTE models only)

BrioSens™ Gateway – User Manual

. . Power and Sensors Connections

Step 1 – Remove the terminals cover screw, then remove the terminals cover.

Step 2 – Connect the appropriate wires, using the pinout shown below. Secure the wires using a 2 mm

flathea screw river. For ratings an escription of each inputs, refer to the pro uct specifications in

Section 8.

Step 3 – Reinstall the terminals cover an secure using the terminal screw. Ensure the cover is properly

aligne to ensure the IP65 Ingress Protection is maintaine on associate mo els

Terminal Block Pinout

3.3.1.

Screw Terminal Details:

Wire gauge range: 16 to 26 AWG (soli or stran e wire)

Recommen e torque: 20 N·cm (1.7 Ibf·in)

Recommen e wire strip length 5-6 mm

BrioSens™ Gateway – User Manual

Side Connectors Pinout (some models only)

3.3.2.

Power Connector Details:

Connector mo el Molex 43650-0200 (tin plate contacts)

Mating connector housing: Molex 43645-0200

Recommen e crimp terminal: Molex 43030-0001 (tin plate contacts)

USB Connector Details:

Connector type Stan ar USB 2.0 type A socket

Power Connection

3.3.3.

The external DC power is typically provi e to the unit using the green screw terminals. There are two

VIN+ an two GND terminals. Connection is only nee e on one pair; the remaining pair can be use to

provi e power to sensors.

Alternatively, on some mo els, the evice can also be powere by the si e power connector. Both

connectors are har wire together, so if the si e connector is use , the power green screw terminals

Power Connector

USB

Connector

BrioSens™ Gateway – User Manual

can be use to provi e power to sensors. In this case, the power supply will nee to be size

accor ingly, taking into account sensor power consumption.

Sensors Connection

3.3.4.

BrioSens™ can connect to various types of analog an igital sensors. A itionally, it inclu es an RS-232

port for communication with sensors or other evices. Refer to the terminal block pinout above, an the

specification sections for etails.

.4. Mounting Instructions

The BrioSens™ can be securely mounte to various surfaces using the optional mounting bracket.

Step 1 – Remove the rubber feet to expose the mounting holes.

BrioSens™ Gateway – User Manual

Step 2 – Align the mounting bracket with the evice, an secure it using the provi e four #8 3/8” self-

threa ing screws. Do not over-tighten as this may strip the screw mounts.

To prevent amage to the evice an /or

compromise

the ingress protection, only use the

provi e screws to secure the mounting bracket to the evice.

Step 3 – Secure the mounting bracket to the esire location using any pan hea , roun hea , or socket

cap hea #8 screws. Alternatively, other mounting metho s can be use with si e slots.

BrioSens™ Gateway – User Manual

For mo els with IP65

ingress protection, position the evice so that water on cables will

flow away from wire terminals. The i eal orientation is vertical, on a wall or otherwise, with

the cables exten ing ownwar s.

For mo els

with no IP65

ingress protection

, the evice

must be installe

in a location

protecte from rain, other liqui s or usty environments.

Obstructions to the internal

Fi, Bluetooth an cellular

antennas

(some mo els)

will prevent

proper wireless performances. Do not place large metallic objects near the internal antennas

area, or otherwise obstruct them from ra iating.

Internal

antennas area

Proper in

stallation

orientation for IP65

protected models with

water on cables flowing

away from device

Water falling

BrioSens™ Gateway – User Manual

4. Partitions and Filesystem

The BrioSens™ uses a NAND for storage. The NAND memory has a capacity of 4 Gbits (512MB) an has

been partitione in the following manner:

Partition Label Size

mt 0 Secon ary bootloa er 32MB

mt 1 Storage 260MB

mt 2 Filesystem 220MB

4.1. Secondary bootloader

Upon power up, the i.MX28 processor runs the co e from its internal boot ROM. The first stage

bootloa er loa s the secon ary bootloa er locate at the base a ress of the NAND memory.

The secon ary bootloa er partition is a rea -only partition an is loa e uring the boot process. This

partition cannot be mo ifie without burning a new kernel to the NAND memory.

The secon ary bootloa er is comprise of the following:

• a boot kernel

• a boot kernel evice tree ( tb)

• an initramfs (embe e in the kernel)

• imx bootlet

The secon ary bootloa er is responsible of up ating the file system an launching the application

kernel.

4.2. Storage

The Storage partition is a non-volatile partition use to store user files. The contents of this partition are

maintaine after reboot.

This partition also contains user configuration files (ex: Wi-Fi configuration) which can be mo ifie an

save .

4. . Filesystem

The Filesystem partition is rea -only an comprise of the following:

• an application kernel

• an application kernel evice tree ( tb)

• an initramfs (embe e in the kernel)

The file system partition also contains the root filesystem (rootfs). Once mounte , files in the Filesystem

can temporarily be create , mo ifie or elete . However, the files will be restore to its original state

after reboot. This prevents corruption of rootfs.

BrioSens™ Gateway – User Manual

Configurations require by rootfs use symbolic links to the Storage partition. This allows configurations

to persist even after a reboot.

If the user nee s to customize the filesystem, please refer to Section 4.6 for instructions.

4.4. OverlayFS

The BrioSens™ uses a rea -only filesystem to prevent changes from occurring on the root filesystem that

may corrupt the system. It allows a simple reboot to restore a system to a pristine state.

BrioSens™ uses OverlayFS to allow temporary mo ification of rea -only files an fol er.

4.5. Updating the file system

The kernel an file system can be up ate by three metho s:

• USB rive

• Permanent storage

• Over-The-Air (OTA) up ate

All up ate metho s require two files:

• rootfs.tar.gz: compresse file system

• rootfs.tar.gz.m 5: checksum of the compresse file system

USB drive

4.5.1.

During the boot process, the secon ary bootloa er searches for a USB rive with a FAT32 partition an

mounts it. If the USB rive contains the require up ate files, the secon ary bootloa er procee s to

up ate the file system.

Permanent storage

4.5.2.

If there is no USB rive, the secon ary bootloa er checks whether there is a new up ate file in the

permanent storage partition. The up ate files shoul be locate in the following fol er:

/mnt/storage

The secon ary bootloa er will look in the location of the up ate file an if the file exists with its

correspon ing checksum, the bootloa er procee s to up ate the file system.

Note:

When using the permanent storage metho , make sure to keep a copy of the up ate files since

the files (rootfs.tar.gz an rootfs.tar.gz.m 5) will be elete from the target. The files on the

USB key will not be elete to allow the up ate of multiple evices.

Over-The-Air (OTA) update

4.5.3.

The BrioSens™ Gateway inclu es a script to up ate itself by ownloa ing an up ate package from the

internet. In or er to up ate the system, execute the following script:

/usr/local/bin/update_system

BrioSens™ Gateway – User Manual

The up ate script will verify if a ownloa is available, ownloa the up ate package containing the

require files, an up ate the file system.

If you woul like to have a new up ate poste for your evices, please contact Briowireless for more

information.

4.6. Customizing the file system

Mo ifying the file system

may

corrupt the system. If the BrioSens

™

Gateway stops working

after customizing the file system, simply revert the changes by using a file system provi e by

Briowireless. Once customize an up ate , the file system will become rea -only an any

changes to that file system will be restore with a reboot.

In or er to mo ify the file system, the following proce ure shoul be followe :

1. Obtain a copy of the original rootfs.tar.gz

2. Decompress rootfs

3. Apply the necessary mo ifications

4. Re-create the compresse archive. Make sure it is calle rootfs.tar.gz

5. Generate a checksum from the compresse archive an name it rootfs.tar.gz.m 5 using the

following shell comman :

md5sum rootfs.tar.gz > rootfs.tar.gz.md5

Once both files (compresse archive an m 5 file) have been create , follow instructions in section 4.5

to up ate the file system.

BrioSens™ Gateway – User Manual

5. systemd

systemd

is an init system that brings up the user space an manages all processes subsequently.

systemd

is the name of the init aemon, an also inclu es the aemons

journald

logind

networkd

5.1. Basic systemd commands

The full explanation about

systemd

an services is beyon the scope of this user manual, however, the

following comman s are useful to manage the services.

To list all services:

systemctl list-units --type service --all

To start a service:

systemctl start [name.service]

To stop a service:

systemctl stop [name.service]

Restart a service:

systemctl restart [name.service]

Reloa a service:

systemctl reload [name.service]

To manage which services will start at boot, the service nee s to be enable :

systemctl enable [name.service]

To isable a service. This will prevent the service from starting at boot:

systemctl disable [name.service]

Get a full status of a service:

systemctl status [name.service]

Check whether a service is active:

systemctl is-active [name.service]

5.2. journald

journald

is a system service that collects an stores logging ata. It was intro uce with

systemd

. It

simplifies the task for system a ministrators to fin interesting an relevant information among an ever-

increasing amount of log messages.

BrioSens™ Gateway – User Manual

Basic log viewing

5.2.1.

There are too many options to view an manipulate the logs, here are the most useful ones:

When use alone, the comman below will show all the logs store in the system starting from the

ol est. This will likely pages an pages of ata.

journalctl

To show only the logs since the most recent boot:

journalctl -b

To isplay a set amount of recor s, use the

-n

option (works exactly as

tail –n

The following comman isplays the 10 most recent entries:

journalctl -n

To specify the number of entries, a a number after the -n flag:

Journalctl -n 20

To filter by time or ate, ifferent keywor s can be use :

journalctl --since "2015-01-10 --until “2015-01-11 03:00

journalctl --since yesterday --until “1 hour ago

There are more keywor s an combinations that can be use . Please refer to man pages of

journalctl

for more information.

To isplay only kernel messages, use the

-k

--dmesg

flags:

journalctl -k

To filter entries by unit or service, use the

-u

option:

journalctl -u systemd-networkd.service

To filter by process, user or group ID, the

_PID

_UID

_GID

fiel s can be use respectively.

For instance, if we are intereste in the process whose ID is 210, the following comman will retrieve

the logs store from that process:

journalctl _PID=210

Table of contents

Popular Gateway manuals by other brands

infinias

infinias S-IMS-A Intelli-M Installation and user guide

nilan

nilan Compact S installation instructions

WELLTECH

WELLTECH FXO GATEWAY H.323 3802 manual

Moxa Technologies

Moxa Technologies MGate 5118 Series user manual

Vignet

Vignet AD802 user manual

SAGEMCOM

SAGEMCOM FAST 3890 V3 quick start guide

HP StorageWorks P4000 G2 user guide

Laird

Laird Sentrius RG1 Series quick start guide

SonicWALL

SonicWALL TZ 150 Wireless Getting started guide

ZyXEL Communications

ZyXEL Communications VMG3925-B10A user guide

Inseego

Inseego SKYUS 100B Series user guide

Portech

Portech MV-374 user manual

Enterasys

Enterasys ANG-1000 Installation & service guide

RadiSys

RadiSys SEG-100 Administration guide

TECOM

TECOM IG6600 Administration manual

Yeastar Technology

Yeastar Technology TG400G user guide

Linkcom

Linkcom Link Gate SIP user guide

DEUTSCHMANN AUTOMATION

DEUTSCHMANN AUTOMATION UNIGATE IC instruction manual

BRIO BrioSens User manual

Popular Gateway manuals by other brands