ethernet lib: fix examples

Author: leonardocavagnis

libraries/Ethernet/examples/AdvancedChatServer/AdvancedChatServer.ino

@@ -5,6 +5,28 @@
  to all connected clients but the client the message comes from.
  To use, telnet to your device's IP address and type.
 
+  Usage:
+  1. Upload this sketch to your board.
+  2. Make sure your board is connected to the network and note its IP address.
+  3. From a computer on the same network, open a terminal and connect via Telnet:
+
+  - On macOS or Linux (using netcat if telnet is not available):
+      telnet <board_ip> 23
+      # or, if telnet is missing:
+      nc <board_ip> 23
+
+  - On Windows (Command Prompt):
+      telnet <board_ip> 23
+      # If 'telnet' is not recognized, enable it in "Windows Features".
+
+  4. Type a message and press Enter.
+  Your message will be broadcast to all connected clients except you.
+
+  Example:
+  telnet 192.168.1.177 23
+
+  Press CTRL + ] then 'quit' to exit Telnet.
+
  */
 
 #include "ZephyrServer.h"
@@ -18,23 +40,29 @@ IPAddress myDns(192, 168, 1, 1);
 IPAddress gateway(192, 168, 1, 1);
 IPAddress subnet(255, 255, 255, 0);
 
-
 // telnet defaults to port 23
 ZephyrServer server(23);
 
 ZephyrClient clients[8];
 
 void setup() {
-
-  // initialize the Ethernet device
-  Ethernet.begin(ip, myDns, gateway, subnet);
-
-  // Open serial communications and wait for port to open:
+  // start serial port:
   Serial.begin(9600);
   while (!Serial) {
     ; // wait for serial port to connect. Needed for native USB port only
   }
 
+  // in Zephyr system check if Ethernet is ready before proceeding to initialize
+  Serial.print("Waiting for link on");
+  while (Ethernet.linkStatus() != LinkON) {
+      Serial.print(".");
+      delay(100);
+  }
+  Serial.println();
+
+  // initialize the Ethernet device
+  Ethernet.begin(ip, myDns, gateway, subnet);
+
   // Check for Ethernet hardware present
   if (Ethernet.hardwareStatus() == EthernetNoHardware) {
     Serial.println("Ethernet shield was not found.  Sorry, can't run without hardware. :(");

libraries/Ethernet/examples/BarometricPressureWebServer/BarometricPressureWebServer.ino

@@ -8,17 +8,22 @@
  This sketch adapted from Nathan Seidle's SCP1000 example for PIC:
  http://www.sparkfun.com/datasheets/Sensors/SCP1000-Testing.zip
 
- TODO: this hardware is long obsolete.  This example program should
- be rewritten to use https://www.sparkfun.com/products/9721
-
  Circuit:
  SCP1000 sensor attached to pins 6,7, and 11 - 13:
  DRDY: pin 6
  CSB: pin 7
  MOSI: pin 11
  MISO: pin 12
  SCK: pin 13
- 
+
+ How it works:
+  1. The board reads temperature and pressure data from the SCP1000 sensor.
+  2. It hosts a simple HTTP server on port 80 that serves the current readings as a web page.
+  3. You can view the readings from any device on the same network via a browser.
+     Open a web browser and go to: http://192.168.1.20/ (Replace with your board's IP address if changed)
+
+ Note: The SCP1000 sensor is long obsolete. For modern projects, consider replacing it
+ with the BMP085/BMP180/BMP280 or similar (e.g. https://www.sparkfun.com/products/9721).
  */
 
 #include "ZephyrServer.h"
@@ -53,15 +58,23 @@ void setup() {
   // start the SPI library:
   SPI.begin();
 
-  // start the Ethernet connection
-  Ethernet.begin(ip);
-
-  // Open serial communications and wait for port to open:
+  // start serial port:
   Serial.begin(9600);
   while (!Serial) {
     ; // wait for serial port to connect. Needed for native USB port only
   }
 
+  // in Zephyr system check if Ethernet is ready before proceeding to initialize
+  Serial.print("Waiting for link on");
+  while (Ethernet.linkStatus() != LinkON) {
+      Serial.print(".");
+      delay(100);
+  }
+  Serial.println();
+
+  // start the Ethernet connection
+  Ethernet.begin(ip);
+
   // Check for Ethernet hardware present
   if (Ethernet.hardwareStatus() == EthernetNoHardware) {
     Serial.println("Ethernet shield was not found.  Sorry, can't run without hardware. :(");

libraries/Ethernet/examples/DhcpAddressPrinter/DhcpAddressPrinter.ino

@@ -11,8 +11,7 @@
 
 void setup()
 {
-
-    // Open serial communications and wait for port to open:
+    // start serial port:
     Serial.begin(9600);
     while (!Serial) {
         ; // wait for serial port to connect. Needed for native USB port only

libraries/Ethernet/examples/TelnetClient/TelnetClient.ino

@@ -1,23 +1,25 @@
-/*
+ /*
   Telnet client
 
- This sketch connects to a a telnet server (http://www.google.com)
- using an Arduino Wiznet Ethernet shield.  You'll need a telnet server
- to test this with.
- Processing's ChatServer example (part of the network library) works well,
- running on port 10002. It can be found as part of the examples
- in the Processing application, available at
- http://processing.org/
- */
+  This sketch connects to a telnet server.
+  You need a telnet server to test this.
+*/
 
 #include "ZephyrClient.h"
 #include "ZephyrEthernet.h"
 
 // The IP address will be dependent on your local network:
 IPAddress ip(192, 168, 1, 177);
 
+// Example: To get the IP address of telehack.com (an example telnet server), run in a terminal:
+// ping telehack.com
+// or
+// nslookup telehack.com
+// Then use the returned IP address in the code.
+
 // Enter the IP address of the server you're connecting to:
 IPAddress server(1, 1, 1, 1);
+int port = 23; // Telnet port
 
 // Initialize the Ethernet client library
 // with the IP address and port of the server
@@ -52,7 +54,7 @@ void setup() {
   Serial.println("connecting...");
 
   // if you get a connection, report back via serial:
-  if (client.connect(server, 10002)) {
+  if (client.connect(server, port)) {
     Serial.println("connected");
   } else {
     // if you didn't get a connection to the server:

libraries/Ethernet/examples/UdpNtpClient/UdpNtpClient.ino

@@ -24,7 +24,6 @@ byte packetBuffer[NTP_PACKET_SIZE]; //buffer to hold incoming and outgoing packe
 ZephyrUDP Udp;
 
 void setup() {
-
   // Open serial communications and wait for port to open:
   Serial.begin(9600);
   while (!Serial) {

libraries/Ethernet/examples/WebClient/WebClient.ino

@@ -32,7 +32,6 @@ bool printWebData = true; // set to false for better speed measurement
 
 void setup()
 {
-
     // Open serial communications and wait for port to open:
     Serial.begin(9600);
     while (!Serial) {

libraries/Ethernet/examples/WebClientRepeatingManual/WebClientRepeatingManual.ino

@@ -18,7 +18,7 @@
 IPAddress ip(192, 168, 1, 177);
 IPAddress myDns(192, 168, 1, 1);
 IPAddress gateway(192, 168, 1, 1);
-IPAddress subnet(255, 255, 0, 0);
+IPAddress subnet(255, 255, 255, 0);
 
 // initialize the library instance:
 ZephyrClient client;

libraries/Ethernet/examples/WebServer/WebServer.ino

@@ -1,17 +1,16 @@
 /*
   Web Server
 
- A simple web server that shows the value of the analog input pins.
- using an Arduino Wiznet Ethernet shield.
- 
+  A simple web server that shows the value of the analog input pins.
+  To view the page, open a web browser and type the server’s IP address in the address bar.
  */
 
 #include "ZephyrServer.h"
 #include "ZephyrClient.h"
 #include "ZephyrEthernet.h"
 
 // The IP address will be dependent on your local network:
-IPAddress ip(192, 168, 2, 177);
+IPAddress ip(192, 168, 1, 177);
 
 // Initialize the Ethernet server library
 // with the IP address and port you want to use