tjbot-ce 3.0.1

package/dist/rpi-drivers/rpi-detect.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * 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.
+ */
+import fs from 'fs';
+class RPiDetect {
+    static model() {
+        let cpuInfo;
+        try {
+            cpuInfo = fs.readFileSync('/proc/cpuinfo', { encoding: 'utf8' });
+        }
+        catch {
+            // likely not a Pi if we can't open /proc/cpuinfo
+            return '';
+        }
+        const modelLine = cpuInfo.split('\n').find((line) => line.startsWith('Model'));
+        if (modelLine === undefined) {
+            return '';
+        }
+        const model = modelLine.split(':')[1].trim();
+        return model;
+    }
+    static isPi3() {
+        const model = RPiDetect.model();
+        return model.startsWith('Raspberry Pi 3');
+    }
+    static isPi4() {
+        const model = RPiDetect.model();
+        return model.startsWith('Raspberry Pi 4');
+    }
+    static isPi5() {
+        const model = RPiDetect.model();
+        return model.startsWith('Raspberry Pi 5');
+    }
+}
+export default RPiDetect;
+//# sourceMappingURL=rpi-detect.js.map

package/dist/rpi-drivers/rpi-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpi-detect.js","sourceRoot":"","sources":["../../src/rpi-drivers/rpi-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,SAAS;IACX,MAAM,CAAC,KAAK;QACR,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACL,iDAAiD;YACjD,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/E,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,KAAK;QACR,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,KAAK;QACR,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,KAAK;QACR,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC9C,CAAC;CACJ;AAED,eAAe,SAAS,CAAC"}

