getting_started

other

Startup of the project

• hardware/software
• first run

Needed hardware/software

Needed indeed

Hard

• Nucleo L552ze-q (theoretically expandable to all boards with TrustZone)
• micro-USB data cable
• your PC

Soft

• STM32CubeIDE
• git

Optional

Hard (to use LED strips)

• RGB LED strips (non addressable, common plus), 12v (maximum 8m)
• Appropriate power supply (12v DC, >6A)
• LED controller based on the P9813: hier
  • _{^{Other controllers based on the P9813 also work, but then you have to pay attention to the voltage and current of the LEDS and the power supply.}}
• 4 Male-Male Jumper-wires
• Connection between controller and LED strip
  • Male-Female Jumper-wires

Soft (To run different versions (e.g. with or without TrustZone)).

• STM32CubeProgrammer
  • theoretically not necessary, because the CLI already comes with the IDE, if you prefer a GUI, be my guest :)

First run

1. install the CubeIDE _{^{(It doesn't matter which of the 3 supported operating systems you use.)}}
2. clone this repo into a folder of your choice (from now on called folder)
3. open the project with the CubeIDE
   • Open the CubeIDE
   • File > Open Projects From File System... > select folder/Demonstartor/ > finish
4. build projects Our project currently consists out of two parts: with and without TZEN. Those are pretty much the same, but one of them has Secureoty enabled , the other not. To Build the Secure (withTZ) Project:
   • Expand Demonstartor
   • select Secure and build with the hammer icon
   • same for Non-Secure (important: only after secure is built)
   • watch the error console and if necessary go to TroubleShooting-Guide
5. run project
   • Connect Nucleo-L552ZE-Q via micro-USB to the PC
   • Click on the arrow or the beetle to run or debug the application. -If a selection window pops up, simply select 'STM32 Cortex-M C/C++ Application' and press OK.
6. now the LEDs on the board should change between blue and green
   • Otherwise go to TroubleShooting-Guide

Further work

More PEPP by more LEDs

7. disconnect device (and power supply!) from power supply
8. wire like this:
   • 
   • _{^{The data and clock pin, can also be chosen differently, but would then have to be adjusted here (or here)}}
9. connect the power supply last
   • Everything on your own responsibility, the 12V after the power supply are normally harmless for humans (but for the board it is).
10. now the whole strip should change between blue and green ^^
    • If not see TroubleShooting-Guide to find out

Different Configs

To Flash the withoutTZ Project, you need to disable TZ
11. to disable TrustZone open the CubeProgrammer
12. set here under OB (option-bytes) RDP (Read Out Protection) to 0.5 or 1 (Never 2!)
13. at TZEN=0 now also the red LEDs should shine

Take over

If you are interested to take over not only the code via a fork, but the whole project, including Kanban-Board, Issues, Wiki and everything else, please let me know (at hanneh00@ unsere-uni-standart-addresse), then I can make you the new maintainer/owner of this repo :)

Problems?

If you have any further problems or questions, please check our Troubleshooting-Guide.