Merge pull request #87 from xjinGao/main

Add TCP server support。

Author: guozhenh

en-us/api/pythonStdlib.md

@@ -1199,8 +1199,8 @@ type - socket type
 proto - protocol number
 
 * usocket.IPPROTO_TCP
-
 * usocket.IPPROTO_UDP
+* usocket.IPPROTO_TCP_SER : socket for TCP Server
 
 Others
 
@@ -1216,6 +1216,8 @@ import usocket
 socket = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM)
 # Creating UDP-based Datagram Sockets
 socket = usocket.socket(usocket.AF_INET, usocket.SOCK_DGRAM)
+# Creating TCP-based server sockets
+socket = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM, usocket.IPPROTO_TCP_SER)
 ```
 
 ##### Translate the host/port argument into a sequence of 5-tuples
@@ -1230,6 +1232,25 @@ Translate the host/port argument into a sequence of 5-tuples. The resulting list
 
 #### Class Socket Methods
 
+##### Bind specified address
+
+> **socket.bind(address)**
+
+Bind the socket to address. The socket must not already be bound. (The format of address depends on the address family)
+
+* `address` : A tuple or list containing addresses and port numbers
+
+Example:
+
+```
+# Bind the datacall IP to the server address
+socket.bind(("",80))
+# Bind a custom IP to the server address
+socket.bind(("192.168.0.1",80))
+```
+
+#####
+
 ##### Enable a server to accept connections
 
 
@@ -1243,7 +1264,7 @@ Enable a server to accept connections. The maximum number of connections can be
 
 > **socket.accept()**
 
-Accept a connection and return a tuple. The socket must be bound to an address and listening for connections. The return value is a pair `(conn, address)`
+Accept a connection and return a tuple. The socket must be bound to an address&port and listening for connections. The return value is a pair `(conn, address, port)`
 
 * `conn` : new socket object usable to send and receive data on the connection
 
@@ -1399,6 +1420,8 @@ Get socket status. The status values are described as follows:
 
 Note:
 
+The BG95 platform does not support this API.
+
 If the user calls the ` socket.getsocketsta () ` after calling the ` socket.close () ` method, it returns-1 because the object resources and so on created at this point have been freed.
 
 **Socket Communication Example**：

zh-cn/api/pythonStdlib.md

@@ -1201,6 +1201,8 @@ proto - 协议号
 
 * usocket.IPPROTO_UDP
 
+* usocket.IPPROTO_TCP_SER ：对应TCP socket 服务端套接字
+
 其他
 
 * usocket.SOL_SOCKET - 套接字选项级别，
@@ -1215,6 +1217,8 @@ import usocket
 socket = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM)
 # 创建基于UDP的数据报套接字
 socket = usocket.socket(usocket.AF_INET, usocket.SOCK_DGRAM)
+# 创建基于TCP的服务端套接字
+socket = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM, usocket.IPPROTO_TCP_SER)
 ```
 
 ##### 将主机域名（host）和端口（port）转换为用于创建套接字的5元组序列
@@ -1229,6 +1233,26 @@ socket = usocket.socket(usocket.AF_INET, usocket.SOCK_DGRAM)
 
 **socket类的方法**
 
+##### 服务端绑定指定地址address
+
+
+> **socket.bind(address)**
+
+服务端绑定指定地址address的服务器。
+
+* `address` ：包含地址和端口号的元组或列表
+
+注意：该方法在服务端套接字使用时，绑定address时会将address设为客户端可连接address。其他客户端是否可连接，需确认运营商网络是否支持。
+
+示例：
+
+```
+#绑定拨号IP为服务器地址，端口自定义
+socket.bind(("",80))
+#绑定自定义address
+socket.bind(("192.168.0.1",80))
+```
+
 ##### 允许服务端接受连接
 
 
@@ -1242,12 +1266,14 @@ socket = usocket.socket(usocket.AF_INET, usocket.SOCK_DGRAM)
 
 > **socket.accept()**
 
-接受连接请求，返回元组，包含新的套接字和客户端地址，形式为：`(conn, address)`
+接受连接请求，返回元组，包含新的套接字和客户端地址以及客户端端口，形式为：`(conn, address, port)`
 
 * `conn` ：新的套接字对象，可以用来发送和接收数据
 
 * `address` ：连接到服务器的客户端地址
 
+* `port` ：连接到服务器的客户端端口
+
 ##### 连接到指定地址address的服务器
 
 > **socket.connect(address)**
@@ -1412,6 +1438,7 @@ socket.setsockopt(usocket.SOL_SOCKET, usocket.TCP_KEEPALIVE, 1)
 
 注意：
 
+BG95平台不支持该API。
 如果用户调用了 `socket.close()` 方法之后，再调用 `socket.getsocketsta()` 会返回-1，因为此时创建的对象资源等都已经被释放。