Actions

Difference between revisions of "Message Formats - Grouped by Function"

From Zenitel Wiki

(Station Features and Status)
(General Exchange Control)
 
(11 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
{{AI}}
 
=== See also ===
 
=== See also ===
  
Line 54: Line 55:
 
|-
 
|-
 
|align=center| [[ST_AUDIO_OPT]] || align=center |   || align=center | 0x00AB  || Control audio options of station in connection.  
 
|align=center| [[ST_AUDIO_OPT]] || align=center |   || align=center | 0x00AB  || Control audio options of station in connection.  
|-
 
| align=center|[[CONN_2_GROUP ]] || align=center | C2G || align=center | 0x00B0 || Connect the audio from a group to the speaker of the group
 
 
|-
 
|-
 
|}
 
|}
Line 189: Line 188:
 
| [[TEMP_PROG]] ||align=center|TPROG||align=center|0x0096|| Temporarily "mute" program distribution to a station
 
| [[TEMP_PROG]] ||align=center|TPROG||align=center|0x0096|| Temporarily "mute" program distribution to a station
 
|-
 
|-
|[[VOL]]|| align=center |  || align=center | 0x009B || Set station volume
+
|[[VOLUME|VOL]]|| align=center |  || align=center | 0x009B || Set station volume
 
|-
 
|-
 
|[[HS_SIDE]]|| align=center |  || align=center | 0x00A2 || Turn station handset overhearing ON/OFF
 
|[[HS_SIDE]]|| align=center |  || align=center | 0x00A2 || Turn station handset overhearing ON/OFF
Line 196: Line 195:
 
|-
 
|-
 
|[[VOIP_AUDIO_CONFIG]]|| align=center | VAC|| align=center | 0x00AF || Configure the RTP stream station  
 
|[[VOIP_AUDIO_CONFIG]]|| align=center | VAC|| align=center | 0x00AF || Configure the RTP stream station  
 +
|-
 +
|[[CONN_2_GROUP ]] || align=center | C2G || align=center | 0x00B0 || Connect the audio from a group to the speaker of the group
 +
|-
 +
| [[PA_CMD]] || align=center |  || align=center | 0x00AE  || Acknowledge and remove IP-ARIO PA failure states.
 
|-
 
|-
  
Line 301: Line 304:
 
|-
 
|-
 
| [[DUMMY]] || ||align=center|0xFFFE|| Test message:  Should be routed, accepted and ignored
 
| [[DUMMY]] || ||align=center|0xFFFE|| Test message:  Should be routed, accepted and ignored
 +
|-
 +
| [[SMALL_RESET]] || ||align=center|0x00BC|| Simulates Small Reset sent from ICX-AlphaCom web interface
 +
|-
 +
| [[CHILLY_RESET]] || ||align=center|0x0039|| Simulates Chilly Reset sent from ICX-AlphaCom web interface
 
|-
 
|-
 
|}
 
|}
Line 344: Line 351:
 
| [[RCO_CHANGED]] ||align=center|RCOC||align=center|0x0085|| New RCO state reported from the exchange
 
| [[RCO_CHANGED]] ||align=center|RCOC||align=center|0x0085|| New RCO state reported from the exchange
 
|-
 
|-
| [[RCI_CHANGED]] ||align=center|$RCIC||align=center|0x0084|| New RCI state reported from the exchange
+
| [[RCI_CHANGED]] ||align=center|RCIC||align=center|0x0084|| New RCI state reported from the exchange
 
|-
 
|-
 +
| [[SET_IPRCO]] || align=center |  || align=center | 0x00AD  || Set a physical RCO on IP station or IP-ARIO
 +
|-
 +
 
|}
 
|}
  
Line 404: Line 414:
  
 
=== AlphaNet ===
 
=== AlphaNet ===
This is messages related to audio control between exchanges.  <br\>[[AlphaNet]] also uses other messages like station emulation, mails, and system maintenance.
+
This is messages related to audio control between exchanges.  <br />[[AlphaNet]] also uses other messages like station emulation, mails, and system maintenance.
  
  
Line 545: Line 555:
 
<br><br>
 
