Bridge

This example for a Yn device shows how to use the Bridge

library to access the digital and analog pins on the board
through REST calls. It demonstrates how you can create your
own API when using REST style calls through the browser.
When running this example, make sure your computer is on
the same network as the Yn device. When you have have
programmed the board, you can request the value on a pin,
write a value to a pin, and configure a pin as an input or
output.
When the REST password is turned off, you can use a browser
with the following URL structure :

http://myArduinoYun.local/arduino/digital/13 :
calls digitalRead(13);

http://myArduinoYun.local/arduino/digital/13/1 :
calls digitalWrite(13,1);

http://myArduinoYun.local/arduino/analog/9/123 : analo
gWrite(9,123);

http://myArduinoYun.local/arduino/analog/2 : analogRead
(2);

http://myArduinoYun.local/arduino/mode/13/input : pinM
ode(13, INPUT);

http://myArduinoYun.local/arduino/mode/13/output : pi
nMode(13, OUTPUT);

You can use the CURL command from the command line
instead of a browser if you prefer.

Hardware Required

Yn board or shield
computer and Yn device on the same wireless or wired
network

Software Required

web browser

Circuit
There is no circuit for this example.

image developed using Fritzing. For more circuit examples, see the Fritzing
project page

Code
The example code shows how it is possible to make REST
requests to the Yn device to read from and write information
to the board's pins.
You need to include the Bridge, YunServer,
and YunClient libraries :
#include <Bridge.h>
#include <YunServer.h>
#include <YunClient.h>

[Get Code]

Instantiate a server enabling the the Yn device to listen for

connected clients.

YunServer server;

In setup(), start serial communication for debugging purposes,

and turn the built-in LED on pin 13 high while Bridge
begins. Bridge.begin() is blocking, and should take about 2
seconds to complete. Once Bridge starts up, turn the LED off.
void setup() {
Serial.begin(9600);
pinMode(13,OUTPUT);
digitalWrite(13, LOW);
Bridge.begin();
digitalWrite(13, HIGH);

[Get Code]

In the second part of setup(), tell the instance of YunServer to

listen for incoming connections only coming from localhost.
Connections made to Linux will be passed to the 32U4
processor for parsing and controlling the pins. This happens
on port 5555. Start the server with server.begin().
server.listenOnLocalhost();
server.begin();
}

[Get Code]

In loop(), you'll create an instance of the YunClient for

managing the connection. If the client connects, process the
requests in a custom function (described below) and close the
connection when finished.
Putting a delay at the end of loop() will be helpful in keeping
the processor from doing too much work.
void loop() {
YunClient client = server.accept();
if (client) {

process(client);
client.stop();
}
delay(50);
}

[Get Code]

Create a function named process that accepts the YunClient as

its argument. Read the command by creating a string to hold
the incoming information. Parse the REST commands by their
functionality (digital, analog, and mode) and pass the
information to the appropriately named function.
void process(YunClient client) {
String command = client.readStringUntil('/');
if (command == "digital") {
digitalCommand(client);
}
if (command == "analog") {
analogCommand(client);
}
if (command == "mode") {
modeCommand(client);
}
}

[Get Code]

Create a function to deal with digital commands. Accept the

client as the argument. Create some local variables to hold
the pin and value of the command.
void digitalCommand(YunClient client) {
int pin, value;

[Get Code]

Parse the client's request for the pin to work with

using client.parseInt().
If the character after the pin is a "/", it means the URL is going
to have a value of 1 or 0 following. This value will assign a

value to the pin, turning it HIGH or LOW. If there is no trailing

"/", read the value from the specified pin.
pin = client.parseInt();
if (client.read() == '/') {
value = client.parseInt();
digitalWrite(pin, value);
}
else {
value = digitalRead(pin);
}

[Get Code]

Print the value to the client and update the datastore key with
the current pin value.
By wrapping the value to the client in F(), you'll be printing
form the flash memory. This helps conserve space in SRAM,
which is useful when dealing with long strings like URLs.
The key will be the pin, and type. For example D2 will be
saved for for digital pin 2. The value will be whatever value
the pin is currently set to, or was read from the pin.
client.print(F("Pin D"));
client.print(pin);
client.print(F(" set to "));
client.println(value);
String key = "D";
key += pin;
Bridge.put(key, String(value));
}

[Get Code]

Set up a function to handle analog calls in the same fashion,

except setting the key to A instead of D when working with
the analog input pins :

void analogCommand(YunClient client) {

int pin, value;
pin = client.parseInt();
if (client.read() == '/') {
value = client.parseInt();
analogWrite(pin, value);
// Send feedback to client
client.print(F("Pin D"));
client.print(pin);
client.print(F(" set to analog "));
client.println(value);
String key = "D";
key += pin;
Bridge.put(key, String(value));
}
else {
value = analogRead(pin);
client.print(F("Pin A"));
client.print(pin);
client.print(F(" reads analog "));
client.println(value);
String key = "A";
key += pin;
Bridge.put(key, String(value));
}
}

[Get Code]

Create one more function to handle pin mode changes. Accept

the YunClient as the argument, and create a local variable to
hold the pin number. Read the pin value just as you did in the
digital and analog functions.
void modeCommand(YunClient client) {
int pin;
pin = client.parseInt();

[Get Code]

Check to make sure the URL is valid

if (client.read() != '/') {
client.println(F("error"));
return;
}

[Get Code]

If it's a valid URL, store the URL as a string. If the mode is

an input or output, configure the pin and report it to client. If
the string doesn't match those values, return an error.
String mode = client.readStringUntil('\r');
if (mode == "input") {
pinMode(pin, INPUT);
// Send feedback to client
client.print(F("Pin D"));
client.print(pin);
client.print(F(" configured as INPUT!"));
return;
}
if (mode == "output") {
pinMode(pin, OUTPUT);
// Send feedback to client
client.print(F("Pin D"));
client.print(pin);
client.print(F(" configured as OUTPUT!"));
return;
}
client.print(F("error: invalid mode "));
client.print(mode);
}

