STM32CubeL1 Nucleo demonstration firmware
Contents
1. wa UM1804 Ts life qugmented User manual STM32CubeL1 Nucleo demonstration firmware Introduction STMCube initiative was originated by STMicroelectronics to ease developers life by reducing development efforts time and cost STM32Cube covers STM32 portfolio STM32Cube Version 1 x includes e The STM32CubeMX a graphical software configuration tool that allows to generate C initialization code using graphical wizards e Acomprehensive embedded software platform delivered per series such as STM32CubeL1 for STM32L 1 series The STM32CubeL1 HAL an STM32 abstraction layer embedded software ensuring maximized portability across STM32 portfolio A consistent set of middleware components such as RTOS USB STMTouch and FatFs All embedded software utilities coming with a full set of examples The STM32CubeL1 Nucleo Demonstration platform is built around the STM32Cube HAL BSP and FatFs middleware component and uses almost the whole STM32 capability to load and display full color bitmaps from a microSD card September 2014 DoclD026727 Rev 1 1 18 www st com Contents UM1804 Contents 1 STM32CubeL1 main features ss ss ass sae RR eee 5 2 Getting started with the demonstration 6 2 1 Hardware requirements anana ss EE se se ss se ee ee ke llle 6 2 1 1 STM32L152 Nucleo board EE Ee reinii 6 2 1 2 Adafruit TFT shield EE EE EE SE EE ee ee es 7 2 2 Hardwar2. loop If the Adafruit 1 8 TFT shield is available LED2 is turned ON because it s sharing the same pin with the SPI CLK signal used to communicate with the LCD and microSD available on the shield A menu is displayed on Adafruit 1 8 TFT describing the demonstration application as shown in Figure 7 Figure 7 Demonstration application menu NUCLEO L152RE NUCLEO L152RE DEMO DEMO Automatic Mode Manual Mode Display images Press Joystick Selected Selected stored under uSD UP for on TFT LCD Manual Mode RIGHT Next image LEFT Previous Press JOY DOWN DOWN for SEL Switch to to continue Automatic Mode automatic mode DoclD026727 Rev 1 Ly Demo functional description d User has to follow the instructions below e Press the Joystick DOWN to continue menu display see Figure 8 e Choose one of the available display modes manual and automatic using the Joystick button Automatic mode by pressing Joystick DOWN The bitmap images available on the microSD card are displayed sequentially in a forever loop Manual mode by pressing Joystick UP The bitmap images available on the microSD card are displayed by pressing Joystick RIGHT to display next images or Joystick LEFT to display previous one Pressing long 1s the Joystick SEL switches the display mode from manual to automatic Figure 8 Reading the Adafruit shield Joystick pat N It is worth noting that the application mana
3. menu assas saaana EE EE EE ee ee es 12 Reading the Adafruit shield JoystiCK EE cet 13 Demonstration application error messages EE EE EE EG EE ee ee ee ee 14 Demonstration UNNIN ae esise eaa ec eee a 14 d DoclD026727 Rev 1 STM32CubeL1 main features d STM32CubeL1 main features STM32CubeL 1 gathers together in a single package all the generic embedded software components required to develop an application on STM32L 1 microcontrollers In line with the STM32Cube initiative this set of components is highly portable not only within the STM32L1 series but also to other STM32 series STM32CubeL 1 is fully compatible with STM32CubeMX code generator that allows the user to generate initialization code The package includes a low level hardware abstraction layer HAL that covers the microcontroller hardware together with an extensive set of examples running on STMicroelectronics boards The HAL is available in an open source BSD license for user convenience STM32CubeL1 package features a set of middleware components with the corresponding examples They come with very permissive license terms e Full USB Device stack supporting many classes HID MSC CDC Audio DFU e CMSIS RTOS implementation with FreeRTOS open source solution e FAT File system based on open source FatFs solution e STMTouch touch sensing solution A demonstration implementing all these middleware components is also provided in the STM32Cu
4. ay header strip into sections to fit the holes on the edge of the shield two sections of 6 pins and two other sections of 8 pins are needed e Toalign the header strips for soldering insert them long pins down into the headers of the STM32 Nucleo board using the connectors CN5 CN6 CN8 and CN9 e Place the shield over the header strips so that the short pins stick up through the holes e Solder on each pin of the header onto the shield PCB to ensure good electrical contact The sequence is shown in Figure 4 Figure 4 Assembling the Adafruit 1 8 TFT shield www st com stm32nucleo 3 DoclDO26727 Rev 1 Demonstration firmware package 3 1 d Demonstration firmware package Demonstration repository The Nucleo demonstration is provided within the STM32CubeL 1 firmware package as shown in Figure 5 Figure 5 Folder structure El jy STM32Cube FW L1 VXY Z E _htmresc Documentation Drivers POE BSP gg CMSIS Hi STM32L1xx HAL Driver Middlewares M ST B d Third Party e Projects 0 eds STM32L100C Discovery 4 STM32L152C Discovery STM32L152D EVAL STM32L152RE Nucleo H Applications Demonstrations i Lo Binary 4 4 EWARM Wh Inc H MDCARM Media B Sr TrueSTUDIO oS readme txt j Release Notes html Examples kd Templates Ed Utilities ay CPU 4 Fonts H a Log H PC Software ttl The demonstration sources are locate
5. beL1 package The block diagram of STM32Cube is shown in Figure 1 Figure 1 STM32Cube block diagram Evaluation boards Discovery boards zio ecd Dedicated boards boards Utilities USB Host FAT file Touch TEP amp Device Graphics system library RIOS CMSIS Middleware level Utilities Hardware Abstraction Layer HAL Board Support Package BSP HAL level STM32F0 STM32F1 STM32F2 STM32F3 STM32F4 STM32L1 STM32L0 Hardware MS35672V1 DoclD026727 Rev 1 5 18 Getting started with the demonstration 2 2 1 6 18 Getting started with the demonstration Hardware requirements The hardware requirements to start the demonstration application are as follows STM32L 152 Nucleo board Adafruit 1 8 TFT shield with Joystick and microSD reference ID 802 one USB type A to Mini B cable to power up the STM32 Nucleo board from the USB ST LINK USB connector CN1 a Standard Capacity SD card SDSC with a capacity up to 4GBytes STM32L152 Nucleo board The STM32 Nucleo board is a low cost and easy to use development kit to quickly evaluate and start some development with ARM 32 bit Cortex M microcontrollers of the STM32 series STM32F103 STM32F030 STM32F072 STM32L152 and STM32L053 Before installing and using the product please accept the Evaluation Product License Agr
6. d in the projects folder of the STM32Cube package for the STM32L 152 Nucleo board The sources are divided into five groups described as follows 1 Binary demonstration binary file in Hex format 2 Media contains the media files bmp required to run the demonstration DoclD026727 Rev 1 9 18 Demonstration firmware package 3 2 3 2 1 3 2 2 10 18 3 Inc contains the demonstration header files 4 Src contains the demonstration source files 5 Project settings a folder per toolchain containing the project settings and the linker files Nucleo board BSP For each board a set of Button LED and Joystick drivers is available within the stm32l1xx nucleo c h files implementing the board capabilities and the bus link mechanism Figure 6 Nucleo BSP architecture BSP Adafruit Shield 9 Release Notes html stm32 adafruit Icd c stm32 adafruit Icd h stm32 adafruit sd c stm32 adafruit sd h Components fj Common S d stim75 9 Release Notes html E stlm75 c stlm75 h jy STM32L x Nucleo amp Release Notes html L stm32l1xx nucleo c L stm32l1xx nucleo h Joystick The 5 way joystick on the shield is based on a resistor trick to permit all the switches to share one analog pin Each movement of the joystick control connects a different resistor and results in a different voltage reading The ADC peripheral is configured within the stm32 1xx nucleo c h driver i
7. e configuration 2c ss EES e md ERR ER ACER Reb tied teases 7 2 2 1 STM32 Nucleo board configuration llle 7 2 2 2 Assembling the Adafruit shield 0 0 2 ee eee 8 3 Demonstration firmware package leeeeeeess 9 3 1 Demonstration repository iii Es ER RE EE ER ER RR RE ER Ra Re ee 9 3 2 Nucleo board BSP EE EG GE eee 10 3 2 1 JOYSUCK RE OE EN ER EE OE EE Og 10 3 2 2 Hoor EE EE EE EE EE N EG 10 3 2 3 MICROSD ase eee d Red e ed b ah a e Se ad Red 11 4 Demo functional description sssessssns 12 4 1 Programming firmware application llle 14 5 FAQS FT 16 6 R vision history is Mey E EER ES EE REM e piae EES se 17 2 18 DoclD026727 Rev 1 Ly UM1804 List of tables List of tables Table 1 Bitmap image properties EE EE EE EE EE ee ee ne 12 Table 2 Document revision history ie 0 00 cece tees 17 DoclDO26727 Rev 1 3 18 d List of figures UM1804 List of figures Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 4 18 STM32Cube block diagram 0 2 nn 5 STM32L152 Nucleo board EE EE EE Se EE ee ee ne 6 Adafruit 1 8 TFT shield EE cece eee 7 Assembling the Adafruit 1 8 TFT shield EE EE ee 8 Folder Structure ss ads see RED ER RE a GEN ie ek PRU ben bb RENEE EE 9 Nucleo BSP architecture EE EE Ee ee GE tees 10 Demonstration application
8. e names are the property of their respective owners Information in this document supersedes and replaces information previously supplied in any prior versions of this document 2014 STMicroelectronics All rights reserved d 18 18 DoclD026727 Rev 1
9. eement available at www st com epla For more information on the STM32 Nucleo board visit www st com stm32nucleo Figure 2 STM32L152 Nucleo board d DoclD026727 Rev 1 Getting started with the demonstration Note 2 2 2 2 1 d Adafruit TFT shield The STM32 Nucleo board supports Arduino connectivity This Adafruit 1 8 TFT shield may be found on the Adafruit website reference ID 802 with the following features e one 1 8 TFT display with 128x160 color pixels e one microSD card interface slot e one 5 way joystick navigation switch left right up down select Figure 3 Adafruit 1 8 TFT shield NavSu oo lt P n 1 r a sS d RST ma ma LAB AAR b s m 3v Sv Gnd Vin e ee _ This shield is just an example of Arduino shield usage you can get more details on Adafruit website Hardware configuration In addition to gathering the hardware please follow the recommendations below to start using the Adafruit 1 8 TFT shield with the STM32 Nucleo board STM32 Nucleo board configuration Check jumpers positions on the STM32 Nucleo board as follows e JP1 OFF e JP5 PWR on U5V side ON e JP6 lpp ON DoclD026727 Rev 1 7 18 Getting started with the demonstration 2 2 2 8 18 Assembling the Adafruit shield The Adafruit TFT shield comes with all surface mount parts pre soldered User can install the headers following the next steps e Cut the breakaw
10. ges some errors refer to Figure 9 that can occur during the access to microSD card to load the bitmap images e fthe microSD card is not FAT formatted a message will be displayed on TFT In this case format the microSD card and put into its root directory the bmp files available within the FW package under Media folder e fthe content of the microSD card is other than a bitmap file a message will be displayed on TFT mentioning that it is not supported User has to ensure that the files available under the microSD card root directory are respecting the above described bitmap properties DoclD026727 Rev 1 13 18 Demo functional description 4 1 14 18 Figure 9 Demonstration application error messages SD Card is not Open directory FAT formatted Cannot mount File type is not fails Please Format the FatFs on Drive supported microSD card Figure 10 Demonstration running Programming firmware application To program the STM32 Nucleo board with the demonstration application please proceed as follows 1 Install the preferred Integrated Development Environment IDE 2 Install the ST LINK V2 1 driver available on ST website There are two ways of programming the STM32 Nucleo board e Method d DoclD026727 Rev 1 Demo functional description 3 Upload the STM32CubeL1_Demo_Nucleo hex from the firmware package available under Projects STM32L152RE Nucleo Demonstrations Binar
11. his demonstration application we will show how to use the STM32CubeL1 firmware package with either the NUCLEO L152RE board and the Adafruit 1 8 TFT shield to display a 128x160 pixel full color bitmap from a microSD card using the FatFs file system To start with this demonstration application user has to copy the provided 128x160 pixel bitmap pictures available within the FW package under Media folder to the root directory of a FAT formatted microSD card and insert the microSD card into the Adafruit shield microSD holder Note that the microSD card can have a storage capacity up to 4GBytes SDSC and that the bitmap images must have the properties detailed in Table 1 Table 1 Bitmap image properties Dimensions 128 x 160 Width 128 pixels Height 160 pixels Bit depth 16 Item type BMP file Name Must not exceed 11 characters including omp extension Once started the application checks the availability of Adafruit 1 8 TFT shield on top of STM32 Nucleo board This is done by reading the state of IO PB 00 pin mapped to Joystick available on the shield If the state of PB 00 is high then the shield is available If the Adafruit 1 8 TFT shield is not available the LED2 is toggling with a frequency equal to 1Hz A second press on the User button lets LED2 toggling with a second frequency equal to 5Hz The third press changes LED2 toggling frequency to 10Hz The described process is done in an infinite
12. n order to get analog voltage values through the analog VO pin 3 The BSP JOY GetState function reads the analog pin and compares the result with 5 different ranges to determine which if any direction the stick has been moved left right up down select LCD The LCD available on the Adafruit 1 8 TFT shield uses 4 wire SPI to communicate with the STM32L chip Digital VO pins 13 11 10 and 8 and has its own pixel addressable frame buffer to display text shapes lines pixels etc DoclD026727 Rev 1 Ly Demonstration firmware package The SPI peripheral is configured within the s m32 1xx nucleo c h driver which contains also the SPI bus link mechanism and IO operations The LCD is controlled by a dedicated BSP LCD driver stm32 adafruit Icd c h which uses the st7735 component that exports in a generic way the LCD IO operations needed for its process 3 2 3 MicroSD The microSD slot available on the Adafruit 1 8 TFT shield uses 4 wire SPI to communicate with the STM32L 1 chip Digital VO pins 13 12 11 and 4 The SPI peripheral is configured within the stm32 1xx_nucleo c h driver which contains also the SPI bus link mechanism and IO operations The microSD is controlled by a dedicated BSP SD driver stm32 adafruit sd c h which exports in a generic way the SD IO operations needed for its process DoclD026727 Rev 1 11 18 d Demo functional description 4 12 18 Demo functional description In t
13. ry the bitmap files cannot the accessed by the demonstration application The File type not supported error message is displayed on the LCD To make it work you have to add the new directory path within f open and f opendir FatFs APIs calls under the fatfs storage c file 3 DoclD026727 Rev 1 Revision history d Revision history Table 2 Document revision history Date 02 Sep 2014 Revision 1 Initial release Changes DoclD026727 Rev 1 17 18 UM1804 IMPORTANT NOTICE PLEASE READ CAREFULLY STMicroelectronics NV and its subsidiaries ST reserve the right to make changes corrections enhancements modifications and improvements to ST products and or to this document at any time without notice Purchasers should obtain the latest relevant information on ST products before placing orders ST products are sold pursuant to ST s terms and conditions of sale in place at the time of order acknowledgement Purchasers are solely responsible for the choice selection and use of ST products and ST assumes no liability for application assistance or the design of Purchasers products No license express or implied to any intellectual property right is granted by ST herein Resale of ST products with provisions different from the information set forth herein shall void any warranty granted by ST for such product ST and the ST logo are trademarks of ST All other product or servic
14. y using your preferred in system programming tool e Method2 Choose one of two supported tool chains IAR Keil and follow the steps below Open the application folder Projects STM32L152RE Nucleo Demonstrations Chose the desired IDE project EWARM for IAR MDK ARM for Keil Double click on the project file for example Project eww for EWARM Rebuild all files Go to Project and select Rebuild all Load the project image Go to Project and select Debug Run the program Go to Debug and select Go The demonstration software as well as other software examples that allow you to discover the STM32 microcontroller features are available on ST website at www st com stm32nucleo DoclD026727 Rev 1 15 18 FAQs 16 18 FAQs How can use this application to display my own images Use any image editing tool and crop your image to no larger than 160 pixels high and 128 pixels wide Save it as a 16 bit color BMP format file Can display more bitmap files Yes You can display more pictures by copying them under the microSD root directory Just modify the define value of MAX BMP FILES constant to the desired number of files In this case you must fine tune the FS LOCK value defining the number of files that can be opened simultaneously under ffconf h the FatFs configuration file What about putting the bitmap files not under the root directory of the microSD Once put under another folder different from the root directo
Download Pdf Manuals
Related Search