Briowireless BitPipe User manual

www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 1
Version 1.1
31 10 2017
BitPipe™ shield for Arduino
User Guide

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 2
Table of Contents
1. Revision History .................................................................................................................................... 3
2. Introduction .......................................................................................................................................... 3
2.1. Audience ....................................................................................................................................... 3
3. Hardware Set-up ................................................................................................................................... 4
3.1. Target Arduino Hardware ............................................................................................................. 4
3.2. What's included ............................................................................................................................ 4
3.3. Things you will need ...................................................................................................................... 5
3.4. Electro-mechanical assembly ........................................................................................................ 5
3.5. Power & communication .............................................................................................................. 9
4. Hardware Interconnect ....................................................................................................................... 10
4.1. BitPipe™ shield header connectors signal assignments ............................................................. 10
4.2. BitPipe™ Modem mode .............................................................................................................. 10
4.3. Controlling radio power .............................................................................................................. 10
5. Alternative Arduino boards ................................................................................................................. 11
5.1. Old Arduino boards (Pre R3 Headers) ......................................................................................... 11
5.2. Small form factor Arduino boards .............................................................................................. 12
6. Arduino environment .......................................................................................................................... 13
6.1. Importing BitPipe™ Arduino SDK into Arduino IDE ..................................................................... 13
6.2. Examples ..................................................................................................................................... 13
6.2.1. HTTPGet .............................................................................................................................. 13
6.2.2. HTTPPost ............................................................................................................................. 13
6.2.3. TCPClient ............................................................................................................................. 14
6.2.4. MQTT ................................................................................................................................... 14
6.2.5. SMS ..................................................................................................................................... 14
6.3. Creating your own project .......................................................................................................... 14
7. Support................................................................................................................................................ 15

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 3
1. Revision History
Revision Date Comments
1.0
13 04 2017
First release
1
.
1
3
1
10 2017
Update
section 6.1
(importing the
B
it
P
ipe
™
library)
2. Introduction
The BitPipe™ Arduino shield is designed to provide connectivity between the Briowireless BitPipe™ and
an Arduino board. It is designed for developers, integrators and hobbyists who want to easily integrate
cellular Internet connectivity to their hardware solutions.
This document describes how to setup and use the BitPipe™ shield for Arduino.
Figure 1: BitPipe™ shie d Simp ified B ock Diagram
2.1. Audience
This document targets software integrators that are experienced with the Arduino environment.
This document supposes the use of the Arduino IDE for development.

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 4
3. Hardware Set-up
3.1. Target Arduino Hardware
The BitPipe™ shield is designed to work with the Arduino R3 pinout. The following Arduino boards are
compatible with the BitPipe™ shield:
• Arduino Uno
• Arduino Leonardo
• Arduino Mega & Mega ADK
• Arduino Zero
• Arduino Due
• Arduino M0 & M0 Pro
Other Arduino boards can also be used, although additional steps and verifications may be required by
the user. Refer to section 5 for alternative boards instructions.
3.2. What's inc uded
The following items are part of the solution:
• 1 x BitPipe™ shield
• 1 x Phillips M2 type screw (for fastening BitPipe™ to the shield)
• 1 x 6 position female header (J11)
• 2 x 8 position female header (J5 and J12)
• 1 x 10 position female header (J6)
• 5 x header jumpers
Figure 2: BitPipe™ Arduino shie d

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 5
3.3. Things you wi need
The following items are required to properly set-up a BitPipe™ shield to an Arduino board:
1. A suggested Arduino board (See section 3.1);
2. A BitPipe™ (go to www.briowireless.com for available product models);
3. A SIM card (3FF), activated with a data plan;
4. 9VDC power adaptor (refer to BitPipe™ manual for maximum current consumption), provides power
to the Arduino board and BitPipe™.
o IMPORTANT: Connector must be of positive polarity:
o Mating barrel power connector (2.1mm I.D., 5.5mm O.D.)
5. Antennas (visit www.briowireless.com to buy them);
6. If you are planning to use a small form factor Arduino (Mini Micro Nano) and do not want to solder
it to the BitPipe™ shield, you will need two 12 positions 100mils pitch female headers (not included).
3.4. E ectro-mechanica assemb y
The following steps describe how to assemble the BitPipe™ shield, BitPipe™ and Arduino board:
IMPORTANT: Industry standard electronic device and component handling methods
should be utilized to protect the hardware from damage that may be caused from electro-
static discharge (ESD) or fast-transient bursts (F B). It is recommended to utilize a properly
grounded wrist strap when handling these devices to ensure their long-term reliability.
Figure 3: BitPipe™ shie d connectors

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 6
1. The first step is to solder the Arduino shield headers on the shield itself.
If using a regular form factor Arduino board, solder the included female headers to connectors J5, J6, J11
and J12 (refer to Figure 3) on the top side of the shield (Figure 4).
Figure 4: Arduino R3 headers
2. Install four jumpers on J20. To power the Arduino board from the BitPipe™ shield, install one jumper
on J3 as well.
3. Carefully align and insert the BitPipe™ shield connectors to the target Arduino board. Do not use
excessive force as this may damage the connector(s). See Figure 5 and Figure 6.
Figure 5: Arduino M0 Pro insta ed

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 7
Figure 6: Arduino Pro Mini insta ed
4. Insert and push the SIM card into the SIM cardholder located at the front of the BitPipe™. A “click”
should be felt when it is fully inserted. The SIM cardholder is a Push-in Push-out type. See Figure 7
and Figure 8.
Figure 7: SIM insta ation
Figure 8: SIM insta ation

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 8
5. Carefully align and install the BitPipe™ to the shield BitPipe™ connector. Do not use excessive force
as this may damage the connector(s). See Figure 9 and Figure 10.
Figure 9: BitPipe™ modem connector
6. Fasten the BitPipe™ to the shield using the M2 screw.
Figure 10: BitPipe™ fastening screw
7. Connect the shield antenna(s) to the BitPipe™ UFL connector. Carefully line up the connector and
apply light pressure downwards until you feel a ‘click’ to confirm it is properly inserted. Do not force
it down as this may damage the connector or BitPipe™ device.

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved. 9
Figure 11: UFL antenna connector
3.5. Power & communication
1. By default, the BitPipe™ serial port is attached to Arduino serial port (0 & 1) through jumper J20 pins
3-4 and 5-6. This connection is the primary method of communicating commands and data from the
Arduino board to the BitPipe™.
2. If you wish to power the Arduino board from the same supply as the BitPipe™ shield, closing jumper
J3 will deliver power to the Arduino’s RAW input. When powering the Arduino board from a different
supply, inc uding a USB cab e, jumper J3 must be open.
3. Insert power supply 9V DC connector into the BitPipe™ shield and plug the power adapter into a
suitable AC mains receptacle. A green LED (D1) should turn on nearby the top left corner of the shield,
indicating power is available to the board.

