OSs-Micrium-Learning Centre-Application Notes
Contents
1. Document Conventions Numbers and Number Bases Hexadecimal numbers are preceded by the Ox prefix and displayed in a monospaced font Example 0xFF886633 Binary numbers are followed by the suffix b for longer numbers groups of four digits are separated with a space These are also displayed in a monospaced font Example 0101 1010 0011 1100b Other numbers in the document are decimal These are displayed in the proportional font prevailing where the number is used Typographical Conventions Hexadecimal and binary numbers are displayed in a monospaced font Code excerpts variable names and function names are displayed in a monospaced font Functions names are always followed by empty parentheses e g OS Start Array names are always followed by empty square brackets e g BSP Vector Array File and directory names are always displayed in an italicized serif font Example Micrium Sofware uCOS l Source A bold style may be layered on any of the preceding conventions or in ordinary text to more strongly emphasize a particular detail Any other text is displayed in a sans serif font Micrium uC OS II C Probe and uC GUI for the Atmel AT91SAM9xxx CPUs Table of Contents 1 Installing the Micirum Software 7 2 Using the Micirum IAR Example Project 8 2 01 01 IAR pC OS II Kernel Awareness 9 2 02 Running the Example Applications 9 2 02 IAR Project configuration 12 2 03 IAR AT91SAM9xxx boot loaders2. Development Board The RS232 port labeled RS232 for pC Probe is used for pC Probe at 115200 baud which allows you to view in real time the value of any variables in the target system Figure 2 6 show an example of the HyperTerminal window AT91SAMS9xxx HyperTerminal p lol x File Edit View Call Transfer Help Initializing uC Probe Creating Application Events Creating Application Tasks Micrium uC OS II on the Atmel AT91SAM9260 General Info uC OS II 2 88 running at 1000 ticks sec CPU Usage 3 at CPU Speed 210 MHz OS ver amp Ticks per Sec Ticks 9699 HCtxSw 10844 CPU Usage amp CPU Speed Micrium uC O0S II on the Atmel AT91SAM9268 Ticks amp ContextSwitches Disconnected Auto detect 115200 8 N 1 SCROLL CAPS NUM Capture Print echo Figure 2 6 System State 11 Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs The push buttons can be used to change the output to a new item The pC GUI demo should be displayed in the AT91SAM9xxx EK board s LCD display as shown in Figure 2 3 and 2 5 2 02 IAR Project configuration The IAR project configurations allow you to compile link and load the software in different ways to the target The following configuration is available in the IAR projects e XRAM BIN This project option is configured to load the code into the board s external SDRAM XRAM 2 03 IAR AT91SAM9xxx boot loaders The example ap
3. Run Time Views gauge OS Configuration General Du ri ng Ru n Ti me View afl OS Configuration E vents Timers Atmel AT91SAM9263 EK when data is a 0S GeneralInfo OS Task CPU Usage 0S Task Stack Usage 0S TaskInfo OS Events 0S Timers 0S Configuration Genera 0S Configue 4 gt X L G collected this will Data Screen Symbol Browser appear as a stop button Components are placed A or a blue square onto the data screen and ee R ieia 32 5 assigned symbols during E g os_dba c luation board which employs the Atmel eo pone i i i z _ os_dec c AT91SAM9263 PE APOIAR this H Ar AR Design View During Run H os_probe c workspace is the source code for this example project i es 7 a Time View these probe_com c demonstrating how easily pC Probe can be used to r9 hose 4 7 d M ee oroo imoni into the behavior of your a Bi mM et components are updated probe_ts232 c embedded target a se MET eee yeaa cron ee E probe_ts232_os c i 2 i with values of those Download the code onto the target start execution the upper left tool bar in this program The components to the right labels LEDs gauges e with values oad data from Symbol Browser 32 at 115200 Contains all symbols on the target and then press the Start button on ap sb me arrears i svmbols from the taraet from the ELF files added to the workspace PES
4. you to examine information about system objects while using the C Spy debugger To gain access to this feature enable the plug in by right clicking on the project name in the work space browser and choosing Options Then select the Debugger entry in the list box and the Plug in tab pane Find the wC OS II entry in the list and finally select the check box beside the entry Options for node LPC3250 Phytec 0S Probe 5 2 x Category Factory Settings General Options C C Compiler Assembler Output Converter Setup Download Extra Options Plugins Custom Build Build Actions Select plugins to load Linker SEGGER embOS OSE Epsilon Power Pac RTOS Simulator Angel Thread GDB Server pC OS l IAR ROM monitor C Code Coverage J3 Link J Trace IORTILRTOS LMI FTDI Description RTOS awareness for CMX Macraigor RDI Third Party Driver Location C Program Files IAR Systems Embedded Workbench 5 24 Originator IAR Systems Version 5 20 0 50993 OK Cancel Figure 2 2 Enabling the pC OS II Kernel Awareness Plug In 2 02 Running the Example Applications The example project includes a basic demonstration of wC OS II and pC Probe The evaluation board components are labeled in the figures 2 3 to 2 5 The example application is the same for all AT91SAM9xxx EK boards To communicate with the board through RS 232 connect a serial cable between the evaluat
5. 12 3 uC Probe 13 Licensing 16 References 16 Contacts 16 Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs 1 Installing the Micirum Software A compiled binary example projects are provided in the self extracting executable the self extracting executable Micrium Atmel uCOS II GUI AT91SAM9xxx exe You will be prompted to accept the simple terms of the licensing agreement If you answer Yes the software will be installed on your PC under the Micrium directory from the root as shown in Figure 1 1 Micrium AppNotes AN 1018 Licensing agreements AN1xxx RTOS If uC OS II is used AN1014 uCOS II ARM If p iall AN1265 UCOS II ATMEL argisamaxxx AN265 commercially AN5xxx CUL Contact AN 5002 uC GUI Atmel AT9TSENS An 5002 www Micrium com AN9Oxxx MULT for pricing AN 9913 PROBE DEMO INTRO Licensing Software EvalBoards AT91SAM9RL Board Atmel Support Package AT91SAMORL IAR BSP AT91SAMORL IAR Binary AT91SAM9261 BSP OS Probe G Only project AT91SAM9261 AT91SAM9261 IAR ee OS Probe GUI AT91SAM9263 BSP Binary Only project AT91SAM9263 AT91SAM9263 IAR Binary Only Project BSP OS Probe GUI Figure 1 1 Directory Structure Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs 2 Using the Micirum IAR Example Project To view the example project start an instance of IAR Embedded Workbench and open e Forthe Atmel A
6. Environment General i Sereen Updat oa Target General Screen Target symbols sec bytes sec Slow queue update period sec C Calculate communication timeout automatically Wait Time ms Figure 6 2 C Probe Options Micrium pC Probe 0S Probe Workspace wsp o Home Numeric Meters Graphs Sliders Tanks Miscellaneous Switches Leds Dials Levels Task Stack Information me a ae Pointer Maximum Current Starts Ends Jalojds g a3edsYH10 M Faj iasmoig joquits G General Task Information L ugos ista RS 232 115200 COM7 2359 bytes sec 8 Figure 6 3 pC Probe Run Time wC OS II Task Information Micrium uC OS II and C Probe for the Atmel AT91SAM9RL64 CPU Licensing uC OS II is provided in source form for FREE evaluation for educational use or for peaceful research If you plan on using pC OS II in a commercial product you need to contact Micrium to properly license its use in your product We provide ALL the source code with this application note for your convenience and to help you experience pC OS II The fact that the source is provided does NOT mean that you can use it without paying a licensing fee Please help us continue to provide the Embedded community with the finest software available Your honesty is greatly appreciated References uC OS II The Real Time Kernel 2nd Edition Jean J Labrosse R amp D Technical Books 2002 ISBN 1 57820 103 9 Embedded Sy
7. Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs Micrium Empowering Embedded Systems ucC OsS II uC Probe uC GUI and the Atmel AT91SAM9xxx Processors AT91SAM9RL R64 Application Note AN 5002 www WMicrium com Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs About Micrium Micrium provides high quality embedded software components in the industry by way of engineer friendly source code unsurpassed documentation and customer support The company s world renowned real time operating system the Micrium wC OS II features the highest quality source code available for today s embedded market Micrium delivers to the embedded markeiplace a full portfolio of embedded software components that complement wC OS II A TCP IP stack USB stack CAN stack File System FS Graphical User Interface GUI as well as many other high quality embedded components Micrium s products consistently shorten time to market throughout all product development cycles For additional information on Micrium please visit www micrium com About pC OS II Thank you for your interest in wC OS II wuC OS II is a preemptive real time multitasking kernel wiC OS II has been ported to over 45 different CPU architectures and now has been ported to the Atmel AT91SAM9260 AT91SAM9261 AT91SAM9263 AT91SAM9XE and AT91SAM9RL64 R64 processors uC OS II is small yet provides all the services you would expect from
8. Name gt exe where lt Project Directory gt is the directory in which the IAR EWARM project is located extension ewp and lt Configuration Name gt is the name of the configuration in that project which was built to generate the ELF file and which will be loaded onto the target The ELF file will be named lt Project Name gt elf in EWARM v4 4x and lt Project Name gt out in EWARM v5 1x unless you specify otherwise To load this ELF file right click on the symbol browser and choose Add Symbols Configure the RS 232 Options In pC Probe choose the Options menu item on the Tools menu A dialog box as shown in Figure 6 2 left should appear Choose the RS 232 radio button Next select the RS 232 item in the options tree and choose the appropriate COM port and baud rate The baud rate for the projects accompanying this appnote is 115200 Start Running You should now be ready to run pC Probe Just press the run button p to see the variables in the open data screens update Figure 6 3 displays two screens in the pC OS Il workspace which display detailed information about each task s state Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs Options nunication Settings ication eee RS 232 O USB oer J Link d Link COM Port COM v sa T EPAP J Link Hew Target Server TCPAIP USB Baud Rate 115200 v amp Ta O TCP IP UDF Sarin baa Settings
9. T91SAM9RL EK evaluation board AT91SAM9RL OS Probe GUI BIN ewp located in Micrium Software EvalBoards Atmel AT91SAM9RL EK IAR OS Probe GUI e Forthe Atmel AT91SAM9261 EK evaluation board AT91SAM9261 OS Probe GUI BIN ewp located in Micrium Software EvalBoards Atmel A T91SAM9261 EK IAR OS Probe GUI e Forthe Atmel AT91SAM9263 EK evaluation board AT91SAM9263 OS Probe GUI BIN ewp located in Micrium Software EvalBoards Atmel AT91SAM9263 EK IAR OS Probe GUI To do this use the Add Existing Project menu command under the Project menu A IAR Embedded Workbench IDE maf Addis FAAA eS ee Add Group Import File List Edit Configurations Remove Create New Project Add Existing Project Options Source Code Control Make FF Compile Chrl FF Rebuild All Clean Batch build Stop Build Debug Make amp Restart Debugger Add an existing pre m Figure 2 1 IAR EW Opening an existing project IAR EWARM 1 Be certain to open the proper project for your version of EWARM The Atmel AT91SAM9xxx examples projects were built using EWARM ver 5 3 2 You might receive warning messages while running the debugger this is because the source code is not provided and IAR con located the files In this case the message should be ignored Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs 2 01 01 IAR pC OS II Kernel Awareness The pC OS II Kernel Awareness plug in will allow
10. all the global symbols on the target is monitored by pC Probe The user places components such as gauges labels and charts into a Data Screen in a uC Probe workspace and assigns each one of these a variable from the Symbol Browser which lists all symbols from the ELF file The symbols associated with components placed on an open Data Screen will be updated after the user presses the start button assuming the user s PC is connected to the target uC Probe currently interfaces with a target processor with a RS 232 A small section of code resident on the target receives commands from the Windows application and responds to those commands The commands ask for a certain number of bytes located at a certain address for example Send 16 bytes beginning at 0x0040102C The Windows application upon receiving the response updates the appropriate component s on the screens with the new values 4 Micripm pC Probe 4T91S4M9263 0S Probe Workspace wsp Za e a Tb ut Home Numeric Meters Graphs Sliders Tanks Miscellaneous Switches Leds Dials Levels 3 MLA Workspace E yC OS II Workspa aij OS About fal OS General Info Start Button 05 Task CPU Usag This button switches Callback Counter EA OS Task Stack Usage 5 A counter is kept in the H OS Task Info between Desig n and EENE uC Probe OS plug in callback fa OS Events which is displayed with this a OS Timers
11. an RTOS task management time and timer management semaphore and mutex message mailboxes and queues event flags a much more You will find that uC OS II delivers on all your expectations and you will be pleased by its ease of use Licensing wC OS II is provided in source form for FREE evaluation for educational use or for peaceful research If you plan on using pC OS II in a commercial product you need to contact Micrium to properly license its use in your product We provide ALL the source code with this application note for your convenience and to help you experience uC OS II The fact that the source is provided DOES NOT mean that you can use it without paying a licensing fee Please help us continue to provide the Embedded community with the finest software available Your honesty is greatly appreciated Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs About uC Probe uC Probe is a Windows application that allows a user to display the value at run time of virtually any variable or memory location on a connected embedded target The user simply populates pC Probe s graphical environment with gauges tables graphs and other components and associates each of these with a variable or memory location Once the application is loaded onto the target the user can begin uC Probe s data collection which will update the screen with variable values fetched from the target uC Probe retrieves the values of globa
12. arene n ane nnnn enna nn nn nnnnnn nnn nanan ness ena nn nas nnneennesnnasan ease obe refer to the pC Probe user manual or visit Push Buttons www micrium com LEFT RIGHT ee eee ee ee ee eee ee ee ee ee ee ee ee eee ee ee ee eee ee eee ee ee we eee ee ee ee eee Ready RS 232 115200 COM Disconnected k Figure 6 1 uwC Probe Windows Program Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs To use pC Probe with the example project or your application do the following 1 Download and Install C Probe A trial version of pC Probe can be downloaded from the Micrium website at http www micrium com products probe probe html 2 Open wC Probe After downloading and installing this program open the example pC Probe workspace for pC OS II named OS Probe Workspace wsp which should be located in your installation directory at Program Files Micrium uC Probe Target Plugins uCOS lI Workspace Connect Target to PC Currently wC Probe can use RS 232 to retrieve information from the target You should connect a RS 232 cable between your target and computer Load Your ELF File The example projects included with this application note are already configured to output an ELF file If you are using your own project please refer to Appendix A of the pC Probe user manual for directions for generating an ELF file with your compiler This file should be in lt Project Directory gt lt Configuration
13. ion board serial port DBG port and your PC and open a HyperTerminal or any Terminal program window Configure the RS 232 interface with the following settings e Bits per Second 115200 e Data bits 8 e Parity None e Stops bits 1 e Flow Control None Once the program is loaded onto the target the LEDs will start blinking Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs p ut System State Output JTA connector RS 232 for wC Probe USB Device Port wC USB Device DataFlash DataFlash i i WE t Push Buttons SD Card Socket uC FS Figure 2 3 Atmel AT91SAM9RL EK Development Board USB Host Port wC Host USB Device Port wC Device System State RS 232 for uC Probe cao P AE Ethernet connector y ae e uC TCP IP oe I Push Buttons Figure 2 4 Atmel AT91SAM9261 EK Development Board 10 Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs System State Output RS 232 for uC Probe Ethernet connector uC TCP IP a S HC GUI Jniversal graphic software for embedded applic ly CPU Any LCD Any Anntication sedis z See J Sg i Compiled Moy 5 2007 85 4135 Version of UE GUI 4 08 Micrium pesar COCOON Poterit rrer s i SUREN FE s he eo ee kbb edjs tevecerecevens MALET SD Card Socket uC FS Push Buttons Figure 2 5 Atmel AT91SAM9263 EK
14. l variables from a connected embedded target and displays the values in an engineer friendly format The supported data types are booleans integers floats and ASCII strings uC Probe can have any number of data screens where these variables are displayed This allows to logically group different views into a product A 30 day trial version of uC Probe is available on the Micrium website http www micrium com products probe probe html Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs Manual Version If you find any errors in this document please inform us and we will make the appropriate corrections for future releases Version Date By Description V 1 00 2009 04 03 Initial version Software Versions This document may or may not have been downloaded as part of an executable file Micrium Atmel uCOS II GUI AT91SAM9xxx exe containing the code and projects described here If so then the versions of the Micrium software modules in the table below would be included In either case the software port described in this document uses the module versions in the table below Module si Version Comment CC uC OS I V2 88 or C vane See Also In addition to the wC GUI projects accompanying this application note wC TCP IP and wC Host and wiC USB Device can be found on the Atmel AT91SAM9 page on the Micrium website Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs
15. plications can be loaded onto the processor via a J TAG as described in Section 2 02 Because some of the projects use volatile memory XRAM IRAM the code will not be retained when the processor is reaset or power is interrupted In order to boot from the non valtile memory a boot loader is needed IAR provides examples that allow allow to program internal flash memories as well as external flash memories such as Nandflash Dataflash Serialflash Norflash or TWI EEPROM The document flashloaders html explains all the details to integrate the boot loader in your application This document can be found in the IAR embedded workbench installation folder Program Files IAR Systems Embedded Workbench xxx arm examples Atmel flashloaders html Where xxx is the current version of the IAR EWARM In addition to the IAR bootloaders there is also a bootstrap AT91Bootstrap application for AT91SAM9 microcontrollers It can be uploaded and launched by the ROM Boot Program and can be used to configure the system and to download a larger application For more information vist the Atmel s web site Micrium uC OS II uC Probe and uC GUI for the Atmel AT91SAM9xxx CPUs 3 uC Probe uC Probe is a Windows program which retrieves the values of global variables from a connected embedded target and displays the values in a engineer friendly format To accomplish this an ELF file created by the user s compiler and containing the names and addresses of
16. stems Building Blocks Jean J Labrosse R amp D Technical Books 2000 ISBN 0 87930 604 1 Contacts IAR Systems Century Plaza 1065 E Hillsdale Blvd Foster City CA 94404 USA 1 650 287 4250 1 650 287 4253 FAX e mail Info lIAR com WEB www lAR com Micrium 949 Crestview Circle Weston FL 33327 USA 1 954 217 2036 1 954 217 2037 FAX e mail Jean Labrosse Micrium com WEB www Micrium com CMP Books Inc 1601 W 23rd St Suite 200 Lawrence KS 66046 9950 USA 1 785 841 1631 1 785 841 2624 FAX e mail rushorders cmpbooks com WEB http Awww cmpbooks com Atmel 2325 Orchard Parkway San Jose CA 95131 USA 1 408 441 0311 1 408 487 2500 WEB www atmel com
Download Pdf Manuals
Related Search