69 lines
2.5 KiB
ReStructuredText
69 lines
2.5 KiB
ReStructuredText
.. _target-stm32f429i-disc1-stm32cube:
|
|
|
|
---------------------------
|
|
stm32f429i-disc1: STM32Cube
|
|
---------------------------
|
|
.. warning::
|
|
This target is in a very preliminary state and is under active development.
|
|
This demo gives a preview of the direction we are heading with
|
|
:ref:`pw_system<module-pw_system>`, but it is not yet ready for production
|
|
use.
|
|
|
|
|
|
The STMicroelectronics STM32F429I-DISC1 development board is currently Pigweed's
|
|
primary target for on-device testing and development. This target configuration
|
|
uses :ref:`pw_system<module-pw_system>` on top of FreeRTOS and the STM32Cube HAL
|
|
rather than a from-the-ground-up baremetal approach.
|
|
|
|
-----
|
|
Setup
|
|
-----
|
|
To use this target, Pigweed must be set up to use FreeRTOS and the STM32Cube HAL
|
|
for the STM32F4 series. The supported repositories can be downloaded via
|
|
``pw package``, and then the build must be manually configured to point to the
|
|
locations the repositories were downloaded to.
|
|
|
|
.. code:: sh
|
|
|
|
pw package install freertos
|
|
pw package install stm32cube_f4
|
|
pw package install nanopb
|
|
|
|
gn args out
|
|
# Add these lines, replacing ${PW_ROOT} with the path to the location that
|
|
# Pigweed is checked out at.
|
|
dir_pw_third_party_freertos = "${PW_ROOT}/.environment/packages/freertos"
|
|
dir_pw_third_party_stm32cube_f4 = "${PW_ROOT}/.environment/packages/stm32cube_f4"
|
|
dir_pw_third_party_nanopb = "${PW_ROOT}/.environment/packages/nanopb"
|
|
|
|
Building and running the demo
|
|
=============================
|
|
This target has an associated demo application that can be built and then
|
|
flashed to a device with the following commands:
|
|
|
|
.. code:: sh
|
|
|
|
ninja -C out pw_system_demo
|
|
|
|
openocd -f targets/stm32f429i_disc1/py/stm32f429i_disc1_utils/openocd_stm32f4xx.cfg -c "program out/stm32f429i_disc1_stm32cube.size_optimized/obj/pw_system/bin/system_example.elf reset exit"
|
|
|
|
Once the board has been flashed, you can connect to it and send RPC commands
|
|
via the Pigweed console:
|
|
|
|
.. code:: sh
|
|
|
|
pw-system-console -d /dev/{ttyX} -b 115200 --proto-globs pw_rpc/echo.proto --token-databases out/stm32f429i_disc1_stm32cube.size_optimized/obj/pw_system/bin/system_example.elf
|
|
|
|
Replace ``{ttyX}`` with the appropriate device on your machine. On Linux this
|
|
may look like ``ttyACM0``, and on a Mac it may look like ``cu.usbmodem***``.
|
|
|
|
When the console opens, try sending an Echo RPC request. You should get back
|
|
the same message you sent to the device.
|
|
|
|
.. code:: sh
|
|
|
|
>>> device.rpcs.pw.rpc.EchoService.Echo(msg="Hello, Pigweed!")
|
|
(Status.OK, pw.rpc.EchoMessage(msg='Hello, Pigweed!'))
|
|
|
|
You are now up and running!
|