matterbridge-ha-roborock 3.0.0

package/README.md

@@ -0,0 +1,19 @@
+# Matterbridge HA Roborock
+
+桥接 Home Assistant 中的 Roborock 到 Matter。
+
+## 配置
+```json
+{
+  "haUrl": "http://homeassistant.local:8123",
+  "haToken": "your-token",
+  "deviceWhitelist": ["vacuum.roborock_s7"]
+}
+```
+
+## 开发
+```bash
+npm install
+npm run build
+npm test
+```

package/config.json

@@ -0,0 +1,10 @@
+{
+  "name": "matterbridge-ha-roborock",
+  "type": "DynamicPlatform",
+  "haUrl": "10.10.10.175:8123",
+  "haToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiI0NDY0ZmFmODY2Njc0ZDYzODZjN2I5OTNiZmNhNGM5YSIsImlhdCI6MTc1NDkyMjExNCwiZXhwIjoyMDcwMjgyMTE0fQ.qTGAd7yICd9AX5lSsw9KcXcKOr3GLnte7B6gEsTCE7o",
+  "deviceWhitelist": [
+    "vacuum.dreame_vacuum_r2254"
+  ],
+  "debug": true
+}

package/dist/src/ha-vacuum-controller.d.ts

@@ -0,0 +1,111 @@
+import { EventEmitter } from 'events';
+import { HomeAssistantClient } from './homeassistant-client.js';
+/**
+ * VacuumState - 吸尘器状态
+ */
+export interface VacuumState {
+    state: string;
+    batteryLevel: number;
+    isCharging: boolean;
+    fanSpeed?: string;
+    cleaningMode?: string;
+    error?: string;
+    errorMsg?: string;
+    rawAttributes?: any;
+}
+/**
+ * CleanModeConfig - 清洁模式配置
+ */
+export interface CleanModeConfig {
+    cleaningMode: string;
+    fanSpeed: string;
+}
+/**
+ * HAVacuumController - Home Assistant 吸尘器控制器
+ * 负责与 Home Assistant 交互,控制吸尘器并监听状态变化
+ */
+export declare class HAVacuumController extends EventEmitter {
+    private haClient;
+    private entityId;
+    private batterySensorId?;
+    private chargingSensorId?;
+    private cleaningModeEntityId?;
+    private errorSensorId?;
+    private currentState?;
+    private pollInterval?;
+    constructor(haClient: HomeAssistantClient, entityId: string, batterySensorId?: string, chargingSensorId?: string, cleaningModeEntityId?: string, errorSensorId?: string);
+    /**
+     * 初始化控制器 - 获取初始状态并设置监听
+     */
+    initialize(): Promise<void>;
+    /**
+     * 更新状态
+     */
+    private updateState;
+    /**
+     * 处理状态变化
+     */
+    private handleStateChange;
+    /**
+     * 启动轮询
+     */
+    private startPolling;
+    /**
+     * 停止轮询
+     */
+    private stopPolling;
+    /**
+     * 获取当前状态
+     */
+    getState(): VacuumState | undefined;
+    /**
+     * 强制刷新状态（用于主动更新）
+     */
+    forceRefreshState(): Promise<void>;
+    /**
+     * 开始清扫
+     */
+    start(): Promise<void>;
+    /**
+     * 暂停清扫
+     */
+    pause(): Promise<void>;
+    /**
+     * 停止清扫
+     */
+    stop(): Promise<void>;
+    /**
+     * 返回充电座
+     */
+    returnToBase(): Promise<void>;
+    /**
+     * 定位扫地机（播放声音）
+     */
+    locate(): Promise<void>;
+    /**
+     * 设置风速
+     */
+    setFanSpeed(speed: string): Promise<void>;
+    /**
+     * 设置清洁模式（使用 select 实体）
+     */
+    setCleaningModeEntity(mode: string): Promise<void>;
+    /**
+     * 设置清洁模式和风速（组合设置）
+     */
+    setCleaningModeAndFanSpeed(config: CleanModeConfig): Promise<void>;
+    /**
+     * 分区清扫 (Xiaomi Miot 特定)
+     * @param segments 区域ID数组
+     */
+    /**
+     * 清扫指定区域
+     * @param segments Matter 区域 ID 数组 (1, 2, 3, 4)
+     * @param segmentMap Matter ID 到 Dreame ID 的映射
+     */
+    cleanSegments(segments: number[], segmentMap?: Record<number, string>): Promise<void>;
+    /**
+     * 销毁控制器
+     */
+    destroy(): void;
+}

