Changes between Version 5 and Version 6 of OFDM/MIMO/Docs/AutoResponse

Timestamp:

Aug 28, 2009, 4:15:54 PM (15 years ago)

Author:

murphpo

Comment:

--

OFDM/MIMO/Docs/AutoResponse

@@ -14 +14 @@
 The header translator is used to construct the header of an automatically transmitted packet using data from the header of the received packet which triggered the transmission.
 
-== Sample Code ==
+== Configuring the Auto Response System ==
 C macros are provided in [src:/PlatformSupport/warpmac/warpphy.h warphphy.h] to help configure the match units, actors and header translator.
+
+Match unit configuration:
+ * PHY_AUTORESPONSE_MATCH_CONFIG(''addr'', ''len'', ''val''): Configure the match unit to check whether ''len'' header bytes starting at ''addr'' match value ''val''
 
 Actor condition requirements:
@@ -39 +42 @@
  * PHY_AUTORESPONSE_TXACTION_CONFIG(''pktBuf'', ''translateHdr'', ''delay'', ''conditions''): Configure the actor to automatically transmit
    * ''pktBuf'': index (in ![1,31]) of the packet buffer from which to automatically transmit the packet
-   * ''translateHdr'': enable the header translator when this actor triggers a transmission ('''1''': use the translator; '''0''': disable the translator)
+   * ''translateHdr'': enable the header translator when this actor triggers a transmission ('''PHY_AUTORESPONSE_ACT_TRANS_HDR''': use the translator; '''0''': disable the translator)
    * ''delay'': number of 0.25µs increments to delay the automatic transmission. The time starts when the final byte of the incoming packet is decoded, even if the actor doesn't depend on the payload error status
    * ''conditions'': bitwise OR'd combination of actor condition flags; every condition must be met by a given reception to trigger the actor.
  * PHY_AUTORESPONSE_ACTION_SETFLAGA_CONFIG(''conditions''): Configure the actor to set Flag A; ''conditions'' is a bitwise OR'd combination of actor condition requirements
  * PHY_AUTORESPONSE_ACTION_SETFLAGB_CONFIG(''conditions''): Configure the actor to set Flag B; ''conditions'' is a bitwise OR'd combination of actor condition requirements
+
+== Sample Code ==
+
+{{{
+#!C
+
+//Configure match unit 0 to search for packets addressed to me
+// Looks for 2 bytes starting at index PKTHEADER_INDX_DSTADDR with value MY_ADDR
+mimo_ofdmTxRx_setMatch0( PHY_AUTORESPONSE_MATCH_CONFIG(PKTHEADER_INDX_DSTADDR, 2, MY_ADDR) );
+
+//Configure match unit 1 to search for DATA packets
+// Looks for 1 byte starting at index PKTHEADER_INDX_TYPE with value DATAPACKET
+mimo_ofdmTxRx_setMatch1( PHY_AUTORESPONSE_MATCH_CONFIG(PKTHEADER_INDX_TYPE, 1, DATAPACKET) );
+
+//Configure the header translator to replace the outgoing destination address with the received source address
+PHY_HEADERTRANSLATE_SET(pktBuf_tx_ACK, (PKTHEADER_INDX_DSTADDR+0), pktBuf_rx, (PKTHEADER_INDX_SRCADDR+0));
+PHY_HEADERTRANSLATE_SET(pktBuf_tx_ACK, (PKTHEADER_INDX_DSTADDR+1), pktBuf_rx, (PKTHEADER_INDX_SRCADDR+1));
+
+//Create a template ACK packet
+templatePkt.header.fullRate = pktFullRate;
+templatePkt.header.codeRate = pktCodeRate;
+templatePkt.header.length = 0;
+templatePkt.header.srcAddr = (unsigned short)(NODEID_TO_ADDR(myID));
+templatePkt.header.pktType = ACKPACKET;
+
+//Copy the template ACK to the PHY packet buffer
+warpmac_prepPhyForXmit(&templatePkt, pktBuf_tx_ACK);
+
+//Configure actor 0 to send ACKs using the header translator after 5µs when the PHY receives a good data packet destined to this node
+mimo_ofdmTxRx_setAction0(
+        PHY_AUTORESPONSE_TXACTION_CONFIG(pktBuf_tx_ACK, PHY_AUTORESPONSE_ACT_TRANS_HDR, 20, 
+                (PHY_AUTORESPONSE_REQ_MATCH0 | PHY_AUTORESPONSE_REQ_MATCH1 | PHY_AUTORESPONSE_REQ_GOODHDR | PHY_AUTORESPONSE_REQ_GOODPKT)));
+
+//Disable the unused actors
+mimo_ofdmTxRx_setAction1(0);
+mimo_ofdmTxRx_setAction2(0);
+mimo_ofdmTxRx_setAction3(0);
+mimo_ofdmTxRx_setAction4(0);
+mimo_ofdmTxRx_setAction5(0);
+
+
+
+}}}