Merge pull request #75 from SummerGGift/add_examples

armink · web-flow · commit 430a41af34c5 · 2019-06-13T18:23:03.000+08:00
【添加】micropython 例程并重新整理模块分类
diff --git a/docs/03-MicroPython_libraries.md b/docs/03-MicroPython_libraries.md
@@ -14,43 +14,47 @@ Python 的标准库被 “微型化”后，就是 MicroPython 标准库，也
 
 ## RT-Thread MicroPython 模块
 
-### 系统模块
-- [rtthread][1] – RT-Thread 系统相关函数
-- [utime][2]  – 时间相关函数
-- [sys][3]  – 系统特有功能函数
-- [math][4]  – 数学函数
-- [uio][5]  – 输入/输出流
-- [ucollections][6]  – 收集和容器类型
-- [ustruct][7]  – 打包和解包原始数据类型
-- [array][8]  – 数字数据数组
-- [gc][9]  – 控制垃圾回收
+### 常用内建模块
+- [rtthread][1]       – RT-Thread 系统相关函数
+- [utime][2]          – 时间相关函数
+- [sys][3]            – 系统特有功能函数
+- [math][4]           – 数学函数
+- [uio][5]            – 输入/输出流
+- [ucollections][6]   – 提供有用的集合类
+- [ustruct][7]        – 打包和解包原始数据类型
+- [array][8]          – 数字数据数组
+- [gc][9]             – 控制垃圾回收
+- [uos][15]           – 基本的 “操作系统” 服务
+- [select][16]        – 等待流事件
+- [uctypes][17]       – 以结构化的方式访问二进制数据
+- [uerrno][18]        – 系统错误码模块
+- [_thread][19]       – 多线程支持
 
 ### 硬件模块
-- [machine][10] – 与硬件相关的功能
-- [machine.Pin][11]
-- [machine.I2C][12]
-- [machine.SPI][13]
-- [machine.UART][14]
-
-### 系统模块
-- [uos][15] – 基本的 “操作系统” 服务
-- [select][16] – 等待流事件
-- [uctypes][17] – 以结构化的方式访问二进制数据
-- [uerrno][18] – 系统错误码模块
-- [_thread][19] – 多线程支持
-
-### 工具模块
-- [cmath][20] – 复数的数学函数
-- [ubinascii][21] – 二进制/ ASCII转换
-- [uhashlib][22] – 哈希算法
-- [uheapq][23] – 堆排序算法
-- [ujson][24] – JSON编码与解码
-- [ure][25] – 正则表达式
-- [uzlib][26] – zlib 解压缩
-- [urandom][27] – 随机数生成模块
+- [machine][10]       – 与硬件相关的功能
+- [machine.Pin][11]   - Pin 引脚控制类
+- [machine.UART][14]  - UART 外设控制类
+- [machine.I2C][12]   - I2C 外设控制类
+- [machine.SPI][13]   - SPI 外设控制类
+- [machine.RTC][29]   - RTC 外设控制类
+- [machine.PWM][30]   - PWM 外设控制类
+- [machine.ADC][31]   - ADC 外设控制类
+- [machine.LCD][34]   - LCD 外设控制类
 
 ### 网络模块
-- [usocket][28] – 套接字模块
+- [usocket][28]       – 网络套接字模块
+- [network][32]       – 网络连接控制模块
+- [network.WLAN][33]  – WiFi 连接控制类
+
+### 常用第三方模块
+- [cmath][20]         – 复数的数学函数
+- [ubinascii][21]     – 二进制/ ASCII转换
+- [uhashlib][22]      – 哈希算法
+- [uheapq][23]        – 堆排序算法
+- [ujson][24]         – JSON编码与解码
+- [ure][25]           – 正则表达式
+- [uzlib][26]         – zlib 解压缩
+- [urandom][27]       – 随机数生成模块
 
 [1]: 03-Basic_Module/01-rtthread.md
 [2]: 03-Basic_Module/02-utime.md
