diff --git a/docs/.vitepress/config/nav.ts b/docs/.vitepress/config/nav.ts index 83e8150..2e5f299 100644 --- a/docs/.vitepress/config/nav.ts +++ b/docs/.vitepress/config/nav.ts @@ -3,7 +3,6 @@ import type { DefaultTheme } from "vitepress"; //导航栏 export const nav: DefaultTheme.Config['nav'] = [ - { text: '首页', link: '/' }, { text: '官网', link: 'https://www.tianbot.com' }, { text: 'ROS 产品文档', @@ -56,10 +55,6 @@ export const nav: DefaultTheme.Config['nav'] = [ }, { text: '关于我们', - // link: 'https://www.tianbot.com/page?id=4', - items: [ - { text: '联系我们', link: 'contact' }, - { text: '我们的社群', link: 'community'} - ], + link: 'about', }, ]; \ No newline at end of file diff --git a/docs/.vitepress/config/sidebar.ts b/docs/.vitepress/config/sidebar.ts index 490babe..0ea1807 100644 --- a/docs/.vitepress/config/sidebar.ts +++ b/docs/.vitepress/config/sidebar.ts @@ -238,33 +238,36 @@ export const sidebar: DefaultTheme.Config['sidebar'] = { '/': [ { //分组标题 1 - text: '💿 ROS2GO', - collapsed: true, - link: '/ros2go/guide/', + text: 'ROS2GO', + collapsed: false, items: [ { text: '使用手册', collapsed: true, link: '/ros2go/guide/', items: [ - { text: '如何启动', link: '/ros2go/guide/how-to-start' }, - { text: '如何备份', link: '/ros2go/guide/how-to-backup-by-timeshift' }, + { text: '如何启动', link: '/ros2go/guide/how-to-start', }, + { text: '如何备份', link: '/ros2go/guide/how-to-backup', }, { text: '如何恢复', link: '/ros2go/guide/how-to-recover' }, { text: '如何升级', link: '/ros2go/guide/how-to-update' }, ], }, { text: '设备兼容', - link: '/ros2go/applicable/', + collapsed: true, + link: '/ros2go/applicable', + items: [ + { text: 'Apple 笔记本(x86)', link: '/ros2go/applicable/macbook' }, + ], }, - { text: '常见问题', link: '/ros2go/question' }, + { text: '常见问题', link: '/ros2go/faq' }, { text: '更新日志', link: '/ros2go/changelog' }, ], }, { //分组标题 2 - text: '🚚 TOM', - collapsed: true, + text: 'TOM', + collapsed: false, link: '/tianbot/', items: [ { text: '注意事项', link: '/tianbot/notice' }, @@ -324,8 +327,8 @@ export const sidebar: DefaultTheme.Config['sidebar'] = { }, { //分组标题 3 - text: '🏁 TIANRACER', - collapsed: true, + text: 'TIANRACER', + collapsed: false, link: '/tianracer/', items: [ { text: '注意事项', link: '/tianracer/notice' }, @@ -381,8 +384,8 @@ export const sidebar: DefaultTheme.Config['sidebar'] = { }, { //分组标题 3 - text: '🚀 TIANROVER', - collapsed: true, + text: 'TIANROVER', + collapsed: false, link: '/tianrover/', items: [ { text: '注意事项', link: '/tianrover/notice' }, @@ -403,8 +406,8 @@ export const sidebar: DefaultTheme.Config['sidebar'] = { }, { //分组标题 4 - text: '🚗 TIANBOT MINI', - collapsed: true, + text: 'TIANBOT MINI', + collapsed: false, link: '/tianbot_mini/', items: [ { text: '注意事项', link: '/tianbot_mini/notice' }, @@ -541,8 +544,8 @@ export const sidebar: DefaultTheme.Config['sidebar'] = { }, { //分组标题 5 - text: '🚁 ROBOMASTER TT', - collapsed: true, + text: 'ROBOMASTER TT', + collapsed: false, items: [ { text: '开箱说明', link: '/rmtt/list' }, { text: '使用手册', link: '/rmtt/' }, @@ -552,8 +555,8 @@ export const sidebar: DefaultTheme.Config['sidebar'] = { }, { //分组标题 6 - text: '📢 ROSECHO', - collapsed: true, + text: 'ROSECHO', + collapsed: false, items: [ { text: '开箱说明', link: '/rosecho/' }, { text: '使用手册', link: '/rosecho/guide/' }, diff --git a/docs/about.md b/docs/about.md new file mode 100644 index 0000000..b3b1fef --- /dev/null +++ b/docs/about.md @@ -0,0 +1,57 @@ +# 联系我们 + +## 销售咨询 + +E-mail: sales@tianbot.com + +微信:[WeChat](https://work.weixin.qq.com/kf/kefu/qrcode?kfcode=kfc023b1f66e23716fd) + +
+ 销售咨询二维码 +
+ +## 微信公众号 + +
+ 微信公众号二维码 +
+ +## 微信群 + +售后专用,方便快捷。 + +
+ 微信群二维码 +
+ +## QQ 交流群 + +基于 QQ 的跨平台性(在 Linux 下)长时间的聊天记录存储,成员数量上限的优势,便于资料分享,气氛活跃。 + +
+ QQ群二维码 +
+ +## Bilibili + +为大家提供更加直观的视频学习途径。 + +
+ Bilibili二维码 +
+ +动动你的金手指,点击链接,关注我们 https://space.bilibili.com/451561151/ + +
+ Bilibili关注二维码 +
+ +## ROS2GO QQ 频道 + +便于问题汇总,答疑及知识沉淀、内容分享,方便后来人拾级而上。 + +点击链接加入 QQ 频道【ROS2GO 交流群】:https://pd.qq.com/s/ff87jqozl + +
+ ROS2GO QQ频道二维码 +
diff --git a/docs/community.md b/docs/community.md deleted file mode 100644 index 661c2b7..0000000 --- a/docs/community.md +++ /dev/null @@ -1,39 +0,0 @@ -# 我们的社群 - -## 微信公众号 - -
- -
- -## 微信群 - -售后专用,方便快捷。 - -
- -
- -## QQ 交流群 - -基于 QQ 的跨平台性(在 Linux 下)长时间的聊天记录存储,成员数量上限的优势,便于资料分享,气氛活跃。 - -![](https://tianbot-pic.oss-cn-beijing.aliyuncs.com/tianbot-pic/Tianbot-DocEE036F120C72CDA9F14B40BB678C2EE9.jpg) - -## BiliBlil 账号 - -为大家提供更加直观的视频学习途径。 - -![](https://tianbot-pic.oss-cn-beijing.aliyuncs.com/tianbot-pic/Tianbot-Docimage-20231124165545081.png) - -动动你的金手指,点击链接,关注我们 https://space.bilibili.com/451561151/ - -![](https://tianbot-pic.oss-cn-beijing.aliyuncs.com/tianbot-pic/Tianbot-DocE0367978F9AC6798B840EF2F568D40E8.jpg) - -## ROS2GO 官方频道 - -便于问题汇总,答疑及知识沉淀、内容分享,方便后来人拾级而上。 - -点击链接加入 QQ 频道【ROS2GO 交流群】:https://pd.qq.com/s/ff87jqozl - -![qq_guild_qrcode1710053909486](https://github.com/tianbot/tianbot_docs/assets/150599200/0b95e8c3-e8ef-4abc-8a0e-1f91f261c524) diff --git a/docs/contact.md b/docs/contact.md deleted file mode 100644 index a8d2f79..0000000 --- a/docs/contact.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -aside: false ---- - -# 联系我们 - -## Contract: - -有问题请在 [Issues](https://github.com/tianbot/tianbot_docs/issues) -或者 [WeChat](https://work.weixin.qq.com/kf/kefu/qrcode?kfcode=kfc023b1f66e23716fd) 联系我们。 - -* Admin:Tianbot -* E-mail: sales@tianbot.com - - -
- -
\ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 2c2bdf5..abdd406 100644 --- a/docs/index.md +++ b/docs/index.md @@ -20,10 +20,10 @@ hero: link: https://space.bilibili.com/451561151 features: - - icon: 💿 + - icon: GO! title: ROS2GO details: 轻松获取完整的 ROS 开发环境体验,秒级启动、随用随走、无需复杂环境配置、不伤宿主 Windows 系统、多维度恢复能力让小白也可无惧折腾... - link: /ros2go/ + link: /ros2go/guide/ - icon: 🚚 title: TOM details: 自主移动机器人平台系列,主要面向科研教育行业的高性能开源全向移动底盘,提供开源控制程序、开发文档,支持使用 USB、CAN、UART 等作为外部通信接口,可灵活使用打造自己独特的机器人方案... diff --git a/docs/ros2go/applicable/index.md b/docs/ros2go/applicable/index.md index 4b9eb09..2ad62c1 100644 --- a/docs/ros2go/applicable/index.md +++ b/docs/ros2go/applicable/index.md @@ -1,8 +1,12 @@ # 设备兼容说明 -## 电脑/笔记本 +Linux 系统的硬件兼容性是一个长期存在且十分棘手的问题,通常 Ubuntu 系统的长期支持(LTS)版本硬件驱动会落后最新的 Linux 硬件驱动 1~2 年,然后最新 Linux 硬件驱动又会落后于 Windows 硬件驱动。 -> 我们通过直接编译最新的 Linux [主线内核](https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git),让 ROS2GO 拥有了**兼容市面上绝大多数设备**的能力。 +由于需要同时支持 ROS1、ROS2,我们只能将 Ubuntu 系统钉到远古的 20.04 LTS 版本😭,也就是说如果完全依赖 Ubuntu 系统的硬件驱动,将落后于主流硬件驱动至少五年,这样 ROS2GO 根本无法兼容大部分硬件,尤其是近年来新出的新品。 + +为了解决这个难题,我们完全放弃了 Ubuntu 官方落后的内核、固件❎,转而通过**魔改内核、直接对接上游固件**的方式✅,使得 ROS2GO 拥有了🔨**兼容市面上绝大多数设备**的能力。但仍然无法做到十全十美,如果您在使用中发现不兼容的设备,请及时通过 QQ 群、频道、微信群等反馈,我们开发人员会第一时间处理。若少数不兼容的设备短时间无法解决,我们也希望您能够理解♥️。 + +## 内核 {#kernel} ### 使用指南 @@ -29,7 +33,47 @@ journalctl -ek 3. 您也可以到我们的 QQ 频道`晒机`板块,寻找可能与您同配置的机器解决方案 -### 早期测试视频 +## 固件 {#firmware} + +### 使用指南 + +> 注:早期版本`v20241019之前`可能有一些过时的包,需要先卸载:`sudo apt purge -y drivers-linux-firmware 2>/dev/null && sudo apt purge -y linux-firmware 2>/dev/null` + +1. 下载固件包`截至2024/11/16`:https://github.com/tianbot/tianbot_docs/releases/download/f20241110/linux-firmware-upstream_20241110-12-ga5b0ee21_all.deb +2. 安装:`sudo dpkg -i linux-firmware-upstream*.deb` +3. 重启机器,enjoy! + +### 问题反馈 + +> 如果您在使用中发现不兼容的设备,请及时通过 QQ 群、频道、微信群等反馈,我们开发人员会第一时间处理。 + +为方便开发人员迅速定位问题,找到解决方案,请您反馈时带上如下命令的返回信息: + +```shell +lspci -k | grep -A 3 -i net +``` + +输出示例`不同的硬件会有不同的输出`: + +``` +03:00.0 Ethernet controller: Realtek Semiconductor Co., Ltd. RTL8111/8168/8211/8411 PCI Express Gigabit Ethernet Controller (rev 15) + DeviceName: Realtek RTL8111E Ethernet LOM + Subsystem: Lenovo Device 390b + Kernel driver in use: r8169 + Kernel modules: r8169 +04:00.0 Network controller: Intel Corporation Wi-Fi 6 AX200 (rev 1a) + Subsystem: Intel Corporation Device 0080 + Kernel driver in use: iwlwifi + Kernel modules: iwlwifi +``` + +## 硬件兼容性 {#hardware} + +### 笔记本 + +一般台式机兼容性都比较好,笔记本则需要注意,以下是早期已经确认支持的部分笔记本型号。新机型的兼容性报告请移步至 QQ 频道`晒机`板块查看。 + +#### 测试视频 【ROS2GO】ROS随身系统使用教程之笔记本兼容性联想小新Pro13锐龙版2020 @@ -66,44 +110,29 @@ journalctl -ek style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"> +### 网卡 + +> 一般有线网卡大概率不会有驱动问题。无线网卡则需要注意,以下是部分已经确认支持的无线网卡型号: + +- Intel® Wi-Fi 7 BE202 +- Intel® Wi-Fi 7 BE200 +- Intel® Wi-Fi 6E AX411 (Gig+) +- Intel® Wi-Fi 6E AX211 (Gig+) +- Intel® Wi-Fi 6E AX210 (Gig+) +- Intel® Wi-Fi 6 AX203 +- Intel® Wi-Fi 6 AX201 +- Intel® Wi-Fi 6 AX200 +- Intel® Wi-Fi 6 AX101 +- Intel® Wireless-AC 9560 +- Intel® Wireless-AC 9260 +- Qualcomm WCN785x Wi-Fi 7 +- Qualcomm WCN685x Wi-Fi 6 +- Broadcom BCM4356 +- MTK MT792x +- Realtek RTL8822CE +- Realtek RTL8825BE +- ... -## 网卡 - -> 我们通过直接对接[上游固件](https://gitlab.com/kernel-firmware/linux-firmware),让 ROS2GO 拥有了**兼容市面上绝大多数网卡**的能力。 - -### 使用指南 - -> 注:早期版本`v20241019之前`可能有一些过时的包,需要先卸载:`sudo apt purge linux-firmware drivers-linux-firmware` - -1. 下载固件包`截至2024/11/16`:https://github.com/tianbot/tianbot_docs/releases/download/f20241110/linux-firmware-upstream_20241110-12-ga5b0ee21_all.deb -2. 安装:`sudo dpkg -i linux-firmware-upstream*.deb` -3. 重启机器,enjoy! - -### 问题反馈 - -> 如果您在使用中发现不兼容的设备,请及时通过 QQ 群、频道、微信群等反馈,我们开发人员会第一时间处理。 - -为方便开发人员迅速定位问题,找到解决方案,请您反馈时带上如下命令的返回信息: - -```shell -lspci -k | grep -A 3 -i net -``` - -输出示例`不同的硬件会有不同的输出`: - -``` -03:00.0 Ethernet controller: Realtek Semiconductor Co., Ltd. RTL8111/8168/8211/8411 PCI Express Gigabit Ethernet Controller (rev 15) - DeviceName: Realtek RTL8111E Ethernet LOM - Subsystem: Lenovo Device 390b - Kernel driver in use: r8169 - Kernel modules: r8169 -04:00.0 Network controller: Intel Corporation Wi-Fi 6 AX200 (rev 1a) - Subsystem: Intel Corporation Device 0080 - Kernel driver in use: iwlwifi - Kernel modules: iwlwifi -``` - -## 传感器 ### 智能音箱 @@ -164,8 +193,6 @@ lspci -k | grep -A 3 -i net - Intel Realsense系列 -........ - ### 手柄 - Logitech F710 diff --git a/docs/ros2go/applicable/use-on-macos.md b/docs/ros2go/applicable/macbook.md similarity index 95% rename from docs/ros2go/applicable/use-on-macos.md rename to docs/ros2go/applicable/macbook.md index 45d0461..e8b0be1 100644 --- a/docs/ros2go/applicable/use-on-macos.md +++ b/docs/ros2go/applicable/macbook.md @@ -1,5 +1,10 @@ # Apple 笔记本(虚拟机方案) +::: tip 💡 +1. 本文档仅适用于 Intel x86 ✅架构的 Apple 笔记本,M* 系列芯片的机型暂不支持😭 +2. 未配备 T2 芯片的机型(2015年中前发售✅),可以尝试直接从 ROS2GO 启动😄 +::: + ## 安装 Virtual Box ### 下载 Virtual Box 安装包 diff --git a/docs/ros2go/question.md b/docs/ros2go/faq.md similarity index 87% rename from docs/ros2go/question.md rename to docs/ros2go/faq.md index 1fb72b1..459399c 100644 --- a/docs/ros2go/question.md +++ b/docs/ros2go/faq.md @@ -12,13 +12,13 @@ fastfetch -l none ``` -## 默认用户名和密码是什么 +## 默认用户名和密码是什么 {#what-is-the-default-username-and-password} - 用户名:`tianbot` - 密码:`ros` -## 如何切换 ROS1/ROS2 运行环境 +## 如何切换 ROS1/2 运行环境 {#how-to-switch-ros1-ros2} 切换到 ROS1: ```shell @@ -29,11 +29,11 @@ source $(ros2go_switch -v 1) source $(ros2go_switch -v 2) ``` -## 如何切换中英文输入法 +## 如何切换中英文输入法 {#how-to-switch-chinese-english-input-method} 使用`Ctrl+ 空格`切换输入法,当处于搜狗输入法下,按下`shift`键切换中英文输入 -## 如何在 ROS2GO 20.04 中安装 ros2 humble 的其他依赖包? {#how-to-install-other-humble-dependencies-in-ros2go-20-04} +## 如何安装 ros2 humble 的其他依赖包? {#how-to-install-other-humble-dependencies} 不要直接使用`apt`安装,如下图所示: @@ -66,11 +66,12 @@ source humble_patch/install/setup.bash --extend ``` ::: -## 如何更新 QQ +## 如何使用 QQ/微信 {#how-to-use-qq-wechat} -请查看腾讯 QQ Linux 版官网说明进行操作:https://im.qq.com/linuxqq/support.html +- QQ:https://im.qq.com/linuxqq/support.html +- 微信:https://linux.weixin.qq.com -## 为什么看视频没声音 +## 为什么看视频没声音 {#why-no-sound-when-watching-video} 首先你需要确定一下, @@ -88,7 +89,7 @@ ROS2GO 是基于 linux 内核和 Ubuntu 打造,所以也是一样的。通常 - 答:大体上的逻辑是这样的,有线耳机只能充当输入输出设备,本身不能处理模拟输入的声音信号,集成了音频处理芯片的 USB 声卡(或某些拓展坞 hub)能够处理声音信号。所以,需要通过耳机连接 USB 声卡(或带有声卡的拓展坞 hub),然后再将 USB 声卡(或这种拓展坞 hub)连接电脑,就能够正常识别麦克风和扬声器设备了。 ::: -## 在部分电脑上无法正常关机? +## 关机卡住怎么办 ::: tip 解决方案 @@ -102,7 +103,7 @@ ROS2GO 是基于 linux 内核和 Ubuntu 打造,所以也是一样的。通常 使用软重启按键:`Ctrl + Alt + PrtScSysRq`,松开`PrtScSysRq`键,然后在按住`Ctrl+Alt`键之后,依次按下`r`,`e`,`i`,`s`,`u`,`b`。切换到 Windows,再关机 ::: -## ROS2GO 三不要操作 +## ROS2GO 三不要操作 {#three-dont} > 很大一部分兼容性问题(99% 以上),主要是因为电脑与 Ubuntu 的兼容问题,这个问题可以善用搜索的方法,先在搜索引擎上搜索相关问题。 @@ -110,7 +111,7 @@ ROS2GO 是基于 linux 内核和 Ubuntu 打造,所以也是一样的。通常 2. 不要随意修改根(/)目录下的文件 3. 不要轻易改动预置 NVIDIA 驱动 -## 系统文件相关和软件版本 +## 系统文件相关和软件版本 {#system-file-and-software-version} | 版本 | 操作系统及版本 | ROS 版本 | 总容量 | 系统占用说明 | |------------|-------------------------------|-------------------|--------|---------------------------------------------------| @@ -125,7 +126,7 @@ ROS2GO 是基于 linux 内核和 Ubuntu 打造,所以也是一样的。通常 - 观看时限:**从首次浏览在线课程开始算起**,三月内有效 -## 无法启动提示任意键继续 +## 无法启动提示任意键继续 {#cannot-start} ```shell error: (hde, gpt1)/vmlinuz has invalid signature @@ -149,7 +150,7 @@ error: you need to load the kernel first 3. ROS2GO 系统终端输入:`lspci | grep -i network` 将结果反馈给售后群,我们工程师会视情况给出解决建议 -## 无法访问原来的 Windows 下的硬盘 +## 无法访问原来的 Windows 下的硬盘 {#cannot-access-windows-disk} 这是一个使用双系统时常见的问题,最常见的原因是没有关闭 Windows 的快速启动,这样 Windows 并不是完全正常的关闭,了解问题可参考这个[链接](https://askubuntu.com/questions/145902/unable-to-mount-windows-ntfs-filesystem-due-to-hibernation),修复此类问题:Error mounting /dev/sda2,使用命令 @@ -161,16 +162,12 @@ sudo ntfsfix /dev/sda2 早期版本 ROS2GO 缺少`pipewire`包,安装即可:`sudo apt install pipewire`,`v20241019`版本之后已修复这个问题 -## 如何将系统安装到硬盘上 +## 如何将系统安装到硬盘上 {#how-to-install-ros2go-to-hard-disk} 理论上是完全可行的,但这属于**高危操作**,如果有时间可以自己折腾,天之博特公司不做任何技术支持保证。具体可以参考 CSDN 用户"静精进境"的文章[ROS2GO 与 WIN10 双系统安装](https://blog.csdn.net/fzx1443678836/article/details/88718959)。 请一定注意,对本机进行任何安装系统或者类似磁盘操作之前请备份重要数据,备份备份再备份! -## 如何进行远程控制,是否可以安装 VNC 等远程软件? - -很多初学者在操作实际机器人时,希望可以用远程桌面进行操作,但是请不要在 ROS2GO 上安装 VNC,已经有安装 VNC 导致无法进入桌面或者显示问题的案例,如果需要远程控制,可以使用系统内的 Remmina Remote Desktop Client,选择 VNC 的模式连接即可,同时我们也推荐使用国产优秀软件[Todesk](https://www.todesk.com/) - -## 我是企业用户,能定制么? +## 我是企业用户,能定制么 {#can-i-customize} ROS2GO 为企业提供软硬件客制化方案,定制包含不仅限于:容量、LOGO、默认用户信息、随盘资料、驱动支持、软件包、桌面背景等,如您有需要,请联系在线客服,我们会有专人为您解答。 diff --git a/docs/ros2go/guide/how-to-backup-by-timeshift.md b/docs/ros2go/guide/how-to-backup.md similarity index 100% rename from docs/ros2go/guide/how-to-backup-by-timeshift.md rename to docs/ros2go/guide/how-to-backup.md diff --git a/docs/ros2go/guide/index.md b/docs/ros2go/guide/index.md index 8321a49..9480546 100644 --- a/docs/ros2go/guide/index.md +++ b/docs/ros2go/guide/index.md @@ -1,19 +1,29 @@ -# 使用手册 +## 产品介绍 {#introduction} -## 产品介绍 -ROS2GO 是由天之博特打造的一款开箱即用的便携式随身系统,基于 Ubuntu 的深度定制使得本产品无需对原有 PC 系统做任何改造,可以在绝大多数 x86 架构的 PC、笔记本上快速启动,秒级进入 ROS 开发环境。无论是 ROS 初学者还是开发人员都能得到快速一致的 ROS 开发体验。 +ROS2GO™ 是由天之博特打造的一款开箱即用的便携式 ROS 集成开发系统。本产品基于 Ubuntu 深度定制(内核、固件、显卡驱动等),无需对原有系统做任何改动即可以在绝大多数 x86 架构的 PC、笔记本上快速启动,为初学者、开发或科研人员提供方便好用的 ROS 开发环境。 -::: info 提示 -如果您有以下需求,ROS2GO可能会帮助到您 +::: tip 📢 如果您有以下需求,ROS2GO 可能会帮到您 ::: -- 想快速了解ROS的初学者 +- 想快速了解 ROS 的初学者 - 需要统一标准开发环境的工程师 - 需要统一便捷教学环境的高校实验室、培训机构 - 需要统一产品出厂标配的资料环境 - 需要统一比赛开发环境RUMA、智能车等比赛 -## 产品参数 + +## 产品特点 {#features} + +- **开箱即用**:无需安装,插入电脑即可[启动](how-to-start.md#start-steps) +- **轻量便携**:体积小巧,重量轻,可随身携带 +- **定制内核**:BBRv3, Multi-generational LRU, Intel&AMD P-state driver, CachyOS patches, AUFS support, zstd v1.56, Btrfs transparent compression, etc. +- **定制驱动**:主流硬件(显卡声卡网卡等)支持,包括不限于Intel/AMD/NVIDIA/MTK/Qualcomm等 +- **无忧恢复**:内置多种[恢复方案](how-to-recover.md),折腾无忧 +- **稳定维护**:积极更新上游[内核、固件、ROS 功能包](https://github.com/tianbot/tianbot_docs/releases)等 +- **强力售后**:[多渠道售后](/community)支持,保障您的使用体验 + + +## 产品规格 {#specifications} | 类型 | 明细 | | --- | --- | | 材质 | 合金 | @@ -27,7 +37,7 @@ ROS2GO 是由天之博特打造的一款开箱即用的便携式随身系统, | 支持硬件 | 1. 激光雷达:傲视智绘、思岚、北阳、西克等
2. 深度相机:Intel RealSense、Asus、Astra、Kinect等 | -## 产品清单 +## 产品清单 {#package} - ROS2GO 1 个 - 使用说明 1 个 @@ -40,7 +50,7 @@ ROS2GO 是由天之博特打造的一款开箱即用的便携式随身系统, ![](https://tianbot-pic.oss-cn-beijing.aliyuncs.com/tianbot-pic/Tianbot-Doc202310241233148.jpg) -## 保修政策 +## 保修政策 {#warranty} > 保修期自收到货物起算,期间客户正常使用,无擅自拆修、改装,出现非人为的性能故障。 @@ -50,22 +60,20 @@ ROS2GO 是由天之博特打造的一款开箱即用的便携式随身系统, | 系统重置 | `1`次 | | 系统升级 | `1`次 | -> 注意: -> -> - 1次免费系统重置代指:系统不能正常启动,如需系统重置请联系客服,确认购买信息无误后,寄回重置。 -> -> - 1次免费系统升级代指:系统大版本更新,功能包升级,如需升级请联系客服,确认购买信息无误后,寄回升级。 -> -> - 保修申请须提供有效的购买证明、单据。 +::: danger ⚠️ +- 系统重置代指:系统不能正常启动,如需系统重置请联系客服,确认购买信息无误后,寄回重置。 +- 系统升级代指:系统大版本更新,功能包升级,如需升级请联系客服,确认购买信息无误后,寄回升级。 +- 保修申请须提供有效的购买证明、单据。 +::: -## 开箱视频 +## 开箱视频 {#unboxing}
-## 使用文章 +## 使用文章 {#user-article} - [ROS2GO是什么?一个便捷的ROS随身系统](https://zhuanlan.zhihu.com/p/47984126) - [ROS学习开发套件 – 田老师对ROS2GO简单全面的介绍](https://www.tianbot.com/2018/11/11/81a4ef888b/) diff --git a/docs/ros2go/index.md b/docs/ros2go/index.md deleted file mode 100644 index 1139738..0000000 --- a/docs/ros2go/index.md +++ /dev/null @@ -1,49 +0,0 @@ -# ROS2GO 开箱说明 - -像 ROS2GO 的名字一样,随时随地带走自己工作环境,更加标准化开发和科研,经过简单几步很短时间就可以体验 ROS 的乐趣,而无需繁碎的环境配置,这就是 ROS2GO。 - -为了保证用户体验,ROS2GO 在出厂时已预装系统并充分测试,确保每一个 ROS2GO 都可以正常启动使用,开箱后请您检查是否完整以及产品运输过程中造成损坏,如有问题您随时联系客服人员反映,我们尽快为您处理,您拿到的 ROS2GO 如图所示,其中包含: -- ROS2GO 1 个 -- 使用说明 1 个 -- 挂绳 1 根 - -::: tip 注意 -包装内容和产品样式变更恕不另外单独通知,具体包装和实际规格以收到货物为准。 -::: - -![](https://tianbot-pic.oss-cn-beijing.aliyuncs.com/tianbot-pic/Tianbot-Doc202310241233148.jpg) - -## 产品开箱 - -
- -
- -## 配套资源 - -ROS2GO 系统本身带了资料、在线课程、仿真案例、常用功能包、基础软件等大家可以通过下面视频进行全面了解 - - -
- -
- -### 工作空间 -在 Melodic 版本的 ROS2GO 中,我们屏蔽了 ROS 的工作空间链接功能。所有的工作空间都是独立编译,因此仅会依赖本空间以及原始/opt 中的安装空间。目前结构暂时未遇到功能包依赖的问题。 - -由于没有了工作空间链接,所以每个工作空间都要在[`~/.bashrc`](https://www.digitalocean.com/community/tutorials/bashrc-file-in-linux)中用--extend 显式启用,注释掉即可关闭工作空间。这样方便大家自学。如果打开`~/.bashrc`查看,会看到在文件的末尾,我们用`source`和`--extend`,包含了很多[工作空间](/basic/ros/ros2go-data-brief)。 - -## 售后支持 -关于 ROS2GO 需要提醒您,我们只保证 ROS2GO 到手可以正常运行,关于 ROS2GO 使用的问题可以咨询我们,但是我们不承担 ROS 相关知识咨询必问必答的技术支持,随货附带的说明书上有加群二维码(只支持扫码加群),您可以使用手机 QQ 扫码加群,工作人员收到消息会及时通过加群申请。 - -::: tip 提示 -不能启动,不能正常运行等等问题比较复杂,很多情况不是一句话能解决的,为了提升效率,以及记录相关问题,您在咨询这些问题的时候建议在群里进行,问题尽量详尽,包含自己的电脑型号,出现问题的原因和图片,必要的时候可以拍视频发出来。 -::: - -::: warning 示例 -- 型号:Thinkpad X1 2019 款 CPU Intel i5-10xxx 无线网卡型号 AX-200 -- 问题:系统无法启动,报错内容 xxx yyy zzz 等 -- 其他:问题图片、开机启动项图片等,必要的时候可以提供开机启动的视频。 -::: diff --git a/docs/ros2go/usage.md b/docs/ros2go/usage.md deleted file mode 100644 index ce947fa..0000000 --- a/docs/ros2go/usage.md +++ /dev/null @@ -1,69 +0,0 @@ -# 拥有 ROS2GO 后,你可以做什么 - -作为开发者,我能想到至少可以使用 ROS2GO 做以下几件事: -- 学习,使用 ROS,进行机器人系统设计 -- 学习,研究机器人感知,SLAM -- 学习,研究机器人控制,集群控制 -- 在 Gazebo 中进行仿真,验证算法 idea - -## 开箱即用 - - 一键切换的 ROS1,ROS2 环境 - - 各种预置好的 ROS 1,2 驱动功能包,具体支持如下表 - -| 硬件设备 | ROS1 | ROS2 | -| :---: | :---: | ---- | -| **激光雷达** | --------- | ----------- | -| Livox mid360 | | 由于 mid360 的 json 配置 IP 需要用到唯一 S/N 码,所以没有直接集成 | -| Velodyne | 已支持 | 已支持 | -| Osight | 已支持 | 已支持 | -| RPLIDAR | 已支持 | ----- | -| YDLIDAR | 已支持 | ----- | -| HOKUYO | 已支持 | ----- | -| **相机** | --------- | ----------- | -| 摄像头 | 已支持 | 已支持 | -| Astra | 已支持 | 已支持 | -| Intel Realsense | 已支持 | 已支持 | -| ZED2i | SDK 需要安转 CUDA,所以没有直接集成 | | - - -## 方便的开发环境依赖 - - Google 三件套:Glog,GFlags,Gtest - - 强大的非线性优化库 Ceres Solver - - 强大的线性代数运算库 Eigen - - 强大的图像处理库 OpenCV - - 强大的三维重建库 PCL - - 此外你可以根据需要,安装其他你喜欢的软件依赖,比如 G2O,Pangolin,Sophus,Gtsam,DBow3 等等,熟悉优秀的开源算法库,足以让你在实现机器人算法时如鱼得水,事半功倍 - -## 各种常用软件 - - VScode - - GIMP 类似 PS 的强大图像处理软件 - - LinuxQQ - - Timeshift 增量式备份神器 - - Ctrl + Space,Shift 一键中英文切换的搜狗输入法 - - Ctrl + Alt + A 一键开启火焰截图 - - 此外你可以根据需要,安装其他你喜欢的软件,比如 OBS Studio,Blender,Rustdesk 等等 - -## 丰富的学习资源 - - 首先是 GAZEBO 仿真,为了便于集中整理和分类,我们通过运动方式和底盘类型来划分不同的仿真实例。你可以看到不限于**差速,阿克曼,全向轮式机器人,机械臂,足式机器人,无人机,机器人集群**的相应仿真,如何将他们快速地运行起来,可以参考[机器人的仿真模拟部分](/simulation/)来进行 - - - 其次是 ROS1,ROS2 优秀 Tutorial,代码 Example,可以在 **study_ws** 和 **ros2_study_ws** 中找到,你可以对照 B 站古月居视频学习,具体位置在[ROS2GO 资料使用说明](/basic/ros/ros2go-data-brief.md)中查看 - -## 安装深度学习环境 - -::: danger 注意 -此部分操作比较危险,操作前请使用 Timeshift 备份好数据,未备份或误操作导致文件系统损坏,个人数据丢失,天之博特不承担任何责任。 -::: - -
- -
- -::: warning 提示 -在安装好深度学习环境之后,请先[使用 Timeshift 进行备份](https://docs.tianbot.com/ros2go/guide/how-to-backup-by-timeshift.html#create-backup),由于 Nvidia 驱动更新频繁,所以请务必在安装好驱动进行备份,否则`某次不经意的系统更新就会导致 Nvidia 驱动崩溃`(内核版本不匹配),所以在安装 N 卡驱动后`不要轻易进行 Software Updater`,这会导致已安装的 N 卡驱动和 DL 环境无法正常使用。 -::: - -以强化学习为例,Gym 的 python 运行环境对依赖库的版本要求极严格,所以各种库版本冲突则是太正常不过了。 - -- **NVIDIA 独显驱动**:自`v20240921`起,ROS2GO 已内置该驱动,无须折腾。 -- **Python 虚拟环境**:你需要一个干净的 Python 环境管理工具,Miniconda 是个不错的选择,准备一套 Pytorch + ONNX + TensorRT 环境,能先把代码跑起来就是最关键的。尽量避免一行代码还没有跑起来,就出现各种奇奇怪怪的依赖库报错。