Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Host may enable the option to enforce acknowledgement of every(exceptions below) serial message transacted with the Module, specifically by issuing the /wiki/spaces/RHA/pages/2621455 command to the Module. With the Serial Acknowledgement feature enabled the Host will queue up outgoing messages, messages will be sent one-by-one and only after the previous request is responded to by a frame with a matching Frame Sequence Number or explicitly asked by the Module. 

The serial acknowledgment option is disabled by default. If this option is disabled when the Host sends a command, a Status Response will only be issued upon an error; i.e., a Status Response of “Success” will not be issued by the Module upon successful completion of the command. This model has been designed to minimize serial traffic but it is important to note that the Host can overload the Module with requests if not limited.

In terms of complexity, request limiting rather than Serial Ack options is a simpler model to implement for Host developers.

Usage

If the option is enabled, both the Host and Module must acknowledge the receipt of every serial message by returning an appropriate frame with a matching Frame Sequence Number.

...

  • A specific response is returned, e.g., a Read Response to a Read Request, with a matching Frame Sequence Number as the request.
  • A general /wiki/spaces/RHA/pages/2621455Status Response is returned with success or error information, with a matching Frame Sequence Number as the frame that is being acknowledged.

...

Figure 1 illustrates a serial transaction with serial acknowledgement enabled by the Host.

Figure 2

Figure 1

 

...



The drawing in Figure 2 illustrates the same serial transaction but with serial acknowledgment disabled; note that these transactions omits any Status Response conveying Success. 


Figure 3

Figure 2

 


The Module queues all outgoing serial messages to the Host. If the Host has enabled the Serial Acknowledgment option, the Module will retransmit any message up to (3) times until that message is acknowledged. The acknowledgement must be of the Status Response type, with a Frame Sequence Number that matches the frame being acknowledged.

...

  • The Host should ACK every frame from the Module that is not an ACK frame or One of the Exception above.
  • After the Host sends a frame to the Module, it should wait for an ACK or Response from the Module before proceeding with sending another frame.
    • If the Host does not receive an ACK or Response from the Module within expected timeout periods (i.e. up to 15 seconds for a ZCL command that goes out over the network), it should retry.

...