<br><br>
  
[[Category:AlphaCom E Software]]
+
[[Category: AMC Software]]
 
[[Category:AlphaNet]]
 
[[Category:AlphaNet]]
 
[[Category: ACDP messages]]
 
[[Category: ACDP messages]]

Latest revision as of 14:23, 30 June 2022

AI.png

See also

Station Connect Operations

Message Short name Message no, Hex Description
CALL_SETUP CALL 0x0008 Sets up a conversation between two users
CONN_REQUEST CONN 0x000A Sets up a conversation between two users
CONN_REFERENCE   0x000B Positive response from the exchange to CONN_REQUEST
CONN_REF_ACK   0x000E The external application acknowledges the CONN_REFERENCE
STATION_BUSY   0x000D Negative response to CONN_REQUEST
RESOURCE_BUSY   0x003E Negative response to CONN_REQUEST
NO_ACCESS   0x003F Negative response to CONN_REQUEST
STATION_DOWN   0x000C Negative response to CONN_REQUEST
DISCON_ST   0x008E Disconnect station from ongoing feature
DISC_REQ   0x0011 Conversation established with CONN_REQUEST: The external application disconnects a conversation.
DISC_REQ_ACK   0x0012 Conversation established with CONN_REQUEST: The AlphaCom acknowledges the DISC_REQ message
DISCONNECTED   0x000F Conversation established with CONN_REQUEST: Conversation was disconnected, e.g. the user pressed C-key
DISCONNECTED_ACK   0x0010 Conversation established with CONN_REQUEST: Acknowledge of the DISCONNECTED message
CALL_STATUS_BC   0x0040 Broadcast message telling the status of a call
CONN_STATUS_BC   0x0041 Broadcast message telling that a connection is established
DISCON_STATUS_BC   0x0042 Broadcast message telling that a connection is disconnected
PARK_INQ_BROKER INQ 0x0086 Park station from conversation, enter Inquiry call state
UNPARK   0x0087 Unpark station from Inquiry call state station, return to conversation
REQ_TRANSF_CALL TRFC 0x0088 Transfer call in an Inquiry Call situation.
PAR_RING   0x0098 Add a Parallel Ringer station to a call in ringing state
SET_SIMPLEX SIMP 0x00A3 Set conversation in simplex
ST_AUDIO_OPT   0x00AB Control audio options of station in connection.



Station Keyboard & Display emulation

Note that the exchange remembers the M-key state and the handset state forever (it’s not “cleared” e.g. by conversation cancel).


Message Short name Message no, Hex Description
DIAL_DIGITS DD 0x0050 Simulate digit dialing from a station
DIAL_DAK   0x0094 Dial DAK on a station
PLAY_DAK PD 0x009C "Dial sequence" for playback.
SINGLE_DIGIT DIG 0x0051 Dial one digit on a station
DIGIT_RELEASE DREL 0x0052 The station has released a digit press
M_KEY M 0x0054 Order station to press M-key
M_KEY_RELEASE MREL 0x0055 Order station to release M-key
HANDSET_OFF HOFF 0x0056 Order station to lift handset
HANDSET_ON HON 0x0057 Order station to replace handset
R_KEY   0x00A4 R_KEY signal
HS_SIDE   0x00A2 Turn handset sidetone on/off
C_KEY C 0x0058 Order station to press C-key
DISPLAY_TEXT DSPL 0x005A Send text and control characters to a station
DIP_FWD DIP 0x00A0 Send DIP messages to IP stations
ST_BUSY_BC   0x0036 Broadcast message: Intercom station is busy
ST_FREE_BC   0x0037 Broadcast message: Intercom station is free



Station Features and Status

