diff --git a/docs/assets/img/product_pics/unit/color/unit_color_04.png b/docs/assets/img/product_pics/unit/color/unit_color_04.png new file mode 100644 index 00000000..e643cec9 Binary files /dev/null and b/docs/assets/img/product_pics/unit/color/unit_color_04.png differ diff --git a/docs/assets/img/product_pics/unit/color/unit_color_05.png b/docs/assets/img/product_pics/unit/color/unit_color_05.png new file mode 100644 index 00000000..7f84a6db Binary files /dev/null and b/docs/assets/img/product_pics/unit/color/unit_color_05.png differ diff --git a/docs/assets/img/product_pics/unit/color/unit_color_06.png b/docs/assets/img/product_pics/unit/color/unit_color_06.png new file mode 100644 index 00000000..f24a2a02 Binary files /dev/null and b/docs/assets/img/product_pics/unit/color/unit_color_06.png differ diff --git a/docs/assets/img/product_pics/unit/color/unit_color_07.png b/docs/assets/img/product_pics/unit/color/unit_color_07.png new file mode 100644 index 00000000..87e3c73b Binary files /dev/null and b/docs/assets/img/product_pics/unit/color/unit_color_07.png differ diff --git a/docs/en/core/m5stickc.md b/docs/en/core/m5stickc.md index 1b885849..81433562 100644 --- a/docs/en/core/m5stickc.md +++ b/docs/en/core/m5stickc.md @@ -14,7 +14,13 @@ **M5StickC** is a ESP32 development board with 0.96 inch **TFT color screen** (80 * 160 resolution), **Red LED**, button, **Microphone**, IR transmitter, 6-axis IMU (SH200Q) and 80 mAH battery. The ESP32 module **ESP32-Pico** in M5StickC also has a built-in 4MB flash. If the M5StickC is equipped with watch-base and watch-belt, you can wear it on your wrist. -**Power on / off:** Press for two seconds to turn it on, and press and hold for six seconds to turn it off. +**Power on / off:** + +* Power on: Press the reset button for at least 2 seconds + +* Shutdown: Press the reset button for at least 6 seconds + + **Note:** Only orange case of M5StickC for sale. @@ -101,7 +107,7 @@ - [ESP32-PICO](https://github.com/m5stack/M5-Schematic/blob/master/Core/esp32-pico-d4_datasheet_en.pdf) - [ST7735S](https://github.com/m5stack/M5-Schematic/blob/master/Core/ST7735S_v1.1.pdf) - - [SH200Q](https://github.com/m5stack/M5-Schematic/blob/master/Core/SH200Q.pdf) - [AXP192](https://github.com/m5stack/M5-Schematic/blob/master/Core/AXP192%20Datasheet%20v1.13_cn.pdf) + - [SH200Q](https://github.com/m5stack/M5-Schematic/blob/master/Core/SH200Q.pdf) - [AXP192](https://github.com/m5stack/M5-Schematic/blob/master/Core/AXP192%20Datasheet%20v1.13_cn.pdf) - [SPM1423](https://pdf1.alldatasheet.com/datasheet-pdf/view/546596/KNOWLES/SPM1423HM4H-B.html) ## Example diff --git a/docs/en/unit/396port.md b/docs/en/unit/396port.md index 39b2e1be..a299ba9f 100644 --- a/docs/en/unit/396port.md +++ b/docs/en/unit/396port.md @@ -16,6 +16,11 @@ - GROVE interface, support [UIFlow](http://flow.m5stack.com) and [Arduino](http://www.arduino.cc) - Two Lego installation holes +## Include + +- 1x 396PORT Unit +- 1x Grove Cable + ## Related Link - **[Offical Video](https://www.youtube.com/channel/UCozgFVglWYQXbvTmGyS739w)** diff --git a/docs/en/unit/color.md b/docs/en/unit/color.md index f1f3aa36..a9c6b1eb 100644 --- a/docs/en/unit/color.md +++ b/docs/en/unit/color.md @@ -8,19 +8,43 @@ ## Description -**COLOR** is a unit can detecte the color of object surface which integrates **TCS3472** (a color sensor). The unit comunicates with M5Core with I2C. +**COLOR** is color recognition unit with integrated **TCS3472** chip. + +**Identify color principle:** + +In the TCS3472, a 3*4 array of filtered photodiodes and a analog-to-digital converters are embedded. Of the 16 photodiodes, 3 have red filters, 3 have green filters, 3 have blue filters and 3 have no filter(clear). + + + +When detecting the color of an object, TCS3472 returns data from four channels: red(R), green(G), blue(B) and clear(C)(non-filtered). The response from the red, green and blue channels (RGB) can be used to determine a particular source’s chromaticity coordinates (x, y). + + + +Chromaticity Calculation Process Overview: + + + +When we get coordinates (x, y), please reference the below figure so as to get the recommended color. + + + +This Unit communicates with the M5Core via the GROVE A interface. It's I2C address is 0x29. ## Feature -- High precision -- Detection range: 0℃~80℃ +- Detection range: -40℃~85℃ - GROVE interface, support [UIFlow](http://flow.m5stack.com) and [Arduino](http://www.arduino.cc) - Two Lego installation holes -## APPLICATION +## Include -- RGB LED Backlight Control -- Product Color Verification +- 1x COLOR Unit +- 1x Grove Cable + +## Application + +- Product Color Verification +- Color tracking robot ## Related Link @@ -28,7 +52,7 @@ - **[Forum](http://forum.m5stack.com/)** -- **Datasheet** - [TCS3472](https://pdf1.alldatasheet.com/datasheet-pdf/view/560511/AMSCO/TCS3472.html) +- **Datasheet** - [TCS3472](https://ams.com/documents/20143/36005/TCS3472_DS000390_2-00.pdf) ## Example diff --git a/docs/en/unit/earth.md b/docs/en/unit/earth.md index 8706ae04..2716ecc5 100644 --- a/docs/en/unit/earth.md +++ b/docs/en/unit/earth.md @@ -20,6 +20,15 @@ You can read the moisture in soil staright or get a digital signal(0/1) that mea - GROVE interface, support [UIFlow](http://flow.m5stack.com) and [Arduino](http://www.arduino.cc) - Two Lego installation holes +## Include + +- 1x EARTH unit +- 1x GROVE Cable + +## Application + +- Potted soil moisture monitoring + ## Related Link - **[Offical Video](https://www.youtube.com/channel/UCozgFVglWYQXbvTmGyS739w)** diff --git a/docs/en/unit/finger.md b/docs/en/unit/finger.md index 7559d7e5..ae4e60ad 100644 --- a/docs/en/unit/finger.md +++ b/docs/en/unit/finger.md @@ -1,4 +1,4 @@ -# FINGER {docsify-ignore-all} +# Unit FINGER {docsify-ignore-all} @@ -28,6 +28,16 @@ The parameter of USART: Baudrate(**default: 19200bps**), Start bits(1 bit), Stop - Input voltage range: 3.3 ~ 6V - Operating temperature and humidity: -10 ~ 60°, 20% ~ 80% --> +## Include + +- 1x FINGER Unit +- 1x Grove Cable + +## Application + +- Fingerprint attendance +- Fingerprint lock + ## Related Link - **[Offical Video](https://www.youtube.com/channel/UCozgFVglWYQXbvTmGyS739w)** diff --git a/docs/en/unit/hub.md b/docs/en/unit/hub.md index 77cd0c2d..93aa2593 100644 --- a/docs/en/unit/hub.md +++ b/docs/en/unit/hub.md @@ -18,6 +18,11 @@ Core at a time. - GROVE interface, support [UIFlow](http://flow.m5stack.com) and [Arduino](http://www.arduino.cc) - Two Lego installation holes +## Include + +- 1x HUB Unit +- 1x Grove Cable + ## Related Link - **[Offical Video](https://www.youtube.com/channel/UCozgFVglWYQXbvTmGyS739w)** diff --git a/docs/en/unit/relay.md b/docs/en/unit/relay.md index 16108e76..a4879c99 100644 --- a/docs/en/unit/relay.md +++ b/docs/en/unit/relay.md @@ -13,15 +13,20 @@ Only a low electrial level is sent to this unit, the relay will be close and the ## Feature + - A single input - Up to 3A @ 30 VDC or 220 VAC - GROVE interface, support [UIFlow](http://flow.m5stack.com) and [Arduino](http://www.arduino.cc) - Two Lego installation holes -## APPLICATION +## Include -- Be perfect for large inductive loads(like DC motors electrocircuit, intelligent interpolation...) -- Control a standard wall outlet device +- 1x RELAY Unit +- 1x Grove Cable + +## Application + +- Remote control of high-power appliances, such as refrigerators, air conditioners, TVs, etc. ## Related Link diff --git a/docs/en/unit/trace.md b/docs/en/unit/trace.md index 00aa81fa..b04c1a63 100644 --- a/docs/en/unit/trace.md +++ b/docs/en/unit/trace.md @@ -8,9 +8,9 @@ ## Description -**TRACE** is a line-follower unit with built-in 4 pairs of photoelectric tube and MEGA328 chip. +**TRACE** is A line of built-in 4 sets of infrared emitting LEDs and infrared sensitive phototransistors. It can output digital signal to a microcontroller so that the robot can follow a black line on white background, or vice versa. -TRACE Unit also communicates with the master through the IIC ( the IIC address is 0x5A). When connected to the M5Core, it is connected to the GROVE A. +This Unit communicates with the M5Core via the GROVE A interface. It's I2C address is 0x5A. @@ -19,6 +19,15 @@ TRACE Unit also communicates with the master through the IIC ( the IIC address i - operation range: The reflecting surface is less than 11mm from the photoelectric surface - GROVE interface, support [UIFlow](http://flow.m5stack.com) and [Arduino](http://www.arduino.cc) +## Include + +- 1x TRACE Unit +- 1x Grove Cable + +## Application + +- Follow line robot + ## Related Link - **[Offical Video](https://www.youtube.com/channel/UCozgFVglWYQXbvTmGyS739w)** diff --git a/docs/ja/core/m5stickc.md b/docs/ja/core/m5stickc.md index 16e90e4e..16f79783 100644 --- a/docs/ja/core/m5stickc.md +++ b/docs/ja/core/m5stickc.md @@ -80,6 +80,7 @@ - [ST7735S](https://github.com/m5stack/M5-Schematic/blob/master/Core/ST7735S_v1.1.pdf) - [SH200Q](https://github.com/m5stack/M5-Schematic/blob/master/Core/SH200Q.pdf) - [AXP192](https://github.com/m5stack/M5-Schematic/blob/master/Core/AXP192%20Datasheet%20v1.13_cn.pdf) + - [SPM1423](https://pdf1.alldatasheet.com/datasheet-pdf/view/546596/KNOWLES/SPM1423HM4H-B.html) ## サンプルコード diff --git a/docs/ja/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md b/docs/ja/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md index 6d1a9bdc..a16ebfb9 100644 --- a/docs/ja/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md +++ b/docs/ja/quick_start/m5core/m5stack_core_get_started_Arduino_MacOS.md @@ -1,4 +1,4 @@ -# M5Core クイックスタート(macOS, Arudino) {docsify-ignore-all} +# M5Core クイックスタート{docsify-ignore-all} :memo: **[テキストチュートリアル](#テキストチュートリアル)**      :clapper: **[ビデオチュートリアル](#ビデオチュートリアル)** diff --git a/docs/zh_CN/core/m5stickc.md b/docs/zh_CN/core/m5stickc.md index 548697c3..9b5f89e5 100644 --- a/docs/zh_CN/core/m5stickc.md +++ b/docs/zh_CN/core/m5stickc.md @@ -14,7 +14,13 @@ **M5StickC** 是一个包含 0.96 寸 **TFT 彩屏** (80 x 160 分辨率)、**红色** LED 灯、按键、**麦克风**、红外发射管、六轴姿态传感器 (SH200Q) 和 80mAH 的电池的小型 **ESP32 开发板**。M5StickC 内的 ESP32 模组 **ESP32-Pico** 还内置了 4MB 的flash。如果 M5StickC 装配上表带底座和表带，你可以将它戴在手腕上。 -**开关机操作：**短按两秒开机，长按六秒关机。 +**开关机操作：** + +* 开机：按复位按键，持续至少 2 秒 + +* 关机：按复位按键，持续至少 6 秒 + + **注意：**外壳颜色只有橙色在售 @@ -102,7 +108,7 @@ - [ESP32-PICO](https://github.com/m5stack/M5-Schematic/blob/master/Core/esp32-pico-d4_datasheet_cn.pdf) - [ST7735S](https://github.com/m5stack/M5-Schematic/blob/master/Core/ST7735S_v1.1.pdf) - - [SH200Q](https://github.com/m5stack/M5-Schematic/blob/master/Core/SH200Q.pdf) - [AXP192](https://github.com/m5stack/M5-Schematic/blob/master/Core/AXP192%20Datasheet%20v1.13_cn.pdf) + - [SH200Q](https://github.com/m5stack/M5-Schematic/blob/master/Core/SH200Q.pdf) - [AXP192](https://github.com/m5stack/M5-Schematic/blob/master/Core/AXP192%20Datasheet%20v1.13_cn.pdf) - [SPM1423](https://pdf1.alldatasheet.com/datasheet-pdf/view/546596/KNOWLES/SPM1423HM4H-B.html) ## 例程 diff --git a/docs/zh_CN/unit/color.md b/docs/zh_CN/unit/color.md index a1b8ffbf..ec700221 100644 --- a/docs/zh_CN/unit/color.md +++ b/docs/zh_CN/unit/color.md @@ -1,4 +1,4 @@ -# COLOR - 颜色传感器Unit {docsify-ignore-all} +# COLOR - 颜色传感器 Unit {docsify-ignore-all} @@ -8,18 +8,47 @@ ## 描述 -Color是一个颜色传感器. 通过GROVE接口(I2C)与M5Core相连，能够识别物体表面颜色，它内置了颜色传感器芯片**TCS3472**. +**COLOR** 是一款集成 **TCS3472** 芯片的颜色识别 Unit。 + +**识别颜色原理：** + +在 TCS3472 中，内嵌了 3*4 阵列的滤波光电二极管和 16 位模拟转转换器。在 12 个光电二极管中，3个具有红色滤光片，3个具有绿色滤光片，3个具有蓝色滤光片，3个没有滤光片（透明）。 + + + + +检测物体颜色时，TCS3472 会返回四个通道数据 - 红色（R），绿色（G），蓝色（B）和清除（C）（未过滤）。红色，绿色和蓝色通道（RGB）的响应可用于确定特定光源的色度坐标（x，y）。 + + + +色度计算过程概述： + + + +最终得到色度坐标（x，y），之后参考下图，以获得推荐的颜色。 + + + + +该 Unit 与 M5Core 通过 GROVE A 接口 ( IIC ) 通信，其 I2C 地址是 0x29 。 + ## 特性 -- 高精度 -- 检测的适用温度范围: 0℃~80℃ -- Unit上配置两个乐高安装孔 +- +- 工作温度范围: -40℃~85℃ +- GROVE 接口，支持 [UIFlow](http://flow.m5stack.com) 编程，[Arduino](http://www.arduino.cc) 编程 +- Unit 内置两个 Lego 插件孔，方便与 Lego 件结合 + +## 包含 + +- 1x COLOR Unit +- 1x Grove 线 ## 应用 -- RGB LED背光灯控制 -- 产品颜色验证 +- 产品颜色验证 +- 颜色追踪机器人 ## 文档 @@ -27,7 +56,7 @@ Color是一个颜色传感器. 通过GROVE接口(I2C)与M5Core相连，能够识 - **[官方论坛](http://forum.m5stack.com/)** -- **数据手册** - [TCS3472](https://pdf1.alldatasheet.com/datasheet-pdf/view/560511/AMSCO/TCS3472.html) +- **数据手册** - [TCS3472](https://ams.com/documents/20143/36005/TCS3472_DS000390_2-00.pdf) ## 例程 @@ -99,8 +128,8 @@ uint16_t _color = color16((int)r, (int)g, (int)b); --> ### 管脚映射 - - + +
M5Core(GROVE接口A)GPIO22GPIO215VGND
颜色传感器UnitSCLSDA5VGND
M5Core ( GROVE 接口 A )GPIO22GPIO215VGND
颜色传感器 UnitSCLSDA5VGND
## 相关视频 diff --git a/docs/zh_CN/unit/finger.md b/docs/zh_CN/unit/finger.md index fada0bc1..630899f9 100644 --- a/docs/zh_CN/unit/finger.md +++ b/docs/zh_CN/unit/finger.md @@ -26,6 +26,16 @@ - 输入电压范围: 3.3 ~ 6V - 工作温湿度范围: -10 ~ 60°, 20% ~ 80% --> +## 包含 + +- 1x FINGER Unit +- 1x Grove 线 + +## 应用 + +- 指纹考勤 +- 指纹锁 + ## 相关链接 - **[官方频道视频](https://i.youku.com/i/UNjE1ODA2MzE0OA==?spm=a2hzp.8253869.0.0)** diff --git a/docs/zh_CN/unit/makey.md b/docs/zh_CN/unit/makey.md index d27edd74..bd4e046e 100644 --- a/docs/zh_CN/unit/makey.md +++ b/docs/zh_CN/unit/makey.md @@ -10,7 +10,7 @@ **MAKEY** 是一款内置 MEGA328P 芯片、蜂鸣器和 RGB 灯的 Unit，并附带 16 个引脚。 -该 Unit 与 M5Core 通过 GROVE A 接口 ( IIC ) 通信，其 I2C 地址是 0x51 。。 +该 Unit 与 M5Core 通过 GROVE A 接口 ( IIC ) 通信，其 I2C 地址是 0x51 。 **使用方法：** diff --git a/docs/zh_CN/unit/pir.md b/docs/zh_CN/unit/pir.md index 14bbc22a..cb7c9a12 100644 --- a/docs/zh_CN/unit/pir.md +++ b/docs/zh_CN/unit/pir.md @@ -10,7 +10,7 @@ **PIR** 是一款集成小型人体感应模块的 Unit。用于感应人体活动的 Unit，通过该 Unit 可以感知 Unit 前面是否有人经过，适用于做人体感应方面的项目。 -其工作过程是感应到红外时输出高电平，在延时时间段内，如果有人体在其感应范围活动，其输出将一直保持高电平，直到人离开后才延时将高电平变为低电平 ( 感应模块检测到人体的每次活动后会自己顺延一个延时时间段，并且以最后一次活动的时间为延时时间的起始点 )。 +可重复触发方式：感应到红外时输出高电平，在延时时间段内，如果有人体在其感应范围活动，其输出将一直保持高电平，直到人离开后才延时将高电平变为低电平 ( 感应模块检测到人体的每次活动后会自己顺延一个延时时间段，并且以最后一次活动的时间为延时时间的起始点 )。 该 Unit 与 M5Core 通过 GROVE B 接口通信。 diff --git a/docs/zh_CN/unit/relay.md b/docs/zh_CN/unit/relay.md index f0461959..714d9573 100644 --- a/docs/zh_CN/unit/relay.md +++ b/docs/zh_CN/unit/relay.md @@ -1,4 +1,4 @@ -# RELAY - 继电器Unit {docsify-ignore-all} +# RELAY - 继电器 Unit {docsify-ignore-all} @@ -16,6 +16,16 @@ - GROVE 接口，支持 [UIFlow](http://flow.m5stack.com) 编程，[Arduino](http://www.arduino.cc) 编程 - Unit 内置两个 Lego 插件孔，方便与 Lego 件结合 +## 包含 + +- 1x RELAY Unit +- 1x Grove 线 + +## 应用 + +- 大功率电器远程遥控，如冰箱、空调、电视等 +- 高压电路的电子开关 + ## 相关链接 - **[官方频道视频](https://i.youku.com/i/UNjE1ODA2MzE0OA==?spm=a2hzp.8253869.0.0)** diff --git a/docs/zh_CN/unit/rs485.md b/docs/zh_CN/unit/rs485.md index e033220d..1b14c103 100644 --- a/docs/zh_CN/unit/rs485.md +++ b/docs/zh_CN/unit/rs485.md @@ -1,4 +1,4 @@ -# RS485 - TTL转RS485通信Unit {docsify-ignore-all} +# RS485 - TTL 转 RS485 通信 Unit {docsify-ignore-all} @@ -10,13 +10,13 @@ ## 描述 -**RS485** 是一个用于TTL电平转RS485电平的Unit，如果要控制的设备是RS485接口的话，将M5Core连接这个Unit之后，Unit就可以适配到这个设备的RS485接口，从而实现接口转换。这个Unit集成了RS-485/RS-422通信收发芯片MAX485/SP485EEN。 +**RS485** 是一个用于 TTL 电平转 RS485 电平的 Unit，如果要控制的设备是 RS485 接口的话，将 M5Core 连接这个 Unit 之后，Unit 就可以适配到这个设备的 RS485 接口，从而实现接口转换。这个 Unit 集成了 RS-485 / RS-422 通信收发芯片 MAX485 / SP485EEN。 ## 特性 -- 驱动最高12V的RS485设备 -- GROVE接口，支持[UIFlow](http://flow.m5stack.com)编程，[Arduino](http://www.arduino.cc)编程 -- Unit内置两个Lego插件孔，方便与Lego件结合 +- 驱动最高 12V 的 RS485 设备 +- GROVE 接口，支持 [UIFlow](http://flow.m5stack.com) 编程，[Arduino](http://www.arduino.cc) 编程 +- Unit 内置两个 Lego 插件孔，方便与 Lego 件结合 ## 包含 @@ -42,7 +42,7 @@ *以下仅为用法示意，并不完整。如果需要完整例程请点击[这里](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/EARTH/Arduino)。* 这是两个 M5Core 之间通过 RS485 相互收发数据的例程。 - + 分别下载[例程](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Module/COMMU/Arduino/RS485)到两个M5Core之后，按下按键 A，然后两个 core 之间会相互发送数据。 --> diff --git a/docs/zh_CN/unit/trace.md b/docs/zh_CN/unit/trace.md index 6333cb5c..5a2b3689 100644 --- a/docs/zh_CN/unit/trace.md +++ b/docs/zh_CN/unit/trace.md @@ -8,18 +8,26 @@ ## 描述 -**TRACE** 是一款内置 4 组光电对管和 MEGA328 芯片的巡线模块。 +**TRACE** 是一款内置 4 组红外发射 LED 和红外敏感光电晶体管的巡线 Unit。它可以将数字信号输出到微控制器，这样机器人可以稳定地跟随白色背景上的黑线，反之亦然。 + +该 Unit 与 M5Core 通过 GROVE A 接口 ( IIC ) 通信，其 I2C 地址是 0x5A 。 -TRACE Unit 同样也是通过 IIC 与主控通信，其I2C地址是0x5A。与 M5Core 相连时，接在 GROVE A 口。 - - ## 特性 - 工作范围：反射面距离光电对管面小于 11mm -- GROVE接口，支持[UIFlow](http://flow.m5stack.com)编程，[Arduino](http://www.arduino.cc)编程 +- GROVE 接口，支持 [UIFlow](http://flow.m5stack.com) 编程，[Arduino](http://www.arduino.cc) 编程 + +## 包含 + +- 1x TRACE Unit +- 1x Grove 线 + +## 应用 + +- 机器人巡线 ## 相关链接 @@ -27,7 +35,7 @@ TRACE Unit 同样也是通过 IIC 与主控通信，其I2C地址是0x5A。与 M5 - **[官方论坛](http://forum.m5stack.com/)** -- **[模块内MEGA328固件](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/TRACE/firmware_328p)** +- **[模块内 MEGA328 固件](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/TRACE/firmware_328p)** ## 例程