Features and enhancements

Automation 5.0.3000

The following are changes and improvements to the Automation module:

• Automation Web Admin console enhancements include validation upon entering data, with error and warning messages displayed if any omissions found.

  Added features to INSTRUCTION web editor for correctly defining the input source.

• Validating CONSTANT input added to prevent creation of invalid CONSTANTS.

  Same validation is made available in Web Admin. For convenience, JSON representation of a CONSTANT will be automatically parsed to string.

• CONSTANT binding of ANY type input now includes the type of the value.

  For example, an ArrayList type with value of {1,2} will result in a JSON String source {"@java.util.List":[1,2]} instead of array [1,2].

• Rules and templates JSON files tracking optimized to prevent unnecessary adding and removal of all artifacts.
• Rules triggers and flow validation added to the logger for more error cases to be visible.
• NUMERIC parameter metadata validation added in order to provide more accurate numeric data range and definition for the allowed values.
• Binding to SYSTEM timestamp input type allowed when the expected value is not of type long (e.g. string or an array with one element).
• Subscribe and unsubscribe console commands optimized for more intuitive options and easier filtering of events.
• HAM module: HAM measurements support removed. See all removals.

Azure IoT Integration 1.0.0 [New Module]

Bosch IoT Gateway Software is now available to run as an Azure IoT Edge module. Integration provides bi-directional communication that allows you to:

• Access devices connected to the Gateway in IoT Hub
• Filter devices and functionalities based on granular criteria
• Configure device twin updates and messages
• Update device and twin properties on either side
• Process device telemetry messages through the Azure IoT Edge services

  For more information on features, configurations and property mappings, visit Azure IoT Integration.

BACnet 1.0.0 [New Module]

Connectivity for BACnet devices over IP (BACnet/IP) network type now available. Module features include:

• Integration with Device Access module to support specific BACnet functionalities using device items
• BACnet Discovery to search and filter BACnet devices
• BACnet objects mapping to BACnet-specific device items

  For more information on features, setup and mappings visit BACnet module.

Bluetooth LE 1.6.0

The following are changes and improvements to the Bluetooth LE module:

• More Bosch Connected Devices (BCD) connected via Bluetooth LE:
  • Bosch Transport Data Logger (TDL) 110 device
  • Sense Connect Detect (SCD) device

  For configuration and accessing GATT Services visit Bluetooth LE Managing Bosch Connected Devices.

• Bluetooth LE pairing methods supported include Just Works, Numeric Comparison, Passkey Entry. For more information, visit Bluetooth LE Pairing.
• Removed deprecated and outdated APIs and functionalities. See all removals.

Cameras 4.5.0

Removed bundles and dependencies due to API removals in SDK 10. See all removals.

Core 1.4.0

The following are changes and improvements to the Core module:

• Async Util termination allowed as part of AsyncUtil API to allow termination of a hanged task.
• Timestamp Annotated Commands API improvements. It is now possible to pass Date parameters to the console commands.
• Commands Utilities API extensions. It is now possible to print Event objects conveniently for command listing, also some other helpful methods were added.
• ManifestParser moved to Framework module. [Concerns Migration]
• Web Console bundles transfer [Concerns Migration]
  • com.prosyst.mbs.web.console.backup bundle moved from Web to Core and renamed to com.prosyst.mbs.core.web.console.backup
  • com.prosyst.mbs.web.console.cpa bundle moved from Web to Core and renamed to com.prosyst.mbs.core.web.console.cpa
• Removed deprecated and outdated APIs and functionalities. See all removals.

Database 3.2.0

The following are changes and improvements to the Database module:

• Upgraded JDBC driver API specification supported to version 4.1.
• Upgraded JDBC driver implementation to allow more than 32 parameters for SQLite INSERT query.
• Upgraded SQLite version used to 3.31.0. Changes log for this version can be found here.
• Removed SQLite internal JDBC API. See all removals.

DECT 2.3.1000

Removed bundles and dependencies due to API removals in SDK 10. See all removals.

DevStreams

Entire module removed. See all removals.

Device Access 3.5.0

Operation event metadata added to DeviceAccess API operations that define operation executed events.

Externals 1.4.0

The following are changes and improvements to the Externals module:

