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 下)长时间的聊天记录存储,成员数量上限的优势,便于资料分享,气氛活跃。
+
+
+
+
+
+## Bilibili
+
+为大家提供更加直观的视频学习途径。
+
+
+
+
+
+动动你的金手指,点击链接,关注我们 https://space.bilibili.com/451561151/
+
+
+
+
+
+## ROS2GO QQ 频道
+
+便于问题汇总,答疑及知识沉淀、内容分享,方便后来人拾级而上。
+
+点击链接加入 QQ 频道【ROS2GO 交流群】:https://pd.qq.com/s/ff87jqozl
+
+
+
+
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:
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 环境,能先把代码跑起来就是最关键的。尽量避免一行代码还没有跑起来,就出现各种奇奇怪怪的依赖库报错。