docs: Fix some documentation errors.

lbuque · lbuque · commit 32653ad3cb2e · 2025-01-18T14:15:49.000+08:00
Signed-off-by: lbuque &lt;lbuque@163.com&gt;
diff --git a/docs/en/base/speaker.rst b/docs/en/base/speaker.rst
@@ -60,7 +60,7 @@ UIFLOW2 Example:
     |atoms3_speaker_example.m5f2|
 
 
-class ATOMEchoBase
+class SpeakerBase
 ------------------
 
 Constructors
diff --git a/docs/en/refs/base.echo.ref b/docs/en/refs/base.echo.ref
@@ -11,7 +11,7 @@
 .. |atoms3_echo_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/examples/base/echo/atoms3_echo_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/base/echo/atoms3_echo_example.m5f2"
         target="_blank"
     >
         atoms3_echo_example.m5f2
diff --git a/docs/en/refs/base.speaker.ref b/docs/en/refs/base.speaker.ref
@@ -13,7 +13,7 @@
 .. |atoms3_speaker_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/examples/base/speaker/atoms3_speaker_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/base/speaker/atoms3_speaker_example.m5f2"
         target="_blank"
     >
         atoms3_speaker_example.m5f2
diff --git a/docs/en/refs/hat.dac2.ref b/docs/en/refs/hat.dac2.ref
@@ -3,7 +3,7 @@
     :height: 200px
     :width: 200px
 
-.. |init.png| image:: https://static-cdn.m5stack.com/mpy_docs/unit/dac2/init.png
+.. |init.png| image:: https://static-cdn.m5stack.com/mpy_docs/hat/dac2/init.png
 
 .. |example.png| image:: https://static-cdn.m5stack.com/mpy_docs/hat/dac2/example.png
 
diff --git a/docs/en/refs/hat.speaker.ref b/docs/en/refs/hat.speaker.ref
@@ -11,7 +11,7 @@
 .. |stickc_plus2_speaker_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/examples/base/speaker/atoms3r_speaker_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/base/speaker/atoms3r_speaker_example.m5f2"
         target="_blank"
     >
         stickc_plus2_speaker_example.m5f2
diff --git a/docs/en/refs/module.gpsv2.ref b/docs/en/refs/module.gpsv2.ref
@@ -28,7 +28,7 @@
 .. |gpsv2_core2_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/module/gps_v2/gpsv2_core2_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/module/gpsv2/gpsv2_core2_example.m5f2"
         target="_blank"
     >
         gpsv2_core2_example.m5f2
diff --git a/docs/en/refs/system.time.ref b/docs/en/refs/system.time.ref
@@ -37,8 +37,8 @@
 .. |cores3_time_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/system/wlan_ap/wlan_ap_cores3_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/system/time/cores3_time_example.m5f2"
         target="_blank"
     >
-        wlan_ap_cores3_example.m5f2
+        cores3_time_example.m5f2
     </a>
diff --git a/docs/en/refs/unit.flash_light.ref b/docs/en/refs/unit.flash_light.ref
@@ -9,11 +9,11 @@
 
 .. |example.png| image:: https://static-cdn.m5stack.com/mpy_docs/unit/flashlight/example.png
 
-.. |cores3_glass_example.m5f2| raw:: html
+.. |cores3_flashlight_example.m5f2| raw:: html
 
     <a
         href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/flashlight/cores3_flashlight_example.m5f2"
         target="_blank"
     >
-        cores3_glass_example.m5f2
+        cores3_flashlight_example.m5f2
     </a>
diff --git a/docs/en/refs/unit.lorawan_rui3.ref b/docs/en/refs/unit.lorawan_rui3.ref
@@ -63,7 +63,7 @@
 .. |lorawan_otaa_cores3_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/lorawancn470/otaa_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/lorawan_rui3/lorawan_otaa_cores3_example.m5f2"
         target="_blank"
     >
         lorawan_otaa_cores3_example.m5f2
@@ -72,7 +72,7 @@
 .. |lorawan_p2p_cores3_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/lorawancn470/p2p_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/lorawan_rui3/lorawan_p2p_cores3_example.m5f2"
         target="_blank"
     >
         lorawan_p2p_cores3_example.m5f2
@@ -81,7 +81,7 @@
 .. |lorawan_p2p_rec_cores3_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/lorawancn470/p2p_rec_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/lorawan_rui3/lorawan_p2p_rec_cores3_example.m5f2"
         target="_blank"
     >
         lorawan_p2p_rec_cores3_example.m5f2
