| /* |
| * Copyright (C) 2012 The Android Open Source Project |
| * |
| * 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 COMPASS_SENSOR_H |
| #define COMPASS_SENSOR_H |
| |
| #include <stdint.h> |
| #include <errno.h> |
| #include <sys/cdefs.h> |
| #include <sys/types.h> |
| |
| #include "SensorBase.h" |
| |
| // TODO: include 3rd-party compass vendor's header file |
| // p.s.: before using unified HAL, make sure 3rd-party compass |
| // solution's driver/HAL work well by themselves |
| #include "AkmSensor.h" |
| |
| /*****************************************************************************/ |
| |
| class CompassSensor : public SensorBase { |
| |
| protected: |
| |
| public: |
| CompassSensor(); |
| virtual ~CompassSensor(); |
| |
| // TODO: make sure either 3rd-party compass solution has following virtual |
| // functions, or SensorBase.cpp could provide equal functionalities |
| virtual int getFd() const; |
| virtual int getRawFd() {return 0;}; |
| virtual int enable(int32_t handle, int enabled); |
| virtual int setDelay(int32_t handle, int64_t ns); |
| virtual int getEnable(int32_t handle); |
| virtual int64_t getDelay(int32_t handle); |
| virtual int64_t getMinDelay() { return -1; } // stub |
| |
| // TODO: unnecessary for MPL solution (override 3rd-party solution) |
| virtual int readEvents(sensors_event_t *data, int count) { return 0; } |
| |
| // TODO: following four APIs need further implementation for MPL's |
| // reference (look into .cpp for detailed information, also refer to |
| // 3rd-party's readEvents() for relevant APIs) |
| int readSample(long *data, int64_t *timestamp); |
| int readRawSample(float *data, int64_t *timestamp); |
| void fillList(struct sensor_t *list); |
| void getOrientationMatrix(signed char *orient); |
| int getAccuracy(); |
| virtual void getCompassBias(long *bias) {return;}; |
| |
| // TODO: if 3rd-party provides calibrated compass data, just return 1 |
| int providesCalibration() { return 1; } |
| |
| // TODO: hard-coded for 3rd-party's sensitivity transformation |
| long getSensitivity() { return (1L << 30); } |
| |
| /* all 3rd pary solution have compasses on the primary bus, hence they |
| have no dependency on the MPU */ |
| int isIntegrated() { return 0; } |
| |
| int checkCoilsReset(void) { return 0; }; |
| int isYasCompass(void) { return 0; }; |
| |
| private: |
| AkmSensor *mCompassSensor; |
| }; |
| |
| /*****************************************************************************/ |
| |
| #endif // COMPASS_SENSOR_H |