ubisys LD6 Firmware Änderungsprotokoll

Version Identification 

• OTA file version: 01600461
• Application: 1.6.0
• Stack: 4.6.1

ubisys Compact7B Stack Changes between 4.4.13 and 4.6.0

• Common Functionality
  • Improved resilience: Enhance interrupt handling for improved button debouncing
  • Resolved a numeric overflow issue in calculating the interval of periodic attribute reports
• Zigbee Cluster Library
  • Cancel an active OTA image download if there is a mismatch in the image type
  • Notify the application and generate an attribute report only if attribute data has changed when being set
  • Updated the revision definition of the IAS ACE server cluster
  • Conduct a range check on the given group identifier when processing an inbound Groups or Scenes cluster command
  • Notify a companion Color Control cluster instance on the same application endpoint upon the completion of an ongoing level transition to ensure proper color representation
  • During initial start-up, execute the start-up behavior through a Color Control cluster instance if it exists; otherwise, proceed via a Level Control cluster instance on the same application endpoint
  • Consider the scenario where the periodic check-in feature of a Poll Control cluster can be disabled
  • Maintain Green Power translation table entries by additionally sorting them according to profile and cluster identifiers
• Zigbee Network Core Stack
  • Consider the scenario where a source route may lack a previous hop if the corresponding device node is only one hop away from the local device entity
  • Respond with the status code “PAN_AT_CAPACITY”, instead of “ACCESS_DENIED”, when processing a network rejoin request command while the local neighbor table is full
  • Transmit a Network Status command with the status ‚UNKNOWN_COMMAND‘ upon receiving an unknown or unsupported network command
  • Improved the check for the minimum header length of an inbound APS frame to reject malformed APS frames
  • Improved routing behavior: Trigger route discovery when transmitting a network-encrypted frame to a neighboring device node that was recently added to the local neighbor table due to an inbound network-secured frame
  • Improved link quality assessment (LQA): Avoid duplicated link quality updates that could negatively affect the LQA results
  • Improved link quality assessment (LQA): Conduct link quality updates upon receiving frames over an alternate secured tunnel, such as a BLE connection
  • Enhanced the processing of consecutive link status frames that are split due to frame length restrictions but belong to the same periodic link status notification
  • Closed a potential vulnerability by rejecting short address changes for an end device triggered by unauthenticated inbound traffic from that device
  • Refrain from updating the neighbor table upon receiving a link status frame if the neighbor table is already at capacity and the sending device node is not yet maintained in the neighbor table

ubisys Compact7B Stack Changes between 4.6.0 and 4.6.1

• Zigbee Cluster Library
  • Take the scenario into account where an existing cluster instance on an application endpoint may be dynamically disabled based on system configuration

Version Identification 

• OTA file version: 0150044D
• Application: 1.5.0
• Stack: 4.4.13

New in version 1.5.0

• Advanced configuration options for the VersaLight color mixing engine to provide more control over the color mixing strategy. This is intended for use-cases where color primaries shall not be used to synthesize white tones; or, vice versa, white primaries shall not be used to contribute to color reproduction, particularly in RGB+CCT applications
• Optimized the VersaLight color mixing engine for even smoother color transitions
• When the output configuration is altered, default reporting configurations are generated for dynamically added application endpoints as needed

ubisys Compact7B Stack Changes between 4.3.1 and 4.4.7

• Common Functionality
  • Persistent Storage 2.0: Added various improvements and optimizations for internal flash memory management during the startup phase for improved resiliency
  • Added sanity checks for ubisys proprietary input configurations, which are supplied over-the-air
  • Improved the start-up behavior of the input state machine (deferred initialization)
• Zigbee Cluster Library
  • Time client: Extended the permissible maximum interval between periodic server queries. Prior to this change, the interval has to be less than about 20 hours
  • OTA client: Improved handling of duplicate image block data, i.e. data that has already been fully or partially received. This prevents unnecessary retries and speeds up the overall download process
  • Added support for restoring factory default reporting configurations using the factory default configuration of an arbitrary (other) endpoint as template
• Zigbee Network Core Stack
  • Improved resilience: Account for the case that retry of a fragmented APS transmission might occur even after all fragments have been received
  • Resolved an issue where the ‚extended nonce‘ flag might not have been set when transmitting an APS encrypted Update Device command

