130 lines
4.5 KiB
ReStructuredText
130 lines
4.5 KiB
ReStructuredText
.. _mikroe_clicker_2:
|
|
|
|
MikroE Clicker 2 for STM32
|
|
##########################
|
|
|
|
Overview
|
|
********
|
|
MikroE Clicker 2 for STM32 is a development board containing an `STM32F407`_
|
|
microcontroller. It is equipped with two mikrobus sockets and furthermore has
|
|
two headers for general signal break out.
|
|
The board also has battery connection and a battery management unit on board.
|
|
It can be powered either from a battery pack, such as a LiPo or from USB.
|
|
The board is equipped with a 25MHz crystal as well as a 32.768kHz clock crystal.
|
|
|
|
|
|
.. figure:: img/clicker-2-stm32f4-thickbox_default-2.jpg
|
|
:align: center
|
|
:alt: Clicker 2 For STM32
|
|
|
|
Clicker 2 For STM32 (Credit: MikroElektronika d.o.o.)
|
|
|
|
Hardware
|
|
********
|
|
The Clicker 2 board contains the following connections:
|
|
|
|
- Two MikroBUS connectors
|
|
- Two headers with general connections
|
|
|
|
Furthermore the board contains two LEDs and two push buttons that are connected
|
|
to the microcontroller.
|
|
|
|
Supported Features
|
|
==================
|
|
The Zephyr MikroE Clicker 2 configuration supports the following hardware features:
|
|
|
|
+-----------+------------+-------------------------------------+
|
|
| Interface | Controller | Driver/Component |
|
|
+===========+============+=====================================+
|
|
| NVIC | on-chip | nested vector interrupt controller |
|
|
+-----------+------------+-------------------------------------+
|
|
| UART | on-chip | serial port-polling; |
|
|
| | | serial port-interrupt |
|
|
+-----------+------------+-------------------------------------+
|
|
| PINMUX | on-chip | pinmux |
|
|
+-----------+------------+-------------------------------------+
|
|
| I2C | on-chip | i2c |
|
|
+-----------+------------+-------------------------------------+
|
|
| SPI | on-chip | spi |
|
|
+-----------+------------+-------------------------------------+
|
|
| ADC | on-chip | adc |
|
|
+-----------+------------+-------------------------------------+
|
|
| USB | on-chip | usb |
|
|
+-----------+------------+-------------------------------------+
|
|
|
|
Other hardware features have not been enabled yet for this board.
|
|
|
|
The default configuration can be found in
|
|
:zephyr_file:`boards/mikroe/mikroe_clicker_2/mikroe_clicker_2_defconfig`
|
|
|
|
Connections and IOs
|
|
===================
|
|
|
|
The two mikroBUS interfaces are aliased in the device tree so that their
|
|
peripherals can be accessed using ``mikrobus_N_INTERFACE`` so e.g. the spi on
|
|
bus 2 can be found by the alias ``mikrobus_2_spi``. The counting corresponds
|
|
with the marking on the board.
|
|
|
|
For connections on the edge connectors, please refer to `Clicker 2 for STM32 User Manual`_.
|
|
|
|
Programming and Debugging
|
|
*************************
|
|
Applications for the ``mikroe_clicker_2`` board configuration can
|
|
be built and flashed in the usual way (see :ref:`build_an_application` and
|
|
:ref:`application_run` for more details).
|
|
|
|
|
|
Flashing
|
|
========
|
|
The initial state of the board is set to lock.
|
|
When you flash, it will fail with the message:
|
|
|
|
.. code-block:: console
|
|
|
|
Error: stm32x device protected
|
|
|
|
Unlocking with openocd makes it possible to flash.
|
|
|
|
.. code-block:: console
|
|
|
|
$ openocd -f /usr/share/openocd/scripts/interface/stlink-v2.cfg \
|
|
-f /usr/share/openocd/scripts/target/stm32f4x.cfg -c init\
|
|
-c "reset halt" -c "stm32f4x unlock 0" -c "reset run" -c shutdown
|
|
|
|
Here is an example for the :ref:`hello_world` application.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: mikroe_clicker_2
|
|
:goals: build flash
|
|
|
|
You should see the following message on the console:
|
|
|
|
.. code-block:: console
|
|
|
|
Hello World! mikroe_clicker_2
|
|
|
|
|
|
Debugging
|
|
=========
|
|
|
|
You can debug an application in the usual way. Here is an example for the
|
|
:ref:`hello_world` application.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: mikroe_clicker_2
|
|
:maybe-skip-config:
|
|
:goals: debug
|
|
|
|
References
|
|
**********
|
|
.. _Clicker 2 website:
|
|
https://www.mikroe.com/clicker-2-stm32f4
|
|
.. _Clicker 2 for STM32 User Manual:
|
|
https://download.mikroe.com/documents/starter-boards/clicker-2/stm32f4/clicker2-stm32-manual-v100.pdf
|
|
.. _STM32F407VG Website:
|
|
https://www.st.com/content/st_com/en/products/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus/stm32-high-performance-mcus/stm32f4-series/stm32f407-417/stm32f407vg.html
|
|
.. _STM32F407:
|
|
https://www.st.com/resource/en/datasheet/stm32f407vg.pdf
|