aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/source/lang/api/board-values.rst41
1 files changed, 34 insertions, 7 deletions
diff --git a/docs/source/lang/api/board-values.rst b/docs/source/lang/api/board-values.rst
index 05e3837..5fbf20f 100644
--- a/docs/source/lang/api/board-values.rst
+++ b/docs/source/lang/api/board-values.rst
@@ -1,10 +1,12 @@
.. _lang-board-values:
-Board-Specific Constants
-========================
+Board-Specific Values
+=====================
There are a number of board-specific values: constants or variables
-which are different depending on which LeafLabs board you have.
+which are different depending on which LeafLabs board you have. The
+exact values for each board are given in your :ref:`board's hardware
+documentation <index-boards>`.
This page lists and documents the board-specific values. You should
use these when appropriate in your own programs. This will help make
@@ -21,14 +23,21 @@ Documentation <index-boards>`.
Constants
---------
+.. TODO [systick.rst] Add a link to systick.rst instead of systick.h
+.. below, when systick.rst exists.
+
+- ``CYCLES_PER_MICROSECOND``: Number of CPU cycles per microsecond on
+ your board.
+
- ``CLOCK_SPEED_MHZ``: Clock speed of your board, in megahertz
(MHz). This is the same as ``CYCLES_PER_MICROSECOND``.
- ``CLOCK_SPEED_HZ``: Clock speed of your board, in hertz (Hz). This
- is the same as ``CLOCK_SPEED_MHZ * 1000000``.
+ is the same as ``CLOCK_SPEED_MHZ`` × 1,000,000.
-- ``CYCLES_PER_MICROSECOND``: Number of CPU cycles per microsecond on
- your board.
+- ``SYSTICK_RELOAD_VAL``: Value used when reloading the :ref:`SysTick
+ <libmaple-systick>` timer's counter. For :ref:`lang-millis` to work
+ properly, this must be ``CYCLES_PER_MICROSECOND`` × 1,000 - 1.
.. _lang-board-values-but:
@@ -70,7 +79,7 @@ Constants
.. _lang-board-values-usart:
-- USART (serial port) related constants:
+- :ref:`USART <usart>` (serial port) related constants:
* ``BOARD_USART1_TX_PIN``, ``BOARD_USART2_TX_PIN``, ``BOARD_USART3_TX_PIN``:
TX pins for the 3 USARTS.
@@ -87,6 +96,24 @@ Constants
* ``BOARD_NR_USARTS``: Number of serial ports on the board. This
number includes UARTs 4 and 5 if they are available.
+- :ref:`SPI <spi>` related constants:
+
+ * ``BOARD_SPI1_NSS_PIN``, ``BOARD_SPI1_MOSI_PIN``,
+ ``BOARD_SPI1_MISO_PIN``, ``BOARD_SPI1_SCK_PIN``: SPI1
+ peripheral's NSS, MOSI, MISO, and SCK pins, respectively.
+
+ * ``BOARD_SPI2_NSS_PIN``, ``BOARD_SPI2_MOSI_PIN``,
+ ``BOARD_SPI2_MISO_PIN``, ``BOARD_SPI2_SCK_PIN``: SPI2
+ peripheral's NSS, MOSI, MISO, and SCK pins, respectively.
+
+ * ``BOARD_SPI3_NSS_PIN``, ``BOARD_SPI3_MOSI_PIN``,
+ ``BOARD_SPI3_MISO_PIN``, ``BOARD_SPI3_SCK_PIN``: SPI3
+ peripheral's NSS, MOSI, MISO, and SCK pins, respectively
+ (available on high-density devices like Maple Native and Maple
+ RET6 edition only).
+
+ * ``BOARD_NR_SPI``: Number of SPI peripherals on the board.
+
.. _lang-board-values-debug:
- Debug (JTAG, SW-Debug) related constants: ``BOARD_JTMS_SWDIO_PIN``,