ubisys Compact7B Stack Changes between 4.4.7 and 4.4.13

• Common Functionality
  • Provided applications/platforms an opportunity to interleave with certain computationally intensive procedures
  • Added verification steps when OTA images are stored in external flash
• Zigbee Cluster Library
  • Color Control server: Improved the internal application interface regarding the state of color transitions
  • Color Control server: Improved management of Enhanced Color Mode (CCB 4071)
  • Color Control server: Resolved an issue where initiating an instant color transition could result in a division-by-zero exception on some platforms
  • Enhanced the attribute framework such that applications need not provide updated values when refreshing attributes if such updated values are not available or desired
  • Addressed an issue where the sequence of operations was undefined, potentially lead to incorrect processing of manufacturer-specific inbound ZCL frames on certain platforms. Note: This affects only a new platform, not existing platforms and products
  • Fixed an issue where an attribute with dynamic storage might not have allocated storage at initialization time
• Zigbee Network Core Stack
  • Improved resilience: Add defensive code to guard against invalid source route information embedded into a network frame. Based on a field issue with a third-party Zigbee stack
  • Simplified and improved the way of creating ZDO simple descriptors

Version Identification 

• OTA file version: 01400431
• Application: 1.4.0
• Stack: 4.3.1

New in version 1.4.0

• Added regular watch-dog timer reset during persistent storage operations that are not time-bound. This is a critical fix for all Series 2 products that shall be applied immediately and also highly recommended for all other products
• Added support for the manufacturer-specific MinimumOnLevel attribute. Defaults to 10% for devices that have no specific configuration of this attribute

ubisys Compact7B Stack Changes between 4.2.2 and 4.3.1

• Common Functionality
  • Added application/platform-specific hooks to Persistent Storage 2.0 when swapping cached pages
• Zigbee Network Core Stack
  • Various improvements and optimizations regarding the network rejoin behavior of sleepy end-devices

Version Identification 

• OTA file version: 01300422
• Application: 1.3.0
• Stack: 4.2.2

New in version 1.3.0

• Various enhancements and improvements provided by the stack roll-up (see stack change log for details)

ubisys Compact7B Stack Changes between 4.1.2 and 4.2.2

• Common Functionality
  • Persistent Storage: Improved robustness against power failures during factory resets
  • Persistent Storage: General speed optimizations for second-generation journaling token storage system. Further speed-optimizations for garbage collection and progressive, piecemeal maintenance for improved responsiveness
  • Push-button event handling for next-generation hardware (settling time option)
• Zigbee Cluster Library
  • Enabled cancelling service locating processes, if needed; available for IAS Zone server, Poll Control server, OTA client and Time client clusters
  • Enabled cancelling particular outbound ZCL requests, if needed
  • Thermostat cluster: Added support for changing schedules over-the-air
  • Window covering cluster: Improved support for back-to-back “Go To Lift” commands
  • OTA client: Abort ongoing OTA download and service locating process when permanently leaving the network
  • OTA client: Clear OTA server configuration when permanently leaving the network
  • Reporting configuration: Omit target address information from persistent storage entries (experimental feature, now deprecated)
  • Fixed an issue, where a ZCL “Report Attribute” command without payload may be repeatedly transmitted (edge case, did not affect existing devices)
  • Fixed an issue, where the remaining packet capacity might have been inaccurate when assembling a ZCL frame with variable length payload (edge case, did not affect existing devices)
• Zigbee Network Core Stack
  • Enabled automatic routing loop detection and resolution
  • Accelerate retrieval of APS security material from persistent storage
  • Improved resilience against power failures when updating APS security material in persistent storage
  • Various improvements and optimizations regarding MAC data poll on sleepy end-devices
  • Various improvements and optimizations regarding indirect transmissions on routers
  • More rigid filtering on sleepy end-devices regarding unsolicited broadcast frames received while polling the parent
  • Enabled cancelling particular outbound ZDO requests pending a response, if needed
  • Now utilizing average LQA for poor parent link assessment, mitigating the impact of one-off RF disturbances
  • Ignore inbound MAC data requests during router network startup
  • Improved resilience to parent link failures during trust center link-key exchanges
  • Fixed an issue, where the next indirect transmission may have been instigated too early
  • Fixed an issue, where the master key on a trust center device or the exchanged authentication token on a router device is not reset when necessary (edge case, did not affect existing devices)

