Skip to content

Commit

Permalink
Merge pull request #81 from westonrobot/feature-adt_v2
Browse files Browse the repository at this point in the history
Feature adt v2
  • Loading branch information
KJCheo-weston authored Jun 13, 2024
2 parents 1012917 + 72000a1 commit 73dc02d
Show file tree
Hide file tree
Showing 24 changed files with 129 additions and 10 deletions.
11 changes: 7 additions & 4 deletions source/robot_user_guide/unitree/b2.rst
Original file line number Diff line number Diff line change
Expand Up @@ -258,10 +258,13 @@ The user interface module expands the interfaces available on the B2 body, allow
4. Resources
============

Manual
Basic Guides
------

* B2 Manual: `Unitree <https://support.unitree.com/home/en/B2_developer/About%20B2>`_
* Manual: `Unitree <https://support.unitree.com/home/en/B2_developer/About%20B2>`_

.. Development
.. -----------
Development
-----------

* SDK Support: `unitree_sdk2 <https://github.com/unitreerobotics/unitree_sdk2>`_
* ROS2 Support: `unitree_ros2 <https://github.com/unitreerobotics/unitree_ros2>`_
5 changes: 4 additions & 1 deletion source/software/installation_guide.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,12 @@ Debian Repository

C++ libraries and binaries (including the widget apps) are provided as ".deb" installation packages. There are two methods you can aquire and install the released debian packages:

* Download the ".deb" packages from the cooresponding github repository and install with the "dpkg" command, e.g., $ sudo dpkg -i <package_name>.deb
* Download the ".deb" packages from the corresponding github repository and install with the "dpkg" command, e.g., $ sudo dpkg -i <package_name>.deb
* Install the packages from Weston Robot's apt-get server

Add Weston Robot's apt source
-----------------------------

Here are the steps you can follow to add the Weston Robot package source:

.. note::
Expand Down
14 changes: 14 additions & 0 deletions source/toolbox/adt_toolbox/adt_toolbox.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
*******************************************
Weston Robot Assisted Driving Toolbox (ADT)
*******************************************

Weston Robot proudly presents the Assisted Driving Toolbox (ADT), a teleoperation system designed and developed by Weston Robot for usage on multiple mobile robot platforms. The system allows the the control and operation of an robot through a shared network; with a wide coverage of its surroundings using mounted onboard camera modules.

Please refer to the following sections for more information on the ADT version that you have purchased:

.. toctree::
:maxdepth: 1

/toolbox/adt_toolbox/v1
/toolbox/adt_toolbox/v2

File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file added source/toolbox/adt_toolbox/figures/adt_v2_01.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/toolbox/adt_toolbox/figures/adt_v2_02.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/toolbox/adt_toolbox/figures/adt_v2_03.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/toolbox/adt_toolbox/figures/adt_v2_05.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/toolbox/adt_toolbox/figures/adt_v2_06.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
********************************************
Weston Robot Asssisted Driving Toolbox (ADT)
********************************************
**********************************************
Weston Robot Assisted Driving Toolbox (ADT) V1
**********************************************

Weston Robot proudly presents the Assisted Driving Toolbox (ADT), a teleoperation system designed and developed by Weston Robot for usage on multiple mobile robot platforms. The system allows the the control and operation of an robot through a shared network; with a wide coverage of its surroundings using mounted onboard camera modules.
Weston Robot proudly presents the Assisted Driving Toolbox (ADT) V1, a teleoperation system designed and developed by Weston Robot for usage on multiple mobile robot platforms. The system allows the the control and operation of an robot through a shared network; with a wide coverage of its surroundings using mounted onboard camera modules.

.. image:: figures/adt_01.png

Expand Down
99 changes: 99 additions & 0 deletions source/toolbox/adt_toolbox/v2.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
**********************************************
Weston Robot Assisted Driving Toolbox (ADT) V2
**********************************************

