• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /******************************************************************************
2  *
3  *  Copyright (C) 2012 Broadcom Corporation
4  *
5  *  Licensed under the Apache License, Version 2.0 (the "License");
6  *  you may not use this file except in compliance with the License.
7  *  You may obtain a copy of the License at:
8  *
9  *  http://www.apache.org/licenses/LICENSE-2.0
10  *
11  *  Unless required by applicable law or agreed to in writing, software
12  *  distributed under the License is distributed on an "AS IS" BASIS,
13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  *  See the License for the specific language governing permissions and
15  *  limitations under the License.
16  *
17  ******************************************************************************/
18 #ifndef NFC_HAL_TARGET_H
19 #define NFC_HAL_TARGET_H
20 
21 #include "data_types.h"
22 
23 #ifdef BUILDCFG
24 #include "buildcfg_hal.h"
25 #endif
26 
27 /****************************************************************************
28 ** NCI related configuration
29 ****************************************************************************/
30 
31 /* GKI pool for NCI messages */
32 #ifndef NFC_HAL_NCI_POOL_ID
33 #define NFC_HAL_NCI_POOL_ID                     GKI_POOL_ID_1
34 #endif
35 
36 #ifndef NFC_HAL_NCI_POOL_BUF_SIZE
37 #define NFC_HAL_NCI_POOL_BUF_SIZE               GKI_BUF1_SIZE
38 #endif
39 
40 /* Initial Max Control Packet Payload Size (until receiving payload size in INIT_CORE_RSP) */
41 #ifndef NFC_HAL_NCI_INIT_CTRL_PAYLOAD_SIZE
42 #define NFC_HAL_NCI_INIT_CTRL_PAYLOAD_SIZE      0xFF
43 #endif
44 
45 /* Number of bytes to reserve in front of NCI messages (e.g. for transport header) */
46 #ifndef NFC_HAL_NCI_MSG_OFFSET_SIZE
47 #define NFC_HAL_NCI_MSG_OFFSET_SIZE             1
48 #endif
49 
50 /* NFC-WAKE */
51 #ifndef NFC_HAL_LP_NFC_WAKE_GPIO
52 #define NFC_HAL_LP_NFC_WAKE_GPIO                UPIO_GENERAL3
53 #endif
54 
55 /* NFCC snooze mode idle timeout before deassert NFC_WAKE in ms */
56 #ifndef NFC_HAL_LP_IDLE_TIMEOUT
57 #define NFC_HAL_LP_IDLE_TIMEOUT                 100
58 #endif
59 
60 /* NFC snooze mode */
61 #ifndef NFC_HAL_LP_SNOOZE_MODE
62 #define NFC_HAL_LP_SNOOZE_MODE                  NFC_HAL_LP_SNOOZE_MODE_UART
63 #endif
64 
65 /* Idle Threshold Host in 100ms unit */
66 #ifndef NFC_HAL_LP_IDLE_THRESHOLD_HOST
67 #define NFC_HAL_LP_IDLE_THRESHOLD_HOST          0
68 #endif
69 
70 /* Idle Threshold HC in 100ms unit */
71 #ifndef NFC_HAL_LP_IDLE_THRESHOLD_HC
72 #define NFC_HAL_LP_IDLE_THRESHOLD_HC            0
73 #endif
74 
75 
76 /* Default NFCC power-up baud rate */
77 #ifndef NFC_HAL_DEFAULT_BAUD
78 #define NFC_HAL_DEFAULT_BAUD                    USERIAL_BAUD_115200
79 #endif
80 
81 /* time (in ms) between power off and on NFCC */
82 #ifndef NFC_HAL_POWER_CYCLE_DELAY
83 #define NFC_HAL_POWER_CYCLE_DELAY               100
84 #endif
85 
86 #ifndef NFC_HAL_PRM_DEBUG
87 #define NFC_HAL_PRM_DEBUG                       TRUE
88 #endif
89 
90 /* max patch data length (Can be overridden by platform for ACL HCI command size) */
91 #ifndef NFC_HAL_PRM_HCD_CMD_MAXLEN
92 #define NFC_HAL_PRM_HCD_CMD_MAXLEN              250
93 #endif
94 
95 /* Require PreI2C patch by default */
96 #ifndef NFC_HAL_PRE_I2C_PATCH_INCLUDED
97 #define NFC_HAL_PRE_I2C_PATCH_INCLUDED          TRUE
98 #endif
99 
100 /* Set to TRUE to always download patch regardless of version */
101 #ifndef NFC_HAL_PRM_SKIP_VERSION_CHECK
102 #define NFC_HAL_PRM_SKIP_VERSION_CHECK          FALSE
103 #endif
104 
105 /* Mininum payload size for SPD NCI commands (used to validate HAL_NfcPrmSetSpdNciCmdPayloadSize) */
106 /* Default is 32, as required by the NCI specifications; however this value may be          */
107 /* over-riden for platforms that have transport packet limitations                          */
108 #ifndef NFC_HAL_PRM_MIN_NCI_CMD_PAYLOAD_SIZE
109 #define NFC_HAL_PRM_MIN_NCI_CMD_PAYLOAD_SIZE    (32)
110 #endif
111 
112 /* amount of time to wait for RESET NTF after patch download */
113 #ifndef NFC_HAL_PRM_RESET_NTF_DELAY
114 #define NFC_HAL_PRM_RESET_NTF_DELAY             (10000)
115 #endif
116 
117 /* amount of time to wait after downloading preI2C patch before downloading LPM/FPM patch */
118 #ifndef NFC_HAL_PRM_POST_I2C_FIX_DELAY
119 #define NFC_HAL_PRM_POST_I2C_FIX_DELAY          (200)
120 #endif
121 
122 /* NFCC will respond to more than one technology during listen discovery  */
123 #ifndef NFC_HAL_DM_MULTI_TECH_RESP
124 #define NFC_HAL_DM_MULTI_TECH_RESP              TRUE
125 #endif
126 
127 /* Data rate for 15693 command/response, it must be same as RW_I93_FLAG_DATA_RATE in nfc_target.h */
128 #define NFC_HAL_I93_FLAG_DATA_RATE_LOW          0x00
129 #define NFC_HAL_I93_FLAG_DATA_RATE_HIGH         0x02
130 
131 #ifndef NFC_HAL_I93_FLAG_DATA_RATE
132 #define NFC_HAL_I93_FLAG_DATA_RATE              NFC_HAL_I93_FLAG_DATA_RATE_HIGH
133 #endif
134 
135 /* Quick Timer */
136 #ifndef QUICK_TIMER_TICKS_PER_SEC
137 #define QUICK_TIMER_TICKS_PER_SEC               100       /* 10ms timer */
138 #endif
139 
140 #ifndef NFC_HAL_SHARED_TRANSPORT_ENABLED
141 #define NFC_HAL_SHARED_TRANSPORT_ENABLED        FALSE
142 #endif
143 
144 /* Enable verbose tracing by default */
145 #ifndef NFC_HAL_TRACE_VERBOSE
146 #define NFC_HAL_TRACE_VERBOSE                   TRUE
147 #endif
148 
149 #ifndef NFC_HAL_INITIAL_TRACE_LEVEL
150 #define NFC_HAL_INITIAL_TRACE_LEVEL             5
151 #endif
152 
153 /* Map NFC serial port to USERIAL_PORT_6 by default */
154 #ifndef USERIAL_NFC_PORT
155 #define USERIAL_NFC_PORT                        (USERIAL_PORT_6)
156 #endif
157 
158 /* Restore NFCC baud rate to default on shutdown if baud rate was updated */
159 #ifndef NFC_HAL_RESTORE_BAUD_ON_SHUTDOWN
160 #define NFC_HAL_RESTORE_BAUD_ON_SHUTDOWN        TRUE
161 #endif
162 
163 /* Enable protocol tracing by default */
164 #ifndef NFC_HAL_TRACE_PROTOCOL
165 #define NFC_HAL_TRACE_PROTOCOL                  TRUE
166 #endif
167 #define BT_TRACE_PROTOCOL                       (NFC_HAL_TRACE_PROTOCOL)
168 
169 #define LogMsg_0 LogMsg
170 #define LogMsg_1 LogMsg
171 #define LogMsg_2 LogMsg
172 #define LogMsg_3 LogMsg
173 #define LogMsg_4 LogMsg
174 #define LogMsg_5 LogMsg
175 #define LogMsg_6 LogMsg
176 
177 /* Trace macros */
178 #define BT_TRACE_0(l,t,m)                           LogMsg_0((TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t)),(m))
179 #define BT_TRACE_1(l,t,m,p1)                        LogMsg_1(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t),(m),(UINT32)(p1))
180 #define BT_TRACE_2(l,t,m,p1,p2)                     LogMsg_2(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t),(m),(UINT32)(p1),   \
181                                                         (UINT32)(p2))
182 #define BT_TRACE_3(l,t,m,p1,p2,p3)                  LogMsg_3(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t),(m),(UINT32)(p1),   \
183                                                         (UINT32)(p2),(UINT32)(p3))
184 #define BT_TRACE_4(l,t,m,p1,p2,p3,p4)               LogMsg_4(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t),(m),(UINT32)(p1),   \
185                                                         (UINT32)(p2),(UINT32)(p3),(UINT32)(p4))
186 #define BT_TRACE_5(l,t,m,p1,p2,p3,p4,p5)            LogMsg_5(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t),(m),(UINT32)(p1),   \
187                                                         (UINT32)(p2),(UINT32)(p3),(UINT32)(p4), \
188                                                         (UINT32)(p5))
189 #define BT_TRACE_6(l,t,m,p1,p2,p3,p4,p5,p6)         LogMsg_6(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t),(m),(UINT32)(p1),   \
190                                                         (UINT32)(p2),(UINT32)(p3),(UINT32)(p4), \
191                                                         (UINT32)(p5),(UINT32)(p6))
192 
193 #define NCI_TRACE_ERROR0(m)                     {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR) BT_TRACE_0(TRACE_LAYER_NCI, TRACE_TYPE_ERROR, m);}
194 #define NCI_TRACE_ERROR1(m,p1)                  {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR) BT_TRACE_1(TRACE_LAYER_NCI, TRACE_TYPE_ERROR, m,p1);}
195 #define NCI_TRACE_ERROR2(m,p1,p2)               {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR) BT_TRACE_2(TRACE_LAYER_NCI, TRACE_TYPE_ERROR, m,p1,p2);}
196 #define NCI_TRACE_ERROR3(m,p1,p2,p3)            {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR) BT_TRACE_3(TRACE_LAYER_NCI, TRACE_TYPE_ERROR, m,p1,p2,p3);}
197 #define NCI_TRACE_ERROR4(m,p1,p2,p3,p4)         {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR) BT_TRACE_4(TRACE_LAYER_NCI, TRACE_TYPE_ERROR, m,p1,p2,p3,p4);}
198 #define NCI_TRACE_ERROR5(m,p1,p2,p3,p4,p5)      {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR) BT_TRACE_5(TRACE_LAYER_NCI, TRACE_TYPE_ERROR, m,p1,p2,p3,p4,p5);}
199 #define NCI_TRACE_ERROR6(m,p1,p2,p3,p4,p5,p6)   {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR) BT_TRACE_6(TRACE_LAYER_NCI, TRACE_TYPE_ERROR, m,p1,p2,p3,p4,p5,p6);}
200 
201 #define NCI_TRACE_WARNING0(m)                   {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING) BT_TRACE_0(TRACE_LAYER_NCI, TRACE_TYPE_WARNING, m);}
202 #define NCI_TRACE_WARNING1(m,p1)                {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING) BT_TRACE_1(TRACE_LAYER_NCI, TRACE_TYPE_WARNING, m,p1);}
203 #define NCI_TRACE_WARNING2(m,p1,p2)             {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING) BT_TRACE_2(TRACE_LAYER_NCI, TRACE_TYPE_WARNING, m,p1,p2);}
204 #define NCI_TRACE_WARNING3(m,p1,p2,p3)          {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING) BT_TRACE_3(TRACE_LAYER_NCI, TRACE_TYPE_WARNING, m,p1,p2,p3);}
205 #define NCI_TRACE_WARNING4(m,p1,p2,p3,p4)       {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING) BT_TRACE_4(TRACE_LAYER_NCI, TRACE_TYPE_WARNING, m,p1,p2,p3,p4);}
206 #define NCI_TRACE_WARNING5(m,p1,p2,p3,p4,p5)    {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING) BT_TRACE_5(TRACE_LAYER_NCI, TRACE_TYPE_WARNING, m,p1,p2,p3,p4,p5);}
207 #define NCI_TRACE_WARNING6(m,p1,p2,p3,p4,p5,p6) {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING) BT_TRACE_6(TRACE_LAYER_NCI, TRACE_TYPE_WARNING, m,p1,p2,p3,p4,p5,p6);}
208 
209 #define NCI_TRACE_API0(m)                       {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API) BT_TRACE_0(TRACE_LAYER_NCI, TRACE_TYPE_API, m);}
210 #define NCI_TRACE_API1(m,p1)                    {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API) BT_TRACE_1(TRACE_LAYER_NCI, TRACE_TYPE_API, m,p1);}
211 #define NCI_TRACE_API2(m,p1,p2)                 {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API) BT_TRACE_2(TRACE_LAYER_NCI, TRACE_TYPE_API, m,p1,p2);}
212 #define NCI_TRACE_API3(m,p1,p2,p3)              {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API) BT_TRACE_3(TRACE_LAYER_NCI, TRACE_TYPE_API, m,p1,p2,p3);}
213 #define NCI_TRACE_API4(m,p1,p2,p3,p4)           {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API) BT_TRACE_4(TRACE_LAYER_NCI, TRACE_TYPE_API, m,p1,p2,p3,p4);}
214 #define NCI_TRACE_API5(m,p1,p2,p3,p4,p5)        {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API) BT_TRACE_5(TRACE_LAYER_NCI, TRACE_TYPE_API, m,p1,p2,p3,p4,p5);}
215 #define NCI_TRACE_API6(m,p1,p2,p3,p4,p5,p6)     {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API) BT_TRACE_6(TRACE_LAYER_NCI, TRACE_TYPE_API, m,p1,p2,p3,p4,p5,p6);}
216 
217 #define NCI_TRACE_EVENT0(m)                     {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT) BT_TRACE_0(TRACE_LAYER_NCI, TRACE_TYPE_EVENT, m);}
218 #define NCI_TRACE_EVENT1(m,p1)                  {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT) BT_TRACE_1(TRACE_LAYER_NCI, TRACE_TYPE_EVENT, m, p1);}
219 #define NCI_TRACE_EVENT2(m,p1,p2)               {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT) BT_TRACE_2(TRACE_LAYER_NCI, TRACE_TYPE_EVENT, m,p1,p2);}
220 #define NCI_TRACE_EVENT3(m,p1,p2,p3)            {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT) BT_TRACE_3(TRACE_LAYER_NCI, TRACE_TYPE_EVENT, m,p1,p2,p3);}
221 #define NCI_TRACE_EVENT4(m,p1,p2,p3,p4)         {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT) BT_TRACE_4(TRACE_LAYER_NCI, TRACE_TYPE_EVENT, m,p1,p2,p3,p4);}
222 #define NCI_TRACE_EVENT5(m,p1,p2,p3,p4,p5)      {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT) BT_TRACE_5(TRACE_LAYER_NCI, TRACE_TYPE_EVENT, m,p1,p2,p3,p4,p5);}
223 #define NCI_TRACE_EVENT6(m,p1,p2,p3,p4,p5,p6)   {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT) BT_TRACE_6(TRACE_LAYER_NCI, TRACE_TYPE_EVENT, m,p1,p2,p3,p4,p5,p6);}
224 
225 #define NCI_TRACE_DEBUG0(m)                     {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG) BT_TRACE_0(TRACE_LAYER_NCI, TRACE_TYPE_DEBUG, m);}
226 #define NCI_TRACE_DEBUG1(m,p1)                  {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG) BT_TRACE_1(TRACE_LAYER_NCI, TRACE_TYPE_DEBUG, m,p1);}
227 #define NCI_TRACE_DEBUG2(m,p1,p2)               {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG) BT_TRACE_2(TRACE_LAYER_NCI, TRACE_TYPE_DEBUG, m,p1,p2);}
228 #define NCI_TRACE_DEBUG3(m,p1,p2,p3)            {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG) BT_TRACE_3(TRACE_LAYER_NCI, TRACE_TYPE_DEBUG, m,p1,p2,p3);}
229 #define NCI_TRACE_DEBUG4(m,p1,p2,p3,p4)         {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG) BT_TRACE_4(TRACE_LAYER_NCI, TRACE_TYPE_DEBUG, m,p1,p2,p3,p4);}
230 #define NCI_TRACE_DEBUG5(m,p1,p2,p3,p4,p5)      {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG) BT_TRACE_5(TRACE_LAYER_NCI, TRACE_TYPE_DEBUG, m,p1,p2,p3,p4,p5);}
231 #define NCI_TRACE_DEBUG6(m,p1,p2,p3,p4,p5,p6)   {if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG) BT_TRACE_6(TRACE_LAYER_NCI, TRACE_TYPE_DEBUG, m,p1,p2,p3,p4,p5,p6);}
232 
233 #ifdef __cplusplus
234 extern "C"
235 {
236 #endif
237 
238 extern void LogMsg (UINT32 trace_set_mask, const char *fmt_str, ...);
239 
240 #ifdef __cplusplus
241 }
242 #endif
243 
244 #endif  /* GKI_TARGET_H */
245