diff --git a/.gitignore b/.gitignore index 298086e..4da577f 100644 --- a/.gitignore +++ b/.gitignore @@ -5,7 +5,8 @@ .LSOverride # Icon must end with two \r -Icon +Icon + # Thumbnails ._* @@ -29,6 +30,7 @@ Temporary Items # ---> JetBrains # Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider # Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839 +.idea # User-specific stuff .idea/**/workspace.xml diff --git a/car/assemble.md b/car/assemble.md new file mode 100644 index 0000000..4b9fc14 --- /dev/null +++ b/car/assemble.md @@ -0,0 +1,13 @@ +## 组装教程 + + + +## 面板介绍 + + \ No newline at end of file diff --git a/car/delivery.md b/car/delivery.md new file mode 100644 index 0000000..d0c2a19 --- /dev/null +++ b/car/delivery.md @@ -0,0 +1,42 @@ +## 收货指南 + + +Autolabor Pro1 机器人发货清单: + +| 序号 | 名称 | 发货数量(件) | 明细 | +|----|----------------------|---------|------------------------------------| +| 1 | Autolabor M2 3D+RTK版 | 3 | 机器人底盘 x1
导航套件 x1
显示器 x1 | +| 2 | Autolabor M2 RTK版 | 3 | 机机器人底盘 x1
导航套件 x1
显示器 x1 | +| 3 | Autolabor M2 3DSLAM版 | 3 | 机器人底盘 x1
导航套件 x1
显示器 x1 | +| 4 | Autolabor M2 底盘版 | 1 | 机器人底盘 x1 | + + +### 检查 + +收到货后请不要急于签收,先检查外包装有无破损,如包装破损或贴于外包装上的防震标签感应器显示为红色,请拍照为证,并与快递员一同开箱验货,确认无误后再签收,如需帮助可联系 Autolabor 客户服务平台。 + +![](imgs/slamSet-label.png "防震标签") + +## 清点 + +温馨提示: + +* 收件后打开包装,对照产品装箱单进行清点,如有短缺请于三日内联系客服,过期不补。 +* 请保留原厂外包装箱用于售后。 +* 部分配件可能随版本升级有所改动,但不影响性能,恕不另行通知。 + +*** + + diff --git a/car/imgs/2.png b/car/imgs/2.png new file mode 100644 index 0000000..a2bc077 Binary files /dev/null and b/car/imgs/2.png differ diff --git a/car/imgs/slamSet-label.png b/car/imgs/slamSet-label.png new file mode 100644 index 0000000..11dcdda Binary files /dev/null and b/car/imgs/slamSet-label.png differ diff --git a/car/imgs/software/image-20240627100358442.png b/car/imgs/software/image-20240627100358442.png new file mode 100644 index 0000000..7e8879d Binary files /dev/null and b/car/imgs/software/image-20240627100358442.png differ diff --git a/car/imgs/software/image-20240627103707291.png b/car/imgs/software/image-20240627103707291.png new file mode 100644 index 0000000..9d81fad Binary files /dev/null and b/car/imgs/software/image-20240627103707291.png differ diff --git a/car/imgs/software/image-20240627104617412.png b/car/imgs/software/image-20240627104617412.png new file mode 100644 index 0000000..cf105a8 Binary files /dev/null and b/car/imgs/software/image-20240627104617412.png differ diff --git a/car/parameter.md b/car/parameter.md new file mode 100644 index 0000000..3ecb6f0 --- /dev/null +++ b/car/parameter.md @@ -0,0 +1,188 @@ +## 规格参数 + +### 底盘 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
尺寸1040 mm*700mm *430 mm驱动形式双轮独立驱动
轴距650mm转向形式阿卡曼转向
轮距600mm悬挂形式四轮双叉臂式独立悬挂
最大速度10km/h电池参数磷酸铁锂 90AH 24V
总质量80kg续航时间12小时
最小转弯半径1.2m续航里程80公里
最大爬坡度30°编码器4096线
离地高度110mm对外通信接口RS232
驻车电子驻车防护等级IP54
驱动电机500W对外供电24V
转向电机250W遥控距离50M
+ +### 上位机(Orin NX) + +| 项目 | 规格 | +|-------|-----------------------------------------| +| 算力 | 100TOPS | +| GPU | 32个Tensor核心1024核 | +| CPU | 8核Arm Cortex-A78 2GHz | +| 内存 | 16GB 128位LPDDR5 102.4GB/s | +| 存储 | 128GB | +| 视频编解码 | H.265 | +| PCIe | 1X4+3X1 PCIe4.0 | +| 显示接口 | HDMI2. 1 1x8K30DP | +| 网卡 | 内置 | +| I/O | USB3.0/SCI/I2C/CAN/DMIC/ DSPK/I2S/GPIOs | + +### 显示器 + +| 项目 | 规格 | +|-----|-----------| +| 尺寸 | 13.3 英寸 | +| 比例 | 16: 9 | +| 分辨率 | 1920*1080 | +| 亮度 | 300 cd/m² | +| 对比度 | 800: 1 | +| 触摸 | 否 | + +### 多线激光雷达(RS-Helios-16p) + +| 项目 | 规格 | +|----------|------------------------------------------------------------| +| 线数 | 16 | +| 激光波长 | 905nm | +| 激光安全等级 | Class 1 人眼安全 | +| 测距能力 | 150m(90m@10% NIST) | +| 盲区 | ≤0.2m | +| 精度(典型值) | ±2cm(1m to 100m)
±3cm(0.1m to 1m)
±3cm(100m to 150m) | +| 水平视场角 | 360° | +| 垂直视场角 | 30°(-15°~+15°) | +| 水平角分辨率 | 0.2°/0.4° | +| 垂直角分辨率 | 均匀 2° | +| 帧率 | 10Hz/20 Hz | +| 转速 | 600/1200rpm (10/20Hz) | +| 出点数 | ~288,000pts/s(单回波)
~576,000pts/s(双回波) | +| UDP数据包内容 | 三维空间坐标
反射强度
时间戳等 | +| 输出数据协议 | UDP packets over Ethernet | +| 时间同步 | ≈ GPRMC with 1PPS,PTP&gPTP | + +### 卫星接收机(RTK580) + +| 项目 | 规格 | +|------------|--------------------------------------| +| 通道 | 1408 通道 | +| 频点 | 5星多频
BDS、GPS、QZSS、GLONASS、Galileo | +| 单点定位 (RMS) | 平面 1.5m 高程 2.5m | +| RTK(RMS) | 平面 0.8cm+1ppm ;高程 1.5cm+1ppm | +| 冷启动 | <30s | +| RTK 初始化时间 | <5s( 典型值 ) | +| 初始化可靠性 | >99.9% | +| 差分通讯方式 | 免DTU模块 | +| 差分数据 | RTCM 3.X | +| 数据格式 | NMEA 0183 Unicore | +| 定位测向数据更新率 | 20Hz | +| 原始观测量数据更新率 | 20Hz | +| 定向精度 (RMS) | 0.1° /1m 基线 | +| 时间精度 (RMS) | 20ns | +| 速度精度 (RMS) | 0.03m/s | +| 双天线接口 | SMA公头外螺内孔 * 2 | +| 通讯接口 | USB-Type-C | +| 供电接口 | USB-Type-C/XT-30 | +| 供电电压 | 5-15V | +| 功耗 | 2.4W | +| 尺寸 | 93mmx69mmx37mm | +| 重量 | 153g | + +### 惯导(CH104M) + +| 项目 | 规格 | +|------|-------------------------------------------------| +| 姿态角 | 横滚/俯仰:0.2°
偏航(静态):0.2°°
偏航(动态):3° | +| 陀螺仪 | 测量范围:±2000°/s
分辨率:0.01°/s
零偏稳定性:1.76°/hr | +| 加速度计 | 测量范围:±8G
分辨率:1uG
零偏稳定性:30uG | +| 磁传感器 | 测量范围:±8G(Gauss)
非线性度:±0.1%
分辨率:0.25mG | + +### 激光雷达(LD19) + +| 参数名称 | 单位 | 最小值 | 典型值 | 最大值 | 备注 | +|:------|:-----|:------|:-----|:----|:-----------------------------------------| +| 测距范围 | m | 0.02 | - | 12 | 70%目标反射率 | +| 扫描频率 | Hz | 5 | 10 | 13 | 外部提供PWM 控速 | +| 测距频率 | Hz | - | 4500 | - | 固定频率 | +| 测距精度 | mm | - | - | - | 测距小于0.3m时,有数据输出。
测距数据变化趋势与实际距离变化趋势一致 | +| 测距精度 | m | -45 | - | 45 | 测距范围在300mm到12000mm时,测量100次的平均值(70%漫反射面) | +| 测距标准差 | mm | - | 10 | - | 测距范围在300mm到12000mm时 | +| 测量分辨率 | mm | - | 15 | - | | +| 角度误差 | ° | - | - | 2 | | +| 角度分辨率 | ° | - | 1 | - | | +| 抗环境光 | KLux | - | - | 30 | | +| 整机寿命 | h | 10000 | - | - | | + +### 深度相机(Vzense DCAM710) + +| 项目 | 规格 | +|----------|--------------------------| +| 尺寸 | 103mmx33mmx22mm | +| 传感器 | ToF CCD+RGB | +| 激光发射器 | 940nm VCSEL | +| ToF分辨率帧率 | 640X480, Max.30fps | +| RGB分辨率帧率 | 1920X1080, 30fps | +| ToF FOV | 69°(H) × 51°(V) | +| RGB FOV | 73°(H)X42°(V) | +| 输出格式 | RAW12(深度,IR), MJPEG(RGB) | +| 检测距离 | 0.35m~4.4m | +| 工作温度 | -10℃~50℃ | + + diff --git a/car/software.md b/car/software.md new file mode 100644 index 0000000..16d187d --- /dev/null +++ b/car/software.md @@ -0,0 +1,248 @@ +# 软件介绍 + +## 完整视频 + +以下为完整介绍视频,包含全部文档内容。 + + + +## 功能简介 + + + +### 启动入口 + +Autolabor M2软件的所有功能启动入口都在桌面的相应文件夹内 + +包括 + +1. 2D SLAM +2. 3D SLAM +3. RTK 寻迹 +4. 硬件测试 + +### 2D SLAM 过程 + +#### 启动 + +点击桌面图标 SLAM 建图导航->2D->开始建图 + +#### 建图过程 + +使用配套的控制手柄控制机器人平台移动,覆盖空间中的待建图区域。 + +使用手柄时,注意手柄已经正确连接,并且解除了底盘急停状态,详情可参考手柄使用说明。 + +建图过程中,注意控制移动速度,应不高于手柄二挡,并且尽量走S形路线覆盖建图区域。 + +建图的质量将直接影响后续定位和导航的效果,如建图质量不佳可重新进行。 + +SLAM算法适用于周围有明显特征的人造环境(室内),例如有平整的墙面,直角特征。 + +不适用于琐碎复杂的环境,例如有较多桌腿或凳子腿,窗帘捶地,有较多植物。 + +#### 保存 + +建图完成后点击 SLAM建图导航->2D->保存并停止建图,然后等待rviz窗口退出,即保存完成。 + +构建好的地图将保存在 /home/autolabor/catkin_ws/src/applications/autolabor/m2/2dslam_cartographer/data 路径下 + +文件名为 map.pbstream. + +### 3D SLAM 过程 + +#### 启动 + +点击桌面图标 SLAM 建图导航->3D->开始建图 + +#### 建图过程 + +使用配套的控制手柄控制机器人平台移动,覆盖空间中的待建图区域。 + +使用手柄时,注意手柄已经正确连接,并且解除了底盘急停状态,详情可参考手柄使用说明。 + +建图过程中,注意控制移动速度,应不高于手柄二挡,并且尽量走S形路线覆盖建图区域。 + +建图的质量将直接影响后续定位和导航的效果,如建图质量不佳可重新进行。 + +SLAM算法适用于周围有明显特征的人造环境(室内),例如有平整的墙面,直角特征。 + +不适用于琐碎复杂的环境,例如有较多桌腿或凳子腿,窗帘捶地,有较多植物。 + +#### 保存 + +建图完成后点击 SLAM建图导航->3D->保存并停止建图,然后等待rviz窗口退出,即保存完成。 + +构建好的地图将保存在 /home/autolabor/catkin_ws/src/applications/autolabor/m2/3dslam_cartographer/data 路径下 + +文件名为 map.pbstream. + +### RTK 寻迹 + +#### 配置千寻账号 + +RTK寻迹功能在使用前需配置千寻账号和4G网卡,确保机器人平台可以连接互联网。 + +打开 /home/autolabor/catkin_ws/src/applications/autolabor/m2/rtktracking_mpc/rtktracking_mpc.launch 文件 + +编辑 al_rtk_ros_driver 节点中的 account 和 password 属性,替换成您自己的千寻账号和密码。 + +![image-20240627100358442](imgs/software/image-20240627100358442.png) + +#### 4G网络 + +准备与Linux 兼容的USB 4G网卡和4G SIM 卡,插入主机USB接口,确认互联网连接正常即可。 + +可使用系统附带的浏览器访问互联网网站测试。 + +主要注意,由于主机以太网网口已经被多线激光雷达占用,并将默认路由指向了以太网网口。如果4G网卡在系统启动前插入USB口可能造成无法连接互联网。 + +可通过拔掉4G网卡再插入的方式解决。 + +通过WIFI连接互联网同理,如遇到无法连接互联网的情况,可通过关闭WIFI再重新打开解决。 + +## 文件的组织形式 + + + +### 工作空间 + +Autolabor M2 套件的ROS工作空间位于 /home/autolabor/catkin_ws 目录下 + +![image-20240627103707291](imgs/software/image-20240627103707291.png) + +包含所有ros软件包的源代码、launch文件、算法配置文件和urdf文件。 + +其中软件包位于 catkin_ws/src/ 路径下 + +启动launch文件和配置文件位于 catkin_ws/src/applications/autolabor/m2 路径下 + +### 软件包 + +1. driver 包含所有硬件驱动程序 +2. mapping 包含用于2D/3D SLAM建图的cartographer 算法包 +3. navigation 包含 move base 全局路径规划器、MPC 局部路径规划器、TEB局部路径规划器、Autolabor粒子滤波、Autolabor寻迹 + +### 配置文件 + +M2 的所有配置文件位于 catkin_ws/src/applications/autolabor 目录下,此目录下内容不建议修改,如需修改可通过派生修改的方式 + +![image-20240627104617412](imgs/software/image-20240627104617412.png) + +1. 2dslam_cartographer 2d cartographer 建图和定位的启动文件和配置 +2. 3dslam_cartographer 3d cartographer 建图和定位的启动文件和配置 +3. rtktracking_mpc 北斗RTK寻迹导航的启动文件和配置 +4. base_launch 底盘驱动launch文件 +5. urdf 机器人描述文件 +6. test 硬件测试 +7. desktop 桌面快捷方式 + +对于1、2、3 的子目录 + +config 保存所有配置文件 + +data 保存用户数据,例如地图,RTK展开点坐标 + +## 自定义配置 + + + +当您需要修改配置或者组织自己launch文件时,我们建议您不要修改 applications/autolabor 目录下的内容, + +而是在 applications 目录下创建一个自定义的目录,并创建包文件(package.xml 和 CMakelist.txt). +将autolabor/m2下您需要对应的功能目录复制到您自定义目录下,修改编译。 + +具体步骤如下 + +1. 在 applications 目录下创建自定义目录 custom (名字可按照您需求修改) +2. 复制 applications/autolabor/m2 目录下 CMakeLists.txt 和 package.xml 文件到custom目录下 +3. 使用文本编辑器打开 CMakelists.txt ,修改 project(m2) 为 project(custom) , 需要与目录名一致 +4. 使用文本编辑器打开 package.xml, 修改 m2custom +5. 复制您需要的功能目录到custom 目录,例如 2dslam_cartographer +6. 使用终端进入到custom包所在目录 cd ~/catkin_ws/src/applications/custom +7. 编译 catkin build --this +8. source 环境变量 source ~/catkin_ws/devel/setup.bash + +这样您可以在自定义包中修改launch文件和配置文件。而不会影响官方文件,当您的配置出现故障时可重复以上步骤恢复。 + +## 配置文件介绍 + + + +### 2D SLAM + +2dslam_cartographer 目录下 + +create_map_start.sh 建图启动脚本 + +create_map_stop.sh 停止并保存地图脚本 + +navigation_start.sh 导航脚本 + +navigation_stop.sh 停止导航脚本 + +2dslam_cartographer_mapping.launch 建图启动launch文件 + +2dslam_cartographer_navigation.launch 导航启动文件 + +config 目录下包含cartographer 建图/定位的配置文件,以及move base 全局路径规划器,局部路径规划器配置文件。 + +data 目录保存用户构建的地图文件,文件名为 map.pbstream + +### 3D SLAM + +3dslam 的文件结构与2dslam完全相同 + +### RTK寻迹 + +rtktracking_mpc 文件夹下保存rtk寻迹功能所需的launch文件和配置 + +rtktracking_mpc_start.sh rtk寻迹启动脚本 + +rtktracking_mpc_stop.sh rtk寻迹停止脚本 + +rtktracking_mpc.launch 启动launch + +config 目录包含 move base 全局路径规划器,局部路径规划器配置文件 + +data 目录保存WGS84到平面直角坐标系展开点配置文件 + +## 硬件测试 + + + + +硬件测试启动入口位于桌面硬件测试目录下,点击对应的图标即可启动 + +针对m2套件包含 + +1. 2D激光雷达测试 +2. 3D激光雷达测试 +3. IMU测试 +4. 底盘遥控测试 +5. RTK测试 (需配置千寻账号,4G网卡,室外环境) + +M2套件不支持PICO深度相机测试 + + + + + diff --git a/car/use.md b/car/use.md new file mode 100644 index 0000000..e45d69a --- /dev/null +++ b/car/use.md @@ -0,0 +1,97 @@ +## 手柄控制 + +M2可以使用手柄控制和上位机控制两种方式来控制,手柄控制权限高于上位机控制,下面将概述手柄控制方式。 + + + +### 概述 + +我们配送一个控制手柄用于控制M2移动。 + +![2.png](imgs/2.png) + +### 使用说明 + +#### 手柄操作步骤 + +1. 长按手柄HOME键,灯光亮起,自动匹配。 +2. 匹配成功后,手柄会震动一下,跑马灯最左侧与最右侧灯常亮。 +3. 同时按下顶部L、LZ、R、RZ四键,手柄解锁。 +4. 在遥控底盘运动、调整线速度、调整角速度的时候需要长按L、LZ、R、RZ四键中任意一键。 + +#### 手柄按键说明 + +我们对于M2的手柄控制设计有几种速度档位,如下表。 + + + + + + + + + + + + + + + + + + + + +
档位0档1档2档3档4档5档
速度16%33%50%66%83%100%
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
按键功能备注
左侧摇杆键控制M2前进与后退控制摇杆推动的力度控制速度,轻推低速移动,推到底为当前档位最高速
右侧摇杆键控制M2左右转向控制摇杆推动的力度控制角度,轻推小角度转向,推到底为最大角转向,松开自动回正
中区“—”键速度减档每按一下,速度降低一档,最低不得高于最底档,如0档
中区“+”键速度加档每按一下,速度提高一档,最高不得高于最高档,如5档
左区4控制键前/后/左/右控制运动方向
右区4控制键前/后/左/右控制运动方向
HOME键开机/急停紧急情况下,可按HOME键,M2会紧急刹车
顶部4控制键解锁/防误触手柄连接成功后,需同时按下4键解锁,控制时需长按任意一键,行驶过程中松开,M2会缓刹
+ diff --git a/conf.json b/conf.json new file mode 100644 index 0000000..a91e298 --- /dev/null +++ b/conf.json @@ -0,0 +1,54 @@ +{ + "_readme": [ + "注:uri 必须保障唯一性,若有重复引用,请使用 rewrite 注册新的 uri", + "由于设计缺陷,rewrite 时只能自定义最后一级路径", + "uri 格式 1 - 相对文档:a/b/c", + "uri 格式 2 - 相对站内:/usedoc/ap1/a/b/c", + "uri 格式 3 - 绝对地址:https://www.baidu.com", + "_readme 本身并没有什么用" + ], + "index": "car/overview", + "rewrite": { + }, + "plugin": { + "emoji": false, + "taskList": true, + "tex": true, + "flowChart": true, + "sequenceDiagram": true + }, + "menu": { + "toc": { + "startLevel": "0", + "overLevel": "0" + }, + "items": [ + { + "name": "Autolabor M2底盘", + "isOpen": true, + "items": [ + { + "name": "收货指南", + "uri": "car/delivery" + }, + { + "name": "组装教程", + "uri": "car/assemble" + }, + { + "name": "手柄控制", + "uri": "car/use" + }, + { + "name": "软件介绍", + "uri": "car/software" + }, + { + "name": "规格参数", + "uri": "car/parameter" + } + ] + } + ] + } +} \ No newline at end of file