Version Identification 

• OTA file version: 01210412
• Application: 1.2.1
• Stack: 4.1.2

New in version 1.2.1

Light Engine Improvements:
• Featuring the brand-new ubisys Versalight™ universal light engine with unparalleled flexibility
• Supports versatile configurations from one up to six primary LEDs per light endpoint
• Supports one to six light endpoints in different setups: monochromatic/dimmable, CCT, RGB, RGBW, RGB+CCT, RGBA, RGBWA, etc.
• Countless configuration options with the 23 most important profiles provided in the ubisys Smart Home App for iOS version 2.1.1 or higher at the touch of your fingertips. Notice: With the Zigbee Direct feature built into LD6 you can configure it with just the app and no gateway hardware and then add it to the hub of your choosing – or just use it without a hub for simple use-cases
• Support for fine-tuning primary information if desired: Specify chromaticity and relative luminous flux for the LED strips or LED spots that are wired to the LD6 when this information is available from datasheets or chromaticity test reports
• Advanced color mixing and improved color fading for visually pleasing transitions
• Ability to apply output configuration changes on-the-fly (no reboot/power-cycle required any more). Endpoints and clusters are simply reconfigured dynamically as needed
• Remove obsolete group, scene and binding table entries when a light endpoint is removed due to reconfiguration
Other New Features:
• Enhanced input configuration support: Features bridging of switches and buttons connected to the device’s inputs to Matter eco-systems. These are exposed as Matter Generic Switches via the ubisys Conflux Zigbee/Matter Bridge, which is included in the ubisys G1 if configured accordingly. Select the “Automation Switch” or “Automation Button” configuration in the ubisys Smart Home App and create a binding to the gateway. Currently, this requires the ubisys Smart Home App for iOS version 2.1.1 or higher
• Enhanced input configuration support: You can now commit more complex input configurations, for example create four dimmer switches, one for each input. This requires ubisys G1 firmware version 4.1.0 or higher

Bug-fixes

• Limit neighbor table to 26 entries (excessive heap usage in dense networks)

ubisys Compact7B Stack Changes between 4.0.0 and 4.1.2

• Common Functionality
  • Power cycle factory reset sequence timing changed to ‘10s on’, ‘10s off’, … cycles across all products and underlying platforms. This is to accommodate upcoming products and platforms and retain a unified factory reset power cycle. Significant gains in power efficiency lead to SoCs remaining powered for several seconds after the power supply has been cut
  • Enhanced input action engine to support emitting manufacturer-specific commands. These may be used, for example, to replicate Matter Generic Switch behavior in Zigbee devices for seamless bridging of inputs to Matter
  • Persistent Storage: Improve robustness against power failures during garbage collection
  • Persistent Storage: Slight tweaks to wear-levelling algorithm
• Zigbee Cluster Library
  • Added support for read attributes structured and write attributes structured. This enables unlimited configuration options for C4 and other products with programmable input configurations, including four dimmer switches, for instance
  • Added safeguards against some misbehaving third party OTA servers
• Zigbee Network Core Stack
  • Fixed an issue, where under rare circumstances, false address conflicts could have been flagged
  • Improved link status processing
  • Routing has been optimized to address certain rare edge cases and improve interoperability with some third-party devices
  • Improved resilience of trust center link-key exchange (when stack is reset)
  • Fixed an issue, where the address comparator misbehaved for some rare constellations
  • Joining and rejoining improved by adding quick MAC association retries with adjustable attempt limit
  • Processing of leave requests with certain status codes has been improved
  • Improved the behavior of leave processing while rejoining
  • Improved robustness by ignoring beacons that arrive after scanning has completed and before joining succeeded
  • Improved resilience to malformed beacon frames
  • Improved link quality assessment on certain platforms
  • Added support for new SoCs

Version Identification 

• OTA file version: 01110400
• Application: 1.1.1
• Stack: 4.0.0

New in version 1.1.1 

