Merge branch 'doc_1.0.9'

README.md

@@ -8,5 +8,17 @@ mPython掌控板是一块MicroPython微控制器板，它集成ESP32高性能双
 GitHub: https://github.com/labplus-cn/mPython    <br/>
 mPython掌控板在线文档: https://mPython.readthedocs.io
 
+# 许可信息
 
-<img src="https://img.shields.io/badge/License-MIT-green.svg" />
+[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+![License: CERN v1.2](https://img.shields.io/badge/License-CERN%20v1.2-lightgrey.svg)
+![License: CC0](https://img.shields.io/badge/License-CC0-blue.svg)
+
+<a href="https://certification.oshwa.org/cn000006.html"><img src="docs/images/OSHW_mark_CN000006.png"  width="150" style="margin: 0px" /></a>
+
+掌控板是一个[OSHWA](https://certification.oshwa.org/license-agreement.html) 认证的开源硬件项目,代码和设计都是开源。但软件须在[GPL-3](http://www.gnu.org/licenses/gpl.html)许可下使用,硬件在CERN许可下使用,文档在CC0许可下使用。
+
+
+# 联系我们
+
+如果您对文档或掌控板的使用有任何建议或疑问，请在Github上创建一个问题，以便与他人共享答案和解决方案。

docs/board/hardware.rst

@@ -25,6 +25,7 @@ mPython掌控是一块MicroPython微控制器板，很好的支持MicroPython/Py
   - 供电方式：Micro USB供电
   - 工作电压：3.3V
   - 最大工作电流:200mA
+  - 最大负载电流:1000mA
   - 掌控板载
 
     - 三轴加速度计MSA300,测量范围:±2G
@@ -63,14 +64,29 @@ mPython掌控是一块MicroPython微控制器板，很好的支持MicroPython/Py
 引脚定义
 --------------
 
-.. image:: /images/掌控板引脚定义-正面.png
+.. figure:: /images/掌控板引脚定义-正面.png
   :width: 800px
+  :align: center
 
-.. image:: /images/掌控板引脚定义-背面.png
+  掌控板正面-触摸引脚
+
+.. figure:: /images/掌控板引脚定义-背面.png
+  :width: 800px
+  :align: center
+
+  掌控板背面-IO引脚
+
+.. figure:: /images/掌控板-pinout_wroom.png
   :width: 800px
+  :align: center
+
+  掌控板ESP32引脚定义
 
-.. image:: /images/掌控板-pinout_wroom.png
+.. figure:: /images/pinout_wroom_pinout.png
   :width: 800px
+  :align: center
+
+  ESP32-WROOM引脚说明
 
 .. _mPythonPindesc:
 

docs/board/index.rst

@@ -8,5 +8,4 @@
    hardware.rst
    drive.rst
    mpythonX.rst
-   mpython2.rst
    flashburn.rst

docs/board/mpythonX.rst

@@ -1,169 +1,4 @@
 mPython X IDE
 ====================
 
-软件安装
------------
-
-目前最新版本为0.3.2，支持Windows 7/8/10、Windows XP、Macos、树莓派、虚谷号：
-
-http://static.steamaker.cn/files/mpythonx-0.3.2-win.exe
-(Win 7 / 8 / 10)
-
-http://static.steamaker.cn/files/mpythonx-0.3.2-xp.exe
-(Win XP)
-
-http://static.steamaker.cn/files/mpythonx-0.3.2-mac.zip
-(Mac OS)
-
-http://static.steamaker.cn/files/mpythonx-0.3.2-arm.tar.gz
-(树莓派)
-
-http://static.steamaker.cn/files/mpythonx-0.3.2-arm64.tar.gz
-(虚谷号，待测试)
-
-附：掌控板的Mac驱动
-
-https://www.silabs.com/documents/public/software/Mac_OSX_VCP_Driver.zip
-
-.. Hint::
-
-  安装过程有可能被杀毒软件误报病毒，需要选择“允许程序所有操作”。
-
-
-安装软件的最后一步，会自动安装CP210x的驱动，如果先前安装过则可以忽略。
-
-.. image:: /images/software/software_2.png
-
-
-
-接入硬件
------------
-
-点击桌面快捷方式mPythonX，打开软件主界面。
-
-.. image:: /images/software/mPythonX/mPythonX_1.png
-
-
-用USB线接入掌控板。正确识别后，“连接串口”处会出现COM口，如下图：
-
-.. image:: /images/software/mPythonX/mPythonX_2.png
-
-
-
-上述顺序可以颠倒，即：可以先接入掌控，再打开软件。
-
-
-图形编辑区
------------
-
-保存
-````````
-
-“保存代码”只保存程序对应的代码，后缀为py：
-
-.. image:: /images/software/mPythonX/mPythonX_3.png
-
-点击“本机读取”，加载保存的py文件：
-
-.. image:: /images/software/mPythonX/mPythonX_5.png
-
-读取效果如图：
-
-.. image:: /images/software/mPythonX/mPythonX_4.png
-
-“保存模块”保存程序对应的代码及图形化模块，后缀为xml：
-
-.. image:: /images/software/mPythonX/mPythonX_6.png
-
-点击“本机读取”，加载保存的xml文件，读取效果如图：
-
-.. image:: /images/software/mPythonX/mPythonX_7.png
-
-模块提示
-````````
-鼠标停留在模块上会有提示：
-
-.. image:: /images/software/mPythonX/mPythonX_8.png
-
-帮助文档
-````````
-在模块上，点击鼠标右键：
-
-.. image:: /images/software/mPythonX/mPythonX_9.png
-
-点击帮助，即可跳转至帮助文档：
-
-.. image:: /images/software/mPythonX/mPythonX_10.png
-
-切换图形/代码模式
-````````
-
-点击“代码模式”/“图形模式”，即可实现对应切换：
-
-.. image:: /images/software/mPythonX/mPythonX_11.png
-
-.. image:: /images/software/mPythonX/mPythonX_12.png
-
-改变图形区/代码区大小
-````````
-
-鼠标停留在圈红的灰色三角上，按住左键左右拖动即可：
-
-.. image:: /images/software/mPythonX/mPythonX_13.png
-
-
-代码编辑区
------------
-
-代码联想：
-
-.. image:: /images/software/mPythonX/mPythonX_14.png
-
-
-运行/刷入
------------
-
-运行/刷入
-````````
-
-运行/刷入两种模式皆可实现程序效果。
-
-点击“连接串口”，按钮字样变成“断开连接”，即可开始运行/刷入：
-
-.. image:: /images/software/mPythonX/mPythonX_15.png
-
-.. Note::
-
-  “运行”的代码脱机后即失效，“刷入”的代码脱机后再次连接电源仍有效
-
-代码查错
-````````
-
-圈红处是反馈的信息，包括硬件信息、代码报错信息等：
-
-.. image:: /images/software/mPythonX/mPythonX_16.png
-
-比如，红字为代码报错信息：
-
-.. image:: /images/software/mPythonX/mPythonX_17.png
-
-读出上一次刷入的代码
-````````
-
-点击“从掌控读出”即可读出上一次刷入的代码。
-
-
-恢复固件
------------
-
-点击“恢复固件”，按照提示操作：
-
-.. image:: /images/software/mPythonX/mPythonX_18.png
-
-.. Hint::
-
-  如果恢复固件失败（或超过30秒仍然一直在恢复），请先尝试关闭杀毒软件，或者选择信任esptool。
-
-
-
-
+https://mpythonx.readthedocs.io/zh_CN/latest/mPythonX.html

docs/classic/breathing_light.rst

@@ -0,0 +1,7 @@
+呼吸灯
+=============
+
+.. literalinclude:: /../examples/pin/breathing_light.py
+    :linenos:
+
+

docs/classic/dht11.rst

@@ -8,7 +8,7 @@ DHT11数字温湿度传感器是一款含有已校准数字信号输出的温湿
     :scale: 50 %
     :align: center
 
-DHT11数字温湿度传感器和掌控板连接需要借助掌控扩展版，在掌控扩展版中DHT11可使用的引脚有0/1/2/8/9/13/14/15/16，在这里使用引脚0。将掌控板插在掌控扩展板上，通过双母头杜邦线将DHT11和扩展板进行连接，DHT11上的“+”连接扩展板的电源口“V”，“-”连接扩展板的地线口“G”，“out”连接扩展板的引脚“0”。
+DHT11数字温湿度传感器和掌控板连接需要借助掌控扩展版，在掌控扩展版中DHT11可使用的引脚有P0/1/8/9/13/14/15/16，在这里使用引脚0。将掌控板插在掌控扩展板上，通过双母头杜邦线将DHT11和扩展板进行连接，DHT11上的“+”连接扩展板的电源口“V”，“-”连接扩展板的地线口“G”，“out”连接扩展板的引脚“0”。
 
 .. image:: /images/classic/dhtconnect.jpg
     :scale: 60 %

docs/classic/index.rst

@@ -5,6 +5,7 @@
     :maxdepth: 1
     :numbered:
 
+    breathing_light.rst
     musicbox.rst
     lux&sound_Cal.rst
     dht11.rst

docs/classic/weather.rst

@@ -77,7 +77,7 @@
     :align: center
     :scale: 60 %
 
-使用前，导入mpython、json、urequests、Timer和天气图标seniverse模块（:download:`seniverse模块 </../examples/06.网络/心知天气/seniverse.py>`，将seniverse模块文件导入掌控板文件根目录）::
+使用前，导入mpython、json、urequests、Timer和天气图标seniverse模块（:download:`seniverse模块 </../examples/network/心知天气/seniverse.py>`，将seniverse模块文件导入掌控板文件根目录）::
 
     from mpython import*
     import json