Message Short name Message no, Hex Description
PROGRAM PROG 0x0001 Set audio program for single station or a predefined group of stations
PROGRAM_ACK   0x0003 Positive response to PROGRAM
PROGRAM_NAK   0x004D Negative response to PROGRAM
PROG_CONF CONF 0x0004 Set Simplex conference for predefined group of stations or a single station
PROG_CONF_ACK   0x0006 Positive response to PROG_CONF
PROG_CONF_NAK   0x004E Negative response to PROG_CONF
CONF_TALK   0x008B Set Simplex conference speaker
CONF_TALK_STOP   0x008C Stop station form feeding Simplex conference
AUDIO_DETECT VOX 0x0053 Triggers the event Simplex_Conference_Audio
O_DUPL_CONF ODC 0x006F Include/exclude a station or a group into/from an Open Duplex Conference
OD_CONF_ENTERED   0x0076 The participant has entered an Open Duplex Conference
OD_CONF_LEAVE   0x0071 The participant has left the Open Duplex Conference
ALARM_MSG ALRM 0x0007 Set up (or disconnect) an ASVP Alarm message to a single station or a predefined group of stations
ALARM_MSG_ACK   0x0009 Positive response to ALARM_MSG
ST_GROUP_DISCON SGD 0x0074 Switch off Group Call audio at a station that receives Group Call audio at the moment
SET_CALL_REQ_MODE SCRM 0x006C Turn on/off message “your call is registered, please wait”, then ringing/flashing at a station
CALL_TRANSFER TRF 0x0044 Set or remove call transfer for a station
CALL_TRANSFER_OK   0x0045 Positive response to CALL_TRANSFER
CALL_TRANSFER_NOK   0x0046 Negative response to CALL_TRANSFER
SET_REQ_TRANSF SCRT 0x002B Set transfer of Call Request for an intercom station
GET_REQ_TRANSF   0x002C Get the Call Request Transfer status for an intercom station
REQ_TRANSF   0x002D Response to the SET_REQ_TRANSF and GET_REQ_TRANSF messages
SET_ABSENCE SABS 0x0028 Set absence status for an intercom station
GET_ABSENCE GABS 0x0029 Get absence status for an intercom station
ABSENCE_STATUS   0x002A Response to SET_ABSENCE and GET_ABSENCE messages
WAKE_UP   0x0047 Register or remove wake­up request
WAKE_UP_ACK   0x0048 Positive response to WAKE_UP
WAKE_UP_NAK   0x0049 Negative response to WAKE_UP
SET_GRP_FILT GFLT 0x007D Set group call filter for a station
GROUP_MEMBERSHIP GRM 0x0081 Set group membership in NVRAM for a station
EXT_FEATURE_BC   0x0043 Broadcast message when a directory number (feature 50) is dialed on a station
SET_STATION_COS SSC 0x0090 Set COS membership in NVRAM for a station
MODIFY_COS_CONTENTS MCC 0x0091 Modify feature membership in COS in NVRAM
DTMF_CONN   0x0097 Generate DTMF tone during conversation (Only during conversation with RingMaster)
SVP_ST   0x00AC Start playback of a message during conversation
TEMP_PROG TPROG 0x0096 Temporarily "mute" program distribution to a station
VOL   0x009B Set station volume
HS_SIDE   0x00A2 Turn station handset overhearing ON/OFF
MVO   0x00A8 Mask volume and handset override ON/OFF
VOIP_AUDIO_CONFIG VAC 0x00AF Configure the RTP stream station
CONN_2_GROUP C2G 0x00B0 Connect the audio from a group to the speaker of the group
PA_CMD   0x00AE Acknowledge and remove IP-ARIO PA failure states.



Station Mail Operations

