C++程序  |  438行  |  18.17 KB

/******************************************************************************
 *
 *  Copyright (C) 2012-2014 Broadcom Corporation
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at:
 *
 *  http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 ******************************************************************************/

#ifndef NFC_HAL_TARGET_H
#define NFC_HAL_TARGET_H

#include "data_types.h"
#include "gki.h"

/****************************************************************************
** NCI related configuration
****************************************************************************/

/* Initial Max Control Packet Payload Size (until receiving payload size in
 * INIT_CORE_RSP) */
#ifndef NFC_HAL_NCI_INIT_CTRL_PAYLOAD_SIZE
#define NFC_HAL_NCI_INIT_CTRL_PAYLOAD_SIZE 0xFF
#endif

/* Number of bytes to reserve in front of NCI messages (e.g. for transport
 * header) */
#ifndef NFC_HAL_NCI_MSG_OFFSET_SIZE
#define NFC_HAL_NCI_MSG_OFFSET_SIZE 1
#endif

/* NFC-WAKE */
#ifndef NFC_HAL_LP_NFC_WAKE_GPIO
#define NFC_HAL_LP_NFC_WAKE_GPIO UPIO_GENERAL3
#endif

/* NFCC snooze mode idle timeout before deassert NFC_WAKE in ms */
#ifndef NFC_HAL_LP_IDLE_TIMEOUT
#define NFC_HAL_LP_IDLE_TIMEOUT 100
#endif

/* NFC snooze mode */
#ifndef NFC_HAL_LP_SNOOZE_MODE
#define NFC_HAL_LP_SNOOZE_MODE NFC_HAL_LP_SNOOZE_MODE_UART
#endif

/* Idle Threshold Host in 100ms unit */
#ifndef NFC_HAL_LP_IDLE_THRESHOLD_HOST
#define NFC_HAL_LP_IDLE_THRESHOLD_HOST 0
#endif

/* Idle Threshold HC in 100ms unit */
#ifndef NFC_HAL_LP_IDLE_THRESHOLD_HC
#define NFC_HAL_LP_IDLE_THRESHOLD_HC 0
#endif

/* Default NFCC power-up baud rate */
#ifndef NFC_HAL_DEFAULT_BAUD
#define NFC_HAL_DEFAULT_BAUD USERIAL_BAUD_115200
#endif

/* time (in ms) between power off and on NFCC */
#ifndef NFC_HAL_POWER_CYCLE_DELAY
#define NFC_HAL_POWER_CYCLE_DELAY 100
#endif

/* time (in ms) between power off and on NFCC */
#ifndef NFC_HAL_NFCC_ENABLE_TIMEOUT
#define NFC_HAL_NFCC_ENABLE_TIMEOUT 1000
#endif

#ifndef NFC_HAL_PRM_DEBUG
#define NFC_HAL_PRM_DEBUG TRUE
#endif

/* max patch data length (Can be overridden by platform for ACL HCI command
 * size) */
#ifndef NFC_HAL_PRM_HCD_CMD_MAXLEN
#define NFC_HAL_PRM_HCD_CMD_MAXLEN 250
#endif

/* Require PreI2C patch by default */
#ifndef NFC_HAL_PRE_I2C_PATCH_INCLUDED
#define NFC_HAL_PRE_I2C_PATCH_INCLUDED TRUE
#endif

/* Mininum payload size for SPD NCI commands (used to validate
 * HAL_NfcPrmSetSpdNciCmdPayloadSize) */
/* Default is 32, as required by the NCI specifications; however this value may
 * be          */
/* over-riden for platforms that have transport packet limitations */
#ifndef NFC_HAL_PRM_MIN_NCI_CMD_PAYLOAD_SIZE
#define NFC_HAL_PRM_MIN_NCI_CMD_PAYLOAD_SIZE (32)
#endif

/* amount of time to wait for authenticating/committing patch to NVM */
#ifndef NFC_HAL_PRM_COMMIT_DELAY
#define NFC_HAL_PRM_COMMIT_DELAY (30000)
#endif

/* amount of time to wait after downloading preI2C patch before downloading
 * LPM/FPM patch */
