homebridge-samsung-dryer 1.0.0

package/index.js

@@ -0,0 +1,193 @@
+'use strict';
+
+const PLUGIN_NAME = 'homebridge-samsung-dryer';
+const PLATFORM_NAME = 'SamsungDryer';
+const ST_BASE = 'https://api.smartthings.com';
+
+module.exports = (api) => {
+  api.registerPlatform(PLUGIN_NAME, PLATFORM_NAME, SamsungDryerPlatform);
+};
+
+async function stGet(token, path) {
+  const r = await fetch(`${ST_BASE}${path}`, { headers: { Authorization: `Bearer ${token}` } });
+  return r.json();
+}
+
+async function stCommand(token, deviceId, commands) {
+  await fetch(`${ST_BASE}/v1/devices/${deviceId}/commands`, {
+    method: 'POST',
+    headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+    body: JSON.stringify({ commands })
+  });
+}
+
+// Dry level → fan rotation % mapping (6 levels across 0-100)
+const DRY_LEVELS = ['dampdry', 'less', 'normal', 'more', 'veryDry', 'extremeDry'];
+function dryLevelToSpeed(level) {
+  const i = DRY_LEVELS.indexOf(level);
+  return i < 0 ? 50 : Math.round(((i + 1) / DRY_LEVELS.length) * 100);
+}
+function speedToDryLevel(speed) {
+  const i = Math.min(DRY_LEVELS.length - 1, Math.max(0, Math.floor((speed / 100) * DRY_LEVELS.length)));
+  return DRY_LEVELS[i];
+}
+
+class SamsungDryerPlatform {
+  constructor(log, config, api) {
+    this.log = log;
+    this.config = config;
+    this.api = api;
+    this.accessories = new Map();
+    this.token = config.accessToken;
+    this.deviceId = config.deviceId;
+    this.pollMs = (config.pollInterval || 30) * 1000;
+
+    api.on('didFinishLaunching', () => {
+      this.log.info('Samsung Dryer plugin started');
+      this.discoverDevices().catch(e => this.log.error('Init error:', e.message));
+      setInterval(() => this.pollStatus().catch(e => this.log.error('Poll error:', e.message)), this.pollMs);
+    });
+  }
+
+  configureAccessory(accessory) {
+    this.accessories.set(accessory.UUID, accessory);
+  }
+
+  getOrCreate(uuid, displayName, category) {
+    let acc = this.accessories.get(uuid);
+    if (!acc) {
+      acc = new this.api.platformAccessory(displayName, uuid);
+      acc.category = category;
+      this.accessories.set(uuid, acc);
+      this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [acc]);
+    }
+    acc.getService(this.api.hap.Service.AccessoryInformation)
+      .setCharacteristic(this.api.hap.Characteristic.Manufacturer, 'Samsung')
+      .setCharacteristic(this.api.hap.Characteristic.Model, 'Dryer')
+      .setCharacteristic(this.api.hap.Characteristic.SerialNumber, this.deviceId)
+      .setCharacteristic(this.api.hap.Characteristic.Name, displayName);
+    return acc;
+  }
+
+  async discoverDevices() {
+    const { Service, Characteristic } = this.api.hap;
+    // Numeric category values — Categories export unreliable across HB versions
+    const CAT = { SENSOR: 10, SWITCH: 8, FAN: 3 };
+    const uuid = id => this.api.hap.uuid.generate(`samsung-dryer-${this.deviceId}-${id}`);
+
+    // 1. ContactSensor "Dryer" — OPEN when running/paused, CLOSED when stopped/done
+    //    Best for automations: "notify me when Dryer stops detecting (cycle complete)"
+    const runAcc = this.getOrCreate(uuid('running'), 'Dryer', CAT.SENSOR);
+    this.runningSvc = runAcc.getService(Service.ContactSensor) || runAcc.addService(Service.ContactSensor, 'Dryer');
+    this.runningSvc.getCharacteristic(Characteristic.ContactSensorState).updateValue(0);
+
+    // 2. Switch "Dryer Power" — start (on) / stop (off) the cycle
+    const swAcc = this.getOrCreate(uuid('power'), 'Dryer Power', CAT.SWITCH);
+    this.powerSvc = swAcc.getService(Service.Switch) || swAcc.addService(Service.Switch, 'Dryer Power');
+    this.powerSvc.getCharacteristic(Characteristic.On)
+      .updateValue(false)
+      .on('set', async (val, cb) => {
+        try {
+          await stCommand(this.token, this.deviceId, [
+            { component: 'main', capability: 'switch', command: val ? 'on' : 'off' }
+          ]);
+        } catch (e) { this.log.error('Power set error:', e.message); }
+        cb(null);
+      });
+
+    // 3. TemperatureSensor "Dryer Temperature" — drum temperature
+    const tempAcc = this.getOrCreate(uuid('temp'), 'Dryer Temperature', CAT.SENSOR);
+    this.tempSvc = tempAcc.getService(Service.TemperatureSensor) || tempAcc.addService(Service.TemperatureSensor, 'Dryer Temperature');
+    this.tempSvc.getCharacteristic(Characteristic.CurrentTemperature).updateValue(0);
+
+    // 4. Switch "Wrinkle Prevent" — post-cycle tumbling to prevent wrinkles
+    const wrinkleAcc = this.getOrCreate(uuid('wrinkle'), 'Wrinkle Prevent', CAT.SWITCH);
+    this.wrinkleSvc = wrinkleAcc.getService(Service.Switch) || wrinkleAcc.addService(Service.Switch, 'Wrinkle Prevent');
+    this.wrinkleSvc.getCharacteristic(Characteristic.On)
+      .updateValue(false)
+      .on('set', async (val, cb) => {
+        try {
+          await stCommand(this.token, this.deviceId, [
+            { component: 'main', capability: 'samsungce.dryerWrinklePrevent', command: val ? 'on' : 'off' }
+          ]);
+        } catch (e) { this.log.error('Wrinkle set error:', e.message); }
+        cb(null);
+      });
+
+    // 5. Fan "Dry Level" — rotation speed maps to dryness level (dampdry→extremeDry)
+    const dryAcc = this.getOrCreate(uuid('drylevel'), 'Dry Level', CAT.FAN);
+    this.dryLevelSvc = dryAcc.getService(Service.Fan) || dryAcc.addService(Service.Fan, 'Dry Level');
+    this.dryLevelSvc.getCharacteristic(Characteristic.On)
+      .updateValue(false)
+      .on('set', (val, cb) => cb(null)); // on/off state managed by poll
+    this.dryLevelSvc.getCharacteristic(Characteristic.RotationSpeed)
+      .setProps({ minValue: 0, maxValue: 100, minStep: 17 })
+      .updateValue(50)
+      .on('set', async (speed, cb) => {
+        try {
+          const level = speedToDryLevel(speed);
+          await stCommand(this.token, this.deviceId, [
+            { component: 'main', capability: 'custom.dryerDryLevel', command: 'setDryerDryLevel', arguments: [level] }
+          ]);
+          this.log.info(`Dry level set to ${level} (${speed}%)`);
+        } catch (e) { this.log.error('Dry level set error:', e.message); }
+        cb(null);
+      });
+
+    this.log.info('Dryer accessories registered, polling...');
+    await this.pollStatus();
+  }
+
+  async pollStatus() {
+    try {
+      const { Characteristic } = this.api.hap;
+      const status = await stGet(this.token, `/v1/devices/${this.deviceId}/components/main/status`);
+
+      // machineState: run | pause | stop | idle
+      const machineState = status['washerOperatingState']?.machineState?.value;
+      const switchState = status['switch']?.switch?.value;
+      const isRunning = machineState === 'run' || machineState === 'pause' || switchState === 'on';
+
+      if (this.runningSvc) {
+        // ContactSensor: 1=open(detected/running), 0=closed(clear/done)
+        this.runningSvc.updateCharacteristic(Characteristic.ContactSensorState, isRunning ? 1 : 0);
+      }
+      if (this.powerSvc) {
+        this.powerSvc.updateCharacteristic(Characteristic.On, isRunning);
+      }
+
+      // Temperature — Samsung dryers report in °F; convert to °C for HomeKit
+      const rawTemp = status['temperatureMeasurement']?.temperature?.value;
+      const tempUnit = status['temperatureMeasurement']?.temperature?.unit;
+      if (rawTemp !== undefined && this.tempSvc) {
+        const tempC = (tempUnit === 'F' || tempUnit === undefined) ? (rawTemp - 32) * 5 / 9 : rawTemp;
+        const clamped = Math.max(-270, Math.min(100, tempC));
+        this.tempSvc.updateCharacteristic(Characteristic.CurrentTemperature, clamped);
+      }
+
+      // Wrinkle prevent
+      const wrinkle = status['samsungce.dryerWrinklePrevent']?.wrinklePrevent?.value;
+      if (wrinkle !== undefined && this.wrinkleSvc) {
+        this.wrinkleSvc.updateCharacteristic(Characteristic.On, wrinkle === 'on' || wrinkle === true);
+      }
+
+      // Dry level → fan speed
+      const dryLevel = status['custom.dryerDryLevel']?.dryLevel?.value;
+      if (dryLevel && this.dryLevelSvc) {
+        const speed = dryLevelToSpeed(dryLevel);
+        this.dryLevelSvc.updateCharacteristic(Characteristic.On, isRunning);
+        this.dryLevelSvc.updateCharacteristic(Characteristic.RotationSpeed, speed);
+      }
+
+      // Log completion time if available
+      const completion = status['washerOperatingState']?.completionTime?.value;
+      if (completion && machineState === 'run') {
+        this.log.debug(`Completion time: ${completion}`);
+      }
+
+      this.log.debug(`Poll: state=${machineState || switchState}, temp=${rawTemp}${tempUnit || 'F'}, dryLevel=${dryLevel}`);
+    } catch (e) {
+      this.log.error('Poll error:', e.message);
+    }
+  }
+}

package/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "homebridge-samsung-dryer",
+  "version": "1.0.0",
+  "description": "Homebridge plugin for Samsung dryer via SmartThings — exposes run state, temperature, dry level, wrinkle prevent",
+  "main": "index.js",
+  "keywords": ["homebridge-plugin","samsung","dryer","smartthings"],
+  "engines": { "homebridge": ">=1.3.0", "node": ">=14.0.0" },
+  "dependencies": {}
+}