Facebook
Twitter
GitHub
  • Home
  • Tech Specs
  • Quick Start
  • FAQ
  • Community

Quick Start


Developing on-line with codebender web IDE

  1. Install codebender browser plugin and Arduino drivers.
  2. All libraries and sample codes are already installed in codebender web IDE.
Unboxing the AirBoard

Developing off-line with the Arduino IDE

  1. Download and install the Arduino IDE
  2. Download and unzip TheAirBoard-master.zip
  3. Place folders under TheAirBoard-master/arduino/ in your Preferences>Sketchbook location /libraries folder
  4. You may need to create the /libraries subfolder if it is your first library
  5. Restart the Arduino IDE
  6. Select Tools>Serial Port>your-serial-port
  7. Select Tools>Board>Arduino Fio

tools

Developing with Ardublock

After you installed the Arduino IDE, download and install Ardublock.

Ardublock

Your first sketch in 30 seconds with ArduBlock

Programming via BLE

ble_link_ks

BLE-Link Kickstarter Edition

Check your BLE-Link version: Kickstarter edition works as-is; DFRobot V1.1 requires a modification (see FAQ). NB A USB dongle is required for programming.

  1. Plug USB dongle into your computer.
  2. Turn on the AirBoard.
  3. Wait for the Link yellow LED on the BLE-Link shield to turn on before trying to upload your sketch.
  4. Select Tools>Serial Port>your-serial-port in the Arduino IDE.
  5. Select Tools>Board>Arduino Fio in the Arduino IDE.
  6. If necessary, check that USB BLE-Link and BLE-Link shield are configured properly as explained in this tutorial.
  • BLE-Link USB dongle AT+ROLE=? returns ROLE_CENTRAL
  • BLE-Link shield AT+ROLE =? returns ROLE_PERIPHERAL

quick_start1

quick_start2

More info:

  • Product page (shield)
  • Product page (USB dongle)
  • User Manual

Programming via XBee

xbee Explorer Dongle

  1. Get two XBee XB24-API 1mW Trace Antenna Series 1 (802.15.4) shields and one XBee Explorer Dongle.
  2. Connect DIO3 to RTS as explained in this tutorial.
  3. Install FTDI drivers for the dongle if necessary.
  4. Configure XBee shields (3 options below).
  5. Select Tools>Serial Port>your-serial-port in the Arduino IDE.

Option 1: automatic configuration

 

  • Upload ConfigShields.ino to the AirBoard using the BLE-Link shield, then swap to Slave XBee shield and power the AirBoard ON.
  • After 8 seconds, the green LED blinks once when configuration is complete.
  • Change ConfigShield.ino settings to Master, then repeat configuration with the second XBee shield.

Option 2: manual configuration

Launch Iron 1.0 for Mac or XCTU for PC and set the XBee shield to factory defaults, except:

  • BD=6 (Both: Interface Data Rate = 57600 bauds)
  • CH=F (Both: Channel = 0x0F)
  • D3= (Master: DIO3 = DI, Slave: DIO3 = DO high)
  • D7=0 (Slave: DIO7 = Disabled)
  • IA=FFFF (Slave: I/O Input Address = any received I/O packet can change outputs)
  • IC=8 (Master: DIO Change Detect = bit DIO3)

Option 3: semi-manual configuration

Launch a terminal window, type +++ and issue the following commands:

  • Master: ATRE,BD6,CHF,D33,IC8,WR,CN
  • Slave: ATRE,BD6,CHF,D35,D70,IAFFFF,WR,CN

More info:

  • Product page
  • User Manual

Programming via Bluetooth 2

bluetooth2

  1. Get one Bluetooth 2.1 shield.
  2. Pair your-device.
  3. Open a terminal and set the Bluetooth shield to factory defaults, except fields below.
  4. Select Tools>Serial Port>your-serial-port in the Arduino IDE.
  • Baudrt=57600
  • InqWindw=0012
  • PagWindw=0500
  • SniffEna=30
  • HidFlags=0
  • Profile= MDM

Note:

What is very nice about Bluetooth 2 Over-The-Air programming is that you don’t need a USB dongle. However, there are a few drawbacks:

  1. Bluetooth 2 OTAP is about 3 times slower than BLE, XBee or WiFi OTAP, i.e. about 15 seconds for a simple LED blink program
  2. Bluetooth OTAP is time sensitive and depends on your computer/OS configuration. It may failed sometimes, typically 20% of the time. When this happens, just re-launch upload.