diff --git a/docs/en/refs/unit.minioled.ref b/docs/en/refs/unit.minioled.ref
@@ -11,7 +11,7 @@
 .. |cores3_minioled_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/glass/cores3_glass_example.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/minioled/cores3_minioled_example.m5f2
         target="_blank"
     >
         cores3_minioled_example.m5f2
diff --git a/docs/en/refs/unit.watering.ref b/docs/en/refs/unit.watering.ref
@@ -16,7 +16,7 @@
 .. |cores3_watering_example.m5f2| raw:: html
 
     <a
-        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/weight_i2c/weight-i2c-demo.m5f2"
+        href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/unit/watering/cores3_watering_example.m5f2"
         target="_blank"
     >
         cores3_watering_example.m5f2
diff --git a/docs/en/units/flash_light.rst b/docs/en/units/flash_light.rst
@@ -31,7 +31,7 @@ UIFLOW2 Example:
 
 .. only:: builder_html
 
-    |cores3_glass_example.m5f2|
+    |cores3_flashlight_example.m5f2|
 
 
 class FlashLightUnit
diff --git a/examples/unit/glass2/cores3_glass2_example.m5f2 b/examples/unit/glass2/cores3_glass2_example.m5f2
@@ -1 +1 @@
-{"version":"V2.0","versionNumber":"V2.2.0","type":"cores3","components":[{"name":"screen","type":"screen","layer":0,"screenId":"builtin","screenName":"","id":"__cores3_screen","createTime":1735638025318,"x":0,"y":0,"width":320,"height":240,"backgroundColor":"#222222","size":0,"isSelected":true},{"name":"label0","type":"label","layer":1,"screenId":"builtin","screenName":"","id":"cg`Jr9X=50vjwj%u","createTime":1735638034711,"x":127,"y":109,"color":"#ffffff","backgroundColor":"#222222","text":"CoreS3","engine":"gfx","font":"Widgets.FONTS.DejaVu18","rotation":0,"isSelected":false},{"name":"screen","type":"screen","layer":0,"screenId":"aUYnwbk_rg1PljeS","screenName":"lcd_0","id":"__display_screen","createTime":1735638049338,"x":0,"y":0,"width":135,"height":240,"backgroundColor":"#000000","size":0,"isSelected":true},{"name":"label1","type":"label","layer":2,"screenId":"aUYnwbk_rg1PljeS","screenName":"lcd_0","id":"i4XP^NsqfaNqiLoq","createTime":1735638054199,"x":48,"y":109,"color":"#ffffff","backgroundColor":"#222222","text":"LCD","engine":"gfx","font":"Widgets.FONTS.DejaVu18","rotation":0,"isSelected":false}],"resources":[{"hardware":["hardware_button","hardware_pin_button","imu","speaker","touch","als","mic","i2c"]},{"unit":["unit_lcd"]}],"units":[{"type":"unit_lcd","name":"lcd_0","portList":["A","PAHUB","Custom"],"portType":"A","userPort":[22,21],"id":"q=6D9KnOdhNEEyR@","createTime":1735638030019,"bus":"i2c0","pahubPortList":[0,1,2,3,4,5],"pahubPort":0,"initBlockId":"IXS0*]U,3A1~Jz:5EDXm"}],"hats":[],"bases":[],"i2cs":[{"id":"i2c0","portType":"A","userPort":[22,21],"freq":"100000","blockId":"I+TwSeTtibW0sc)PtP0%"}],"blockly":"<block type=\"basic_on_setup\" id=\"setup_block\" deletable=\"false\" x=\"50\" y=\"50\"><mutation isBegin=\"true\"></mutation><field name=\"UPDATEOP\">true</field><statement name=\"FUNC\"><block type=\"system_m5_begin\" id=\"system_m5_begin\"><next><block type=\"i2c_init\" id=\"I+TwSeTtibW0sc)PtP0%\"><field name=\"NAME\">0</field><field name=\"FREQ\">100000</field><value name=\"SCL\"><shadow type=\"math_number\" id=\"y1WcU^LV!DU}c1x$*|q`\"><mutation max=\"Infinity\" min=\"-Infinity\" precision=\"0\"></mutation><field name=\"NUM\">1</field></shadow></value><value name=\"SDA\"><shadow type=\"math_number\" id=\"{U3=-%U[!B%Z6UboNDcr\"><mutation max=\"Infinity\" min=\"-Infinity\" precision=\"0\"></mutation><field name=\"NUM\">2</field></shadow></value><next><block type=\"unit_lcd_init\" id=\"IXS0*]U,3A1~Jz:5EDXm\"><mutation hasScreen=\"true\" showScreen=\"true\" screenId=\"aUYnwbk_rg1PljeS\"></mutation><field name=\"NAME\">lcd_0</field><field name=\"SHOW_OP\">true</field><value name=\"ADDR\"><shadow type=\"unit_lcd_addr_option\" id=\"N-~8LFHHW2NvQ-9jqM_G\"><field name=\"VALUE\">0x3e</field></shadow></value></block></next></block></next></block></statement></block><block type=\"basic_on_loop\" id=\"loop_block\" deletable=\"false\" x=\"450\" y=\"50\"><mutation isUpdate=\"true\"></mutation><field name=\"UPDATEOP\">true</field><statement name=\"FUNC\"><block type=\"system_m5_update\" id=\"system_m5_update\"></block></statement></block>","screen":[{"simulationName":"Built-in","type":"builtin","width":320,"height":240,"scale":0.78,"screenName":"","blockId":"","screenColorType":0,"id":"builtin","createTime":1735638025316},{"simulationName":"display_0","type":"display","width":135,"height":240,"scale":1,"screenName":"lcd_0","blockId":"IXS0*]U,3A1~Jz:5EDXm","screenColorType":0,"id":"aUYnwbk_rg1PljeS","createTime":1735638049322,"fullZoom":1.387}],"logicWhenNum":0,"customList":[]}
+{"version":"V2.0","versionNumber":"V2.2.1","type":"cores3","components":[{"name":"screen","type":"screen","layer":0,"screenId":"builtin","screenName":"","id":"__cores3_screen","createTime":1737170160925,"x":0,"y":0,"width":320,"height":240,"backgroundColor":"#222222","size":0,"isSelected":true},{"name":"label0","type":"label","layer":1,"screenId":"builtin","screenName":"","id":"kCjo#tXbLT^BJ=7S","createTime":1737170201503,"x":127,"y":109,"color":"#ffffff","backgroundColor":"#222222","text":"CoreS3","engine":"gfx","font":"Widgets.FONTS.DejaVu18","rotation":0,"isSelected":false},{"name":"screen","type":"screen","layer":0,"screenId":"pEhB-&n$61OJ&@AI","screenName":"glass2_0","id":"__display_screen","createTime":1737170214123,"x":0,"y":0,"width":128,"height":64,"backgroundColor":"#000000","size":0,"isSelected":true},{"name":"label1","type":"label","layer":2,"screenId":"pEhB-&n$61OJ&@AI","screenName":"glass2_0","id":"a-NdpP`^lv@kuASH","createTime":1737170220920,"x":26,"y":21,"color":"#ffffff","backgroundColor":"#222222","text":"GLASS2","engine":"gfx","font":"Widgets.FONTS.DejaVu18","rotation":0,"isSelected":false}],"resources":[{"hardware":["hardware_button","hardware_pin_button","imu","speaker","touch","als","mic","i2c"]},{"unit":["unit_glass2"]}],"units":[{"type":"unit_glass2","name":"glass2_0","portList":["A","PAHUB","Custom"],"portType":"A","userPort":[22,21],"id":"l0!vlnraZOAgY_ki","createTime":1737170170377,"bus":"i2c0","pahubPortList":[0,1,2,3,4,5],"pahubPort":0,"initBlockId":"ev_ZrE@eatXV0bZ5sGc+"}],"hats":[],"bases":[],"i2cs":[{"id":"i2c0","portType":"A","userPort":[22,21],"freq":"100000","blockId":"%~KJ(T1m(it7a(mb)[Jy"}],"blockly":"<block type=\"basic_on_setup\" id=\"setup_block\" deletable=\"false\" x=\"50\" y=\"50\"><mutation isBegin=\"true\"></mutation><field name=\"UPDATEOP\">true</field><statement name=\"FUNC\"><block type=\"system_m5_begin\" id=\"system_m5_begin\"><next><block type=\"i2c_init\" id=\"%~KJ(T1m(it7a(mb)[Jy\"><field name=\"NAME\">0</field><field name=\"FREQ\">100000</field><value name=\"SCL\"><shadow type=\"math_number\" id=\"oD)mpd]RDwJHW|(l3tbF\"><mutation max=\"Infinity\" min=\"-Infinity\" precision=\"0\"></mutation><field name=\"NUM\">1</field></shadow></value><value name=\"SDA\"><shadow type=\"math_number\" id=\"5oyCA#6rP#rxOl6)K%tt\"><mutation max=\"Infinity\" min=\"-Infinity\" precision=\"0\"></mutation><field name=\"NUM\">2</field></shadow></value><next><block type=\"unit_glass2_init\" id=\"ev_ZrE@eatXV0bZ5sGc+\"><mutation hasScreen=\"true\" showScreen=\"false\" screenId=\"pEhB-&amp;n$61OJ&amp;@AI\"></mutation><field name=\"NAME\">glass2_0</field><field name=\"SHOW_OP\">false</field><value name=\"ADDR\"><shadow type=\"unit_glass2_addr_option\" id=\"-pF?.zO_(I~p*OV6`PAl\"><field name=\"VALUE\">0x3c</field></shadow></value></block></next></block></next></block></statement></block><block type=\"basic_on_loop\" id=\"loop_block\" deletable=\"false\" x=\"450\" y=\"50\"><mutation isUpdate=\"true\"></mutation><field name=\"UPDATEOP\">true</field><statement name=\"FUNC\"><block type=\"system_m5_update\" id=\"system_m5_update\"></block></statement></block>","screen":[{"simulationName":"Built-in","type":"builtin","width":320,"height":240,"scale":0.78,"screenName":"","blockId":"","screenColorType":0,"id":"builtin","createTime":1737170160893},{"simulationName":"display_0","type":"display","width":128,"height":64,"scale":1,"screenName":"glass2_0","blockId":"ev_ZrE@eatXV0bZ5sGc+","screenColorType":1,"id":"pEhB-&n$61OJ&@AI","createTime":1737170214105,"fullZoom":5.203}],"logicWhenNum":0,"customList":[]}
diff --git a/examples/unit/glass2/cores3_glass2_example.py b/examples/unit/glass2/cores3_glass2_example.py
@@ -7,7 +7,6 @@
 from M5 import *
 from hardware import I2C
 from hardware import Pin
