diff --git a/docs/assets/img/product_pics/base/basex/basex_01.webp b/docs/assets/img/product_pics/base/basex/basex_01.webp new file mode 100755 index 00000000..07839030 Binary files /dev/null and b/docs/assets/img/product_pics/base/basex/basex_01.webp differ diff --git a/docs/assets/img/product_pics/base/basex/basex_02.webp b/docs/assets/img/product_pics/base/basex/basex_02.webp new file mode 100644 index 00000000..d1069d83 Binary files /dev/null and b/docs/assets/img/product_pics/base/basex/basex_02.webp differ diff --git a/docs/assets/img/product_pics/base/basex/basex_03.webp b/docs/assets/img/product_pics/base/basex/basex_03.webp new file mode 100755 index 00000000..e1b0530b Binary files /dev/null and b/docs/assets/img/product_pics/base/basex/basex_03.webp differ diff --git a/docs/assets/img/product_pics/base/basex/basex_04.webp b/docs/assets/img/product_pics/base/basex/basex_04.webp new file mode 100755 index 00000000..aee0614c Binary files /dev/null and b/docs/assets/img/product_pics/base/basex/basex_04.webp differ diff --git a/docs/en/base/basex.md b/docs/en/base/basex.md new file mode 100644 index 00000000..77435c76 --- /dev/null +++ b/docs/en/base/basex.md @@ -0,0 +1,119 @@ +# BaseX {docsify-ignore-all} + + + +*** + +:memo:**[Description](#Description)**      :🛒**[Purchase](https://m5stack.com/collections/m5-base/products/basex-industrial-board-module)**      :clapper:**[Video](#Video)**    **[EasyLoader](#EasyLoader)** + +## Description + +**BaseX** is a special base compatible with LEGO EV3 motor. The structure design is similar to base26, supporting multiple ways of fixation, and an additional LEGO connection base is provided. When building the LEGO structure, Basex can be easily embedded in the work. Basex can be connected to 4-way (RJ11) LEGO motor at the same time, supporting angle / speed reading and control, and perfectly compatible with the original motor functions. In addition, the base provides two servo interfaces, which can directly control the rotation angle of the servo.There is a motherboard PDM microphone for sound collection. In order to adapt to different use scenarios, a UART interface (16 / 17) and a GPIO interface (26 / 36) are provided to make access to various sensors more flexible. A 900mah battery is built in the base, which can be charged through the usb-c interface of m5core to extend the endurance. In order to improve the driving ability of the interface, the base is equipped with a DC power socket, which can be powered by an external 9-12v power supply to provide a stable power supply for the motor. + + + +## Feature + +- 4-way RJ11 LEGO motor interface (total maximum current 2A) +- 2-way servo interface (total maximum current 2A) +- 1-way UART +- 1-way GPIO +- On board PDM microphone (GOIO 34) +- On board DC-DC conversion (9 ~ 12V,independent power supply for the motor only) +- Built in 900mAh battery +- Multiple fixing methods / LEGO hole connection support + +## Size and Weight + +- Size：54mm * 54mm * 32mm +- Weight：64g + +## Application + +- Encoder motor / servo controller +- LEGO DIY intelligent control + +## I2C Control instructions + +I2C Slave address: 0x22 + + + + + + + + + + + + + + + + + + +
FunctionRegister addressValue
SERVO1_ANGLE_ADDR0X00 0~180
SERVO2_ANGLE_ADDR0x01 0~180
SERVO1_PULSE_ADDR0x10(uint16_t) 500~2500
SERVO2_PULSE_ADDR0x12(uint16_t)500~2500
MOTOR1_PWM_DUTY_ADDR0x20 -127~127
MOTOR2_PWM_DUTY_ADDR0x21 -127~127
MOTOR3_PWM_DUTY_ADDR0x22 -127~127
MOTOR4_PWM_DUTY_ADDR0x23 -127~127
MOTOR1_ENCODER_ADDR0x30 int32_t
MOTOR2_ENCODER_ADDR0x34 int32_t
MOTOR3_ENCODER_ADDR0x38 int32_t
MOTOR4_ENCODER_ADDR0x3C int32_t
MOTOR1_SPEED_ADDR0x40 -127~127
MOTOR2_SPEED_ADDR0x41 -127~127
MOTOR3_SPEED_ADDR0x42 -127~127
MOTOR4_SPEED_ADDR0x43 -127~127
+ +I2C Motor address: + + + + + + +
Motor numberMotor Address
MOTOR10x50
MOTOR20x60
MOTOR30x70
MOTOR40x80
+ +Mode config method: Motor address + nByte + + + + + + + + + + + + +
ByteValue
0Run mode
1position-p(3)
2position-i(1)
3position-d(15)
4|5|6|7position-point
8position-max-speed
9speed-p
10speed-i
11speed-d
12speed-point
+ + + + + +
Motor run modeValue
Normal0X00
Position0x01
Encoder0x02
+ +## Product + +- 1x BaseX +- 1x LEGO base +- 2x M3 * 5mm 304 Stainless steel hexagon socket bolt +- 2x M3 * 32mm 304 Stainless steel hexagon socket bolt +- 1x M3 wrench + +## EasyLoader + + + + + +>1. EasyLoader is a simple and fast program burner. Every product page in EasyLoader provides a product-related case program. This can be burned to the M5 device through simple steps, and a series of function verifications can be performed. + +>After downloading the software, double-click to run the application, connect the M5 device to the computer through the data cable, select the port parameters, click **"Burn"** to burn the program (**For M5StickC, set the baud rate to 115200 or 750000**) + +?>3. Currently EasyLoader is only available for Windows operating system, Before installing and using the Easyloader for M5Core, you need to install CP210X driver (you do not need to install with M5StickC as controller)[Click here to view the driver installation tutorial](en/related_documents/M5Burner#install-usb-driver) + +## Code + +### 1. Arduino IDE + +*To get complete code, please click [here](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Base/BaseX)* + +## Video + + \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 173ff66a..5f165fd2 100644 --- a/docs/index.md +++ b/docs/index.md @@ -136,7 +136,8 @@ {a:"/#/en/base/m5go_charger", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/base/base_m5go_base_01.png", p:"M5GO CHARGER"}, {a:"/#/en/base/base15", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/base/base_base15_01.jpg", p:"BASE15"}, {a:"/#/en/base/base26", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/base/base_base26_01.jpg", p:"BASE26"}, - {a:"/#/en/accessory/battery_base", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/accessory/battery_base_01.jpg", p:"M5Camera Battery"} + {a:"/#/en/accessory/battery_base", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/accessory/battery_base_01.jpg", p:"M5Camera Battery"}, + {a:"/#/en/base/basex", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/base/base_basex_01.webp", p:"BaseX"}, ]; var unit_list = [ diff --git a/docs/zh_CN/README.md b/docs/zh_CN/README.md index 0de8d8d5..86694d9d 100644 --- a/docs/zh_CN/README.md +++ b/docs/zh_CN/README.md @@ -138,7 +138,8 @@ {a:"/#/zh_CN/base/m5go_charger", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/base/base_m5go_base_01.png", p:"M5GO CHARGER"}, {a:"/#/zh_CN/base/base15", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/base/base_base15_01.jpg", p:"BASE15"}, {a:"/#/zh_CN/base/base26", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/base/base_base26_01.jpg", p:"BASE26"}, - {a:"/#/zh_CN/accessory/battery_base", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/accessory/battery_base_01.jpg", p:"M5Camera Battery"} + {a:"/#/zh_CN/accessory/battery_base", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/accessory/battery_base_01.jpg", p:"M5Camera Battery"}, + {a:"/#/zh_CN/base/baseX", img:"https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_homepage/base/base_basex_01.webp", p:"BaseX"}, ]; var unit_list = [ diff --git a/docs/zh_CN/base/basex.md b/docs/zh_CN/base/basex.md new file mode 100644 index 00000000..3c3d2314 --- /dev/null +++ b/docs/zh_CN/base/basex.md @@ -0,0 +1,118 @@ +# BaseX {docsify-ignore-all} + + + +*** + +:memo:**[描述](#描述)**      :electric_plug:**[原理图](#原理图)**      🛒**[购买链接](https://m5stack.com/collections/m5-base/products/basex-industrial-board-module)**      :clapper:**[相关视频](#相关视频)**    **[EasyLoader](#EasyLoader)** + +## 描述 + +**BaseX** 是一款兼容乐高EV3电机的专用底座，结构设计上与BASE26类似，支持多种方式进行固定，并且额外提供一个乐高连接底座，在搭建乐高结构时可以将BaseX轻松嵌入到作品中。BaseX可同时接入4路(RJ11)乐高电机，支持角度/速度的读取和控制，完美兼容原有电机功能。此外，底座提供2个舵机接口，可以直接控制舵机旋转角度,一个内置的PDM麦克风可以采集声音。为了适应不同的使用场景，提供一个UART接口（16/17)与一个GPIO接口(26/36），接入各类传感器更加灵活。底座内置一块900mAh电池，可通过M5Core的USB-C接口进行充电，延长使用续航时间。为了提高接口的驱动能力，在底座上配备了DC电源座，可以通过外部9-12V电源为电机供电。 + + + +## 产品特性 + +- 4路RJ11乐高电机接口（合计最大电流2A） +- 2路舵机驱动（合计最大电流2A） +- 1路UART +- 1路GPIO +- 内置PDM麦克风(GPIO 34) +- 板载DC-DC转换(9 ~ 12V输入，仅为电机独立供电) +- 内置900mAh电池 +- 多种固定方式/支持乐高孔连接 + +## 尺寸重量 + +- 尺寸：54mm * 54mm * 32mm +- 重量：64g + +## 应用 + +- 乐高编码电机/舵机控制器 +- 乐高玩具DIY智能控制 + +## I2C控制说明 + +I2C 从机地址: 0x22 + + + + + + + + + + + + + + + + + + +
功能 寄存器地址值
SERVO1_ANGLE_ADDR0X00 0~180
SERVO2_ANGLE_ADDR0x01 0~180
SERVO1_PULSE_ADDR0x10(uint16_t) 500~2500
SERVO2_PULSE_ADDR0x12(uint16_t)500~2500
MOTOR1_PWM_DUTY_ADDR0x20 -127~127
MOTOR2_PWM_DUTY_ADDR0x21 -127~127
MOTOR3_PWM_DUTY_ADDR0x22 -127~127
MOTOR4_PWM_DUTY_ADDR0x23 -127~127
MOTOR1_ENCODER_ADDR0x30 int32_t
MOTOR2_ENCODER_ADDR0x34 int32_t
MOTOR3_ENCODER_ADDR0x38 int32_t
MOTOR4_ENCODER_ADDR0x3C int32_t
MOTOR1_SPEED_ADDR0x40 -127~127
MOTOR2_SPEED_ADDR0x41 -127~127
MOTOR3_SPEED_ADDR0x42 -127~127
MOTOR4_SPEED_ADDR0x43 -127~127
+ +I2C 电机地址: + + + + + + +
电机编号电机地址
MOTOR10x50
MOTOR20x60
MOTOR30x70
MOTOR40x80
+ +配置方法 +电机地址 + nBit + + + + + + + + + + + + +
位值
0电机运行模式
1position-p(3)
2position-i(1)
3position-d(15)
4|5|6|7position-point
8position-max-speed
9speed-p
10speed-i
11speed-d
12speed-point
+ + + + + +
电机运行模式值
Normal0X00
Position0x01
Encoder0x02
+ +## 套件清单 + +- 1x BaseX +- 1x 乐高底座 +- 2x M3 * 5mm 304不锈钢内六角螺栓 +- 2x M3 * 32mm 304不锈钢内六角螺栓 +- 1x M3内六角扳手 + +## EasyLoader + + + + + +>1.EasyLoader是一个简洁快速的程序烧录器，每一个产品页面里的EasyLoader都提供了一个与产品相关的案例程序，通过简单步骤将其烧录至主控，能够进行一系列的功能验证.**(目前EasyLoader仅适用于Windows操作系统)** + +>2.下载软件后，双击运行应用程序，将M5设备通过数据线连接至电脑,选择端口参数，点击 **"Burn"** 即可开始烧录.(**为M5StickC烧录时，请将波特率设置在750000或115200**) + +## 例程 + +### 1. Arduino IDE + +[点击此处](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Base/BaseX)，获取完整程序. + +## 相关视频 + + \ No newline at end of file