Contiki-NG
CC1352P_2_LAUNCHXL_fxns.c
1/*
2 * Copyright (c) 2018-2019, Texas Instruments Incorporated
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * * Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 *
12 * * Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * * Neither the name of Texas Instruments Incorporated nor the names of
17 * its contributors may be used to endorse or promote products derived
18 * from this software without specific prior written permission.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
22 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
24 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
27 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
28 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 */
32
33/*
34 * ======== CC1352P_2_LAUNCHXL_fxns.c ========
35 * This file contains the board-specific initialization functions, and
36 * RF callback function for antenna switching.
37 */
38
39#include <stdbool.h>
40#include <stddef.h>
41#include <stdint.h>
42
43#include <ti/devices/DeviceFamily.h>
44#include DeviceFamily_constructPath(driverlib/ioc.h)
45#include DeviceFamily_constructPath(driverlib/cpu.h)
46#include <ti/drivers/rf/RF.h>
47#include <ti/drivers/pin/PINCC26XX.h>
48
49#include <ti/drivers/Board.h>
50
51#include "Board.h"
52
53
54/*
55 * ======== CC1352P_2_LAUNCHXL_sendExtFlashByte ========
56 */
57void CC1352P_2_LAUNCHXL_sendExtFlashByte(PIN_Handle pinHandle, uint8_t byte)
58{
59 uint8_t i;
60
61 /* SPI Flash CS */
62 PIN_setOutputValue(pinHandle, IOID_20, 0);
63
64 for (i = 0; i < 8; i++) {
65 PIN_setOutputValue(pinHandle, IOID_10, 0); /* SPI Flash CLK */
66
67 /* SPI Flash MOSI */
68 PIN_setOutputValue(pinHandle, IOID_9, (byte >> (7 - i)) & 0x01);
69 PIN_setOutputValue(pinHandle, IOID_10, 1); /* SPI Flash CLK */
70
71 /*
72 * Waste a few cycles to keep the CLK high for at
73 * least 45% of the period.
74 * 3 cycles per loop: 8 loops @ 48 Mhz = 0.5 us.
75 */
76 CPUdelay(8);
77 }
78
79 PIN_setOutputValue(pinHandle, IOID_10, 0); /* CLK */
80 PIN_setOutputValue(pinHandle, IOID_20, 1); /* CS */
81
82 /*
83 * Keep CS high at least 40 us
84 * 3 cycles per loop: 700 loops @ 48 Mhz ~= 44 us
85 */
86 CPUdelay(700);
87}
88
89/*
90 * ======== CC1352P_2_LAUNCHXL_wakeUpExtFlash ========
91 */
93{
94 PIN_Config extFlashPinTable[] = {
95 /* SPI Flash CS */
96 IOID_20 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_HIGH | PIN_PUSHPULL |
97 PIN_INPUT_DIS | PIN_DRVSTR_MED,
98 PIN_TERMINATE
99 };
100 PIN_State extFlashPinState;
101 PIN_Handle extFlashPinHandle = PIN_open(&extFlashPinState, extFlashPinTable);
102
103 /*
104 * To wake up we need to toggle the chip select at
105 * least 20 ns and ten wait at least 35 us.
106 */
107
108 /* Toggle chip select for ~20ns to wake ext. flash */
109 PIN_setOutputValue(extFlashPinHandle, IOID_20, 0);
110 /* 3 cycles per loop: 1 loop @ 48 Mhz ~= 62 ns */
111 CPUdelay(1);
112 PIN_setOutputValue(extFlashPinHandle, IOID_20, 1);
113 /* 3 cycles per loop: 560 loops @ 48 Mhz ~= 35 us */
114 CPUdelay(560);
115
116 PIN_close(extFlashPinHandle);
117}
118
119/*
120 * ======== CC1352P_2_LAUNCHXL_shutDownExtFlash ========
121 */
123{
124 /* To be sure we are putting the flash into sleep and not waking it, we first have to make a wake up call */
126
127 PIN_Config extFlashPinTable[] = {
128 /* SPI Flash CS*/
129 IOID_20 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_HIGH | PIN_PUSHPULL |
130 PIN_INPUT_DIS | PIN_DRVSTR_MED,
131 /* SPI Flash CLK */
132 IOID_10 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL |
133 PIN_INPUT_DIS | PIN_DRVSTR_MED,
134 /* SPI Flash MOSI */
135 IOID_9 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL |
136 PIN_INPUT_DIS | PIN_DRVSTR_MED,
137 /* SPI Flash MISO */
138 IOID_8 | PIN_INPUT_EN | PIN_PULLDOWN,
139 PIN_TERMINATE
140 };
141 PIN_State extFlashPinState;
142 PIN_Handle extFlashPinHandle = PIN_open(&extFlashPinState, extFlashPinTable);
143
144 uint8_t extFlashShutdown = 0xB9;
145
146 CC1352P_2_LAUNCHXL_sendExtFlashByte(extFlashPinHandle, extFlashShutdown);
147
148 PIN_close(extFlashPinHandle);
149}
150
151/*
152 * For the SysConfig generated Board.h file, Board_RF_SUB1GHZ will not be
153 * defined unless the RF module is added to the configuration. Therefore,
154 * we don't include this code if Board_RF_SUB1GHZ is not defined.
155 */
156#if defined(Board_RF_SUB1GHZ)
157
158/*
159 * ======== Antenna switching ========
160 */
161static PIN_Handle antennaPins;
162static PIN_State antennaState;
163
164void initAntennaSwitch()
165{
166 PIN_Config antennaConfig[] = {
167 Board_RF_24GHZ | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL | PIN_DRVSTR_MAX, /* Path disabled */
168 Board_RF_HIGH_PA | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL | PIN_DRVSTR_MAX, /* Path disabled */
169 Board_RF_SUB1GHZ | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL | PIN_DRVSTR_MAX, /* Path disabled */
170 PIN_TERMINATE
171 };
172 antennaPins = PIN_open(&antennaState, antennaConfig);
173}
174
175/*
176 * ======== CC1352P_2_LAUNCHXL_rfDriverCallback ========
177 * Sets up the antenna switch depending on the current PHY configuration.
178 * Truth table:
179 *
180 * Path DIO28 DIO29 DIO30
181 * =========== ===== ===== =====
182 * Off 0 0 0
183 * Sub-1 GHz 0 0 1
184 * 2.4 GHz 1 0 0
185 * 20 dBm TX 0 1 0
186 */
187void rfDriverCallback(RF_Handle client, RF_GlobalEvent events, void *arg)
188{
189 /* Local variable. */
190 bool sub1GHz = false;
191 uint8_t loDivider = 0;
192
193 /* Switch off all paths first. Needs to be done anyway in every sub-case below. */
194 PINCC26XX_setOutputValue(Board_RF_24GHZ, 0);
195 PINCC26XX_setOutputValue(Board_RF_HIGH_PA, 0);
196 PINCC26XX_setOutputValue(Board_RF_SUB1GHZ, 0);
197
198 if (events & RF_GlobalEventRadioSetup) {
199 /* Decode the current PA configuration. */
200 RF_TxPowerTable_PAType paType = (RF_TxPowerTable_PAType)RF_getTxPower(client).paType;
201
202 /* Decode the generic argument as a setup command. */
203 RF_RadioSetup* setupCommand = (RF_RadioSetup*)arg;
204
205 switch (setupCommand->common.commandNo) {
206 case (CMD_RADIO_SETUP):
207 case (CMD_BLE5_RADIO_SETUP):
208 loDivider = RF_LODIVIDER_MASK & setupCommand->common.loDivider;
209
210 /* Sub-1GHz front-end. */
211 if (loDivider != 0) {
212 sub1GHz = true;
213 }
214 break;
215 case (CMD_PROP_RADIO_DIV_SETUP):
216 loDivider = RF_LODIVIDER_MASK & setupCommand->prop_div.loDivider;
217
218 /* Sub-1GHz front-end. */
219 if (loDivider != 0) {
220 sub1GHz = true;
221 }
222 break;
223 default:break;
224 }
225
226 if (sub1GHz) {
227 /* Sub-1 GHz */
228 if (paType == RF_TxPowerTable_HighPA) {
229 /* PA enable --> HIGH PA
230 * LNA enable --> Sub-1 GHz
231 */
232 PINCC26XX_setMux(antennaPins, Board_RF_24GHZ, PINCC26XX_MUX_GPIO);
233 /* Note: RFC_GPO3 is a work-around because the RFC_GPO1 (PA enable signal) is sometimes not
234 de-asserted on CC1352 Rev A. */
235 PINCC26XX_setMux(antennaPins, Board_RF_HIGH_PA, PINCC26XX_MUX_RFC_GPO3);
236 PINCC26XX_setMux(antennaPins, Board_RF_SUB1GHZ, PINCC26XX_MUX_RFC_GPO0);
237 } else {
238 /* RF core active --> Sub-1 GHz */
239 PINCC26XX_setMux(antennaPins, Board_RF_24GHZ, PINCC26XX_MUX_GPIO);
240 PINCC26XX_setMux(antennaPins, Board_RF_HIGH_PA, PINCC26XX_MUX_GPIO);
241 PINCC26XX_setMux(antennaPins, Board_RF_SUB1GHZ, PINCC26XX_MUX_GPIO);
242 PINCC26XX_setOutputValue(Board_RF_SUB1GHZ, 1);
243 }
244 } else {
245 /* 2.4 GHz */
246 if (paType == RF_TxPowerTable_HighPA)
247 {
248 /* PA enable --> HIGH PA
249 * LNA enable --> 2.4 GHz
250 */
251 PINCC26XX_setMux(antennaPins, Board_RF_24GHZ, PINCC26XX_MUX_RFC_GPO0);
252 /* Note: RFC_GPO3 is a work-around because the RFC_GPO1 (PA enable signal) is sometimes not
253 de-asserted on CC1352 Rev A. */
254 PINCC26XX_setMux(antennaPins, Board_RF_HIGH_PA, PINCC26XX_MUX_RFC_GPO3);
255 PINCC26XX_setMux(antennaPins, Board_RF_SUB1GHZ, PINCC26XX_MUX_GPIO);
256 } else {
257 /* RF core active --> 2.4 GHz */
258 PINCC26XX_setMux(antennaPins, Board_RF_24GHZ, PINCC26XX_MUX_GPIO);
259 PINCC26XX_setMux(antennaPins, Board_RF_HIGH_PA, PINCC26XX_MUX_GPIO);
260 PINCC26XX_setMux(antennaPins, Board_RF_SUB1GHZ, PINCC26XX_MUX_GPIO);
261 PINCC26XX_setOutputValue(Board_RF_24GHZ, 1);
262 }
263 }
264 } else {
265 /* Reset the IO multiplexer to GPIO functionality */
266 PINCC26XX_setMux(antennaPins, Board_RF_24GHZ, PINCC26XX_MUX_GPIO);
267 PINCC26XX_setMux(antennaPins, Board_RF_HIGH_PA, PINCC26XX_MUX_GPIO);
268 PINCC26XX_setMux(antennaPins, Board_RF_SUB1GHZ, PINCC26XX_MUX_GPIO);
269 }
270}
271#endif
272
273/*
274 * ======== Board_initHook ========
275 * Called by Board_init() to perform board-specific initialization.
276 */
277void Board_initHook()
278{
279#if defined(Board_RF_SUB1GHZ)
280 initAntennaSwitch();
281#endif
282
284}
void CC1352P_2_LAUNCHXL_wakeUpExtFlash(void)
Wake up the external flash present on the board files.
void CC1352P_2_LAUNCHXL_shutDownExtFlash(void)
Shut down the external flash present on the board files.