Diff: EthernetInterface.h

Revision:

4:9a52c802be61

Parent:

3:f5776537f27f

Child:

14:cec293071eed

--- a/EthernetInterface.h	Tue Jun 26 14:30:34 2012 +0000
+++ b/EthernetInterface.h	Tue Jun 26 14:53:52 2012 +0000
@@ -28,19 +28,44 @@
 
 #include "lwip/netif.h"
 
-/** Interface using Ethernet to connect to an IP-based network
+ /** Interface using Ethernet to connect to an IP-based network
  *
  */
 class EthernetInterface : public LwIPInterface
 {
 public:
+  /** Instantiate the Ethernet interface.
+  * 
+  */
   EthernetInterface();
 
+  /** Initialize the interface with DHCP.
+  * Initialize the interface and configure it to use DHCP (no connection at this point).
+  * \return 0 on success, a negative number on failure
+  */
   int init(); //With DHCP
 
+  /** Initialize the interface with a static IP address.
+  * Initialize the interface and configure it with the following static configuration (no connection at this point).
+  * \param ip the IP address to use
+  * \param mask the IP address mask
+  * \param gateway the gateway to use
+  * \param dns1 the primary DNS server
+  * \param dns2 the secondary DNS server
+  * \return 0 on success, a negative number on failure
+  */
   int init(const char* ip, const char* mask, const char* gateway, const char* dns1, const char* dns2); //No DHCP
 
+  /** Connect
+  * Bring the interface up, start DHCP if needed.
+  * \return 0 on success, a negative number on failure
+  */
   virtual int connect();
+  
+  /** Disconnect
+  * Bring the interface down
+  * \return 0 on success, a negative number on failure
+  */
   virtual int disconnect();
 
 private: