/****************************************************************************** * * Copyright (C) 2012 Asahi Kasei Microdevices Corporation, Japan * * 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 AKMD_INC_AK8975DRIVER_H #define AKMD_INC_AK8975DRIVER_H #include /* Device driver */ #include /* int8_t, int16_t etc. */ /*** Constant definition ******************************************************/ #define AKD_TRUE 1 /*!< Represents true */ #define AKD_FALSE 0 /*!< Represents false */ #define AKD_SUCCESS 1 /*!< Represents success.*/ #define AKD_FAIL 0 /*!< Represents fail. */ #define AKD_ERROR -1 /*!< Represents error. */ /*! 0:Don't Output data, 1:Output data */ #define AKD_DBG_DATA 0 /*! Typical interval in ns */ #define AK8975_MEASUREMENT_TIME_NS ((AK8975_MEASUREMENT_TIME_US) * 1000) /*! 720 LSG = 1G = 9.8 m/s2 */ #define LSG 720 /*** Type declaration *********************************************************/ typedef unsigned char BYTE; /*! Open device driver. This function opens device driver of acceleration sensor. @return If this function succeeds, the return value is #AKD_SUCCESS. Otherwise the return value is #AKD_FAIL. */ typedef int16_t(*ACCFNC_INITDEVICE)(void); /*! Close device driver. This function closes device drivers of acceleration sensor. */ typedef void(*ACCFNC_DEINITDEVICE)(void); /*! Acquire acceleration data from acceleration sensor and convert it to Android coordinate system. @return If this function succeeds, the return value is #AKD_SUCCESS. Otherwise the return value is #AKD_FAIL. @param[out] data A acceleration data array. The coordinate system of the acquired data follows the definition of Android. Unit is SmartCompass. */ typedef int16_t(*ACCFNC_GETACCDATA)(short data[3]); /*** Global variables *********************************************************/ /*** Prototype of Function ***************************************************/ int16_t AKD_InitDevice(void); void AKD_DeinitDevice(void); int16_t AKD_TxData( const BYTE address, const BYTE* data, const uint16_t numberOfBytesToWrite); int16_t AKD_RxData( const BYTE address, BYTE* data, const uint16_t numberOfBytesToRead); int16_t AKD_GetMagneticData(BYTE data[SENSOR_DATA_SIZE]); void AKD_SetYPR(const int buf[YPR_DATA_SIZE]); int AKD_GetOpenStatus(int* status); int AKD_GetCloseStatus(int* status); int16_t AKD_SetMode(const BYTE mode); int16_t AKD_GetDelay(int64_t delay[AKM_NUM_SENSORS]); int16_t AKD_GetLayout(int16_t* layout); int16_t AKD_GetAccelerationData(int16_t data[3]); #endif /* AKMD_INC_AK8975DRIVER_H */