release ATOM Motion

This commit is contained in:
Gitshaoxiang
2021-01-15 15:21:40 +08:00
parent 1cf004c994
commit 005e7daefe
16 changed files with 378 additions and 13 deletions
Binary file not shown.

After

Width:  |  Height:  |  Size: 101 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 57 KiB

+7
View File
@@ -136,3 +136,10 @@ void loop() {
**DescriptionRead battery charging current**
## isCharging()
**Syntax**
`bool isCharging();`
**DescriptionCheck if it is charging**
+138
View File
@@ -0,0 +1,138 @@
# ATOM Motion
<el-tag effect="plain">SKU:K053</el-talg>
<div class="product_pic"><img src="assets/img/product_pics/atom_base/atom_motion/atom_motion_01.webp"><img src="assets/img/product_pics/atom_base/atom_motion/atom_motion_02.webp"></div>
## Description
**ATOM Motion** is a steering gear & DC motor drive base designed for the ATOM device series. It has an integrated STM32 control chip with an I2C communication control mode suitable for device communication. The base includes 4-channel steering gear and 2-channel DC motor interface. Integrated 16340 lithium battery (with capacity of 700mAh). Two-way HY2.0-4P interface expansion and 4 LED out pins which can be used to connect some sensors and expansion equipment. Suitable for multi-steering gear/motor control scenarios, such as multi-axis steering gear manipulator control or trolley motor drive.
## Product Features
- 4 channel servo control
- 2 channel DC motor control
- Removable lithium battery
- Magnetic back design
- Independent power switch
- 2 way HY2.0-4P expansion interface
## Include
- 1x ATOM Lite
- 1x ATOM Motion
- 1x M2 screw driver
- 1x M2*8 cup head screws
- 1x TYPE-C USB Cable20cm)
## Applications
- DC motor trolley control
- Steering gear arm control
## Specification
<table class="table-1">
<thead>
<tr>
<th>Specification</th>
<th>Parameter</th>
</tr>
</thead>
<tbody>
<tr>
<td>Removable lithium battery</td>
<td>Specification: 16340, capacity 700mAh</td>
</tr>
<tr>
<td>Interface PIN spacing</td>
<td>2.54mm</td>
</tr>
<tr>
<td>Net weight</td>
<td>40g</td>
</tr>
<tr>
<td>Gross weight</td>
<td>77.1g</td>
</tr>
<tr>
<td>Product Size</td>
<td>24*72*21mm</td>
</tr>
<tr>
<td>Package dimensions<</td>
<td>95 x 65 x 25mm</td>
</tr>
</tbody>
</table>
## EasyLoader
>EasyLoader is a simple and fast program burner, which has a built-in product-related case program, which can be burned to the main control through simple steps to perform a series of functional 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_Motion.exe">Windows</a>
</div>
</div>
<div>
<video id="example_video" controls>
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/AtomBase/ATOM_MOTION.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>Control the rotation of 4 steering gears and 2 DC motors, press the ATOM center button to switch the direction of the DC motor rotation</p>
</div>
</div>
</div>
## PinMap
- I2C Interface
<table>
<tr><td>ATOM</td><td>G21</td><td>G25</td></tr>
<tr><td>ATOM Motion</td><td>SCL</td><td>SDA</td></tr>
</table>
- HY2.0-4P
<table>
<tr><td>ATOM</td><td>G23、G33</td><td>G22、G19</td></tr>
<tr><td>ATOM Motion</td><td>PORT-B(Black)</td><td>PORT-C(Blue)</td></tr>
</table>
## I2C register
- I2C Address: **0x38**
<table>
<tr><td>Function</td><td>Reg Address</td><td>Data Range</td><td>R/W</td></tr>
<tr><td>Servo(1~4)</td><td>0x00~0x03</td><td>angle: 0-180</td><td>R/W<</td></tr>
<tr><td>Servo(1~4)</td><td>0x10~0x17</td><td>pulse: 500-2500</td><td>R/W<</td></tr>
<tr><td>Motor(1~2)</td><td>0x20~0x21</td><td>speed: -127-127</td><td>R/W<</td></tr>
</table>
## Schematic
<img src="assets/img/product_pics/atom_base/atom_motion/atom_motion_sch.webp">
## Example
- [Arduino Example Code](https://github.com/m5stack/M5Atom/tree/master/examples/ATOM_BASE/ATOM_Motion)
<script>
var purchase_link = 'https://m5stack.com/products/atom-motion-kit-with-motor-and-servo-driver-stm32f0';
anchor_search(purchase_link);
scrollFunc();
</script>
+8
View File
@@ -254,10 +254,18 @@ For more info on specific pin functions refer to the official ESP32 Docs[ESP32 d
## Video
- Product Introduce
<video class="video_size" controls>
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/Core/M5PAPER.mp4" type="video/mp4">
</video>
- How to open the M5Paper shell?
<video class="video_size" controls>
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/Core/paper_open_shell.mp4" type="video/mp4">
</video>
<script>
var purchase_link = 'https://m5stack.com/collections/black-friday/products/m5paper-esp32-development-kit-960x540-4-7-eink-display-235-ppi';
+1
View File
@@ -135,6 +135,7 @@
{"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/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"},
{"a":"/#/en/atom/atom_motion", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_motion_01.webp", "p":"ATOM MOTION", "sku":"K053" ,"kw":"SERVO MOTOR"},
{"a":"/#/en/atom/atom_poe", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_poe_01.webp", "p":"ATOM PoE", "sku":"K052" ,"kw":"PoE W5500"}
]
},
+5 -1
View File
@@ -6,7 +6,7 @@
## Description
**ACCEL** is a motion sensor Unit. Integrated with ADXL 345 and ACC it is able to obtain 3-axis of Acceleration. ADXL 345 is a small, thin, ultra-low power consumption 3-axis accelerometer with high resolution (13-bit) measurement at up to ±16 g. Digital output data is formatted as 16-bit twos complement and it is accessible through I2C digital interface. In this Unit, we used I2C series interface.
**ACCEL** is a motion sensor Unit. Integrated with ADXL 345 and ACC it is able to obtain 3-axis of Acceleration. ADXL 345 is a small, thin, ultra-low power consumption 3-axis accelerometer with high resolution (13-bit) measurement at up to ±16 g. Digital output data is formatted as 16-bit twos complement and it is accessible through I2C(addr:0x53) digital interface. In this Unit, we used I2C series interface.
<br>
*What is an accelerometer?*<br>
@@ -52,6 +52,10 @@ By measuring the amount of static acceleration, due to gravity, you can find out
<td> Measurement range </td>
<td> ± 16g </td>
</tr>
<tr>
<td> I2C Address </td>
<td> 0x53 </td>
</tr>
<tr>
<td> Resolution </td>
<td> The resolution of 10-bit fixed resolution increases with the increase of g range, up to 13 bits at ± 16 g </td>
+7
View File
@@ -136,3 +136,10 @@ void loop() {
**功能:读取电池充电电流**
## isCharging()
**函数原型:**
`bool isCharging();`
**功能:检查是否处于充电状态**
+86 -10
View File
@@ -1,27 +1,103 @@
# ATOM Motion
<el-tag effect="plain">SKU:K050</el-talg>
<el-tag effect="plain">SKU:K053</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>
<div class="product_pic"><img src="assets/img/product_pics/atom_base/atom_motion/atom_motion_01.webp"><img src="assets/img/product_pics/atom_base/atom_motion/atom_motion_02.webp"></div>
## 描述
**ATOM Motion** 是适配ATOM主控系列的舵机&DC电机驱动方案,内部集成STM32控制芯片,采用I2C通信控制方式。提供4通道舵机,2通道DC电机接口。集成规格16340锂电池(容量700mAh)。
两路HY2.0-4P接口拓展,对4个PIN脚进行了引出,能够用于外接一些传感器与拓展设备。
**ATOM Motion** 是适配ATOM主控系列的舵机&DC电机驱动方案,内部集成STM32控制芯片,采用I2C通信控制方式。提供4通道舵机,2通道DC电机接口。集成规格16340锂电池(容量700mAh)。两路HY2.0-4P接口拓展,对4个PIN脚进行了引出,能够用于外接一些传感器与拓展设备。适用于多舵机/电机控制场景,如多轴舵机机械臂控制或是小车电机驱动。
## 产品特性
- 4通道舵机控制
- 2通道直流电机控制
- 内嵌锂电池
- HY2.0-4P拓展接口
- 可拆卸锂电池
- 背面磁吸设计
- 独立电源开关
- 2路HY2.0-4P拓展接口
## 包含
- 1x ATOM Lite
- 1x ATOM Motion
- 1x M2内六角扳手
- 1x M2*8杯头机械牙螺丝
- 1x TYPE-C USB Cable20cm)
## 应用
- 直流电机小车控制
- 舵机机械臂控制
## 规格参数
<table class="table-1">
<thead>
<tr>
<th>规格</th>
<th>参数</th>
</tr>
</thead>
<tbody>
<tr>
<td>输入电压</td>
<td>9-24V/DC</td>
</tr>
<tr>
<td>可拆卸锂电池</td>
<td>规格:16340, 容量700mAh</td>
</tr>
<tr>
<td>接口PIN间距</td>
<td>2.54mm</td>
</tr>
<tr>
<td>净重</td>
<td>40g</td>
</tr>
<tr>
<td>毛重</td>
<td>77.1g</td>
</tr>
<tr>
<td>产品尺寸</td>
<td>24*72*21mm</td>
</tr>
<tr>
<td>包装尺寸</td>
<td>95 x 65 x 25mm</td>
</tr>
</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_Motion.exe">Windows</a>
</div>
</div>
<div>
<video id="example_video" controls>
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/AtomBase/ATOM_MOTION.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>控制4路舵机与2路DC电机转动,按下ATOM中心按键可切换DC电机旋转方向</p>
</div>
</div>
</div>
## 管脚映射
- I2C Interface: **0x38**
- I2C Interface
<table>
<tr><td>ATOM</td><td>G21</td><td>G25</td></tr>
@@ -57,7 +133,7 @@
<script>
var purchase_link = 'https://m5stack.com/products/atom-h-bridge-driver-kit-drv8876';
var purchase_link = 'https://m5stack.com/products/atom-motion-kit-with-motor-and-servo-driver-stm32f0';
anchor_search(purchase_link);
scrollFunc();
+1 -1
View File
@@ -2,7 +2,7 @@
<el-tag effect="plain">SKU:K012-B</el-tag>
<div class="product_pic"><img src="assets/img/product_pics/base/lan_01.webp" width="300" height="300"></div>
<div class="product_pic"><img src="assets/img/product_pics/base/lan_01.webp"></div>
## 描述
+8
View File
@@ -254,10 +254,18 @@
## 相关视频
- 产品介绍
<video class="video_size" controls>
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/Core/M5PAPER.mp4" type="video/mp4">
</video>
- M5Paper背板拆解教程
<video class="video_size" controls>
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/Core/paper_open_shell.mp4" type="video/mp4">
</video>
<script>
var purchase_link = 'https://m5stack.com/collections/black-friday/products/m5paper-esp32-development-kit-960x540-4-7-eink-display-235-ppi';
+4
View File
@@ -170,6 +170,10 @@
以下代码仅为片段,如需获取完整代码, [请点击此处](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Module/COMX_LTE)
### UIFlow
[UIFLow Network Over COM.LTE使用教程](zh_CN/quick_start/comx_lte/network_over_com)
### 管脚映射
<table>
+1
View File
@@ -135,6 +135,7 @@
{"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/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"},
{"a":"/#/zh_CN/atom/atom_motion", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_motion_01.webp", "p":"ATOM MOTION", "sku":"K053" ,"kw":"SERVO MOTOR"},
{"a":"/#/zh_CN/atom/atom_poe", "img":"https://static-cdn.m5stack.com/image/m5-docs_homepage/atom_base/atom_poe_01.webp", "p":"ATOM PoE", "sku":"K052" ,"kw":"PoE W5500"}
]
},
@@ -0,0 +1,107 @@
# Network Over COM.LTE使用教程
>Network Over COM.LTE模式,可以使得设备在使用UIFlow时,所有网络数据经过LTE发送。
?>注意事项: `CORE2`在使用`Network Over COM.LTE模式`时,M-BUS的5V电源将切换为输入模式,因此请直接输入5V电源至M-BUS,或使用DC适配器连接至LTE模块进行供电。
## 准备工作
### 驱动安装
>程序烧录前,M5Core型主机(包含BASIC/GRAY/M5GO/FIRE/FACES/CORE2)用户请根据您使用的操作系统,点击下方按钮下载相应的CP210X驱动程序压缩包.在解压压缩包后,选择对应操作系统位数的安装包进行安装。
* __下载CP210X驱动程序__
<div class="files_download">
<p class="item">
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/drivers/CP210x_VCP_Windows.zip">
<img src="/image/base/Windows_logo.webp" width="50">
<span class="item-title">Windows10</span>
</a>
</p>
<p class="item">
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/drivers/CP210x_VCP_MacOS.zip">
<img src="/image/base/MacOS_logo.webp" width="50">
<span class="item-title">MacOS</span>
</a>
</p>
<p class="item">
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/drivers/CP210x_VCP_Linux.zip">
<img src="/image/base/Linux_logo.webp" width="50">
<span class="item-title">Linux</span>
</a>
</p>
</div>
><img src="/image/base/CP210X_install.gif " width="70%">
### 烧录工具
>请根据您所使用的操作系统,点击下方按钮下载相应的M5Burner固件烧录工具.解压打开应用程序。
<div class="files_download">
<p class="item">
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/software/M5Burner.zip">
<img src="/image/base/Windows_logo.webp" width="50">
<span class="item-title">Windows10</span>
</a>
</p>
<p class="item">
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/software/M5Burner_MacOS.zip">
<img src="/image/base/MacOS_logo.webp" width="50">
<span class="item-title">MacOS</span>
</a>
</p>
<p class="item">
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/software/M5Burner_Linux.zip">
<img src="/image/base/Linux_logo.webp" width="50">
<span class="item-title">Linux</span>
</a>
</p>
</div>
<img src="assets/img/getting_started_pics/how_to_burn_firmware/M5Burner/M5Burner_01.webp">
?>注意:MacOS用户安装完成后请将应用放入Application文件夹内,如下图所示。
><img src="/image/base/application.webp" width="70%">
?>注意:Linux用户请切换至解压文件路径下,在终端中运行`./M5Burner`, 运行应用。
### 固件烧录
>1.双击打开Burner烧录工具,在左侧菜单中选择对应的设备类型,选择你所需要的固件版本,点击下载按钮进行下载。
<img src="assets\img\quick_start\core\burner_m5core01.webp" width="70%">
>2.然后将M5设备通过Type-C数据线连接到电脑,选择对应的COM口,点击"Burn"开始烧录.
<img src="assets\img\quick_start\core\burner_m5core02.webp" width="70%">
>3.当烧录日志提示`Burn Successfully`时,则表示固件已经烧录完成。
<img src="assets\img\quick_start\core\burner_done.webp" width="70%">
## 设置APN/切换模式
>1.点击`Configuration`,软件将开始读取当前设备的配置信息,在弹出的配置框中,你可以根据你所使用的运营商,重新配置APN。(默认APN为CMNET
>2.将设备切换至COM.LTE工作模式,你可以在配置框中将`COM.X`选项设置为`True`或是,在设备的启动后,进入Setup配置页面进行模式切换。
## 开始使用
>1.配置完成后,开机将会自动启用,并开始检查。通过测试后,将进入编程模式页面。
>2.参考以下案例,通过http请求URL`https://httpbin.org/ip`,获取本机当前IP。
<img src="assets\img\quick_start\comx_lte\http_get_ip.jpg" width="70%">
+5 -1
View File
@@ -6,7 +6,7 @@
## 描述
**ACCEL** 是一款运动数据传感器. 内部集成**ADXL345**三轴加速度计.可测量范围高达±16g(13位分辨率)的加速度数据.输出数据格式为16位二进制补码,可通过I2C数字接口访问.
**ACCEL** 是一款运动数据传感器. 内部集成**ADXL345**三轴加速度计.可测量范围高达±16g(13位分辨率)的加速度数据.输出数据格式为16位二进制补码,可通过I2C数字接口访问(地址0x53).
什么是加速度计?<br>
加速度计是一种加速力的测量设备。这些力可能是静态的(如重力). 或者是动态的由加速度计的移动或振动引起.
@@ -46,6 +46,10 @@
<td>测量范围</td>
<td>±16g</td>
</tr>
<tr>
<td>I2C地址</td>
<td>0x53</td>
</tr>
<tr>
<td>分辨率</td>
<td>10位固定分辨率分辨率随g范围提高而提高,±16 g时高达13位 </td>