package/dist/rpi-drivers/rpi-driver.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * 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.
+ */
+import { Transform } from 'stream';
+import { CameraController } from '../camera/index.js';
+import { ListenConfig, SeeConfig, ShineConfig, SpeakConfig, WaveConfig } from '../config/index.js';
+import { MicrophoneController } from '../microphone/index.js';
+import { ServoPosition } from '../servo/index.js';
+import { SpeakerController } from '../speaker/index.js';
+import { STTController } from '../stt/stt.js';
+import { TTSController } from '../tts/tts.js';
+import { Capability, Hardware } from '../utils/index.js';
+import { FaceDetectionMetadata, ImageClassificationResult, ImageDescriptionResult, ObjectDetectionResult } from '../vision/index.js';
+import { VisionController } from '../vision/vision.js';
+export declare abstract class RPiHardwareDriver {
+    abstract getHardware(): Set<Hardware>;
+    abstract hasHardware(hardware: Hardware): boolean;
+    abstract hasCapability(capability: Capability): boolean;
+    abstract setupCamera(config: SeeConfig): void;
+    abstract setupLED(config: ShineConfig): Promise<void>;
+    abstract setupLEDCommonAnode(config: ShineConfig['commonanode']): void;
+    abstract setupLEDNeopixel(config: ShineConfig['neopixel']): Promise<void>;
+    abstract setupMicrophone(config: ListenConfig): void;
+    abstract setupServo(config: WaveConfig): void;
+    abstract setupSpeaker(config: SpeakConfig): void;
+    abstract cleanup(): Promise<void>;
+    abstract initializeSTTEngine(): Promise<void>;
+    abstract initializeTTSEngine(): Promise<void>;
+    abstract initializeVisionEngine(): Promise<void>;
+    abstract startMic(): void;
+    abstract pauseMic(): void;
+    abstract resumeMic(): void;
+    abstract stopMic(): void;
+    abstract getMicInputStream(): Transform;
+    abstract listenForTranscript(options?: {
+        onPartialResult?: (text: string) => void;
+        onFinalResult?: (text: string) => void;
+        abortSignal?: AbortSignal;
+    }): Promise<string>;
+    abstract capturePhoto(atPath?: string): Promise<string>;
+    abstract capturePhotoBuffer(): Promise<Buffer>;
+    abstract detectObjects(image: Buffer | string): Promise<ObjectDetectionResult[]>;
+    abstract classifyImage(image: Buffer | string): Promise<ImageClassificationResult[]>;
+    abstract detectFaces(image: Buffer | string): Promise<{
+        isFaceDetected: boolean;
+        metadata: FaceDetectionMetadata[];
+    }>;
+    abstract describeImage(image: Buffer | string): Promise<ImageDescriptionResult>;
+    abstract renderLED(hexColor: string): Promise<void>;
+    abstract renderLEDCommonAnode(rgbColor: [number, number, number]): void;
+    abstract renderLEDNeopixel(hexColor: string): Promise<void>;
+    abstract playAudio(audioPath: string): Promise<void>;
+    abstract speak(message: string): Promise<void>;
+    abstract renderServoPosition(position: ServoPosition): void;
+}
+export declare abstract class RPiBaseHardwareDriver extends RPiHardwareDriver {
+    initializedHardware: Set<Hardware>;
+    protected cameraController?: CameraController;
+    protected microphoneController?: MicrophoneController;
+    protected speakerController?: SpeakerController;
+    protected sttController?: STTController;
+    protected ttsController?: TTSController;
+    protected visionController?: VisionController;
+    protected listenConfig: ListenConfig;
+    protected shineConfig: ShineConfig;
+    protected seeConfig: SeeConfig;
+    protected speakConfig: SpeakConfig;
+    constructor();
+    getHardware(): Set<Hardware>;
+    hasHardware(hardware: Hardware): boolean;
+    hasCapability(capability: Capability): boolean;
+    setupCamera(config: SeeConfig): void;
+    setupLED(config: ShineConfig): Promise<void>;
+    setupMicrophone(config: ListenConfig): void;
+    setupSpeaker(config: SpeakConfig): void;
+    cleanup(): Promise<void>;
+    initializeSTTEngine(): Promise<void>;
+    initializeTTSEngine(): Promise<void>;
+    initializeVisionEngine(): Promise<void>;
+    startMic(): void;
+    pauseMic(): void;
+    resumeMic(): void;
+    stopMic(): void;
+    getMicInputStream(): Transform;
+    listenForTranscript(options?: {
+        onPartialResult?: (text: string) => void;
+        onFinalResult?: (text: string) => void;
+        abortSignal?: AbortSignal;
+    }): Promise<string>;
+    capturePhoto(atPath?: string): Promise<string>;
+    capturePhotoBuffer(): Promise<Buffer>;
+    detectObjects(image: Buffer | string): Promise<ObjectDetectionResult[]>;
+    classifyImage(image: Buffer | string): Promise<ImageClassificationResult[]>;
+    describeImage(image: Buffer | string): Promise<ImageDescriptionResult>;
+    detectFaces(image: Buffer | string): Promise<{
+        isFaceDetected: boolean;
+        metadata: FaceDetectionMetadata[];
+    }>;
+    renderLED(hexColor: string): Promise<void>;
+    playAudio(audioPath: string): Promise<void>;
+    speak(message: string): Promise<void>;
+}
+//# sourceMappingURL=rpi-driver.d.ts.map

package/dist/rpi-drivers/rpi-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpi-driver.d.ts","sourceRoot":"","sources":["../../src/rpi-drivers/rpi-driver.ts"],"names":[],"mappings":"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"}

package/dist/rpi-drivers/rpi-driver.js

