...
Info |
---|
This document describes the functionality of alarm/ SMS/ beacon how to configure the integration between W-AIR base station and a Message serverand any Nurse call system. The integration is based on MQTT protocol. User Guide: Nurse Call Systems Integration with Wildix W-AIR - User Guide. Created: June 2024 Permalink: https://wildix.atlassian.net/wiki/x/UATOAQ |
...
Requirements
- WMS 6.0X
- W-AIR firmware version 730B200version 730b200
- Supported devices
- W-AIR base station: W-AIR Sync Plus, W-AIR Base Station
- W-AIR handset: W-AIR Med, W-AIR LifeSaver, W-AIR LifeSaver-EX
...
Priority
It is possible to set an alarm with different priority, below are the different colors that are used on W-AIR handset depending on the priority.
- 1: red
- 2: red
- 3: red
- 4: Yellow
- 5: Yellow
- 6: Yellow
- 7: Green
- 8: Green
- 9: Green
- All other values: Green
Confirmation type
XML child "confirmationtype" (JobDataDef):
- 0: No User confirmation needed
- W-AIR base station sends back a confirmation to a Message server that the message is received on W-AIR base station
- 1: User Received Job confirmation needed
- W-AIR base station sends back a confirmation to a Message server that the message is received on W-AIR base station
- W-AIR base station sends back a confirmation to a Message server that the message is received on W-AIR handset
- 2: User Confirm/ Reject Job confirmation needed
- W-AIR base station sends back a confirmation to a Message server that the message is received on W-AIR base station
- W-AIR base station sends back a confirmation to a Message server that the message is received on W-AIR handset
- W-AIR base station sends back a confirmation to a Message server if the user confirms /rejects the message
Reference number
Substituting an alarm
The reference number is unique number per alarm. When sending an alarm, the reference number always needs to be present, otherwise the message is interpreted as an SMS.
- If an alarm is sent with the same referencenumber as a previous alarm that is NOT yet confirmed/ rejected (confirmationtype 2), the first alarm is deleted and only the new one is saved and displayed on W-AIR handset
- If an alarm is sent with the same referencenumber as a previous alarm that is confirmed/ rejected, then both alarms are displayed
- If an alarm is sent with the same referencenumber as a previous alarm that has confirmationtype 0 or 1, then both alarms are on W-AIR handset
Deleting an alarm
It is possible to delete an alarm that is NOT yet confirmed/ rejected on W-AIR handset.
- Deletion is available for an alarm with confirmationtype 1 and 2
- For deleting an existing alarm, the same reference number should be used and the status should be set to 10
Response handling
For confirmationtype 1 and 2, there is always a response sent to a Message server that W-AIR base station/ handset receives the messages:
- A Message server needs both responses to be sure that the messages are received on W-AIR handset.
- A Message server should not send a new message to the same W-AIR handset before both responses are received
- In case a Message server does not receive the response from W-AIR handset, it should wait a minimum of 10 sec before trying to send a message again to the same W-AIR handset. This is needed so W-AIR base station has enough time to timeout the first messages
When using confirmationtype 0, a Message server doesn't know if the SMS/ alarm is lost from W-AIR base station to W-AIR handset. Here a Message server should always wait 10 sec between each message to the same W-AIR handset
Examples
Below are examples of an alarm sent from a Message server with confirmationtype 2:
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Delete an alarm
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Sending alarms
...
from W-AIR base station/ handset to a Message server
W-AIR handset can be configured so it sends an alarm to a Message server for the following cases:
...
Parameters are stored on W-AIR base station and transferred to W-AIR handset, it is not possible to change them on W-AIR handset:
Name | Setting | Comment |
---|---|---|
Handset mode (2 bit) | Receive beacon, transmit beacon, 1 selectable (drop down) receive and transmit beacon. | 1 selectable (drop down) |
Active mode | ||
Transmit power (6 bit) | 0 to -46dBm in 2 dB steps | 1 selectable (drop down) |
Transmit selection (2 bit) | Select which beacon type to transmit: | 1 selectable (drop down) |
Transmit interval (2 bit) | Interval between each beacon transmit: | 1 selectable (drop down) |
Passive mode | ||
Receive mode (2 bit) | Report beacon information: | 1 selectable (drop down) |
Receive selection (4 bit) 1 extra bit reserved | Select which beacons to receive: | All 3 can be selected |
In W-AIR network with up to 1000 handsets, it is important to use as little space as possible for the parameters. It is not recommended to store the broadcast for each W-AIR handset as this will fill 32kByte on W-AIR base station. The IPEI number should be used as part of the UUID number together with a selectable value that is the same for all handsets.
Transmit beacon content (32 bytes) | Broadcast data of the transmitted beacon (space reserved 32 bytes): | Input of up to 32 bytes |
Sending beacon messages from W-AIR base station/ handset
...