More info:

  • Product page
  • User Manual

Programming via WiFi

wifi

  1. Get one WiFly shield.
  2. Disconnect from any wired or wireles networks.
  3. Briefly connect shield pin 9 to VDD at boot time to activate the adhoc network.
  4. Connect to the adhoc network
  5. Set the WiFly shield to factory defaults, except fields below.
  6. Compile and locate your .hex file.
  7. On Mac, edit and update this AppleScript with your .hex file path and name.
  8. Open a terminal and launch the script to upload the .hex file.
  • OPEN=
  • CLOSE=
  • REMOTE=
  • IP=169.254.1.1:2000
  • IoMask=0x21f2
  • Baudrate=57600

More info:

  • Product page
  • User Manual
01-Blink an RGB LED
02-Simple Serial Monitor echo
03-Check battery status while charging
04-Auto configure wireless shields
05-Control the built-in LED colors with your smartphone
06-Control NeoPixels with your smartphone
07-GP2Y0A02YK0F infrared proximity sensor
08-ADXL345 accelerometer
09-Simple ClickMe button with RemoteXY for Bluetooth 2/Android
10-Control a brushbot with your smartphone (BLE)
11-Control a brushbot with your smartphone and RemoteXY for Bluetooth 2/Android
12-Control an airship with the G-sensor of your smartphone and RemoteXY for Bluetooth 2/Android
13-Play with littleBits in and out
14-Control littleBits with your smartphone and RemoteXY for Bluetooth 2/Android
15-Send SMS with sensor value to GSM cell phone
16-Send email with sensor value on the internet via WiFi
17-Autonomous XBee data logger (6 months @ 1 data per minute)
18-Send sensor values to SIGFOX network
19-Send sensor values to LoRa WAN
20-Blynk
01-Blink an RGB LED

This is your first LED Blink Arduino sketch.

Turn an RGB LED on for one second, then off for one second, repeatedly.

You can adjust the LED brightness between 0 and 255.

  • GREEN = digital 5
  • BLUE = digital 6
  • RED = digital 9

02-Simple Serial Monitor echo

This simple echo Arduino sketch displays back what you type on Serial Monitor:

  • blink the green LED every second
  • display time since power ON in seconds
  • echo characters typed on Serial Monitor

03-Check battery status while charging

This Arduino sketch monitors the battery voltage, USB voltage and charge status continuously:

  • blink red/green while charging
  • solid green when charged or when discharging
  • solid red when battery low
  • print battery level indicator on Serial Monitor

04-Auto configure wireless shields

This Arduino sketch automatically configures any of XBee, Bluetooth 2 or WiFi shields:

  1. upload the program to the AirBoard via the BLE-Link shield
  2. replace the BLE-Link shield by any blank XB24-API, RN42XVP or RN-XV shield
  3. power the AirBoard and run the program once to setup the working configuration
  4. after 8 seconds, the green LED blinks once when configuration is complete.

Our preferred configurations are:

xbee

Set XB24-API XBee to factory defaults, except:

  • BD=6 (Both: Interface Data Rate = 57600 bauds)
  • CH=F (Both: Channel = 0x0F)
  • D3= (Master: DIO3 = DI, Slave: DIO3 = DO high)
  • D7=0 (Slave: DIO7 = Disabled)
  • IA=FFFF (Slave: I/O Input Address = any received I/O packet can change outputs)
  • IC=8 (Master: DIO Change Detect = bit DIO3)

bluetooth2

Set RN42XVP Bluetooth2 to factory defaults, except:

  • Baudrt=9600 (57600 for Over-The-Air Programming)
  • InqWindw=0012
  • PagWindw=0500
  • SniffEna=30
  • HidFlags=0
  • Profile= MDM
wifi

Set RN-XV RN171 WiFly to factory defaults, except:

  • OPEN=
  • CLOSE=
  • REMOTE=
  • IP=169.254.1.1:2000
  • IoMask=0x21f2
  • Baudrate=9600 (57600 for Over-The-Air Programming)
05-Control the built-in LED colors with your smartphone

This Arduino sketch controls 7 colors of the built-in RGB LED at full power from a smartphone. Android sources can be found on github.

