diff --git a/.gitignore b/.gitignore index 455906f2..1d810621 100644 --- a/.gitignore +++ b/.gitignore @@ -4,3 +4,4 @@ docs/.DS_Store docs/zh_CN/hat/.DS_Store docs/zh_CN/.DS_Store *.icloud + diff --git a/docs/assets/img/product_pics/module/com.x_gps/com.x_gps_sch.webp b/docs/assets/img/product_pics/module/com.x_gps/com.x_gps_sch.webp new file mode 100644 index 00000000..4d43928a Binary files /dev/null and b/docs/assets/img/product_pics/module/com.x_gps/com.x_gps_sch.webp differ diff --git a/docs/assets/img/product_pics/module/com.x_gps/comx_gps.webp b/docs/assets/img/product_pics/module/com.x_gps/comx_gps.webp new file mode 100644 index 00000000..242e3cc0 Binary files /dev/null and b/docs/assets/img/product_pics/module/com.x_gps/comx_gps.webp differ diff --git a/docs/assets/img/product_pics/unit/a_meter/ameter.webp b/docs/assets/img/product_pics/unit/a_meter/ameter.webp new file mode 100644 index 00000000..c2026094 Binary files /dev/null and b/docs/assets/img/product_pics/unit/a_meter/ameter.webp differ diff --git a/docs/assets/img/product_pics/unit/mic/mic.webp b/docs/assets/img/product_pics/unit/mic/mic.webp new file mode 100644 index 00000000..dcfa38ad Binary files /dev/null and b/docs/assets/img/product_pics/unit/mic/mic.webp differ diff --git a/docs/assets/img/product_pics/unit/v_meter/vmeter.webp b/docs/assets/img/product_pics/unit/v_meter/vmeter.webp new file mode 100644 index 00000000..6d29b381 Binary files /dev/null and b/docs/assets/img/product_pics/unit/v_meter/vmeter.webp differ diff --git a/docs/en/faq.md b/docs/en/faq.md index afb45fda..cd9e8a15 100644 --- a/docs/en/faq.md +++ b/docs/en/faq.md @@ -105,7 +105,7 @@
Q4: Does the M5Stack device support Chinese display?

- Support for GB2312 code display in Arduino environment, refer to the hzk16 example in Display, which is limited by the execution speed and UTF-8 file size in Micropython environment. + Support for GB2312 code display in Arduino environment, refer to the hzk16 example in Display, UIFlow support it.
diff --git a/docs/en/module/comx_gps.md b/docs/en/module/comx_gps.md index 95ca612b..42e765e6 100644 --- a/docs/en/module/comx_gps.md +++ b/docs/en/module/comx_gps.md @@ -1,8 +1,8 @@ # COM.GPS -SKU:M003 +SKU:M031-G -
+
## Description @@ -152,7 +152,7 @@ For more information,please refer to [u-blox 8 / u-blox M8 Receiver Description ## Schematic - + \ No newline at end of file diff --git a/docs/en/unit/ameter.md b/docs/en/unit/ameter.md new file mode 100644 index 00000000..8677cd05 --- /dev/null +++ b/docs/en/unit/ameter.md @@ -0,0 +1,165 @@ +# Ammeter Unit{docsify-ignore-all} + +SKU:U086 + +
+ +## Description + +**Ammeter Unit** is a current meter that can monitor the current in real time. The 16-bit ADC (analog-to-digital) converter ADS1115 is used internally to communicate through I2C (0X48). In order to ensure the measurement accuracy, there is a built-in DC-DC isolated power supply, and the I2C interface is also electrically isolated through the low-power isolator CA-IS3020S. This prevents noise and surges on the data bus or other circuits from entering the local ground terminal to interfere or damage sensitive circuits. Each Unit is individually calibrated when leaving the factory, with an effective accuracy of ±1999 (3 digits after the decimal point) The unit has a maximum measurement current of ±4A, and an internal integrated 4A fuse to prevent excessive measurement current from burning out the circuit. Minimal Resolution reaches 0.15626mA. + +>? EEPROM (0x51) has built-in calibration parameters when leaving the factory. Please do not write to the EEPROM, otherwise the calibration data will be overwritten and the measurement results will be inaccurate. + +## Product Features + +- ±4A range +- 16-bit ADC conversion +- LED power indicator +- Overcurrent protection +- Minimal Resolution(mA) reaches 0.15626 +- No recalibration (EEPROM factory write) +- Accuracy up to ±1999 +- Built-in CA-IS3020S isolation chip, anti-interference +- Isolated DC-DC +- Up to 5000 VRMS isolation withstand voltage +- Development platform: Arduino, UIFlow (Blockly, Pyhton) +- 2x LEGO compatible holes + +## Includes + +- 1x Ammeter Unit +- 1x Grove Cable + +## Application + +- galvanometer + +## Specification + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ResourcesParameter
Withstand voltage5000V
Measuring range±4A
ProtocolI2C
Net Weight9g
Gross Weight24g
Product Size65*24*8mm
Package Size67*53*12mm
+ + ## Measurement Range Gain Setting + +**Different range resolution is different, the error value of the result is different, please set the appropriate range according to the needs.Do not write EEPROM.If you really want to save the custom calibration values to EEPROM，Using the following statement, the factory data will be lost once written** + +```Arduino + +bool Ammeter::saveCalibration2EEPROM(ammeterGain_t gain, int16_t hope, int16_t actual) + +//@Parameter: ammeterGarin_t gain //Set Gain +########################################### +# // | PAG | Max Input Voltage(V) | # +# // | PAG_4096 | 64 | # +# // | PAG_2048 | 32 | # +# // | PAG_512 | 16 | # +# // | PAG_256 | 8 | # +########################################### +//@Parameter: int16_t hope // Set target value +//@Parameter: int16_t actual //ADC raw value + +``` + + + + +
ADC1115_Reference calibrationCalibration current(A)Expected reading(int16)
PGA512(O.512)26400
+ + + + + + + + +
Current measurement rangeMaximum input current(A)Power Disspation(W)Minimum resolution(mA)Gain factor
4.09640.9683.886082.50.125
2.04820.4820.971521.250.0625
1.02410.245.242880.6250.03125
0.5125.121.310720.31250.015625
0.2562.560.327680.156260.007813
+ + +## EasyLoader + +>EasyLoader is a concise and fast program writer, which has a built-in case program related to the product. It can be burned to the main control by simple steps to perform a series of function verification. Please install the corresponding driver according to the device type. M5Core host [Please click here to view the CP210X driver installation tutorial](en/arduino/arduino_development), M5StickC/V/T/ATOM series can be used without driver) + +
+
+
+
+ Windows + MacOS +
+
+
+ +
+ + +

Description:

+

Measuring current, gear 0.512, maximum input current 5A, analog pointer shows range 2A

