compass3d.h

#ifndef _AVRIO_COMPASS3D_H_
#define _AVRIO_COMPASS3D_H_

#include <avrio/defs.h>

__BEGIN_C_DECLS
/* ========================================================================== */
#include <stdio.h>
#include <avrio/button.h>
#include <avrio/vector3f.h>
/* constants ================================================================ */

#define COMPASS3D_NOT_CALIBRATED (1)

/* structures =============================================================== */
typedef struct xCompass3dCalibration {

  int iMin[3];
  int iMax[3];
} xCompass3dCalibration;

/* internal public functions ================================================ */
int  iCompass3dInit (void);

int iCompass3dCalibrate (FILE * xOutStream, xButMask xBut);

void vCompass3dSetCalibration (const xCompass3dCalibration * xCalibration);

void vCompass3dClearCalibration (void);

void vCompass3dCalibration (xCompass3dCalibration * xCalibration);

int iCompass3dRead (float * fMag);

int iCompass3dHeading (const float * fAtt, const float * fMag, float fMagDeclinaison);

float fCompass3dHeadingRadian (const float * fAtt, const float * fMag, float fMagDeclinaison);

int iCompass3dHeadingFrom (const float * fFrom);

int iCompass3dReadRaw (int * iMag);

__END_C_DECLS
/* ========================================================================== */
#endif  /* _AVRIO_COMPASS3D_H_ not defined */