Nde-Le-Be-Fe Diagnostics
NDE/LE/BE/FE Diagnostics
Screen Overview
The NDE/LE/BE/FE Diagnostics screen provides real-time diagnostics, maintenance, and synchronization tools for Allegion Engage gateways and locks (NDE, LE, BE, FE) integrated with BluSKY. Use this page to select a system/site, discover and manage gateways, inspect lock states, sync or reset local lock databases, update firmware, simulate card swipes, and troubleshoot communication through live command/reply panes.
Field Definitions
| Field Label | Definition | Notes |
|---|---|---|
| Commands | Live log showing commands sent to selected gateway/locks. | Read-only; use Clear Screens/Pause to manage output. |
| Replies | Live log showing replies/events from the selected gateway/locks. | Read-only; can be limited with Selected Gateway. |
| Selected Gateway (checkbox) | Filters command/reply traffic to only the highlighted gateway. | Uncheck to view all traffic for the current site. |
| Systems (right panel) | List of BluSKY systems available to the user. | Select a system to load its sites and devices. |
| Submit (Systems) | Applies the system selection/search to refresh device lists. | Enabled when a system is selected or typed. |
| Site Name | Text field to add or edit a site label for Engage devices. | Used with Add Site/Update Site Devices. |
| Operator Email | Email address for a site operator account. | Used when assigning/removing site operators. |
| IP Address (top) | IP address associated with the selected gateway. | Populated when reading gateway configuration. |
| Systems/Sites (bottom left) | Combined list of available systems and their Engage sites. | Selecting a site populates Gateways and Locks/Readers. |
| Gateways | List of Engage gateways discovered/assigned to the selected site. | Select a gateway before running gateway-specific actions. |
| Locks/Readers | List of locks/readers paired to the selected gateway. | Select one or more to view details or run lock actions. |
| Lock/Reader Details | Information panel for the selected lock/reader (status, params). | Read-only snapshot; refresh with List All Locks/Lock State. |
| Card/Facility Code | Manual entry of a credential value for testing. | Used with Simulate Swipe to generate an access event. |
| IP Address (Change IP Address) | New IP to apply to the selected gateway. | Used with Change IP Address. |
| Firmware File Path (Gateway) | File path to the gateway firmware package to be uploaded. | Used with Update Gateway Firmware. |
| Firmware File Path (Locks) | File path to the lock firmware file for model-specific updates. | Used with Update Locks Firmware. |
Screen Actions and Functions
- Clear Screens – Clears the Commands and Replies panes.
- Pause – Temporarily stops live log updates in both panes.
- List All Locks – Queries the gateway for all paired locks and populates the list.
- Lock State – Requests and displays current state of the selected lock(s).
- Lock Parameters – Reads configuration parameters from the selected lock(s).
- Sync Lock Schedules – Pushes access schedules from BluSKY to selected lock(s).
- Lock Portal – Sends a lock/secure command to the selected lock/portal.
- Unlock Portal – Sends an unlock command to the selected lock/portal.
- Release Portal – Sends a momentary release/REX-style command.
- Card Access Portal – Triggers a credential check on the selected portal.
- Sync Lock Database – Synchronizes the lock database on the gateway with BluSKY.
- Reset Lock Database – Rebuilds the lock database on the gateway from BluSKY. Use with caution.
- Sync Gateway Locks – Pulls the lock roster from the gateway and reconciles with BluSKY.
- Reset Gateway Locks – Clears and rebuilds the gateway’s lock list from BluSKY.
- Show Persons – Displays the list of persons associated with the site for troubleshooting.
- Systems > Submit – Confirms the selected system and refreshes context.
- Add Site – Creates a new Engage site under the selected system using Site Name.
- Delete Site – Removes the selected site from BluSKY. Blocked if devices exist.
- Site Operators – Manages operator assignments using Operator Email.
- Update Site Devices – Refreshes site device inventory from Engage to BluSKY.
- Initialize Gateway – Initializes/provisions the highlighted gateway for use.
- Gateway Config Info – Reads and displays gateway configuration including IP Address.
- Delete Gateway – Removes the selected gateway association from BluSKY.
- Gateway Firmware Versions – Displays detected gateway firmware levels.
- Update Gateway Firmware – Uploads firmware from Firmware File Path (Gateway).
- Change IP Address – Applies the IP Address (Change IP Address) to the selected gateway.
- Remove Operator – Removes the operator specified in Operator Email from the site.
- Update Gateway Devices – Discovers/updates devices connected to the selected gateway. Double-click to force a full sync.
- Delete Gateway Lock – Removes the selected lock from the gateway.
- NDE Firmware Versions / LE Firmware Versions / BE Firmware Versions / FE Firmware Versions – Displays available/installed versions for respective lock models.
- Update Locks Firmware – Uploads firmware from Firmware File Path (Locks) to selected locks.
- Refresh (Locks/Readers) – Re-queries locks/readers for the selected gateway.
- Simulate Swipe – Generates a test access event using Card/Facility Code.
- Map Lock to Reader – Associates a discovered lock with a BluSKY reader object.
Usage Instructions & Examples
How to synchronize a site’s Engage devices
- In Systems/Sites, select the target site and highlight the desired gateway.
- Click Update Site Devices to pull the latest site inventory.
- Double-click Update Gateway Devices to force a full gateway-to-BluSKY sync.
- Click List All Locks to confirm all locks are listed.
How to check and correct a lock that is not responding
- Select the gateway, then highlight the lock in Locks/Readers.
- Click Lock State to view its current status in Replies.
- If schedules are missing, click Sync Lock Schedules.
- If the lock roster is out of date, click Sync Gateway Locks.
- If corruption is suspected, click Reset Gateway Locks, then List All Locks.
How to update gateway firmware
- Select the gateway in the Gateways list.
- Click Gateway Firmware Versions to verify current level.
- Browse to the package path in Firmware File Path (Gateway).
- Click Update Gateway Firmware and monitor Replies until completion.
How to simulate a credential for testing
- Select the gateway and lock/portal to test.
- Enter the value in Card/Facility Code (format must match the site’s card format).
- Click Simulate Swipe and verify the event result in Replies and access logs.
How to change a gateway’s IP address
- Select the gateway and confirm connectivity with Gateway Config Info.
- Enter the new IP in IP Address (Change IP Address).
- Click Change IP Address and wait for confirmation in Replies.
How to add a new Engage site
- In Systems, select the correct system and click Submit.
- Enter a Site Name and (optionally) an Operator Email.
- Click Add Site, then Update Site Devices to discover devices.
System Behaviors and Edge Cases
- Double-clicking Update Gateway Devices forces a full device reconciliation between the Engage gateway and BluSKY.
- Many actions require a selection context:
- Gateway-specific actions are disabled until a gateway is highlighted.
- Lock actions require one or more locks selected.
- Sync vs Reset:
- Sync operations reconcile differences without destructive clearing.
- Reset operations rebuild the database/roster and can remove unmanaged devices; use cautiously.
- Firmware updates:
- The firmware file path must be reachable by the BluSKY client/agent performing the update.
- Model-specific firmware applies only to matching devices (NDE/LE/BE/FE).
- Power or network loss during update may leave devices in recovery mode; rerun the update if needed.
- Simulate Swipe:
- If the entered Card/Facility Code does not match a defined format, the action fails and an error is logged.
- Simulated events appear in control/transaction logs marked as simulated.
- Delete Site is blocked if gateways or locks are still assigned; remove or move devices first.
- Delete Gateway removes the gateway from BluSKY but does not factory-reset the hardware.
- Pause only stops screen updates; background device communication continues.
- Clear Screens removes only the on-screen logs; it does not clear device history.
- Selected Gateway checkbox filters displayed traffic; it does not limit which device a command is sent to—device selection still controls command targets.
Permissions
- Screen access: Global Administrators, Integrators/Installers, and Tenant/Site Administrators with Engage Management rights.
- Device control (Lock/Unlock/Release, Sync/Reset): requires DeviceControl or EngageDiagnostics permission.
- Firmware updates (gateway and locks): requires ManageFirmware permission.
- Site and gateway deletion: restricted to users with DeleteSites and DeleteGateways permissions.
- Mapping locks to readers and changing IP: requires DeviceConfigure permission.
- Read-only users can view logs and lists but cannot execute actions.
Linked Workflows
- Engage Provisioning and Gateways management: add/commission gateways before running diagnostics.
- Readers setup: use Map Lock to Reader to align physical locks with logical readers for access rules.
- Access Levels and Schedules: define schedules that are later pushed via Sync Lock Schedules.
- Control/Activity Logs: verify results of Simulate Swipe and lock commands.
- People/Credentials: ensure card formats and credentials exist for accurate testing.
Reference Image Links
