Cloud Connectivity for Renesas MCUs - Build Connected Products

Transcription

1 Cloud Connectivity for Renesas MCUs - Build Connected Products PART I I Devices in the Cloud RX & RL Family Description: This lab introduces developers to cloud connectivity for embedded devices so they can build their own connected products. This is the second part of a two-part lab it builds upon the activities completed in Part I. Part I establishes cloud connectivity with a development kit and covers entry-level interactive concepts. Part II introduces more advanced connected device concepts, and covers subjects such as development APIs, sharing data and cloud scripting. Lab Objectives, Part II 1. Interact with Device data via the API 2. Create a script that reacts to device conditions 3. Interact with shared data 4. Begin building a cloud connected system Lab Materials Please verify you have the following materials at your lab station. Laptop PC with Internet connection and Web browser Demo Hardware one of the following o YRDKRX63N + Ethernet cable o YRDKRL78G14 + GS WiFi This laboratory procedure This is the second part of a two-part Lab. Part II Skill Level 1. Intermediate understanding of Exosite Time to Complete Lab 60 Minutes Part II Sections 1 Chat with Your Device Create a Cloud Script Share Your Data Use Shared Data Advanced Scripting Cloud Connectivity for Renesas MCUs Page 1 of 12

2 1 Chat with Your Device Overview: This section uses an XMPP interface (chat protocol implemented by most major chat applications), to interact with Device data over a chat client (you can use Google talk / chat). It demonstrates how the cloud connected elements of your device can be accessed by an API with proper credentials. Procedural Steps: Step 1.1 Step 1.2 If you have a Gmail account, log into Gmail (mail.google.com). If you don t have a Gmail account, open Google Talk on your computer and login with the account the instructor has written on the board. In Gmail, click the chat icon at the bottom left, and type commander@m2.exosite.com in the contact box and click Invite to chat. In Google talk, click the +Add button at the bottom and type commander@m2.exosite.com and click Next and OK. Step 1.3 Commander should show up in your People list with a green circle next to it indicating the XMPP chat interface is online. Cloud Connectivity for Renesas MCUs Page 2 of 12

3 Step 1.4 Double click commander to open a chat window and type help commander responds with a list of valid commands. Step 1.5 In Renesas Portals, click the Device menu item on the left and click on your RDK device in the Device list. Double click on the CIK string (40 character hex key) and copy it to the clipboard (Ctrl-C). Step 1.6 Go back to the commander chat session and type setcik and then paste your CIK value in, and hit enter. Commander should respond with ok. This sets the chat session environment to communicate with your RDK device. Step 1.7 Make sure your board is turned on and connected to the cloud. Type dslist and commander will respond with a list of data sources that your device has available. Type read ping and commander will Cloud Connectivity for Renesas MCUs Page 3 of 12

4 respond with the value of the ping data source (<timestamp>, <value>). Step 1.8 Type write led_ctrl 0 this sets the LED Control data source to a zero verify it turns the LEDs off on your board. Type write led_ctrl 1 and verify the LEDs come back on. That s it! Even without the Renesas Portals web interface, you can see how it is possible to communicate with your device via an API interface. Exosite has lots of API types XMPP is just one of them. 2 Create a Cloud Script Overview: This section introduces the developer to the idea of running processing elements in the cloud that are tied to the behavior of the device. A cloud script runs in the cloud, but operates inside the device s profile essentially creating a processing extension to the device s capabilities. Procedural Steps Cloud Connectivity for Renesas MCUs Page 4 of 12

5 Step 2.1 In Renesas Portals, click the Scripts menu item on the left hand side of the page the Scripts list will show up. Step 2.2 Click the link + Add Script on the right hand side of the page name the Script Every Power Cycle and select the Dispatch script template. Step 2.3 Click the new script your created to open the script debugger/editor. You will notice the right hand side has a list of Available Aliases these are the real-time device data sources your script can interact with. Change the values in the script YOUR DATA SOURCE ALIAS HERE and YOUR HERE to ping and your address, respectively. Click Update. Cloud Connectivity for Renesas MCUs Page 5 of 12

6 Step 2.4 Reset your board (RL78G14 users -> make sure to hold down Switch 1!) and wait for about 45 seconds you can click Refresh to refresh the debug pane if the script triggers and sends an , the debug(message) code will also print debug information to the Debug Log. OK you did it! You are now running code inside the cloud processing environment for your device. This is a powerful extension of your device capabilities that becomes even more powerful as you gain an understanding of data shares, resource aliases and the rest of the data hierarchy on the system. 3 Share Your Data Overview: This section shows users how data from one device can be shared to other devices or people. Sharing data from one or more devices into other forums is a powerful way to connect autonomous nodes or to aggregate data from many devices. Data can be shared publicly (to anyone who wants it), or privately (only to individuals who receive share keys). Procedural Steps Step 3.1 In Renesas Portals, click the Data menu item on the left hand side of the page the Data Source list will show up Cloud Connectivity for Renesas MCUs Page 6 of 12