What will you make with just an LED?

On Bluetooth 4.0 BLE Android devices

  1. Get one BLE-Link shield
  2. Install tAB-COLOR.apk
  3. Search and connect « Bluno » device

ble_link_ks

Color

On Bluetooth 2 Android devices

  1. Get one RN42XVP Bluetooth 2.1 shield
  2. Configure the shield @9600 bauds (see Auto configure wireless shield)
  3. Install tAB-Colorbuttons.apk
  4. Search and connect your device

bluetooth2

ColorButtons

06-Control NeoPixels with your smartphone

Same as above, but this  Arduino sketch controls 7 full power colors of 40 NeoPixels daisy chained in 2 concentric rings:

  • NeoPixel Ring – 24 x WS2812 5050 RGB LED with Integrated Drivers
  • NeoPixel Ring – 16 x WS2812 5050 RGB LED with Integrated Drivers

Note:

Be sure to use a powerful power supply (for example Li-ion battery). 40 white NeoPixels will draw up to 2.4A (20mA per segment = 60mA per white pixel).

1586-01
1463-03
What artists do with the AirBoard and NeoPixels
Control NeoPixels from your smartphone
07-GP2Y0A02YK0F infrared proximity sensor
proximity

This Arduino sketch repeatedly read the proximity sensor value from analog pin A4 and switch the LED red when distance is under 50 cm.

  1. order and populate the Proximity sensor PCB
  2. choose between 3V3 or 5V source to power the sensor: connect VCC to 5V if USB is plugged in, to 3V3 otherwise
  • schematics.pdf
  • Arduino sketch
top

Proximity sensor PCB top

bottom

Proximity sensor PCB bottom

Use the 360° USB adapter to continuously power this active proximity sensor
Detect presence, monitor distances and build your home automation system
08-ADXL345 accelerometer
ADXL2AirBoard

This Arduino sketch repeatedly read the 3-axis accelerations in g. Look for triggered actions: inactivity, activity, single tap, double tap and free fall.

  1. plug the ADXL345 breakout board
  2. power OFF and ON The AirBoard to initialize the I2C driver
  • SDA …. A4
  • SCL ….. A5
  • CS ……. D10~
  • VCC …. D11~
  • GND … D12
ADXL345 accelerometer test with remoteXY
09-Simple ClickMe button with RemoteXY for Bluetooth 2/Android
RemoteXY for Bluetooth 2/Android is a Graphical User Interface (GUI) generator to build your own mobile interface. The idea behind it is that this is the Arduino program which tells the GUI how to display and behave. This Arduino sketch is a very simple ClickMe button which switches ON and OFF the green LED.

  1. upload this program to the AirBoard via the BLE-Link shield
  2. replace the BLE-Link shield by the RN-42 Bluetooth 2 shield
  3. launch RemoteXY for Bluetooth 2/Android
  4. power on the AirBoard
  5. search and connect to the RN42 device ID written on the module

What you need:

  • Bluetooth2 module
  • RemoteXY for Bluetooth 2/Android
  • Arduino sketch
bluetooth2
RemoteXY
A simple ClickMe button for RemoteXY
ClickMe_smartphone
10-Control a brushbot with your smartphone (BLE)
brushbot

This Arduino sketch uses left/arrow keys to control a miniature brushbot made of toothbrush heads and vibrating pager motors.

  1. order and populate the dual motor drive PCB
  2. add 2 pager vibrating motors
  3. install tAB-Direction.apk on your Bluetooth 4.0 BLE Android device
  4. search and connect « Bluno » device

Vibrating motor specifications:

  • Dimension: 10mm diameter, 2.7mm thick
  • Voltage: 2V – 5V
  • 5V current draw: 100mA, 4V current draw: 80mA, 3V current draw: 60mA, 2V current draw: 40mA
  • 11000 RPM at 5V
  • Weight: 0.9 gram

Note:

When operating simultaneously, some vibrating motors may exceed the built-in regulator current (200mA). If this happens, simply reduce the PWM ratio in the following instructions: analogWrite(LEFT, 255); analogWrite(RIGHT, 255); Another option would be to make a hardware hack and drive the breakout board mosfets directly from the built-in battery.

  • schematics.pdf
  • Arduino sketch
top

