Lazy load camera subdriver

Author: nickolas-deboom

drivers/SmartThings/matter-switch/src/init.lua

@@ -127,6 +127,8 @@ function SwitchLifecycleHandlers.device_init(driver, device)
   end
 end
 
+local lazy_load_if_possible = require "utils.lazy_load_subdriver"
+
 local matter_driver_template = {
   lifecycle_handlers = {
     added = SwitchLifecycleHandlers.device_added,
@@ -309,7 +311,7 @@ local matter_driver_template = {
   supported_capabilities = fields.supported_capabilities,
   sub_drivers = {
     require("sub_drivers.aqara_cube"),
-    require("sub_drivers.camera"),
+    lazy_load_if_possible("sub_drivers.camera"),
     require("sub_drivers.eve_energy"),
     require("sub_drivers.third_reality_mk1")
   }

drivers/SmartThings/matter-switch/src/sub_drivers/camera/can_handle.lua

@@ -0,0 +1,20 @@
+-- Copyright © 2025 SmartThings, Inc.
+-- Licensed under the Apache License, Version 2.0
+
+return function(opts, driver, device, ...)
+  local device_lib = require "st.device"
+  if device.network_type == device_lib.NETWORK_TYPE_MATTER then
+    local version = require "version"
+    if version.rpc < 10 or version.api < 16 then
+      return false
+    end
+    for _, ep in ipairs(device.endpoints) do
+      for _, dt in ipairs(ep.device_types) do
+        if dt.device_type_id == 0x0142 then
+          return true, require("sub_drivers.camera")
+        end
+      end
+    end
+  end
+  return false
+end

drivers/SmartThings/matter-switch/src/sub_drivers/camera/init.lua

@@ -1,16 +1,5 @@
--- Copyright 2025 SmartThings
---
--- 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.
+-- Copyright © 2025 SmartThings, Inc.
+-- Licensed under the Apache License, Version 2.0
 
 -------------------------------------------------------------------------------------
 -- Matter Camera Sub Driver
@@ -160,25 +149,6 @@ local ABS_VOL_MAX, ABS_VOL_MIN = 254.0, 0.0
 
 -- Helper Functions
 
-local function is_camera(opts, driver, device)
-  local device_lib = require "st.device"
-  if device.network_type == device_lib.NETWORK_TYPE_MATTER then
-    local version = require "version"
-    if version.rpc < 10 or version.api < 16 then
-      device.log.warn(string.format("Matter Camera not supported on current firmware version"))
-      return false
-    end
-    for _, ep in ipairs(device.endpoints) do
-      for _, dt in ipairs(ep.device_types) do
-        if dt.device_type_id == 0x0142 then -- 0x0142 is the Camera device type ID
-          return true
-        end
-      end
-    end
-  end
-  return false
-end
-
 local function component_to_endpoint(device, component)
   local camera_eps = device:get_endpoints(clusters.CameraAvStreamManagement.ID)
   table.sort(camera_eps)
@@ -621,7 +591,7 @@ local function device_init(driver, device)
     local parent_child_device = false
     for _, ep in ipairs(device.endpoints) do
       if device:supports_server_cluster(clusters.OnOff.ID, ep.endpoint_id) then
-        local child_profile = cfg.SwitchCfg.assign_child_profile(device, ep.endpoint_id)
+        local child_profile = cfg.SwitchCfg.assign_profile_for_onoff_ep(device, ep.endpoint_id)
         if child_profile then
           num_floodlight_eps = num_floodlight_eps + 1
           local name = string.format("%s %d", "Floodlight", num_floodlight_eps)
@@ -1582,7 +1552,7 @@ local camera_handler = {
       [capabilities.localMediaStorage.commands.setLocalVideoRecording.NAME] = set_enabled_factory(clusters.CameraAvStreamManagement.attributes.LocalVideoRecordingEnabled)
     }
   },
-  can_handle = is_camera
+  can_handle = require("sub_drivers.camera.can_handle")
 }
 
 return camera_handler

drivers/SmartThings/matter-switch/src/utils/lazy_load_subdriver.lua

@@ -0,0 +1,14 @@
+-- Copyright 2025 SmartThings, Inc.
+-- Licensed under the Apache License, Version 2.0
+
+return function(sub_driver_name)
+  local version = require "version"
+  local MatterDriver = require "st.matter.driver"
+  if version.api >= 16 then
+    return MatterDriver.lazy_load_sub_driver_v2(sub_driver_name)
+  elseif version.api >= 9 then
+    return MatterDriver.lazy_load_sub_driver(require(sub_driver_name))
+  else
+    return require(sub_driver_name)
+  end
+end