Message Short name Message no, Hex Description
SEND_MAIL SM 0x0031 Send a mail message to an intercom station
SEND_TXT_MAIL STM 0x0032 Send a mail message with free text to an intercom station
SEND_MAIL_ACK   0x0033 Response to the SEND_MAIL and SEND_TEXT_MAIL messages
CANCEL_MAIL CANM 0x0065 Delete one or more mail/call request/alarm messages queued at a station
SET_MAIL_TIMEOUT SMT 0x0082 Set the timer of a mail queue entry
COPY_MAIL CPYM 0x0083 Send a copy of a mail in own queue to a new destination (station or group)
MAILQ_NAVIG   0x008D Do operation on mail queue, or step current mail in mail queue
DELETE_MAIL DELM 0x0034 Delete a mail entry in the queue for an intercom station
DELETE_MAIL_ACK   0x0035 Response to the DELETE_MAIL message
GET_FIRST_MAIL   0x002E Get the first mail entry in the queue for an intercom station
GET_LAST_MAIL   0x0064 Get the last mail entry in the queue for an intercom station
GET_NEXT_MAIL   0x002F Get the next mail entry in the queue for an intercom station
GET_PREV_MAIL   0x0063 Get the previous mail entry in the queue for an intercom station
GET_THIS_MAIL   0x004A Get the identified mail entry in the queue for an intercom station
EXT_MAIL   0x0030 Response to the GET_x_MAIL messages
Q_ELEM_ADDED   0x004B Broadcast message. Reports that a mail message has been added to a station’s mail queue
Q_ELEM_REMOVED   0x004C Broadcast message. Reports that a mail message has been removed from a station’s mail queue
UPD_MAIL_TIMEOUT   0x009D Used for Ringing Group to update mail timeout in AlphaNet



General Exchange Control

Message Short name Message no, Hex Description
SET_SYSTEM_TIME SST 0x0027 Set the internal clock to the given date and time
GET_SYSTEM_TIME GST 0x0025 Ask a device (AlphaCom) for date and time
SYSTEM_TIME   0x0026 Response to the GET_SYSTEM_TIME and SET_SYSTEM_TIME message
PUT_STRING PUT 0x0073 Output String to Exchange serial port after adding appropriate framing depending on selected port
LOG_STRING LOG 0x0075 Output String to System Log
EXECUTE_COMMAND X 0x004F Send a command string to the exchange to be executed there
EVENT_REPORT ER 0x0067 Report an event to the event/action system
SET_TIMER ST 0x008F Start or stop a timer
WRITE_USER_DEF_DATA WUDD 0x008A Write User Defined Data (UDD)
SET_DIRNO_TXT SDT 0x0077 Change the display text of a directory number (station or feature)
NAME_EXTENSION   0x0080 Special exchange mode using two line names: Send the second line through AlphaNet
SNV SNV 0x0095 Update specific system settings (NVRAM) values
SYNC_FLASH   0x00A5 Dump local database to flash file system
STATUS_REPORT   0x0072 Report equipment Presence and Error/OK status
GROUP_MSG GM 0x00A6 Start SVP message playback to group
GROUP_MSG_STOP GMS 0x00A7 Stop SVP message playback to group
COMMAND_RESPONSE   0x0066 General response message to messages
ILLEGAL_PARAM   0x0023 Negative response
DPMT_INVALID   0x0000 Reserved value for internal use
CAC   0x00A9 Cancel All Conversations
DUMMY   0xFFFE Test message: Should be routed, accepted and ignored
SMALL_RESET   0x00BC Simulates Small Reset sent from ICX-AlphaCom web interface
CHILLY_RESET   0x0039 Simulates Chilly Reset sent from ICX-AlphaCom web interface



Device Control and Status

A device shall not respond to any message before it’s operative except RESET_DEVICE and GET_DEVICE.

Message Short name Message no, Hex Description
RESET_TAKEN RSTT 0x0038 A device reports that it has done an internal reset
RESET_DEVICE RESET 0x0039 Reset a device
GET_DEVICE GDEV 0x003A Get information from an external device
DEVICE_INFO   0x003B Response to the GET_DEVICE message
PING   0x003C Test device: “Are you there?”
PONG   0x003D Response to the PING message. “Yes, I’m here.”



Remote Control

Message Short name Message no, Hex Description
SET_LOGICAL_RCO SLRC 0x006B Set or clear a logical RCO
RCO_CHANGED RCOC 0x0085 New RCO state reported from the exchange
RCI_CHANGED RCIC 0x0084 New RCI state reported from the exchange
SET_IPRCO   0x00AD Set a physical RCO on IP station or IP-ARIO




RIO Protocol

There are a number of messages for RIO control. The message sequences, timing and error procedures are described in a separate document. Note that all inputs or outputs “owned” by the exchange can NOT be controlled in parallel by an external computer. Responses are always returned to the device that controls a pin.


