diff --git a/docs/assets/img/product_pics/atom_base/echo/Echo.webp b/docs/assets/img/product_pics/atom_base/echo/Echo.webp new file mode 100644 index 00000000..5febff8e Binary files /dev/null and b/docs/assets/img/product_pics/atom_base/echo/Echo.webp differ diff --git a/docs/assets/img/product_pics/atom_base/echo/echo_sch.webp b/docs/assets/img/product_pics/atom_base/echo/echo_sch.webp new file mode 100644 index 00000000..5b42cdfe Binary files /dev/null and b/docs/assets/img/product_pics/atom_base/echo/echo_sch.webp differ diff --git a/docs/assets/img/product_pics/core/basic/basic_01.webp b/docs/assets/img/product_pics/core/basic/basic_01.webp index 081db900..c2ef2ac0 100644 Binary files a/docs/assets/img/product_pics/core/basic/basic_01.webp and b/docs/assets/img/product_pics/core/basic/basic_01.webp differ diff --git a/docs/assets/img/product_pics/core/gray/gray_01.webp b/docs/assets/img/product_pics/core/gray/gray_01.webp index d8b9bc9d..2bc101ea 100644 Binary files a/docs/assets/img/product_pics/core/gray/gray_01.webp and b/docs/assets/img/product_pics/core/gray/gray_01.webp differ diff --git a/docs/en/accessory/servo_holder.md b/docs/en/accessory/servo_holder.md deleted file mode 100644 index eb68797b..00000000 --- a/docs/en/accessory/servo_holder.md +++ /dev/null @@ -1,55 +0,0 @@ -# SG90 Servo Holder - -
SKU:A076
- -
- -## Description - -**SG90 Servo Holder** is a 9g servo with LEGO fixed bracket.There are 180 ° and 360 ° specifications.The independent design of the fixed bracket can be easily disassembled, and the product is completely designed according to the LEGO standard unit,so that you can easily combine with LEGO series products, play unlimited creativity.The rudder plate is designed to be reopened without screw connection. It can be directly connected with LEGO parts. No matter 180 ° or 360 ° servo, it is very easy for beginners to use.Even if you don't know how to program, you can easily drive it with UIFlow.There is no need to use a dedicated servo-drive board with feedback control and a complicated gearbox. Any common pwm driver or a microcontroller can easily control this servo. Compared to driving a stepper motor, a servo is much simpler to use. You can use it to do interesting small projects requiring angular movement and/or control.The commonly used pulse width is 1-2ms (-90° position - 1ms , 0° position - 1.5ms, 90° position - 2ms)，working at 50Hz. Going beyond the specified pulse width range will damage the servo.If you feel that the cable is not long enough, you can purchase the servo extension cable to extend it. 180° servo has three connecting wires,yellow is signal line, brown is GND, red is 5V, 180° servo can only control angle.The 360° servo has two connecting lines, red is 5V, black is GND, 360° servo can't control the angle, but you can adjust the speed by controlling PWM.When using the steering gear, pay attention to the power supply current and voltage to prevent burnout. - -### Product Features - -- Gear material: plastic -- Weight： 9g -- Size： 23mm x 12.2mm x 29mm -- Torque： 1.6kg•cm/4.8V;1.8kg•cm/6.0V -- Speed： 0.1sec/60°/4.8V;0.09sec/60°/6.0v -- Cable length： 3cm -- dead zone： 4μm -- Spline： 21Teeth -- Voltage： 4.8-6.0V - -## Specification - - - - - - - - - - - - - - - - - - - - - - -
ResourcesParameter
net weightg
Gross weightg
Product Sizemm
Package Sizemm
- - \ No newline at end of file diff --git a/docs/en/accessory/servo_kit.md b/docs/en/accessory/servo_kit.md new file mode 100644 index 00000000..915786f5 --- /dev/null +++ b/docs/en/accessory/servo_kit.md @@ -0,0 +1,91 @@ +# Servo Kit 180°/360° + +
SKU:A076
+ +
+ +## Description + +**Servo Kit 180°/360°** is a 9g servo with LEGO fixed bracket.There are 180 ° or 360 ° specifications.The independent design of the fixed bracket can be easily disassembled, and the product is completely designed according to the LEGO standard unit,so that you can easily combine with LEGO series products, play unlimited creativity.The rudder plate is designed to be reopened without screw connection. It can be directly connected with LEGO parts. No matter 180 ° or 360 ° servo, it is very easy for beginners to use.Even if you don't know how to program, you can easily drive it with UIFlow.There is no need to use a dedicated servo-drive board with feedback control and a complicated gearbox. Any common pwm driver or a microcontroller can easily control this servo. Compared to driving a stepper motor, a servo is much simpler to use. You can use it to do interesting small projects requiring angular movement and/or control.The commonly used pulse width is 1-2ms (-90° position - 1ms , 0° position - 1.5ms, 90° position - 2ms)，working at 50Hz. Going beyond the specified pulse width range will damage the servo.If you feel that the cable is not long enough, you can purchase the servo extension cable to extend it. 180° servo has three connecting wires,yellow is signal line, brown is GND, red is 5V, 180° servo can only control angle.The 360° servo has two connecting lines, red is 5V, black is GND, 360° servo can't control the angle, but you can adjust the speed by controlling PWM.When using the steering gear, pay attention to the power supply current and voltage to prevent burnout. + +### Product Features + +- Gear material: plastic +- Weight： 9g +- Size： 23mm x 12.2mm x 29mm +- Torque： 1.6kg•cm/4.8V;1.8kg•cm/6.0V +- Speed： 0.1sec/60°/4.8V;0.09sec/60°/6.0v +- Cable length： 3cm +- dead zone： 4μm +- Spline： 21Teeth +- Voltage： 4.8-6.0V + +## Include + +- 2x SG90 Servo 180° or 360° +- 2x GROVE2SERVO adapter +- 2x Elastic +- 2x Fixed base of servo +- 2x Special steering wheel +- 2x Axle connector +- 4x Conncetor peg with friction +- 1x Frame 5x7-module +- 2x Servo accessories package +- 2x M2*4mm self tapping screw + +## Specification + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ResourcesParameter
Gear materialMetal motor teeth, plastic gearbox
Gross weight49g
net weight44g
Gross weight49g
net weight44g
Gross weight49g
Product Size40*12*36mm
Package Size73*45*23mm
+ + ## Video + + + + + \ No newline at end of file diff --git a/docs/en/atom/atomecho.md b/docs/en/atom/atomecho.md index 18885de7..d79b5a8e 100644 --- a/docs/en/atom/atomecho.md +++ b/docs/en/atom/atomecho.md @@ -1,25 +1,28 @@ -# M5AtomECHO +# ATOM ECHO -
SKU:E001
+
SKU:C008-C
-
+
## Description -**M5AtomECHO** is a Programmable Smart Speaker designed based on ATOM. Its volume is very small, only 24 * 24 * 17 mm. Music can be played by bluetooth of ESP32 with mobile phones and tablets. Of course, you can access AWS, Baidu and other cloud platforms by writing code, and use built-in microphone and speaker for voice interaction, so that M5AtomECHO has certain AI capabilities, realizing voice control, story telling, Internet of things and other functions. The speaker is embedded with an RGB LED (SK6812), which can visually display the connection status. In addition to being used as a Bluetooth speaker, it still has the control ability of Atom series. You can connect devices through the grove interface, G21 / G25 can only be used for general I/O, they do not support I2C and UART.Screw hole on the back is convenient for users to fix. +**ATOM ECHO** is a programmable smart speaker designed based on ATOM. It has a small size with only 24 * 24 * 17 mm. Music can be played by bluetooth of ESP32 with mobile phones and tablets, and you can also play the specified streaming music through WiFi. In order to facilitate the usage of speech function, we have integrated STT (speech to text) service in ATOM ECHO. You can use this function by burning the specified firmware, and complete various operations by voice command. Of course, you can access AWS, GOOGLE and other cloud platforms by writing code and using built-in microphone and speaker for speech interaction. In that way, ATOM ECHO possesses certain AI capabilities like realizing voice control, intelligent conversation, internet of things and other functions. The speaker is embedded with an RGB LED (SK6812) which can visually display the connection status. In addition to being used as a bluetooth speaker, it still has the control ability of ATOM series. You can connect the device through the GROVE interface. G21 / G25 can only be used for general I/O, they do not support I2C and UART. cScrew hole on the back is convenient for users to fix. -?> **Note: the product can not be used for a long time. It is recommended to play music for about 1 hour. It is not allowed to play low-frequency and heavy music, otherwise the speaker will be damaged.** +?>**Note: the product can not be used for a long time. It is recommended to play music for about 1 hour. It is not allowed to play low-frequency and heavy music, otherwise the speaker will be damaged.** ## Product Features - Light and small -- Based on esp32, Support A2DP, BLE 4.0 +- Support STT services +- Based on ESP32, Support A2DP, BLE 4.0 - 2.4G WiFi IEEE 802.11b/g/n - Built-in microphone and speaker - RGB LED status display indication - GROVE extension interface - Record and playback - Programmable key +- Programming platform:Arduino、ESP-IDF/ADF + ## Include @@ -108,7 +111,7 @@
@@ -148,10 +151,11 @@ - **Datasheet** - [SPM1423](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/core/SPM1423HM4H-B_datasheet_en.pdf) - [ESP32-PICO-D4](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/core/esp32-pico-d4_datasheet_en.pdf) + - [NS4168](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/core/NS4168_CN_datasheet.pdf) ## Schematic -- [BASIC](https://) + ## Usage @@ -169,15 +173,18 @@ The factory default firmware is Bluetooth speaker, which uses A2DP protocol to t ## Video +**The following video is an example** + diff --git a/docs/en/quick_start/atom/atom_echo_quick_start.md b/docs/en/quick_start/atom/atom_echo_quick_start.md index 6daae8ea..b446f3c0 100644 --- a/docs/en/quick_start/atom/atom_echo_quick_start.md +++ b/docs/en/quick_start/atom/atom_echo_quick_start.md @@ -24,7 +24,7 @@ As**G19/G22/G23/G33**is used as I2S, it can not be reused as other function pins ## EchoSTT service -EchoSTT is a speech to text service, which sends the local speech to the cloud server through the network and returns the recognition results to the local device. Whether you use this service in UIFlow or Arduino, you need to bind token through MAC address to obtain permission. The specific steps are as follows: +EchoSTT is a speech to text service, which sends the local speech to the cloud server through the network and returns the recognition results to the local device. Whether you use this service in UIFlow, you need to bind token through MAC address to obtain permission. The specific steps are as follows: - Go to [Official website](https://m5stack.com/pages/download)to download latest version M5Burner(2.0.0 and above) @@ -46,7 +46,9 @@ Before running this example, make sure that you have completed the above steps t ## Arduino example for EchoSTT services -When using this example, you need to rest.settoken("your_Token"); fill in the acquired token. + + +When using this example, you need to input WIFI SSID and PASSWORD，get token through M5Burner，then find rest.settoken("your_Token"); fill in the acquired token. - [EchoSTT services](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Core/Atom/AtomEcho/Arduino/EchoSTT) diff --git a/docs/en/uiflow/advanced.md b/docs/en/uiflow/advanced.md index 70e29426..88fb484f 100644 --- a/docs/en/uiflow/advanced.md +++ b/docs/en/uiflow/advanced.md @@ -40,6 +40,8 @@ **[Blynk](#Blynksupport-M5Stack-Fire-only)** +**[Echo STT](#Echo-STT)** + # Remote #### Function Description @@ -844,4 +846,25 @@ Callback function when Bluetooth is connected / disconnected > -> \ No newline at end of file +> + +# Echo STT + +>Send speech through ATOM Echo to obtain the converted text + +> + +* __Init echo speech recognition token__ +Input token and initialize speech service. + +* __Recv echo data__ +Callback function receives data returned by speech recognition. + +* __Get recv text__ +Receive data from speech recognition. + +#### USAGE + +>ATOM Echo flash related ECHO STT firmware and controls led through speech recognition by M5StackFire. + +> \ No newline at end of file diff --git a/docs/image/Advanced module/EchoSTT.webp b/docs/image/Advanced module/EchoSTT.webp new file mode 100644 index 00000000..ee3a8c68 Binary files /dev/null and b/docs/image/Advanced module/EchoSTT.webp differ diff --git a/docs/image/Advanced module/echo_stt.webp b/docs/image/Advanced module/echo_stt.webp new file mode 100644 index 00000000..3b5b12bb Binary files /dev/null and b/docs/image/Advanced module/echo_stt.webp differ diff --git a/docs/index.md b/docs/index.md index 51fcca48..35e83547 100644 --- a/docs/index.md +++ b/docs/index.md @@ -23,6 +23,7 @@ //ATOM {a:"/#/en/core/atom_lite", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/core/atom_lite_01.webp", p:"ATOM Lite", sku:"C008" ,kw:"ESP32 LED"}, {a:"/#/en/core/atom_matrix", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/core/atom_matrix_01.webp", p:"ATOM Matrix", sku:"C008-B" ,kw:"ESP32 LED MPU6886"}, + {a:"/#/en/atom/atomecho", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/core/atom_echo.webp", p:"ATOM ECHO", sku:"C008-C" ,kw:"ESP32 Speaker I2S"}, //ATOM BASE {a:"/#/en/atom/atomic", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/atom_base/atomic_01.webp", p:"ATOMIC", sku:"A077" ,kw:"PROTOTYPE"}, {a:"/#/en/atom/tail485", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/atom_base/tail485_01.webp", p:"Tail485", sku:"T002" ,kw:"RS485"}, diff --git a/docs/zh_CN/README.md b/docs/zh_CN/README.md index acd932c6..284f2a33 100644 --- a/docs/zh_CN/README.md +++ b/docs/zh_CN/README.md @@ -24,6 +24,7 @@ //ATOM {a:"/#/zh_CN/core/atom_lite", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/core/atom_lite_01.webp", p:"ATOM Lite", sku:"C008" ,kw:"ESP32 LED"}, {a:"/#/zh_CN/core/atom_matrix", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/core/atom_matrix_01.webp", p:"ATOM Matrix", sku:"C008-B" ,kw:"ESP32 LED MPU6886"}, + {a:"/#/zh_CN/core/atomecho", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/core/atom_echo.webp", p:"ATOM ECHO", sku:"C008-C" ,kw:"ESP32 Speaker I2S"}, //ATOM BASE {a:"/#/zh_CN/atom/atomic", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/atom_base/atomic_01.webp", p:"ATOMIC", sku:"A077" ,kw:"PROTOTYPE"}, {a:"/#/zh_CN/atom/tail485", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/atom_base/tail485_01.webp", p:"Tail485", sku:"T002" ,kw:"RS485"}, diff --git a/docs/zh_CN/accessory/servo_holder.md b/docs/zh_CN/accessory/servo_holder.md deleted file mode 100644 index db256f83..00000000 --- a/docs/zh_CN/accessory/servo_holder.md +++ /dev/null @@ -1,63 +0,0 @@ -# SG90 Servo Holder - -
SKU:A076
- -
- -## 描述 - -**SG90 Servo Holder** 是一款带有乐高固定支架的9g舵机，有180°与360°两种规格.独立设计的固定支架可以方便的拆装，产品完全按照乐高标准单位设计，使得您可以轻易的与乐高系列产品进行结合，发挥无限的创造力。舵盘重新开模设计，免去了螺丝连接的方式，可以直接用乐高零件进行连接。无论180°还是360°舵机，对于初学者来说非常容易使用，即使你不懂得代码也可以用UIFlow轻松的驱动它，工作频率50Hz -，脉冲宽度在1-2ms，0°位置（1.5ms），-90°位置（1ms），90°位置（2ms）超出脉宽范围会使舵机损坏。180°舵机有三根连接线，黄色为信号线，棕色为GND，红色为5V，180°舵机仅能控制角度；360°舵机有两根连接线，红色为5V，黑色为GND，360°舵机无法控制角度但你可以通过控制PWM对它进行调速。舵机使用时注意供电电流和电压防止被烧毁。 - -## 产品特性 - -- 规格: - - 齿轮材质： 塑胶齿 - - 重量： 9g - - 尺寸： 23mm x 12.2mm x 29mm - - 扭力： 1.6kg•cm/4.8V;1.8kg•cm/6.0V - - 速度： 0.1sec/60°/4.8V;0.09sec/60°/6.0V - - 线长： 3cm - - 死区： 4μm - - 花键： 21T - - 电压： 4.8-6.0V - -## 包含 - -- 1x SG90 servo -- 1x 固定连接件 -- 1x 定制舵盘 - -## 规格参数 - - - - - - - - - - - - - - - - - - - - - - -
规格参数
净重g
毛重g
产品尺寸mm
包装尺寸mm
- - \ No newline at end of file diff --git a/docs/zh_CN/accessory/servo_kit.md b/docs/zh_CN/accessory/servo_kit.md new file mode 100644 index 00000000..7df5f10a --- /dev/null +++ b/docs/zh_CN/accessory/servo_kit.md @@ -0,0 +1,105 @@ +# Servo Kit 180°/360° + +
SKU:A076
+ +
+ +## 描述 + +**Servo Kit 180°/360°** 是一款带有乐高固定支架的9g舵机，有180°与360°两种规格.独立设计的固定支架可以方便的拆装，产品完全按照乐高标准单位设计，使得您可以轻易的与乐高系列产品进行结合，发挥无限的创造力。舵盘重新开模设计，免去了螺丝连接的方式，可以直接用乐高零件进行连接。无论180°还是360°舵机，对于初学者来说非常容易使用，即使你不懂得代码也可以用UIFlow轻松的驱动它。180°舵机有三根连接线，黄色为信号线，棕色为GND，红色为5V，180°舵机仅能控制角度；360°舵机有两根连接线，红色为5V，黑色为GND，360°舵机无法控制角度但你可以通过控制PWM对它进行调速。舵机使用时注意供电电流和电压防止被烧毁。 + +## 产品特性 + +- 微型伺服系统 +- 兼容乐高 +- 控制简单 +- 支持Arduino、UIFlow + +## 包含 + +- 2x SG90 Servo 180° or 360° +- 2x GROVE2SERVO转接器 +- 2x 橡皮筋 +- 2x 舵机固定连接件 +- 2x 定制带孔舵盘 +- 2x 十字轴连接器 +- 4x 黑销 +- 1x 5x7方形框梁 +- 2x 舵机配件包 +- 2x M2*4mm自攻螺丝 + +## 规格参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
规格参数
齿轮材质金属马达齿、塑料齿轮箱
舵机重量9g
扭力1.6kg•cm/4.8V;1.8kg•cm/6.0V
180舵机速度0.1sec/60°/4.8V;0.09sec/60°/6.0V
齿轮材质金属马达齿、塑料齿轮箱
线长3cm
死区4μm
花键21T
电压4.8-6.0V
净重44g
毛重49g
产品尺寸40*12*36mm
包装尺寸73*45*23mm
+ + ## 相关视频 + + + + \ No newline at end of file diff --git a/docs/zh_CN/app/balac.md b/docs/zh_CN/app/balac.md index f0272cab..91c60f88 100644 --- a/docs/zh_CN/app/balac.md +++ b/docs/zh_CN/app/balac.md @@ -24,13 +24,13 @@ - 1x M5StickC - 1x BalaC Base -- 2x Wheel -- 2x Wheel Connector -- 2x 9G Servo -- 2x Elastic -- 2x Screw -- 1x Hex key -- 1x 16340 Battery +- 2x 轮胎 +- 2x 轮胎适配器 +- 2x 9G 舵机 +- 2x 橡皮筋 +- 2x 螺丝 +- 1x 内六角扳手 +- 1x 16340 电池 - 1x 10cm Type-C Cable ## 应用 diff --git a/docs/zh_CN/atom/atomecho.md b/docs/zh_CN/atom/atomecho.md index 4c373af8..c887bb21 100644 --- a/docs/zh_CN/atom/atomecho.md +++ b/docs/zh_CN/atom/atomecho.md @@ -1,25 +1,27 @@ # ATOM ECHO -
SKU:E001
+
SKU:C008-C
-
+
## 描述 -**ATOM ECHO**是一款基于ATOM设计的可编程智能音箱，它的体积非常小巧，只有24*24*17毫米，通过ESP32自带的蓝牙功能与手机、平板等进行连接即可播放音乐。当然，你可以通过编写代码接入AWS、百度等云平台，使用内置麦克风和扬声器进行语音交互，使得ATOM ECHO具备一定的AI能力，实现语音控制、讲故事、物联网等功能。音箱内嵌一颗RGB LED（SK6812)，可以直观的显示连接状态。除了可以作为蓝牙音箱使用外，它依然具备了ATOM系列的控制能力，你可以通过GROVE接口连接外部设备，G21/G25仅能用于通用IO，不支持UART与I2C。其背面有一个M2螺丝孔，方便用户进行固定。 +**ATOM ECHO**是一款基于ATOM设计的可编程智能音箱，它的体积非常小巧，只有24*24*17毫米，通过ESP32自带的蓝牙功能与手机、平板等进行连接即可播放音乐，也可以通过WIFI播放指定的流媒体音乐。为了方便用户使用语音功能，我们在ATOM ECHO内集成了STT(语音转文字)服务，您可以通过烧录指定固件开启该功能，通过语音下达指令完成多样化的操作。当然，您还可以通过自行编写代码接入AWS、GOOGLE等云平台，使用内置麦克风和扬声器进行语音交互，使得ATOM ECHO具备一定的AI能力，实现语音控制、智能对话、物联网等功能。音箱内嵌一颗RGB LED（SK6812)，可以直观的显示连接状态。除了可以作为智能音箱使用外，它依然具备了ATOM系列的控制能力，你可以通过GROVE接口连接外部设备，G21/G25仅能用于通用IO，不支持UART与I2C。其背面有一个M2螺丝孔，方便用户进行固定。 ?> **注意：产品不可长时间使用，音乐播放建议在1小时左右，不可播放低频过重的音乐，否则将损坏扬声器。** ## 产品特性 - 轻便小巧 +- 支持STT服务 - 基于ESP32,支持A2DP、BLE 4.0 -- IEEE 802.11b/g/n +- WIFI协议 IEEE 802.11b/g/n - 内置麦克风与扬声器 - RGB LED状态显示 - GROVE扩展接口 - 录音与声音回放 - 独立可编程按键 +- 编程平台:Arduino、ESP-IDF/ADF ## 包含 @@ -110,7 +112,7 @@
@@ -126,6 +128,7 @@ - **Datasheet** - [SPM1423](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/core/SPM1423HM4H-B_datasheet_en.pdf) - [ESP32-PICO-D4](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/core/esp32-pico-d4_datasheet_en.pdf) + - [NS4168](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/core/NS4168_CN_datasheet.pdf) ### 管脚映射 @@ -136,7 +139,7 @@ ## 原理图 - + ## 使用方法 @@ -157,10 +160,9 @@ - [EchoSTT服务](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Core/Atom/AtomEcho/Arduino/EchoSTT) - ## 相关视频 -**Demo** +**以下视频为案例演示**