Update documentation system

Author: christoph2

docs/conf.py

@@ -24,7 +24,7 @@
 # -- Project information -----------------------------------------------------
 
 project = 'BlueParrot XCP'
-copyright = '2019, Christoph Schueler'
+copyright = '2019-2025, Christoph Schueler'
 author = 'Christoph Schueler'
 
 # The short X.Y version
@@ -65,7 +65,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

docs/tutorial.rst

@@ -2,10 +2,10 @@ Tutorial
 ========
 
 This tutorial gives you a practical, step-by-step path to get a BlueParrot XCP slave running on
-- Arduino boards (Ethernet/WiFi or CAN shields, and optional serial SXI)
+- Arduino boards (serial SXI, Ethernet/WiFi or CAN shields)
 - Raspberry Pi Pico (RP2040)
 
-It focuses on minimal configuration in your `xcp_config.h`, building/flashing, and connecting from an XCP master.
+It focuses on minimal configuration in your `xcp_config.h`, building/flashing, and connecting from an XCP client.
 For a full description of all configuration options, see :doc:`options`.
 
 Quick overview
@@ -25,8 +25,9 @@ Prerequisites
 ^^^^^^^^^^^^^
 - Arduino IDE or Arduino CLI installed
 - For Ethernet: an Ethernet-capable board/shield (e.g., W5100/W5500) or WiFi board (ESP32)
-- For CAN: a CAN shield (e.g., Seeed Studio CAN v2 or CAN FD shield)
-- Optional serial SXI over the board’s UART
+- For CAN: a CAN shield (MKR Zero CAN Shield, Seeed Studio CAN Shield, and SparkFun CAN Shield are currently supported).
+- Serial SXI over the board’s UART (recommended starting point).
+
 
 1) Choose a transport
 ^^^^^^^^^^^^^^^^^^^^^

tools/arduino/hello_xcp/xcp_config.h

@@ -35,8 +35,8 @@
 **  General Options.
 */
     // #define TP_CAN
-    #define TP_ETHER
-    // #define TP_SXI
+    // #define TP_ETHER
+    #define TP_SXI
 
     /*
     **  Transport-Layer specific Options.
@@ -78,9 +78,9 @@
         #define XCP_ON_ETHERNET_IP_OCTETS 192, 168, 137, 100
         #define XCP_ON_ETHERNET_PORT      (5555)
 
-        #define XCP_ON_ETHERNET_ARDUINO_DRIVER (XCP_ON_ETHERNET_DRIVER_WIFI)
-        #define XCP_ON_ETHERNET_WIFI_SSID      ("A1_CE8A")
-        #define XCP_ON_ETHERNET_WIFI_PASSWORD  ("6H54726A66")
+        #define XCP_ON_ETHERNET_ARDUINO_DRIVER (XCP_ON_ETHERNET_DRIVER_ETHERNET)
+        #define XCP_ON_ETHERNET_WIFI_SSID      ("")
+        #define XCP_ON_ETHERNET_WIFI_PASSWORD  ("")
         #define XCP_ON_ETHERNET_MAC_ADDRESS    { 0xBE, 0xEF, 0xCA, 0xAA, 0xFF, 0xFE }
 
         #define XCP_MAX_CTO (32)  // (16)