Change the comment of code into English.

Author: githubChenchi

network-comm/net-protocols/http/example_file_download.py

@@ -1,27 +1,27 @@
 import request
 
-# http 协议的（非 https）百度URL
+# Baidu URL over HTTP protocol (not HTTPS)
 url = 'http://www.baidu.com'
 
-# 发送 HTTP GET 请求
+# Send the HTTP GET request
 response = request.get(url)
 
-# 创建文件baidu.html
+# Create file baidu.html
 f = open('/usr/baidu.html', 'wb')    # 'wb' 表示写入二进制数据
 
-# 获取网页文件内容，并写入文件
+# Get web page content and write to the file
 for i in response.content:
 	f.write(i)
 
-# 网页数据拉取完毕，关闭文件
+# Close the file after fetching the web page data
 f.close()
 
-# 打开文件baidu.html
-with open('/usr/baidu.html', 'rb') as f:    # 'rb' 以二进制方式读取文件
+# Open file baidu.html
+with open('/usr/baidu.html', 'rb') as f:    # 'rb' means reading the file in binary mode
 	r = f.read()
     while r:
         print(r)
         r = f.read()
 
-# 关闭文件
+# Close the file
 f.close()

network-comm/net-protocols/http/example_get_weather.py

@@ -1,12 +1,12 @@
 import request
 
-# 天气查询URL
+# Weather query URL
 url = 'http://restapi.amap.com/v3/weather/weatherInfo?key=2875b8171f67f3be3140c6779f12dcba&city=北京&extensions=base'
 
-# 发送 HTTP GET 请求
+# Send the HTTP GET request
 response = request.get(url)
 
-# 获取天气查询网站返回的原始数据
+# Get the raw data returned by the weather query website
 data = ''
 for i in response.text:
 	data += i

network-comm/net-protocols/http/example_get_weather_json_resolve.py

@@ -1,12 +1,12 @@
 import request
 
-# 天气查询URL
+# Weather query URL
 url = 'http://restapi.amap.com/v3/weather/weatherInfo?key=2875b8171f67f3be3140c6779f12dcba&city=北京&extensions=base'
 
-# 发送 HTTP GET 请求
+# Send the HTTP GET request
 response = request.get(url)
 
-# 获取天气查询网站返回的原始数据，并解析为dict
+# Get raw data from the website and parse it into a dict type by calling the json() method of response object
 data = response.json()
 data = data['lives'][0]
 for k,v in data.items():

network-comm/net-protocols/tcp-udp/example_set_default_nic_of_ethernet.py

@@ -1,21 +1,21 @@
 import ethernet
 
-# 创建以太网卡
+# Create an Ethernet NIC
 eth = ethernet.W5500(b'\x12\x34\x56\x78\x9a\xbc','','','',-1,38,36,37, 0)
 print('W5500 ethernet nic created.')
 
-# 开启 DHCP 功能
+# Enable DHCP
 eth.dhcp()
 print('DHCP enabled.')
 
-# 网卡注册成功后，查看网络配置信息
+# After the NIC is registered, check the network configuration information
 ip_conf = eth.ipconfig()
 print('get ip_conf:', ip_conf)
 
-# 将以太网卡设置为默认网卡
+# Set the Ethernet NIC as the default NIC
 eth.set_default_NIC(ip_conf[1][1])
 print('W5500 is set as default nic.')
 
-# 启动网卡
+# Enable the NIC
 eth.set_up()
 print('Ethernet nic enabled.')

network-comm/net-protocols/tcp-udp/example_set_default_nic_of_wifi.py

@@ -1,24 +1,24 @@
 from usr.WLAN import ESP8266
 from machine import UART
 
-# 创建Wi-Fi网卡
+# Create a Wi-Fi NIC
 wifi = ESP8266(UART.UART2, ESP8266.STA)
 print('Wi-Fi nic created.')
 