@@ -0,0 +1,261 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * 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.
+ */
+import { CameraController } from '../camera/index.js';
+import { MicrophoneController } from '../microphone/index.js';
+import { SpeakerController } from '../speaker/index.js';
+import { STTController } from '../stt/stt.js';
+import { TTSController } from '../tts/tts.js';
+import { Capability, convertHexToRgbColor, Hardware, isCommandAvailable, TJBotError } from '../utils/index.js';
+import { VisionController } from '../vision/vision.js';
+export class RPiHardwareDriver {
+}
+export class RPiBaseHardwareDriver extends RPiHardwareDriver {
+    // initialized hardware
+    initializedHardware;
+    // controllers for hardware components
+    cameraController;
+    microphoneController;
+    speakerController;
+    // controllers for STT, TTS, CV
+    sttController;
+    ttsController;
+    visionController;
+    // cached configuration for listen
+    listenConfig = {};
+    // cached configuration for shine
+    shineConfig = {};
+    // cached configuration for see
+    seeConfig = {};
+    // cached configuration for speak
+    speakConfig = {};
+    constructor() {
+        super();
+        this.initializedHardware = new Set();
+    }
+    getHardware() {
+        return new Set(this.initializedHardware);
+    }
+    hasHardware(hardware) {
+        return this.initializedHardware.has(hardware);
+    }
+    hasCapability(capability) {
+        switch (capability) {
+            case Capability.LISTEN:
+                return this.hasHardware(Hardware.MICROPHONE);
+            case Capability.SEE:
+                return this.hasHardware(Hardware.CAMERA);
+            case Capability.SHINE:
+                return this.hasHardware(Hardware.LED);
+            case Capability.SPEAK:
+                return this.hasHardware(Hardware.SPEAKER);
+            case Capability.WAVE:
+                return this.hasHardware(Hardware.SERVO);
+            default:
+                return false;
+        }
+    }
+    setupCamera(config) {
+        this.cameraController = new CameraController();
+        this.seeConfig = config;
+        const width = config.cameraResolution?.[0] ?? 1920;
+        const height = config.cameraResolution?.[1] ?? 1080;
+        const verticalFlip = config.verticalFlip ?? false;
+        const horizontalFlip = config.horizontalFlip ?? false;
+        const captureTimeout = config.captureTimeout ?? 500;
+        const zeroShutterLag = config.zeroShutterLag ?? false;
+        this.cameraController.initialize([width, height], verticalFlip, horizontalFlip, captureTimeout, zeroShutterLag);
+        this.initializedHardware.add(Hardware.CAMERA);
+    }
+    async setupLED(config) {
+        this.shineConfig = config;
+        if (config.hasCommonAnodeLED) {
+            this.setupLEDCommonAnode(config.commonanode ?? {});
+        }
+        if (config.hasNeopixelLED) {
+            await this.setupLEDNeopixel(config.neopixel ?? {});
+        }
+    }
+    setupMicrophone(config) {
+        this.microphoneController = new MicrophoneController();
+        this.listenConfig = config;
+        const rate = config.microphoneRate ?? 44100;
+        const channels = config.microphoneChannels ?? 2;
+        const device = config.device ?? '';
+        this.microphoneController.initialize(rate, channels, device);
+        this.initializedHardware.add(Hardware.MICROPHONE);
+    }
+    setupSpeaker(config) {
+        this.speakerController = new SpeakerController();
+        // Validate that aplay is available
+        if (!isCommandAvailable('aplay')) {
+            throw new TJBotError('TJBot requires the aplay command for audio playback. ' +
+                'Install it with: sudo apt-get install alsa-utils');
+        }
+        const device = config.device ?? '';
+        // Cache the full config for later use in speak()
+        this.speakConfig = config;
+        this.speakerController.initialize(device);
+        this.speakerController.setAudioLifecycleCallbacks(() => this.pauseMic(), () => this.resumeMic());
+        this.initializedHardware.add(Hardware.SPEAKER);
+    }
+    async cleanup() {
+        // Clean up controllers
+        if (this.cameraController) {
+            await this.cameraController.cleanup?.();
+        }
+        if (this.microphoneController) {
+            await this.microphoneController.cleanup?.();
+        }
+        if (this.speakerController) {
+            await this.speakerController.cleanup?.();
+        }
+        if (this.sttController) {
+            await this.sttController.cleanup?.();
+        }
+        if (this.ttsController) {
+            await this.ttsController.cleanup?.();
+        }
+        if (this.visionController) {
+            await this.visionController.cleanup?.();
+        }
+        // Clear hardware state
+        this.initializedHardware.clear();
+        this.cameraController = undefined;
+        this.microphoneController = undefined;
+        this.speakerController = undefined;
+        this.sttController = undefined;
+        this.ttsController = undefined;
+        this.visionController = undefined;
+    }
+    async initializeSTTEngine() {
+        if (this.microphoneController === undefined) {
+            throw new TJBotError('Microphone controllernot initialized. Make sure to call setupMicrophone() before initializing the STT engine.');
+        }
+        this.sttController = new STTController(this.microphoneController);
+        await this.sttController.initialize(this.listenConfig);
+    }
+    async initializeTTSEngine() {
+        if (this.speakerController === undefined) {
+            throw new TJBotError('Speaker controllernot initialized. Make sure to call setupSpeaker() before initializing the TTS engine.');
+        }
+        this.ttsController = new TTSController(this.speakerController);
+        await this.ttsController.initialize(this.speakConfig);
+    }
+    async initializeVisionEngine() {
+        this.visionController = new VisionController();
+        await this.visionController.initialize(this.seeConfig);
+    }
+    startMic() {
+        if (this.microphoneController === undefined) {
+            throw new TJBotError('Microphone controllernot initialized. Make sure to call setupMicrophone() before using the microphone.');
+        }
+        this.microphoneController.start();
+    }
+    pauseMic() {
+        if (this.microphoneController === undefined) {
+            return;
+        }
+        this.microphoneController.pause();
+    }
+    resumeMic() {
+        if (this.microphoneController === undefined) {
+            return;
+        }
+        this.microphoneController.resume();
+    }
+    stopMic() {
+        if (this.microphoneController === undefined) {
+            throw new TJBotError('Microphone controllernot initialized. Make sure to call setupMicrophone() before using the microphone.');
+        }
+        this.microphoneController.stop();
+    }
+    getMicInputStream() {
+        if (this.microphoneController === undefined) {
+            throw new TJBotError('Microphone controller not initialized. Make sure to call setupMicrophone() before using the microphone.');
+        }
+        return this.microphoneController.getInputStream();
+    }
+    async listenForTranscript(options) {
+        if (this.sttController === undefined) {
+            throw new TJBotError('STT controller not initialized. Make sure to call setupMicrophone() before listening.');
+        }
+        const transcript = await this.sttController.transcribe({
+            onPartialResult: options?.onPartialResult,
+            onFinalResult: options?.onFinalResult,
+            abortSignal: options?.abortSignal,
+        });
+        return transcript.trim();
+    }
+    async capturePhoto(atPath) {
+        if (this.cameraController === undefined) {
+            throw new TJBotError('Camera controller not initialized. Make sure to call setupCamera() before using the camera.');
+        }
+        return this.cameraController.capturePhoto(atPath);
+    }
+    async capturePhotoBuffer() {
+        if (this.cameraController === undefined) {
+            throw new TJBotError('Camera controller not initialized. Make sure to call setupCamera() before using the camera.');
+        }
+        return this.cameraController.capturePhotoBuffer();
+    }
+    async detectObjects(image) {
+        if (this.visionController === undefined) {
+            throw new TJBotError('Vision controller is not initialized. Make sure to call setupCamera() before using Vision.');
+        }
+        return this.visionController.detectObjects(image);
+    }
+    async classifyImage(image) {
+        if (this.visionController === undefined) {
+            throw new TJBotError('Vision controller is not initialized. Make sure to call setupCamera() before using Vision.');
+        }
+        return this.visionController.classifyImage(image);
+    }
+    async describeImage(image) {
+        if (this.visionController === undefined) {
+            throw new TJBotError('Vision controller is not initialized. Make sure to call setupCamera() before using Vision.');
+        }
+        return this.visionController.describeImage(image);
+    }
+    async detectFaces(image) {
+        if (this.visionController === undefined) {
+            throw new TJBotError('Vision controller is not initialized. Make sure to call setupCamera() before using Vision.');
+        }
+        return this.visionController.detectFaces(image);
+    }
+    async renderLED(hexColor) {
+        if (this.shineConfig.hasCommonAnodeLED) {
+            const rgb = convertHexToRgbColor(hexColor);
+            this.renderLEDCommonAnode(rgb);
+        }
+        if (this.shineConfig.hasNeopixelLED) {
+            await this.renderLEDNeopixel(hexColor);
+        }
+    }
+    async playAudio(audioPath) {
+        if (this.speakerController === undefined) {
+            throw new TJBotError('Speaker controller not initialized. Make sure to call setupSpeaker() before playing audio.');
+        }
+        return this.speakerController.playAudio(audioPath);
+    }
+    async speak(message) {
+        if (this.ttsController === undefined) {
+            throw new TJBotError('TTS controller not initialized. Make sure to call setupSpeaker() before speaking.');
+        }
+        return this.ttsController.speak(message);
+    }
+}
+//# sourceMappingURL=rpi-driver.js.map