+
+
+
+ +## Related Link + +- **Datasheet** + - [CA-IS3020S](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/CA-IS3020S.pdf) + - [ADS1115](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/ADS1115.PDF) + +## Schematic + + + +### PinMap + + + + +
M5Core(GROVE A)SDA(GPIO21)SCL(GPIO22)5VGND
A Meter UnitSDASCL5VGND
+ +## Example + +### 1. Arduino IDE + +[Click here to download the Arduino example](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/A_Meter_Unit) + + \ No newline at end of file diff --git a/docs/en/unit/mic.md b/docs/en/unit/mic.md new file mode 100644 index 00000000..b208966d --- /dev/null +++ b/docs/en/unit/mic.md @@ -0,0 +1,127 @@ +# Microphone Unit{docsify-ignore-all} + +SKU:U096 + +
+ +## Description + +**Microphone Unit** is a sound sensor with a built-in omni-directional electret microphone. The signal is amplified and output by microphone preamplifier max4466. The amplifier can effectively suppress power supply noise and common mode noise, and the output signal has high sound recovery and can be used in noisy environments. The unit can not only output analog signals, but also output digital level signals. The built-in LM393 double voltage comparator can set the comparison voltage threshold by adjusting 10K adjustable resistance. The sensor is very suitable for acoustic electrical conversion, audio recording / sampling, FFT acoustic feedback, voice switch and other projects.. + +## Product Features + +- Audio record/sample +- Built-in microphone preamplifier MAX4466 +- Omnidirectional, 52dB sensitivity +- Digital output and analog signal +- Built-in dual independent precision voltage comparator and adjustable resistor, threshold adjustable +- Development platform: Arduino, UIFlow (Blocky, Python) +- HY2.0-4P interface +- 2X LEGO™ compatible holes + +## Include + +- 1x Microphone Unit +- 1x Grove Cable + +## Applications + +- FFT Spectrum Display +- Audio Sample / Record +- Voice Switch + +## Specification + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ResourcesParameter
Microphone sensitivity / SNR52dB/40dB
Output SignalAnalog / digital
Working Voltage3.3V
Net weight5g
Gross weight16g
Product Size32*24*8mm
Package Size67*53*12mm
+ +## EasyLoader + +>EasyLoader is a concise and fast program writer, which has a built-in case program related to the product. It can be burned to the main control by simple steps to perform a series of function verification. Please install the corresponding driver according to the device type. M5Core host [Please click here to view the CP210X driver installation tutorial](en/arduino/arduino_development), M5StickC/V/T/ATOM series can be used without driver) + +
+
+
+
+ Windows + MacOS + +
+
+
+ +
+ + +

Description:

+

Display the AD value collected by the microphone

