Merge branch 'master' of github.com:m5stack/m5-docs

This commit is contained in:
Sean
2020-12-25 16:24:11 +08:00
13 changed files with 203 additions and 28 deletions
Binary file not shown.

After

Width:  |  Height:  |  Size: 85 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

+140
View File
@@ -0,0 +1,140 @@
# ATOM H-DRIVER
<el-tag effect="plain">SKU:K050</el-talg>
<div class="product_pic"><img src="assets/img/product_pics/atom_base/atom_hdriver/atom_hdriver_01.webp"><img src="assets/img/product_pics/atom_base/atom_hdriver/atom_hdriver_02.webp"></div>
## Description
**ATOM HDriver** is a `H-bridge` motor driver adapted to ATOM controller. Built-in DRV8876 motor driver chip, support `9-24V/DC power input` (Built-in DC/DC circuit powers the whole device, ADC pin G33 direct voltage divider circuit can monitor the power input at any time), the output current can reach `1.5A`, `peak 2A`, can be used for DC motor speed regulation and forward and reverse control. The driver integrates N-channel H bridge, charge pump regulator, current detection and regulation, current proportional output and protection circuit (protection function integration: power supply undervoltage lockout (UVLO), charge pump undervoltage (CPUV), output overvoltage Current (OCP) and device over temperature (TSD), fault conditions are also indicated by the `FAULT` pin).
## Product Features
- N-channel H-bridge motor driver
* Drives one bidirectional brushed DC motor
* Other resistive and inductive loads
DRV8876: 700-mΩ (High-Side + Low-Side)
- High output current capability
* output 1.5A, Peak 2A
H-bridge control modes
- 3.3-V logic inputs
- Spread spectrum clocking for low electromagnetic interference (EMI)
- Integrated protection features
* Undervoltage lockout (UVLO)
* Charge pump undervoltage (CPUV)
* Overcurrent protection (OCP)
* Automatic retry or outputs latched off(IMODE)
* Thermal shutdown (TSD)
* Automatic fault recovery
* Fault indicator pin (nFAULT)
## Inclued
- 1x ATOM Lite
- 1x ATOM H-driver
- 1x 3.96*4P Male
- 1x M2 Hex Key
- 1x M2*8mm Hexagon socket cup head machine screw
- 1x TYPE-C USB Cable20cm)
## Application
- DC motor control
## Specification
<table class="table-1">
<thead>
<tr>
<th>Specification</th>
<th>Parameter</th>
</tr>
</thead>
<tbody>
<tr>
<td>Power Input</td>
<td>9-24V/DC</td>
</tr>
<tr>
<td>Current Output</td>
<td>output 1.5A, peak 2A</td>
</tr>
<tr>
<td>Net weight</td>
<td>16g</td>
</tr>
<tr>
<td>Gross weight</td>
<td>36g</td>
</tr>
<tr>
<td>Product Size</td>
<td>24*48*18mm</td>
</tr>
<tr>
<td>Package Size</td>
<td>54*54*20mm</td>
</tr>
</tbody>
</table>
## 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.
<div class="easyloader-box">
<div style="background-color:white;">
<div><img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/easyloader_intro.webp"></div>
<div class="easyloader-btn">
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/EasyLoader/Windows/ATOM_BASE/EasyLoader_Atom_Hdriver.exe">Windows</a>
<!-- <a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/EasyLoader/MacOS/ATOM_BASE/EasyLoader_QRCODE_ATOM_BASE.dmg">MacOS</a> -->
<!-- <a>Linux</a>
<a>MacOS</a> -->
</div>
</div>
<div>
<video id="example_video" controls>
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/AtomBase/ATOM_HDRIVER.mp4" type="video/mp4">
</video>
<div class="easyloader-mask">
<a>
<svg id="play-btn" t="1583228776634" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="4152" width="75" height="75"><path d="M512 0C229.216 0 0 229.216 0 512s229.216 512 512 512 512-229.216 512-512S794.784 0 512 0z m0 928C282.24 928 96 741.76 96 512S282.24 96 512 96s416 186.24 416 416-186.24 416-416 416zM384 288l384 224-384 224z" p-id="4153" fill="#007aff"></path></svg></a>
<p>Description:</p>
<p>Press the middle button to control the motor is forward and reverse, long press to stop</p>
</div>
</div>
</div>
## Related Link
- **Datasheet**
- [DRV8876PWPR](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/atombase/atom_hdriver/C575551_DRV8876PWPR_2020-06-01.PDF)
## PinMap
<table>
<tr><td>ATOM</td><td>G22</td><td>G19</td><td>G23</td><td>G33</td></tr>
<tr><td>Hdriver</td><td>FAULT</td><td>IN1</td><td>IN2</td><td>VIN-1/10</td></tr>
</table>
<img src="assets/img/product_pics/atom_base/atom_hdriver/atom_hdriver_03.webp" width="30%">
?>Tip: When a fault occurs, the FAULT (G22) pin will be triggered to pull down. G33 can obtain 1/10 of the input voltage and can be used to detect the current power input.
## Schematic
<img src="assets/img/product_pics/atom_base/atom_hdriver/atom_hdriver_sch.webp">
## Example
- [Arduino Example Code](https://github.com/m5stack/M5Atom/tree/master/examples/ATOM_BASE/ATOM_Hdriver)
<script>
var purchase_link = 'https://m5stack.com/products/atom-h-bridge-driver-kit-drv8876';
anchor_search(purchase_link);
scrollFunc();
</script>
+2 -3
View File
@@ -25,7 +25,6 @@
- 1DEAN,UPC,Code 39,Code 93,Code 128,UCC/EAN 128, CodabarInterleaved 2 of 5, ITF-6,ITF-14,ISBN,ISSN, MSI-Plessey,GS1 Databar,Code 11,Industrial 25Standard 25,Plessey, Matrix 2 of 5
## Inclued
- 1x ATOM QR-CODE
@@ -127,7 +126,7 @@ The scan module has been configured at the factory. M5Atom Lite has no pre-burn
## 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)
>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.
<div class="easyloader-box">
<div style="background-color:white;">
@@ -152,7 +151,7 @@ The scan module has been configured at the factory. M5Atom Lite has no pre-burn
</div>
</div>
### PinMap
## PinMap
<table>
<tr><td>M5Atom</td><td>GPIO23</td><td>GPIO33</td><td>3.3V</td><td>GND</td></tr>
+2 -2
View File
@@ -132,7 +132,8 @@
{"a":"/#/en/atom/atomhub_switch_d", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_switch_d_01.webp", "p":"ATOM SWITCH-D", "sku":"K042-D" ,"kw":"ATOM SWITCH RS485"},
{"a":"/#/en/atom/atomfly", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atomfly.webp", "p":"ATOM-FLY", "sku":"K040" ,"kw":"ATOM FLY"},
{"a":"/#/en/atom/atom_mate", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_mate.webp", "p":"ATOM-MATE", "sku":"A086" ,"kw":"ATOM MATE HAT MOUNT PIN"},
{"a":"/#/en/atom/atomic_step_motor", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_stepmotor.webp", "p":"ATOM STEPMOTOR", "sku":"K047" ,"kw":"ATOM STEP MOTOR"}
{"a":"/#/en/atom/atomic_step_motor", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_stepmotor.webp", "p":"ATOM STEPMOTOR", "sku":"K047" ,"kw":"ATOM STEP MOTOR"},
{"a":"/#/en/atom/atom_hdriver", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_hdriver_01.webp", "p":"ATOM H-DRIVER", "sku":"K050" ,"kw":"H bridge"}
]
},
"Modules": {
@@ -215,7 +216,6 @@
],
"AI-Cameras": [
{"a":"/#/en/unit/unitv", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit-v-01.webp", "p":"UNIT-V(OV2640)", "sku":"U078", "qs":"/#/en/quick_start/unitv/unitv_quick_start" ,"kw":"K210 CAMERA OV2640", "category":"AI-Cameras"},
{"a":"/#/zh_CN/unit/unitv_ov7740", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unitv_ov7740.webp", "p":"UNIT-V(OV7740)", "sku":"U078-C", "qs":"/#/zh_CN/quick_start/unitv/unitv_quick_start" ,"kw":"K210 CAMERA OV7740"},
{"a":"/#/en/core/m5stickv", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/core/m5stickv_01.webp", "p":"M5StickV", "sku":"K027" , "qs":"/#/en/quick_start/m5stickv/m5stickv_quick_start", "kw":"K210 CAMERA AXP192 MPU6886"}
]
},
+2 -3
View File
@@ -104,14 +104,13 @@ bool Ammeter::saveCalibration2EEPROM(ammeterGain_t gain, int16_t hope, int16_t a
?>Absolute maxium `6A` Do not exceed it, otherwise the equipment will be burnt down.
<table>
<tr><td>Current measurement range</td><td>Maximum input current(A)</td><td>Power dispensation(W)</td><td>Minimum resolution(mA)</td><td>Gain factor</td></tr>
<tr><td>4.096</td><td>4</td><td>83.88608</td><td>2.5</td><td>0.125</td></tr>
<tr><td>PAG_4096(Calibrated)</td><td>±4</td><td>83.88</td><td>2.5</td><td>0.125</td></tr>
<!-- <tr><td>2.048</td><td>20.48</td><td>20.97152</td><td>1.25</td><td>0.0625</td></tr>
<tr><td>1.024</td><td>10.24</td><td>5.24288</td><td>0.625</td><td>0.03125</td></tr>
<tr><td>0.512</td><td>5.12</td><td>1.31072</td><td>0.3125</td><td>0.015625</td></tr> -->
<tr><td>0.256</td><td>2.56</td><td>0.32768</td><td>0.15626</td><td>0.007813</td></tr>
<tr><td>PAG_256(Calibrated)</td><td>±2.56</td><td>0.32768</td><td>0.15626</td><td>0.007813</td></tr>
</table>
+3 -3
View File
@@ -106,12 +106,12 @@ bool Voltmeter::saveCalibration2EEPROM(voltmeterGain_t gain, int16_t hope, int16
</table> -->
<table>
<tr><td>Voltage measurement range</td><td>Maximum input voltage(V)</td><td>Minimum resolution(mV)</td><td>Gain factor</td></tr>
<tr><td>4.096</td><td>128</td><td>7.85</td><td>0.125</td></tr>
<tr><td>Voltage measurement range</td><td>Maximum input DC voltage(V)</td><td>Minimum resolution(mV)</td><td>Gain factor</td></tr>
<tr><td>PAG_4096(Calibrated)</td><td>±128</td><td>7.85</td><td>0.125</td></tr>
<!-- <tr><td>2.048</td><td>64</td><td>3.93</td><td>0.0625</td></tr>
<tr><td>1.024</td><td>32</td><td>1.96</td><td>0.03125</td></tr>
<tr><td>0.512</td><td>16</td><td>0.98</td><td>0.015625</td></tr> -->
<tr><td>0.256</td><td>8</td><td>0.49</td><td>0.007813</td></tr>
<tr><td>PAG_256(Calibrated)</td><td>±8</td><td>0.49</td><td>0.007813</td></tr>
</table>
## EasyLoader
+41 -8
View File
@@ -1,6 +1,8 @@
# ATOM HDriver
# ATOM H-DRIVER
<el-tag effect="plain">SKU:K039</el-talg>
<el-tag effect="plain">SKU:K050</el-talg>
<div class="product_pic"><img src="assets/img/product_pics/atom_base/atom_hdriver/atom_hdriver_01.webp"><img src="assets/img/product_pics/atom_base/atom_hdriver/atom_hdriver_02.webp"></div>
## 描述
@@ -29,7 +31,7 @@
## 包含
- 1x ATOM Lite
- 1x ATOM Hdriver
- 1x ATOM H-driver
- 1x 3.96*4P 公头
- 1x M2内六角扳手
- 1x M2*8杯头机械牙螺丝
@@ -76,6 +78,34 @@
</tbody>
</table>
## EasyLoader
>EasyLoader是一个简洁快速的程序烧录器,其内置了一个产品相关的案例程序,通过简单步骤将其烧录至主控,即可进行一系列的功能验证。
<div class="easyloader-box">
<div style="background-color:white;">
<div><img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/easyloader_intro.webp"></div>
<div class="easyloader-btn">
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/EasyLoader/Windows/ATOM_BASE/EasyLoader_Atom_Hdriver.exe">Windows</a>
<!-- <a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/EasyLoader/MacOS/ATOM_BASE/EasyLoader_QRCODE_ATOM_BASE.dmg">MacOS</a> -->
<!-- <a>Linux</a>
<a>MacOS</a> -->
</div>
</div>
<div>
<video id="example_video" controls>
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/AtomBase/ATOM_HDRIVER.mp4" type="video/mp4">
</video>
<div class="easyloader-mask">
<a>
<svg id="play-btn" t="1583228776634" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="4152" width="75" height="75"><path d="M512 0C229.216 0 0 229.216 0 512s229.216 512 512 512 512-229.216 512-512S794.784 0 512 0z m0 928C282.24 928 96 741.76 96 512S282.24 96 512 96s416 186.24 416 416-186.24 416-416 416zM384 288l384 224-384 224z" p-id="4153" fill="#007aff"></path></svg></a>
<p>案例描述:</p>
<p>按下中间按键控制电机正反转,长按停止</p>
</div>
</div>
</div>
## 相关链接
- **Datasheet**
@@ -88,20 +118,23 @@
<tr><td>Hdriver</td><td>FAULT</td><td>IN1</td><td>IN2</td><td>VIN-1/10</td></tr>
</table>
<img src="assets/img/product_pics/atom_base/atom_hdriver/atom_hdriver_03.webp" width="30%">
?>提示:当故障发生时,将触发FAULT(G22)引脚下拉,G33能够获取输入电压的1/10,能够用于检测当前的电源输入情况。
## 案例程序
- [Arduino代码示例](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/AtomBase/AtomFLY)
## 原理图
<img src="assets/img/product_pics/atom_base/atom_hdriver/atom_hdriver_sch.webp">
## 案例程序
- [Arduino代码示例](https://github.com/m5stack/M5Atom/tree/master/examples/ATOM_BASE/ATOM_Hdriver)
<script>
var purchase_link = 'https://m5stack.com/collections/all/products/atomic-proto-kit';
var purchase_link = 'https://m5stack.com/products/atom-h-bridge-driver-kit-drv8876';
anchor_search(purchase_link);
scrollFunc();
+5 -1
View File
@@ -6,7 +6,11 @@
## 描述
**Base PoE** 是一款支持PoE供电的以太网控制器底座,方便设备轻松接入互联网。它支持RS485/RS232通讯,可作为以太网转串口服务器使用。内置以W5500全硬件嵌入式以太网控制器,W5500集成了 TCP/IP 协议栈,具备8路独立硬件socket,10/100M 以太网数据链路层(MAC)及物理层(PHY)为嵌入式系统提供更加简易的互联网连接方案,支持PoE(有源以太网)技术,通过内置的PoE模块可以直接通过PoE集线器/交换机为底座供电而无需单独配备电源。为方便在工业应用场景的快速部署,套件内提供金属滑轨和磁盘便于安装固定,配备HT3.96端子用作RS485/RS232的电气连接,能够满足实际生产环境中的有线网络接入需求
**ATOM PoE** 是一款适配ATOM主控的以太网控制器底座,支持PoE供电,方便设备轻松接入互联网。
提供RS485/RS232通讯接口,可作为以太网转串口服务器使用。
内置W5500嵌入式以太网控制器,集成了 TCP/IP 协议栈,具备8路独立硬件socket,10/100M 以太网数据链路层(MAC)及物理层(PHY)为嵌入式系统提供更加简易的互联网连接方案,支持PoE(有源以太网)技术,通过内置的PoE模块可以直接通过PoE集线器/交换机为底座供电而无需单独配备电源。为方便在工业应用场景的快速部署,套件内提供金属滑轨和磁盘便于安装固定,配备HT3.96端子用作RS485/RS232的电气连接,能够满足实际生产环境中的有线网络接入需求。
HT3.96连接器的 6 个引脚默认悬空,你可以根据需求选择连接RS232或RS485电平转换板。
+3 -3
View File
@@ -132,7 +132,8 @@
{"a":"/#/zh_CN/atom/atomhub_switch_d", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_switch_d_01.webp", "p":"ATOM SWITCH-D Kit", "sku":"K042-D" ,"kw":"ATOM SWITCH RS485"},
{"a":"/#/zh_CN/atom/atomfly", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atomfly.webp", "p":"ATOM FLY Kit", "sku":"K040" ,"kw":"ATOM FLY"},
{"a":"/#/zh_CN/atom/atom_mate", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_mate.webp", "p":"ATOM MATE", "sku":"A086" ,"kw":"ATOM MATE HAT MOUNT PIN"},
{"a":"/#/zh_CN/atom/atomic_step_motor", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_stepmotor.webp", "p":"ATOM STEPMOTOR Kit", "sku":"K047" ,"kw":"ATOM STEP MOTOR"}
{"a":"/#/zh_CN/atom/atomic_step_motor", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_stepmotor.webp", "p":"ATOM STEPMOTOR Kit", "sku":"K047" ,"kw":"ATOM STEP MOTOR"},
{"a":"/#/zh_CN/atom/atom_hdriver", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_hdriver_01.webp", "p":"ATOM H-DRIVER", "sku":"K050" ,"kw":"H bridge"}
]
},
"功能模块": {
@@ -197,7 +198,7 @@
{"a":"/#/zh_CN/module/faces_calculator", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/face_cal.webp", "p":"CALCULATOR", "sku":"A005" ,"kw":"FACES CALCULATOR"},
{"a":"/#/zh_CN/module/faces_gameboy", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/face_gamepad.webp", "p":"GAMEPAD", "sku":"A004" ,"kw":"FACES GAMEPAD"}
],
"其他": [
"其他模块": [
{"a":"/#/zh_CN/module/ecg", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/module/ecg_01.webp", "p":"ECG", "sku":"M034" ,"kw":"AD8232", "category":"其他"}
]
},
@@ -215,7 +216,6 @@
],
"AI-摄像头": [
{"a":"/#/zh_CN/unit/unitv", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unit-v-01.webp", "p":"UNIT-V(OV2640)", "sku":"U078", "qs":"/#/zh_CN/quick_start/unitv/unitv_quick_start" ,"kw":"K210 CAMERA OV2640", "category":"AI-摄像头"},
{"a":"/#/zh_CN/unit/unitv_ov7740", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/unit/unitv_ov7740.webp", "p":"UNIT-V(OV7740)", "sku":"U078-C", "qs":"/#/zh_CN/quick_start/unitv/unitv_quick_start" ,"kw":"K210 CAMERA OV7740"},
{"a":"/#/zh_CN/core/m5stickv", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/core/m5stickv_01.webp", "p":"M5StickV", "sku":"K027" , "qs":"/#/zh_CN/quick_start/m5stickv/m5stickv_quick_start", "kw":"K210 CAMERA AXP192 MPU6886"}
]
},
+2 -2
View File
@@ -98,11 +98,11 @@ bool Voltmeter::saveCalibration2EEPROM(voltmeterGain_t gain, int16_t hope, int16
<table>
<tr><td>电流测量档位</td><td>最大输入电流(A)</td><td>功耗(W)</td><td>最小分辨率(mA)</td><td>增益系数</td></tr>
<tr><td>4.096</td><td>4</td><td>83.88</td><td>2.5</td><td>0.125</td></tr>
<tr><td>PAG_4096(已校准)</td><td>±4</td><td>83.88</td><td>2.5</td><td>0.125</td></tr>
<!-- <tr><td>2.048</td><td>20.48</td><td>20.97152</td><td>1.25</td><td>0.0625</td></tr>
<tr><td>1.024</td><td>10.24</td><td>5.24288</td><td>0.625</td><td>0.03125</td></tr>
<tr><td>0.512</td><td>5.12</td><td>1.31072</td><td>0.3125</td><td>0.015625</td></tr> -->
<tr><td>0.256</td><td>2.56</td><td>0.32768</td><td>0.15626</td><td>0.007813</td></tr>
<tr><td>PAG_256(已校准)</td><td>±2.56</td><td>0.32768</td><td>0.15626</td><td>0.007813</td></tr>
</table>
+3 -3
View File
@@ -100,12 +100,12 @@ bool Voltmeter::saveCalibration2EEPROM(voltmeterGain_t gain, int16_t hope, int16
</table> -->
<table>
<tr><td>电压测量档位</td><td>输入电压(V)满幅度</td><td>最小分辨率(mV)</td><td>增益系数</td></tr>
<tr><td>4.096</td><td>128</td><td>7.85</td><td>0.125</td></tr>
<tr><td>电压测量档位</td><td>DC输入电压(V)满幅度</td><td>最小分辨率(mV)</td><td>增益系数</td></tr>
<tr><td>PAG_4096(已校准)</td><td>±128</td><td>7.85</td><td>0.125</td></tr>
<!-- <tr><td>2.048</td><td>64.32581818</td><td>3.926136364</td><td>0.0625</td></tr>
<tr><td>1.024</td><td>32.16290909</td><td>1.963068182</td><td>0.03125</td></tr>
<tr><td>0.512</td><td>16.08145455</td><td>0.981534091</td><td>0.015625</td></tr> -->
<tr><td>0.256</td><td>8</td><td>0.49</td><td>0.007813</td></tr>
<tr><td>PAG_256(已校准)</td><td>±8</td><td>0.49</td><td>0.007813</td></tr>
</table>
## EasyLoader