7 Step 3.2 Click the + Add Data link on the upper right hand side and choose From Existing Data and select your RX63N or RL78G14 device and click Continue. Step 3.3 In the Data Setup pane, name the data source your name (e.g. John Doe), integer format, any Unit you like, and alias <firstname>_<lastname> (eg. john_doe). Select Watch Dog for the data source, select Multiply for Calculation and 2 for the Constant. This creates a new data source that will be populated with a value twice that of the data in Watch Dog every time new data comes into Watch Dog. Click Continue. Step 3.4 You should see a new data source named your name in the data source list. Click it to open the Data Information popup. In the Data Information popup, enter the address of the class mate next to you and click Create Share. This will send them an with the Cloud Connectivity for Renesas MCUs Page 7 of 12

8 share code and also make the data available in the + Add Data wizard. Step 3.5 Back in the Data Source List, click the + Add Data link again, and this time add From Shared Data, Continue. Select Data Shared to You and choose the data that your neighbor shared with you shown in the drop-down list. Assign to your development kit device and click Continue. Step 3.6 You now have your neighbor s data available to your device and to you as a user in the Portal. You can see it listed in your data source list, and can click on it to see the data history in the pop-up. Cloud Connectivity for Renesas MCUs Page 8 of 12

9 4 Use Shared Data Overview: This lab section demonstrates the use of a shared data source to control the behavior of multiple devices from a single input. Once the data is shared, it can be operated on by the recipient to create valuable information, make decisions, and to generate combinatorial outputs. The developer can explore some of these other concepts. Procedural Steps Step 4.1 In Renesas Portals, click the Data menu item on the left hand side of the page the Data Source list will show up. Click the data source LED Control to open the data popup. Scroll down and type in Confirm into the delete box and delete the data source. Step 4.2 Back in the Data Source list, click + Add Data to add a new data source. Choose From Public Source Cloud Connectivity for Renesas MCUs Page 9 of 12

10 Step 4.3 Either: a) Type in "32f974301c8e4c2c5cc32e335d9fa2553f2e6ebf in the Public RID box b) Or, Search for Devcon 2012 in the search box presented and select the Data Source called LED Control for Devcon 2012 Step 4.4 Step 4.5 Assign the public data to your development kit device, give the alias the name led_ctrl and click Continue. Your Data Source list should now have the data source LED Control (public) listed in the data source list again. When you have this listed, please raise your hand and let the instructor know. Step 4.6 The instructor has the source of the Public LED Control for Devcon 2012 he will turn it on and off and you can see the LEDs on everyone s dev kits turn on and off. 5 Advanced Scripting Overview: This section demonstrates how to use Cloud Scripting at a Portal level to interact with your devices and other information in your Portal environment. Because your Portal is a parent and your devices (development kits / other devices) are children, your Portal script can interact with certain elements from Cloud Connectivity for Renesas MCUs Page 10 of 12

11 the children. This is very useful for creating automated management schemes for your own connected product efforts. Procedural Steps Step 5.1 In Renesas Portals, click the Scripts menu item on the left hand side of the page the Scripts list will show up. Click + Add Script and select Community (the name of your Portal) for the Reference Device, name it Portal Device Monitor and select the Portal Device Monitor for the script template. Step 5.2 Update the YOUR HERE to use your address this script will monitor the Portal for changes to Device meta data and you when meta information for a Device in the Portal changes. Step 5.3 Click the Devices menu item on the left hand side and click the Exosite Device so the popup window opens. In the popup window, change the Location field to Sunny California. Cloud Connectivity for Renesas MCUs Page 11 of 12

12 Step 5.4 Check your you should receive an that notified you that someone changed information about your device. Wrap Up OK that s it for Part II! Along with the in-lab demos the instructor gave regarding Portals Whitebox (creating your own version of you now have the skills and the tools to deploy full cloud-connected products of your own. Cloud connectivity for products is changing the way people interact with their world. From home security monitoring, to remote sensor readings, to in-field software updates, to industrial & efficiency process control, to anywhere access to files cloud connectivity for embedded products is helping products become smarter and more cost effective. We hope this lab was a good introduction to cloud connectivity for Renesas products thanks for attending, and let us know how we can help you Build Your Own Connected Products! All the best, Hans Rempel hansrempel@exosite.com Cloud Connectivity for Renesas MCUs Page 12 of 12