1 /****************************************************************************** 2 * 3 * Copyright (C) 2003-2014 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 19 /****************************************************************************** 20 * 21 * This is the interface file for storing nv data 22 * 23 ******************************************************************************/ 24 #ifndef NFC_HAL_NV_CO_H 25 #define NFC_HAL_NV_CO_H 26 27 #include "nfc_hal_target.h" 28 29 #if (NFC_HAL_HCI_INCLUDED == TRUE) 30 31 #include <time.h> 32 33 /***************************************************************************** 34 ** Constants and Data Types 35 *****************************************************************************/ 36 37 /************************** 38 ** Common Definitions 39 ***************************/ 40 41 /* Status codes returned by call-out functions, or in call-in functions as 42 * status */ 43 #define NFC_HAL_NV_CO_OK 0x00 44 #define NFC_HAL_NV_CO_FAIL 0x01 /* Used to pass all other errors */ 45 #define NFC_HAL_NV_CO_EACCES 0x02 46 #define NFC_HAL_NV_CO_ENOTEMPTY 0x03 47 #define NFC_HAL_NV_CO_EOF 0x04 48 #define NFC_HAL_NV_CO_EODIR 0x05 49 /* Returned in nfa_nv_ci_open if no room */ 50 #define NFC_HAL_NV_CO_ENOSPACE 0x06 51 #define NFC_HAL_NV_CO_EIS_DIR 0x07 52 #define NFC_HAL_NV_CO_RESUME 0x08 /* used in nfa_nv_ci_open, on resume */ 53 /* used in nfa_nv_ci_open, on resume (no file to resume) */ 54 #define NFC_HAL_NV_CO_NONE 0x09 55 56 typedef uint8_t tNFC_HAL_NV_CO_STATUS; 57 58 #define DH_NV_BLOCK 0x01 59 #define HC_F3_NV_BLOCK 0x02 60 #define HC_F4_NV_BLOCK 0x03 61 #define HC_F2_NV_BLOCK 0x04 62 #define HC_F5_NV_BLOCK 0x05 63 64 /***************************************************************************** 65 ** Function Declarations 66 *****************************************************************************/ 67 /************************** 68 ** Common Functions 69 ***************************/ 70 71 /******************************************************************************* 72 ** 73 ** Function nfc_hal_nv_co_read 74 ** 75 ** Description This function is called by NFA to read in data from the 76 ** previously opened file. 77 ** 78 ** Parameters p_buf - buffer to read the data into. 79 ** nbytes - number of bytes to read into the buffer. 80 ** 81 ** Returns void 82 ** 83 ** Note: Upon completion of the request, nfa_nv_ci_read () is 84 ** called with the buffer of data, along with the number 85 ** of bytes read into the buffer, and a status. The 86 ** call-in function should only be called when ALL 87 ** requested bytes have been read, the end of file has 88 ** been detected, or an error has occurred. 89 ** 90 *******************************************************************************/ 91 void nfc_hal_nv_co_read(uint8_t* p_buf, uint16_t nbytes, uint8_t block); 92 93 /******************************************************************************* 94 ** 95 ** Function nfc_hal_nv_co_write 96 ** 97 ** Description This function is called by io to send file data to the 98 ** phone. 99 ** 100 ** Parameters p_buf - buffer to read the data from. 101 ** nbytes - number of bytes to write out to the file. 102 ** 103 ** Returns void 104 ** 105 ** Note: Upon completion of the request, nfa_nv_ci_write () is 106 ** called with the file descriptor and the status. The 107 ** call-in function should only be called when ALL 108 ** requested bytes have been written, or an error has 109 ** been detected, 110 ** 111 *******************************************************************************/ 112 void nfc_hal_nv_co_write(const uint8_t* p_buf, uint16_t nbytes, uint8_t block); 113 114 #endif /* NFC_HAL_HCI_INCLUDED */ 115 #endif /* NFC_HAL_NV_CO_H */ 116