@@ -80,4 +84,9 @@ Python 的标准库被 “微型化”后，就是 MicroPython 标准库，也
 [26]: 06-Tools_Module/07-uzlib.md
 [27]: 06-Tools_Module/08-urandom.md
 [28]: 07-Network_Module/01-usocket.md
-
+[29]: 04-Hardware_Control_Module/07-machine-RTC.md
+[30]: 04-Hardware_Control_Module/08-machine-PWM.md
+[31]: 04-Hardware_Control_Module/09-machine-ADC.md
+[32]: 07-Network_Module/02-network.md
+[33]: 07-Network_Module/03-network-WLAN.md
+[34]: 04-Hardware_Control_Module/06-machine-LCD.md
diff --git a/examples/basic/_thread.py b/examples/basic/_thread.py
@@ -0,0 +1,21 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import _thread
+import utime as time
+
+def testThread():
+    while True:
+        print("Hello from thread")
+        time.sleep(2)
+
+_thread.start_new_thread(testThread, ())
+while True:
+    pass
diff --git a/examples/basic/array.py b/examples/basic/array.py
@@ -0,0 +1,26 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import array
+
+a = array.array('i', [2, 4, 1, 5])
+b = array.array('f')
+print(a)
+print(b)
+
+a = array.array('f', [3, 6])
+print(a)
+a.append(7.0)
+print(a)
+
+a = array.array('i', [1, 2, 3])
+b = array.array('i', [4, 5])
+a.extend(b)
+print(a)
diff --git a/examples/basic/random.py b/examples/basic/random.py
@@ -0,0 +1,18 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import random
+
+for j in range(0, 2):
+    random.seed(13)         #指定随机数种子
+    for i in range(0, 10):  #生成0到10范围内的随机序列
+        print(random.randint(1, 10))
+    print("end")
+
diff --git a/examples/basic/rtthread.py b/examples/basic/rtthread.py
@@ -0,0 +1,15 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import rtthread
+
+print(rtthread.is_preempt_thread())       # determine if code is running in a preemptible thread
+print(rtthread.current_tid() )            # current thread id
+rtthread.stacks_analyze()                 # show thread information
diff --git a/examples/basic/sys.py b/examples/basic/sys.py
@@ -0,0 +1,18 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import sys
+
+print(sys.version)
+print(sys.version_info)
+print(sys.path)
+print(sys.__name__)
+print(sys.platform)
+print(sys.byteorder)
diff --git a/examples/basic/ucollections.py b/examples/basic/ucollections.py
@@ -0,0 +1,29 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+from ucollections import namedtuple
+
+MyTuple = namedtuple("MyTuple", ("id", "name"))
+t1 = MyTuple(1, "foo")
+t2 = MyTuple(2, "bar")
+print(t1.name)
+assert t2.name == t2[1]
+ucollections.OrderedDict(...)
+
+from ucollections import OrderedDict
+
+# To make benefit of ordered keys, OrderedDict should be initialized
+# from sequence of (key, value) pairs.
+d = OrderedDict([("z", 1), ("a", 2)])
+# More items can be added as usual
+d["w"] = 5
+d["b"] = 3
+for k, v in d.items():
+    print(k, v)
diff --git a/examples/basic/uos.py b/examples/basic/uos.py
@@ -0,0 +1,19 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import uos
+
+uos.mkdir("rtthread")
+uos.getcwd()
+uos.chdir("rtthread")
+uos.getcwd()
+uos.listdir()
+uos.rmdir("11")
+uos.listdir()
diff --git a/examples/basic/utime.py b/examples/basic/utime.py
@@ -0,0 +1,21 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import utime
+
+utime.sleep(1)                                    # sleep for 1 second
+utime.sleep_ms(500)                               # sleep for 500 milliseconds
+utime.sleep_us(10)                                # sleep for 10 microseconds
+start = utime.ticks_ms()                          # get value of millisecond counter
+delta = utime.ticks_diff(utime.ticks_ms(), start) # compute time difference
+print(utime.ticks_add(utime.ticks_ms(), -100))
+print(utime.ticks_add(0, -1))
+
+
diff --git a/examples/network/network_wlan_ap.py b/examples/network/network_wlan_ap.py
@@ -0,0 +1,16 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import network
+
+ap = network.WLAN(network.AP_IF)
+ap.config(essid="hello_rt-thread", password="88888888")
+ap.active(True)
+ap.config("essid")
diff --git a/examples/network/network_wlan_sta.py b/examples/network/network_wlan_sta.py
@@ -0,0 +1,16 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import network
+
+wlan = network.WLAN(network.STA_IF)
+wlan.scan()
+wlan.connect("rtthread","02188888888")
+wlan.isconnected()
diff --git a/examples/network/tcp_client.py b/examples/network/tcp_client.py
@@ -0,0 +1,16 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import usocket
+
+s = usocket.socket(usocket.AF_INET,usocket.SOCK_STREAM)
+s.connect(("192.168.10.110",6000))  
+s.send("micropython")               
+s.close()
diff --git a/examples/network/tcp_server.py b/examples/network/tcp_server.py
@@ -0,0 +1,19 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+import usocket
+
+s = usocket.socket(usocket.AF_INET,usocket.SOCK_STREAM)  # Create STREAM TCP socket
+s.bind(('192.168.12.32', 6001))   
+s.listen(5)
+s.setblocking(True)
+sock,addr=s.accept()              
+sock.recv(10)                    
+s.close()
diff --git a/examples/w601_iot_board/adc.py b/examples/w601_iot_board/adc.py
@@ -0,0 +1,16 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+from machine import ADC     # 从 machine 导入 ADC 类
+
+adc = ADC(2, 5)             # 创建 ADC 对象，当前使用编号为 2 的 ADC 设备的 5 通道
+adc.read()                  # 获取 ADC 对象采样值
+adc.deinit()                # 关闭 ADC 对象
+adc.init(5)                 # 开启并重新配置 ADC 对象
diff --git a/examples/w601_iot_board/i2c.py b/examples/w601_iot_board/i2c.py
@@ -0,0 +1,21 @@
+# 
+# Copyright (c) 2006-2019, RT-Thread Development Team
+# 
+# SPDX-License-Identifier: MIT License
+# 
+# Change Logs:
+# Date           Author       Notes
+# 2019-06-13     SummerGift   first version
+#
+
+from machine import Pin, I2C
+
+clk = Pin(("clk", 43), Pin.OUT_OD)   # Select the 43 pin device as the clock
+sda = Pin(("sda", 44), Pin.OUT_OD)   # Select the 44 pin device as the data line
+i2c = I2C(-1, clk, sda, freq=100000) # create I2C peripheral at frequency of 100kHz
+i2c.scan()                           # scan for slaves, returning a list of 7-bit addresses
+i2c.writeto(0x51, b'123')            # write 3 bytes to slave with 7-bit address 42
+i2c.readfrom(0x51, 4)                # read 4 bytes from slave with 7-bit address 42
+i2c.readfrom_mem(0x51, 0x02, 1)      # read 1 bytes from memory of slave 0x51(7-bit)
+i2c.writeto_mem(0x51, 2, b'\x10')    # write 1 byte to memory of slave 42
+
diff --git a/examples/w601_iot_board/lcd.py b/examples/w601_iot_board/lcd.py
diff --git a/examples/w601_iot_board/pin.py b/examples/w601_iot_board/pin.py
diff --git a/examples/w601_iot_board/pwm.py b/examples/w601_iot_board/pwm.py
diff --git a/examples/w601_iot_board/rtc.py b/examples/w601_iot_board/rtc.py
diff --git a/examples/w601_iot_board/spi.py b/examples/w601_iot_board/spi.py
diff --git a/examples/w601_iot_board/uart.py b/examples/w601_iot_board/uart.py