-# 配置连接的SSID和password，并连接路由器
+# Configure the SSID and password, and connect to the router
 ssid = 'ssid'
 password = 'password'
 wifi.station(ssid,password)
 print('Wi-Fi connected：%s, %s.' % (ssid, password))
 
-# 给Wi-Fi网卡配置DNS服务器地址
+# Configure the DNS server address for the Wi-Fi NIC
 wifi.set_dns('8.8.8.8', '114.114.114.114')
 print('Wi-Fi DNS server configured.')
 
-# 查看网络配置信息
+# Check the network configuration information
 ip_conf = wifi.ipconfig()
 print('get ip_conf:', ip_conf)
 
-# 将Wi-Fi网卡设置为默认网卡
+# Set the Wi-Fi NIC as the default NIC
 wifi.set_default_NIC(ip_conf[0])
 print('Wi-Fi is set as default nic.')

network-comm/net-protocols/tcp-udp/example_socket_bind_of_ethernet.py

@@ -1,38 +1,38 @@
 import ethernet
 import usocket
 
-# 创建以太网卡
+# Create an Ethernet NIC
 eth = ethernet.W5500(b'\x12\x34\x56\x78\x9a\xbc','','','',-1,38,36,37, 0)
 print('W5500 ethernet nic created.')
 
-# 开启 DHCP 功能
+# Enable DHCP
 eth.dhcp()
 print('DHCP enabled.')
 
-# 启动网卡
+# Enable NIC
 eth.set_up()
 print('Ethernet nic enabled.')
 
-# 网卡注册成功后，查看网络配置信息
+# After the NIC is registered, check the network configuration information
 ip_conf = eth.ipconfig()
 print('get ip_conf:', ip_conf)
 
 def tcp_client(address, port):
-    # 创建socket对象
+    # Create a socket object
     sock = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM, usocket.IPPROTO_TCP)
     print('socket object created.')
 
-    # 创建完成socket对象以后，并且连接服务器之前 绑定以太网卡IP地址
+    # Bind the Ethernet NIC IP address after creating the socket object and before connecting to the server
     local_address = ip_conf[1][1]
     sock.bind((local_address, 0))
     print('bind ethernet address: %s', local_address)
 
-    # 域名解析
+    # Resolve the domain name
     sockaddr=usocket.getaddrinfo(address, port)[0][-1]
     print('DNS for %s: %s' % (address, sockaddr[0]))
 
-    # 连接tcp服务器
+    # Connect to the TCP server
     sock.connect(sockaddr)
     print('tcp link established.')
 
-    # 更多代码请参考前面关于 TCP 客户端的代码示例
+    # More code in TCP client samples above

network-comm/net-protocols/tcp-udp/example_socket_bind_of_wifi.py

@@ -2,40 +2,40 @@
 from machine import UART
 import usocket
 
-# 创建Wi-Fi网卡
+# Create a Wi-Fi NIC
 wifi = ESP8266(UART.UART2, ESP8266.STA)
 print('Wi-Fi nic created.')
 
-# 配置连接的SSID和password，并连接路由器
+# Configure the SSID and password, and connect to the router
 ssid = 'ssid'
 password = 'password'
 wifi.station(ssid,password)
-print('Wi-Fi connected：%s, %s.' % (ssid, password))
+print('Wi-Fi connected: %s, %s.' % (ssid, password))
 
-# 给Wi-Fi网卡配置DNS服务器地址
+# Configure the DNS server address for the Wi-Fi NIC
 wifi.set_dns('8.8.8.8', '114.114.114.114')
 print('Wi-Fi DNS server configured.')
 
-# 查看网络配置信息
+# Check the network configuration information
 ip_conf = wifi.ipconfig()
 print('get ip_conf:', ip_conf)
 
 def tcp_client(address, port):
-    # 创建socket对象
+    # Create a socket object
     sock = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM, usocket.IPPROTO_TCP)
     print('socket object created.')
 
-    # 创建完成socket对象以后，并且连接服务器之前 绑定Wi-Fi网卡IP地址
+    # Before connecting to the server, bind the Wi-Fi NIC IP address
     local_address = ip_conf[0]
     sock.bind((local_address, 0))
     print('bind ethernet address: %s', local_address)
 