Dual motor drive PCB top

bottom

Dual motor drive PCB bottom

 

 

 

 

 

 

Play with tiny remote controlled brushbots
motors
Direction
11-Control a brushbot with your smartphone and RemoteXY for Bluetooth 2/Android
brushbot

Same as above, but this Arduino sketch uses RemoteXY and Bluetooth 2. RemoteXY for Bluetooth 2/Android is a Graphical User Interface (GUI) generator to build your own mobile interface. The idea behind it is that this is the Arduino program which tells the GUI how to display and behave.

What you need:

  • populated dual motor drive PCB
  • pager vibrating motor x2
  • Bluetooth2 module
  • RemoteXY for Bluetooth 2/Android
  • Arduino sketch
1201-01
motors
bluetooth2
RemoteXY
Make a tiny remote controlled brushbots from vibrating motor discs
brushbot
brushbot_smartphone
12-Control an airship with the G-sensor of your smartphone and RemoteXY for Bluetooth 2/Android
G-sensor

RemoteXY for Bluetooth 2/Android is a Graphical User Interface (GUI) generator to build your own mobile interface. The idea behind it is that this is the Arduino program which tells the GUI how to display and behave. It features an innovative G-sensor widget which senses your smartphone’s motion. This Arduino sketch is a dual-channel proportional control for robotic motors, triggered by the internal smartphone’s G-sensor. Given the low current of the micro motors below, you can directly connect them the AirBoard pins 10, 11 and GND.

What you need:

  • TPM2 motors x2
  • Picooz tail propellers x2
  • Bluetooth2 module
  • RemoteXY for Bluetooth 2/Android
  • Arduino sketch
tpm2
propeller
moteurs
bluetooth2
RemoteXY
Motors specs

  • body: D4x12.5mm
  • axle: D0.66x4mm
  • weight: 0.7g
  • speed: 20300 rpm @3V
  • power consumption (no load): 17.6mA @3V

Note:
To control an airship in 3D, you normally would want 3 motors for XYZ. But this adds weight and using gravity as Z-force is a great way to teach physics and buoyancy. You need to make a perfect balance, so that the airship naturally lifts up as motors increase speed and slowly returns to earth otherwise.

airship
13-Play with littleBits in and out
sketchBit

Combine the flexibility of the AirBoard broad range of wireless shields and the diversity of littleBits to make your own devices, robots, etc… littleBits is a library of electronic modules. The sketchBit is a single-input/single-output bit adapter that allows you to control your littleBits modules from the AirBoard. It also features a micro switch to select digital vs analog output for advanced functionalities.

This Arduino sketch directly copies the input bit to the output bit in a transparent mode.

WARNING! DO NOT CONNECT THE AIRBOARD MICRO USB CONNECTOR AND THE POWER BIT AT THE SAME TIME.

warning

Note:
This board was produced as a limited edition for Kickstarter and is not currently available for sale.

What you need:

  • 9V battery gives some juice to littleBits and the AirBoard
  • power bit powers littleBits’ 5V and AirBoard’s 5VUSB (simultaneously recharge the built-in battery)
  • dimmer goes to The AirBoard analog input pin A5
  • bargraph is driven by The AirBoard digital output pin 10
  • sketchBit connects the AirBoard to littleBits

Battery_Cable_(1)
power
dimmer
bargraph
sketchBit
14-Control littleBits with your smartphone and RemoteXY for Bluetooth 2/Android
littleBits_box
littlebits_play
sketchBit_top
sketchBit_bottom
littleBits_Neopixels

Combine the flexibility of the AirBoard broad range of wireless shields, the ease of RemoteXY drag-n’drop programming and the diversity of littleBits to make your own devices, robots, etc… littleBits is a library of electronic modules. The sketchBit is a single-input/single-output bit adapter that allows you to control your littleBits modules from the AirBoard. It also features a micro switch to select digital vs analog output for advanced functionalities. RemoteXY for Bluetooth 2/Android is a Graphical User Interface (GUI) generator to build your own mobile interface. The idea behind it is that this is the Arduino program which tells the GUI how to display and behave.

This Arduino sketch sends the input bit to a bargraph on your smartphone and a slider on your smartphone drives the output bit.

WARNING! DO NOT CONNECT THE AIRBOARD MICRO USB CONNECTOR AND THE POWER BIT AT THE SAME TIME.