package/dist/rpi-drivers/rpi-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpi-driver.js","sourceRoot":"","sources":["../../src/rpi-drivers/rpi-driver.ts"],"names":[],"mappings":"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"}

package/dist/rpi-drivers/rpi3-driver.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * 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.
+ */
+import { ShineConfig, WaveConfig } from '../config/index.js';
+import { ServoPosition } from '../servo/index.js';
+import { RPiBaseHardwareDriver } from './rpi-driver.js';
+import { FaceDetectionMetadata, ImageClassificationResult, ImageDescriptionResult, ObjectDetectionResult } from '../vision/index.js';
+declare class RPi3Driver extends RPiBaseHardwareDriver {
+    private commonAnodeLed;
+    private neopixelLed;
+    private useGRBFormat;
+    private servo;
+    private userHasBeenWarned;
+    constructor();
+    setupLEDCommonAnode(config: ShineConfig['commonanode']): void;
+    setupLEDNeopixel(config: ShineConfig['neopixel']): Promise<void>;
+    setupServo(config: WaveConfig): void;
+    renderLEDCommonAnode(rgbColor: [number, number, number]): void;
+    renderLEDNeopixel(hexColor: string): Promise<void>;
+    cleanup(): Promise<void>;
+    renderServoPosition(position: ServoPosition): void;
+    private warnIfUsingLocalAI;
+    listenForTranscript(): Promise<string>;
+    speak(message: string): Promise<void>;
+    detectObjects(image: Buffer | string): Promise<ObjectDetectionResult[]>;
+    classifyImage(image: Buffer | string): Promise<ImageClassificationResult[]>;
+    describeImage(image: Buffer | string): Promise<ImageDescriptionResult>;
+    detectFaces(image: Buffer | string): Promise<{
+        isFaceDetected: boolean;
+        metadata: FaceDetectionMetadata[];
+    }>;
+}
+export default RPi3Driver;
+//# sourceMappingURL=rpi3-driver.d.ts.map

