lib/module: Add Commu module support.

Signed-off-by: Tinyu-Zhao <[email protected]>

Author: Tinyu-Zhao

docs/en/conf.py

@@ -51,7 +51,7 @@
     "M5",
     "module.mbus",
     "network",
-    "m5can"
+    "m5can",
 ]
 
 autodoc_default_options = {

docs/en/module/commu.rst

@@ -0,0 +1,72 @@
+Commu Module
+==============
+
+.. sku: M011
+
+.. include:: ../refs/module.commu.ref
+
+This is the driver library for the module Commu for receiving and sending CAN / RS485 / I2C data.
+
+Support the following products:
+
+    |commu|
+
+
+UiFlow2 Example
+---------------
+
+CAN, RS485, I2C communication
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Open the |commu_core2_example.m5f2| project in UiFlow2.
+
+This example shows how to receive and send data using the Commu Module.
+
+UiFlow2 Code Block:
+
+    |example.png|
+
+Example output:
+
+    None
+
+MicroPython Example
+-------------------
+
+CAN, RS485, I2C communication
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This example shows how to receive and send data using the Commu Module.
+
+MicroPython Code Block:
+
+    .. literalinclude:: ../../../examples/module/commu/commu_core2_example.py
+        :language: python
+        :linenos:
+
+Example output:
+
+    None
+
+**API**
+-------
+
+CommuModule
+^^^^^^^^^^^
+
+.. autoclass:: module.commu.CommuModuleCAN
+    :members:
+
+.. autoclass:: module.commu.CommuModuleRS485
+    :members:
+
+    The `CommuModuleRS485` class wraps an instance of the `UART` class.
+
+    For more details, see :ref:`hardware.UART <hardware.UART>`.
+
+.. autoclass:: module.commu.CommuModuleI2C
+    :members:
+
+    The `CommuModuleI2C` class wraps an instance of the `I2C` class.
+
+    For more details, see :ref:`machine.I2C <machine.I2C>`. -- a two-wire serial protocol.

docs/en/module/index.rst

@@ -7,6 +7,7 @@ Module
     4in8out.rst
     ain4.rst
     bala2.rst
+    commu.rst
     display.rst
     dmx.rst
     dualkmeter.rst

docs/en/refs/module.commu.ref

@@ -0,0 +1,23 @@
+..  |commu| image:: https://static-cdn.m5stack.com/resource/docs/products/module/commu/commu_01.webp
+    :target: https://docs.m5stack.com/en/module/commu
+    :height: 200px
+    :width: 200px
+
+.. |init.png| image:: https://m5stack.oss-cn-shenzhen.aliyuncs.com/mpy_docs/module/commu/init.png
+.. |info.png| image:: https://m5stack.oss-cn-shenzhen.aliyuncs.com/mpy_docs/module/commu/info.png
+.. |get_irq_state.png| image:: https://m5stack.oss-cn-shenzhen.aliyuncs.com/mpy_docs/module/commu/get_irq_state.png
+.. |any.png| image:: https://m5stack.oss-cn-shenzhen.aliyuncs.com/mpy_docs/module/commu/any.png
+.. |recv_message.png| image:: https://m5stack.oss-cn-shenzhen.aliyuncs.com/mpy_docs/module/commu/recv_message.png
+.. |recv_message_into.png| image:: https://m5stack.oss-cn-shenzhen.aliyuncs.com/mpy_docs/module/commu/recv_message_into.png
+.. |send.png| image:: https://m5stack.oss-cn-shenzhen.aliyuncs.com/mpy_docs/module/commu/send.png
+
+.. |example.png| image:: https://static-cdn.m5stack.com/mpy_docs/module/commu/example.png
+
+.. |commu_core2_example.m5f2| raw:: html
+
+    <a
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/module/commu/commu_core2_example.m5f2"
+        target="_blank"
+    >
+        commu_core2_example.m5f2
+    </a>