• Richer XML processing support to enable operation on Java 11+
  • woodstox-core bundle added with version 5.3.0
  • Stax2-api bundle updated to version 4.2.0
  • Javax.activation and javax.activation.compact bundles updated to version 1.2.0
  • Javax.xml.bind and javax.xml.bind.compact bundles updated to version 2.3.1
  • Jackson.dataformat.xml bundle added with version 2.10.0
  • Jackson.annotations, jackson.core, jackson.databind, jackson.jaxrs.json.provider and jackson.module.jaxb.annotations bundles updated to version 2.10.0

• Jetty HTTP2 and Servlet 3.0 support enhancements

  The following libraries required by the Jetty HTTP Server, are made Java 8 compact1 compatible:

  • Jetty-alpn-api, v.1.1.3.v20160715
  • Jetty-alpn-conscrypt-server, v.9.4.18.v20190429
  • Jetty-alpn-openjdk8-server, v.9.4.18.v20190429
  • Jetty-alpn-server, v.9.4.18.v20190429
  • Jetty-http2-hpack, v.9.4.18.v20190429
  • Jetty-http2-server, v.9.4.18.v20190429
  • Jetty-osgi-alpn, v.9.4.18.v20190429
  • jetty-security, v.9.4.18.v20190429
  • jetty-server, v.9.4.18.v20190429
  • jetty-servlet, v.9.4.18.v20190429
  • jetty-util, v.9.4.18.v20190429

• Enabled WebSockets support over Jetty HTTP

  The following library bundles were added:

  • javax.websocket-api, v.1.0.0
  • websocket-api, v.9.4.18.v20190429
  • websocket-common, v.9.4.18.v20190429
  • websocket-server, v.9.4.18.v20190429
  • websocket-servlet, v.9.4.18.v20190429

  Those libraries are also java 8 compact1 compatible.

• Java 13 support
  • org.objectweb.asm bundle updated to version 7.3.1 in order to enable the depending bundles for Java 13

• OSGi Core Release 7 support
  • osgi.core bundle updated to version 7.0.0
  • osgi.annotation bundle updated to version 7.0.0

• Web Console bundles transfer [Concerns Migration]
  • org.apache.felix.webconsole bundle moved from External to Web
  • org.apache.felix.webconsole.plugins.event bundle moved from External to Web
  • org.apache.felix.webconsole.plugins.useradmin bundle moved from External to Web
  • org.apache.felix.webconsole.plugins.ds bundle removed from SDK
  • org.apache.felix.webconsole.plugins.upnp bundle removed from SDK
  • org.apache.felix.webconsole.plugins.packageadmin bundle removed from SDK

• Removed deprecated and outdated APIs and functionalities See all removals.

FIM 2.3.2000

The following are changes and improvements to the FIM module:

• Eventable-only operations metadata added. Enables the definition of the operation properties and their types added later as event properties in the operation executed events.

  Visible in the Metadata Viewer in FIM web admin and console commands.

• Added validation for the Functional Item UID uniqueness by Register and Modify hooks.
• Infinity and NaN numbers support added. These numbers could be created by providing their string representation, e.g. {"value":"Infinity"}.

  Available in the extended Web Admin data editor for java.lang.Number BEAN metadata.

• Handling of invalid LDAP filters passed as arguments to the Groups API operations unified.

  Currently IllegalArgumentException is thrown instead of InvalidSyntaxException as it is expected on each item operation call with unexpected argument value.

  The changed operations are:

  • com.prosyst.mbs.services.fim.groups.GroupAdmin.getRootGroups(String)
  • com.prosyst.mbs.services.fim.groups.Group.filterItems(String)
  • com.prosyst.mbs.services.fim.groups.Group.filterItemsByType(Class<T>, String)
• Subscribe and unsubscribe console commands optimized with more intuitive options and easier filtering of events.
• Removed deprecated and outdated APIs and functionalities See all removals.

Framework 8.6.2

The following are changes and improvements to the Framework module:

• Support for OSGi Core Release 7 now available.

  The newest version of the OSGi Framework enables better interoperability and access to the newest OSGi APIs and annotations.

• Services moved to Framework: [Concerns Migration]
  • Resolver service (com.prosyst.mbs.services.resolver) – moved from OSGi.
  • Manifest parser (com.prosyst.util.manparser) – moved from Core.
• Service modification hooks now make it possible to reject modification of service properties. For more info visit Intercept Service Operations.
• Truncating longer bundle locations now allows bundles with longer locations to be installed in framework storage.
• Added system property (mbs.useradmin.default.saltAlgorithm) to linux server script, in order to use non-blocking secure random algorithm.
• Removed deprecated and outdated APIs and functionalities See all removals.