-    # 域名解析
+    # Resolve the domain name
     sockaddr=usocket.getaddrinfo(address, port)[0][-1]
     print('DNS for %s: %s' % (address, sockaddr[0]))
 
-    # 连接tcp服务器
+    # Connect to the TCP server
     sock.connect(sockaddr)
     print('tcp link established.')
 
-    # 更多代码请参考前面关于 TCP 客户端的代码示例
+    # More code in TCP client samples above

network-comm/net-protocols/tcp-udp/example_tcp_client_with_dns.py

@@ -2,46 +2,46 @@
 import checkNet
 
 def tcp_client(address, port):
-    # 创建socket对象
+    # Create a socket object
     sock = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM, usocket.IPPROTO_TCP)
     print('socket object created.')
 
-    # 域名解析
+    # Domain name resolution
     sockaddr=usocket.getaddrinfo(address, port)[0][-1]
     print('DNS for %s: %s' % (address, sockaddr[0]))
 
-    # 连接tcp服务器
+    # Connect to the TCP server
     sock.connect(sockaddr)
     print('tcp link established.')
 
-    # 打包用户数据
+    # Package user data
     data = 'GET / HTTP/1.1\r\n'
     data += 'Host: ' + address + ':' + str(port) + '\r\n'
     data += 'Connection: close\r\n'
     data += '\r\n'
     data = data.encode()
 
-    # 发送数据
+    # Send the data
     sock.send(data)
     print('<-- send data:')
     print(data)
 
-    #接收数据
+    # Receive the data
     print('--> recv data:')
     while True:
         try:
             data = sock.recv(1024)
             print(data)
         except:
-            # 数据接收完毕，连接断开
+            # Connection ends until the data is fully received
             print('tcp disconnected.')
             sock.close()
             break
 
 if __name__ == '__main__':
     stage, state = checkNet.waitNetworkReady(30)
-    if stage == 3 and state == 1: # 网络状态正常
+    if stage == 3 and state == 1: # Network connection is normal
         print('Network connection successful.')
-        tcp_client('www.baidu.com', 80) # 启动客户端功能
+        tcp_client('www.baidu.com', 80) # Start the client
     else:
         print('Network connection failed, stage={}, state={}'.format(stage, state))

network-comm/net-protocols/tcp-udp/example_tcp_client_without_dns.py

@@ -2,42 +2,42 @@
 import checkNet
 
 def tcp_client(address, port):
-    # 创建socket对象
+    # Create a socket object
     sock = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM, usocket.IPPROTO_TCP)
     print('socket object created.')
 
-    # 连接tcp服务器
+    # Connect to the TCP server
     sock.connect((address, port))
     print('tcp link established: %s, %s' % (address, port))
 
-    # 打包用户数据
+    # Package user data
     data = 'GET / HTTP/1.1\r\n'
     data += 'Host: ' + address + ':' + str(port) + '\r\n'
     data += 'Connection: close\r\n'
     data += '\r\n'
     data = data.encode()
 
-    # 发送数据
+    # Send the data
     sock.send(data)
     print('<-- send data:')
     print(data)
 
-    #接收数据
+    # Receive the data
     print('--> recv data:')
     while True:
         try:
             data = sock.recv(1024)
             print(data)
         except:
-            # 数据接收完毕，连接断开
+            # Connection ends until the data is fully received
             print('tcp disconnected.')
             sock.close()
             break
 
 if __name__ == '__main__':
     stage, state = checkNet.waitNetworkReady(30)
-    if stage == 3 and state == 1: # 网络状态正常
+    if stage == 3 and state == 1: # Network connection is normal
         print('Network connection successful.')
-        tcp_client('36.152.44.95', 80) # 启动客户端功能
+        tcp_client('36.152.44.95', 80) # Start the client
     else:
         print('Network connection failed, stage={}, state={}'.format(stage, state))