BitPipe™ shield for Arduino – User Guide
www.briowireless.com Copyright © 2017 Briowireless Inc. All rights reserved.
10
4. Hardware Interconnect
The following describes the interconnect details and signals used to communicate and control a BitPipe™
via the serial interface.
4.1. BitPipe™ shie d header connectors signa assignments
The BitPipe™ shield connectors are used to provide radio control to the Arduino board.
• BitPipe™ shield pin 0 is mapped to UART-TX on the BitPipe™ and connected to the Arduino pin 0
(RX). BitPipe™ UART-TX can be disconnected from the Arduino pin 0 (RX) by removing jumper J20
5-6 to be able to update your sketch through the Arduino bootloader or use another serial port if
you have more than one port, like the Arduino Mega.
• BitPipe™ shield pin 1 is mapped to UART-RX on the BitPipe™ and connected to the Arduino pin 1
(TX). BitPipe™ UART-RX can be disconnected from the Arduino pin 1 (TX) by removing jumper J20
3-4 to be able to update your sketch through the Arduino bootloader or use another serial port if
you have more than one port, like the Arduino Mega.
• BitPipe™ shield IOREF is used as IO voltage reference for serial communication and connected
through pins 7-8 of J20. If your Arduino board does not have the R3 pinout, this pin is not available.
In that case, you will need to place a jumper between pins 1-2 of J19 if your Arduino board
operates at 3.3V or pins 2-3 of J19 if your Arduino board operates at 5V.
Arduino connector BitPipe™ shie d header
Comments
Pin(s) Signa Pin(s) Signa
RAW Raw input supply VIN DC In supply Power input from barrel connector
GND Ground GND Ground Common ground
IOREF IO reference IOREF IO Reference IO voltage reference of the Arduino
0 Serial RX 0 BitPipe™
UART-TX Arduino RX BitPipe™ TX
1 Serial TX 1 BitPipe™
UART-RX Arduino TX BitPipe™ RX
Tab e 1: BitPipe™ shie d header to Arduino header interconnect
NOTE: A other BitPipe™ shie d pins are not used.
4.2. BitPipe™ Modem mode
The BitPipe™ has 2 different operating modes: Modem mode and Autonomous mode. Hardware
strappings on the BitPipe™ shield set the BitPipe™ in Modem mode by default. In this mode, the BitPipe™
Serial API is enabled.
For more information on Serial API, visit https: briowireless.com products Module-API-SDK-
Documentation index.html.
4.3. Contro ing radio power
Radio power is controlled via the Serial API.
See examples source to know how to control radio power.