[Get Code]

The complete sketch is below :

/*
Arduino Yn Bridge example
This example for the YunShield/Yn shows how
to use the Bridge library to access the digital and
analog pins on the board through REST calls.
It demonstrates how you can create your own API when
using REST style calls through the browser.
Possible commands created in this shetch:

"/arduino/digital/13"
"/arduino/digital/13/1"
"/arduino/analog/2/123"
"/arduino/analog/2"
"/arduino/mode/13/input"
"/arduino/mode/13/output"

->
->
->
->
->
->

digitalRead(13)
digitalWrite(13, HIGH)
analogWrite(2, 123)
analogRead(2)
pinMode(13, INPUT)
pinMode(13, OUTPUT)

This example code is part of the public domain

http://www.arduino.cc/en/Tutorial/Bridge
*/
#include <Bridge.h>
#include <BridgeServer.h>
#include <BridgeClient.h>
// Listen to the default port 5555, the Yn webserver
// will forward there all the HTTP requests you send
BridgeServer server;
void setup() {
// Bridge startup
pinMode(13, OUTPUT);
digitalWrite(13, LOW);
Bridge.begin();
digitalWrite(13, HIGH);
// Listen for incoming connection only from localhost
// (no one from the external network could connect)
server.listenOnLocalhost();
server.begin();
}
void loop() {
// Get clients coming from server
BridgeClient client = server.accept();
// There is a new client?
if (client) {
// Process request
process(client);
// Close connection and free resources.
client.stop();
}
delay(50); // Poll every 50ms
}
void process(BridgeClient client) {

// read the command

String command = client.readStringUntil('/');
// is "digital" command?
if (command == "digital") {
digitalCommand(client);
}
// is "analog" command?
if (command == "analog") {
analogCommand(client);
}
// is "mode" command?
if (command == "mode") {
modeCommand(client);
}
}
void digitalCommand(BridgeClient client) {
int pin, value;
// Read pin number
pin = client.parseInt();
// If the next character is a '/' it means we have an URL
// with a value like: "/digital/13/1"
if (client.read() == '/') {
value = client.parseInt();
digitalWrite(pin, value);
} else {
value = digitalRead(pin);
}
// Send feedback to client
client.print(F("Pin D"));
client.print(pin);
client.print(F(" set to "));
client.println(value);
// Update datastore key with the current pin value
String key = "D";
key += pin;
Bridge.put(key, String(value));
}
void analogCommand(BridgeClient client) {
int pin, value;
// Read pin number
pin = client.parseInt();

// If the next character is a '/' it means we have an URL

// with a value like: "/analog/5/120"
if (client.read() == '/') {
// Read value and execute command
value = client.parseInt();
analogWrite(pin, value);
// Send feedback to client
client.print(F("Pin D"));
client.print(pin);
client.print(F(" set to analog "));
client.println(value);
// Update datastore key with the current pin value
String key = "D";
key += pin;
Bridge.put(key, String(value));
} else {
// Read analog pin
value = analogRead(pin);
// Send feedback to client
client.print(F("Pin A"));
client.print(pin);
client.print(F(" reads analog "));
client.println(value);
// Update datastore key with the current pin value
String key = "A";
key += pin;
Bridge.put(key, String(value));
}
}
void modeCommand(BridgeClient client) {
int pin;
// Read pin number
pin = client.parseInt();
// If the next character is not a '/' we have a malformed URL
if (client.read() != '/') {
client.println(F("error"));
return;
}
String mode = client.readStringUntil('\r');
if (mode == "input") {
pinMode(pin, INPUT);

// Send feedback to client

client.print(F("Pin D"));
client.print(pin);
client.print(F(" configured as INPUT!"));
return;
}
if (mode == "output") {
pinMode(pin, OUTPUT);
// Send feedback to client
client.print(F("Pin D"));
client.print(pin);
client.print(F(" configured as OUTPUT!"));
return;
}
client.print(F("error: invalid mode "));
client.print(mode);
}

[Get Code]

See Also

Bridge Library - Your reference to the Bridge Library

Console Ascii Table A complete ASCII table printed to

the Console

Console Pixel Turn an LED on and off through the

Console

Console Read - Read data coming from bridge using the

Console.read() function

Data Logger - Log data from three analog sensors to an

SD card.

File Write - How to write file into the Yn filesystem.

Http Client - A basic HTTP client that connects to the

internet and downloads content.

Http Client Console - HTTP client that connects,

downloads content and shows it using WiFi and Console.

Mailbox Read Message - How to read the messages

queue, called Mailbox, using the Bridge library.

Process - How to run linux processes using an Yn.

Remote Due Blink - How to upload remotely a sketch on

DUE boards.

Shell Commands - How to run linux shell commands

using a Yn.

Temperature Web Panel - How to serve data from an

analog input via the Yn's built-in webserver.

Time check - Gets the time from Linux via Bridge then
parses out hours, minutes and seconds.

WiFi Status - Prints information about the status of your

wifi connection.

Yn First Configuration - Easily configure your Yn device

using Serial Monitor and USB port.

Serial Terminal - Use the Yn's 32U4 processor as a serial

terminal for the Linux side on the Yn.

Last revision 2016/05/25 by SM