forked from Blendman974/faceclaw
78 lines
2.6 KiB
TypeScript
78 lines
2.6 KiB
TypeScript
declare const com: any;
|
|
declare const global: any;
|
|
|
|
export const COMPASS_CHANGED = 15;
|
|
export const COMPASS_CALIBRATION_STARTED = 16;
|
|
export const COMPASS_CALIBRATION_COMPLETE = 17;
|
|
|
|
export type CompassDiagnostics = {
|
|
/** 0 uncalibrated .. 3 well calibrated; -1 unavailable. */
|
|
magneticAccuracy: number;
|
|
/** 0 none, 1 small/temperature, 2 large; -1 unavailable. */
|
|
magneticAnomalies: number;
|
|
/** 0 unknown, 1 GRV (relative), 2 GMRV, 3 RV. */
|
|
orientationSource: number;
|
|
flags: number;
|
|
sampleTimeMs: number;
|
|
};
|
|
|
|
export type CompassEvent = {
|
|
command: number;
|
|
/** Magnetic heading in degrees, or -1 for calibration-only events. */
|
|
headingDegrees: number;
|
|
/** Absent with stock/older CFW or an unrecognized diagnostic extension. */
|
|
diagnostics?: CompassDiagnostics;
|
|
};
|
|
|
|
function activeCommunicator(): any {
|
|
if (!global.isAndroid) return null;
|
|
try {
|
|
return com.faceclaw.app.FaceclawBleCommunicator.getActive();
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Request CFW mode 10 to start/stop the stock firmware compass on behalf of
|
|
* `owner`. The magnetometer is shared: it runs while any owner wants it and
|
|
* stops once the last one releases it, so apps can't switch each other off.
|
|
*/
|
|
export function setCompassEnabled(enabled: boolean, owner = "compass"): void {
|
|
try {
|
|
activeCommunicator()?.setCompassEnabled(owner, enabled);
|
|
} catch (error) {
|
|
console.warn(`setCompassEnabled failed: ${error}`);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Subscribe to stock compass heading/calibration notifications. Events are
|
|
* delivered on the calling thread's Looper, so this works from app workers.
|
|
*/
|
|
export function addCompassListener(listener: (event: CompassEvent) => void): () => void {
|
|
const active = activeCommunicator();
|
|
if (!active) return () => {};
|
|
const proxy = new com.faceclaw.app.FaceclawCompassListener({
|
|
onCompassEvent: (command: number, headingDegrees: number, magneticAccuracy: number,
|
|
magneticAnomalies: number, orientationSource: number, diagnosticFlags: number, sampleTimeMs: number) => {
|
|
listener({
|
|
command: Number(command), headingDegrees: Number(headingDegrees),
|
|
diagnostics: diagnosticFlags >= 0 ? {
|
|
magneticAccuracy: Number(magneticAccuracy), magneticAnomalies: Number(magneticAnomalies),
|
|
orientationSource: Number(orientationSource), flags: Number(diagnosticFlags),
|
|
sampleTimeMs: Number(sampleTimeMs),
|
|
} : undefined,
|
|
});
|
|
},
|
|
});
|
|
active.addCompassListener(proxy);
|
|
return () => {
|
|
try {
|
|
activeCommunicator()?.removeCompassListener(proxy);
|
|
} catch {
|
|
// The communicator may have been replaced during a disconnect.
|
|
}
|
|
};
|
|
}
|