package/dist/src/ha-vacuum-controller.js

@@ -0,0 +1,289 @@
+import { EventEmitter } from 'events';
+/**
+ * HAVacuumController - Home Assistant 吸尘器控制器
+ * 负责与 Home Assistant 交互,控制吸尘器并监听状态变化
+ */
+export class HAVacuumController extends EventEmitter {
+    haClient;
+    entityId;
+    batterySensorId;
+    chargingSensorId;
+    cleaningModeEntityId; // select.dreame_vacuum_r2254_cleaning_mode
+    errorSensorId; // 新增：sensor.dreame_vacuum_r2254_error
+    currentState;
+    pollInterval;
+    constructor(haClient, entityId, batterySensorId, chargingSensorId, cleaningModeEntityId, errorSensorId // 新增参数
+    ) {
+        super();
+        this.haClient = haClient;
+        this.entityId = entityId;
+        this.batterySensorId = batterySensorId;
+        this.chargingSensorId = chargingSensorId;
+        this.cleaningModeEntityId = cleaningModeEntityId;
+        this.errorSensorId = errorSensorId; // 新增赋值
+    }
+    /**
+     * 初始化控制器 - 获取初始状态并设置监听
+     */
+    async initialize() {
+        // 获取初始状态
+        await this.updateState();
+        // 监听 WebSocket 状态变化
+        this.haClient.on('stateChanged', async (entityId, newState) => {
+            if (entityId === this.entityId) {
+                // vacuum 主实体状态变化
+                await this.handleStateChange(newState);
+            }
+            else if (entityId === this.batterySensorId) {
+                // 电池传感器状态变化
+                await this.updateState();
+            }
+            else if (entityId === this.chargingSensorId) {
+                // 充电状态传感器变化
+                await this.updateState();
+            }
+            else if (entityId === this.cleaningModeEntityId) {
+                // 清洁模式传感器变化
+                await this.updateState();
+            }
+            else if (entityId === this.errorSensorId) { // 新增：监听错误传感器
+                await this.updateState();
+            }
+        });
+        // 启动轮询作为备用
+        this.startPolling();
+    }
+    /**
+     * 更新状态
+     */
+    async updateState() {
+        const entity = await this.haClient.getEntityState(this.entityId);
+        await this.handleStateChange(entity);
+    }
+    /**
+     * 处理状态变化
+     */
+    async handleStateChange(entity) {
+        // 获取电池电量
+        let batteryLevel = 0;
+        if (this.batterySensorId) {
+            try {
+                const batterySensor = await this.haClient.getEntityState(this.batterySensorId);
+                batteryLevel = parseFloat(batterySensor.state) || 0;
+            }
+            catch (error) {
+                console.error(`[${this.entityId}] Failed to get battery sensor:`, error);
+                batteryLevel = entity.attributes.battery_level || 0;
+            }
+        }
+        else {
+            batteryLevel = entity.attributes.battery_level || 0;
+        }
+        // 获取充电状态
+        let isCharging = false;
+        if (this.chargingSensorId) {
+            try {
+                const chargingSensor = await this.haClient.getEntityState(this.chargingSensorId);
+                isCharging = chargingSensor.state.toLowerCase() === 'on';
+            }
+            catch (error) {
+                console.error(`[${this.entityId}] Failed to get charging sensor:`, error);
+                // 回退：只信任 HA 的 charging 状态（不包括 docked）
+                isCharging = entity.state.toLowerCase() === 'charging';
+            }
+        }
+        else {
+            // 如果没有充电传感器，只信任 HA 的 charging 状态
+            isCharging = entity.state.toLowerCase() === 'charging';
+        }
+        // 获取清洁模式
+        let cleaningMode = undefined;
+        if (this.cleaningModeEntityId) {
+            try {
+                const cleaningModeEntity = await this.haClient.getEntityState(this.cleaningModeEntityId);
+                cleaningMode = cleaningModeEntity.state;
+            }
+            catch (error) {
+                console.error(`[${this.entityId}] Failed to get cleaning mode:`, error);
+            }
+        }
+        // 新增：获取错误状态
+        let errorMsg = undefined;
+        if (this.errorSensorId) {
+            try {
+                const errorSensor = await this.haClient.getEntityState(this.errorSensorId);
+                errorMsg = errorSensor.state;
+            }
+            catch (error) {
+                console.error(`[${this.entityId}] Failed to get error sensor:`, error);
+            }
+        }
+        this.currentState = {
+            state: entity.state,
+            batteryLevel: batteryLevel,
+            isCharging: isCharging,
+            fanSpeed: entity.attributes.fan_speed,
+            cleaningMode: cleaningMode,
+            error: entity.attributes.error,
+            errorMsg: errorMsg, // 新增：错误消息
+            rawAttributes: entity.attributes,
+        };
+        this.emit('stateChanged', this.currentState);
+    }
+    /**
+     * 启动轮询
+     */
+    startPolling(intervalMs = 30000) {
+        this.pollInterval = setInterval(async () => {
+            try {
+                await this.updateState();
+            }
+            catch (error) {
+                console.error(`[${this.entityId}] Poll failed:`, error);
+            }
+        }, intervalMs);
+    }
+    /**
+     * 停止轮询
+     */
+    stopPolling() {
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = undefined;
+        }
+    }
+    /**
+     * 获取当前状态
+     */
+    getState() {
+        return this.currentState;
+    }
+    /**
+     * 强制刷新状态（用于主动更新）
+     */
+    async forceRefreshState() {
+        await this.updateState();
+    }
+    /**
+     * 开始清扫
+     */
+    async start() {
+        await this.haClient.callService('vacuum', 'start', {
+            entity_id: this.entityId,
+        });
+    }
+    /**
+     * 暂停清扫
+     */
+    async pause() {
+        await this.haClient.callService('vacuum', 'pause', {
+            entity_id: this.entityId,
+        });
+    }
+    /**
+     * 停止清扫
+     */
+    async stop() {
+        await this.haClient.callService('vacuum', 'stop', {
+            entity_id: this.entityId,
+        });
+    }
+    /**
+     * 返回充电座
+     */
+    async returnToBase() {
+        await this.haClient.callService('vacuum', 'return_to_base', {
+            entity_id: this.entityId,
+        });
+    }
+    /**
+     * 定位扫地机（播放声音）
+     */
+    async locate() {
+        try {
+            await this.haClient.callService('vacuum', 'locate', {
+                entity_id: this.entityId,
+            });
+            console.log(`[${this.entityId}] 📍 定位命令已发送`);
+        }
+        catch (error) {
+            console.error(`[${this.entityId}] ❌ 定位失败:`, error);
+            throw error;
+        }
+    }
+    /**
+     * 设置风速
+     */
+    async setFanSpeed(speed) {
+        await this.haClient.callService('vacuum', 'set_fan_speed', {
+            entity_id: this.entityId,
+            fan_speed: speed,
+        });
+    }
+    /**
+     * 设置清洁模式（使用 select 实体）
+     */
+    async setCleaningModeEntity(mode) {
+        if (!this.cleaningModeEntityId) {
+            throw new Error('Cleaning mode entity ID not configured');
+        }
+        await this.haClient.callService('select', 'select_option', {
+            entity_id: this.cleaningModeEntityId,
+            option: mode,
+        });
+    }
+    /**
+     * 设置清洁模式和风速（组合设置）
+     */
+    async setCleaningModeAndFanSpeed(config) {
+        // 先设置清洁模式
+        if (this.cleaningModeEntityId) {
+            await this.setCleaningModeEntity(config.cleaningMode);
+            // 等待一小段时间确保模式切换完成
+            await new Promise(resolve => setTimeout(resolve, 500));
+        }
+        // 再设置风速
+        await this.setFanSpeed(config.fanSpeed);
+    }
+    /**
+     * 分区清扫 (Xiaomi Miot 特定)
+     * @param segments 区域ID数组
+     */
+    /**
+     * 清扫指定区域
+     * @param segments Matter 区域 ID 数组 (1, 2, 3, 4)
+     * @param segmentMap Matter ID 到 Dreame ID 的映射
+     */
+    async cleanSegments(segments, segmentMap) {
+        // 如果提供了映射，转换为 Dreame segment ID
+        if (segmentMap) {
+            const dreameSegments = segments
+                .map(id => segmentMap[id])
+                .filter(id => id !== undefined);
+            console.log(`[${this.entityId}] 🗺️  清扫区域: Matter[${segments.join(',')}] → Dreame[${dreameSegments.join(',')}]`);
+            // 使用 Dreame 专用服务
+            await this.haClient.callService('dreame_vacuum', 'vacuum_clean_segment', {
+                entity_id: this.entityId,
+                segments: dreameSegments,
+            });
+        }
+        else {
+            // 回退到 xiaomi_miot 服务
+            console.log(`[${this.entityId}] 🗺️  清扫区域: ${segments.join(',')}`);
+            await this.haClient.callService('xiaomi_miot', 'call_action', {
+                entity_id: this.entityId,
+                siid: 18,
+                aiid: 1,
+                in: segments,
+            });
+        }
+    }
+    /**
+     * 销毁控制器
+     */
+    destroy() {
+        this.stopPolling();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=ha-vacuum-controller.js.map

package/dist/src/ha-vacuum-controller.js.map

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

package/dist/src/homeassistant-client.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from 'events';
+export interface HAVacuumEntity {
+    entity_id: string;
+    state: string;
+    attributes: {
+        friendly_name: string;
+        battery_level?: number;
+        fan_speed?: string;
+        fan_speed_list?: string[];
+        error?: string;
+        [key: string]: any;
+    };
+    last_changed: string;
+    last_updated: string;
+}
+export declare class HomeAssistantClient extends EventEmitter {
+    private baseUrl;
+    private token;
+    private ws?;
+    private messageId;
+    private isConnected;
+    constructor(url: string, token: string);
+    testConnection(): Promise<boolean>;
+    getVacuumEntities(): Promise<HAVacuumEntity[]>;
+    getEntityState(entityId: string): Promise<HAVacuumEntity>;
+    callService(domain: string, service: string, data?: any): Promise<any>;
+    connectWebSocket(): Promise<void>;
+    disconnect(): void;
+    isConnectedToWebSocket(): boolean;
+}

package/dist/src/homeassistant-client.js

@@ -0,0 +1,135 @@
+import fetch from 'node-fetch';
+import WebSocket from 'ws';
+import { EventEmitter } from 'events';
+export class HomeAssistantClient extends EventEmitter {
+    baseUrl;
+    token;
+    ws;
+    messageId = 1;
+    isConnected = false;
+    constructor(url, token) {
+        super();
+        this.baseUrl = url.replace(/\/$/, '');
+        this.token = token;
+    }
+    async testConnection() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/`, {
+                headers: {
+                    'Authorization': `Bearer ${this.token}`,
+                    'Content-Type': 'application/json'
+                }
+            });
+            if (!response.ok) {
+                throw new Error(`Connection failed: ${response.statusText}`);
+            }
+            const data = await response.json();
+            console.log('✅ HA connection:', data.message);
+            return true;
+        }
+        catch (error) {
+            console.error('❌ HA connection failed:', error);
+            return false;
+        }
+    }
+    async getVacuumEntities() {
+        const response = await fetch(`${this.baseUrl}/api/states`, {
+            headers: {
+                'Authorization': `Bearer ${this.token}`,
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get states: ${response.statusText}`);
+        }
+        const states = await response.json();
+        return states.filter((e) => e.entity_id.startsWith('vacuum.'));
+    }
+    async getEntityState(entityId) {
+        const response = await fetch(`${this.baseUrl}/api/states/${entityId}`, {
+            headers: {
+                'Authorization': `Bearer ${this.token}`,
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get state: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    async callService(domain, service, data = {}) {
+        const url = `${this.baseUrl}/api/services/${domain}/${service}`;
+        console.log(`[HA Client] Calling service:`);
+        console.log(`   URL: ${url}`);
+        console.log(`   Data: ${JSON.stringify(data)}`);
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.token}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(data)
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            console.error(`[HA Client] ❌ Service call failed: ${response.status} ${response.statusText}`);
+            console.error(`   Response: ${errorText}`);
+            throw new Error(`Service call failed: ${response.statusText} - ${errorText}`);
+        }
+        const result = await response.json();
+        console.log(`[HA Client] ✅ Service call successful`);
+        return result;
+    }
+    async connectWebSocket() {
+        return new Promise((resolve, reject) => {
+            const wsUrl = this.baseUrl
+                .replace('http://', 'ws://')
+                .replace('https://', 'wss://');
+            this.ws = new WebSocket(`${wsUrl}/api/websocket`);
+            const timeout = setTimeout(() => {
+                reject(new Error('WebSocket timeout'));
+            }, 10000);
+            this.ws.on('message', (data) => {
+                const msg = JSON.parse(data.toString());
+                if (msg.type === 'auth_required') {
+                    this.ws.send(JSON.stringify({
+                        type: 'auth',
+                        access_token: this.token
+                    }));
+                }
+                else if (msg.type === 'auth_ok') {
+                    clearTimeout(timeout);
+                    this.isConnected = true;
+                    this.ws.send(JSON.stringify({
+                        id: this.messageId++,
+                        type: 'subscribe_events',
+                        event_type: 'state_changed'
+                    }));
+                    resolve();
+                }
+                else if (msg.type === 'event') {
+                    const event = msg.event;
+                    if (event.event_type === 'state_changed') {
+                        const entityId = event.data.entity_id;
+                        if (entityId.startsWith('vacuum.')) {
+                            this.emit('stateChanged', entityId, event.data.new_state);
+                        }
+                    }
+                }
+            });
+            this.ws.on('error', (error) => {
+                clearTimeout(timeout);
+                reject(error);
+            });
+        });
+    }
+    disconnect() {
+        if (this.ws) {
+            this.ws.close();
+        }
+    }
+    isConnectedToWebSocket() {
+        return this.isConnected;
+    }
+}
+//# sourceMappingURL=homeassistant-client.js.map

package/dist/src/homeassistant-client.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,13 @@
+import type { Matterbridge, PlatformConfig } from 'matterbridge';
+import { RoborockHAPlatform } from './platform.js';
+/**
+ * Matterbridge 会直接调用 default export（不是 new）
+ * 所以这里必须返回 new 出来的平台实例
+ */
+type RoborockArgs = [
+    matterbridge: Matterbridge,
+    log: any,
+    config: PlatformConfig
+];
+export default function (...args: RoborockArgs): RoborockHAPlatform;
+export {};

package/dist/src/index.js

@@ -0,0 +1,5 @@
+import { RoborockHAPlatform } from './platform.js';
+export default function (...args) {
+    return new RoborockHAPlatform(...args);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAYnD,MAAM,CAAC,OAAO,WAAW,GAAG,IAAkB;IAC5C,OAAO,IAAI,kBAAkB,CAAC,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC"}