PCB bringup code instructions lacking

[martukas]

Some steps are missing in the explanation of how to run the bringup code for the RevA PCB.

In order for STM32 support to become available in the "Boards manager" interface, one must do this step first:
https://github.com/stm32duino/Arduino_Core_STM32#getting-started
More specifically, this requires one to do the following in the Arduino IDE:
File -> Settings to find the Additional Boards Manager URLs field.

Then:

• chose port
• Select "Generic STM32L4 series"
• Now it will ask you if you want to install drivers automatically, answer "Yes"
• Now Tools->Board part number and select "Generic L496ZGTx"

The rest of the settings appear to be available as described in the program comments.

When you try to open the ino program it will make you create a sub-directory called stm32_test and move the ino file there. This forces a change in the repo structure. Either the file should already be in such a subdirectory as committed, or there should be some instructions to move it elsewhere (my documents? what is the standard place arduino IDE likes to keep its stuff?) just temporarily or for the sake of deployment.

Anyway, with the above out of the way, if you now try to build it and upload it, it fails with the following message:

Sketch uses 41848 bytes (3%) of program storage space. Maximum is 1048576 bytes.
Global variables use 1808 bytes (0%) of dynamic memory, leaving 325872 bytes for local variables. Maximum is 327680 bytes.
STM32CubeProgrammer not found (STM32_Programmer_CLI.exe).
Please install it or add '<STM32CubeProgrammer path>\bin' to your PATH environment:
https://www.st.com/en/development-tools/stm32cubeprog.html
Aborting!
C:/Users/martu/AppData/Local/Arduino15/packages/STMicroelectronics/tools/STM32Tools/2.1.1/stm32CubeProg.sh: line 141: STM32_Programmer_CLI.exe: not found
Failed uploading: uploading error: exit status 127

Some googling takes us to this page:
https://github.com/stm32duino/wiki/wiki/Upload-methods#requirement

Explaining that you must download a thing from:
https://www.st.com/en/development-tools/stm32cubeprog.html

where you must register and/or log into an account to download the utility.

Now deploying seems to work, I get a buzzer beep and some blower action.

However, the code indicates that there may be some debug text coming out on a serial channel. Not sure how to configure the IDE to pick up on those...

How do you know it is wrong

It is not possible to bringup test the PCB by following the instructions. There appear to be missing steps.

Starting points

Should probably take the info that's in the ino comments, integrate it with notes from this ticket, and publish it in a README.md next to the ino file.