Home | History | Annotate | Download | only in hardware
      1 /*
      2  * Copyright (C) 2011 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 
     18 #ifndef ANDROID_NFC_HAL_INTERFACE_H
     19 #define ANDROID_NFC_HAL_INTERFACE_H
     20 
     21 #include <stdint.h>
     22 #include <strings.h>
     23 #include <sys/cdefs.h>
     24 #include <sys/types.h>
     25 
     26 #include <hardware/hardware.h>
     27 
     28 __BEGIN_DECLS
     29 
     30 #define NFC_HARDWARE_MODULE_ID "nfc"
     31 
     32 /*
     33  * Begin PN544 specific HAL
     34  */
     35 #define NFC_PN544_CONTROLLER "pn544"
     36 
     37 typedef struct nfc_module_t {
     38     struct hw_module_t common;
     39 } nfc_module_t;
     40 
     41 /*
     42  * PN544 linktypes.
     43  * UART
     44  * I2C
     45  * USB (uses UART DAL)
     46  */
     47 typedef enum {
     48     PN544_LINK_TYPE_UART,
     49     PN544_LINK_TYPE_I2C,
     50     PN544_LINK_TYPE_USB,
     51     PN544_LINK_TYPE_INVALID,
     52 } nfc_pn544_linktype;
     53 
     54 typedef struct {
     55     struct hw_device_t common;
     56 
     57     /* The number of EEPROM registers to write */
     58     uint32_t num_eeprom_settings;
     59 
     60     /* The actual EEPROM settings
     61      * For PN544, each EEPROM setting is a 4-byte entry,
     62      * of the format [0x00, addr_msb, addr_lsb, value].
     63      */
     64     uint8_t* eeprom_settings;
     65 
     66     /* The link type to which the PN544 is connected */
     67     nfc_pn544_linktype linktype;
     68 
     69     /* The device node to which the PN544 is connected */
     70     const char* device_node;
     71 
     72     /* On Crespo we had an I2C issue that would cause us to sometimes read
     73      * the I2C slave address (0x57) over the bus. libnfc contains
     74      * a hack to ignore this byte and try to read the length byte
     75      * again.
     76      * Set to 0 to disable the workaround, 1 to enable it.
     77      */
     78     uint8_t enable_i2c_workaround;
     79     /* I2C slave address. Multiple I2C addresses are
     80      * possible for PN544 module. Configure address according to
     81      * board design.
     82      */
     83     uint8_t i2c_device_address;
     84 } nfc_pn544_device_t;
     85 
     86 static inline int nfc_pn544_open(const struct hw_module_t* module,
     87         nfc_pn544_device_t** dev) {
     88     return module->methods->open(module, NFC_PN544_CONTROLLER,
     89         (struct hw_device_t**) dev);
     90 }
     91 
     92 static inline int nfc_pn544_close(nfc_pn544_device_t* dev) {
     93     return dev->common.close(&dev->common);
     94 }
     95 /*
     96  * End PN544 specific HAL
     97  */
     98 
     99 __END_DECLS
    100 
    101 #endif // ANDROID_NFC_HAL_INTERFACE_H
    102