• We have added a super exciting new feature to LD6: This is the first publicly released firmware to include fully standard-compliant Zigbee Direct Device support based on our certified Golden Unit implementation of Zigbee Direct 1.0! This means you can use a smart phone, PC or speaker with Bluetooth, which runs a Zigbee Virtual Device app, to setup entry-level systems, control the LD6 or other native Zigbee devices in the wireless mesh network without actually needing a Zigbee hub! But even for hub-centric systems Zigbee Direct simplifies onboarding in systems that support Zigbee Direct commissioning flows. In addition, if your LD6 is operating in an environment that did not support advanced ubisys proprietary settings (e.g. input and output configurations) or the ecosystem did not deploy ubisys OTA firmware images, Zigbee Direct will remedy the lack of such ecosystem support. It will allow you to use the ubisys Smart Home app to directly connect to your LD6 and make these settings from there and also supply OTA firmware images from there in the future
• Modify default configuration for LD6 to use outputs D1…D4 for RGBW (as in previous versions) and additionally outputs D5 and D6 for a tunable white light source (D5 = cool white 6500K, D6 = warm white 2700K) on a second endpoint
• Added support for over-the-air configuration of outputs, e.g. up to 6 x dimmable or 3 x tunable white or 2 x RGB, or 1 x RGBW + 2 x dimmable or 1 x RGBW + 1 x tunable white etc. This setting is preserved across factory resets. Notice that the configuration change will take effect after a reboot and may result in added or removed end-points, modified device types (e.g. changing from dimmable light, extended color light, color temperature light), added or removed clusters and different color capabilities (full color vs. color temperature). It is recommended that after making output configuration changes a device and service discovery is triggered on controllers. If your controller does not support rediscovery then the device must be removed from the network and then joined to the system again
• Added ballast configuration cluster. This allows adjusting minimum and maximum light output, i.e. customizing the 1% and 100% light output levels to match your light source and usage environment
• Improved tunable white color mixing
• Increased PWM resolution for output channels and increased default PWM frequency
• Added new common production test access port (TAP) to LD6 firmware

ubisys Compact7B Stack Changes between 3.0.0 and 4.0.0

• Zigbee Direct 1.0 certified and awarded Golden Unit designation for both the Zigbee Virtual Device (ZVD) and Zigbee Direct Device (ZDD)
  • Zigbee Virtual Device supports all mandatory and optional features and all possible device roles: trust center, router, non-sleepy end-device
  • Zigbee Direct Device supports all mandatory and optional features and all possible device roles: trust center, router, sleepy end-device, non-sleepy end-device. Tunneling service is currently available on routing-capable devices only.
  • Support for all cryptographic suites supported by Zigbee Direct, i.e. SPEKE/Curve25519/AES-MMO-128/HMAC-AES-MMO-128 and ECDHE-PSK/P-256/SHA-256/HMAC-SHA-256-128 on both ZVD and ZDD
• Zigbee 2023 compliant (passes all compliance tests, certification pending)
  • Asymmetric key agreement before network admission with optional device interview
  • Support for all mandatory and all optional features defined in Zigbee 2023 in all possible device roles: trust center, router, sleepy end-device, non-sleepy end-device
  • Support for all cryptographic suites supported by Zigbee 2023, i.e. SPEKE/Curve25519/AES-MMO-128/HMAC-AES-MMO-128 and SPEKE/Curve25519/SHA-256/HMAC-SHA-256-128
  • Fully standard-compliant Works With All Hubs feature support retaining full compatibility with the pre-standard Amazon Works With All Hubs cluster
  • Negotiation of fragmentation capabilities
  • Fragmentation support for new ZDO commands
  • APS security frame counter synchronization
  • Standardized trust center swap-out (trust center and joined devices)
  • Standardized network-level retries, including data poll retries for sleepy end-devices
• Enhanced product-level configuration options for customized stack behavior
• Optimizations to improve routing and instant network connectivity on start-up
• Ongoing maintenance of the code base: Restructuring, refactoring and consolidating
• Round-up of bug-fixes and performance improvements

Note: This change log is a generic stack change log. Products incorporating the stack can choose to enable specific feature sets. For example, the 2023 feature set can be selectively disabled in products to support a graceful transition to Zigbee 2023 in progressive roll-outs. In addition, while the stack supports all variations of key agreement suites, end-products might support only a reasonable subset. Specifically, ubisys products will prefer SPEKE/Curve25519/AES-MMO-128/HMAC-AES-MMO-128 for all Zigbee 2023, Zigbee Direct 1.0 and digital signatures of OTA images as this suite provides the best blend of security, performance and resource utilization.

