Serial Acknowledgement

The Host may enable the option to enforce acknowledgement of every serial message transacted with the Module, specifically by issuing the Serial ACK Config Write command to 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.

If Serial Acks are not enabled, care should be taken during the Startup Configuration sequence that module/host are given time to process the payload before sending the next frame in the sequence.

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.

There are two possible Serial Acknowledgement types:

  • 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 Status Response is returned with success or error information, with a matching Frame Sequence Number as the frame that is being acknowledged.

When the Serial Acknowledgement option is enabled, a general Status Response with a status of Success will be returned from the Module, OR an assigned response whose Frame Sequence Number matches that of the originating request.

The Host should acknowledge every frame coming from the Module that is not an acknowledgement frame. The acknowledgement frame that the Host should send out is a Status Response frame with a payload of 0x00 (Success), and a Frame Sequence Number that matches the Sequence Number of the frame 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.

Exceptions

The Module will not respond to the following frames with any acknowledgement, even if the Serial Acknowledgement feature is enabled:

  • Status Response
  • Module Info Request
  • Host Startup Ready (will respond with another Startup Sync Request)
  • Reset
  • Restore to Factory Default
  • Latency Request
  • OTA Image Notification
  • OTA Query Next Image Response
  • OTA Image Block Response
  • OTA Upgrade End Response
  • Attribute Report Passthrough Control

Summary

  • The Host should ACK every frame from the Module that is not an ACK frame.
  • 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.

Legal Notices

Copyright © 2020 MMB Networks, Inc. All rights reserved.
Confidential materials prepared and delivered by MMB Networks for receipt and review only by any partner subject to a valid and enforceable MMB Networks confidentiality agreement. Any receipt, review, or misuse of any of the content exchanged hereunder by any party not a party to this confidential exchange shall be subject to any and all rights available under the law. All rights, title and interest to the materials shall remain with MMB Networks.
Any suggestions provided to MMB Networks with respect to MMB Networks' products or services shall be collectively deemed “Feedback.” You, on behalf of yourself, or if you are providing Feedback on behalf of your employer or another entity, represent and warrant that you have full legal authority to bind such entity to these terms, agree to grant and hereby grant to MMB Networks a nonexclusive, perpetual, irrevocable, royalty free, worldwide license to use and otherwise exploit such Feedback within any MMB Networks products and services.