Message Short name Message no, Hex Description
GET_PIN_COUNTS GPC 0x0013 Query a RIO about number of output and input pins and support for non mandatory features
PIN_COUNTS   0x0014 Response to the GET_PIN_COUNTS message
SET_RCO SET 0x0018 Turn the given remote control output on
SET_RCO_OK   0x0019 Positive response to the SET_RCO message
SET_RCO_FAILED   0x001A Negative response to the SET_RCO message
CLEAR_RCO CLR 0x0015 Turn the given remote control output off
CLEAR_RCO_OK   0x0016 Positive response to the CLEAR_RCO message
CLEAR_RCO_FAILED   0x0017 Negative response to the CLEAR_RCO message
PULSE_RCO PULS 0x001B Generate a pulse with the defined length
PULSE_RCO_OK   0x001C Positive response to the PULSE_RCO message
PULSE_RCO_FAILED   0x0022 Negative response to the PULSE_RCO message
POLL_RCI POLL 0x001D Poll the given remote control input once
SCAN_RCI_ONCE SCAN 0x0020 Scan input until defined condition is met, then report to exchange
SCAN_RCI_ACK   0x0021 Positive response to the SCAN_RCI_ONCE message
RCI_IS_ON   0x001F Response to the POLL_RCI and SCAN_RCI_ONCE messages, input pin is on
RCI_IS_OFF   0x001E Response to the POLL_RCI and SCAN_RCI_ONCE messages, input pin is off
SCAN_END_ACK   0x0024 Acknowledgment to the RCI_IS_OFF and RCI_IS_ON messages



AlphaNet

This is messages related to audio control between exchanges.
AlphaNet also uses other messages like station emulation, mails, and system maintenance.


Message Short name Message no, Hex Description
AUDIO_PATH_SETUP   0x8001 Set up audio path between a source node and a destination node (possibly via transit nodes)
AUDIO_CODEC   0x801D Message sent in the direction of start node, from end node or trans-coding nodes along the path
AUDIO_PATH_OK   0x8002 End to end message: Audio path is ready
AUDIO_LINK_OK   0x8003 Response to AUDIO_PATH_SETUP. Channel number is OK
AUDIO_PATH_STATE   0x801E SIP Response to AUDIO_PATH_SETUP
STATION_INFO   0x801F SIP update of number and display text
EC_STATE   0x0093 Update remote node of the Echo Canceler state of station.
AUDIO_LINK_NOT_AVAILABLE   0x8004 Response to AUDIO_PATH_SETUP from next node: Channel not granted
AUDIO_PATH_DISCONNECT   0x8006 Release the end­to­end audio path. Normal disconnect from source or destination
AUDIO_LINK_RELEASE   0x8005 Used to release audio path backwards stepwise from node to node when setup meets busy or faulty link
STATION_LISTEN   0x0061 Message from remote exchange. Set station in listen mode. Shut mic
STATION_CONVERSATION   0x0060 Message from remote exchange. Set station in conversation mode. Stop tone and open mic.
STATION_TRANSFER   0x0062 Message from remote exchange: Transfer of B subscriber.
CHECK_AUDIO_PATH   0x800E Check of established audio path at regular intervals
AUDIO_PATH_CHECK_OK   0x800F Positive response to CHECK_AUDIO_PATH
AUDIO_CH_LOOPBACK_REQ   0x8010 Request for loopback audio connection. Used by the Audio Channel Testing process
AUDIO_CH_LOOPBACK_ACK   0x8011 Positive acknowledge of AUDIO_CH_LOOPBACK_REQ
AUDIO_CH_FAULTY   0x8013 Response to AUDIO_CH_LOOPBACK_REQ: Requested channel was faulty
LOOPBACK_IMPOSSIBLE   0x8014 Response to AUDIO_CH_LOOPBACK_REQ
AUDIO_CH_DISCON   0x8012 Disconnect a audio channel after loopback test
AUDIO_CH_TONE_REQ   0x8015 Request a peer exchange to put a 500Hz tone on a audio channel
AUDIO_M_PATH_SETUP   0x8016 Communication in a multi-node network
AUDIO_M_PATH_OK   0x8017 Contains statuses for an AUDIO_M_PATH_SETUP from one or more destination exchanges
AUDIO_M_LINK_OK   0x8019 Per­ hop positive response to AUDIO_M_PATH_SETUP
AUDIO_M_PATH_BACKTRACK   0x8018 AUDIO_M_PATH_SETUP failed
VCP_MEET_REQ   0x0069 Request answer to global group call
BUILD_GLOB_GRP   0x0070 Broadcast message to all exchanges to make them rebuild global group indexes
GLOB_GRP_MEMB   0x006A A exchange tells which global groups this exchange is member of by broadcasting this to all exchanges
RESET_AUDIO_LINK   0x8000 Reset audio link between nodes. Message not used in current AlphaCom version
CONF_JOIN   0x0078 Exchange wants to join conference, asks root-exchange to setup connection back to sender
CONF_MEMB_CHK   0x0079 Ask whether any neighbor exchange has any ordinary member left in conference
CONF_ORD_MEMB   0x007A An exchange tells its neighbors that it has ordinary member left in conference
CONF_IS_ROOT   0x007B Broadcast message. Sender informs that it is root of conference
CONF_NOT_ROOT   0x007C Broadcast message. Sender informs that it is no longer root of conference
AUDIO_M_FEED_REQ   0x801A Global Simplex Conference: Some station is pressing the M-key when participating in a conference
AUDIO_M_FEED_STOP   0x801B Global Simplex Conference: The station is releasing the M-key
AUDIO_PATH_DELAY   0x8007 Set Duplex switch delay
AUDIO_RTP_DTMF_DIGIT   0x8021 Rfc4733 RTP digit event send or receive
AUDIO_RTP_DTMF_SETUP   0x8020 Set up reception of rfc4733 digit events in RTP.



