From 82f7b9c014667719dd7700b0e41d88712f47ec21 Mon Sep 17 00:00:00 2001 From: sujithhanwha <67031640+sujithhanwha@users.noreply.github.com> Date: Tue, 20 Jan 2026 16:40:21 +0900 Subject: [PATCH 1/8] method to list the available firmwares to be used with upgradefirmware. --- doc/Core.xml | 42 ++++++++++++++++ wsdl/ver10/device/wsdl/devicemgmt.wsdl | 70 ++++++++++++++++++++++++++ 2 files changed, 112 insertions(+) diff --git a/doc/Core.xml b/doc/Core.xml index 8d8bc1174..7242a6aeb 100644 --- a/doc/Core.xml +++ b/doc/Core.xml @@ -3170,6 +3170,14 @@ onvif://www.onvif.org/name/ARV-453 Section . + + + AvailableFirmwareListing + + + Indication if the device supports firmware listing as specified in Section . + + SystemLogging @@ -4997,6 +5005,40 @@ onvif://www.onvif.org/name/ARV-453 In case it is not possible to provide exact figures for ExpectedDownTime, the device shall provide best-effort estimates. +
+ GetAvailableFirmwares + This operation retrieves a list of available firmware versions for the device. A device may support firmware list retrieval through the GetAvailableFirmwares command. + The returned list contains firmware information including name, description, and optional download URL. The firmware names returned can be used with firmware upgrade operations. + + + request + + OnlyOfficial - optional [xs:boolean] + Optional flag to filter only official firmware versions. If not specified or set to false, all available firmware versions are returned. + + + + response + + FirmwareInfo [tds:FirmwareInfo] optional unbounded + List of available firmware versions. Each FirmwareInfo contains: + + + + faults + + + No command-specific faults. + + + + access class + + READ_SYSTEM + + + +
GetSystemLog This operation gets a system log from a device. The device should support system log information retrieval through the GetSystemLog command. The exact format of the system logs is outside the scope of this standard. diff --git a/wsdl/ver10/device/wsdl/devicemgmt.wsdl b/wsdl/ver10/device/wsdl/devicemgmt.wsdl index e7456a3ef..abeffa63c 100644 --- a/wsdl/ver10/device/wsdl/devicemgmt.wsdl +++ b/wsdl/ver10/device/wsdl/devicemgmt.wsdl @@ -316,6 +316,11 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO Indicates support for firmware upgrade through the cloud. + + + Specifies support for retrieving the list of available firmware through GetAvailableFirmwares. + + Indicates support for firmware upgrade through HTTP. @@ -2494,6 +2499,49 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + + + + + + Optional flag to filter only official firmware versions. + + + + + + + + + + + + + List of available firmware versions. + + + + + + + + + + + + The name of the firmware version. + + + + + Description of the firmware version. + + + + + + + @@ -3116,6 +3164,12 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + + + + + + @@ -3771,6 +3825,13 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + + + This operation returns the list of firmware versions available for the device. The retrieved firmware name can then be used with the UpgradeFirmware operation. + + + + @@ -2532,13 +2537,33 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO The name of the firmware version. - + Description of the firmware version. + + + The release date of the firmware version. + + + + + Indicates whether the firmware version is an official release. + + + + + Indicates whether the firmware is a bridge firmware essential for upgrade. + + + + + Indicates whether the firmware version is the latest official release. + + From 7b2c4d86946508bc17ea4c0fe51af360847e987e Mon Sep 17 00:00:00 2001 From: sujith raman <67031640+sujithhanwha@users.noreply.github.com> Date: Sat, 24 Jan 2026 10:25:52 +0900 Subject: [PATCH 3/8] description updated to match with the wsdl --- doc/Core.xml | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/doc/Core.xml b/doc/Core.xml index 7242a6aeb..fc9ae479f 100644 --- a/doc/Core.xml +++ b/doc/Core.xml @@ -5007,8 +5007,8 @@ onvif://www.onvif.org/name/ARV-453
GetAvailableFirmwares - This operation retrieves a list of available firmware versions for the device. A device may support firmware list retrieval through the GetAvailableFirmwares command. - The returned list contains firmware information including name, description, and optional download URL. The firmware names returned can be used with firmware upgrade operations. + This operation retrieves a list of available firmware versions for the device. + The returned list contains firmware information including name, description, and optional information about release date, whether its official one and whether its a bridge firmware essential for upgrade or downgrade. The firmware names returned can be used with firmware upgrade operations. request @@ -5016,12 +5016,16 @@ onvif://www.onvif.org/name/ARV-453 OnlyOfficial - optional [xs:boolean] Optional flag to filter only official firmware versions. If not specified or set to false, all available firmware versions are returned. + + IncludePreviousVersions - optional [xs:boolean] + Optional flag to include previous firmware versions in the response. If not specified or set to false, only the latest versions are returned. + response FirmwareInfo [tds:FirmwareInfo] optional unbounded - List of available firmware versions. Each FirmwareInfo contains: + List of available firmware versions. From 16a1c61aba9a383fbeacbb1866f90910d71a868b Mon Sep 17 00:00:00 2001 From: sujith raman <67031640+sujithhanwha@users.noreply.github.com> Date: Sat, 24 Jan 2026 10:36:56 +0900 Subject: [PATCH 4/8] Only Official flag updated for better clarity --- doc/Core.xml | 4 ++-- wsdl/ver10/device/wsdl/devicemgmt.wsdl | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/Core.xml b/doc/Core.xml index fc9ae479f..8ecd5ba28 100644 --- a/doc/Core.xml +++ b/doc/Core.xml @@ -5013,8 +5013,8 @@ onvif://www.onvif.org/name/ARV-453 request - OnlyOfficial - optional [xs:boolean] - Optional flag to filter only official firmware versions. If not specified or set to false, all available firmware versions are returned. + IncludeUnofficial - optional [xs:boolean] + Optional flag to include non-official firmware versions (like beta firmwares or customized firmwares) in the response. If not specified or set to false, only official firmware versions are returned. IncludePreviousVersions - optional [xs:boolean] diff --git a/wsdl/ver10/device/wsdl/devicemgmt.wsdl b/wsdl/ver10/device/wsdl/devicemgmt.wsdl index f37b77496..298c15046 100644 --- a/wsdl/ver10/device/wsdl/devicemgmt.wsdl +++ b/wsdl/ver10/device/wsdl/devicemgmt.wsdl @@ -2502,9 +2502,9 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO - + - Optional flag to filter only official firmware versions. + Optional flag to include non-official firmware versions in the response. If not passed, only official versions are listed. From 52819eb69bc2c6d42974e5bd5823a2b9e7e52d81 Mon Sep 17 00:00:00 2001 From: sujithhanwha <67031640+sujithhanwha@users.noreply.github.com> Date: Wed, 28 Jan 2026 09:35:29 +0900 Subject: [PATCH 5/8] Includeunofficial flag to Includebeta and description updated --- doc/Core.xml | 6 +++--- wsdl/ver10/device/wsdl/devicemgmt.wsdl | 8 ++++---- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/doc/Core.xml b/doc/Core.xml index 8ecd5ba28..cedf9fb68 100644 --- a/doc/Core.xml +++ b/doc/Core.xml @@ -5008,13 +5008,13 @@ onvif://www.onvif.org/name/ARV-453
GetAvailableFirmwares This operation retrieves a list of available firmware versions for the device. - The returned list contains firmware information including name, description, and optional information about release date, whether its official one and whether its a bridge firmware essential for upgrade or downgrade. The firmware names returned can be used with firmware upgrade operations. + The returned list contains firmware information including name, description, and optional information about the release date, whether it is a beta version, and whether it is a bridge firmware essential for upgrade or downgrade. The firmware names returned can be used with the UpgradeFirmware operation. request - IncludeUnofficial - optional [xs:boolean] - Optional flag to include non-official firmware versions (like beta firmwares or customized firmwares) in the response. If not specified or set to false, only official firmware versions are returned. + IncludeBeta - optional [xs:boolean] + Optional flag to include beta firmware versions in the response. If not specified or set to false, only stable firmware versions are returned. Note that beta versions may not be available for devices via this channel. IncludePreviousVersions - optional [xs:boolean] diff --git a/wsdl/ver10/device/wsdl/devicemgmt.wsdl b/wsdl/ver10/device/wsdl/devicemgmt.wsdl index 298c15046..d6c9848bc 100644 --- a/wsdl/ver10/device/wsdl/devicemgmt.wsdl +++ b/wsdl/ver10/device/wsdl/devicemgmt.wsdl @@ -2502,9 +2502,9 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO - + - Optional flag to include non-official firmware versions in the response. If not passed, only official versions are listed. + Optional flag to include beta firmware versions in the response. If not passed, only stable firmware versions would be listed. Note that beta versions may not be available for devices via this channel. @@ -2549,9 +2549,9 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO - + - Indicates whether the firmware version is an official release. + Indicates whether the firmware version is a beta release. From f0808c7efff098525630843b7fed90c9480e5c76 Mon Sep 17 00:00:00 2001 From: sujithhanwha <67031640+sujithhanwha@users.noreply.github.com> Date: Fri, 30 Jan 2026 17:22:38 +0900 Subject: [PATCH 6/8] firmwarename changed to firmwareversion --- doc/Core.xml | 2 +- wsdl/ver10/device/wsdl/devicemgmt.wsdl | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/Core.xml b/doc/Core.xml index cedf9fb68..8f7fbe01a 100644 --- a/doc/Core.xml +++ b/doc/Core.xml @@ -5008,7 +5008,7 @@ onvif://www.onvif.org/name/ARV-453
GetAvailableFirmwares This operation retrieves a list of available firmware versions for the device. - The returned list contains firmware information including name, description, and optional information about the release date, whether it is a beta version, and whether it is a bridge firmware essential for upgrade or downgrade. The firmware names returned can be used with the UpgradeFirmware operation. + The returned list contains firmware information including version, description, and optional information about the release date, whether it is a beta version, and whether it is a bridge firmware essential for upgrade or downgrade. The firmware versions returned can be used with the UpgradeFirmware operation. request diff --git a/wsdl/ver10/device/wsdl/devicemgmt.wsdl b/wsdl/ver10/device/wsdl/devicemgmt.wsdl index d6c9848bc..dc0c8d471 100644 --- a/wsdl/ver10/device/wsdl/devicemgmt.wsdl +++ b/wsdl/ver10/device/wsdl/devicemgmt.wsdl @@ -2532,9 +2532,9 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO - + - The name of the firmware version. + Version identifier of the firmware. From c198b74cb3e8536b7ea8042162e363ad933bb995 Mon Sep 17 00:00:00 2001 From: sujith raman <67031640+sujithhanwha@users.noreply.github.com> Date: Tue, 10 Mar 2026 14:12:48 +0700 Subject: [PATCH 7/8] bridge firmware concept removed and old firmware note added --- doc/Core.xml | 4 +++- wsdl/ver10/device/wsdl/devicemgmt.wsdl | 5 ----- 2 files changed, 3 insertions(+), 6 deletions(-) diff --git a/doc/Core.xml b/doc/Core.xml index 8f7fbe01a..90286cb92 100644 --- a/doc/Core.xml +++ b/doc/Core.xml @@ -5008,7 +5008,9 @@ onvif://www.onvif.org/name/ARV-453
GetAvailableFirmwares This operation retrieves a list of available firmware versions for the device. - The returned list contains firmware information including version, description, and optional information about the release date, whether it is a beta version, and whether it is a bridge firmware essential for upgrade or downgrade. The firmware versions returned can be used with the UpgradeFirmware operation. + The returned list contains firmware information including version, description, and optional information about the release date and whether it is a beta version. The firmware versions returned can be used with the UpgradeFirmware operation. + The device should list only firmware versions that are valid upgrade or downgrade from the current firmware version. If none of the returned firmware versions have the IsLatest flag set, the client may call this operation again after completing a firmware upgrade to obtain an updated list of available versions. + Listing old firmware versions is up to the device implementation; not all devices may support this. request diff --git a/wsdl/ver10/device/wsdl/devicemgmt.wsdl b/wsdl/ver10/device/wsdl/devicemgmt.wsdl index dc0c8d471..7cd191141 100644 --- a/wsdl/ver10/device/wsdl/devicemgmt.wsdl +++ b/wsdl/ver10/device/wsdl/devicemgmt.wsdl @@ -2554,11 +2554,6 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO Indicates whether the firmware version is a beta release. - - - Indicates whether the firmware is a bridge firmware essential for upgrade. - - Indicates whether the firmware version is the latest official release. From 8829c219749258f83bfa010051c62b81999164f6 Mon Sep 17 00:00:00 2001 From: sujith raman <67031640+sujithhanwha@users.noreply.github.com> Date: Sat, 14 Mar 2026 07:08:13 +0700 Subject: [PATCH 8/8] update according to f2f feedback --- doc/Core.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/Core.xml b/doc/Core.xml index 90286cb92..0b06a392b 100644 --- a/doc/Core.xml +++ b/doc/Core.xml @@ -5009,8 +5009,8 @@ onvif://www.onvif.org/name/ARV-453 GetAvailableFirmwares This operation retrieves a list of available firmware versions for the device. The returned list contains firmware information including version, description, and optional information about the release date and whether it is a beta version. The firmware versions returned can be used with the UpgradeFirmware operation. - The device should list only firmware versions that are valid upgrade or downgrade from the current firmware version. If none of the returned firmware versions have the IsLatest flag set, the client may call this operation again after completing a firmware upgrade to obtain an updated list of available versions. - Listing old firmware versions is up to the device implementation; not all devices may support this. + The device shall list only firmware versions that are valid upgrade or downgrade from the current firmware version. If none of the returned firmware versions have the IsLatest flag set, the client may call this operation again after completing a firmware upgrade to obtain an updated list of available versions. + When requesting for old firmware using IncludePreviousVersions, listing old firmware versions is up to the device implementation; not all devices may support this. request