Sample program showing how to connect GR-PEACH into Watson IoT through mbed Connector and Watson's Connector Bridge

Dependencies:   AsciiFont DisplayApp GR-PEACH_video LCD_shield_config LWIPBP3595Interface_STA_for_mbed-os USBDevice

Overview

This sample program shows how to connect GR-PEACH into Watson IoT through mbed Connector and Watson's Connector Bridge. Note that this program is derived from https://github.com/ARMmbed/mbed-ethernet-sample-techcon2016.

In this program, at first, the barcode data input from camera is decoded on GR-PEACH using ZXing which is an open-source, multi-format 1D/2D barcode image processing library. Then, the decoded string is sent to Watson IoT via mbed Device Connector and Watson's Connector Bridge. At last, the delivered string is confirmed via NodeRED flow.

Required hardware

Application setup

  1. Select the connection type. For details, please refer to the following wiki:
    https://developer.mbed.org/teams/Renesas/code/mbed-os_Watson-IoT_ZXing_sample/wiki/Connection-type.
  2. Set the client credentials. For details, please refer to the following wiki:
    https://developer.mbed.org/teams/Renesas/code/mbed-os_Watson-IoT_ZXing_sample/wiki/Client-credentials.
  3. Change Ethernet settings. For details, please refer to the following wiki:
    https://developer.mbed.org/teams/Renesas/code/mbed-os_Watson-IoT_ZXing_sample/wiki/Ethernet-settings.
  4. Change Wifi settings. For details, please refer to the following wiki:
    https://developer.mbed.org/teams/Renesas/code/mbed-os_Watson-IoT_ZXing_sample/wiki/Wifi-settings.

Building this sample program

  1. Import this sample program onto mbed Compiler.
  2. Configure this sample program in accordance with Application setup.
  3. Compile the example on mbed Compiler and download the resultant binary file.
  4. Plug the Ethernet cable into GR-PEACH if you are using Ethernet mode. /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen7.png
  5. Plug the micro-USB cable into the OpenSDA port with lies on the next to the RESET button.
  6. Copy the binary previously downloaded to your PC to GR-PEACH to flash this sample program. When the copy is successfully completed, the board is ready to work.
  7. Press the RESET button on the board to run this sample program.
  8. For verification, please refer to the following wiki:
    https://developer.mbed.org/teams/Renesas/code/mbed-os_Watson-IoT_ZXing_sample/wiki/Monitoring-the-application.

Application resources

This sample program exposes two resources listed below:

  1. /311/0/5850 : Trigger to toggle LED on GR-PEACH (PUT). When "1" is sent to this resource by PUT method, LED should be turned off. Otherwise, LED should be turned on.
  2. /888/0/7700: Decode result of barcode data input from camera (GET)

