1.. zephyr:board:: beagleconnect_freedom
2
3Overview
4********
5
6BeagleBoard.org BeagleConnect Freedom is a wireless
7Internet of Things board based on the SimpleLink multi-Standard CC1352P7 wireless MCU.
8
9Hardware
10********
11BeagleBoard.org BeagleConnect Freedom board features the TI CC1352P7 wireless microcontroller.
12The BeagleConnect Freedom is the first available BeagleConnect solution consisting
13of a board and a case which ships programmed and ready to be used.
14
15BeagleConnect Freedom board runs the Zephyr RTOS and has mikroBUS ports along
16with BLE and Sub-GHz radios on it.
17
18The CC1352P7 wireless MCU has a 48 MHz Arm Cortex-M4F SoC and a Bluetooth Low Energy and IEEE 802.15.4.
19
20The board also features a TI MSP430F5503 microcontroller used as a USB-to-serial bridge and
21GPIO expander.
22
23
24Supported Features
25==================
26
27The board configuration supports the following hardware features:
28
29+-----------+------------+----------------------+
30| Interface | Controller | Driver/Component     |
31+===========+============+======================+
32| GPIO      | on-chip    | gpio                 |
33+-----------+------------+----------------------+
34| MPU       | on-chip    | arch/arm             |
35+-----------+------------+----------------------+
36| NVIC      | on-chip    | arch/arm             |
37+-----------+------------+----------------------+
38| PINMUX    | on-chip    | pinmux               |
39+-----------+------------+----------------------+
40| UART      | on-chip    | serial               |
41+-----------+------------+----------------------+
42| I2C       | on-chip    | i2c                  |
43+-----------+------------+----------------------+
44| SPI       | on-chip    | spi                  |
45+-----------+------------+----------------------+
46| HWINFO    | on-chip    | hwinfo               |
47+-----------+------------+----------------------+
48| I2C       | off-chip   | OPT3001              |
49+-----------+------------+----------------------+
50| I2C       | off-chip   | HDC2010              |
51+-----------+------------+----------------------+
52| I2C       | off-chip   | BCF_BRIDGE_MCU       |
53+-----------+------------+----------------------+
54| ADC       | on-chip    | adc                  |
55+-----------+------------+----------------------+
56| PWM       | on-chip    | pwm                  |
57+-----------+------------+----------------------+
58| FLASH     | on-chip    | flash                |
59+-----------+------------+----------------------+
60| RADIO     | on-chip    | ieee802154           |
61+-----------+------------+----------------------+
62
63Connections and IOs
64===================
65
66.. figure:: img/beagleconnect_freedom_front_annotated.webp
67   :align: center
68   :width: 500px
69   :alt: Front connections
70
71   BeagleConnect Freedom front connections
72
73.. figure:: img/beagleconnect_freedom_back_annotated.webp
74   :align: center
75   :width: 500px
76   :alt: Back connections
77
78   BeagleConnect Freedom back connections
79
80
81+-------+--------------+-------------------------------------+
82| Pin   | Function     | Usage                               |
83+=======+==============+=====================================+
84| DIO5  | RST_MB2      | Reset mikroBUS port 2               |
85+-------+--------------+-------------------------------------+
86| DIO6  | RST_MB1      | Reset mikroBUS port 1               |
87+-------+--------------+-------------------------------------+
88| DIO7  | INT_SENSOR   | On-board sensor interrupts          |
89+-------+--------------+-------------------------------------+
90| DIO8  | FLASH_CS     | SPI flash chip-select               |
91+-------+--------------+-------------------------------------+
92| DIO9  | SDO / PICO   | SPI serial data output              |
93+-------+--------------+-------------------------------------+
94| DIO10 | SCK          | SPI serial clock                    |
95+-------+--------------+-------------------------------------+
96| DIO11 | SDI / POCI   | SPI serial data input               |
97+-------+--------------+-------------------------------------+
98| DIO12 | CC1352_RX    | UART RXD mikroBUS port 1 or MSP430  |
99+-------+--------------+-------------------------------------+
100| DIO13 | CC1352_TX    | UART TXD mikroBUS port 1 or MSP430  |
101+-------+--------------+-------------------------------------+
102| DIO14 | I2C_CTRL     | Enable on-board sensor I2C bus      |
103+-------+--------------+-------------------------------------+
104| DIO15 | USER_BOOT    | BOOT button status                  |
105+-------+--------------+-------------------------------------+
106| DIO16 | INT_MB1      | INTERRUPT PIN on mikroBUS port 1    |
107+-------+--------------+-------------------------------------+
108| DIO17 | PWM_MB1      | PWM PIN on mikroBUS port 1          |
109+-------+--------------+-------------------------------------+
110| DIO18 | LED_LINK     | Radio link indicator LED            |
111+-------+--------------+-------------------------------------+
112| DIO19 | PWM_MB2      | PWM PIN on mikroBUS port 2          |
113+-------+--------------+-------------------------------------+
114| DIO20 | INT_MB2      | INTERRUPT PIN on mikroBUS port 2    |
115+-------+--------------+-------------------------------------+
116| DIO21 | MB2_RX       | UART RXD on mikroBUS port 2         |
117+-------+--------------+-------------------------------------+
118| DIO22 | MB2_TX       | UART TXD on mikroBUS port 2         |
119+-------+--------------+-------------------------------------+
120| DIO23 | AN_MB1       | ANALOG PIN on mikroBUS port 1       |
121+-------+--------------+-------------------------------------+
122| DIO24 | AN_MB2       | ANALOG PIN on mikroBUS port 2       |
123+-------+--------------+-------------------------------------+
124| DIO25 | SCL          | I2C SCL                             |
125+-------+--------------+-------------------------------------+
126| DIO26 | SDA          | I2C SDA                             |
127+-------+--------------+-------------------------------------+
128| DIO27 | CS_MB2       | SPI CS on microBUS port 2           |
129+-------+--------------+-------------------------------------+
130| DIO28 | CS_MB1       | SPI CS on microBUS port 1           |
131+-------+--------------+-------------------------------------+
132| DIO29 | REF_SW_CTRL1 | Antenna mux PA enable               |
133+-------+--------------+-------------------------------------+
134| DIO30 | REF_SW_CTRL2 | Antenna mux SubG enable             |
135+-------+--------------+-------------------------------------+
136
137System requirements
138===================
139
140Prerequisites
141-------------
142
143BeagleConnect Freedom requires `CC1352 Flasher <https://pypi.org/project/cc1352-flasher/>`_ for
144flashing Zephyr firmware using ``west flash``.
145
146.. code-block:: console
147
148   pip3 install cc1352-flasher
149
150References
151**********
152
153BeagleBoard.org BeagleConnect Freedom reference:
154  https://beagleconnect.org
155