warning

Note:
This board was produced as a limited edition for Kickstarter and is not currently available for sale.
Control your littleBits with your smartphone

What you need:

  • 9V battery gives some juice to littleBits and the AirBoard
  • power bit powers littleBits’ 5V and AirBoard’s 5VUSB (simultaneously recharge the built-in battery)
  • dimmer goes to The AirBoard analog input pin A5
  • bargraph is driven by The AirBoard digital output pin 10
  • sketchBit connects the AirBoard to littleBits
  • Bluetooth2 module connects the AirBoard to RemoteXY (Bluetooth2 only)
  • RemoteXY for Bluetooth 2/Android allows building your own mobile app

Battery_Cable_(1)
power
dimmer
bargraph
sketchBit
bluetooth2
RemoteXY
15-Send SMS with sensor value to GSM cell phone
GPRSbee

This Arduino sketch is a GSM data logger based on the SODAQ GPRSbee SIM800H shield.

It repeatedly reads light sensor data and sends an SMS with the measured value every minute.

  1. plug the light sensor between the A4 and GND pins
  2. check SJ1 and SJ2 connections on the back of the GPRSbee shield. SJ1: « ON » should be connected to « PIN 4″, SJ2: see below
  3. insert a mini SIM card into the GPRSbee slot
  4. connect the antenna
  5. place the device within a GSM network coverage area

The GPRSbee can be powered by The AirBoard internal battery or by an external battery.

  • the battery signal is the 11th header pin close to SJ2
  • SJ2: short for internal AirBoard battery, open for external battery

WARNING! DO NOT CONNECT AN EXTERNAL BATTERY TO THE GPRSBEE IF SJ2 IS SHORTENED.

warning_GPRSbee

Note:

On the AirBoard Kickstarter Edition, J2 and J3 are 11-pin connectors which incorporate B+/B- pads to allow direct power of GPRSbee. The new J2/J3 connectors are now 10-pins (also 2mm thinner) to avoid possible confusion when inserting wireless shields. GPRSbee can still be powered by B+ with your own connection.

More info:

  • Product page
  • User Manual
LDR
Just a 200k LDR to plug between A4 and GND
16-Send email with sensor value on the internet via WiFi
wifi

This Arduino sketch is a WiFi data logger based on the WiFly RN-XV (RN171) WiFi shield:

It repeatedly reads light sensor data every minute and pushes a motification to PushingBox which sends an email with the measured value.

  1. plug the light sensor between the A4 and GND pins
  2. place the device within a WiFi network coverage area
  3. set WiFly baudrate to default 9600
  4. set client mode: do not connect GPIO9 to VDD upon power up
  5. configure your WiFi SSID and password
  6. add an e-mail service on PushingBox and a scenario with $var$ in the message body

Note:

On the production units, J2 and J3 connectors are 2mm thinner than the Kickstarter Edition’s. This has a number of advantages, for example compacity and the ability of the board to hold its own balance when standing on the J1 connector (this was a bit problematic with SIGFOX modules for instance). The drawback is that the WiFly shield now does not fully insert into the AirBoard’s female connectors. This is not ideal, however this does work for prototyping and also other popular WiFi shields (e.g. the cheaper ESP8266) will fit nicely.

More info:

  • Product page
  • User Manual

PushingBox is a service which can send e-mails triggered by a device.

  1. connect to PushingBox with your Google account
  2. add an e-mail service with your e-mail address
  3. add a scenario
  4. add an action with send e-mail service for your scenario ($var$ is a variable (e.g. your sensor value) that you can pass in the e-mail body)

0e54e-add_a_service
09191-add_a_scenario
0ddcb-add_an_action
17-Autonomous XBee data logger (6 months @ 1 data per minute)
xbee

With the AirBoard and XBee shield, send your data periodically every minute for 6 full months on its tiny 155mAh battery. Yes, we can! With this ultra low-power logger Arduino sketch, send light sensor values every minute, using power down feature in between and watchdog as the real-time clock (RTC) timer.

  1. configure MASTER and SLAVE XBee shields at 57,600 bauds, using the ConfigShields Arduino sketch
  2. turn on the micro switch just before uploading to make sure the wireless module power is on (5 seconds timeout after boot)
  3. plug the light sensor between the A4 and GND pins
  4. repeatedly read the light sensor from analog pin A4
  5. send the raw data every minute
  6. power down between transmit (56-second watchdog timeout for wakeup)
