Contiki-NG
CC1350_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  * ======== CC1350_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 
47 #include <ti/drivers/rf/RF.h>
48 #include <ti/drivers/pin/PINCC26XX.h>
49 
50 #include <ti/drivers/Board.h>
51 
52 #include "Board.h"
53 
54 
55 /*
56  * ======== CC1350_LAUNCHXL_sendExtFlashByte ========
57  */
58 void CC1350_LAUNCHXL_sendExtFlashByte(PIN_Handle pinHandle, uint8_t byte)
59 {
60  uint8_t i;
61 
62  /* SPI Flash CS */
63  PIN_setOutputValue(pinHandle, IOID_20, 0);
64 
65  for (i = 0; i < 8; i++) {
66  PIN_setOutputValue(pinHandle, IOID_10, 0); /* SPI Flash CLK */
67 
68  /* SPI Flash MOSI */
69  PIN_setOutputValue(pinHandle, IOID_9, (byte >> (7 - i)) & 0x01);
70  PIN_setOutputValue(pinHandle, IOID_10, 1); /* SPI Flash CLK */
71 
72  /*
73  * Waste a few cycles to keep the CLK high for at
74  * least 45% of the period.
75  * 3 cycles per loop: 8 loops @ 48 Mhz = 0.5 us.
76  */
77  CPUdelay(8);
78  }
79 
80  PIN_setOutputValue(pinHandle, IOID_10, 0); /* CLK */
81  PIN_setOutputValue(pinHandle, IOID_20, 1); /* CS */
82 
83  /*
84  * Keep CS high at least 40 us
85  * 3 cycles per loop: 700 loops @ 48 Mhz ~= 44 us
86  */
87  CPUdelay(700);
88 }
89 
90 /*
91  * ======== CC1350_LAUNCHXL_wakeUpExtFlash ========
92  */
94 {
95  PIN_Config extFlashPinTable[] = {
96  /* SPI Flash CS */
97  IOID_20 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_HIGH | PIN_PUSHPULL |
98  PIN_INPUT_DIS | PIN_DRVSTR_MED,
99  PIN_TERMINATE
100  };
101  PIN_State extFlashPinState;
102  PIN_Handle extFlashPinHandle = PIN_open(&extFlashPinState, extFlashPinTable);
103 
104  /*
105  * To wake up we need to toggle the chip select at
106  * least 20 ns and ten wait at least 35 us.
107  */
108 
109  /* Toggle chip select for ~20ns to wake ext. flash */
110  PIN_setOutputValue(extFlashPinHandle, IOID_20, 0);
111  /* 3 cycles per loop: 1 loop @ 48 Mhz ~= 62 ns */
112  CPUdelay(1);
113  PIN_setOutputValue(extFlashPinHandle, IOID_20, 1);
114  /* 3 cycles per loop: 560 loops @ 48 Mhz ~= 35 us */
115  CPUdelay(560);
116 
117  PIN_close(extFlashPinHandle);
118 }
119 
120 /*
121  * ======== CC1350_LAUNCHXL_shutDownExtFlash ========
122  */
124 {
125  /*
126  * To be sure we are putting the flash into sleep and not waking it,
127  * we first have to make a wake up call
128  */
130 
131  PIN_Config extFlashPinTable[] = {
132  /* SPI Flash CS*/
133  IOID_20 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_HIGH | PIN_PUSHPULL |
134  PIN_INPUT_DIS | PIN_DRVSTR_MED,
135  /* SPI Flash CLK */
136  IOID_10 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL |
137  PIN_INPUT_DIS | PIN_DRVSTR_MED,
138  /* SPI Flash MOSI */
139  IOID_9 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL |
140  PIN_INPUT_DIS | PIN_DRVSTR_MED,
141  /* SPI Flash MISO */
142  IOID_8 | PIN_INPUT_EN | PIN_PULLDOWN,
143  PIN_TERMINATE
144  };
145  PIN_State extFlashPinState;
146  PIN_Handle extFlashPinHandle = PIN_open(&extFlashPinState, extFlashPinTable);
147 
148  uint8_t extFlashShutdown = 0xB9;
149 
150  CC1350_LAUNCHXL_sendExtFlashByte(extFlashPinHandle, extFlashShutdown);
151 
152  PIN_close(extFlashPinHandle);
153 }
154 
155 /*
156  * ======== Board_initHook ========
157  * Called by Board_init() to perform board-specific initialization.
158  */
159 void Board_initHook()
160 {
162 }
163 
164 /*
165  * For the SysConfig generated Board.h file, Board_RF_SUB1GHZ will not be
166  * defined unless the RF module is added to the configuration. Therefore,
167  * we don't include this code if Board_RF_SUB1GHZ is not defined.
168  */
169 #if defined(Board_RF_SUB1GHZ)
170 
171 /*
172  * ======== CC1350_LAUNCHXL_rfDriverCallback ========
173  * This is an implementation for the CC1350 launchpad which uses a
174  * single signal for antenna switching.
175  */
176 void rfDriverCallback(RF_Handle client, RF_GlobalEvent events, void *arg)
177 {
178  /* Decode input arguments. */
179  (void)client;
180  RF_RadioSetup* setupCommand = (RF_RadioSetup*)arg;
181 
182  /* Local variable. */
183  bool sub1GHz = false;
184  uint8_t loDivider = 0;
185 
186  if (events & RF_GlobalEventRadioSetup) {
187  /* Power up the antenna switch */
188  PINCC26XX_setOutputValue(Board_RF_POWER, 1);
189 
190  /* Decision about the frequency band shall be made based on the
191  loDivider field. */
192  switch (setupCommand->common.commandNo) {
193  case (CMD_RADIO_SETUP):
194  case (CMD_BLE5_RADIO_SETUP):
195  loDivider = RF_LODIVIDER_MASK & setupCommand->common.loDivider;
196 
197  /* Sub-1 GHz, requires antenna switch high. */
198  if ((loDivider != 0) && (loDivider != 2)) {
199  sub1GHz = true;
200  }
201  break;
202  case (CMD_PROP_RADIO_DIV_SETUP):
203  loDivider = RF_LODIVIDER_MASK & setupCommand->prop_div.loDivider;
204 
205  /* Sub-1 GHz, requires antenna switch high. */
206  if ((loDivider != 0) && (loDivider != 2)) {
207  sub1GHz = true;
208  }
209  break;
210  default:break;
211  }
212 
213  /* Select the correct antenna. */
214  if (sub1GHz) {
215  PINCC26XX_setOutputValue(Board_RF_SUB1GHZ, 1);
216  }
217  else {
218  PINCC26XX_setOutputValue(Board_RF_SUB1GHZ, 0);
219  }
220  }
221  else if (events & RF_GlobalEventRadioPowerDown) {
222  /* Disable antenna switch to save current */
223  PINCC26XX_setOutputValue(Board_RF_POWER, 0);
224  PINCC26XX_setOutputValue(Board_RF_SUB1GHZ, 0);
225  }
226 }
227 #endif
void CC1350_LAUNCHXL_shutDownExtFlash(void)
Turn off the external flash on LaunchPads.
void CC1350_LAUNCHXL_wakeUpExtFlash(void)
Wake up the external flash present on the board files.