package/dist/rpi-drivers/rpi3-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpi3-driver.d.ts","sourceRoot":"","sources":["../../src/rpi-drivers/rpi3-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAwB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACxB,MAAM,oBAAoB,CAAC;AAI5B,cAAM,UAAW,SAAQ,qBAAqB;IAC1C,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,iBAAiB,CAAkC;;IAO3D,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,IAAI;IAQvD,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtE,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAMpC,oBAAoB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQxD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBlD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAQlD,OAAO,CAAC,kBAAkB;IAgCpB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAKvE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAK3E,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAKtE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAAE,cAAc,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,qBAAqB,EAAE,CAAA;KAAE,CAAC;CAIrH;AAED,eAAe,UAAU,CAAC"}

package/dist/rpi-drivers/rpi3-driver.js

@@ -0,0 +1,145 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * 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.
+ */
+import { LEDCommonAnode, LEDNeopixel } from '../led/index.js';
+import { LGPIOServoController } from '../servo/index.js';
+import { Hardware } from '../utils/index.js';
+import { getLogger } from '../utils/logging.js';
+import { RPiBaseHardwareDriver } from './rpi-driver.js';
+const logger = getLogger(import.meta.url);
+class RPi3Driver extends RPiBaseHardwareDriver {
+    commonAnodeLed;
+    neopixelLed;
+    useGRBFormat;
+    servo;
+    userHasBeenWarned = {};
+    constructor() {
+        super();
+        this.useGRBFormat = true;
+    }
+    setupLEDCommonAnode(config) {
+        const redPin = config?.redPin ?? 19;
+        const greenPin = config?.greenPin ?? 13;
+        const bluePin = config?.bluePin ?? 12;
+        this.commonAnodeLed = new LEDCommonAnode(redPin, greenPin, bluePin);
+        this.initializedHardware.add(Hardware.LED);
+    }
+    async setupLEDNeopixel(config) {
+        const pin = config?.gpioPin ?? 18;
+        this.neopixelLed = new LEDNeopixel(pin);
+        await this.neopixelLed.initialize();
+        this.useGRBFormat = config?.useGRBFormat ?? true;
+        this.initializedHardware.add(Hardware.LED);
+    }
+    setupServo(config) {
+        const pin = config.servoPin ?? 18;
+        this.servo = new LGPIOServoController(0, pin);
+        this.initializedHardware.add(Hardware.SERVO);
+    }
+    renderLEDCommonAnode(rgbColor) {
+        if (this.commonAnodeLed) {
+            this.commonAnodeLed.render(rgbColor);
+        }
+        else {
+            logger.warn('Attempted to render on an uninitialized Common Anode LED');
+        }
+    }
+    async renderLEDNeopixel(hexColor) {
+        if (this.neopixelLed) {
+            const c = hexColor.startsWith('#') ? hexColor.slice(1) : hexColor;
+            if (c.length !== 6) {
+                logger.warn(`Invalid NeoPixel color '${hexColor}'`);
+                return;
+            }
+            if (this.useGRBFormat) {
+                const grbStr = `0x${c[2]}${c[3]}${c[0]}${c[1]}${c[4]}${c[5]}`;
+                const grb = parseInt(grbStr, 16);
+                await this.neopixelLed.render(grb);
+            }
+            else {
+                const rgbStr = `0x${c}`;
+                const rgb = parseInt(rgbStr, 16);
+                await this.neopixelLed.render(rgb);
+            }
+        }
+        else {
+            logger.warn('Attempted to render on an uninitialized Neopixel LED');
+        }
+    }
+    async cleanup() {
+        if (this.neopixelLed) {
+            await this.neopixelLed.cleanup();
+        }
+        await super.cleanup();
+    }
+    renderServoPosition(position) {
+        if (this.servo) {
+            this.servo.setPosition(position);
+        }
+        else {
+            logger.warn('Attempted to render on an uninitialized servo');
+        }
+    }
+    warnIfUsingLocalAI(aiType) {
+        if (this.userHasBeenWarned[aiType]) {
+            return;
+        }
+        switch (aiType) {
+            case 'stt':
+                if (this.listenConfig.backend?.type === 'local') {
+                    logger.warn('Using local STT on Raspberry Pi 3 may have poor performance. Consider using a cloud-based backend for better results.');
+                }
+                break;
+            case 'tts':
+                if (this.speakConfig.backend?.type === 'local') {
+                    logger.warn('Using local TTS on Raspberry Pi 3 may have poor performance. Consider using a cloud-based backend for better results.');
+                }
+                break;
+            case 'vision':
+                if (this.seeConfig.backend?.type === 'local') {
+                    logger.warn('Using local Vision on Raspberry Pi 3 may have poor performance. Consider using a cloud-based backend for better results.');
+                }
+                break;
+        }
+        this.userHasBeenWarned[aiType] = true;
+    }
+    async listenForTranscript() {
+        this.warnIfUsingLocalAI('stt');
+        return super.listenForTranscript();
+    }
+    async speak(message) {
+        this.warnIfUsingLocalAI('tts');
+        return super.speak(message);
+    }
+    async detectObjects(image) {
+        this.warnIfUsingLocalAI('vision');
+        return super.detectObjects(image);
+    }
+    async classifyImage(image) {
+        this.warnIfUsingLocalAI('vision');
+        return super.classifyImage(image);
+    }
+    async describeImage(image) {
+        this.warnIfUsingLocalAI('vision');
+        return super.describeImage(image);
+    }
+    async detectFaces(image) {
+        this.warnIfUsingLocalAI('vision');
+        return super.detectFaces(image);
+    }
+}
+export default RPi3Driver;
+//# sourceMappingURL=rpi3-driver.js.map