IoT Demo User`s Manual
Contents
1. _ Fn eon Saet ona atasay ooon D SM Solar Panel 36 000 ew Charge Controller aS Electric Power y Company Te i i i Power Meter Inverter et 7 1 Open uC Probe in your Windows PC and click File Open to open the dashboard example file SmartHomeGateway wspx located at the following path in your Windows PC L__micrium ___software uC Probe L__wWorkspaces SS Page 13 Micripm loT Demo User s Manual 7 2 The first time you open the workspace an error message will report that uC Probe was unable to find the ELF file in your file system pC Probe Missing File uC Probe is unable to find the following file uC MQTT SmartHomeGwy Ether out uC Probe found the following files in your working directory Name Modified Date Please select one of them to update your workspace Browse Cancel Update You can update the path to the file depending on where you have your Micrium folder in your file system L__micrium L__Examples L TI L EK TM4C1294XL L uC MQTT SmartHomeGwy L EW IAR L FLASH L Exe L uC MQTT SmartHomeGwy Ether out 7 3 Click the Settings button located in the top toolbar of uC Probe and configure the Communication Settings to TCP IP and your loT device s IP address as shown in the previous step 5 5 Page 14 Micripm lol Demo User s Manual pC Probe Settings En2. Micripm lol Demo User s Manual Micrium Spectrum loT Demo on the Connected LaunchPad TM4C products Smart Home Gateway There are countless resources in the lof world today Embedded system engineers are faced with a large variety of protocols cloud services platforms techniques and solutions to choose from Because most of these resources seem disjointed we have tried most of them and put together a complete set of resources that you will need to develop an loT device in less time The purpose of this demo is to introduce you to the following resources of choice for the loT The Texas Instruments Connected LaunchPad TM4C platform The IAR Systems Embedded Workbench for ARM The 2lemetry ThingFabric loT platform Micrium embedded software and tools The following lol demo simulates a series of home appliances that you can control and monitor from the web The minimum hardware requirements include the following components Windows PC Texas Instruments Connected LaunchPad TM4C1294 Ethernet Cable Micro USB Cable IAR Systems Embedded Workbench for ARM Micrium uC Probe SEA Page 1 Micripm loT Demo User s Manual Step 1 Installing IAR Systems Embedded Workbench for ARM The IAR Systems Embedded Workbench for ARM incorporates a compiler an assembler a linker and a debugger into one single integrated development environment IDE In this step you will install the 32K Kickstart
3. actually install the drivers manually by opening the Device Manager in the Control Panel as shown below a Device Manager E aa File Action View Help e m E H m ERE 4 Micrium 18 gt lR Acronis Devices gt Wa Computer gt Sy Disk drives b Display adapters gt e DVD CD ROM drives gt Human Interface Devices Sg IDE ATA ATAPI controllers EF Jungo Keyboards F Mice and other pointing devices h kL Monitors a Network adapters Broadcom NetLink TM Gigabit Ethernet E Realtek PCI GBE Family Controller 4 5 Other devices Sp Unrecognized USB devices i In Circuit Debug Interface gt W Portable Devices gt Ports COM amp LPT bp 0 Processors bp EP Sound video and game controllers b System devices P F Universal Serial Bus controllers a PPE eee a Page 4 Micripm lol Demo User s Manual a Device Manager onl Is x File Action View Help e 56 H melee 4 3 Micrium 18 EP Acronis Devices W Computer Sq Disk drives Display adapters 3 DVD CD ROM drives gt bi Human Interface Devices Sg IDE ATA ATAPI controllers EP Jungo Keyboards the unrecognized b Mice and other pointing devices device kL Monitors EP Network adapters 4 Broadcom NetLink TM Gigabit Ethernet FV Ta Ta Right click over 7 il Tr aa a Ep Realtek PCI GBE Family Controller U 4 Other devices Driver Software i In Circuit D Update Driver S
4. is a Windows application designed to read and write the memory of any embedded target processor during run time Memory locations are mapped to a set of virtual controls and indicators placed on a dashboard We will use uC Probe to monitor and control the loT device Page 2 Micripm loT Demo User s Manual In this step you will install de Educational Edition of uC Probe by downloading the uC Probe Windows Installer from the following link http micrium com tools ucprobe software and docs The Educational Edition of uC Probe is available for free evaluation with a few limitations such as a limited amount of features and a limited amount of continuous run time This license can be upgraded to the Basic or Professional Editions at any time For more information go to the following address http micrium com tools ucprobe features Step 3 Connecting the Texas Instruments TM4C1294 The TM4C1294 shown below is an evaluation and demonstration board for the Connected LaunchPad TM4C Power and Programming microcontrollers etree All the jumpers should be connected except for JP1 which should be configured for ICDI Page 3 Micripm loT Demo User s Manual Step 4 Installing the Windows Drivers for the Connected LaunchPad TM4C products The first time you connect the board as described in the previous step depending on your version of Windows and IAR Systems Windows may not recognize the USB device You have to
5. 3 0 00 0 000 Amps 21925PM 2419 30PM 240 35PM 2 19 4DPM 2 19 45 PM Kitchen Laundry Appliances Solar Panel Net Meter Use the navigation bar at the bottom of the web page to go to other views that will display the state of the Solar Panel and Battery Bank There is also other view labeled as Net Meter that displays your power meter and how much of that demand is coming from the power company and your solar system Page 17
6. Update Driver Software Stellaris Virtual Serial Port COM30 Wait for the success message Windows has successfully updated your driver software Windows has finished installing the driver software for this device A Stellaris Virtual Serial Port Close _ Repeat the same process for the remaining two unrecognized USB devices until you get the following two success messages Page 7 Micripm loT Demo User s Manual L Update Driver Software Stellaris ICDI JTAG SWD Interface Windows has successfully updated your driver software Windows has finished installing the driver software for this device A Stellaris ICDI JTAG SWD Interface L Update Driver Software Stellaris ICDI DFU Device Windows has successfully updated your driver software Windows has finished installing the driver software for this device i Stellaris ICDI DFU Device Page 8 Micripm loT Demo User s Manual Step 5 Working with IAR Systems Embedded Workbench for ARM 5 1 The easiest way to open the IAR Systems Embedded Workbench for ARM is by either launching the shortcut on your desktop or by typing in the keyword IAR in the search box shown below Programs 2 IAR Embedded Workbenche IAR License Manager 7 Da NN 3 Launch IAR 1 Click the Windows Start button 2 Search for IAR All Programs 5 2 Click File Open Workspace and browse to
7. ct will be compiled and a debugging session will be launched 6 3 The debugger will start by halting the CPU at the main entry point as shown below Simply press the Go button to start execution m ag uC MQTT SmartHomeGwy IAR Embedded Workbench IDE File Edit View Project Debug J Link wC OS IIl Tools Window Help Da S SIZI ses B x Workspace Debug Entr oint for C code Files oo o GuC MQTT SmantH v a App a a BSP La G uc CPU Note s 1 It is assumed that your code will call mai Ha E uC DHCPc E era initialization est UL settee ttt eet ete tee eee ttt ttt ttt ttt ett et eee eee ete tet ttt ttt tteteteeteteeeee Ha E uc MOTT PY La G uC Probe Ha E uC TCPIP v2 mme E R TT a C uCos II ok La E Output none none OS_ERR err CPU_IntDis BSP IntVectSet 27 CPU _FNCT VOID OSCtxSwISR OSInit err uC MQT T SmarHomeGwy 6 4 The example will start uC OS III and uC TCP IP The uC DHCPc will negotiate an IP Address with the network s DHCP server in a process that can take between 1 30 seconds depending on network traffic 6 5 Use the IAR s Live Watch window to inspect the IP address that your lol device was able to negotiate with the DHCP server Click View Live Watch and enter the variable name AppTcplpAddr as shown below _ i Page 11 Micripm loT Demo User s Manual Expression Value Location Typ
8. dianness Little Endian Big Endian TCP IP Ea Interfaces None lt gt Cloud Only Target Resident Code Ny reer ww RS 232 amp use Debug Interfaces amp j Unk jesauar A wy CMSIS DAP i Cypress PSoC Prog Fa EET SS symbols sec io 4 io 4 i ot J i 4 bytes sec Refresh Settings IP Address Remote Host 10 10 1 151 7 i Remote Port 9930 Time Out sec enable Error Handling Safe Mode Ignore consecutive errors for a Disabled maximum time of Pe eee ee eee Tee eee Tee TTS TS eT TS eT Tee Tee TT eS ST TST TT eT Tee TTS SST TST TSS e TTS TT ST TS ST Tee eT eS TT eee TST TST TTT TTS Tree TT eee Teer Tet 7 4 Click the Run button located in the top toolbar of uC Probe 7 5 Click on the Dashboard tab of uC Probe to go to the Smart Home Gateway dashboard screen Press the buttons above each appliance to turn the household loads on and off You can also increase or decrease the sunlight intensity with the vertical slider next to the solar panel SS Page 15 Micripm loT Demo User s Manual Step 8 Monitoring and Controlling the loT Device remotely from the Web 2lemetry s ThingFabric is the loT platform where all the data generated by the embedded target is stored The lol device connects to this platform using MQTT a simple publish subscribe protocol For more information about MQTT please visit htto matt org Your loT device is periodically p
9. e ApoTcolpAddr Uo elias ales alt ald Ox2001C244 char 1 b AppMQTT_ThinglD O00 1AB602A04B 2001C060 char 33 click to edit gt 4 i Board s IP address loT device unique ID Similarly inspect the value of the string AppMQTT_ThingID as illustrated in the image above This is your board s unique ID in the cloud and you are going to need this information later Page 12 Micripm loT Demo User s Manual Step 7 Monitoring and Controlling the lol Device from uC Probe The loT example featured in this demo runs a simulator to create data for a Smart Home Gateway The theory of operation can be described as follows The sun shines on the solar panels and they generate DC electricity This DC current is routed into an inverter that converts it to 120 volts AC the same as the house s main supply Any surplus electricity generated by the system not used by the appliances is used to charge the battery bank or fed back into the mains electricity supply grid for which a credit is received in the electric bill In this step you will use uC Probe to control and monitor the simulation through a dashboard that contains controls to modify the sunlight intensity and the state of the electrical loads among others At the same time the dashboard will display the current output values amps calculated by the simulation algorithm as shown in the following image m a e a B
10. edition of IAR Systems Embedded Workbench for ARM by downloading the installer from the following link http supp iar com Download SW item EWARM EVAL The same installer is used for both the 30 day time limited and the Kickstart size limited evaluation edition Step 2 Installing Micrium Software 2 1 Installing Micrium Embedded Software The Micrium Embedded Software includes uC OS III and wC TCP IP in pre compiled linkable library form The application level code is provided for free and solely as a reference to help engineers use Micrium Texas Instruments and 2lemetry products There are no express or implied copyright licenses granted hereunder to design or fabricate any lol devices based on the information in this guide Micrium Texas Instruments and 2lemetry make no warranty representation or guarantee regarding the suitability of this example for any particular purpose nor does Micrium TI and 2lemetry assume any liability arising out of the application or use of any example design and specifically disclaims any and all liability including without limitation consequential or incidental damages You can download the Micrium embedded software from the following link http micrium com download iot tm4c1294 smarthomegateway Simply extract the contents in your PC This guide will make reference to this embedded software by calling it the Micrium folder at Micrium 2 2 Installing Micrium wC Probe Micrium uC Probe
11. ng uniquely identifying this devi devices Only needs to be unique to yo lib_cfg h Common examples include device s MAC ad os_app_hooks c Device 1 Device 2 are fine too os_app_hooks h ttttttttttttttttttttttttttttttttttttttttttttttttttttt os_cfg h F os_cfg_app h E probe_com_ctg h E spin_led c define APP MQTT M2MIO USERNAME juan bena L R spin_led h 0 define APP MQTT M2MIO PASSWORD Sf4dcc3b5 uC ues MQTT M2MIO DOMAIN com micri A LJ uC c pee Ha G uC LIB E Micrium uC Software La SjucMOTT MOTT M2MIO TOPIC STUFF PUB smarthome u a gt r QTT M2MIO TOPIC STUFF SUB smarthome E uC Probe x zE a CjuC TCPIP V2 88 define APP MQTT M2MIO BROKER HOST NAME q m2m io Ha G uCOS l 89 define APP MQTT M2MIO BROKER PORT La Output a0 T g B uC MQTT SmartHomeGwy map 91 define APP MQTT RX BUF SIZE D uC MQTT SmartHomeGwy out 92 93 define APP _MQTT JSON_PARSER_HAYSTACK MAX LEN uC MOTT SmartHomeGwy sem SSSR SESS RP mT _ seen sates mete app_matth bsp_cfg h clk_cfg h cpu_cfg h b th hb h h amp TTT l TTT Tatas a a a a a a a Executable File ELF Page 10 Micripm loT Demo User s Manual Step 6 Executing the loT Example In this step you will download the example code into Flash memory and start a debugging session using IAR Systems Embedded Workbench 6 1 Click Project Download and Debug to execute the example 6 2 The proje
12. oftware J fp In CircuitD Disable W Portable Devic Uninstall J Ports COM amp A Processors b p sound video a Properties p e System devices D F Universal Serial Bus controllers aa Tae Scan for hardware changes yT il Page 5 Micripm loT Demo User s Manual Select the option Browse my computer for driver software m Update Driver Software In Circuit Debug Interface How do you want to search for driver software gt Search automatically for updated driver so Windows will search your computer and the Internet f latest driver software for your device unless you ve disabled thi Installation settings L gt Browse my computer for driver software Locate and install driver software manually Browse to the path where you have your IAR Systems installation C Program Files x86 IAR Systems Embedded Workbench arm drivers StellarisICDI Page 6 Micripm loT Demo User s Manual Windows Security 3 Windows can t verify the publisher of this driver software Select the option Install this driver gt Don t install this driver software software anyway You should check your manufacturer s website for updated dri your device gt Install this driver software anyway g Only install driver software obtained from your manufacturer s website or disc Unsigned software from other sources may harm your computer or steal information iw See details J
13. the workspace file uC MQTT SmartHomeGwy Ether eww located at the following path in your Windows PC L__micrium L__Fyamples LTI L EK TM4C1294XL L uC MQTT Sma rtHomeGwy Ether L EW_IAR Depending on the version of IAR Embedded Workbench installed in your Windows PC you may be asked to let the tool update your project to your version s format You can safely accept and let the tool bring up your project to the correct format The workspace will open in a window similar to the one shown in the image below Page 9 Micripm loT Demo User s Manual Starts a Debugging Session e uC MQTT SmartHomeGwy IAR Embedded Workbench IDE File Edit View Project J Link Tools Window Help rA LEIRER LIRE VTVEUAP SPER R STS amp probe_tcpip h app c bsp_int_vect_tbl c app_cfe app_matt c O 7x aaa 58 eeeeeeeteeeeeeeeeeeeeeececeeceeceeeeeeteeeeeeeececeeteteteeeeeeee files 59 i LOCAL DEF E F uC MQTT SmartHomeGwy As tee f tttttttttttt La G App Application level Code Ha G SmartHomeGwy E smart_home_gwy c J L E smart_home_gwy h ttttttttttttttttttttttttttttttttttttttttttttttttttttt COTCPIP The values below can be found by logging into the m2 E app c Username Your email address you used to create t E app_ctg h Password MD5 hash of your password 32 character Domain Randomly generated Can be found on Ac Device Type Can remain things If this device is device on the m2m io portal there may b Device ID A stri
14. ublishing the latest simulation data values to the MQTT broker at 2lemetry via MQTT At the same time the lol device subscribes to a topic to receive any requests from a remote MQTT client to control the Smart Home Gateway In this step you will use your internet browser to control and monitor the simulation through a web page that contains controls to modify the sunlight intensity and the state of the electrical loads At the same time the webpage will display the current output values amps calculated by the simulation algorithm 8 1 Open an internet browser such as Google Chrome and go to the following address http micrium com iotdemos smarthomegateway 8 2 The TM4C1294 board s MAC address will be used as a unique ID in the 2lemetry loT platform This unique ID is Known as the Thing ID and it is displayed on previous step 5 5 Type in the Thing ID e g 00305508 in the text box to connect to your loT device as shown below MICH pD T G Micrium i fi i t Micrium MQTT Broker Settings Thing ID 001AB602A04B x 8 3 Once connected to your lol device you can turn On and Off the household loads as shown in the image below Page 16 Micripm lol Demo User s Manual hh http micnium com iot pD D Micrium po ao Micripm Family Room 1 00 0 75 0 50 lt 025 gt 0 00 0 837 Amps 21925PM 24030PM 210 35PM 2 19 40PM 2 19 45 PM 0 12 off y 0 09 E 0 06 t 0 0
Download Pdf Manuals
Related Search