Note:
You cannot brick the AirBoard! However, when playing with the power down feature you may put the AirBoard in a mode where it cannot recover for further programming. This is why it is STRONGLY suggested that you keep the 5-second boot timeout in the setup function to allow wireless programming right after boot (and before a possible mis-goto sleep). In case you really mis-activated this mode at boot time, it’s always possible to get back to normal by powering the wireless shield separately.

Ultra Low-Power performance

  • over 6 months estimated autonomy from the 155 mAh built-in battery @ 1 data transmit per minute
  • de-activate watchdog timer and communication to enter the lowest possible power-down current and reach over 2 years of autonomy
  • compute your own performance from our sample spreadsheet

Power budget

Power budget in µA

300nA

Design hardware wakeup for longest autonomy in power-down mode

Low power beta tests at Green Fablab Barcelona
18-Send sensor values to SIGFOX network
SIGFOX

This SIGFOX logger Arduino sketch is based on the Telecom Design TD1207/1208 module operating in the 868MHz European frequency band.

  • Check the SIGFOX website for deployment and certification status in other parts of the world.
  • Network coverage and operators are detailed here.
  • To activate your SIGFOX account, connect to the subscription backend and enter your ID and PAC numbers.
  • Contact subscribe@sigfox.com or nicolas.lesconnec@sigfox.com for any further questions.

The module has been updated to the latest bidirectional firmware (SOFT1451):

  • Uplink: maximum 140 messages per day
  • Downlink: maximum 2 messages per day

To get started with this Arduino sketch:

  1. plug the light sensor between the A4 and GND pins
  2. repeatedly read the light sensor from analog pin A4
  3. send the value to the SIGFOX network every 10 minutes
  4. get your messages on the SIGFOX backend

 

Note:

  • This shield has an ESD protection diode built-in to protect the antenna for outdoor use. It was produced as a limited edition for Kickstarter, has passed SIGFOX certification and is now pending for distributors.

More info:

  • Product page
  • User Manual
SIGFOXbee1
SIGFOXbee2
Note:

  • The AirBoard was also successfuly tested with SigBee shield by ATIM. You can start from this Arduino sketch.
SigBee1
SigBee2
peuf_neige
Deploy your sensors out in the field

Order early samples here

includes:

  • SIGFOX shield for the AirBoard (Radio Configuration Zone (RCZ) 1: Europe, Iran, Oman, South Africa)
  • 61mm Quad-Band antenna (straight or right-angle)
  • 1 year SIGFOX subscription (140 downlink + 2 uplink messages per day) – after one year, directly renew subscription at the SIGFOX’s portal.

Model type
61mm mini Quad-Band antenna

Several SMA antennae are compatible with this shield:

  • 61mm, Mini GSM/Cellular Quad-Band Antenna – 2dBi SMA Plug
  • 61mm, Right-angle Mini GSM/Cellular Quad-Band Antenna – 2dBi SMA Plug
  • 168mm, ANTENNA 900MHZ HG R-SMA BLK 6.6″ (bigger, but better performance)

2.4ant
90°antenna
6.6ant
19-Send sensor values to LoRa WAN
LoRa

This LoRa logger Arduino sketch sends a message to a LoRa network every 10 seconds via the Multitech MultiConnect® mDot™ LoRaWAN™ module, distributed in Europe by Dataprint.

Lora1
Lora2
balloon
20-Blynk

Here are the steps to use Blynk’s GUI IDE with the AirBoard.

  1. connect your smartphone to your WiFi network, plug the BLE-Link shield to your AirBoard and the USB BLE-Link dongle to your computer
  2. type your Auth Token and upload this Arduino sketch to the AirBoard (same as Blynk’s Arduino_Serial_USB.ino sample code)
  3. drag and drop a D5 button to control the green LED (pin 5)
  4. open a terminal window and launch socat: ./blynk-ser.sh -c your_serial_port -b 9600
  5. enter your serial port when prompted: Select serial port [ ]: your_serial_port

first_project
Subscribe to our newsletter:
Facebook
Twitter
GitHub
  • sales
  • forum
© 2015 AirThings Inc.