X-Git-Url: https://oss.titaniummirror.com/gitweb/?a=blobdiff_plain;f=tos%2Flib%2Fmac%2Ftkn154%2Finterfaces%2FMLME%2FMLME_ASSOCIATE.nc;h=7e1c095a7bcecc9e824ea552869078ebe7ae17ad;hb=e9bfab607e051bae6afb47b44892ce37541d1b44;hp=ce135fda5569249630a6fa7308186cce3e5fdc0f;hpb=adf1de6c009d13b7b52e68535c63b28f59c97400;p=tinyos-2.x.git

diff --git a/tos/lib/mac/tkn154/interfaces/MLME/MLME_ASSOCIATE.nc b/tos/lib/mac/tkn154/interfaces/MLME/MLME_ASSOCIATE.nc
index ce135fda..7e1c095a 100644
--- a/tos/lib/mac/tkn154/interfaces/MLME/MLME_ASSOCIATE.nc
+++ b/tos/lib/mac/tkn154/interfaces/MLME/MLME_ASSOCIATE.nc
@@ -33,6 +33,11 @@
  * ========================================================================
  */
 
+/** 
+ * MLME-SAP association primitives define how a device becomes
+ * associated with a PAN. (IEEE 802.15.4-2006, Sect. 7.1.3)
+ */
+
 #include "TKN154.h"
 
 interface MLME_ASSOCIATE {
@@ -51,6 +56,7 @@ interface MLME_ASSOCIATE {
    *                        of the associating device
    * @param security        The security options (NULL means security is 
    *                        disabled)
+   *
    * @return       IEEE154_SUCCESS if the request succeeded and a confirm event
    *               will be signalled, an appropriate error code otherwise 
    *               (no confirm event will be signalled in this case)
@@ -67,7 +73,7 @@ interface MLME_ASSOCIATE {
                         );
 
   /**
-   * Notification that a device has requested to associate with a PAN.
+   * Notification that a device has requested to associate with this PAN.
    *
    * @param DeviceAddress the 64-bit address of the requesting device
    * @param CapabilityInformation Specifies the operational capabilities
@@ -82,7 +88,7 @@ interface MLME_ASSOCIATE {
                         );
 
   /**
-   * Send a response to a device's request to associate
+   * Sends a response to a device that requested to associate with this PAN.
    *
    * @param DeviceAddress     The 64-bit address of the device to respond to
    * @param AssocShortAddress The short device address allocated by the
@@ -90,9 +96,10 @@ interface MLME_ASSOCIATE {
    * @param status          The status of the association attempt
    * @param security        The security options (NULL means security is 
    *                        disabled)
+   *
    * @return IEEE154_SUCCESS if the request succeeded and an indication event
    *         will be signalled through the MLME_COMM_STATUS interface later,  
-   *         otherwise an appropriate error code (no MLME_COMM_STATUS.indication
+   *         an appropriate error code otherwise (no MLME_COMM_STATUS.indication
    *         event will be signalled in this case)
    */
   command ieee154_status_t response (
@@ -103,7 +110,7 @@ interface MLME_ASSOCIATE {
                         );
 
   /**
-   * Confirmation of the association attempt.
+   * Confirms an association attempt.
    *
    * @param AssocShortAddress The short device address allocated by the
    *                          coordinator on successful association