update some wifi config instructions

Author: soundanalogous

examples/StandardFirmataWiFi/StandardFirmataWiFi.ino

@@ -22,14 +22,14 @@
 
   See file LICENSE.txt for further informations on licensing terms.
 
-  Last updated by Jeff Hoefs: April 10th, 2016
+  Last updated by Jeff Hoefs: April 17th, 2016
 */
 
 /*
   README
 
-  StandardFirmataWiFi is a WiFi server application. You will need a Firmata client library with
-  a network transport in order to establish a connection with StandardFirmataWiFi.
+  StandardFirmataWiFi enables the use of Firmata over a TCP connection. It can be configured as
+  either a TCP server or TCP client.
 
   To use StandardFirmataWiFi you will need to have one of the following
   boards or shields:
@@ -49,10 +49,10 @@
   - ESP8266 requires the Arduino ESP8266 core which can be obtained here:
     https://github.com/esp8266/Arduino
 
-  In order to use the WiFi Shield 101 with Firmata you will need a board with at least
-  35k of Flash memory. This means you cannot use the WiFi Shield 101 with an Arduino Uno
-  or any other ATmega328p-based microcontroller or with an Arduino Leonardo or other
-  ATmega32u4-based microcontroller. Some boards that will work are:
+  In order to use the WiFi Shield 101 with Firmata you will need a board with at least 35k of Flash
+  memory. This means you cannot use the WiFi Shield 101 with an Arduino Uno or any other
+  ATmega328p-based microcontroller or with an Arduino Leonardo or other ATmega32u4-based
+  microcontroller. Some boards that will work are:
 
   - Arduino Zero
   - Arduino Due
@@ -87,8 +87,7 @@
 
 /*
  * Uncomment the following include to enable interfacing with Serial devices via hardware or
- * software serial. Note that if enabled, this sketch will likely consume too much memory to run on
- * an Arduino Uno or Leonardo or other ATmega328p-based or ATmega32u4-based boards.
+ * software serial.
  */
 //#include "utility/SerialFirmata.h"
 
@@ -921,10 +920,10 @@ void setup()
     DEBUG_PRINT(".");
     streamConnected = stream.maintain();
   }
-  if (streamConnected) {  
+  if (streamConnected) {
     DEBUG_PRINTLN( "TCP connection established" );
   } else {
-    DEBUG_PRINTLN( "failed to establish TCP connection" );    
+    DEBUG_PRINTLN( "failed to establish TCP connection" );
   }
   printWifiStatus();
 

examples/StandardFirmataWiFi/wifiConfig.h

@@ -3,13 +3,13 @@
  *
  * You must configure your particular hardware. Follow the steps below.
  *
- * Currently StandardFirmataWiFi is configured as a Wi-Fi server. An option to
- * configure as a Wi-Fi client will be added in the future.
+ * By default, StandardFirmataWiFi is configured as a TCP server, to configure
+ * as a TCP client, see STEP 2.
  *============================================================================*/
 
 // STEP 1 [REQUIRED]
 // Uncomment / comment the appropriate set of includes for your hardware (OPTION A, B or C)
-// Option A is enabled by default.
+// Arduino MKR1000 or ESP8266 are enabled by default if compiling for either of those boards.
 
 /*
  * OPTION A: Configure for Arduino MKR1000 or Arduino WiFi Shield 101
@@ -75,8 +75,8 @@
  * The appropriate libraries are included automatically when compiling for the ESP8266 so
  * continue on to STEP 2.
  *
- * IMPORTANT: You must have the esp8266 board support installed. To easily install this board, open
- * see the instructions here: https://github.com/esp8266/Arduino#installing-with-boards-manager.
+ * IMPORTANT: You must have the esp8266 board support installed. To easily install this board see
+ * the instructions here: https://github.com/esp8266/Arduino#installing-with-boards-manager.
  */
 //do not modify the following 14 lines
 #ifdef ESP8266
@@ -108,12 +108,18 @@
 //#define HUZZAH_WIFI
 
 
-// STEP 2 [REQUIRED for all boards and shields]
+// STEP 2 [OPTIONAL for all boards and shields]
+// If you want to setup you board as a TCP client, uncomment the following define and replace
+// the IP address with the IP address of your server.
+//#define SERVER_IP 10, 0, 0, 15
+
+
+// STEP 3 [REQUIRED for all boards and shields]
 // replace this with your wireless network SSID
 char ssid[] = "your_network_name";
 
 
-// STEP 3 [OPTIONAL for all boards and shields]
+// STEP 4 [OPTIONAL for all boards and shields]
 // If you want to use a static IP (v4) address, uncomment the line below. You can also change the IP.
 // If the first line is commented out, the WiFi shield will attempt to get an IP from the DHCP server.
 // If you are using a static IP with the ESP8266 then you must also uncomment the SUBNET and GATEWAY.
@@ -122,11 +128,6 @@ char ssid[] = "your_network_name";
 //#define GATEWAY_IP_ADDRESS 0,0,0,0       // REQUIRED for ESP8266_WIFI, optional for others
 
 
-// STEP 4 [OPTIONAL for all boards and shields]
-// uncomment and replace with the IP address of your server if the Arduino is the TCP client
-//#define SERVER_IP 10, 0, 0, 15
-
-
 // STEP 5 [REQUIRED for all boards and shields]
 // define your port number here, you will need this to open a TCP connection to your Arduino
 #define SERVER_PORT 3030
@@ -214,7 +215,7 @@ char wep_key[] = "your_wep_key";
 #else
   WiFiServerStream stream(SERVER_PORT);
 #endif
- 
+
 /*==============================================================================
  * PIN IGNORE MACROS (don't change anything here)
  *============================================================================*/