#ifndef NFC_HAL_PRM_POST_I2C_FIX_DELAY
#define NFC_HAL_PRM_POST_I2C_FIX_DELAY (200)
#endif

/* NFCC will respond to more than one technology during listen discovery  */
#ifndef NFC_HAL_DM_MULTI_TECH_RESP
#define NFC_HAL_DM_MULTI_TECH_RESP TRUE
#endif

/* Data rate for 15693 command/response, it must be same as
 * RW_I93_FLAG_DATA_RATE in nfc_target.h */
#define NFC_HAL_I93_FLAG_DATA_RATE_LOW 0x00
#define NFC_HAL_I93_FLAG_DATA_RATE_HIGH 0x02

#ifndef NFC_HAL_I93_FLAG_DATA_RATE
#define NFC_HAL_I93_FLAG_DATA_RATE NFC_HAL_I93_FLAG_DATA_RATE_HIGH
#endif

/* NFC HAL HCI */
#ifndef NFC_HAL_HCI_INCLUDED
#define NFC_HAL_HCI_INCLUDED TRUE
#endif

/* Quick Timer */
#ifndef QUICK_TIMER_TICKS_PER_SEC
#define QUICK_TIMER_TICKS_PER_SEC 100 /* 10ms timer */
#endif

#ifndef NFC_HAL_SHARED_TRANSPORT_ENABLED
#define NFC_HAL_SHARED_TRANSPORT_ENABLED FALSE
#endif

/* Enable verbose tracing by default */
#ifndef NFC_HAL_TRACE_VERBOSE
#define NFC_HAL_TRACE_VERBOSE TRUE
#endif

#ifndef NFC_HAL_INITIAL_TRACE_LEVEL
#define NFC_HAL_INITIAL_TRACE_LEVEL 5
#endif

/* Map NFC serial port to USERIAL_PORT_6 by default */
#ifndef USERIAL_NFC_PORT
#define USERIAL_NFC_PORT (USERIAL_PORT_6)
#endif

/* Restore NFCC baud rate to default on shutdown if baud rate was updated */
#ifndef NFC_HAL_RESTORE_BAUD_ON_SHUTDOWN
#define NFC_HAL_RESTORE_BAUD_ON_SHUTDOWN TRUE
#endif

/* Enable protocol tracing by default */
#ifndef NFC_HAL_TRACE_PROTOCOL
#define NFC_HAL_TRACE_PROTOCOL TRUE
#endif

/* Legacy protocol-trace-enable macro */
#ifndef BT_TRACE_PROTOCOL
#define BT_TRACE_PROTOCOL (NFC_HAL_TRACE_PROTOCOL)
#endif

/* Enable HAL tracing by default */
#ifndef NFC_HAL_USE_TRACES
#define NFC_HAL_USE_TRACES TRUE
#endif

/* HAL trace macros */
#if (NFC_HAL_USE_TRACES == TRUE)
#define NCI_TRACE_0(l, t, m) \
  LogMsg((TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t)), (m))
#define NCI_TRACE_1(l, t, m, p1) \
  LogMsg(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t), (m), (uintptr_t)(p1))
#define NCI_TRACE_2(l, t, m, p1, p2)                            \
  LogMsg(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t), (m), \
         (uintptr_t)(p1), (uintptr_t)(p2))
#define NCI_TRACE_3(l, t, m, p1, p2, p3)                        \
  LogMsg(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t), (m), \
         (uintptr_t)(p1), (uintptr_t)(p2), (uintptr_t)(p3))
#define NCI_TRACE_4(l, t, m, p1, p2, p3, p4)                    \
  LogMsg(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t), (m), \
         (uintptr_t)(p1), (uintptr_t)(p2), (uintptr_t)(p3), (uintptr_t)(p4))
#define NCI_TRACE_5(l, t, m, p1, p2, p3, p4, p5)                             \
  LogMsg(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t), (m),              \
         (uintptr_t)(p1), (uintptr_t)(p2), (uintptr_t)(p3), (uintptr_t)(p4), \
         (uintptr_t)(p5))
#define NCI_TRACE_6(l, t, m, p1, p2, p3, p4, p5, p6)                         \
  LogMsg(TRACE_CTRL_GENERAL | (l) | TRACE_ORG_STACK | (t), (m),              \
         (uintptr_t)(p1), (uintptr_t)(p2), (uintptr_t)(p3), (uintptr_t)(p4), \
         (uintptr_t)(p5), (uintptr_t)(p6))

#define HAL_TRACE_ERROR0(m)                              \
  {                                                      \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR)  \
      NCI_TRACE_0(TRACE_LAYER_HAL, TRACE_TYPE_ERROR, m); \
  }
#define HAL_TRACE_ERROR1(m, p1)                              \
  {                                                          \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR)      \
      NCI_TRACE_1(TRACE_LAYER_HAL, TRACE_TYPE_ERROR, m, p1); \
  }
#define HAL_TRACE_ERROR2(m, p1, p2)                              \
  {                                                              \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR)          \
      NCI_TRACE_2(TRACE_LAYER_HAL, TRACE_TYPE_ERROR, m, p1, p2); \
  }
#define HAL_TRACE_ERROR3(m, p1, p2, p3)                              \
  {                                                                  \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR)              \
      NCI_TRACE_3(TRACE_LAYER_HAL, TRACE_TYPE_ERROR, m, p1, p2, p3); \
  }
#define HAL_TRACE_ERROR4(m, p1, p2, p3, p4)                              \
  {                                                                      \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR)                  \
      NCI_TRACE_4(TRACE_LAYER_HAL, TRACE_TYPE_ERROR, m, p1, p2, p3, p4); \
  }
#define HAL_TRACE_ERROR5(m, p1, p2, p3, p4, p5)                              \
  {                                                                          \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR)                      \
      NCI_TRACE_5(TRACE_LAYER_HAL, TRACE_TYPE_ERROR, m, p1, p2, p3, p4, p5); \
  }
#define HAL_TRACE_ERROR6(m, p1, p2, p3, p4, p5, p6)                         \
  {                                                                         \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_ERROR)                     \
      NCI_TRACE_6(TRACE_LAYER_HAL, TRACE_TYPE_ERROR, m, p1, p2, p3, p4, p5, \
                  p6);                                                      \
  }

#define HAL_TRACE_WARNING0(m)                              \
  {                                                        \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING)  \
      NCI_TRACE_0(TRACE_LAYER_HAL, TRACE_TYPE_WARNING, m); \
  }
#define HAL_TRACE_WARNING1(m, p1)                              \
  {                                                            \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING)      \
      NCI_TRACE_1(TRACE_LAYER_HAL, TRACE_TYPE_WARNING, m, p1); \
  }
#define HAL_TRACE_WARNING2(m, p1, p2)                              \
  {                                                                \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING)          \
      NCI_TRACE_2(TRACE_LAYER_HAL, TRACE_TYPE_WARNING, m, p1, p2); \
  }
#define HAL_TRACE_WARNING3(m, p1, p2, p3)                              \
  {                                                                    \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING)              \
      NCI_TRACE_3(TRACE_LAYER_HAL, TRACE_TYPE_WARNING, m, p1, p2, p3); \
  }
#define HAL_TRACE_WARNING4(m, p1, p2, p3, p4)                              \
  {                                                                        \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING)                  \
      NCI_TRACE_4(TRACE_LAYER_HAL, TRACE_TYPE_WARNING, m, p1, p2, p3, p4); \
  }
#define HAL_TRACE_WARNING5(m, p1, p2, p3, p4, p5)                              \
  {                                                                            \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING)                      \
      NCI_TRACE_5(TRACE_LAYER_HAL, TRACE_TYPE_WARNING, m, p1, p2, p3, p4, p5); \
  }
#define HAL_TRACE_WARNING6(m, p1, p2, p3, p4, p5, p6)                         \
  {                                                                           \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_WARNING)                     \
      NCI_TRACE_6(TRACE_LAYER_HAL, TRACE_TYPE_WARNING, m, p1, p2, p3, p4, p5, \
                  p6);                                                        \
  }

#define HAL_TRACE_API0(m)                              \
  {                                                    \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API)  \
      NCI_TRACE_0(TRACE_LAYER_HAL, TRACE_TYPE_API, m); \
  }
