Big update

Author: liangshao07

docs/examples/02-Button LED.md

@@ -8,7 +8,7 @@
 >     - ESP32-DevKitC
 > - MicroPython API
 >     - ESP32-DevKitC
-> - STM32Cube（待补充）
+> - STM32Cube
 
 # Arduino API
 
@@ -359,3 +359,40 @@ def main():
 # 调用主函数开始执行
 main()
 ```
+
+# STM32Cube
+
+- 新建工程（参考 LED Blinking）
+- 配置引脚
+
+![image-20241204214437378](../images/image-20241204214437378.png)
+
+- 编写代码
+    - 按下时，切换
+    - 每次按下，切换
+
+
+```cpp
+	  HAL_GPIO_ReadPin(GPIOB,B_KEY_Pin);	// == below
+	  HAL_GPIO_ReadPin(B_KEY_GPIO_Port,B_KEY_Pin);	// Reading GPIO_B 12, HIGH or LOW;
+	  // GPIO_PIN_SET = 1 / GPIO_PIN_RESET = 0
+if(HAL_GPIO_ReadPin(B_KEY_GPIO_Port,B_KEY_Pin) == GPIO_PIN_RESET){
+		  HAL_GPIO_WritePin(C_LED_GPIO_Port, C_LED_Pin, GPIO_PIN_SET);
+	  }
+	  else{
+		  HAL_GPIO_WritePin(C_LED_GPIO_Port, C_LED_Pin, GPIO_PIN_RESET);
+	  }
+```
+
+```cpp
+// Toggles on and off each time the button is pressed
+	  
+	  if(HAL_GPIO_ReadPin(GPIOB, B_KEY_Pin)==GPIO_PIN_RESET){
+		  HAL_Delay(10);	// Keystroke elimination
+		  if (HAL_GPIO_ReadPin(GPIOB, B_KEY_Pin)==GPIO_PIN_RESET){
+			  HAL_GPIO_TogglePin(GPIOC, C_LED_Pin);	// Toggle High-Low Level
+			  while(HAL_GPIO_ReadPin(GPIOB, B_KEY_Pin)==GPIO_PIN_RESET){}	// Keystroke elimination
+		  }
+	  }
+```
+

docs/examples/13-48 Stepper motor.md

@@ -1,4 +1,4 @@
-# 48 Stepper motor.md
+# 48 Stepper motor
 
 ###### 目录
 

docs/examples/ESP32-UDP-LED.md

@@ -0,0 +1,142 @@
+# ESP32-UDP-LED
+
+# Arduino API
+
+## ESP32-DevKitC
+
+```arduino
+
+```
+
+# MicroPython API
+
+## ESP32-DevKitC
+
+```python
+"""
+ESP32 UDP 控制 LED
+
+此代码演示了如何使用 MicroPython 将 ESP32 连接到指定的 Wi-Fi 网络，并通过 UDP 协议接收网络数据来控制连接到 GPIO2 引脚的 LED 的开关状态。
+
+电路连接：
+- LED 阳极（较长的一脚）连接到 GPIO2。
+- LED 阴极（较短的一脚）通过一个 330Ω 电阻连接到 GND。
+
+电路图：
+    ESP32          LED
+   ---------      -----
+  |         |    |     |
+  |    2    |----|>|---+---- GND
+  |         |    (Anode) (Cathode)
+  |         |  (通过 330Ω 电阻)
+  |         |  
+  |         |  
+
+创建于 2024
+作者：Liang
+"""
+
+import socket
+import time
+import network
+import machine
+
+# 配置 Wi-Fi SSID 和密码
+WIFI_SSID = "Wokwi-GUEST"
+WIFI_PASSWORD = ""
+
+# 初始化 LED 引脚
+led = None
+
+def do_connect():
+    """
+    连接到指定的 Wi-Fi 网络。
+    
+    返回:
+        bool: 如果连接成功返回 True，否则返回 False。
+    """
+    wlan = network.WLAN(network.STA_IF)
+    wlan.active(True)
+    if not wlan.isconnected():
+        print('正在连接到网络...')
+        wlan.connect(WIFI_SSID, WIFI_PASSWORD)
+        i = 1
+        while not wlan.isconnected():
+            print("正在链接...{}".format(i))
+            i += 1
+            time.sleep(1)
+    print('网络配置:', wlan.ifconfig())
+    return True
+
+def start_udp():
+    """
+    启动 UDP 服务并绑定端口。
+    
+    返回:
+        socket: 创建并绑定的 UDP 套接字。
+    """
+    # 创建 UDP 套接字
+    udp_socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    # 绑定本地信息
+    udp_socket.bind(("0.0.0.0", 7788))
+    print("UDP 服务器已启动，监听端口 7788")
+    return udp_socket
+
+def handle_data(data, sender_info):
+    """
+    处理接收到的数据并控制 LED。
+    
+    参数:
+        data (str): 接收到的数据字符串。
+        sender_info (tuple): 发送者的地址和端口。
+    """
+    global led
+    print("{} 发送: {}".format(sender_info, data))
+    
+    if data == "light on":
+        print("灯亮...")
+        led.value(1)
+    elif data == "light off":
+        print("灯灭...")
+        led.value(0)
+    else:
+        print("无效命令")
+
+def main():
+    """
+    主函数，连接到 Wi-Fi 并启动 UDP 服务，接收并处理数据。
+    """
+    global led
+    
+    # 1. 连接到 Wi-Fi
+    if not do_connect():
+        print("无法连接到 Wi-Fi 网络，请检查 SSID 和密码。")
+        return
+    
+    # 2. 创建 UDP 服务
+    udp_socket = start_udp()
+    
+    # 3. 初始化 LED 引脚
+    led = machine.Pin(2, machine.Pin.OUT)
+    led.value(0)  # 初始关闭 LED
+    
+    # 4. 接收并处理网络数据
+    while True:
+        try:
+            recv_data, sender_info = udp_socket.recvfrom(1024)
+            recv_data_str = recv_data.decode("utf-8")
+            handle_data(recv_data_str, sender_info)
+        except Exception as e:
+            print("发生错误:", e)
+
+if __name__ == "__main__":
+    main()
+```
+
+# ESP-IDF API
+
+## ESP32-DevKitC
+
+```c
+
+```

docs/examples/ESP32-连接 Wi-Fi.md

@@ -0,0 +1,111 @@
+# ESP32-连接 Wi-Fi
+
+# Arduino API
+
+## ESP32-DevKitC
+
+```arduino
+
+```
+
+# MicroPython API
+
+## ESP32-DevKitC
+
+```python
+"""
+ESP32 Wi-Fi Connection
+
+此代码演示了如何使用 MicroPython 将 ESP32 连接到指定的 Wi-Fi 网络。
+
+创建于 2024
+作者：Liang
+"""
+
+import network
+import time
+
+# 配置 Wi-Fi SSID 和密码
+WIFI_SSID = "your_wifi_ssid"
+WIFI_PASSWORD = "your_wifi_password"
+
+# 初始化 Wi-Fi 接口
+wlan = network.WLAN(network.STA_IF)
+
+def connect_to_wifi():
+    """
+    连接到指定的 Wi-Fi 网络。
+    
+    返回:
+        bool: 如果连接成功返回 True，否则返回 False。
+    """
+    # 激活接口
+    wlan.active(True)
+    # 连接到 Wi-Fi 网络
+    wlan.connect(WIFI_SSID, WIFI_PASSWORD)
+    
+    # 等待连接
+    timeout = 10  # 设置超时时间（秒）
+    start_time = time.time()
+    while not wlan.isconnected() and (time.time() - start_time) < timeout:
+        print("正在连接到 Wi-Fi...")
+        time.sleep(1)
+    
+    if wlan.isconnected():
+        print("Wi-Fi 连接成功！")
+        print("网络配置:", wlan.ifconfig())
+        return True
+    else:
+        print("Wi-Fi 连接失败！")
+        return False
+
+def main():
+    """
+    主函数，尝试连接到 Wi-Fi 并处理结果。
+    """
+    if connect_to_wifi():
+        print("已成功连接到 Wi-Fi 网络。")
+    else:
+        print("无法连接到 Wi-Fi 网络，请检查 SSID 和密码。")
+
+# 调用主函数开始执行
+main()
+```
+
+# ESP-IDF API
+
+## ESP32-DevKitC
+
+```c
+
+```
+
+# 原理
+
+# **1. 设置工作模式**
+
+`Wi-Fi`是基于`IEEE 802.11`标准的无线网络技术 让联网设备以无线电波的形式，加入采用`TCP/IP`通信协议的网络
+
+`Wi-Fi`网络环境通常有两种设备
+
+- Access Point(`AP`) 无线接入点，提供无线接入的设备，家里的光猫就是结合WiFi和internet路由功能的AP。AP和AP可以相互连接。
+- Station(`STA`) 无线终端，连接到AP的装置，手机，电脑等需要联网的设备都是出于STA模式，这个模式不允许其他设备接入
+
+# **3. SSID**
+
+**BSSID**就是无线路由器的MAC地址（本质是**一个MAC地址**）
+
+**SSID**就是手机上搜索到的wifi名字（本质是**一串字符**）
+
+**ESSID**是一个比较抽象的概念，它实际上就和ssid相同（本质也是**一串字符**）。如果有好几个无线路由器都叫这个名字，那么我们就相当于把这个ssid**扩大**了，所以这几个无线路由器共同的这个名字就叫ESSID
+
+打个比方：
+
+- SSID就好比是每个连锁店的门口**招牌**上写的字（例如：阿迪达斯）
+- ESSID就是连锁店的牌子（例如：阿迪达斯）
+- BSSID就是每个连锁店的地址（比如万达广场店，襄阳路店）
+
+连锁店的品牌名与写到招牌上的名就相当于ESSID和SSID
+
+- 当前的`ESP32`不支持`5G`路由器，所以链接的时候要注意这一点，否则连不上
+- 可以将自己的手机开热点让`ESP32`链接