STM32-Primer
Contents
1. e ST7637 Datasheet This document describes the 65K 132x132 color dot matrix LCD controller driver and is available from http www sitronix com tw e The PZGISBW SCLW pdf document describes the characteristics for the 128x128 display of the STM32 Primer This document is available from your Ride7 environment e The full GNU Compiler Collection GCC manuals are available from the Ride7 environment Please visit the Circle community web site at http www stm32circle com for more resources User Manual STM32 Primer 3 Getting started 3 1 Connect battery charge and power up 1 Open the Primer s case by pulling the top and bottom halves of the case apart There are no catches or releases that hold the case together 2 Fit the jumper so that it straddles the two pins to connect the power supply 3 Close the case 4 Connect the Primer to the USB port on a PC to charge its battery 5 After charging the battery press the push button to activate the Primer 3 2 Play 1 After the opening screen is displayed press the push button to call the main menu 2 Tilt the Primer backward forward to navigate in the menu use the push button to select a menu command Initial menu items include Config Configure parameters for the Primer including the pointer backlight for the LCD display and time Maze Start the maze game Note that this menu item depends on the application that 1s selec2. SWD and JTAG debug interfaces Fast input output up to 80 IOs ADC DAC Embedded communication peripherals USB 2 0 CAN USART SPI I2C LIN Multiple timers watchdog PWM Systick timer 2 4 3D accelerometer The STM32 Primer is equipped with a MEMS inertial sensor LIS3LVO2DL from STMicroelectronics This device is used by the STM32 Primer as a human interface device to select commands in coordination with a graphic pointer When you start the STM32 Primer for the first time you will see a small ball moving according to the orientation of the STM32 Primer circuit The information about the 3D position is provided by the MEMS You will find complete documentation of the 3D accelerometer on the companion CD ROM Examples are provided that allow evaluation of various functions of the MEMS usage User Manual STM32 Primer 2 5 Power supply The STM32 Primer features a 2 4V rechargeable battery The following figure shows the general principle of the power supply schematic the complete STM32 Primer schematics are available in appendix A CCE Cortex VCC5_RiLink fy BTI 24W NIMH When one USB connector is linked to a PC host either the RLink or the STM32 the 5V voltage supplied by the PC is used to recharge the batteries When no USB host is connected the battery is used to supply the power for the STM32 Primer When the batteries are fully charged the Primer can be used for about 2 hours The dura
3. The included firmware CircleOS task scheduler system services and demonstration applications implements low level functions driving the various STM32 peripherals In addition it includes features for dynamic loading and management of new applications All firmware demos C sources and projects and more future applications are available for free download at the STM32 Primer dedicated site http www stm32circle com The Primer and Ride7 software toolset provide everything needed for programming the STM32 and debugging applications including e USB host connection for in circuit programming and debugging e Ride7 integrated development environment for code editing device programming and application debugging debug up to 32K of code with included version For information about upgrade to an unlimited version of Ride visit http www stm32circle com resources e GNU C C compiler unlimited compiling User Manual STM32 Primer 2 The STM32 Primer hardware 2 1 List of Contents You will find when opening the box The STM32 Primer in its plastic case A USB cable for host PC connection that can be used to program and debug the STM32 microcontroller Alternatively this cable can be used to communicate with the STM32 Primer if you program a USB client application A CD ROM containing Ride7 for ARM and all the STM32 Primer documentation 2 2 Description 3D accelerometer DEBUG USB connector STM32 Graphic display
4. Push Button STM32 USB connector The STM32 Primer provides the following devices An LCD color monitor 64K colors 128x128 pixels 2 USB connectors O One marked Debug to connect to a PC running Ride for application development O One marked STM32 that allows the embedded application to communicate with an external USB host One push button to switch on the power supply and to launch menu commands One accelerometer MEMS that captures the 3D position information related to the STM32 4 User Manual STM32 Primer Primer and which 1s used to navigate through the menus and to move the pointer e Note that 2 footprints on the printed circuit could receive some optional interface components e One IrDA transmitter top side close to the Debug USB port that allows communication between two STM32 Primer e One extra connector is linked to some unused I O pins of the STM32 in order to add extra peripherals hs Opening the plastic case of the STM32 Primer is easy no screw no clip Just separate the two halves of the case and remove the board User Manual STM32 Primer 2 3 STM32 microcontroller features The STM32 Primer is equipped with an STM32F103B6 one of the new ST Cortex based 32 bit microcontrollers The main characteristics of this device are ARM 32 bit Cortex M3 CPU 72 MHz 90 DMips with 1 25 DMips MHz 128KB of Flash program memory 20KB SRAM Embedded oscillators for high speed quartz RTC
5. a database where the members can share their applications with the stm32circle community An application can include both the source files and the object files or the object files An application is generally made of one object file but may occasionally have several of them The linking of the application in such a case can be done either using the circle_megr exe software available in the RIDE7 INSTALL DIR bin directory or within the Ride7 environment When an application is split into several object files these object files must be placed in a library in order to pass a unique filename as an argument to circle_mgr exe 4 8 Restoring the factory configuration If you have been experimenting with CircleOS applications and have modified your STM32 Primer configuration you may want to restore the initial factory configuration In order to do this please follow these steps 1 Connect your STM32 Primer s debug USB port to your PC 2 Power up your STM32 Primer by pressing its button 3 Open a command prompt from Windows Navigate to Start Programs Accessories Command prompt 4 Change the current directory to the Ride7 installation directory This can be done with the following command adapt it to your actual configuration if you did not install Ride7 1n its default location cd C program files Raisonance Ride 5 Now change the current directory to the STM32 specific library directory This can be done
6. equipment in standard trash receptacles For more information about disposal and recycling of electronic goods please refer to http www raisonance com support weee php 22
7. example installed with the Ride7 Kit ARM This example can be loaded in Ride7 using a shortcut placed in the Start Menu The example full path is RIDE7 INSTALL DIR Examples ARM Primer STM32 toggle with CircleOS toggle with CircleOS rprj It makes use of the CircleOS operating system provided as a library circle elf that is described in the next chapter Follow these instructions to modify the example 1 Open the example Start gt Programs gt Raisonance Tools gt Ride7 gt STM32 Primer gt STM32 Primer Startup Project Plug the Primer Debug USB port into the PC using the USB cable and follow the Windows USB installation 2 Launch the Debug mode EF S 3 Run the program gt In the main menu on the Circle choose toggle As you can see the application just toggles the green led to red Now we will modify the program to make the buzzer beep at each led toggle 4 Exit the debug mode ae Open the toggle example C file Project x Just double click on the toggle With CircleOS c in the ul 2 show project window E fo Project toggle_with_Circeos H Br toggle_with_Circle05 text 456 data fc toggle with CircleoS c fexst 364 dar al Circle lF p FAT elf 6 Add in the code if itoggle_ count gt MAX TOGGLE COUNT i toggle count U CurrenthLedMode CurrentLedMode LED OW 2 LED OFF LED OWN LED Set LED GRE
8. o Time This sets your STM32 Primer time Note that the RTC clock will remain valid even if your STM32 Primer is shut off o Test This performs a quick factory test of the STM32 Primer You can add more applications to your STM32 Primer by downloading them on the web site www stm32circle com projects Refer to the chapter 4 4 Managing applications on your STM32 Primer 3 3 Install the Ride7 software toolset for ARM The CD ROM contains many resources to help you evaluate the STM32 family e The RLink driver that needs to be installed in order to program erase the applications e Ride7 the Raisonance IDE to write and debug new applications e The complete GNU software toolchain based on the GCC compiler which is fully integrated into Ride7 e Some utilities to manage your Circle applications Circle is the OS embedded on your STM32 Primer refer to Chapter4 1 CircleOS architecture for details e Documentation Datasheets user manuals for the different components of the STM32 Primer To install 1 Insert the Raisonance mini CD ROM on your PC a menu will appear 2 Select Install ARM Toolset from the menu It will install all the required resources on your PC including the RLink driver required for connection on the Debug USB port of your Primer Note Install Ride7 before connecting to this USB port 10 User Manual STM32 Primer 3 4 Modify an STM32 application example In this chapter we will modify an
9. with the following command cd lib ARM CircleOs 6 Erase your STM32 Primer reprogram it with its factory ROM image which is in the circle hex file Then restart the device These operations can be done with the following single command c rtex pgm TSTMS2Fr103RBI6 E Pcircl e hex Ss The TSTM32F103RBT6 option selects the appropriate device The E command erases the ROM The Pcircle hex command programs the device with the proper hex file The S command restarts the device These operations take approximately 30 seconds 18 User Manual STM32 Primer 4 9 Resetting your STM32 Primer In case you need to reset your STM32 Primer several mechanisms can be used a Hardware reset 1 Remove any USB cable 2 Open your STM32 Primer s case to temporarily remove the battery jumper which is on the back side 3 Replace your battery jumper close the case of your STM32 Primer and restart it by pressing its button b Software reset A software reset will erase all the flash memory in your STM32 Primer and all applications and the CircleOS will be suppressed 1 Connect your STM32 Primer s debug USB port to your PC 2 Power up your STM32 Primer by pressing its button 3 Open a command prompt from Windows Navigate to Start Programs Accessories Command prompt 4 Reset your STM32 Primer using the cortex_pgm exe utility installed in RIDE7 INSTALL DIR bin directory This must be done with the following c
10. EN CurrentLedMode LED Set LED RED CurrentLedMode BUZZER SetMode BUZZER SHORTBEEP 7 Launch the Debug mode mk Uk 8 Run the program gt 11 User Manual STM32 Primer 4 Managing your CircleOS applications 4 1 CircleOS architecture The STM32 Primer is equipped with an STM32F103 that contains 128KB of FLASH and 20KB of RAM The STM32 Primer embeds the CircleOS operating system source files are available on www stm32circle com web site It provides services that will help you develop your STM32 Primer applications including e Application management e LCD graphic functions e Mems functions e LED Buzzer and Push Button functions e Menu functions Scheduler task CircleOS can load several independent applications Each application is run by CircleOS when selected has the full availability of the CPU and can use all the RAM that is not being used by CircleOS i e 16KB in the memory address range from 2000000h to 20003FFFh It will be scheduled by the CircleOS with full privileges on the device until it explicitly quits 12 User Manual STM32 Primer 4 2 The CircleOS Scheduler CircleOS acts in several stages An initialization stage which occurs upon device reset a periodic systick interrupt and the scheduling of applications a lnitialization stage During the initialization stage the hardware Reset Exception configuration 1s performed an
11. STM32 Primer Fun easy introduction kit for STM32 microcontrollers User Manual July 2007 RAISONANCE Table of Contents Presco 110210 8 8 Ree ee een ee mn ee ne eee ee 3 2 Ae IVS 2 Primer NIWA tetas a is eae s ied tedtecacnd aig ed O 4 PLIST Or COMENTS cane i E ae AERE E EEE A E E T A 4 PAP TE CRMC 1 AEREE AE E EE EIEN A E A E EN E EA T E T A 4 23 SLM Zm rocontro ller aeS o E O 6 Di ACO TO INN Ue ae O E E O E TOT 6 De OWE SUD Dy aru a a a a ee ee 7 26 For RET MAL OMMALIO Migs cig integrins nections untested na cael sate lan Setanta lat anni aia caty 7 Df Geine SEd esn a E T 9 Jl Connect batery Charee and DOWEL UP cererii an a T eae eee te 9 eTA A A EEE EE A E E E EE E E A AS 9 3 3 Install the Ride7 software toolset for ARM ccccssssssessesseseeccecceesseeeeeeaeeseeesaeaeees 10 3 4 Modity an SIM application examp esne E errata eaee eaten aerate ee 11 4 Managing your CircleOS applicationS eeeeeeeeeseeseeeeeeeeeeeeeeeeereeeerereeeeeeeeeereerererereeeeressssereesss 12 AICOS ALC MIL CLUS en a a a A ee iautaae ts 12 42 The CircleOS Schedule E di tavandeiatetateaet ata a O ts utes 13 EL TIM ALI ZAI OM SA OC ea E T vcdles vas eam acieloe neds 13 I PTO CIC Sy SC Ke MLS I oeni E EE NR 13 C App ICaOn SCMCOUICE aussirre E AE ae yeh aasetaedene stn gestae ehoe eaeeateaae 14 Op CATCH 7 VI CU ORY Ma Prsia a ee ea oasis O ES 14 44 Resources used by CircleOS reran ne nee a a oes 15 4 5 Managing applications
12. d the periodic Yy system timer systick is installed Initialization e MEMS Init etc The systick period depends on the RCC settings it can be modified through the menu Config CPU Speed to the following predefined values CPU freq Systick Freq 18MHz 0 75 KHz Systick Interrupt BUZZER_Handler 36MHz 1 5KHz Periodic MENU_Handler Actions e etc A8MHz 2KHz The CPU_ freq SysTick 24000 ratio is applied for all these values b Periodic systick interrupt The periodic systick makes a call to the CircleOS systick interrupt handler This interrupt handler will perform a short processing on each of the STM32 Primer components LEDs button buzzer MEMS LCD etc 13 User Manual STM32 Primer c Application scheduler CircleOS is the base application of your STM32 Primer It will handle the menu selections and react to user actions Once an application is run usually through a menu selection CircleOS will first call an initialization routine for the application then will repeatedly call the application handler at the Systick frequency until it returns a MENU LEAVE value You will find more details about programming CircleOS applications in Chapter 5 Developing CircleOS applications 4 3 CircleOS Memory map The CircleOS firmware requires 24KB of FLASH and 4KB of RAM including the stack usage for the applications The remaining 104KB are availabl
13. e for applications which can be added or removed at will using a programming tool see below Flash memory can be programmed in 1 KB blocks only The following figure shows an example of memory mapping Flash 128KB 0x0801FFF u Li Man D 0x08015000 v 0x08014000 eg 0x08012000 R A M D a 20 KB E 0x0800A000 0x20004FFF pe OS 4KB g 0x08009000 0x20004000 see 0x08008000 S 2a 0x08006000 O eN T m i E 0x08000000 0x20000000 14 User Manual STM32 Primer 4 4 Resources used by CircleOS The following figure Courtesy of Bob Seabrook shows which peripherals are used by CircleOS and their respective usage Circles 1 7 Peripherals used by CircleOS Shee onte STM32F103xx Performance Line Block Diagram ns EEr e EEr POWER JNTRS Voo 2 to 36V VOLT REG am 4 3 TO 1 8V Ves JTD CORTEX M3 CPU JTCKISWCLK FLASH 128 KB z JTMSIS WIO 64 bit VDD JTG Fanmi Fa MHZ adk as AF 3 SRAM E z 20 KE i von aa PCLKA OS C_IN a PLL amp XTAL OSC OSC OUT agua ria CLOCK E 4 16 MHz Battery amp Temperature T channels FCLK MANAGT 7 sel RC 8 MHz WDG i Standby EDDA interface r ir NRST VBAT i cee OSC32_IN oe AHB AHE OSC OUT APB2 APB ANTI_TAMP S0AF Expansion EMS dag dongle button 0 PA 1S 0 4 Channels J BUZZEF MEME lcd bl tag dongle leds PENSOS buzzer d Ch anmes Ch 3 lod datatcontrol POSM 6 Ch tg Che Icd neS backlight RA TA CTS RTS S
14. l o Linking file Ce tmp Level Ox Link of C tmp level o succeeded Hex file generated Blank checking the FLASH area OK Programming tile tmp ld nex to Tlash OK Registering application in FAT OK Erase E circle mgr exe EMaze remove only Maze Eappname Circle mgr e E remove ALL apps Wait W When a command list is launched through a batch file the W command allows you to pause the execution and to check the intermediate results Caution Any hex file can be programmed to the FLASH memory of your STM32 Primer using the cortex_pgm exe utility However doing this will destroy your CircleOS firmware and you will have to reinstall it if you wish to use it later refer to chapter4 8 Restoring the factory configuration for details 16 User Manual STM32 Primer 4 6 Selecting the current application One application is considered to be the current application The ID of the current application is saved in the backup memory From the main menu you can launch it directly To change the current application select the Application command from the main menu Then select the application you wish to specify it as the current application and push the button The new current application name will now appear in the main menu 17 User Manual STM32 Primer 4 7 Downloading new applications You will find on the http www stm32circle com projects Circle web site
15. martCard as AF AX TX CTS ATS Smartcard as AF ems POPS PENE e7 MOS MISO SCR NSS as AF MES 5 a SDA SMBAL 4 Channels 2 compl Channels jae Brk input THI MOSLMISO AAt SCK NSS as AF rt SPH Sn RX TX CTS RTS SmartCard as AF 4 USART1 T F a LF g Ei ao a i a lt gt can USBDP CANTX VODA USBOMTCANRE USB 2 0 FS ao te lt gt _use208s ve lt gt SRAM 5128 Vorr WW DG Chi16 tadci lt wos Temperature Temp sensor 15 User Manual STM32 Primer 4 5 Managing applications on your STM32 Primer The applications can be managed by the circle _mgr exe utility You will find it in the TRIDE7 INSTALL DIR Bin directory This utility dedicated to the STM32 Primer allows e Listing of the currently loaded CircleOS applications e Adding of new CircleOS applications e Removing of CircleOS applications e Checking how much FLASH memory is available Refer to the http www stm32circle com web site for more information about this utility The following commands are available with the circle _mgr exe utility Command Syntax Description List L List the loaded applications The following information will be output circle mgr exe L Reading FAT table AppO Name Maze Addr 0x08006000 Size 8KB Appl Name Breakout Addr 0x08008000 Size 4KB Largest free block 92KB Add Afilename Add anew application object file circle mgr exe Ac tmp leve
16. ommand cortex pgm S To reload the initial program use the following command Cortex pom exe ToMsZrluskBio E PstmoZprimerl lwhex os where stm32primer1 1 hex is the full application which is available on the web site 19 User Manual STM32 Primer 5 Developing CircleOS applications The full source files of CircleOS are available on the http www stm32circle com web site Once registered you will be able to download them along with many resources for developing your application The games originally delivered with the STM32 Primer show working application examples 9 1 Libraries Some common services are offered to ease your development of CircleOS applications e The STM32 libraries written by ST provide access to the embedded peripherals such as timers ADC communication interfaces thermometer etc of the STM32 microcontroller e The low level CircleOS functions that provide an easy access to the STM32 Primer s on board peripherals 3D accelerometer LCD monitor button buzzer battery LEDs e The graphical functions that provide powerful high level functionality Menu management pointers linked to the 3D accelerometer character maps sound The source files of these libraries can be found On the CD or on the ST web site for the STM32 libraries Specific documentation about the STM32 library is also available On the http www stm32circle com web site for the CircleOS libraries registra
17. on your STM32 Primet ccccccccccccceeceeeeeeeeaeeeeeeseeseeeeeeeeeas 16 AO SCICCLING TNE CUIPEML APP I CALON i std tena cele alate crea Slated edie ale aac dus ales ater chia 17 A Downloadine NEW ADPHCATIOMS wigs cies ceed oan S aaa ee wea asa a 18 4 8 Restoring the factory CONfIQUIATION ec ccccccscsseeeeeeseeeeeeececceeeeeeeesssausseeseeeeeeeeeeeeeeas 18 AO Resetin e your STM 2 Princesse ict scciaaeatsaet ae OE 19 a Hardware TESE eac uor a A idavaae Oa 19 ID SOUT ALS TCS a a E E once teens etecsenosabe aes 19 JDeveloper OS APPNCALIONS area ade E N a 20 SAE oe ae A E E N EE E E EATE EEEE TERTA EEA 20 5 2 Developing your first CircleOS application sesasine E NNS 20 523 Debuseine your applicators nereko a n EEE neces 21 5 4 Sharing your application with the Circle COMMUMNItY cc ccccsssecceeeeeeceeeaeeeeeeaeees 21 Og TG Sy Ch 8 coed E nc Secs taeda tata stage A e ae 22 User Manual STM32 Primer 1 Presentation The STM32 Primer is an innovative low cost evaluation and development package that is designed to provide a fun and easy introduction to the features of the STM32 with ARM Cortex MS3 core The Primer s ergonomic design with MEMS based controls navigate by tilting the tool left right backward or forward and LCD display provide fun and easy control of the included demonstration firmware that includes graphical user interface and games based on the resources of the STM32 microcontroller
18. ted in Applic Applic Select an application to run The application that you choose will then appear in the main menu Shutdown Turn off the Primer To restart the Primer simply press the push button Note When you receive the Primer the MEMS based controls are calibrated to a zero position that matches a 30 angle from the horizontal corresponds to the position of a book when reading To practice controlling the Primer move the blue dot around the main screen It takes a little practice Preinstalled applications The Primer includes pre installed applications e Maze A game where the player navigates inside a labyrinth eating dots to win points while avoiding ghosts e Breakout A game where the player uses a paddle to bounce a ball against a wall of blocks destroying the block to win points Win the game by destroying all the blocks e Configuration Configuration and test applications have been pre installed in order to check your STM32 Primer s capabilities From the main menu of the STM32 Primer launch the Config command The following parameters can be set User Manual STM32 Primer o CPU Freq This lets you choose the speed of your STM32 Primer o Backlight This lets you tune the backlight intensity Note that the backlight is the main source of power consumption with the LCD monitor itself Reducing the backlight intensity allow to extend the duration when Primer is powered by the battery
19. tion required Their documentation is accessible from Ride7 5 2 Developing your first CircleOS application Creation of a CircleOS application is done automatically in Ride7 9 Navigate to Project New project 10 Leave the Type selection list to New application 11 In the Processor selection list select the STM32F103RBT6 CircleOS device 12 Select an application name such as My CircleOS application 13 Define the location where your new project will be created 14 Click the Finish button Your new project will be created with an application containing a CircleOS application skeleton as well as the Circle elf and FAT elf files necessary to connect your application to CircleOS 1 Open the Application c file 2 Search for the Application Name variable in the file 3 Change the Application Name value from My App to HELLO 4 Inthe Application Handler function create a new string as follows const char msg Hello World Use the DRAW DisplayString CircleOS service to display the msg string variable you just created on the STM32 Primer display DRAW DisplayString 5 20 msg sizeof msg X Y string length 6 Connect your STM32 Primer to your PC using the USB cable be sure to use the debug USB port of your STM32 Primer GN 20 User Manual STM32 Primer 7 From Ride go to Debug Start which will program your application to
20. tion of the batteries depends on the Primer activity For instance it can be extended or reduced by changing the setting of the backlight intensity see the menu Settings Note The battery load mechanism of the STM32 Primer 1s limited It just applies a voltage to the battery in order to charge it without any control over the delivered current This is enough for demonstration and evaluation purposes but this should not be applied to a project intended for commercialization Full recharging of the battery takes 16 hours and it is recommended to remove the battery jumper after charging if your Primer will remain connected to your PC for application development 2 6 For further information This document describes the STM32 Primer basic use and its hardware and firmware features Further information about tools intended for use with the Primer may be found in e LIS3LVO2DL MEMS Inertial Sensor Data Sheet available from http www st com e STM32F103 Performance AC Line available from http www st com e STM32F10x Flash programming manual available from http www st com e STM32F10x advanced ARM based 32 bit MCU reference manual available from http www st com e STM32F10x Datasheet available from http www st com e The Cortex M3 Technical Reference Manual document describes the Cortex M3 Core 7 User Manual STM32 Primer and is available directly from http www arm com
21. your STM32 Primer This may take about 15 seconds 8 Go to Debug Run 9 On your STM32 Primer select your application name on the main menu Your application is now on your STM32 Primer For further information about CircleOS application programming and available OS services please visit http www stm32circle com 5 3 Debugging your application In order to debug your application you must go to Project Properties in Ride7 In the Configuration selection box Circle Debug and Circle Release are available Make sure you select the Circle Debug configuration which 1s the default Ride7 will take care of all the settings required for switching between debug and release mode through the use of these configurations The standard STM32 Primer is limited to debug in the first 32KB only A software key can be purchased on http www stm32circle com to allow debugging in the whole 128KB of memory 5 4 Sharing your application with the Circle community Once your application works properly you can share it with the other members through the http www stm32circle com community 21 User Manual STM32 Primer 6 Recycling As part of our continuing efforts to proved the best service to our users an communities Raisonance is actively defining take back and recycling programs for EU customers as part of the implementation of the European WEEE directive This symbol is a reminder not to dispose of your electronic
Download Pdf Manuals
Related Search
STM32 Primer stm32 primer2 stm32 primer