82 lines
2.8 KiB
TypeScript
82 lines
2.8 KiB
TypeScript
/**
|
|
* Ambient light sensor access through the custom firmware (CFW image-handler
|
|
* mode 16; see g2flash/patches/als_sensor.c).
|
|
*
|
|
* The stock firmware only reads its OPT3001 light sensor while auto-brightness
|
|
* is on, and then steps the panel brightness itself (visible flicker). The CFW
|
|
* adds two things:
|
|
*
|
|
* - QUERY: one report from the driver's current state.
|
|
* - PASSIVE polling: the firmware opens and polls the sensor at our interval,
|
|
* the stock adjuster never touches the panel, and a report arrives when the
|
|
* reading moved by at least `minDelta` or `heartbeatMs` elapsed. The phone
|
|
* then applies brightness itself (setBrightness with autoAdjust=false), e.g.
|
|
* only while the display is blank or during a UI transition.
|
|
*
|
|
* Reports are 24-byte ['A','L',version,...] records on settings field 105.
|
|
*/
|
|
import { toUint8Array } from "../util/array-util";
|
|
import {
|
|
decodeAmbientLightReport,
|
|
resolvePollingOptions,
|
|
type AmbientLightPollingOptions,
|
|
type AmbientLightReport,
|
|
} from "./ambient-light-types";
|
|
|
|
declare const com: any;
|
|
declare const global: any;
|
|
|
|
export * from "./ambient-light-types";
|
|
|
|
function activeCommunicator(): any {
|
|
if (!global.isAndroid) return null;
|
|
try {
|
|
return com.faceclaw.app.FaceclawBleCommunicator.getActive();
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/** Ask the firmware for one ambient-light report (delivered to listeners). */
|
|
export function queryAmbientLight(): void {
|
|
try {
|
|
activeCommunicator()?.queryAmbientLight();
|
|
} catch (error) {
|
|
console.warn(`queryAmbientLight failed: ${error}`);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Start or stop CFW passive light-sensor polling. Starting is idempotent and
|
|
* re-opens the sensor if the stock firmware closed it, so it is safe to resend
|
|
* on every session start.
|
|
*/
|
|
export function setAmbientLightPolling(enabled: boolean, options: AmbientLightPollingOptions = {}): void {
|
|
const { intervalMs, minDelta, heartbeatMs, bindToLease } = resolvePollingOptions(options);
|
|
try {
|
|
activeCommunicator()?.setAmbientLightPolling(enabled, intervalMs, minDelta, heartbeatMs, bindToLease);
|
|
} catch (error) {
|
|
console.warn(`setAmbientLightPolling failed: ${error}`);
|
|
}
|
|
}
|
|
|
|
/** Subscribe to decoded ambient-light reports. Delivered on the main thread. */
|
|
export function addAmbientLightListener(listener: (report: AmbientLightReport) => void): () => void {
|
|
const active = activeCommunicator();
|
|
if (!active) return () => {};
|
|
const proxy = new com.faceclaw.app.FaceclawAmbientLightListener({
|
|
onAmbientLight: (body: any) => {
|
|
const report = decodeAmbientLightReport(toUint8Array(body));
|
|
if (report) listener(report);
|
|
},
|
|
});
|
|
active.addAmbientLightListener(proxy);
|
|
return () => {
|
|
try {
|
|
activeCommunicator()?.removeAmbientLightListener(proxy);
|
|
} catch {
|
|
// The communicator may have been replaced during a disconnect.
|
|
}
|
|
};
|
|
}
|