µC/Probe on the RIoTboard
Contents
1. Figure 3 4 2 This folder contains the files that implement and make the example The file app c is the application level example that demonstrates how easy it is to include a uC Probe interface in your embedded Linux C project The files with the suffix _cfg are for configuration purposes You don t really need to edit any of these files simply type make all at the command line to build the example and generate the ELF file Figure 3 4 3 The wC CPU module consists of files that encapsulate common CPU specific functionality and CPU compiler specific data types Although there is no need to get familiar or edit any of these files they are still required to build the example Figure 3 4 4 The uC Lib module consists of library functions meant to be highly portable and not tied to any specific compiler It contains the source code of the functions used to manipulate ASCII strings perform memory copies and more Similar to the uC CPU files previously described there is no need to get familiar or edit any of these files but they are still required to build the example Figure 3 4 5 The uC Probe Target module implements the communication protocol on the embedded target i e RloTboard to respond to the requests from uwC Probe running on the Windows PC There is no need to get familiar or edit any of these files 3 4 Installation of uC Probe Target code in the RloTboard Extract the files indicated by the blue box in Figure 3 4 1 t2. zip F Downloads W Music Pictures Videos File System te Trash Network Browse Net Micrium_RIoT_QSP zip selected 222 7 kB _ Figure 3 6 RloTboard Downloads Page 9 Micripm uC Probe on the RloTboard You can extract from the zip file the entire micrium folder indicated by the green boxes in Figure 3 4 2 5 and copy it to your Home directory as shown below Computer Ei Desktop IO Documents a Documents Downloads Downloads Desktop W Music Jm Pictures wal micrium dd Ki i Music Pictures B Videos File System A tm Trash Nell Public Templates Videos Network Browse Net micrium selected containing 2 items Figure 3 7 RloTboard Extracting Files 3 5 Compiling the uC Probe Target Demo on the RloTboard Open a terminal console to the RloTboard change your working directory to the one where you installed the micrium folder in the previous step and to the subfolder shown in Figure 3 4 2 where the makefile is located For example you can enter the following command at the prompt cd micrium Examples RloTboard RloTboard uC Probe To compile the uwC Probe demo and generate the executable file ELF enter the following command at the prompt make all 3 6 Executing the uC Probe Target Demo on the RloTboard Similar to the previous step open a terminal console to the RloTboard change your working directory to the one shown in Figure 3 4
3. Micripm uC Probe on the RloTboard Micrium wC Probe on the RloTboard Linux 1 Introduction Whether you are doing kernel driver or application development in a Linux environment it s likely that at some point you will need to debug your program using the GNU Debugger GDB to do basic operations such as printing variable values setting breakpoints and stepping through your code There are several GUIs available for GDB such as the Eclipse CDT IDE that effectively help you debug and trace your application and libraries at the C source code level Other tools exist to analyze performance execution paths and memory including memory leak detection benchmark and optimization However if you are doing embedded application development in a Linux environment all the previously mentioned tools are simply not enough uC Probe is a Windows application tool that helps you extend your debugging scope to a higher level where you can model the system and operate the model using virtual controls to simulate stimulus and virtual indicators to simulate response By having a dashboard for your C code you will gain a firm understanding of what the embedded system is doing at any given time uC Probe works with any embedded target processor and in most cases it does not require any special code running on the embedded target e g no kernel baremetal Other platforms such as the RloTboard featured in this document require a few files writ
4. 2 where the makefile is located and enter the following command at the prompt probe_demo out Page 10 Micripm uC Probe on the RloTboard 3 7 Opening the uC Probe Demo on the Windows PC Open uC Probe on the Windows PC and click File gt Open to open the workspace file probe_demo wspx located in the folder illustrated in Figure 3 4 1 3 8 Updating the Symbols Browser If you have modified the original demo by editing the file app c illustrated in Figure 3 4 2 then the memory addresses of your global variables have most likely changed and you will need to update the Symbols Browser in uC Probe You first need to transfer the new ELF file that you built in step 3 5 from the RloTboard to the Windows PC You can do that by inserting a USB flash drive in one of the RloTboard s USB ports in HUB1 or HUB2 When you insert a USB flash drive into the RloTboard Ubuntu will open a window on your desktop where you can drag and drop the new ELF file probe_demo out Alternatively you can open a console terminal and enter the following command cp micrium Examples RloTboard RloTboard uC Probe probe_demo out media lt USB Flash Drive s Serial gt Then you can insert the USB flash drive in your Windows PC and use Windows Explorer to copy the new ELF file probe_demo out into your Micrium folder in your Windows PC For example Removable Disk E probe_demo out To C Users lt your name gt Desktop Micrium Finally to up
5. 0 2600 2620 260 2660 2680 2700 2720 2740 Bo Running TCP IP Device TCP IP Symbols Configured 3 Tx 9 270 reques Figure 3 11 uC Probe Dashboard As you move the slider or type in a message in the text box control from uC Probe you will see the RloTboard s terminal window updating its output accordingly as shown in Figure 3 12 linaro linaro ubuntu desktop micrium Examples RloTboard RloT uC Probe a 0x0001611C Thursday 01 01 70 02 27 16 AM UTC G FG Pb amp L S DD OD 7 TU E m T D m B gt m E pe ar OD g a T iL D U ie i T 0 U Ee T TT D P i 0x0001609C 0x00016098 d 6x0001611C Ox0001609C Ox00016098 i 6x0001611C 0x0001609C 0x00016098 d 6x0001611C E m m a ma pe xO001609C m m i in xG G16098 i x6 001611C 8xO801609C Ox60016098 Enter a message here 0 Thursday 01 01 70 02 Enter a message here 0 5 AM UTC Thursday 61 01 70 2 Enter a message here i Thursday 01 01 70 02 Enter a message her a Thursday 01 01 70 2 Enter a message here 6 AM UTC AM UTC Figure 3 12 RloTboard Terminal Window Page 14
6. TCP IP communication interface and configure it with the RloTboard s IP address as shown in Figure 3 10 Page 12 Micripm uC Probe on the RloTboard pG Probe Settings Endianness Statistics Data Collection Little Endian symbols sec Big Endian bytes sec Interfaces Refresh None Settings Cloud Only Remote Host 192 168 7 2 UONeEJHUNUWWO td Target Resident Code Remote Port 9930 i tery J Time Out sec enable Error Handling Safe Mode ignore consecutive errors fora x Disabled maximum time of Debug Interfaces fm j Link oo CMSIS DAP i Cypress PSoC Prog Figure 3 10 uC Probe Communication Settings Note Whether your RloTboard s network interface is configured in DHCP or static mode you can enter one of the following commands at the command line prompt to display its IP address hostname I capital as in India ip addr show ifconfig Page 13 Micripm uC Probe on the RloTboard 3 10 Running uC Probe on the Windows PC Click the Run button in the top toolbar of uC Probe uC Probe will start exchanging data with your RloTboard and will display the dashboard shown in Figure 3 11 O9 O gt E So E v DataScreen1 vX App_Date Thursday 01 01 70 02 27 17 AM UTC Micrium uC Probe probe_demo wspx App_Msgf Enter a message here pools App_Val ao 1 to tot tot tot 2570 2590 2610 2630 2650 2670 2690 2710 2730 27 258
7. d on the onboard flash storage The example in this document requires Linux To re flash the board with a Linux image follow the instructions in this manual Be familiar with the RloTboard including how to power up the board connect a mouse and keyboard connect a monitor and connect it to the Internet Click here for more information Have abasic understanding of Linux and GNU commands Have a basic understanding of Linux based embedded systems development using POSIX threads in the C language Page 3 Micripm uC Probe on the RloTboard 3 Quick Start Guide This section will guide you through the necessary 10 steps to run the example of Micrium s uC Probe on the Linux version of the RloTboard 3 1 Installation of uC Probe for Windows Start by downloading and executing the uC Probe Windows Installer from the following link http micrium com tools ucprobe software and docs The installation process will automatically create a shortcut on your Desktop that you will need later on E Micrium uC Probe Figure 3 1 uC Probe Shortcut on the Windows Desktop With the purchase of the RloTboard from element14 you are eligible for a 1 month subscription to the Professional Edition of uC Probe You can choose to activate your license at any time but because the subscription period begins from the moment you activate it we recommend activating it at a later time as this demo simply requires the Evaluation Edition of
8. date the Symbols Browser click the button with the Red X shown in Figure 3 8 then click the button labeled ELF and browse to the folder where you transferred the new ELF file probe_demo out For example C Users lt your name gt Desktop Micrium Page 11 Micripm uC Probe on the RloTboard Symbol Browser S ELF G CDF Zor csr EF CSF 3 mor E MQTT 2 Search by Name Name Display Name i Type Size Memory Addres at gt Y probe demo out N A N A 5 633 N A Hl app c app c N A 257 N A App Date App Date char 128 128 0x000152F4 App_Msq App_Msg char 128 128 000015274 App Val App Val unsigned char 1 Ox00015270 Cpu_cc cpu_c c N A 28 N A E cpu_core c Cpu_core c N A 304 N A lib_math c lib_math c N A 4 N A lib_mem c lib_mem c N A 2 072 N A i Figure 3 8 uC Probe Symbols Browser 3 9 Configuring uC Probe on the Windows PC The only configuration setting need by uC Probe is the IP address of the RloTboard By default the RloTboard is configured in DHCP mode However if your board is set Click the Settings button in the top toolbar of wC Probe as indicated in Figure 3 9 Micrium pC Probe of ae Bring Forward Ro Group 7 fy Show Hide Grid Ep E Show Hide Rulers Paste X A QD iii of Application Clipboard Arrange Hed Units as Zoom Factor x Figure 3 9 uC Probe Top Toolbar uC Probe will open the Settings window shown in Figure 3 10 Select the
9. o any folder in your Windows PC For example you can extract these files to a folder called Micrium on your Desktop C Users lt your name gt Desktop Micrium Now in regards to the files indicated by the green boxes in Figure 3 4 2 5 there are multiple ways to transfer them to your RloTboard s file system Here are some ideas USB flash drive in one of the USB ports in HUB1 or HUB2 Micro SD Card in J7 SecureCopy SCP command Directly from the RIoT board Page 8 Micripm uC Probe on the RloTboard The easiest way to do it is probably by downloading the files directly from the RloTboard by using an Internet browser from the RIoT board s Ubuntu desktop environment and downloading the same zip file from here http micrium com probe Micrium RloT QSP zi When you do so Ubuntu will open a window similar to the one shown in the following image Opening Micrium_RloT_QSPzip You have chosen to open Micrium_RloT_QSPzip whichis a Zip archive From http micrium com What should Firefox do with this file ce Open with Archive Manager default Save File C Do this automatically For Files like this From now on Cancel OK N Figure 3 5 RloTboard Downloading File Select the option to Save the file and press Ok The file will be downloaded to your Downloads directory as shown below Downloads b Computer Home Downloads Home Ei Desktop E Documents Micrium _RloT_QSP
10. s PC and uC Probe You design your own dashboard by dragging and dropping virtual controls and indicators onto a data screen Each virtual control and indicator needs to be mapped to a RloTboard s symbol by selecting it from the symbol browser Refer to the document uC Probe User s Manual for more information on creating your own dashboard with uC Probe Page 2 Micripm uC Probe on the RloTboard Figure 1 1 3 Before proceeding to the run time stage uC Probe needs to be configured to use TCP IP In order to start the run time stage you click the Run button and uC Probe starts making requests to read the value of all the memory locations associated with each virtual control and indicator i e buttons and gauges respectively At the same time uC Probe sends commands to write the memory locations associated with each virtual control i e buttons on a click event Figure 1 1 4 In the case of a reading request the RloTboard responds with the latest value In the case of a write command the RloTboard responds with an acknowledgement Figure 1 1 5 uC Probe parses the responses from the RloTboard and updates the virtual controls and indicators Requirements To conduct the steps in this guide you must meet the following requirements Have a RloTboard Board the RloTboard can be purchased from here Have a HDMI cable and monitor Have a USB based keyboard and mouse The RloTboard comes with an Android OS image preinstalle
11. ten in C that are available for free and are royalty free This document will walk you through the steps necessary to run a Linux process written in C on the RloTboard and interface the process with uC Probe via TCP IP Global variables declared in the Linux process will be available for read write access from a dashboard in the Windows PC Figure 1 1 shows an overview of the system and data flow The annotations at the bottom of the image describe each step in the data flow Page 1 Micripm uC Probe on the RloTboard Windows PC ELF File Running uC Probe Symbol names and addresses ELF Header Program Header Table text rodata Section Header Table 5 THCIProbe mann Graphical ee uC Probe Workspace Dashboard made out of virtual controls mapped to the RloT global vars RloT board Running uC Probe Target Figure 1 1 uC Probe and the RloTboard Flow Diagram Figure 1 1 1 You have to provide uC Probe with an ELF file with DWARF 2 3 or 4 debugging information The ELF file is generated by your toolchain s linker i e GNU s gcc uC Probe parses the ELF file and reads the addresses of each of the RloTboard s symbols i e global variables and creates a catalog known as Symbol Browser which will be used by you during design time to select the symbols you want to display on your dashboard Figure 1 1 2 During design time you create a uC Probe workspace using a Window
12. um RloT QSP zi The contents of this zip file are illustrated in Figure 3 4 where the files surrounded by the Blue box are meant to be used in the host Windows PC while the files surrounded by the Green boxes are meant to be used in the Linux side of the system i e RloTboard s file system Page 6 Micripm uC Probe on the RloTboard For discussion purposes we can separate the directory structure in 5 different categories as indicated in Figure 3 4 The annotations at the bottom of Figure 3 4 will describe each group of files L__mMicrium RIoT QSP probe demo out 4 probe demo wspx 1 micrium Examples ___RToTboard 2 L__RToTboard L__uC Probe app c cpu_cfg h lib_cfg h makefile probe com _cfg h Software uC CPU 3 uC Lib 4 uC Probe Ta rget 5 Communication L__Generic Source probe com c probe _com h TCPIP OS L__posix probe tcpip os c Source probe tcpip c probe tcpip h Figure 3 4 Micrium Quick Start Package Directory Structure Page 7 Micripm uC Probe on the RloTboard Figure 3 4 1 These files are meant to be used on the Windows PC side of the system by uC Probe They are the input files to uC Probe and can be described as follows The file probe_demo out is the executable file ELF generated by the compiler The file probe_demo wspx is the workspace file format used by uC Probe to store the dashboard where all the graphical widgets get configured
13. uwC Probe Whenever you are ready to activate your license you will need internet access and then you can activate it by simply clicking File gt Activation and entering the 20 characters license key provided by element14 Page 4 Micripm uC Probe on the RloTboard 3 2 Connecting the RloTboard Connect the RIoT board to your Windows PC as shown in Figure 3 2 USB Keyboard USB Mouse Internet HDMI TV or Monitor 5V 4A DC Figure 3 2 RloTboard Connections The RloTboard will start Linux and will show a Desktop on your display connected to the HDMI port of the RloTboard similar to the one shown in Figure 3 3 Some of the steps in this quick start guide will ask you to use the tools indicated in Figure 3 3 to perform the following actions Web Browser To download software Terminal To compile the demo and build the executable USB flash drive file system To transfer the ELF file from the RloTboard to your Windows PC Page 5 Micripm uC Probe on the RloTboard Ty 4 00 08 amp linaro Firefox Web Browser Terminal 4 0 GB Filesystem Zi biii Figure 3 3 RIoTboard Desktop 3 3 Download of uC Probe Target code in the RloTboard All the files necessary to interface Micrium s uC Probe with the RloTboard board are archived in the Quick Start Package for the RloTboard zip file Micrium_RIloT_QSP zip which is available for download from the following link http micrium com probe Micri
Download Pdf Manuals
Related Search