Setup of Watson IoT

  1. You should create Watson IoT Instance by the following procedure:
    • Login IBM Bluemix from https://console.ng.bluemix.net/ and login it.
    • Select Services as follows: /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen6.png
    • Select Internet of Things" as follows: /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen7_1.png
    • Press Get Started as follows: /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen8.png
    • Configure Watson IoT Instance
      • Leave unbound /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen9.png
      • Select the Free plan, then click Create /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen10.png

  2. You should create Watson IoT Application Credentials Once you successfully create Watson IoT Instance, you should see the following Watson IoT dashboard: /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen11.png
    • On dashboard, launch the Connect your devices dashboard /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen12.png
    • Click APPS /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen13.png
    • Click Generate API Key /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen14_1.png
    • Record the API Key and Authenticatoin Token. Then click Generate after adding a comment /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen15.png Note that these two values will be needed in the later step.
  3. Watson IoT NodeRED Application should be created in accordance with the following procedure:
    • Go back to your Bluemix Dashboard: https://console.ng.bluemix.net
    • Click Create Application /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen16.png
    • Select Node-RED Starter /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen17.png
    • Enter a unique App name and Click Create /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen18.png
    • Application will Stage after a few minutes
    • Application will report app is running when the staging has completed
  4. Watson NodeRED Application should be binded to Watson IoT instance
    • You can now see the dashboard below: /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen19.png
    • Click Connections. Then, press Connect Existing /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen20.png
    • Click on Watson IoT Instance badge. Then, press Connect /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen21.png
    • NodeRED application will restage. This will take a while. Please wait for Your app is running state /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen22.png /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen23.png
  5. You should acquire mbed Device Connector DOMAIN value
    • Go to the mbed Device Connector Dashboard: https://connector.mbed.com and log in /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen41.png
    • Select Access Key in order to create a new token /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen42.png
    • Click CREATE NEW ACCESS KEY and enter a unique name. Then, push ADD bution /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen43.png
    • an API token is generated. Need to save the generated string for later steps /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen44.png
  1. You should configure Watson IoT ARM mbed Connector Bridge
    • Go back to the Watson IoT Dashboard and select Extensions /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen24.png
    • Press Add Extension /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen25.png
    • Add ARM mbed Connector /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen26_1.png
    • Setup the bridge /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen27.png
    • Enter your Connector API Token to Access Key and MBED_DOMAIN to Domain Id, respectively. Then, click Check Connection /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen28.png
    • If the connection is successfully established, you can see Connection Established. Then, press Done /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen29.png
  2. NodeRED Flow Example should be imported
    • Open NODEFLOW_GR-PEACH.txt
    • Navigate to the URL that you recorded earlier for your Watson IoT NodeRED Application (i.e. http://<app name>.mybluemix.net) and Select Go to your NodeRED flow editor /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen30.png
    • Select menu, Import and Clipboard /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen31.png
    • Paste the entire contents of JSON code described in NODEFLOW_GR-PEACH.txt and click Import /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen32.png
  3. Watson IoT Application Node Flow should be configured
    • Double-click input node and link them to your Watson IoT instance. /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen33.png
    • Click on the edit button /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen34.png
    • First enter arbitrary name. Then, Watson API Key and Watson Auth Token previously acquired. Finally, press Add to save /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen35.png
    • Enter MBED_ENDPOINT_NAME in security.h as Device ID. Then, press Done to save /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen36.png
    • Double-click output node /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen37.png
    • Edit API Key and Device Id in the same manner as that for input node
    • Click LED OFF and LED ON node and replace MBED_ENDPOINT_NAME_GOES_HERE with MBED_ENDPOINT_NAME as shown below: /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen38.png
    • Click Deproy to deploy NodeRED application /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen39.png
  4. Invoke sample program
    • Press the reset button on GR-PEACH
    • The decode result of barcode data should be shown in debug window /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen40_1.png
    • Also, you can toggle LED by clicking Turn LED OFF and Turn LED ON injection node /media/uploads/HinoNaka/mbed-os_watson-iot_zxing_sample_screen40_2.png
Committer:
Osamu Nakamura
Date:
Thu Nov 24 13:59:16 2016 +0900
Revision:
0:ad834d403a8c
Initial Commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Osamu Nakamura 0:ad834d403a8c 1 // -*- mode:c++; tab-width:2; indent-tabs-mode:nil; c-basic-offset:2 -*-
Osamu Nakamura 0:ad834d403a8c 2 #ifndef __ARRAY_H__
Osamu Nakamura 0:ad834d403a8c 3 #define __ARRAY_H__
Osamu Nakamura 0:ad834d403a8c 4
Osamu Nakamura 0:ad834d403a8c 5 /*
Osamu Nakamura 0:ad834d403a8c 6 * Array.h
Osamu Nakamura 0:ad834d403a8c 7 * zxing
Osamu Nakamura 0:ad834d403a8c 8 *
Osamu Nakamura 0:ad834d403a8c 9 * Copyright 2010 ZXing authors All rights reserved.
Osamu Nakamura 0:ad834d403a8c 10 *
Osamu Nakamura 0:ad834d403a8c 11 * Licensed under the Apache License, Version 2.0 (the "License");
Osamu Nakamura 0:ad834d403a8c 12 * you may not use this file except in compliance with the License.
Osamu Nakamura 0:ad834d403a8c 13 * You may obtain a copy of the License at
Osamu Nakamura 0:ad834d403a8c 14 *
Osamu Nakamura 0:ad834d403a8c 15 * http://www.apache.org/licenses/LICENSE-2.0
Osamu Nakamura 0:ad834d403a8c 16 *
Osamu Nakamura 0:ad834d403a8c 17 * Unless required by applicable law or agreed to in writing, software
Osamu Nakamura 0:ad834d403a8c 18 * distributed under the License is distributed on an "AS IS" BASIS,
Osamu Nakamura 0:ad834d403a8c 19 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Osamu Nakamura 0:ad834d403a8c 20 * See the License for the specific language governing permissions and
Osamu Nakamura 0:ad834d403a8c 21 * limitations under the License.
Osamu Nakamura 0:ad834d403a8c 22 */
Osamu Nakamura 0:ad834d403a8c 23
Osamu Nakamura 0:ad834d403a8c 24 #include <vector>
Osamu Nakamura 0:ad834d403a8c 25
Osamu Nakamura 0:ad834d403a8c 26 #include <zxing/common/Counted.h>
Osamu Nakamura 0:ad834d403a8c 27
Osamu Nakamura 0:ad834d403a8c 28 namespace zxing {
Osamu Nakamura 0:ad834d403a8c 29
Osamu Nakamura 0:ad834d403a8c 30 template<typename T> class Array : public Counted {
Osamu Nakamura 0:ad834d403a8c 31 protected:
Osamu Nakamura 0:ad834d403a8c 32 public:
Osamu Nakamura 0:ad834d403a8c 33 std::vector<T> values_;
Osamu Nakamura 0:ad834d403a8c 34 Array() {}
Osamu Nakamura 0:ad834d403a8c 35 Array(int n) :
Osamu Nakamura 0:ad834d403a8c 36 Counted(), values_(n, T()) {
Osamu Nakamura 0:ad834d403a8c 37 }
Osamu Nakamura 0:ad834d403a8c 38 Array(T const* ts, int n) :
Osamu Nakamura 0:ad834d403a8c 39 Counted(), values_(ts, ts+n) {
Osamu Nakamura 0:ad834d403a8c 40 }
Osamu Nakamura 0:ad834d403a8c 41 Array(T const* ts, T const* te) :
Osamu Nakamura 0:ad834d403a8c 42 Counted(), values_(ts, te) {
Osamu Nakamura 0:ad834d403a8c 43 }
Osamu Nakamura 0:ad834d403a8c 44 Array(T v, int n) :
Osamu Nakamura 0:ad834d403a8c 45 Counted(), values_(n, v) {
Osamu Nakamura 0:ad834d403a8c 46 }
Osamu Nakamura 0:ad834d403a8c 47 Array(std::vector<T> &v) :
Osamu Nakamura 0:ad834d403a8c 48 Counted(), values_(v) {
Osamu Nakamura 0:ad834d403a8c 49 }
Osamu Nakamura 0:ad834d403a8c 50 Array(Array<T> &other) :
Osamu Nakamura 0:ad834d403a8c 51 Counted(), values_(other.values_) {
Osamu Nakamura 0:ad834d403a8c 52 }
Osamu Nakamura 0:ad834d403a8c 53 Array(Array<T> *other) :
Osamu Nakamura 0:ad834d403a8c 54 Counted(), values_(other->values_) {
Osamu Nakamura 0:ad834d403a8c 55 }
Osamu Nakamura 0:ad834d403a8c 56 virtual ~Array() {
Osamu Nakamura 0:ad834d403a8c 57 }
Osamu Nakamura 0:ad834d403a8c 58 Array<T>& operator=(const Array<T> &other) {
Osamu Nakamura 0:ad834d403a8c 59 values_ = other.values_;
Osamu Nakamura 0:ad834d403a8c 60 return *this;
Osamu Nakamura 0:ad834d403a8c 61 }
Osamu Nakamura 0:ad834d403a8c 62 Array<T>& operator=(const std::vector<T> &array) {
Osamu Nakamura 0:ad834d403a8c 63 values_ = array;
Osamu Nakamura 0:ad834d403a8c 64 return *this;
Osamu Nakamura 0:ad834d403a8c 65 }
Osamu Nakamura 0:ad834d403a8c 66 T const& operator[](int i) const {
Osamu Nakamura 0:ad834d403a8c 67 return values_[i];
Osamu Nakamura 0:ad834d403a8c 68 }
Osamu Nakamura 0:ad834d403a8c 69 T& operator[](int i) {
Osamu Nakamura 0:ad834d403a8c 70 return values_[i];
Osamu Nakamura 0:ad834d403a8c 71 }
Osamu Nakamura 0:ad834d403a8c 72 int size() const {
Osamu Nakamura 0:ad834d403a8c 73 return values_.size();
Osamu Nakamura 0:ad834d403a8c 74 }
Osamu Nakamura 0:ad834d403a8c 75 bool empty() const {
Osamu Nakamura 0:ad834d403a8c 76 return values_.size() == 0;
Osamu Nakamura 0:ad834d403a8c 77 }
Osamu Nakamura 0:ad834d403a8c 78 std::vector<T> const& values() const {
Osamu Nakamura 0:ad834d403a8c 79 return values_;
Osamu Nakamura 0:ad834d403a8c 80 }
Osamu Nakamura 0:ad834d403a8c 81 std::vector<T>& values() {
Osamu Nakamura 0:ad834d403a8c 82 return values_;
Osamu Nakamura 0:ad834d403a8c 83 }
Osamu Nakamura 0:ad834d403a8c 84 };
Osamu Nakamura 0:ad834d403a8c 85
Osamu Nakamura 0:ad834d403a8c 86 template<typename T> class ArrayRef : public Counted {
Osamu Nakamura 0:ad834d403a8c 87 private:
Osamu Nakamura 0:ad834d403a8c 88 public:
Osamu Nakamura 0:ad834d403a8c 89 Array<T> *array_;
Osamu Nakamura 0:ad834d403a8c 90 ArrayRef() :
Osamu Nakamura 0:ad834d403a8c 91 array_(0) {
Osamu Nakamura 0:ad834d403a8c 92 }
Osamu Nakamura 0:ad834d403a8c 93 explicit ArrayRef(int n) :
Osamu Nakamura 0:ad834d403a8c 94 array_(0) {
Osamu Nakamura 0:ad834d403a8c 95 reset(new Array<T> (n));
Osamu Nakamura 0:ad834d403a8c 96 }
Osamu Nakamura 0:ad834d403a8c 97 ArrayRef(T *ts, int n) :
Osamu Nakamura 0:ad834d403a8c 98 array_(0) {
Osamu Nakamura 0:ad834d403a8c 99 reset(new Array<T> (ts, n));
Osamu Nakamura 0:ad834d403a8c 100 }
Osamu Nakamura 0:ad834d403a8c 101 ArrayRef(Array<T> *a) :
Osamu Nakamura 0:ad834d403a8c 102 array_(0) {
Osamu Nakamura 0:ad834d403a8c 103 reset(a);
Osamu Nakamura 0:ad834d403a8c 104 }
Osamu Nakamura 0:ad834d403a8c 105 ArrayRef(const ArrayRef &other) :
Osamu Nakamura 0:ad834d403a8c 106 Counted(), array_(0) {
Osamu Nakamura 0:ad834d403a8c 107 reset(other.array_);
Osamu Nakamura 0:ad834d403a8c 108 }
Osamu Nakamura 0:ad834d403a8c 109
Osamu Nakamura 0:ad834d403a8c 110 template<class Y>
Osamu Nakamura 0:ad834d403a8c 111 ArrayRef(const ArrayRef<Y> &other) :
Osamu Nakamura 0:ad834d403a8c 112 array_(0) {
Osamu Nakamura 0:ad834d403a8c 113 reset(static_cast<const Array<T> *>(other.array_));
Osamu Nakamura 0:ad834d403a8c 114 }
Osamu Nakamura 0:ad834d403a8c 115
Osamu Nakamura 0:ad834d403a8c 116 ~ArrayRef() {
Osamu Nakamura 0:ad834d403a8c 117 if (array_) {
Osamu Nakamura 0:ad834d403a8c 118 array_->release();
Osamu Nakamura 0:ad834d403a8c 119 }
Osamu Nakamura 0:ad834d403a8c 120 array_ = 0;
Osamu Nakamura 0:ad834d403a8c 121 }
Osamu Nakamura 0:ad834d403a8c 122
Osamu Nakamura 0:ad834d403a8c 123 T const& operator[](int i) const {
Osamu Nakamura 0:ad834d403a8c 124 return (*array_)[i];
Osamu Nakamura 0:ad834d403a8c 125 }
Osamu Nakamura 0:ad834d403a8c 126
Osamu Nakamura 0:ad834d403a8c 127 T& operator[](int i) {
Osamu Nakamura 0:ad834d403a8c 128 return (*array_)[i];
Osamu Nakamura 0:ad834d403a8c 129 }
Osamu Nakamura 0:ad834d403a8c 130
Osamu Nakamura 0:ad834d403a8c 131 void reset(Array<T> *a) {
Osamu Nakamura 0:ad834d403a8c 132 if (a) {
Osamu Nakamura 0:ad834d403a8c 133 a->retain();
Osamu Nakamura 0:ad834d403a8c 134 }
Osamu Nakamura 0:ad834d403a8c 135 if (array_) {
Osamu Nakamura 0:ad834d403a8c 136 array_->release();
Osamu Nakamura 0:ad834d403a8c 137 }
Osamu Nakamura 0:ad834d403a8c 138 array_ = a;
Osamu Nakamura 0:ad834d403a8c 139 }
Osamu Nakamura 0:ad834d403a8c 140 void reset(const ArrayRef<T> &other) {
Osamu Nakamura 0:ad834d403a8c 141 reset(other.array_);
Osamu Nakamura 0:ad834d403a8c 142 }
Osamu Nakamura 0:ad834d403a8c 143 ArrayRef<T>& operator=(const ArrayRef<T> &other) {
Osamu Nakamura 0:ad834d403a8c 144 reset(other);
Osamu Nakamura 0:ad834d403a8c 145 return *this;
Osamu Nakamura 0:ad834d403a8c 146 }
Osamu Nakamura 0:ad834d403a8c 147 ArrayRef<T>& operator=(Array<T> *a) {
Osamu Nakamura 0:ad834d403a8c 148 reset(a);
Osamu Nakamura 0:ad834d403a8c 149 return *this;
Osamu Nakamura 0:ad834d403a8c 150 }
Osamu Nakamura 0:ad834d403a8c 151
Osamu Nakamura 0:ad834d403a8c 152 Array<T>& operator*() const {
Osamu Nakamura 0:ad834d403a8c 153 return *array_;
Osamu Nakamura 0:ad834d403a8c 154 }
Osamu Nakamura 0:ad834d403a8c 155
Osamu Nakamura 0:ad834d403a8c 156 Array<T>* operator->() const {
Osamu Nakamura 0:ad834d403a8c 157 return array_;
Osamu Nakamura 0:ad834d403a8c 158 }
Osamu Nakamura 0:ad834d403a8c 159
Osamu Nakamura 0:ad834d403a8c 160 operator bool () const {
Osamu Nakamura 0:ad834d403a8c 161 return array_ != 0;
Osamu Nakamura 0:ad834d403a8c 162 }
Osamu Nakamura 0:ad834d403a8c 163 bool operator ! () const {
Osamu Nakamura 0:ad834d403a8c 164 return array_ == 0;
Osamu Nakamura 0:ad834d403a8c 165 }
Osamu Nakamura 0:ad834d403a8c 166 };
Osamu Nakamura 0:ad834d403a8c 167
Osamu Nakamura 0:ad834d403a8c 168 } // namespace zxing
Osamu Nakamura 0:ad834d403a8c 169
Osamu Nakamura 0:ad834d403a8c 170 #endif // __ARRAY_H__