1.. _arduino_uno_click:
2
3Arduino UNO click shield
4########################
5
6Overview
7********
8
9The Arduino UNO click is an extension to the Arduino UNO R3 headers.
10It's a simple shield that converts Arduino UNO R3 headers to two mikroBUS
11host sockets that allow you to connect many other click shields to your
12board.
13In other words, the Arduino UNO click will generally be used by other
14shields using the mikroBUS interface.
15
16Two mikroBUS headers are exposed by the overlay: ``mikrobus_header_1`` and
17``mikrobus_header_2``, each corresponding to a socket on the Arduino UNO
18click shield.
19
20The first socket (``mikrobus_header_1``) is the default socket which is
21assigned the node label ``mikrobus_header`` in the overlay.
22
23More information about the shield can be found at
24`Arduino UNO click shield website`_.
25
26Requirements
27************
28
29This shield can only be used with a board which provides a configuration
30for Arduino R3 connector.
31
32The board must also define node aliases for arduino Serial,
33SPI and I2C interfaces (see :ref:`shields` for more details).
34
35Connecting shields should use the first socket (``mikrobus_header_1``). This
36socket is assigned the ``mikrobus_header`` node label.
37
38Programming
39***********
40
41Include ``--shield arduino_uno_click`` when you invoke ``west build`` with
42other mikroBUS shields. For example:
43
44.. zephyr-app-commands::
45   :zephyr-app: samples/net/sockets/echo_server
46   :host-os: unix
47   :board: sam_v71_xult/samv71q21
48   :gen-args: -DEXTRA_CONF_FILE=overlay-802154.conf
49   :shield: arduino_uno_click,atmel_rf2xx_mikrobus
50   :goals: build
51
52References
53**********
54
55.. target-notes::
56
57.. _Arduino UNO click shield website:
58   https://www.mikroe.com/arduino-uno-click-shield
59