Release 25.12 (NAOSDK 4.12.2)

Release 25.12 (NAOSDK 4.12.2)

Versions

Component

Version

NAO® Cloud

25.12

NAO® Server

25.12

NAO® Viewer

25.12

NAO® Edge Adapter

25.12

NAO Cloud

Improvements / New features

  • Simplify infrastructure troubleshooting with enhanced debugging capabilities, including new debug buttons in Location Dashboard and Listener Monitoring pages for initiating targeted debugging sessions on selected tags or listeners.

  • Improve device visibility with new manufacturer and model fields added to MQTT /locs and /alerts messages, enabling better asset tracking and inventory management across diverse tag deployments.

  • Enhanced duress event traceability with new trace field in MQTT messages for button press events, providing visibility into the complete event processing pipeline including reporting gateways, adapters, and Kinesis streams for comprehensive system diagnostics.

NAO Server

Improvements / New features

  • Streamline deployment workflows with enhanced setup automation, including non-interactive installation mode for scripted deployments and improved offline installation support.

  • Improve system transparency with refined status messaging to reduce confusion during initial setup and configuration.

  • Service Versions:

asset-tracker:04a8537b-2026-01-08 busybox:1.37.0 grafana:11.3.1_env_inline gwadapter:3403b4f1-2026-01-07 haproxy:2.7_ssl_env_inline iegomez-mosquitto-go-auth:prem_inline-2.1.0-mosquitto_1.6.14 influxdb:1.11.8_env_inline_25.09 minio:env_inline_RELEASE.2021-01-30T00-20-58Z.hotfix.0c1d75aa8 minio_mc:env_inline_RELEASE.2021-03-23T05-46-11Z nao-gizmo:5294048f-2025-10-06 naocloud:5a02b6a9b-2026-01-8 naoviewer:R811e26ed-2026-01-07 postgres:13.2 redis:7.2.4 registry:2.8.3 telegraf:1.36.1_prem_inline_25.09
  • Improved reliability of the connection with Cisco Nova:
    Connection-level monitoring has been added at the application layer. The connection is now supervised by a scheduled job that checks measure reception every 15 seconds. If no data is received for 15 seconds, the connection is automatically reset. In addition, a periodic reconnection is performed when the IoT device is not accessible. CISCO_IOT_ORCHESTRATOR_TIMEOUT_SECONDS added to control the number of seconds before the connection is considered stale or non-functional.

  • Automatic cleanup of Cisco Nova when tags are deleted from the NAO server:
    When a trackable or a set of trackable assets is removed from the server (via the API or the web interface, either individually or in batch), the corresponding trackable(s) are automatically decommissioned from the IoT Orchestrator.

    The server CLI tag cleanup command remains available and allows the removal of all tags from a specific site. This command also cleans the tags in the IoT Orchestrator.

  • Cleaner and more consistent handling of public endpoints:
    The NAO server needs to know its public IP address or public hostname. Previously, providing this information required setting multiple environment variables. This has been simplified: only one environment variable is now required which is PUBLIC_ENDPOINT.

  • Docker Compose new configuration structure:

    • Added x-public-endpoints anchor for public-facing endpoint configurations

    • Added x-internal-endpoints anchor for internal service endpoints

    • Added x-internal-users anchor for internal user credentials

    • Added x-internal-databases anchor for database configurations

    • Added x-statsd-config anchor for StatsD monitoring configuration

  • conf.env new vars:

    • PUBLIC_ENDPOINT: public IP address or public hostname

    • ROOT_KEY: use as root key to all other internal passwords

    • CISCO_IOT_ORCHESTRATOR_TIMEOUT_SECONDS
  • Rétrocompatibilité:

    • The new Docker Compose file and setup.sh are compatible with previous projects.

    • The new conf.env is not compatible

NAO MAP SDK

Improvements / New features

  • Fixed map rendering priority - Resolved issue where certain floor maps were not displaying correctly due to improper layer ordering in multi-building deployments.

NAO Edge Adapter

Improvements / New features

  • Enable high-performance on-premise data processing with the new NAO Edge Adapter, a lightweight component that provides hybrid cloud-edge architecture for Cisco Spaces deployments, offering low-latency local data processing with cloud-based management and configuration.

  • Improve system reliability with redundant data paths, supporting both local firehose (direct from Cisco Spaces Connector) and cloud firehose streams for uninterrupted duress event processing.