Version Identification 

• OTA file version: 01010300
• Application: 1.0.1
• Stack: 3.0.0

ubisys Compact7B Stack Changes between 2.4.0 and 3.0.0

• Added support for I2C TAP
• Added support for a unified and fully configurable join/rejoin algorithm with back-offs and retries at the stack level
• Reject trust center rejoin on a distributed security network (CSA incident no. 2021-ZP-0401)
• Start TCLK exchange if an end device could not successfully finish TCLK exchange during its initial joining and has just rejoined
• Improved sleep management: Checking both transmission and reception queues for pending packets, if necessary
• Extended the advanced parent link maintenance mechanism by the new criterion „poor poll control reactivity“
• More granular startup progress notifications, including kick-off of a Touch Link commissioning procedure
• Stop ongoing join/rejoin retry attempts when Touch Link commissioning procedure is instigated
• Encapsulated the All Hubs cluster’s dependency on the Touch Link server, IAS Zone server and Time client clusters, for better modularity
• Added Enhancements to the Thermostat cluster
• Made the hard limit for the scene table capacity configurable
• Added support for the Relative Humidity Measurement cluster
• Added framework support for initiating enroll request and IAS zone status change indication via the ZCL request queue
• Added framework support for time query initiated by a Time client cluster
• Prohibit automatic CIE detection by default; application is still able to instigate it though should legacy systems require it
• Explicitly stop fast polling mode as soon as no more response frame is pending
• Resume network activity if a router device just failed a rejoin attempt
• Enhancement: PAN-ID and permit joining state changes are forwarded to application clusters
• Bug-fix: Under rare circumstances, a frame might linger in the transmission queue without being actually sent
• Bug-fix: Potential overflow of 64-bit timer values might occur when unsigned arithmetic is used for comparison of due times
• Bug-fix: During MAC association, if an unrelated frame is being received via data polling, MAC association might be incorrectly terminated; account for this case and retry if permissible
• Bug-fix: Periodical polling timer used to be unconditionally kept alive, even in case of data poll failure; temporarily cancel it to avoid interference with subsequent retry attempts. Once succeeded, the periodical polling timer will be reinstated for its normal usage.
• Bug-fix: When assessing MAC capability changes for a rejoining device verify the „Device Type“ and „Receiver on when Idle“ bits only
• Bug-fix: Skip route discovery table verification diagnostics in case of an end device
• Bug-fix: Limit the use of incoming APS security material to few select cases only
• Bug-fix: Periodical reporting on a cluster attribute could lead to undue delays of reports for other clusters
• Bug-fix: Startup behavior of the OnOff cluster might be incorrect due to interactions with Level Control or Color Control clusters on the same application endpoint
• Bug-fix: Brightness adjustment of the Level control cluster might be incorrect due to interactions with a Color Control cluster on the same application endpoint
• Bug-fix: Under rare circumstances, neighbor table entries might be incorrect (caused by a typo)
• Bug-fix: Under rare circumstances, out-of-sequence or truncated OTA data block could result in failed OTA download attempts

Version Identification 

• OTA file version: 00940240
• Application: 0.9.4
• Stack: 2.4.0

New in version 0.9.4 

• Now using an improved implementation of the Color Control cluster for better color reproduction and smooth transitions
• Added support for tunable white lights
• Full support for Touch Link functionality
•  Improved gamma correction
•  Added support for coupling color temperature to light output intensity (“dim-to-warm”)
•  Improved color mixing quality at low brightness levels
•  Added support for configuring all three physical inputs according to end-user requirements
•  Modified the device type and device ID parameters to better reflect the supported feature set
• Upgraded the internal bootloader to support larger application firmware images extending into the second internal flash memory bank (future-proofing).

ubisys Compact7B Stack Changes between 2.1.0 and 2.4.0