History 1.3.0

Subscribe and unsubscribe console commands optimized with more intuitive options and easier filtering of events.

JSON-RPC 1.5.0

The following are changes and improvements to the JSON-RPC module:

• JSON push events now provided by WebSockets Endpoint (com.prosyst.mbs.webservices.jsonrpc.event.websocket.endpoint)
• Inactivity timeout now added to JSON Long Polling Subscription Configuration.
• Removed deprecated and outdated APIs and functionalities See all removals.

KNX 5.5.0

The following are changes and improvements to the KNX module:

• Handling invalid values added on driver and adapter level based on KNX Datapoint specification.
  • Added new method DPT.isValueValid() (package com.prosyst.mbs.services.knx.dpt, version 1.6.0) with default implementation that always returns true.
  • Updated classes DPTTempRoomSetpSetF16 and DPTTempRoomSetpShiftSetF16 with new methods to check validity and set invalid values for the Comfort, Standby and Eco settings.
  • If an invalid value is reported on a datapoint of a Sensor/Actuator/Setpoint device item, the value inside the item's Quantity value is set to Double.NaN.
• Misspelled classes [Concerns Migration]
  • A few classes had the wrong spelling Conection instead of Connection. New names: ConnectionManager, ConnectionManagerCallback, ConnectionManagerTCP and ConnectionManagerUDP.
  • com.prosyst.mbs.services.knx.ip package version changed to 2.0
• Removed deprecated and outdated APIs and functionalities See all removals.

mDNS 1.2.0

The following are changes and improvements to the mDNS module:

• Misspelled method [Concerns Migration]
  • getSubType, containing non UTF8 capital character 'T' removed. Use the replacement getSubType method.
  • com.prosyst.mbs.services.mdns.ServiceDescriptor package version changed to 2.0

MediaStreams

Entire module removed See all removals.

mToolkit 3.7.3000

Removed deprecated and outdated APIs and functionalities See all removals.

Network Manager

Entire module removed See all removals.

OMA

Entire module removed See all removals.

ONVIF 1.3.0

The following are changes and improvements to the ONVIF module:

• Camera Certificates Validation added.

  New functional item SecureConnection allows handling HTTPS connections to the ONVIF device. For more info visit Validation of Camera Certificates.

• Camera Firmware Updates added.

  New functional item FirmwareUpdate for Bosch cameras allows updating the device software version. For more info visit Camera Firmware Updates.

• Device ONLINE/OFFLINE status part of Device Access now implemented for ONVIF.

OSGi 1.6.0

The following are changes and improvements to the OSGI module:

• Default HTTP service is Jetty.

  A new framework start argument httpcompat is in place. The old httpnext start argument has been removed.

• Deprecated proprietary APIs com.prosyst.mbs.services.http.
• Javax WebSockets API (JSR 356) support added.
• Support for fine grained SSL connection parameters customization through SSLContext and SSLParameters services added.
• Event Collector Utility added to replace the EventTracker functionality.

  The utility provides a mechanism to inspect events, dispatched before a handler/application is registered.

  • com.prosyst.mbs.services.event.tracker.EventCollector added.
  • com.prosyst.mbs.services.event.tracker.EventTracker deprecated.
• Asynchronous Executor Utility integrated into Configuration Admin and Metatype. The utility uses java.util.concurrent API and is more easy to maintain.
  • com.prosyst.util.concurrent.AsyncUtil replaces usage of com.prosyst.util.Timer.
• Resolver module moved [Concerns Migration]

  Functionality integrated into Framework module: com.prosyst.mbs.services.resolver package removed (moved to Framework).

• Removed deprecated and outdated APIs and functionalities See all removals.

Peripheral 2.0.4000

The following are changes and improvements to the Peripheral module.

• IPv6 support in mDNS Observer. Configuration for IPv6 only devices is introduced. If both IPv4 and IPv6 addresses are available, the Peripheral Admin will use IPv4.
• Subscribe and unsubscribe console commands optimized with more intuitive options and easier filtering of events.

REST 2.1.0

The following are changes and improvements to the REST module:

• REST push events now provided by WebSockets Endpoint (com.prosyst.mbs.webservices.rest.event.websocket.endpoint)
• Removed deprecated and outdated APIs and functionalities See all removals.

RMT

Entire module removed See all removals.

SHIP 2.3.0

The following are changes and improvements to the SHIP module:

