Improve the documentation of the blinky sample, fixing typos, adding links to the relevant DT documentation and cleaning up a bit. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
41 lines
1.0 KiB
ReStructuredText
41 lines
1.0 KiB
ReStructuredText
.. _blinky-sample:
|
|
|
|
Blinky sample
|
|
#############
|
|
|
|
Overview
|
|
********
|
|
|
|
The Blinky example shows how to configure GPIO pins as outputs which can also be
|
|
used to drive LEDs on the hardware usually delivered as "User LEDs" on many of
|
|
the supported boards in Zephyr.
|
|
|
|
.. _blinky-sample-requirements:
|
|
|
|
Requirements
|
|
************
|
|
|
|
The demo assumes that an LED is connected to one of GPIO lines. The
|
|
sample code is configured to work on boards that have defined the ``led0``
|
|
alias in their :ref:`board's devicetree description file
|
|
<devicetree-in-out-files>`, :file:`<board>.dts`.
|
|
Doing so will generate these variables:
|
|
|
|
- ``DT_ALIAS_LED0_GPIOS_CONTROLLER``
|
|
- ``DT_ALIAS_LED0_GPIOS_PIN``
|
|
|
|
Building and Running
|
|
********************
|
|
|
|
This sample does not output anything to the console. It can be built and
|
|
flashed to a board as follows:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/basic/blinky
|
|
:board: reel_board
|
|
:goals: build flash
|
|
:compact:
|
|
|
|
After flashing the image to the board, the user LED on the board should start to
|
|
blink.
|