MQTT API changes

New fields in location and alert messages

New fields added to /locs and /alerts topics:

  • manufacturer: String field identifying the tag manufacturer (e.g., "Minew")

  • model: String field identifying the tag model (e.g., "b7")

These fields are enabled on a per-site basis via NAO Cloud configuration parameter: tag_detail_fields=model,manufacturer

Example /locs message:

[ { "tag_id": 84635, "tracking_id": "C30000495972", "site_id": 6804, "loc_updated_at": 1764673128000, "lon": 1.3872890810366394, "lat": 43.5643507133133, "alt": 5, "loc_uncertainty": 1, "duration": 32524, "zone_ids": [120435], "trigger": null, "model": "b7", "manufacturer": "Minew" } ]

Enhanced duress event tracing

New trace field added to duress MQTT messages (trigger button_pressed and post_event_loc_update) providing event processing visibility:

  • reporters: List of gateways reporting the alert

  • adapters: Which adapter reported the alert (e.g., "NAO-Edge-ENVIRONMENT")

  • pipeline: Which Kinesis stream received the alert

  • payloads: Triggering payloads in hex string format (may be absent or empty)

In /locs messages:

  • If an alert exists in the alerts attribute, the trace field is added to the first alert object (message["alerts"][0])

  • If no alert exists, trace is added as a field of the location

In /alerts messages:

  • The trace field is added as a field of the alert

REST API changes

No breaking changes in this release.

Known Limitations

NAO Edge Adapter

  • NAO Edge Adapter only supports NAO Track NG, and single API Key (multi-site possible) configurations

NAO Server Debug Console

  • Debug Console is accessible only to admin users via /debug_console endpoint

  • Live log streaming limited to 300MB to prevent memory issues

  • Request timeout set to 90 seconds for long-running operations

  • Slow request warnings displayed for operations exceeding 3 seconds

NAO Cloud

  • MQTT trace field in duress messages may be absent or empty depending on event processing path - applications must handle both cases

  • Tag manufacturer and model fields require per-site configuration activation via tag_detail_fields parameter

    • Related Articles

    • Release 24.06 (NAOSDK 4.11.16)

      Versions Component Version NAO® Cloud 24.06 NAO® Viewer 24.06 NAO® SDK iOS 4.11.16 NAO® SDK Android 4.11.16 NAO® Logger iOS 4.11.16 NAO® Logger Android 4.11.16 New Features NAO® SDK New interface available – NAOSDK integrates a new callback, to ...
    • Release 24.03 (NAOSDK 4.11.15)

      Versions Component Version NAO® Cloud 24.03 NAO® Viewer 24.03 NAO® SDK iOS 4.11.15 NAO® SDK Android 4.11.15 NAO® Logger iOS 4.11.15 NAO® Logger Android 4.11.15 New Features NAO® Viewer Management of time overruns: to help our clients monitor ...
    • Release 23.12 (NAOSDK 4.11.14)

      Versions Component Version NAO® Cloud 23.12 NAO® Viewer 23.12 NAO® SDK iOS 4.11.14 NAO® SDK Android 4.11.14 NAO® Logger iOS 4.11.14 NAO® Logger Android 4.11.14 New Features NAO® Viewer Improve history management NAO Flow V1 NAO® Cloud / NAO® Server ...
    • Release 24.09 (NAOSDK 4.11.17)

      Versions Component Version NAO® Cloud 24.09 NAO® Viewer 24.09 NAO® SDK iOS 4.11.17 NAO® SDK Android 4.11.17 NAO® Logger iOS 4.11.17 NAO® Logger Android 4.11.17 New Features NAO® Cloud Location history: added new controls on the NAO Cloud history ...
    • Release 4.0

      Release V4.0.27 Date: 07 July 2016 Build: V4.0.27-R15136 Fixed Issues Android: Fix crash during BLE measurement serialization. Occurs only in debug mode and occasionally Release V4.0.25 Date: 01 July 2016 Build: V4.0.25-R15041 Fixed Issues Android ...