+
+
+
+ +## Related Link + +- **Datasheet** + - [MAX4466](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/MAX4466_V2.PDF) + - [LM393](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/LM393.PDF) + +## Schematic + + + +### Pin Map + + + + +
M5Core(PORT BGPIO26GPIO365VGND
Mic Unit26365VGND
+ +## Example + +### 1. Arduino IDE + +To get complete code, please click [here](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/MIC_Unit) + + \ No newline at end of file diff --git a/docs/en/unit/vmeter.md b/docs/en/unit/vmeter.md new file mode 100644 index 00000000..6d60b2bf --- /dev/null +++ b/docs/en/unit/vmeter.md @@ -0,0 +1,164 @@ +# Voltmeter Unit{docsify-ignore-all} + +SKU:U087 + +
+ +## Description + +**Voltmeter Unit** is a voltage meter that can monitor the voltage in real time. The 16-bit ADC (analog-to-digital) converter ADS1115 is used internally to communicate through I2C (0X49). In order to ensure the measurement accuracy, there is a built-in DC-DC isolated power supply, and the I2C interface is also electrically isolated through the low-power isolator CA-IS3020S. This prevents noise and surges on the data bus or other circuits from entering the local ground terminal to interfere or damage sensitive circuits. Each Unit is individually calibrated when leaving the factory, with an effective accuracy of ±1999 (3 digits after the decimal point), and a maximum measurement voltage of ±36V. Minimal Resolution reaches 0.490798455 mV. + +>? EEPROM (0x53) has built-in calibration parameters when leaving the factory. Please do not write to the EEPROM, otherwise the calibration data will be overwritten and the measurement results will be inaccurate. + +## Product Features + +- ±36V range +- LED power indicator +- 16-bit ADC conversion +- Overcurrent protection +- No recalibration (EEPROM factory write) +- Accuracy up to ±1999 +- Minimal Resolution(mV) reaches 0.490798455 +- Built-in CA-IS3020S isolation chip, anti-interference +- Isolated DC-DC +- Up to 5000 VRMS isolation withstand voltage +- Development platform: Arduino, UIFlow (Blockly, Python) +- 2x LEGO™ compatible holes +## Includes + +- 1x Voltmeter Unit +- 1x Grove Cable + +## Application + +- voltmeter + +## Specification + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ResourcesParameter
Withstand voltage5000V
Measuring range±36V
ProtocolI2C
Net Weight9g
Gross Weight24g
Product Size65*24*8mm
Package Size67*53*12mm
+ +## Measurement Range Gain Setting + +**Different range resolution is different, the error value of the result is different, please set the appropriate range according to the needs.Do not write EEPROM.If you really want to save the custom calibration values to EEPROM，Using the following statement, the factory data will be lost once written** + +```Arduino + +bool Voltmeter::saveCalibration2EEPROM(voltmeterGain_t gain, int16_t hope, int16_t actual) + +//@Parameter: voltmeterGarin_t gain //Set Gain +########################################### +# // | PAG | Max Input Voltage(V) | # +# // | PAG_4096 | 64 | # +# // | PAG_2048 | 32 | # +# // | PAG_512 | 16 | # +# // | PAG_256 | 8 | # +########################################### +//@Parameter: int16_t hope // Set target value +//@Parameter: int16_t actual //ADC raw value + +``` + + + + + +
ADC1115_Reference calibrationCalibration voltage(V)Expected reading(int16)
PGA4096(4.096)607641
PGA512(0.512)55094
+ + + + + + + + +
Voltage measurement rangeMaximum input voltage(V)Minimum resolution(mV)Gain factor
4.096128.65163647.8522727270.125
2.04864.325818183.9261363640.0625
1.02432.162909091.9630681820.03125
0.51216.081454550.9815340910.015625
0.2568.0407272730.4907984550.007813
+ +## EasyLoader + +>EasyLoader is a concise and fast program writer, which has a built-in case program related to the product. It can be burned to the main control by simple steps to perform a series of function verification. Please install the corresponding driver according to the device type. M5Core host [Please click here to view the CP210X driver installation tutorial](en/arduino/arduino_development), M5StickC/V/T/ATOM series can be used without driver) + +
+
+
+
+ Windows + MacOS +
+
+
+ +
+ + +

Description:

+

Measuring voltage, gear 0.512, maximum measuring voltage 16V, analog pointer indicating range 5V

+
+
+
+ +## Related Link + +- **Datasheet** + - [CA-IS3020S](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/CA-IS3020S.pdf) + - [ADS1115](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/ADS1115.PDF) + +## Schematic + + + +### PinMap + + + + +
M5Core(GROVE A)SDA(GPIO21)SCL(GPIO22)5VGND
V Meter UnitSDASCL5VGND
+ +## Example + +### 1. Arduino IDE + +[Click here to download the Arduino example](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/V_Meter_Unit) + + \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 74e1329a..b400385a 100644 --- a/docs/index.md +++ b/docs/index.md @@ -70,7 +70,8 @@ const module_list = [ //Communication Modules - {a:"/#/en/module/comx_gsm", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_gsm.webp", p:"COM.GSM", sku:"M031-D" ,kw:"SIM800C", category:"Communication Modules"}, + {a:"/#/en/module/comx_gps", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/module/comx_gps.webp", p:"COM.GPS", sku:"M031-G" ,kw:"GPS M8N", category:"Communication Modules"}, + {a:"/#/en/module/comx_gsm", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_gsm.webp", p:"COM.GSM", sku:"M031-D" ,kw:"SIM800C"}, {a:"/#/en/module/comx_lorawan", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_lorawan.webp", p:"COM.LoRaWAN", sku:"M031-C" ,kw:"LoRaWAN"}, {a:"/#/en/module/comx_lte", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_lte.webp", p:"COM.LTE(4G)", sku:"M031-A" ,kw:"LTE COMX"}, {a:"/#/en/module/comx_lte-data", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_lte-data.webp", p:"COM.LTE-DATA", sku:"M031-E" ,kw:"LTE-DATA COMX"}, @@ -119,10 +120,13 @@ const unit_list = [ //Sensor class - {a:"/#/en/unit/earth", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_earth_01.webp", p:"EARTH", sku:"U019" ,kw:"SENSOR", category:"Sensor class"}, + {a:"/#/en/unit/mic", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/unit/mic.webp", p:"Microphone", sku:"U096" ,kw:"MIC SOUND SENSOR", category:"Sensor class"}, + {a:"/#/en/unit/ameter", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/unit/ameter.webp", p:"Ammeter", sku:"U086" ,kw:"AMETER SENSOR"}, + {a:"/#/en/unit/vmeter", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/unit/vmeter.webp", p:"Voltmeter", sku:"U087" ,kw:"VMETER VOLT SENSOR"}, + {a:"/#/en/unit/earth", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_earth_01.webp", p:"EARTH", sku:"U019" ,kw:"EARTH SENSOR",}, {a:"/#/en/unit/env", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_env_01.webp", p:"ENV", sku:"U001" ,kw:"DHT12 BMP280"}, - {a:"/#/en/unit/light", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_light_01.webp", p:"LIGHT", sku:"U021" ,kw:"SENSOR"}, - {a:"/#/en/unit/pir", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_pir_01.webp", p:"PIR", sku:"U004" ,kw:"SENSOR"}, + {a:"/#/en/unit/light", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_light_01.webp", p:"LIGHT", sku:"U021" ,kw:"LIGHT SENSOR"}, + {a:"/#/en/unit/pir", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_pir_01.webp", p:"PIR", sku:"U004" ,kw:"PIR SENSOR"}, {a:"/#/en/unit/ncir", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_ncir_01.webp", p:"NCIR", sku:"U028" ,kw:"MLX90614"}, {a:"/#/en/unit/thermal", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_thermal_01.webp", p:"THERMAL", sku:"U016" ,kw:"MLX90640"}, {a:"/#/en/unit/color", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_color_01.webp", p:"COLOR", sku:"U009" ,kw:"TCS3472 SENSOR"}, diff --git a/docs/zh_CN/README.md b/docs/zh_CN/README.md index 8b111e33..d7be4a16 100644 --- a/docs/zh_CN/README.md +++ b/docs/zh_CN/README.md @@ -70,7 +70,8 @@ const module_list = [ //Communication Modules - {a:"/#/zh_CN/module/comx_gsm", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_gsm.webp", p:"COM.GSM", sku:"M031-D" ,kw:"SIM800C", category:"Communication Modules"}, + {a:"/#/zh_CN/module/comx_gps", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/module/comx_gps.webp", p:"COM.GPS", sku:"M031-G" ,kw:"GPS M8N", category:"Communication Modules"}, + {a:"/#/zh_CN/module/comx_gsm", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_gsm.webp", p:"COM.GSM", sku:"M031-D" ,kw:"SIM800C"}, {a:"/#/zh_CN/module/comx_lorawan", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_lorawan.webp", p:"COM.LoRaWAN", sku:"M031-C" ,kw:"LoRaWAN"}, {a:"/#/zh_CN/module/comx_lte", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_lte.webp", p:"COM.LTE(4G)", sku:"M031-A" ,kw:"LTE COMX"}, {a:"/#/zh_CN/module/comx_lte-data", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/comx_lte-data.webp", p:"COM.LTE-DATA", sku:"M031-E" ,kw:"LTE-DATA COMX"}, @@ -119,7 +120,10 @@ const unit_list = [ //Sensor class - {a:"/#/zh_CN/unit/earth", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_earth_01.webp", p:"EARTH", sku:"U019" ,kw:"SENSOR", category:"Sensor class"}, + {a:"/#/zh_CN/unit/mic", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/unit/mic.webp", p:"Microphone", sku:"U096" ,kw:"MIC SOUND SENSOR", category:"Sensor class"}, + {a:"/#/zh_CN/unit/ameter", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/unit/ameter.webp", p:"Ammeter", sku:"U086" ,kw:"AMETER SENSOR"}, + {a:"/#/zh_CN/unit/vmeter", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/unit/vmeter.webp", p:"Voltmeter", sku:"U087" ,kw:" VMETER VOLT SENSOR"}, + {a:"/#/zh_CN/unit/earth", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_earth_01.webp", p:"EARTH", sku:"U019" ,kw:"EARTH SENSOR"}, {a:"/#/zh_CN/unit/env", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_env_01.webp", p:"ENV", sku:"U001" ,kw:"DHT12 BMP280"}, {a:"/#/zh_CN/unit/light", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_light_01.webp", p:"LIGHT", sku:"U021" ,kw:"SENSOR"}, {a:"/#/zh_CN/unit/pir", img:"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit_pir_01.webp", p:"PIR", sku:"U004" ,kw:"SENSOR"}, diff --git a/docs/zh_CN/faq.md b/docs/zh_CN/faq.md index 023bba17..f1503675 100644 --- a/docs/zh_CN/faq.md +++ b/docs/zh_CN/faq.md @@ -9,7 +9,7 @@
-
Q1：不同的M5主机、摄像头Unit之间有什么区别？

+
Q1: 不同的M5主机、摄像头Unit之间有什么区别？

查看产品比较表格 @@ -17,9 +17,81 @@
+
+
Q1: 在哪里可以购买M5Stack的产品？

+
+
+国内用户可以在我们的淘宝企业店铺购买产品 +
+
+
+
-
Q2: LoRa与LoRaWAN模块有什么区别？

+
Q1: 官方的信息发布平台是那里？如何获得第一手新闻消息?

+
+
+ 官方的信息发布平台有 + 官网新闻页 + Youtubu + FaceBook + Instagram + Twitter +
+
+
+ + +
+
Q1: M5Stack主要的控制器有哪些？

+
+
+M5Stack的主要的控制器可以分为3大类，Core系列，Stick系列和Atom系列，未来会增加其他系列控制器。 +
+
+
+ + +
+
Q1: M5Stack的控制器系列之间有什么区别？

+
+
+Core系列的控制器有屏幕是我们的主打系列；Stick系列屏幕上会变得较小，整体的体积小了很多，性价比高；Atom系列没有屏幕，取而代之的则是RGB灯，它的价格是最便宜的，可用作物联网终端控制设备；官网能看到详细资料的对比 +
+
+
+ +
+
Q1: COM系列通讯模块与其他旧款通讯模块有什么区别

+
+
+ COM通讯模块主要采用SimCOM模组，模块主体采用公版设计，主要通讯模组可根据需求更换，通过拨码开关可配置串口通讯物理引脚，旧款模块模组直接焊接，无法拆卸，串口物理引脚需要手动划断，不可再次修改。 +
+
+
+ + +
+
Q2: 不懂编程，是否可以用M5Stack产品做应用

+
+
+ 不懂编程可以使用UIFlow进行编程，但是小孩子的基本编程思维应该具备，M5Stack产品的引脚定义要知道(比如ESP32哪些引脚用了ADC会导致WiFi无法工作，哪些引脚只能输入不能输出)数据处理流程要清晰，如果想做个人认知范围外的功能，建议先自行学习相关知识(比如我想将图像保存为JPEG图片，至少你得知道JPEG文件数据格式)。 +
+
+
+ +
+
Q3: 我想做物联网应用，不知道选择哪个通讯模块

+
+
+ 确定自己的立项需求，使用哪个物联网平台，需要AT支持什么协议，数据吞吐量大小，信号覆盖率，网速要求，项目造价，后期维护成本等等问题，如果你了解清楚这些问题自然有答案。 +
+
+
+ + +
+
Q4: LoRa与LoRaWAN模块有什么区别？

@@ -31,9 +103,21 @@
+
+
Q5: 刚拿到主机，该怎么用

+
+
+ +如果以前接触过Arduino，了解C/C++语言，请按照下面步骤进行配置，如果完全没有接触过Arduino，请移步至UIFlow +或查看UIFlow相关书籍 + +
+
+
+
-
Q3: M5摄像头通过 WIFI 传输图像给手机，能传输多远？

+
Q6: M5摄像头通过 WIFI 传输图像给手机，能传输多远？

@@ -46,7 +130,7 @@
-
Q4: 能否连接5G频段的Wi-Fi

+
Q7: 能否连接5G频段的Wi-Fi

@@ -64,22 +148,183 @@
-
Q1: 如何消除M5Core的扬声器噪声？

+
Q1: ESP-IDF、Arduino、UIFlow、Micropython几种编程环境有什么不同

- 在 Arduino 程序的 Setup()中执行以下语句 - 
-            
-              dacWrite(M5STACKFIRE_SPEAKER_PIN, 0);
-            
-
+ ESP-IDF属于乐鑫专有SDK底层开发，需要用户熟练掌握C/C++编程，了解ESP32内部接口定义及API，熟悉GCC、CMAKE等编译环境，主要面向产品级、消费级领域开发，对基础用户入门门槛较高，主要适合单一领域的专业用户。 + +Arduino编程是在ESP-IDF的基础上对接口进行封装，用户无需过多关心底层实现逻辑，主要偏向于业余DIY爱好者、编程入门用户，用户只需了解基本的C/C++知识即可上手，开源资料较多，代码通用型较强，适合新手入门。 + +MicroPython是Python语言的精简版本，主要应用于单片机，代码实时解释执行，相较于C/C++的代码写法，MicroPython更容易理解，适用于对运行速度没有苛刻要求的场景，适合熟悉Python语言的用户。 + +UIFlow是M5Stack推出的一款可视化编程平台，内部集成了与M5Stack产品相关的编程模块，支持离线与在线编程，支持MicroPython编程语言，可视化操作用户使用门槛进一步降低，用户只需构建程序逻辑，简单设置参数即可完成编程操作。 +
+
+
+ +
+
Q2: Arduino环境如何搭建?

+
+ +
+
+ +
+
Q2: 官方的github网站是什么?

+
+
+ 最新的库或者例子我们都会第一时间在这里更新的github +
+
+
+ +
+
Q2: 官方例程在哪里下载?

+
+
+ 这是我们的主要的例程集中的github仓库,其中罗列了主要的外设例程，欢迎参考 +
+
+
+ +
+
Q3: ESP-IDF环境如何搭建

+
+
+ 参考ESP-IDF说明 +
+
+
+ +
+
Q4: Arduino上传不成功

+
+
+ 确认开发板型号、波特率、串行端口配置无误，擦除Flash再次上传，如果依然上传失败，请联系客服。 +
+
+
+ +
+
Q4: 如何使用Burner烧录固件?

+
+
+ 在我们的官网UIFlow的教程中有如何下载固件的教程
-
Q2: 编写的程序里用到了按键，但是按过一次之后就再也不起作用

+
Q5: ESP-IDF的API

+
+
+ 参考ESP-IDF说明 +
+
+
+ + +
+
Q6: ESP-IDF如何编译烧录固件

+
+
+ 在ESP-IDF中直接用'make flash'命令或在Eclipse IDE 中编译和烧写，如果直接烧录已编译的bin文件，可根据文件内存地址使用ESP Tools 进行烧录
+ M5Stack IDF component
+ M5StickC IDF component +
+
+
+ +
+
Q7: Arduino内如何使用蓝牙、如何用HTTP、如何使用SD、如何使用WebServer、如何使用FreeRTOS等

+
+
+ 请从以下320个示例中查找TECHTUTORIALSX +
+
+
+ +
+
Q8: V-Function传出的数据我不想用UIFlow接收，告诉我怎么获取

+
+
+ UIFlow内集成的功能针对UIFlow体系内的产品使用，如果希望通过Arduino或其他平台产品获取数据请了解一下相关平台的JSON格式解析。 +
+
+
+ +
+
Q9: 从哪里获取资料学习

+
+
+ 硬件只是实现的载体，C/C++、Arduino、Python相关的网站都可以学习，关于M5Stack产品自身硬件的使用方法可以参考产品文档和示例 +
+
+
+ + +
+
Q9: ATOM Echo、ATOM Lite、ATOM Matrix程序通用吗

+
+
+ 三款主机的内部引脚定义不同，ATOM Lite与ATOM Matrix大部分程序是通用的，ATOM Echo定位是智能音箱，底部引脚被I2S占用，理论上无法与其他主机共用相同程序。 +
+
+
+ + +
+
Q10: 为什么我的Arduino代码编译报错了

+
+
+如果是官方提供的程序，上传前已经编译验证通过，如果使用的官方程序编译报错，有可能是因为库版本或板管理引起冲突导致，可以到GitHub提交issue或者联系客服。如果是自行编写的程序，请仔细检查函数声明、类引用是否存在重复定义或类型不匹配的问题。 +
+
+
+ +
+
Q11: V-Function传出的数据我不想用UIFlow接收，告诉我怎么获取

+
+
+ UIFlow内集成的功能针对UIFlow体系内的产品使用，如果希望通过Arduino或其他平台产品获取数据请了解一下相关平台的JSON格式解析。 +
+
+
+ + +
+
Q11: 使用MPU6886得到的Picth、Roll、Yaw不准确

+
+
+ Pitch、Roll、Yaw是通过IMU获取的加速度与角速度实时解算出来的，与算法的准确性有很大关系。现阶段提供的程序没有对算法进行优化。 +
+
+
+ +
+
Q12: 这个视频里的项目很有意思，能不能给源码

+
+
+ 所有素材来源出自用户手中，有的用户用来课上教学，有的用户用来生产周边产品，有的用户用于出版教程，你所见到的并非用户都会无偿提供代码，能提供的代码都可以在GitHub中通过搜索筛选找到。部分项目在M5Burner里已经提供，可以直接烧录。 +
+
+
+ + +
+
Q18: Core2与Core的示例程序是否通用

+
+
+ 由于接口引脚定义有所改动，程序是不能直接使用的，需要在程序中修改相应的引脚。 +
+
+
+ +
+
Q14: 编写的程序里用到了按键，但是按过一次之后就再也不起作用

使用按键和喇叭需要在执行后添加M5.update()来重新响应。 @@ -92,8 +337,213 @@
+ +
-
Q3: UIFlow的Micropython与官方主线Micropython有什么区别

+
Q16: M5Stack设备支持中文显示吗?

+
+
+ 在Arduino环境中支持GB2312编码显示，参考Display中的hzk16示例，UIFlow中可直接显示。 +
+
+
+ + +
+
Q17: 如何获得更多的API?

+
+
+ M5官方提供的参考API仅限于M5硬件封装的功能，软件应用的库比如WIFI，HTTP等不属于提供的范畴，可参考其他ESP32和Arduino库，使用上是通用的。 +
+
+
+ + +
+
Q17: Burner中的第三方固件如何使用和修改?

+
+
+ 我们的Burner除了会提供UiFlow的固件之外还会搜寻github上一些有意思的固件，这些固件大多都是不需要或者需要很少的硬件依赖就可以做成的，可以提供给大家下载娱乐。如果想去自己下载修改内容，可以点击固件版本旁边的github的LOGO即可跳转到相应的github主页，在那里可以下载 +
+
+
+ + +
+
常见硬件问题
+
+ +
+
Q18: M5Stack可以挂几个I2C

+
+
+ ESP32内部有两条I2C总线，每条I2C总线理论上最多支持外挂127个设备，其中主机已经占用一条I2C总线，因此还有一条I2C总线可供用户自定义。 +
+
+
+ + +
+
Q13: 如何消除M5Core的扬声器噪声？

+
+
+ 在 Arduino 程序的 Setup()中执行以下语句 + 
+            
+              dacWrite(M5STACKFIRE_SPEAKER_PIN, 0);
+            
+
+
+
+
+ +
+
Q18: Core2与其他模块兼容吗

+
+
+ Core2的BUS母座插孔深度与其他主机不同，如果你是新用户以前没有购买过早期模块，不必担心，都是兼容的，只要引脚之间没有冲突就可以堆叠使用。 +
+
+
+ + +
+
Q18: DC Motor Module怎么连接乐高电机

+
+
+ DC Motor Module支持乐高NXT、EV3系列的伺服电机，不支持乐高PF电机，由于乐高伺服电机使用RJ12接口，因此需要使用M5Stack特制的连接线进行连接。 +
+
+
+ +
+
Q11: StickC与Atom的HY2.0-4P接口输入数字信号没反应

+
+
+ StickC与Atom在使用HY2.0-4P接口时，需要对相应引脚进行上拉操作，否则无信号输出。 +
+
+
+ + + + +
+
Q18: StickC/StickC Plus的IR最远发射距离多少

+
+
+ 根据测试最远距离为80cm +
+
+
+ + +
+
Q18: Atom GPS Kit为什么GPS只有TX没有RX

+
+
+ Atom引脚有限，为了兼容Atom Matrix的使用，没有接入GPIO21/25引脚，通常也很少会使用RX对GPS配置，如果有特殊需求，可以将GPS模块单独配置，如果只在AtomLite上使用，用户可以自行飞线RX至GPIO21/25引脚。 +
+
+
+ +
+
Q18: Core2屏幕下方3个圆点要怎么使用

+
+
+ 屏幕下方的圆点只是镭射图案，道理与安卓手机屏幕下方三个按键是一样的，它是触摸屏的一部分，只需要设置触摸热区即可映射为虚拟按键，整块屏幕任何位置都可映射为虚拟按键，具体使用参考Core2 Example内的Touch示例。 +
+
+
+ +
+
Q4: FACE II底座的LED Bar如何点亮

+
+
+ FACE II底座的LED Bar使用方法与M5GO 底座使用相同，引脚为GPIO15,可参考M5Stack Fire的程序。 +
+
+
+ +
+
Q4: RS485在使用时必须连接4根线吗

+
+
+ RS485只需要连接3根(GND、TX、 RX），12/24V引脚仅提供为M5Stack设备供电的目的，省掉USB供电接线。如连接非M5Stack设备请务必确认设备电压，防止烧毁，一般建议只接3根线。 + +
+
+
+ +
+
Q4: 多个电池可以堆叠吗

+
+
+ 可以多个堆叠，电池并联总容量增加，电压不变，但是由于每个电池在使用过程中放电不是均衡的，因此电池之间存在电压差，可能会引起电池倒充的现象，长期使用会减少电池寿命，因此不建议长期堆叠使用。 + +
+
+
+ +
+
Q4: 有些产品使用了STM32的芯片，可以给它编程吗

+
+
+ 产品预留了烧录测试点，用户可以自行编程，由于STM32固件不开源，自行编程意味着使用者放弃了保修，因此不建议用户自己编程。 + +
+
+
+ + +
+
Q4: StickC的HAT有些带有电池，如何给电池充电

+
+
+ 只需将StickC插入HAT，给StickC供电即可向HAT电池供电 + +
+
+
+ + +
+
Q18: ESP32有几个串口

+
+
+ ESP32一共有3个硬件串口，通过初始化串口(RX/TX)可以将指定的GPIO引脚映射为串口引脚，其中一个硬件串口(GPIO1/GPIO3)已经被USB接口(UART0)占用，剩余两个可供用户连接串口外设，UART1被系统默认设为(GPIO16/GPIO17)，UART2在系统内未指定，用户自由映射。 +
+
+
+ + +
+
UIFlow常见问题
+
+ + +
+
Q18: UIFlow如何使用？

+
+
+ 关于UIFlow的使用教程在我们的官网有整理，同时我们还在B站发布相关视频教程 +
+
+
+ + +
+
Q18: UIFlow如何添加图片?

+
+
+ 我们的UIFlow目前支持jpg格式的图片，png图片我们还将在后续的更新中加入进去。我们可以提供过转换格式的软件或者是jpg图片制作软件获得一张你要显示的图片(50KB以下)。当我们的控制器连接了网络并连接上了服务器后然后通过运行左边的manage图标，点击添加图片后选择jpg图片，然后等待上传至控制器。通过左边栏的Image拉到屏幕上后点开它就能选择我们上传的图片了 +
+
+
+ + +
+
Q15: UIFlow的Micropython与官方主线Micropython有什么区别

UIFlow是基于主线Micropython的二次封装，集成了大量M5Stack官方库，在使用上UIFlow更加简单容易理解，同时也大部分兼容主线的API写法。 @@ -102,24 +552,58 @@
-
Q4: M5Stack设备支持中文显示吗

+
Q15: UIFlow如何建立自己的块？

- 在Arduino环境中支持GB2312编码显示，参考Display中的hzk16示例，在Micropython环境下受限于执行速度和UTF-8文件大小，暂不支持。 + 我们的UIFlow的贝塔版本有一个供给玩家自己建立模块的功能。刚开始使用的时候我们需要点击User Manual去仔细阅读手册。然后打开Create *.m5b file去制作模块，并点击Download下载下来，然后点击Open *.m5b就可以使用了
-
-
Q5: 如何获得更多的API

+
Q15: Core怎样快速进入wifi模式？

- M5官方提供的参考API仅限于M5硬件封装的功能，软件应用的库比如WIFI，HTTP等不属于提供的范畴，可参考其他ESP32和Arduino库，使用上是通用的。 + 开机的时候按住中间按键即可快速进入wifi模式
+
+
Q15: UIFlow运行的文件会被保存在哪里？

+
+
+ UIFlow下运行和保存的micropython文件会保存在控制器的temp.py中。不同的是运行的文件是直接运行不会切换模式，而下载的文件则是改变成App模式后重启，我们的App模式也是开机运行运行temp.py文件。离线的m5f文件会保存在您浏览器下载的位置 +
+
+
+ +
+
Q15: UIFlow支持多线程吗?

+
+
+ 对于UIFlow来说它本身基于多线程做的，为了防止用户在使用多线程的过程中在原则上不当使得UIFlow无法正常工作，对用户不开放多线程部分，想DIY的用户可以通过micropython官方多线程文档自行编写 +
+
+
+ +
+
Q15: UIFlow的变量可以重名吗？

+
+
+ 由于图形化转换成micropython的技术问题，目前为止我们的变量都是全局变量，所以变量之间不能重名，后续可能会有所调整 +
+
+
+ +
+
Q15: 自己用UiFlow编写Core2画板程序为什么手松开绘图痕迹就消失了？

+
+
+ core2目前为止使用了LVGL和普通GUI绘图，你的绘图可能使用的是普通GUI的API，但是触摸使用的是LVGL的API，所以LVGL的触摸触发了重绘会覆盖掉之前的绘图痕迹，使用**高级**->**附加代码**中的模块添加“lv.obj.set_click(lv.scr_act(), False)”代码即可关闭重绘事件 +
+
+
常见产品售后问题
@@ -231,6 +715,18 @@
+
+
Q8: 向V-Training发送照片但是接收的邮件并未包含模型文件

+
+
+ 仔细检查邮件中的内容，训练错误将在邮件中指出，发送的照片中只允许包含指定的两个文件夹，照片的最低数量和分类有要求，如果存在隐藏文件会导致训练失败 +
+ V-Training详细使用教程 + +
+
+
+
Q9: 烧录程序时出现MD5文件错误

@@ -263,9 +759,19 @@
+
+
Q12: 怎么更改GPS设置

+
+
+ 一般来说，GPS使用默认设置即可，如果有特殊需求更改设置，可以使用TTL转USB转换器直接与GPS连接，通过U-Blox Center进行配置，具体软件使用说明，参照U-Blox官网U-center使用指南。 + +
+
+
+
-
Q12: 使用HAT-Thermal时，屏幕显示带有图像波纹干扰

+
Q13: 使用HAT-Thermal时，屏幕显示带有图像波纹干扰

@@ -281,7 +787,7 @@
-
Q13: MacOS版本升级高版本后，M5StickC无法正常烧录程序。

+
Q14: MacOS版本升级高版本后，M5StickC无法正常烧录程序。

diff --git a/docs/zh_CN/module/comx_gps.md b/docs/zh_CN/module/comx_gps.md new file mode 100644 index 00000000..2fd0b4a5 --- /dev/null +++ b/docs/zh_CN/module/comx_gps.md @@ -0,0 +1,168 @@ +# COM.GPS + +SKU:m031-G + +
+ +## 描述 + +**COM.GPS** 是M5Stack堆叠模块系列中的一款，卫星定位模块.基于NEO-M8N模组开发，配备有源天线.NEO-M8N具备 -167 dBm 高接收灵敏度，并且保持系统低功耗.NEO-M8N 集成了 72 通道的 [u-blox](https://www.u-blox.com) M8 GNSS 引擎，支持多个 GNSS 系统：北斗, Galileo, GLONASS, GPS / QZSS，允许同时接收 3 个 GNSS 系统的数据.模组内部集成了可编程FLASH，可对固件进行升级。该模块具有较小的静态漂移，低功耗和紧凑的尺寸非常适合于车辆，PDA等手持设备，车辆监控，移动电话，相机和其他移动定位系统中的应用。M5Core与COM.GPS模块之间使用UART通信协议，通过模块内的拨码开关可设置UART通讯引脚. + +如果你想要更改串口波特率，请点击 ( [u-center-just-for-Windows](https://www.u-blox.com/en/product/u-center-windows) )查看. + +**注意: 为了使 GPS 模块获得良好信号，请在使用时将模块放置在室外.** + +**UART协议：波特率（默认为9600bps），数据位（8位），起始位（1位），停止位（1位），校验位（无）** + +?>COM GSM的RXD/TXD可以通过设置拨码开关接入的M5Stack的UART（TX(0/13/17)RX(5/15/16)），**M5Stack Fire** 中的 GPIO 16 / 17 默认与PSRAM连接，在使用GSM时会产生冲突，建议使用剩余两组中的任意一组UART引脚。 + +?>右侧拨码开关无需设置。 + +## 产品特性 + +- 天线类型：外置有源天线 +- 外部天线端口：SMA +- 可以同时从3个GNSS系统接收数据 +- 水平位置精度：最小 2.5m +- GPS 模组 (NEO-M8N) 内置闪存, 通过[u-center-just-for-Windows](https://www.u-blox.com/en/product/u-center-windows)升级固件 +- 支持协议: NMEA, UBX, RTCM +- 行业领先的 -167dBm 灵敏度 +- 与 NEO‑7 和 NEO‑6 系列向后兼容 + +## 包含 + +- 1x M5Stack GPS 模块 +- 1x 外置天线(长度: 1 m) + +## 应用 + +- 基于 GPS 的物流跟踪管理 +- 无人驾驶汽车定位 + +## 规格参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
规格参数
接收类型GPS:L1C/A SBAS:L1C/A QZSS:L1C/A GLONASS:L1OF BediDou:B1 Galileo:E1B/C
定位时间Cold start:26S Hot start:1.5S
灵敏度-167 dBm
刷新率Separate GNSS 10Hz，Parallel GNSS 5Hz
速率精度0.05m/s
最大高度50000m
最大速度500m/s
工作电压2.7 ~ 3.6V
工作温度-40 ~ 80°C
净重28g
毛重99g
产品尺寸54*54*13mm
包装尺寸125*68*23mm
+ +## 相关链接 + +- **[GPS Info](https://www.u-blox.com/zh/product/neo-m8-series)** (GPS) + +- **[TinyGPS++库官网](http://arduiniana.org/libraries/tinygpsplus/)** + +- **datasheet** + + - **[NEO-M8N](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/module/NEO-M8-FW3_DataSheet_en.pdf)** + + - **[u-blox Protocol Manual](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/module/u-blox8-M8_ReceiverDescrProtSpec_en.pdf)** + +## EasyLoader + +>EasyLoader是一个简洁快速的程序烧录器，其内置了一个产品相关的案例程序，通过简单步骤将其烧录至主控，即可进行一系列的功能验证.**(程序烧录前，请根据设备类型安装相应驱动程序. M5Core型主机[请点击此处查看CP210X驱动安装教程](zh_CN/arduino/arduino_development?id=安装串口驱动)，M5StickC/V/T/ATOM系列可免驱动使用)** + +
+
+
+
+ Windows + MacOS +
+
+
+ +
+ + +

案例描述:

+

拨码开关RX16/TX17,屏幕显示地理位置与时间

+
+
+
+ + +## 案例程序 + +### Arduino IDE + +[点击这里下载Arduino示例](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Module/COMX_GPS) + +**注意: 为了使 GPS 模块获得良好信号，请在使用时将模块放置在室外.** + +**协议规范:** + +请参考 [u-blox 8 / u-blox M8 Receiver Description - Manual](https://www.u-blox.com/sites/default/files/products/documents/u-blox8-M8_ReceiverDescrProtSpec_%28UBX-13003221%29_Public.pdf)了解更多信息, 下表是NMEA协议中xxRMC消息的指令. + + + +## 原理图 + + + + + \ No newline at end of file diff --git a/docs/zh_CN/module/servo2.md b/docs/zh_CN/module/servo2.md new file mode 100644 index 00000000..b0efa223 --- /dev/null +++ b/docs/zh_CN/module/servo2.md @@ -0,0 +1,105 @@ +# Module SERVO 2 + +SKU:M014 + +
+ +## 描述 + +**SERVO 2** 是M5Stack堆叠模块系列中的一款舵机驱动模块，内部采用PCA9685 16通道PWM控制器，可以同时控制16路舵机。采用直流电源输入（6-12V）设计，通过两片SY8368AQQC进行降压，双通道输出最大总功率35W (5V/3.5A*2)，单通道输出最大功率25W(5V/5A)，当使用电池底座供电时最高支持5V/2A输出。模块与主机直接通过I2C进行通讯（默认0x40），通过拨码开关可改变I2C地址，这也意味着多个SERVO2可以堆叠使用，板上有一个电源切换开关，可控制SERVO2电源通断。 + + +## 产品特性 + +- 16x 舵机驱动通道 +- 2x 电源指示灯 +- I2C地址可调 +- 支持内部/外部供电 +- DC 输入: 6-12V +- DC 连接器类型: XT30 (母头) + +## 包含 + +- 1x Servo2 模块 + +## 应用 + +- 人形机器人 +- 仿生多关节机器人 +- 3轴舵机云台 + +## 规格参数 + + + + + + + + + + + + + + + + + + + + + + +
规格参数
净重g
毛重g
产品尺寸54.2*54.2*13.2mm
包装尺寸mm
+ +## 相关链接 + +- **[PCA9685](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/module/PCA9685.pdf)** + +## EasyLoader + +>EasyLoader是一个简洁快速的程序烧录器，其内置了一个产品相关的案例程序，通过简单步骤将其烧录至主控，即可进行一系列的功能验证.**(程序烧录前，请根据设备类型安装相应驱动程序. M5Core型主机[请点击此处查看CP210X驱动安装教程](zh_CN/arduino/arduino_development?id=安装串口驱动)，M5StickC/V/T/ATOM系列可免驱动使用)** + +
+
+
+
+ Windows + MacOS + +
+
+
+ +
+ + +

案例描述:

+

+
+
+
+ +## 案例程序 + +### 1. Arduino IDE + +[请点击此处下载Arduino代码]() + +## 原理图 + + + + + \ No newline at end of file diff --git a/docs/zh_CN/unit/ameter.md b/docs/zh_CN/unit/ameter.md new file mode 100644 index 00000000..2a27cba5 --- /dev/null +++ b/docs/zh_CN/unit/ameter.md @@ -0,0 +1,166 @@ +# Ammeter Unit{docsify-ignore-all} + +SKU:U086 + +
+ +## 描述 + +**Ammeter Unit** 是一款电流计，可以对电流进行实时监测。内部采用16位ADC数模转换器ADS1115，通过I2C(0X48)进行通讯。为了保证测量精度，内置DC-DC隔离电源，同时I2C接口通过低功耗隔离器CA-IS3020S进行电气隔离，防止数据总线或其他电路上的噪声和浪涌进入本地接地端而干扰或损坏敏感电路。每个Unit在出厂时都单独进行校准，最小分辨率达到0.15626mA，有效值达到±1999（小数点后三位），最大测量电流为±4A，内部集成4A熔断器，防止测量电流过大烧毁电路。 + +>? EEPROM(0x51)在出厂时内置了校准参数，请勿对EEPROM进行写操作，否则校准数据将被覆盖导致测量结果不准确。 + +## 产品特性 + +- ±4A量程 +- 16位ADC转换 +- 最小分辨率达到0.15626mA +- LED电源指示灯 +- 过流保护 +- 免重新校准(EEPROM出厂写入) +- 精度高达±1999 +- 内置 CA-IS3020S隔离芯片，抗干扰 +- 隔离DC-DC +- 高达 5000 VRMS 隔离耐压 +- 开发平台: Arduino, UIFlow(Blockly,Pyhton) +- 2x LEGO 兼容孔 + +## 包含 + +- 1x Ammeter Unit +- 1x Grove 线 + +## 应用 + +- 电流计 + +## 规格参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
规格参数
耐压值5000V
测量范围±4A
通讯协议I2C
净重9g
毛重24g
产品尺寸65*24*8mm
包装尺寸67*53*12mm
+ + +## 测量范围增益设置 + +**不同的量程分辨率不同，获得的结果误差值不同，请根据需要设置合适的量程。请勿对EEPROM进行写操作，如果确实希望将自定义校准值保存至EEPROM，使用下列语句，一旦写入后出厂数据将丢失** + +```Arduino + +bool Voltmeter::saveCalibration2EEPROM(voltmeterGain_t gain, int16_t hope, int16_t actual) + +//@Parameter: voltmeterGarin_t gain 设置增益 +########################################### +# // | PAG | Max Input Voltage(V) | # +# // | PAG_4096 | 64 | # +# // | PAG_2048 | 32 | # +# // | PAG_512 | 16 | # +# // | PAG_256 | 8 | # +########################################### +//@Parameter: int16_t hope 设置目标值 +//@Parameter: int16_t actual ADC原始读数 + +``` + + + + +
ADC1115参考校准档位校准电流(A)期望读数(int16)
PGA512(O.512)26400
+ + + + + + + + +
电流测量档位最大输入电流(A)功耗(W)最小分辨率(mA)增益系数
4.09640.9683.886082.50.125
2.04820.4820.971521.250.0625
1.02410.245.242880.6250.03125
0.5125.121.310720.31250.015625
0.2562.560.327680.156260.007813
+ + +## EasyLoader + +>EasyLoader是一个简洁快速的程序烧录器，其内置了一个产品相关的案例程序，通过简单步骤将其烧录至主控，即可进行一系列的功能验证.**(程序烧录前，请根据设备类型安装相应驱动程序. M5Core型主机[请点击此处查看CP210X驱动安装教程](zh_CN/arduino/arduino_development?id=安装串口驱动)，M5StickC/V/T/ATOM系列可免驱动使用)** + +
+
+
+
+ Windows + MacOS +
+
+
+ +
+ + +

案例描述:

+

测量电流，档位0.512，最大输入电流5A，模拟指针表示范围2A

+
+
+
+ +## 相关链接 + +- **Datasheet** + - [CA-IS3020S](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/CA-IS3020S.pdf) + - [ADS1115](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/ADS1115.PDF) + +## 原理图 + + + +### 管脚映射 + + + + +
M5Core(GROVE A)SDA(GPIO21)SCL(GPIO22)5VGND
A Meter UnitSDASCL5VGND
+ +## 案例程序 + +### 1. Arduino IDE + +[点击这里获取Arduino示例程序](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/A_Meter_Unit) + + \ No newline at end of file diff --git a/docs/zh_CN/unit/mic.md b/docs/zh_CN/unit/mic.md new file mode 100644 index 00000000..d2eea9df --- /dev/null +++ b/docs/zh_CN/unit/mic.md @@ -0,0 +1,124 @@ +# Microphone Unit{docsify-ignore-all} + +SKU:U096 + +
+ +## 描述 + +**Microphone Unit** 是一款声音传感器，内置全指向型驻极体麦克风，通过麦克风前置放大器MAX4466对信号进行放大输出，该放大器能有效抑制电源噪声与共模噪声，输出信号声音还原度高，可在嘈杂环境中使用。该Unit不仅可以输出模拟信号，也可以输出数字电平信号，内置LM393双电压比较器，可通过调节10K可调电阻，设定比较电压阈值。该传感器非常适用于声电转换，声控开关等项目。 + +## 产品特性 + +- 声音采样/音频录制 +- 内置麦克风前置放大器MAX4466 +- 全指向，52dB灵敏度 +- 模拟与数字信号输出 +- 内置电压比较器与可调电阻，阈值可调 +- 开发平台: Arduino, UIFlow(Blockly,Python) +- HY2.0-4P 接口 +- 2x LEGO 兼容孔 + +## 包含 + +- 1x Microphone Unit +- 1x Grove 连接线 + +## 应用 + +- 声电转换 +- 声控开关 + +## 规格参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
规格参数
麦克风灵敏度/信噪比52dB/40dB
输出信号模拟/数字
工作电压3.3V
净重5g
毛重16g
产品尺寸32*24*8mm
包装尺寸67*53*12mm
+ +## EasyLoader + +>EasyLoader是一个简洁快速的程序烧录器，其内置了一个产品相关的案例程序，通过简单步骤将其烧录至主控，即可进行一系列的功能验证.**(程序烧录前，请根据设备类型安装相应驱动程序. M5Core型主机[请点击此处查看CP210X驱动安装教程](zh_CN/arduino/arduino_development?id=安装串口驱动)，M5StickC/V/T/ATOM系列可免驱动使用)** + +
+
+
+
+ Windows + MacOS +
+
+
+ +
+ + +

案例描述:

+

显示麦克风采集AD值

+
+
+
+ +## 相关链接 + +- **Datasheet** + - [MAX4466](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/MAX4466_V2.PDF) + - [LM393](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/LM393.PDF) + +## 原理图 + + + +### 管脚映射 + + + + +
M5Core(PORT BGPIO26GPIO365VGND
Mic Unit26365VGND
+ +## 案例程序 + +### 1. Arduino IDE + +[点击这里获取Arduino示例程序](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/MIC_Unit) + + \ No newline at end of file diff --git a/docs/zh_CN/unit/vmeter.md b/docs/zh_CN/unit/vmeter.md new file mode 100644 index 00000000..f7523d60 --- /dev/null +++ b/docs/zh_CN/unit/vmeter.md @@ -0,0 +1,166 @@ +# Voltmeter Unit{docsify-ignore-all} + +SKU:U087 + +
+ +## 描述 + +**Voltmeter Unit** 是一款电压传感器，可以对电压进行实时监测。内部采用16位ADC数模转换器ADS1115，通过I2C(0X49)进行通讯。为了保证测量精度，内置DC-DC隔离电源，同时I2C接口通过低功耗隔离器CA-IS3020S进行电气隔离，防止数据总线或其他电路上的噪声和浪涌进入本地接地端而干扰或损坏敏感电路。每个Unit在出厂时都单独进行校准，有效值达到±1999（小数点后3位），最大测量电压为±36V，最小分辨率达到0.490798455mV。 + +>? EEPROM(0x53)在出厂时内置了校准参数，请勿对EEPROM进行写操作，否则校准数据将被覆盖导致测量结果不准确。 + +## 产品特性 + +- ±36V量程 +- 16位ADC转换 +- 最小分辨率达到0.490798455mV +- LED电源指示灯 +- 过流保护 +- 免重新校准(EEPROM出厂写入) +- 精度高达±1999 +- 内置 CA-IS3020S隔离芯片，抗干扰 +- 隔离DC-DC +- 高达 5000 VRMS 隔离耐压 +- 开发平台: Arduino, UIFlow(Blockly,Python) +- 2x LEGO 兼容孔 + +## 包含 + +- 1x Voltmeter Unit +- 1x Grove 线 +## 应用 + +- 电压表 + +## 规格参数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
规格参数
耐压值5000V
测量范围±36V
通讯协议I2C
净重9g
毛重24g
产品尺寸65*24*8mm
包装尺寸67*53*12mm
+ + +## 测量范围增益设置 + +**不同的量程分辨率不同，获得的结果误差值不同，请根据需要设置合适的量程。请勿对EEPROM进行写操作，如果确实希望将自定义校准值保存至EEPROM，使用下列语句，一旦写入后出厂数据将丢失** + +```Arduino + +bool Voltmeter::saveCalibration2EEPROM(voltmeterGain_t gain, int16_t hope, int16_t actual) + +//@Parameter: voltmeterGarin_t gain 设置增益 +########################################### +# // | PAG | Max Input Voltage(V) | # +# // | PAG_4096 | 64 | # +# // | PAG_2048 | 32 | # +# // | PAG_512 | 16 | # +# // | PAG_256 | 8 | # +########################################### +//@Parameter: int16_t hope 设置目标值 +//@Parameter: int16_t actual ADC原始读数 + +``` + + + + + +
ADC1115参考校准档位校准电压(V)期望读数(int16)
PGA4096(4.096)607641
PGA512(0.512)55094
+ + + + + + + + +
电压测量档位最大输入电压(V)最小分辨率(mV)增益系数
4.096128.65163647.8522727270.125
2.04864.325818183.9261363640.0625
1.02432.162909091.9630681820.03125
0.51216.081454550.9815340910.015625
0.2568.0407272730.4907984550.007813
+ +## EasyLoader + +>EasyLoader是一个简洁快速的程序烧录器，其内置了一个产品相关的案例程序，通过简单步骤将其烧录至主控，即可进行一系列的功能验证.**(程序烧录前，请根据设备类型安装相应驱动程序. M5Core型主机[请点击此处查看CP210X驱动安装教程](zh_CN/arduino/arduino_development?id=安装串口驱动)，M5StickC/V/T/ATOM系列可免驱动使用)** + +
+
+
+
+ Windows + MacOS +
+
+
+ +
+ + +

案例描述:

+

测量电压，档位0.512，最大测量电压16V，模拟指针表示范围5V

+
+
+
+ +## 相关链接 + +- **Datasheet** + - [CA-IS3020S](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/CA-IS3020S.pdf) + - [ADS1115](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/ADS1115.PDF) + +## 原理图 + + + +### 管脚映射 + + + + +
M5Core(GROVE A)SDA(GPIO21)SCL(GPIO22)5VGND
A Meter UnitSDASCL5VGND
+ +## 案例程序 + +### 1. Arduino IDE + + +[点击这里获取Arduino示例程序](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/V_Meter_Unit) + + \ No newline at end of file