System Maintenance

Message Short name Message no, Hex Description
SET_NODE_NUMBER   0x006D Change the node number of an exchange
ROUTE_ALPHAPRO_MSG   0x006E Send AlphaPro message via AlphaNet to/from a remote node
CONSOLE_REQ   0x007E Log on to system debug console (TST)
CONSOLE_DISC   0x007F Log off from system debug console (TST)
CFG_UPD   0x00A1 Signal update of configuration tables.


Billing

Message Short name Message no, Hex Description
CDC_STATE   0x009E Used for Billing AMCD->ABSD
CDC_CMD   0x009F Used for Billing ABSD->AMCD

Common notes

  • Over time, more parameters will be added to existing messages. These parameters are often marked “(optional)”, and the AMC version which introduced them is shown to the right in the explanation of each parameter.
- Note that it’s the exchange that processes the DP message that adds default values when it creates an internal representation of the message. If you send a “short” message to a remote node in AlphaNet, all default fields will be filled in in that exchange. Example: SEND_MAIL without A station name will get the name from the same dir.no in the remote exchange (if existing). See comment under Simple Link Layer.
  • In general, NULL is not allowed as NET_OBJ_REF parameter.
It’s described explicitly when it can be used, e.g. to switch call forwarding OFF. Hint: Some DP messages works correctly only if you leave the NET_OBJ_REF parameter out, rather than supplying an explicit NULL field.
  • Note that all messages may cause the response message ILLEGAL_PARAM, indicating that the exchange has problems recognizing either the message number, or a parameter value of a message. In these cases the documented response message will NOT be returned.
- ILLEGAL_PARAM refers to the problem parameter using a number from 1 and up. This is the number you will find in to the left of each parameter in the table.
- In AlphaNet, if you get an ILLEGAL_PARAM from a remote node indicating that an optional parameter is required, remember that the AMC versions indicated for optional parameters refers to the receiving node, not the local node generating the message.
  • Some messages may seem to have too few parameters. Keep in mind that:
- the network layer header contains node and device address for both a source and a destination
- the reference field is always identical in a “command” and the returned “response”.
  • AlphaNet: To control a station in a network you must address the DP message to that station’s node. Messages are in general ONLY routed according to the network layer header. If you send a message to an exchange, and use a node number as part of the (A) Subscriber field which is different from the addressed node, the command will be ignored or cause an error response. The messages which deviates from this rule is documented explicitly!