-from unit import Glass2Unit
 
 
 label0 = None
@@ -24,7 +23,7 @@ def setup():
     label0 = Widgets.Label("CoreS3", 127, 109, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
 
     i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000)
-    glass2_0 = Glass2Unit(i2c0, 0x3C)
+    glass2_0 = M5.addDisplay(i2c0, 0x3C, {"unit_glass2": True})
     label1 = Widgets.Label(
         "GLASS2", 26, 21, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18, glass2_0
     )
diff --git a/examples/unit/minioled/cores3_minioled_example.m5f2 b/examples/unit/minioled/cores3_minioled_example.m5f2
diff --git a/examples/unit/minioled/cores3_minioled_example.py b/examples/unit/minioled/cores3_minioled_example.py

Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,7 @@`
`11`	`11`	`.. \|atoms3_echo_example.m5f2\| raw:: html`
`12`	`12`
`13`	`13`	`<a`
`14`		`- href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/examples/base/echo/atoms3_echo_example.m5f2"`
	`14`	`+ href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/base/echo/atoms3_echo_example.m5f2"`
`15`	`15`	`target="_blank"`
`16`	`16`	`>`
`17`	`17`	`atoms3_echo_example.m5f2`
Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@`
`13`	`13`	`.. \|atoms3_speaker_example.m5f2\| raw:: html`
`14`	`14`
`15`	`15`	`<a`
`16`		`- href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/examples/base/speaker/atoms3_speaker_example.m5f2"`
	`16`	`+ href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/base/speaker/atoms3_speaker_example.m5f2"`
`17`	`17`	`target="_blank"`
`18`	`18`	`>`
`19`	`19`	`atoms3_speaker_example.m5f2`
Original file line number	Diff line number	Diff line change
`@@ -28,7 +28,7 @@`
`28`	`28`	`.. \|gpsv2_core2_example.m5f2\| raw:: html`
`29`	`29`
`30`	`30`	`<a`
`31`		`- href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/module/gps_v2/gpsv2_core2_example.m5f2"`
	`31`	`+ href="https://uiflow2.m5stack.com/?example=https://raw.githubusercontent.com/m5stack/uiflow-micropython/develop/examples/module/gpsv2/gpsv2_core2_example.m5f2"`
`32`	`32`	`target="_blank"`
`33`	`33`	`>`
`34`	`34`	`gpsv2_core2_example.m5f2`