• New HttpService/WebSockets support [Concerns Migration]

  The following three bundles have new implementations based on JRS 356 (javax.websockets) and its suplementary OSGi HTTP and javax.net.ssl services:

  • com.prosyst.mbs.ship.driver.tls
  • com.prosyst.mbs.ship.driver.exporter
  • com.prosyst.mbs.ship.driver.server

  The previous versions of the SHIP bundles are kept for compatibility under new names:

  • com.prosyst.mbs.ship.driver.tls.websockets
  • com.prosyst.mbs.ship.driver.exporter.websockets
  • com.prosyst.mbs.ship.driver.server.websockets

  The suffix ".websockets" denotes that the implementation of the bundle is based on the deprecated Bosch WebSockets API. Additionally, these bundles have the suffix "Compatibility Mode" in their Bundle-Name manifest header.

  New kitman scripts reference the old compatibility SHIP bundles (*.websockets) to be used when the OSGi framework is started with httpcompat server option.

  • SHIP Compatibility Mode
  • SHIP DA HDM Support Compatibility Mode

SPINE 2.5.0

The following are changes and improvements to the SPINE module:

• New HttpService/WebSockets support [Concerns Migration]
  • Two new scripts (*.websockets) reference respectively the compatibility SHIP scripts above (see SHIP) and these shall be used when the OSGi framework is started with httpcompat server option.
  • Two EEBus SPINE demos are provided with new kitman scripts for starting the demos in compatibility mode.

TEE 2.0.4001

Upgraded JUnit 4 version from 4.11 to 4.12. Summary of the changes for this version can be found here.

Units 1.2.3000

Unit of pressure added to the Imperial system that represents "pound-force per square inch".

Util 1.2.0

The following are changes and improvements to the Util module:

• Simple Login service updates.
  • Default protection for passwords is upgraded to fit the new security standards for hashing and salting passwords.
  • A new SimpleLoginException is introduced in the SimpleLogin API to unify the thrown exceptions.
• Kitman scripts can contain minimum execution environment. Kitman Manager allows a kitman script to express mandatory requirements for its execution against the hosting environment. This is described via a LDAP filter in a Kitman-Target header in the kitman script.
• Removed deprecated and outdated APIs and functionalities. See all removals.

WebSockets 1.2.0

The following are changes and improvements to the WebSockets module:

• Deprecation of Bosch proprietary WebSockets API (com.prosyst.mbs.services.websockets)
• Created basic demo for JRS 356 (javax.websockets) Java API for WebSockets support.

Zigbee 4.8.0

The following are changes and improvements to the Zigbee module:

• Reporting device item added.

  This new item could be used to dynamically read and configure device attribute reports. For Reporting operations mapping to Zigbee Cluster Library(ZCL), check Supported General Commands table in Zigbee Cluster Library Support.

• Message handling mechanism added with priority in the simulator. Now messages received by the simulator are processed by handlers. To change the default message processing, add MessageHandlers with higher priority.
• Removed deprecated and outdated APIs and functionalities See all removals.

Z-Wave 6.0.0

The following are changes and improvements to the Z-Wave module.

• Z-Wave Plus V2 support

  The Z-Wave Network Protocol Specification was implemented and tested over the currently latest Z/IP Gateway release - 7.13.01. The new bundle (com.prosyst.mbs.zwave.driver.zip.gateway) provides an IP protocol client for the Z/IP Gateway application, which is now mandatory for Z-Wave Plus V2 certification. This is a result of the Z-Wave Serial API becoming private.

  For complete overview and set up, visit Z-Wave Module Overview.

• New Z/IP gateway-based features include:
  • Z-Wave S2 support (see com.prosyst.mbs.zwave.ZWaveS2Bootstrapping in Z-Wave Driver Java API)
  • Z-Wave Smart Start support (see Z-Wave Node Provisioning APIs provided on Driver and Device Access levels in Z-Wave DA Items Java API)
• The old serial API-based Z-Wave Plus stack is getting deprecated.
• Command Class Multilevel Sensor support upgrade

  Z-Wave Plus v2 certification requirement. Support extended from version 10 to version 11 on Driver and Device Access level. Available only over the Z/IP Gateway based Z-Wave driver.

• Command Class Basic support upgrade

  Z-Wave Plus v2 certification requirement. Support extended from version 1 to version 2 on Driver and Device Access level. Available only over the Z/IP Gateway based Z-Wave driver.