#define HAL_TRACE_API1(m, p1)                              \
  {                                                        \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API)      \
      NCI_TRACE_1(TRACE_LAYER_HAL, TRACE_TYPE_API, m, p1); \
  }
#define HAL_TRACE_API2(m, p1, p2)                              \
  {                                                            \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API)          \
      NCI_TRACE_2(TRACE_LAYER_HAL, TRACE_TYPE_API, m, p1, p2); \
  }
#define HAL_TRACE_API3(m, p1, p2, p3)                              \
  {                                                                \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API)              \
      NCI_TRACE_3(TRACE_LAYER_HAL, TRACE_TYPE_API, m, p1, p2, p3); \
  }
#define HAL_TRACE_API4(m, p1, p2, p3, p4)                              \
  {                                                                    \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API)                  \
      NCI_TRACE_4(TRACE_LAYER_HAL, TRACE_TYPE_API, m, p1, p2, p3, p4); \
  }
#define HAL_TRACE_API5(m, p1, p2, p3, p4, p5)                              \
  {                                                                        \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API)                      \
      NCI_TRACE_5(TRACE_LAYER_HAL, TRACE_TYPE_API, m, p1, p2, p3, p4, p5); \
  }
#define HAL_TRACE_API6(m, p1, p2, p3, p4, p5, p6)                              \
  {                                                                            \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_API)                          \
      NCI_TRACE_6(TRACE_LAYER_HAL, TRACE_TYPE_API, m, p1, p2, p3, p4, p5, p6); \
  }

#define HAL_TRACE_EVENT0(m)                              \
  {                                                      \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT)  \
      NCI_TRACE_0(TRACE_LAYER_HAL, TRACE_TYPE_EVENT, m); \
  }
#define HAL_TRACE_EVENT1(m, p1)                              \
  {                                                          \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT)      \
      NCI_TRACE_1(TRACE_LAYER_HAL, TRACE_TYPE_EVENT, m, p1); \
  }
#define HAL_TRACE_EVENT2(m, p1, p2)                              \
  {                                                              \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT)          \
      NCI_TRACE_2(TRACE_LAYER_HAL, TRACE_TYPE_EVENT, m, p1, p2); \
  }
#define HAL_TRACE_EVENT3(m, p1, p2, p3)                              \
  {                                                                  \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT)              \
      NCI_TRACE_3(TRACE_LAYER_HAL, TRACE_TYPE_EVENT, m, p1, p2, p3); \
  }
#define HAL_TRACE_EVENT4(m, p1, p2, p3, p4)                              \
  {                                                                      \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT)                  \
      NCI_TRACE_4(TRACE_LAYER_HAL, TRACE_TYPE_EVENT, m, p1, p2, p3, p4); \
  }
#define HAL_TRACE_EVENT5(m, p1, p2, p3, p4, p5)                              \
  {                                                                          \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT)                      \
      NCI_TRACE_5(TRACE_LAYER_HAL, TRACE_TYPE_EVENT, m, p1, p2, p3, p4, p5); \
  }
#define HAL_TRACE_EVENT6(m, p1, p2, p3, p4, p5, p6)                         \
  {                                                                         \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_EVENT)                     \
      NCI_TRACE_6(TRACE_LAYER_HAL, TRACE_TYPE_EVENT, m, p1, p2, p3, p4, p5, \
                  p6);                                                      \
  }

#define HAL_TRACE_DEBUG0(m)                              \
  {                                                      \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG)  \
      NCI_TRACE_0(TRACE_LAYER_HAL, TRACE_TYPE_DEBUG, m); \
  }
#define HAL_TRACE_DEBUG1(m, p1)                              \
  {                                                          \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG)      \
      NCI_TRACE_1(TRACE_LAYER_HAL, TRACE_TYPE_DEBUG, m, p1); \
  }
#define HAL_TRACE_DEBUG2(m, p1, p2)                              \
  {                                                              \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG)          \
      NCI_TRACE_2(TRACE_LAYER_HAL, TRACE_TYPE_DEBUG, m, p1, p2); \
  }
#define HAL_TRACE_DEBUG3(m, p1, p2, p3)                              \
  {                                                                  \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG)              \
      NCI_TRACE_3(TRACE_LAYER_HAL, TRACE_TYPE_DEBUG, m, p1, p2, p3); \
  }
