1.. zephyr:board:: sim3u1xx_dk
2
3Overview
4********
5
6This is a `development kit`_ that is used to develop software for the SiM3U1xx MCUs.
7
8Hardware
9********
10
11- Silicon Labs SiM3U167-B-GM SoC
12- CPU core: ARM Cortex®-M3
13- Flash memory: 256 kB
14- RAM: 32 kB
15- IO:
16
17  - 2x user LEDs
18  - 2x user push buttons
19  - 2x power LEDs
20  - Reset push button
21  - Potentiometer
22  - Analog terminals
23  - Capacitive sensing slider and button
24  - USB virtual COM port
25
26For more information about the SiM3U167 SoC and the SiM3U1xx board, refer to these documents:
27
28- Silicon Labs SiM3U1xx_
29- Silicon Labs SiM3U167-B-GM_
30- Silicon Labs SiM3U1xx-B-DK_
31- Silicon Labs SiM3U1xx-B-DK MCU card `user's guide`_
32- Silicon Labs SiM3U1xx and SiM3C1xx Revision B Errata_
33
34.. _SiM3U1xx: https://www.silabs.com/mcu/32-bit-microcontrollers/precision32-sim3u1xx
35.. _SiM3U167-B-GM: https://www.silabs.com/mcu/32-bit-microcontrollers/precision32-sim3u1xx/device.sim3u167-b-gm
36.. _SiM3U1xx-B-DK: https://www.silabs.com/development-tools/mcu/32-bit/sim3u1xx-development-kit
37.. _user's guide: https://www.silabs.com/documents/public/user-guides/UPMU-M3U160.pdf
38.. _Errata: https://www.silabs.com/documents/public/errata/SiM3U1xx-SiM3C1xxErrata.pdf
39
40Supported Features
41==================
42
43The board configuration supports the following hardware features:
44
45+-----------+------------+-------------------------------------+
46| Interface | Controller | Driver/Component                    |
47+===========+============+=====================================+
48| NVIC      | on-chip    | nested vector interrupt controller  |
49+-----------+------------+-------------------------------------+
50| SYSTICK   | on-chip    | systick                             |
51+-----------+------------+-------------------------------------+
52| AES       | on-chip    | crypto                              |
53+-----------+------------+-------------------------------------+
54| DMA       | on-chip    | dma                                 |
55+-----------+------------+-------------------------------------+
56| FLASH     | on-chip    | flash memory                        |
57+-----------+------------+-------------------------------------+
58| GPIO      | on-chip    | gpio                                |
59+-----------+------------+-------------------------------------+
60| UART      | on-chip    | serial port-polling;                |
61|           |            | serial port-interrupt               |
62+-----------+------------+-------------------------------------+
63
64Connections and IOs
65===================
66
67+--------+--------------------------+----------------------------------------------------+
68| Pin    | Name                     | Note                                               |
69+========+==========================+====================================================+
70| PB1.12 | TX (O)                   | Serial connection to host via USB virtual COM port |
71+--------+--------------------------+                                                    |
72| PB1.13 | RX (I)                   |                                                    |
73+--------+--------------------------+                                                    |
74| PB1.14 | RTS (O)                  |                                                    |
75+--------+--------------------------+                                                    |
76| PB1.15 | CTS (I)                  |                                                    |
77+--------+--------------------------+----------------------------------------------------+
78| PB2.8  | Push button switch (SW2) |                                                    |
79+--------+--------------------------+----------------------------------------------------+
80| PB2.9  | Push button switch (SW3) |                                                    |
81+--------+--------------------------+----------------------------------------------------+
82| PB2.10 | Red LED (DS3)            |                                                    |
83+--------+--------------------------+----------------------------------------------------+
84| PB2.11 | Yellow LED (DS4)         |                                                    |
85+--------+--------------------------+----------------------------------------------------+
86| PB1.5  | Potentiometer            |                                                    |
87+--------+--------------------------+----------------------------------------------------+
88| PB2.12 | Potentiometer bias       |                                                    |
89+--------+--------------------------+----------------------------------------------------+
90
91Programming and Debugging
92*************************
93
94Flashing
95========
96
97The sample application :zephyr:code-sample:`hello_world` is used for this example. Build the Zephyr kernel and
98application:
99
100.. zephyr-app-commands::
101   :zephyr-app: samples/hello_world
102   :board: sim3u1xx_dk
103   :goals: build
104
105Connect the sim3u1xx_dk to your host computer using both USB port and you should see a USB serial
106connection.
107
108Open a serial terminal (minicom, putty, etc.) with the following settings:
109
110- Speed: 115200
111- Data: 8 bits
112- Parity: None
113- Stop bits: 1
114
115Reset the board and you'll see the following message on the corresponding serial port
116terminal session:
117
118.. code-block:: console
119
120   Hello World! sim3u1xx_dk/sim3u167
121
122References
123**********
124
125.. target-notes::
126
127.. _development kit:
128   https://www.silabs.com/development-tools/mcu/32-bit/sim3u1xx-development-kit
129