• Migrated to new 64-bit timer implementation across the entire stack
• Improved support for the future ZigBee Direct technology
• Consolidated support for All Hubs at the stack level, e.g., advanced parent link maintenance mechanism, beacon survey etc.
• Completed support for the proprietary All Hubs cluster
• Added support for dynamic cluster instantiation
• Completed support for Hybrid Zigbee Green Power technology
• Completed support for the Color Control cluster
• Added better programmatic control over attribute reports, enabled pausing and resuming attribute reports
• Enhanced the keep-alive mechanism for end devices via the end device timeout approach
• Make sure that APS security of incoming requests is mirrored to outgoing responses
• Extended maximum reporting interval (enabled by new 64-bit timer implementation)
• Enhancements and improvements of the Level Control cluster
• Enhancements and improvements of the Thermostat cluster
• Added support for the HMAC-SHA-256 encryption scheme
• Further modularized LZMA decompression implementation
• Added ZDO request queue support for a ZDO request command anticipating multiple responses
• Added ZCL request queue support for a ZCL request command anticipating multiple responses
• Added enhancements to the OTA server locating process
• Added support for Green Power GPDF frame encryption
• Optimized start-up LED indicator behavior, i.e. improve arbitration of LED usage between menu and status indications
• Added support for multiple handlers for the same GPIO
• Added generalized section support for multiple platforms
• Reject TC rejoin with MAC capabilities change to prevent security vulnerability (CSA incident no. 2021-ZP-0401)
• Added retry mechanism to the MAC association process for robustnessin dense networks
• Explicitly set the destination PAN ID in case of injecting an unsolicited rejoin response due to address conflict (improve interoperability with 3^rd party stack)
• Reject a leave request during the startup process if a rejoin is already in progress
• Routing optimization, add weak provisional default route to trust center
• Indicate parent router link failure upon failed keep-alive mechanism by making use of the end device timeout approach
• Introduced a multi-pass priority scheme for network leave processing (improve modularity)
• Ensure factory new state when a Touch Link commissioning procedure is instigated (for devices which do not reboot)
• Improved the Touch Link commissioning process flow in case of router/end device joining (await confirmation for pending leave request)
• Improved the transition behavior for the Level Control cluster
• Color Control cluster: Improved the behavior when changing color modes
• Extended support for the Fan Control cluster
• Added support for the Basic client cluster
• Added framework support for processing ZCL Read Attributes response command
• Enhanced the behavior upon receipt of an OTA Image Notify command
• Consider the fact that All Hubs and Touch Link clusters are only optionally available
• Consider the fact that a remote OTA server might not support rate limiting
• Prohibited OTA downgrade by default
• Added support for the gateway attribute “current channel”
• Bug-fix: Idle processing requires thread-safety on some platforms
• Bug-fix: Improve co-existence of AODV and MTO routing algorithms
• Bug-fix: Under rare circumstances a pending outgoing attribute report got discarded inadvertently
• Bug-fix: OTA hash calculation must account for data chunks not arriving in-sequence
• Bug-fix: Make sure all code paths align the transmit options for default responses with the mating request
• Bug-fix: Cluster-level global flags and individual configuration options used to be not maintained persistently
• Bug-fix: Disentangle cluster-level policy settings for APS ACKs and default responses
• Bug-fix: Fixed Green Power OOB key encryption for emerging Green Power install code support
• Bug-fix: Nonce setup for GPD vs. GPS used to be incorrect (relates to Hybrid Green Power feature)
• Bug-fix: NWK short address might be invalidated after a failed TC rejoin when the NWK key material has not been received in time
• Bug-fix: Ensure resetting the startup parameters during a cold-start
• Bug-fix: Ensure resetting the network layer’s retransmission queue across stack restarts
• Bug-fix: On some platforms loss of timer ticks might occur due to internal timer resolution discrepancy
• Bug-fix: Need to only evaluate the router/end device capacity fields in a beacon payload when performing network discovery during initial joining
• Bug-fix: Startup parameters might be inadvertently dropped across startup retry attempts
• Bug-fix: Unexpected behavior might be encountered while resolving an ongoing PAN ID conflict (caused by typo)
• Bug-fix: Internal coordinator flag might have inadvertently been set while forming a distributed network
• Bug-fix: Client/server cluster role not always properly honored when accessing an attribute
• Bug-fix: Increment network update ID in course of network-wide channel change (improve interoperability)
• Bug-fix: Global ZCL commands used to be silently dropped if the APS security level was insufficient. Instead, create a proper response mirroring the incoming security and indicating insufficient privileges.