Weston Robot proudly presents the Assisted Driving Toolbox (ADT) V2, a teleoperation system designed and developed by Weston Robot for usage on multiple mobile robot platforms. The system allows the the control and operation of an robot through a shared network; with a wide coverage of its surroundings using mounted onboard camera modules.

Assisted Driving Client Setup
=============================

System Requirements
-------------------

1. Host computer running Ubuntu 20.04/22.04
2. Joystick for control via the Assisted Driving Toolbox Client
3. Shared network between the robot and host computer

Client Software Installation
----------------------------

.. note::
We updated our apt-get server in July 2023. If you've added Weston Robot's old apt source before, you will need to remove it first.

.. code-block:: bash
$ sudo rm /etc/apt/sources.list.d/weston-robot.list
Follow these steps to install the Assisted Driving Toolbox Client on the host computer. If you have installed packages from the Weston Robot repository before, you can skip to step 3.

1. Follow the instructions `here <https://docs.westonrobot.com/software/installation_guide.html#add-weston-robot-s-apt-source>`_ to add the Weston Robot package source to your system's software repository list.

2. Now you can update the apt index and install the ADT package with "apt-get" command.

.. code-block:: bash
$ sudo apt-get update
$ sudo apt-get install wr-ad-toolbox
**Note:** Installation of additional third-party dependency packages may be required for this package.

TLS Certificate Installation
----------------------------
To run the Assisted Driving Toolbox Client, you need to install a set of TLS certificates. These certificates are used to establish a secure connection between the client and the robot
for control. You should have received a password-protected zip file containing the certificates from Weston Robot.

1. Extract the zip file to a location of your choice.
2. Open a terminal and navigate to the directory where you extracted the zip file.
3. Run the following command to install the certificates:

.. code-block:: bash
$ sudo ./install_certificates.sh
Running the Assisted Driving Toolbox Client
-------------------------------------------
To open the application, locate the Assisted Driving Toolbox Client in the application menu:

- Press the Windows key on your keyboard to open the application search bar. Search for "WR Assisted Driving Toolbox".
- Click on the application icon to open the Assisted Driving Toolbox Client.

.. image:: figures/adt_v2_01.png
:alt: Launching Assisted Driving Toolbox Client

The Assisted Driving Toolbox Client will open with the following screen:

.. image:: figures/adt_v2_02.png
:alt: Assisted Driving Toolbox Client Start Screen

Click on the "Login" button. A new browser window will open with the following login page:

.. image:: figures/adt_v2_03.png
:alt: Assisted Driving Toolbox Client Login Page

Login with your credentials. After successful login, the Assisted Driving Toolbox Client will prompt you to select the robot you want to control:

.. image:: figures/adt_v2_04.png
:alt: Assisted Driving Toolbox Client Robot Selection

If this is your first time using the Assisted Driving Toolbox Client, a settings menu will automatically open for you to configure the joystick and camera settings.

Key Application Features
------------------------

Teleoperation Panel
~~~~~~~~~~~~~~~~~~~

The teleoperation panel serves as the main control interface for the robot. It allows you to control the robot's movement and observe the robot's surroundings through
the robot's onboard cameras in real-time.

.. image:: figures/adt_v2_05.png
:alt: Teleoperation Panel

Settings Menu
~~~~~~~~~~~~~

.. image:: figures/adt_v2_06.png
:alt: Settings Menu

The settings menu allows you to configure the joystick and camera settings. You can access the settings menu by clicking on the gear icon in the bottom right corner
of the Assisted Driving Toolbox Client, or via the top menu bar by selecting "File" > "Settings".
2 changes: 1 addition & 1 deletion source/toolbox/toolbox.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,5 @@ Here you can find user guides of robotic toolboxes developed by Weston Robot:
.. toctree::
:maxdepth: 1

/toolbox/adt_toolbox
/toolbox/adt_toolbox/adt_toolbox

0 comments on commit 73dc02d

Please sign in to comment.