#define HAL_TRACE_DEBUG4(m, p1, p2, p3, p4)                              \
  {                                                                      \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG)                  \
      NCI_TRACE_4(TRACE_LAYER_HAL, TRACE_TYPE_DEBUG, m, p1, p2, p3, p4); \
  }
#define HAL_TRACE_DEBUG5(m, p1, p2, p3, p4, p5)                              \
  {                                                                          \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG)                      \
      NCI_TRACE_5(TRACE_LAYER_HAL, TRACE_TYPE_DEBUG, m, p1, p2, p3, p4, p5); \
  }
#define HAL_TRACE_DEBUG6(m, p1, p2, p3, p4, p5, p6)                         \
  {                                                                         \
    if (nfc_hal_cb.trace_level >= BT_TRACE_LEVEL_DEBUG)                     \
      NCI_TRACE_6(TRACE_LAYER_HAL, TRACE_TYPE_DEBUG, m, p1, p2, p3, p4, p5, \
                  p6);                                                      \
  }

#else /* Disable HAL tracing */

#define HAL_TRACE_0(l, t, m)
#define HAL_TRACE_1(l, t, m, p1)
#define HAL_TRACE_2(l, t, m, p1, p2)
#define HAL_TRACE_3(l, t, m, p1, p2, p3)
#define HAL_TRACE_4(l, t, m, p1, p2, p3, p4)
#define HAL_TRACE_5(l, t, m, p1, p2, p3, p4, p5)
#define HAL_TRACE_6(l, t, m, p1, p2, p3, p4, p5, p6)

#define HAL_TRACE_ERROR0(m)
#define HAL_TRACE_ERROR1(m, p1)
#define HAL_TRACE_ERROR2(m, p1, p2)
#define HAL_TRACE_ERROR3(m, p1, p2, p3)
#define HAL_TRACE_ERROR4(m, p1, p2, p3, p4)
#define HAL_TRACE_ERROR5(m, p1, p2, p3, p4, p5)
#define HAL_TRACE_ERROR6(m, p1, p2, p3, p4, p5, p6)

#define HAL_TRACE_WARNING0(m)
#define HAL_TRACE_WARNING1(m, p1)
#define HAL_TRACE_WARNING2(m, p1, p2)
#define HAL_TRACE_WARNING3(m, p1, p2, p3)
#define HAL_TRACE_WARNING4(m, p1, p2, p3, p4)
#define HAL_TRACE_WARNING5(m, p1, p2, p3, p4, p5)
#define HAL_TRACE_WARNING6(m, p1, p2, p3, p4, p5, p6)

#define HAL_TRACE_API0(m)
#define HAL_TRACE_API1(m, p1)
#define HAL_TRACE_API2(m, p1, p2)
#define HAL_TRACE_API3(m, p1, p2, p3)
#define HAL_TRACE_API4(m, p1, p2, p3, p4)
#define HAL_TRACE_API5(m, p1, p2, p3, p4, p5)
#define HAL_TRACE_API6(m, p1, p2, p3, p4, p5, p6)

#define HAL_TRACE_EVENT0(m)
#define HAL_TRACE_EVENT1(m, p1)
#define HAL_TRACE_EVENT2(m, p1, p2)
#define HAL_TRACE_EVENT3(m, p1, p2, p3)
#define HAL_TRACE_EVENT4(m, p1, p2, p3, p4)
#define HAL_TRACE_EVENT5(m, p1, p2, p3, p4, p5)
#define HAL_TRACE_EVENT6(m, p1, p2, p3, p4, p5, p6)

#define HAL_TRACE_DEBUG0(m)
#define HAL_TRACE_DEBUG1(m, p1)
#define HAL_TRACE_DEBUG2(m, p1, p2)
#define HAL_TRACE_DEBUG3(m, p1, p2, p3)
#define HAL_TRACE_DEBUG4(m, p1, p2, p3, p4)
#define HAL_TRACE_DEBUG5(m, p1, p2, p3, p4, p5)
#define HAL_TRACE_DEBUG6(m, p1, p2, p3, p4, p5, p6)
#endif /* Disable HAL tracing */

#endif /* GKI_TARGET_H */