Differences

This shows you the differences between two versions of the page.

--- tutorials_devicehub [2016/12/16 04:48]
admin [Data Transmission]
+++ tutorials_devicehub [2017/04/01 06:50] (current)
admin [Sending Commands to the Nodes]
@@ Line 5: / Line 5: @@
 In this tutorial we will use [[https://devicehub.net/|DeviceHub]] to aggregate data from multiple Sparrow nodes and use their API to also send commands back to the nodes.
-===== DeviceHub =====
+====== DeviceHub ======
 To gain access, you will need to first create an account on the platform. After registering and logging in, select Project > New Project, and give your project a name. Initially, your project will be assigned a Project ID and an API Key, which will serve to identify it on the platform.
@@ Line 19: / Line 19: @@
  <code> > pip install devicehub </code>
-==== Data Transmission ====
+===== Data Transmission =====
 Next, we will write a small Python program to send data into our DeviceHub account. Use as a reference the code below and fill in the PROJECT_ID, DEVICE_UUID and API_KEY fields with your own values:
@@ Line 36: / Line 36: @@
 def analog_input(dev, sensor):
     value = randint(0, 1023)
-    sensor.addValue(value)
+    sensor.addValue(float(value.strip()))
     dev.send()
     print value
@@ Line 115: / Line 115: @@
 If everything goes well, you will have temperature sensor data coming in every second and printed on the screen.
+<code bash>
+pi@raspberrypi:~ $ python myserial.py
+.22
+.19
+.56
+.89
+</code>
 Now, it's only a matter of combining the two python programs above in order to send everything to DeviceHub:
@@ Line 155: / Line 162: @@
 If everything goes well, you should now be able to see live temperature data in your DeviceHub account.
+{{ ::temperature.png?800 |}}
 ===== Sending Commands to the Nodes =====
@@ Line 169: / Line 178: @@
 DEVICE_UUID     = 'your Device UUID'
 API_KEY         = 'your API KEY'
-AN_SENSOR_NAME  = 'LED' #make sure your actuator has the same name on DeviceHub!
+ACTUATOR_NAME1  = 'LED' #make sure your actuator has the same name on DeviceHub!
@@ Line 190: / Line 199: @@
 except KeyboardInterrupt:
     print 'Goodbye!'
+</code>
+{{ ::actuators.png?600 |}}
+Similarly, you can add an actuator with an Analog input to the DeviceHub interface. Let's add three of them and control the RGB LED on the Sparrow Node. Name them Red, Green and Blue and use the following code for testing:
+<code python>
+from devicehub import Sensor, Actuator, Device, Project
+from time import sleep
+import serial
+PROJECT_ID      = 'your project ID'
+DEVICE_UUID     = 'your Device UUID'
+API_KEY         = 'your API KEY'
+AN1_SENSOR_NAME  = 'Red' #make sure your actuator has the same name on DeviceHub!
+AN2_SENSOR_NAME  = 'Green' #make sure your actuator has the same name on DeviceHub!
+AN3_SENSOR_NAME  = 'Blue' #make sure your actuator has the same name on DeviceHub!
+red = "0"
+green = "0"
+blue = "0"
+def act1_callback(payload):
+    global red
+    print ACT1.state
+    red = str(ACT1.state)
+def act2_callback(payload):
+    global green
+    print ACT2.state
+    green = str(ACT2.state)
+def act3_callback(payload):
+    global blue
+    print ACT3.state
+    blue = str(ACT3.state)
+project = Project(PROJECT_ID)
+device = Device(project, DEVICE_UUID, API_KEY)
+ACT1 = Actuator(Actuator.ANALOG, AN1_SENSOR_NAME)
+ACT2 = Actuator(Actuator.ANALOG, AN2_SENSOR_NAME)
+ACT3 = Actuator(Actuator.ANALOG, AN3_SENSOR_NAME)
+device.addActuator(ACT1, act1_callback)
+device.addActuator(ACT2, act2_callback)
+device.addActuator(ACT3, act3_callback)
+# Make sure you have the correct port and baud rate selected
+# For Windows, use COMx instead of ttyUSB
+ser=serial.Serial('/dev/ttyUSB0', 9600)
+try:
+    while True:
+        ser.write(red + ',' + green + ',' + blue + '\n') #send RGB values as CSV
+        sleep(1.0)
+except KeyboardInterrupt:
+    print 'Goodbye!'
+</code>
+Now we need to write an Arduino sketch for the Sparrow node to read the CSV data from the serial port and refresh the color on the LED:
+<code C>
+// pins for the LEDs:
+const int redPin = 8;
+const int greenPin = 11;
+const int bluePin = 10;
+void setup() {
+  // initialize serial:
+  Serial.begin(9600);
+  // make the pins outputs:
+  pinMode(redPin, OUTPUT);
+  pinMode(greenPin, OUTPUT);
+  pinMode(bluePin, OUTPUT);
+}
+void loop() {
+  // if there's any serial available, read it:
+  while (Serial.available() > 0) {
+    // look for the next valid integer in the incoming serial stream:
+    int red = Serial.parseInt();
+    // do it again:
+    int green = Serial.parseInt();
+    // do it again:
+    int blue = Serial.parseInt();
+    // look for the newline. That's the end of your
+    // sentence:
+    if (Serial.read() == '\n') {
+      // constrain the values to 0 - 255 and invert
+      // if you're using a common-cathode LED, just use "constrain(color, 0, 255);"
+      red = 255 - constrain(red, 0, 255);
+      green = 255 - constrain(green, 0, 255);
+      blue = 255 - constrain(blue, 0, 255);
+      // fade the red, green, and blue legs of the LED:
+      analogWrite(redPin, red);
+      analogWrite(greenPin, green);
+      analogWrite(bluePin, blue);
+      // print the three numbers in one string as hexadecimal:
+      Serial.print(red, HEX);
+      Serial.print(green, HEX);
+      Serial.println(blue, HEX);
+    }
+  }
+}
 </code>