Skip to content

GitLab

  • Menu
Projects Groups Snippets
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • Husky Usage Guide Husky Usage Guide
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Merge requests 0
    • Merge requests 0
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Releases
  • Packages & Registries
    • Packages & Registries
    • Package Registry
    • Infrastructure Registry
  • Wiki
    • Wiki
  • Activity
  • Graph
  • Jobs
  • Commits
Collapse sidebar
  • Wouter Jansen
  • Husky Usage GuideHusky Usage Guide
  • Wiki
  • Home

Home · Changes

Page history
Update home authored Feb 23, 2023 by Wouter Jansen's avatar Wouter Jansen
Hide whitespace changes
Inline Side-by-side
home.md
View page @ 1a0a6ace
...@@ -5,7 +5,7 @@ Please ask a lab member to use the Husky to make sure it is available and in goo ...@@ -5,7 +5,7 @@ Please ask a lab member to use the Husky to make sure it is available and in goo
This guide was updated last on 2023-02-23. This guide was updated last on 2023-02-23.
![husky.jpg](husky.jpg) ![husky.jpg](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/husky.jpg)
## Table of content ## Table of content
...@@ -47,9 +47,9 @@ This guide was updated last on 2023-02-23. ...@@ -47,9 +47,9 @@ This guide was updated last on 2023-02-23.
### Layout ### Layout
![layout.png](layout.png) ![layout.png](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/layout.png)
![layout_back.png](layout_back.png) ![layout_back.png](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/layout_back.png)
### Status panel ### Status panel
The status panel is a display of LED indicators located on the rear of the chassis which provide information about the current status of Husky. The indicators are described in the table below. The status panel is a display of LED indicators located on the rear of the chassis which provide information about the current status of Husky. The indicators are described in the table below.
...@@ -63,23 +63,23 @@ The status panel is a display of LED indicators located on the rear of the chass ...@@ -63,23 +63,23 @@ The status panel is a display of LED indicators located on the rear of the chass
</thead> </thead>
<tbody> <tbody>
<tr> <tr>
<td ><img src="status_battery.png"/></td> <td ><img src="https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/status_battery.png"/></td>
<td >Battery Status The four LED segments provide an approximate indication of the relative lifetime remaining in the battery.</td> <td >Battery Status The four LED segments provide an approximate indication of the relative lifetime remaining in the battery.</td>
</tr> </tr>
<tr> <tr>
<td ><img src="status_communication.png"/></td> <td ><img src="https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/status_communication.png"/></td>
<td >Communication Status When green, Husky is receiving a stream of correctly-formatted motion commands, and is ready to drive. When yellow, Husky is receiving commands, but will not drive due to emergency stop or another error. When red, serial communications are currently timed-out.</td> <td >Communication Status When green, Husky is receiving a stream of correctly-formatted motion commands, and is ready to drive. When yellow, Husky is receiving commands, but will not drive due to emergency stop or another error. When red, serial communications are currently timed-out.</td>
</tr> </tr>
<tr> <tr>
<td ><img src="status_general_error.png"/></td> <td ><img src="https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/status_general_error.png"/></td>
<td >General Error Status Illuminates red when Husky will not drive due to an error state. Such states include emergency stop, insufficient battery power, or an unspecified software error.</td> <td >General Error Status Illuminates red when Husky will not drive due to an error state. Such states include emergency stop, insufficient battery power, or an unspecified software error.</td>
</tr> </tr>
<tr> <tr>
<td ><img src="status_emergency.png"/></td> <td ><img src="https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/status_emergency.png"/></td>
<td >Emergency Stop Status Illuminates red when Husky will not drive due to the emergency stop being activated, either onboard or wireless (if available).</td> <td >Emergency Stop Status Illuminates red when Husky will not drive due to the emergency stop being activated, either onboard or wireless (if available).</td>
</tr> </tr>
<tr> <tr>
<td ><img src="status_charge.png"/></td> <td ><img src="https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/status_charge.png"/></td>
<td >Charge Indicator Illuminates red when Husky user power is being supplied externally.</td> <td >Charge Indicator Illuminates red when Husky user power is being supplied externally.</td>
</tr> </tr>
</tbody> </tbody>
...@@ -88,7 +88,7 @@ The status panel is a display of LED indicators located on the rear of the chass ...@@ -88,7 +88,7 @@ The status panel is a display of LED indicators located on the rear of the chass
### Starting up ### Starting up
The silver button at the top of the Status Panel is used to power the Husky on and off. From the "off" state, pressing the button will cause the Husky to power on and a blue ring at the edge of the button will be illuminated. From the "on" state, pressing the button will cause the Husky to power off and the blue ring will no longer be illuminated. The silver button at the top of the Status Panel is used to power the Husky on and off. From the "off" state, pressing the button will cause the Husky to power on and a blue ring at the edge of the button will be illuminated. From the "on" state, pressing the button will cause the Husky to power off and the blue ring will no longer be illuminated.
![panel.jpg](panel.jpg) ![panel.jpg](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/panel.jpg)
status panel lights will show a brief test pattern. The `COMM` status light will turn red, as the PC is not yet communicating with Husky. status panel lights will show a brief test pattern. The `COMM` status light will turn red, as the PC is not yet communicating with Husky.
...@@ -98,12 +98,12 @@ The `STOP` status light will be red if the Stop button is pressed. If the Stop b ...@@ -98,12 +98,12 @@ The `STOP` status light will be red if the Stop button is pressed. If the Stop b
To teleoperate Husky, first release the motion stop. Then, referring to the following image of the Logitech Controller, press the enable button (either slow or fast mode) and use the left thumbstick to drive Husky. To teleoperate Husky, first release the motion stop. Then, referring to the following image of the Logitech Controller, press the enable button (either slow or fast mode) and use the left thumbstick to drive Husky.
![controller.png](controller.png) ![controller.png](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/controller.png)
### Orientation reference ### Orientation reference
The reference frame used by all Clearpath Robotics ground robots is based on ISO 8855, and is shown in the figure below. Husky's front is shown. When commanded with a positive translational velocity (forward), wheels travel in the positive X-direction. The direction of the axes differs from those used for roll, pitch, and yaw in aircraft, and care should be taken to ensure that data is interpreted correctly. The reference frame used by all Clearpath Robotics ground robots is based on ISO 8855, and is shown in the figure below. Husky's front is shown. When commanded with a positive translational velocity (forward), wheels travel in the positive X-direction. The direction of the axes differs from those used for roll, pitch, and yaw in aircraft, and care should be taken to ensure that data is interpreted correctly.
![orientation.png](orientation.png) ![orientation.png](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/orientation.png)
### Specifications ### Specifications
...@@ -137,7 +137,7 @@ The reference frame used by all Clearpath Robotics ground robots is based on ISO ...@@ -137,7 +137,7 @@ The reference frame used by all Clearpath Robotics ground robots is based on ISO
### Safety: Emergency-stop and lockout ### Safety: Emergency-stop and lockout
![safety.png](safety.png) ![safety.png](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/safety.png)
The motion-stop function allows a person in the physical vicinity of the robot to halt its motion and prevent re-initiation of motion. Power supply to Husky's motor drivers is enabled by a normally-open relay, which is closed in series with the stop switch. This motion-stop system is intended for use in emergency situations. The motion stop system should not be used as the means of controlling robot motion during regular operation. The motion-stop function allows a person in the physical vicinity of the robot to halt its motion and prevent re-initiation of motion. Power supply to Husky's motor drivers is enabled by a normally-open relay, which is closed in series with the stop switch. This motion-stop system is intended for use in emergency situations. The motion stop system should not be used as the means of controlling robot motion during regular operation.
...@@ -159,9 +159,9 @@ The battery shipped with Husky A200 may be charged outside the robot or while st ...@@ -159,9 +159,9 @@ The battery shipped with Husky A200 may be charged outside the robot or while st
5. Unplug the charger from the wall and then disconnect it from the battery. 5. Unplug the charger from the wall and then disconnect it from the battery.
6. Connect battery terminal connector back to the MCU board. Black to black, red to red. 6. Connect battery terminal connector back to the MCU board. Black to black, red to red.
![charging_connection.jpg](charging_connection.jpg) ![charging_connection.jpg](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/charging_connection.jpg)
![battery_connection.jpg](battery_connection.jpg) ![battery_connection.jpg](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/battery_connection.jpg)
The battery charger shipped with Clearpath Robotics's lead-acid battery-powered products uses a two-state charge cycle. The battery charger shipped with Clearpath Robotics's lead-acid battery-powered products uses a two-state charge cycle.
...@@ -178,7 +178,7 @@ The Wi-Fi SSID is `HuskyLAN` and has password `Husky123`. ...@@ -178,7 +178,7 @@ The Wi-Fi SSID is `HuskyLAN` and has password `Husky123`.
To connect to the Husky's network you can either connect to the Wi-Fi access point or connect an Ethernet cable to available ethernet switch in the hatch. To connect to the Husky's network you can either connect to the Wi-Fi access point or connect an Ethernet cable to available ethernet switch in the hatch.
![ethernet_switch.jpg](ethernet_switch.jpg) ![ethernet_switch.jpg](https://cosysgit.uantwerpen.be/wjansen/husky-usage-guide/-/blob/main/ethernet_switch.jpg)
### Internet access ### Internet access
By default the Husky has no internet access. On the USB-hub a secondary Wi-Fi adapter is plugged in. You can connect this one to a internet-able network. By default the Husky has no internet access. On the USB-hub a secondary Wi-Fi adapter is plugged in. You can connect this one to a internet-able network.
......
Clone repository
  • The basics
    • Layout
    • Status panel
    • Starting up
    • Using the controller
    • Orientation reference
    • Specifications
    • Safety: Emergency-stop and lockout
  • Network Setup
    • Network basics
    • Internet access
  • Sensors
    • eRTIS
    • Ouster OS0-128 LiDAR
    • Intel Realsense d435i camera
  • Using ROS
    • Default nodes
    • Default topics
    • Motion topics
    • Odometry topics
    • Diagnostic topics
    • Custom workspace
    • ROS Husky packages
    • Navigation with ROS
    • Publishing eRTIS data
    • Publishing Ouster OS0-128 LiDAR data
    • Publishing Intel Realsense d435i camera data
    • Transformation tree
  • Configuration
    • Software versions
    • Network
    • Bash alias commands
  • Other resources