@switchbot/homebridge-switchbot 5.0.0-beta.6 → 5.0.0-beta.60

package/src/devices-hap/lightstrip.ts

@@ -328,7 +328,7 @@ export class StripLight extends deviceBase {
         // Update HomeKit
         if (serviceData.model === SwitchBotBLEModel.StripLight && serviceData.modelName === SwitchBotBLEModelName.StripLight) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -354,7 +354,7 @@ export class StripLight extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: stripLightServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -399,7 +399,7 @@ export class StripLight extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: stripLightWebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()
@@ -485,13 +485,18 @@ export class StripLight extends deviceBase {
             .then(async (device_list: SwitchbotDevice[]) => {
               const deviceList = device_list as WoStrip[]
               this.infoLog(`On: ${this.LightBulb.On}`)
+              this.debugLog(`device_list: ${JSON.stringify(device_list)}`)
               return await this.retryBLE({
                 max: this.maxRetryBLE(),
                 fn: async () => {
-                  if (this.LightBulb.On) {
-                    return await deviceList[0].turnOn()
+                  if (deviceList.length > 0) {
+                    if (this.LightBulb.On) {
+                      return await deviceList[0].turnOn()
+                    } else {
+                      return await deviceList[0].turnOff()
+                    }
                   } else {
-                    return await deviceList[0].turnOff()
+                    throw new Error('No devices found during discovery.')
                   }
                 },
               })
@@ -529,8 +534,19 @@ export class StripLight extends deviceBase {
           switchBotBLE
             .discover({ model: this.device.bleModel, id: this.device.bleMac })
             .then(async (device_list: SwitchbotDevice[]) => {
+              const deviceList = device_list as WoStrip[]
               this.infoLog(`Brightness: ${this.LightBulb.Brightness}`)
-              return await (device_list[0] as WoStrip).setBrightness(Number(this.LightBulb.Brightness))
+              this.debugLog(`device_list: ${JSON.stringify(device_list)}`)
+              return await this.retryBLE({
+                max: this.maxRetryBLE(),
+                fn: async () => {
+                  if (deviceList.length > 0) {
+                    return await deviceList[0].setBrightness(Number(this.LightBulb.Brightness))
+                  } else {
+                    throw new Error('No devices found during discovery.')
+                  }
+                },
+              })
             })
             .then(async () => {
               this.successLog(`Brightness: ${this.LightBulb.Brightness} sent over SwitchBot BLE, sent successfully`)
@@ -568,8 +584,19 @@ export class StripLight extends deviceBase {
           switchBotBLE
             .discover({ model: this.device.bleModel, id: this.device.bleMac })
             .then(async (device_list: SwitchbotDevice[]) => {
+              const deviceList = device_list as WoStrip[]
               this.infoLog(`RGB: ${(this.LightBulb.Brightness, red, green, blue)}`)
-              return await (device_list[0] as WoStrip).setRGB(Number(this.LightBulb.Brightness), red, green, blue)
+              this.debugLog(`device_list: ${JSON.stringify(device_list)}`)
+              return await this.retryBLE({
+                max: this.maxRetryBLE(),
+                fn: async () => {
+                  if (deviceList.length > 0) {
+                    return await deviceList[0].setRGB(Number(this.LightBulb.Brightness), red, green, blue)
+                  } else {
+                    throw new Error('No devices found during discovery.')
+                  }
+                },
+              })
             })
             .then(async () => {
               this.successLog(`RGB: ${(this.LightBulb.Brightness, red, green, blue)} sent over SwitchBot BLE, sent successfully`)

package/src/devices-hap/lock.ts

@@ -332,7 +332,7 @@ export class Lock extends deviceBase {
         if ((serviceData.model === SwitchBotBLEModel.Lock || SwitchBotBLEModel.LockPro)
           && (serviceData.modelName === SwitchBotBLEModelName.Lock || SwitchBotBLEModelName.LockPro)) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -358,7 +358,7 @@ export class Lock extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: lockServiceData | lockProServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -403,7 +403,7 @@ export class Lock extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: lockWebhookContext | lockProWebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()
@@ -455,13 +455,20 @@ export class Lock extends deviceBase {
           switchBotBLE
             .discover({ model: this.device.bleModel, id: this.device.bleMac })
             .then(async (device_list: SwitchbotDevice[]) => {
+              const deviceList = device_list as WoSmartLock[]
+              this.infoLog(`LockTargetState: ${this.LockMechanism.LockTargetState}`)
+              this.warnLog(`device_list: ${JSON.stringify(device_list)}`)
               return await this.retryBLE({
                 max: this.maxRetryBLE(),
                 fn: async () => {
-                  if (this.LockMechanism.LockTargetState === this.hap.Characteristic.LockTargetState.SECURED) {
-                    return await (device_list[0] as WoSmartLock).lock()
+                  if (deviceList && Array.isArray(deviceList) && deviceList.length > 0) {
+                    if (this.LockMechanism.LockTargetState === this.hap.Characteristic.LockTargetState.SECURED) {
+                      return await deviceList[0].lock()
+                    } else {
+                      return await deviceList[0].unlock()
+                    }
                   } else {
-                    return await (device_list[0] as WoSmartLock).unlock()
+                    throw new Error('No devices found during discovery.')
                   }
                 },
               })

package/src/devices-hap/meter.ts

@@ -209,8 +209,9 @@ export class Meter extends deviceBase {
 
     // CurrentTemperature
     if (!(this.device as meterConfig).hide_temperature && this.TemperatureSensor?.Service) {
-      this.TemperatureSensor.CurrentTemperature = this.deviceStatus.temperature
-      this.debugLog(`CurrentTemperature: ${this.TemperatureSensor.CurrentTemperature}°c`)
+      // OpenAPI returns Celsius; convert if user configured a different unit
+      this.TemperatureSensor.CurrentTemperature = convertUnits(this.deviceStatus.temperature, 'CELSIUS', (this.device as meterConfig).convertUnitTo)
+      this.debugLog(`CurrentTemperature: ${this.TemperatureSensor.CurrentTemperature}`)
     }
 
     // BatteryLevel
@@ -287,7 +288,7 @@ export class Meter extends deviceBase {
         // Update HomeKit
         if (serviceData.model === SwitchBotBLEModel.Meter && serviceData.modelName === SwitchBotBLEModelName.Meter) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -313,7 +314,7 @@ export class Meter extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: meterServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -358,7 +359,7 @@ export class Meter extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: meterWebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()

package/src/devices-hap/meterplus.ts

@@ -213,8 +213,9 @@ export class MeterPlus extends deviceBase {
 
     // CurrentTemperature
     if (!(this.device as meterConfig).hide_temperature && this.TemperatureSensor?.Service) {
-      this.TemperatureSensor.CurrentTemperature = this.deviceStatus.temperature
-      this.debugLog(`CurrentTemperature: ${this.TemperatureSensor.CurrentTemperature}°c`)
+      // OpenAPI returns Celsius; convert if user configured a different unit
+      this.TemperatureSensor.CurrentTemperature = convertUnits(this.deviceStatus.temperature, 'CELSIUS', (this.device as meterConfig).convertUnitTo)
+      this.debugLog(`CurrentTemperature: ${this.TemperatureSensor.CurrentTemperature}`)
     }
 
     // BatteryLevel
@@ -291,7 +292,7 @@ export class MeterPlus extends deviceBase {
         // Update HomeKit
         if (serviceData.model === SwitchBotBLEModel.MeterPlus && serviceData.modelName === SwitchBotBLEModelName.MeterPlus) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -317,7 +318,7 @@ export class MeterPlus extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: meterPlusServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -362,7 +363,7 @@ export class MeterPlus extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: meterPlusWebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()

package/src/devices-hap/meterpro.ts

@@ -263,8 +263,9 @@ export class MeterPro extends deviceBase {
 
     // CurrentTemperature
     if (!(this.device as meterProConfig).hide_temperature && this.TemperatureSensor?.Service) {
-      this.TemperatureSensor.CurrentTemperature = this.deviceStatus.temperature
-      this.debugLog(`CurrentTemperature: ${this.TemperatureSensor.CurrentTemperature}°c`)
+      // OpenAPI returns Celsius; convert if user configured a different unit
+      this.TemperatureSensor.CurrentTemperature = convertUnits(this.deviceStatus.temperature as number, 'CELSIUS', (this.device as meterProConfig).convertUnitTo)
+      this.debugLog(`CurrentTemperature: ${this.TemperatureSensor.CurrentTemperature}`)
     }
 
     // Carbon Dioxide Sensor
@@ -367,7 +368,7 @@ export class MeterPro extends deviceBase {
         if ((serviceData.model === SwitchBotBLEModel.MeterPro && serviceData.modelName === SwitchBotBLEModelName.MeterPro)
           || (serviceData.model === SwitchBotBLEModel.MeterProCO2 && serviceData.modelName === SwitchBotBLEModelName.MeterProCO2)) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -393,7 +394,7 @@ export class MeterPro extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: meterProServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -428,7 +429,7 @@ export class MeterPro extends deviceBase {
       }
     } catch (e: any) {
       await this.apiError(e)
-      this.errorLog(`failed openAPIRefreshStatus with ${this.device.connectionType} Connection, Error Message: ${JSON.stringify(e.message)}`)
+      this.errorLog(`failed openAPIRefreshStatus with ${this.device.connectionType} Connection, Error: ${e.message ?? e}`)
     }
   }
 
@@ -438,7 +439,7 @@ export class MeterPro extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: meterProWebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()

package/src/devices-hap/motion.ts

@@ -262,7 +262,7 @@ export class Motion extends deviceBase {
         // Update HomeKit
         if (serviceData.model === SwitchBotBLEModel.MotionSensor && serviceData.modelName === SwitchBotBLEModelName.MotionSensor) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -288,7 +288,7 @@ export class Motion extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: motionSensorServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -333,7 +333,7 @@ export class Motion extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: motionSensorWebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()

package/src/devices-hap/plug.ts

@@ -187,7 +187,7 @@ export class Plug extends deviceBase {
         if ((serviceData.model === SwitchBotBLEModel.PlugMiniUS || SwitchBotBLEModel.PlugMiniJP)
           && serviceData.modelName === (SwitchBotBLEModelName.PlugMini || SwitchBotBLEModelName.PlugMini)) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -213,7 +213,7 @@ export class Plug extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: plugMiniUSServiceData | plugMiniJPServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -258,7 +258,7 @@ export class Plug extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: plugWebhookContext | plugMiniUSWebhookContext | plugMiniJPWebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()
@@ -320,10 +320,14 @@ export class Plug extends deviceBase {
               return await this.retryBLE({
                 max: this.maxRetryBLE(),
                 fn: async () => {
-                  if (this.Outlet.On) {
-                    return await deviceList[0].turnOn()
+                  if (deviceList.length > 0) {
+                    if (this.Outlet.On) {
+                      return await deviceList[0].turnOn()
+                    } else {
+                      return await deviceList[0].turnOff()
+                    }
                   } else {
-                    return await deviceList[0].turnOff()
+                    throw new Error('No devices found during discovery.')
                   }
                 },
               })

package/src/devices-hap/relayswitch.ts

@@ -315,7 +315,7 @@ export class RelaySwitch extends deviceBase {
         // Update HomeKit
         if ((serviceData.model === SwitchBotBLEModel.RelaySwitch1PM && serviceData.modelName === SwitchBotBLEModelName.RelaySwitch1PM) ?? (serviceData.model === SwitchBotBLEModel.RelaySwitch1 && serviceData.modelName === SwitchBotBLEModelName.RelaySwitch1)) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -341,7 +341,7 @@ export class RelaySwitch extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: relaySwitch1ServiceData | relaySwitch1PMServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -386,7 +386,7 @@ export class RelaySwitch extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: relaySwitch1Context | relaySwitch1PMContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()

package/src/devices-hap/robotvacuumcleaner.ts

@@ -275,7 +275,7 @@ export class RobotVacuumCleaner extends deviceBase {
         // Update HomeKit
         if (serviceData.model === SwitchBotBLEModel.Unknown && serviceData.modelName === SwitchBotBLEModelName.Unknown) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -301,7 +301,7 @@ export class RobotVacuumCleaner extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: robotVacuumCleanerServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -346,7 +346,7 @@ export class RobotVacuumCleaner extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: robotVacuumCleanerS1WebhookContext | robotVacuumCleanerS1PlusWebhookContext | floorCleaningRobotS10WebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()
@@ -400,14 +400,20 @@ export class RobotVacuumCleaner extends deviceBase {
           switchBotBLE
             .discover({ model: this.device.bleModel, id: this.device.bleMac })
             .then(async (device_list: SwitchbotDevice[]) => {
+              const deviceList = device_list as any[]
               this.infoLog(`On: ${this.LightBulb.On}`)
+              this.warnLog(`device_list: ${JSON.stringify(device_list)}`)
               return await this.retryBLE({
                 max: this.maxRetryBLE(),
                 fn: async () => {
-                  if (this.LightBulb.On) {
-                    return await (device_list[0] as any).turnOn()
+                  if (deviceList && Array.isArray(deviceList) && deviceList.length > 0) {
+                    if (this.LightBulb.On) {
+                      return await (deviceList[0] as any).turnOn()
+                    } else {
+                      return await (deviceList[0] as any).turnOff()
+                    }
                   } else {
-                    return await (device_list[0] as any).turnOff()
+                    throw new Error('No devices found during discovery.')
                   }
                 },
               })

package/src/devices-hap/waterdetector.ts

@@ -269,7 +269,7 @@ export class WaterDetector extends deviceBase {
         // Update HomeKit
         if (serviceData.model === SwitchBotBLEModel.Leak && serviceData.modelName === SwitchBotBLEModelName.Leak) {
           this.serviceData = serviceData
-          if (serviceData !== undefined || serviceData !== null) {
+          if (serviceData !== undefined && serviceData !== null) {
             await this.BLEparseStatus()
             await this.updateHomeKitCharacteristics()
           } else {
@@ -295,7 +295,7 @@ export class WaterDetector extends deviceBase {
         this.platform.bleEventHandler[this.device.bleMac] = async (context: waterLeakDetectorServiceData) => {
           try {
             this.serviceData = context
-            if (context !== undefined || context !== null) {
+            if (context !== undefined && context !== null) {
               this.debugLog(`received BLE: ${JSON.stringify(context)}`)
               await this.BLEparseStatus()
               await this.updateHomeKitCharacteristics()
@@ -340,7 +340,7 @@ export class WaterDetector extends deviceBase {
       this.platform.webhookEventHandler[this.device.deviceId] = async (context: waterLeakDetectorWebhookContext) => {
         try {
           this.webhookContext = context
-          if (context !== undefined || context !== null) {
+          if (context !== undefined && context !== null) {
             this.debugLog(`received Webhook: ${JSON.stringify(context)}`)
             await this.parseStatusWebhook()
             await this.updateHomeKitCharacteristics()

package/src/devices-matter/BaseMatterAccessory.ts

@@ -10,6 +10,8 @@
 
 import type { API, EndpointType, Logger, MatterAccessory } from 'homebridge'
 
+import { deviceLoggingEnabled, deviceLoggingIsDebug, logDeviceStatusCode, rgb2hs } from '../utils.js'
+
 export interface BaseMatterAccessoryConfig {
   uuid: string
   displayName: string
@@ -86,26 +88,195 @@ export abstract class BaseMatterAccessory implements MatterAccessory {
    */
   protected async updateState(cluster: string, attributes: Record<string, unknown>): Promise<void> {
     await this.api.matter.updateAccessoryState(this.uuid, cluster, attributes)
-    this.log.debug(`[${this.displayName}] Updated ${cluster} state:`, attributes)
+    this.logDebug(`Updated ${cluster} state:`, attributes)
   }
 
   /**
    * Log helper methods
    */
+  // Generic logging delegation: prefer platform-provided log helpers in
+  // `this.context` (infoLog/debugLog/warnLog/errorLog) and fall back to the
+  // local `this.log` methods when not available.
+  protected logWith(level: 'info' | 'error' | 'debug' | 'warn', message: string, ...args: unknown[]): void {
+    const ctx: any = this.context as any
+    const map: Record<string, string> = {
+      info: 'infoLog',
+      error: 'errorLog',
+      debug: 'debugLog',
+      warn: 'warnLog',
+    }
+    const fn = ctx?.[map[level]]
+    if (typeof fn === 'function') {
+      fn(`[${this.displayName}] ${message}`, ...args)
+      return
+    }
+    const local = (this.log as any)[level]
+    if (typeof local === 'function') {
+      local.call(this.log, `[${this.displayName}] ${message}`, ...args)
+    }
+  }
+
   protected logInfo(message: string, ...args: unknown[]): void {
-    this.log.info(`[${this.displayName}] ${message}`, ...args)
+    this.logWith('info', message, ...args)
   }
 
   protected logError(message: string, ...args: unknown[]): void {
-    this.log.error(`[${this.displayName}] ${message}`, ...args)
+    this.logWith('error', message, ...args)
   }
 
   protected logDebug(message: string, ...args: unknown[]): void {
-    this.log.debug(`[${this.displayName}] ${message}`, ...args)
+    this.logWith('debug', message, ...args)
   }
 
   protected logWarn(message: string, ...args: unknown[]): void {
-    this.log.warn(`[${this.displayName}] ${message}`, ...args)
+    this.logWith('warn', message, ...args)
+  }
+
+  /**
+   * Logging helpers parity: allow Matter accessories to ask whether device-level
+   * logging is enabled or in debug mode. These mirror the helpers used by the
+   * HAP/IR device bases so behavior is consistent across platforms.
+   */
+  public async loggingIsDebug(): Promise<boolean> {
+    const ctx: any = this.context as any
+    return deviceLoggingIsDebug(ctx?.deviceLogging)
+  }
+
+  public async enablingDeviceLogging(): Promise<boolean> {
+    const ctx: any = this.context as any
+    return deviceLoggingEnabled(ctx?.deviceLogging, ctx?.platformLogging)
+  }
+
+  /**
+   * Status code logging using shared helper
+   */
+  public async statusCode(statusCode: number, deviceId?: string, hubDeviceId?: string): Promise<void> {
+    await logDeviceStatusCode(
+      statusCode,
+      {
+        debugLog: this.logDebug.bind(this),
+        errorLog: this.logError.bind(this),
+        infoLog: this.logInfo.bind(this),
+      },
+      deviceId ?? (this.context as any)?.deviceId,
+      hubDeviceId ?? (this.context as any)?.hubDeviceId,
+    )
+  }
+
+  /**
+   * Convenience helpers that delegate OpenAPI/BLE commands to platform-provided
+   * functions that are injected into the accessory `context` by
+   * `platform-matter` when the accessory is created from a discovered device.
+   *
+   * These methods are intentionally thin wrappers — the platform controls
+   * retries, discovery and client lifecycle via the helper functions.
+   */
+  protected async sendOpenAPICommand(command: string, parameter = 'default'): Promise<any> {
+    const ctx: any = this.context as any
+    const fn = ctx?.sendOpenAPI
+    if (typeof fn === 'function') {
+      return fn(command, parameter)
+    }
+    throw new Error('OpenAPI helper not available')
+  }
+
+  protected async sendBLECommand(methodName: string, ...args: any[]): Promise<any> {
+    const ctx: any = this.context as any
+    const fn = ctx?.sendBLE
+    if (typeof fn === 'function') {
+      return fn(methodName, ...args)
+    }
+    throw new Error('BLE helper not available')
+  }
+
+  public async sendOnCommand(deviceId?: string): Promise<void> {
+    const ctx: any = this.context as any
+    const id = deviceId ?? ctx?.deviceId
+    try {
+      if (ctx?.connectionType === 'BLE') {
+        await this.sendBLECommand('turnOn')
+      } else {
+        await this.sendOpenAPICommand('turnOn')
+      }
+      // update our matter state
+      await this.updateState(this.api.matter.clusterNames.OnOff, { onOff: true })
+      this.logInfo(`sendOnCommand successful for ${id}`)
+    } catch (e: any) {
+      this.logError(`sendOnCommand failed for ${id}: ${String(e?.message ?? e)}`)
+      throw e
+    }
+  }
+
+  public async sendOffCommand(deviceId?: string): Promise<void> {
+    const ctx: any = this.context as any
+    const id = deviceId ?? ctx?.deviceId
+    try {
+      if (ctx?.connectionType === 'BLE') {
+        await this.sendBLECommand('turnOff')
+      } else {
+        await this.sendOpenAPICommand('turnOff')
+      }
+      await this.updateState(this.api.matter.clusterNames.OnOff, { onOff: false })
+      this.logInfo(`sendOffCommand successful for ${id}`)
+    } catch (e: any) {
+      this.logError(`sendOffCommand failed for ${id}: ${String(e?.message ?? e)}`)
+      throw e
+    }
+  }
+
+  public async sendSetBrightness(percent: number, deviceId?: string): Promise<void> {
+    const ctx: any = this.context as any
+    const id = deviceId ?? ctx?.deviceId
+    try {
+      if (ctx?.connectionType === 'BLE') {
+        await this.sendBLECommand('setBrightness', percent)
+      } else {
+        await this.sendOpenAPICommand('setBrightness', String(percent))
+      }
+      const level = Math.round((percent / 100) * 254)
+      await this.updateState(this.api.matter.clusterNames.LevelControl, { currentLevel: level })
+      this.logInfo(`sendSetBrightness successful for ${id}: ${percent}%`)
+    } catch (e: any) {
+      this.logError(`sendSetBrightness failed for ${id}: ${String(e?.message ?? e)}`)
+      throw e
+    }
+  }
+
+  public async sendSetColor(r: number, g: number, b: number, deviceId?: string): Promise<void> {
+    const ctx: any = this.context as any
+    const id = deviceId ?? ctx?.deviceId
+    try {
+      if (ctx?.connectionType === 'BLE') {
+        await this.sendBLECommand('setRGB', r, g, b)
+      } else {
+        await this.sendOpenAPICommand('setColor', `${r}:${g}:${b}`)
+      }
+      // Convert to hue/sat for matter state update
+      const [h, s] = rgb2hs(r, g, b)
+      await this.updateState(this.api.matter.clusterNames.ColorControl, { currentHue: Math.round((h / 360) * 254), currentSaturation: Math.round((s / 100) * 254) })
+      this.logInfo(`sendSetColor successful for ${id}: ${r},${g},${b}`)
+    } catch (e: any) {
+      this.logError(`sendSetColor failed for ${id}: ${String(e?.message ?? e)}`)
+      throw e
+    }
+  }
+
+  public async sendSetColorTemperature(kelvin: number, deviceId?: string): Promise<void> {
+    const ctx: any = this.context as any
+    const id = deviceId ?? ctx?.deviceId
+    try {
+      if (ctx?.connectionType === 'BLE') {
+        await this.sendBLECommand('setColorTemperature', kelvin)
+      } else {
+        await this.sendOpenAPICommand('setColorTemperature', `${kelvin}`)
+      }
+      const mireds = Math.round(1000000 / kelvin)
+      await this.updateState(this.api.matter.clusterNames.ColorControl, { colorTemperatureMireds: mireds })
+      this.logInfo(`sendSetColorTemperature successful for ${id}: ${kelvin}K`)
+    } catch (e: any) {
+      this.logError(`sendSetColorTemperature failed for ${id}: ${String(e?.message ?? e)}`)
+      throw e
+    }
   }
 
   /**