diff --git a/components/supported_platforms.mdx b/components/supported_platforms.mdx index 31426ba8f..c812a3318 100644 --- a/components/supported_platforms.mdx +++ b/components/supported_platforms.mdx @@ -5,7 +5,7 @@ | Husky | A200 | Yes (as of 0.1) | No | Yes (as of 2.0) | Coming Soon | | | A300 | No | No | Yes (as of 2.0) | Coming Soon | | Jackal | J100 | Yes (as of 0.1) | No | Yes (as of 2.3) | Coming Soon | -| Warthog | W200 | Yes (as of 0.2) | No | Coming Soon | Coming Soon | +| Warthog | W200 | Yes (as of 0.2) | No | Yes (as of 2.6) | Coming Soon | | Dingo | DD100 | Yes (as of 0.3) | No | Yes (as of 2.3) | Coming Soon | | | DO100 | Yes (as of 1.0) | No | Yes (as of 2.3) | Coming Soon | | | DD150 | Yes (as of 0.3) | No | Yes (as of 2.3) | Coming Soon | @@ -37,4 +37,3 @@ for information on cross-vendor commuication. | | DD150 | Yes | No | No | No | No | | | DO150 | Yes | No | No | No | No | | Ridgeback | R100 | Yes | No | No | No | No | -| Boxer | B250 | No | No | No | No | No | diff --git a/components/supported_sensors.mdx b/components/supported_sensors.mdx index 44e807240..a1116339b 100644 --- a/components/supported_sensors.mdx +++ b/components/supported_sensors.mdx @@ -39,6 +39,8 @@ Debian drivers are automatically installed on robots as part of the | [MicroStrain 3DM-GQ7](/docs_robots/accessories/sensors/gps/microstrain_gq7) | Debian | Debian | Debian | Debian | [LORD Inertial](https://github.com/LORD-MicroStrain/microstrain_inertial) | | [Redshift Labs UM7](/docs_robots/accessories/sensors/imu/redshift_labs_um7) | Debian | Debian | Debian | Debian | [UM7](https://github.com/ros-drivers/um7) | | CH Robotics UM6 | Debian | Debian | Debian | Debian | [UM7](https://github.com/ros-drivers/um7) | +| Phidgets IMU | Unsupported | Unsupported | Debian | Debian | [Phidgets](https://github.com/ros-drivers/phidgets_drivers) | + ### GPS @@ -61,6 +63,7 @@ Debian drivers are automatically installed on robots as part of the |:------------------------------------------------------------------------------------ |:---------------- |:---------------- |:--------------- |:--------------- |:----------------------------------------------------- | | [Axis F1035-E](/docs_robots/accessories/sensors/cameras/axis_f1035_e) | Debian | Debian | Debian | Debian | [axis_camera](https://github.com/ros-drivers/axis_camera.git) | | [Axis M5525-E](/docs_robots/accessories/sensors/cameras/axis_m5525_e) | Debian | Debian | Debian | Debian | [axis_camera](https://github.com/ros-drivers/axis_camera.git) | +| [Axis M5526-E](/docs_robots/accessories/sensors/cameras/axis_m5526_e) | Debian | Debian | Debian | Debian | [axis_camera](https://github.com/ros-drivers/axis_camera.git) | | [Axis Q6225-LE-E](/docs_robots/accessories/sensors/cameras/axis_q6225_le) | Debian | Debian | Debian | Debian | [axis_camera](https://github.com/ros-drivers/axis_camera.git) | | [Flir Blackfly S](/docs_robots/accessories/sensors/cameras/flir_blackfly_s) | Debian | Debian | Debian | Debian | [flir_camera_driver](https://github.com/ros-drivers/flir_camera_driver) | @@ -70,8 +73,8 @@ Debian drivers are automatically installed on robots as part of the |:------------------------------------------------------------------------------------ |:---------------- |:---------------- |:--------------- |:--------------- |:----------------------------------------------------- | | [Intel Realsense D435](/docs_robots/accessories/sensors/cameras/realsense_d435) | Debian | Debian | Debian | Debian | [Realsense](https://github.com/clearpathrobotics/realsense_ros) | | [Intel Realsense D435i](/docs_robots/accessories/sensors/cameras/realsense_d435) | Debian | Debian | Debian | Debian | [Realsense](https://github.com/clearpathrobotics/realsense_ros) | -| [Intel Realsense D415](/docs_robots/accessories/sensors/cameras/realsense_d435) | Debian | Debian | Debian | Debian | [Realsense](https://github.com/clearpathrobotics/realsense_ros) | -| [Intel Realsense D455](/docs_robots/accessories/sensors/cameras/realsense_d435) | Debian | Debian | Debian | Debian | [Realsense](https://github.com/clearpathrobotics/realsense_ros) | -| [Intel Realsense D456](/docs_robots/accessories/sensors/cameras/realsense_d435) | Debian | Debian | Debian | Debian | [Realsense](https://github.com/clearpathrobotics/realsense_ros) | +| Intel Realsense D415 | Debian | Debian | Debian | Debian | [Realsense](https://github.com/clearpathrobotics/realsense_ros) | +| Intel Realsense D455 | Debian | Debian | Debian | Debian | [Realsense](https://github.com/clearpathrobotics/realsense_ros) | +| Intel Realsense D456 | Debian | Debian | Debian | Debian | [Realsense](https://github.com/clearpathrobotics/realsense_ros) | | [Luxonis OAK-D](/docs_robots/accessories/sensors/cameras/luxonis_oakd) | Debian | Debian | Debian | Debian | [depthai-ros](https://github.com/luxonis/depthai-ros.git) | | [Stereolabs Zed 2](/docs_robots/accessories/sensors/cameras/stereolabs_zed_2) | Source | Source | Source | Source | [zed-ros2-wrapper](https://github.com/stereolabs/zed-ros2-wrapper.git) | diff --git a/docs_robots/accessories/pacs.mdx b/docs_robots/accessories/pacs.mdx index 68c518269..f7f4fa872 100644 --- a/docs_robots/accessories/pacs.mdx +++ b/docs_robots/accessories/pacs.mdx @@ -80,28 +80,34 @@ Refer to the integration pages for our robots for more details: | **Camera** | [Axis F1035-E](sensors/cameras/axis_f1035_e.mdx) | 020068 | 027105 | 027212 | | | [Axis F34](sensors/cameras/axis_f1035_e.mdx) | 020442 | 027634 | 027633 | | | [Axis M5525-E](sensors/cameras/axis_m5525_e.mdx) | 006758 | 027106 | 027225 | +| | [Axis M5526-E](sensors/cameras/axis_m5526_e.mdx) | 033044 | 034058 | 034059 | | | [FLIR Blackfly S](sensors/cameras/flir_blackfly_s.mdx) | many | 027118 | 027218 | | | [FLIR Ladybug5+](sensors/cameras/flir_ladybug5p.mdx) | 017245 | 028894 | 028893 | | | [Intel RealSense D435](sensors/cameras/realsense_d435.mdx) | 017103 | 026869 | 027208 | +| | Intel RealSense D456 | 032184 | 034081 | 034082 | +| | [Luxonis OAK-D Pro W PoE](sensors/cameras/luxonis_oakd) | 032195 | 034284 | 034285 | | | [Occam Omni 60 Colour](sensors/cameras/occam_omni_60.mdx) | 019645 | 027102 | 027211 | | | [Stereolabs ZED 2](sensors/cameras/stereolabs_zed_2.mdx) | 023611 | 028960 | 028959 | | | [Stereolabs ZED 2i](sensors/cameras/stereolabs_zed_2.mdx) | 025844 | 026872 | 027210 | | **Computer** | Mini-ITX Indoor | - | 027668 | 027667 | -| **GPS** | [Garmin GPS 18x](sensors/gps/garmin_gps_18x.mdx) | 001893 | 028876 | 028875 | +| **GNSS** | [Garmin GPS 18x](sensors/gps/garmin_gps_18x.mdx) | 001893 | 028876 | 028875 | | | [Swift Navigation Duro](sensors/gps/swift_navigation_duro.mdx) | 015822 | 027107 | 027213 | | | [Swift Navigation Duro Inertial](sensors/gps/swift_navigation_duro.mdx) | 018151 | 027108 | 027214 | -| **IMU** | [Microstrain 3DM-GX5-10](sensors/imu/microstrain_3dm_gx5.mdx) | 017839 | 028963 | 028962 | +| **IMU** | Microstrain 3DM-GV7-AHRS | 032617 | 033489 | 033490 | +| | [Microstrain 3DM-GX5-10](sensors/imu/microstrain_3dm_gx5.mdx) | 017839 | 028963 | 028962 | | | [Microstrain 3DM-GX5-15](sensors/imu/microstrain_3dm_gx5.mdx) | 017772 | 027114 | 027215 | | | [Microstrain 3DM-GX5-25](sensors/imu/microstrain_3dm_gx5.mdx) | 014603 | 027117 | 027217 | | | [Microstrain 3DM-GX5-35](sensors/imu/microstrain_3dm_gx5.mdx) | 028528 | 028964 | 028957 | | | [Microstrain 3DM-GX5-45](sensors/imu/microstrain_3dm_gx5.mdx) | 017391 | 028966 | 028965 | | | [Redshift Labs UM7](sensors/imu/redshift_labs_um7.mdx) | 011914 | 028881 | 028880 | +| **INS** | [Fixposition Vision-RTK 2](sensors/ins/fixposition) | 031747 | 033482 | 033484 | | **Lidar 2D** | [Hokuyo UST10-LX](sensors/lidar_2d/hokuyo_ust10_lx.mdx) | 011759 | 027207 | 026611 | | | [Hokuyo UST10-LX Vertical](sensors/lidar_2d/hokuyo_ust10_lx.mdx) | 011759 | 026966 | 027224 | | | [Hokuyo UST20-LX](sensors/lidar_2d/hokuyo_ust20_lx.mdx) | 016359 | 029013 | 029012 | | | [Hokuyo UST30-LX](sensors/lidar_2d/hokuyo_ust30_lx.mdx) | 027584 | 029015 | 029014 | | | [SICK LMS111](sensors/lidar_2d/sick_lms111.mdx) | 006387 | 027657 | 027656 | -| **Lidar 3D** | [Velodyne Puck Lite](sensors/lidar_3d/velodyne_puck_lite.mdx) | 016312
023729 | 029027 | 029026 | +| **Lidar 3D** | Seyond Robin W | 032185 | 033852 | 034087 | +| | [Velodyne Puck Lite](sensors/lidar_3d/velodyne_puck_lite.mdx) | 016312
023729 | 029027 | 029026 | | | [Velodyne Puck](sensors/lidar_3d/velodyne_puck.mdx) | 011703
020972 | 026859 | 027206 | | | [Velodyne Puck Vertical](sensors/lidar_3d/velodyne_puck.mdx) | 011703
020972 | 026965 | 027222 | | | [Velodyne Ultra Puck](sensors/lidar_3d/velodyne_ultra_puck.mdx) | 016901
029035 | 029037 | 029036 | diff --git a/docs_robots/accessories/sensors/cameras/axis_m5525_e.mdx b/docs_robots/accessories/sensors/cameras/axis_m5525_e.mdx index 48800ebf6..e200f74b6 100644 --- a/docs_robots/accessories/sensors/cameras/axis_m5525_e.mdx +++ b/docs_robots/accessories/sensors/cameras/axis_m5525_e.mdx @@ -4,7 +4,6 @@ sidebar_position: 2 --- import Support from "/components/support.mdx"; -import YAML from "/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/axis_camera.mdx";
+ +
+ +## Item Numbers + +| Description | CPR Item | Sales Kit | Installation Kit, With Fasteners | +| :------------------ | :------------------------------------------------------: | :-------: | :------------------------------: | +| Axis M5526-E sensor | [033044](/assets/pdf/clearpath_robotics_033044-TDS1.pdf) | 034058 | 034059 | + +--- + +## Specifications + +| Description | Value | +| :-------------------------- | :------------------- | +| Mass, Camera | 1 kg | +| Voltage, Minimum | PoE, 20 V | +| Voltage, Maximum | PoE, 28 V | +| Voltage, Sensor | PoE, 24 V | +| Power, Average | 4.2 W | +| Data | Ethernet, 100 Mbit/s | +| View, Horizontal | 360° | +| View, Vertical | 0° - 90° | +| Zoom | 10X Optical | +| Ingress Protection, Solids | 6 | +| Ingress Protection, Liquids | 6 | +| Operating Temperature, Min | -20°C | +| Operating Temperature, Max | 50°C | + +--- + +## Software Bringup + +This sensor is not currently included in the Clearpath Robotics robot package but may be in the future. +If you purchased this sensor with your Clearpath robot, we will install the necessary ROS packages and configuration details on the robot's computer. + +Refer to this page's Further Reading section for more details. + +--- + +## Troubleshooting + + + +--- + +## Further Reading + +1. [Datasheet](/assets/pdf/clearpath_robotics_033044-TDS1.pdf) +2. [Dimensions](/assets/pdf/clearpath_robotics_033044-TDS2.pdf) +3. [User Manual](https://help.axis.com/en-us/axis-m5526-e) +4. [Axis website](https://www.axis.com/products/axis-m5526-e) +5. [ROS webpage](http://wiki.ros.org/axis_camera) +6. [ROS tutorial](http://wiki.ros.org/axis_camera/Tutorials/SettingUpAxisNetworkCamera) +7. [GitHub](https://github.com/ros-drivers/axis_camera) diff --git a/docs_robots/accessories/sensors/cameras/axis_q6225_le.mdx b/docs_robots/accessories/sensors/cameras/axis_q6225_le.mdx index db8e90515..5eb96b92a 100644 --- a/docs_robots/accessories/sensors/cameras/axis_q6225_le.mdx +++ b/docs_robots/accessories/sensors/cameras/axis_q6225_le.mdx @@ -1,6 +1,6 @@ --- title: Axis Q6225-LE -sidebar_position: 3 +sidebar_position: 4 --- import Support from "/components/support.mdx"; diff --git a/docs_robots/accessories/sensors/cameras/flir_blackfly_s.mdx b/docs_robots/accessories/sensors/cameras/flir_blackfly_s.mdx index 1a699a427..b22cffb05 100644 --- a/docs_robots/accessories/sensors/cameras/flir_blackfly_s.mdx +++ b/docs_robots/accessories/sensors/cameras/flir_blackfly_s.mdx @@ -1,6 +1,6 @@ --- title: FLIR Blackfly S -sidebar_position: 4 +sidebar_position: 5 --- import Support from "/components/support.mdx"; diff --git a/docs_robots/accessories/sensors/cameras/flir_ladybug5p.mdx b/docs_robots/accessories/sensors/cameras/flir_ladybug5p.mdx index 0a172c2e6..75d7920dd 100644 --- a/docs_robots/accessories/sensors/cameras/flir_ladybug5p.mdx +++ b/docs_robots/accessories/sensors/cameras/flir_ladybug5p.mdx @@ -1,6 +1,6 @@ --- title: FLIR Ladybug5+ -sidebar_position: 5 +sidebar_position: 6 --- import Support from "/components/support.mdx"; diff --git a/docs_robots/accessories/sensors/cameras/luxonis_oakd.mdx b/docs_robots/accessories/sensors/cameras/luxonis_oakd.mdx index 88a644a2c..7fcf3efee 100644 --- a/docs_robots/accessories/sensors/cameras/luxonis_oakd.mdx +++ b/docs_robots/accessories/sensors/cameras/luxonis_oakd.mdx @@ -1,6 +1,6 @@ --- title: Luxonis OAK-D -sidebar_position: 6 +sidebar_position: 7 --- import Support from "/components/support.mdx"; @@ -19,7 +19,7 @@ import YAML from "/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors | :-------------------------- | :------------------------------------------------------: | :-------: | :------------------------------: | | Luxonis OAK-D Pro | 025961 | | | | Luxonis OAK-D Lite | 025963 | | | -| Luxonis OAK-D Pro W PoE | 028065 | | 032195 | +| Luxonis OAK-D Pro W PoE | 032195 | 034284 | 034285 | --- diff --git a/docs_robots/accessories/sensors/cameras/occam_omni_60.mdx b/docs_robots/accessories/sensors/cameras/occam_omni_60.mdx index 9b8b2eb87..546e6082c 100644 --- a/docs_robots/accessories/sensors/cameras/occam_omni_60.mdx +++ b/docs_robots/accessories/sensors/cameras/occam_omni_60.mdx @@ -1,6 +1,6 @@ --- title: Occam Omni 60 -sidebar_position: 7 +sidebar_position: 8 --- import Support from "/components/support.mdx"; diff --git a/docs_robots/accessories/sensors/cameras/realsense_d435.mdx b/docs_robots/accessories/sensors/cameras/realsense_d435.mdx index c37e76f69..6f43af68f 100644 --- a/docs_robots/accessories/sensors/cameras/realsense_d435.mdx +++ b/docs_robots/accessories/sensors/cameras/realsense_d435.mdx @@ -1,6 +1,6 @@ --- title: RealSense D435 -sidebar_position: 8 +sidebar_position: 9 --- import Support from "/components/support.mdx"; diff --git a/docs_robots/accessories/sensors/cameras/stereolabs_zed_2.mdx b/docs_robots/accessories/sensors/cameras/stereolabs_zed_2.mdx index a73ce8286..521cd107a 100644 --- a/docs_robots/accessories/sensors/cameras/stereolabs_zed_2.mdx +++ b/docs_robots/accessories/sensors/cameras/stereolabs_zed_2.mdx @@ -1,6 +1,6 @@ --- title: Stereolabs Zed 2 -sidebar_position: 9 +sidebar_position: 10 --- import Support from "/components/support.mdx"; diff --git a/docs_robots/accessories/sensors/ins/fixposition.mdx b/docs_robots/accessories/sensors/ins/fixposition.mdx index 25e2d6026..aad4428dd 100644 --- a/docs_robots/accessories/sensors/ins/fixposition.mdx +++ b/docs_robots/accessories/sensors/ins/fixposition.mdx @@ -13,7 +13,37 @@ import YAML from "/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors /> -Also known as Fixposition XVN +:::info + +The _Fixposition Vision RTK 2_ has also been called _Fixposition XVN_. + +::: + +## Item Numbers + +| Description | CPR Item | Sales Kit | Installation Kit, With Fasteners | +| :------------------------------ | :------------------------------------------------------: | :-------: | :------------------------------: | +| Fixposition Vision RTK 2 sensor | [031747](/assets/pdf/clearpath_robotics_031747-TDS1.pdf) | 033482 | 033484 | + +--- + +## Specifications + +| Description | Value | +| :-------------------------- | :----------- | +| Mass, Camera | 420 g | +| Voltage, Minimum | 4.5 V | +| Voltage, Maximum | 36 V | +| Voltage, Sensor | 12 V or 24 V | +| Power, Average | 10 W | +| View, Horizontal | 100° | +| View, Vertical | 64° | +| Ingress Protection, Solids | 6 | +| Ingress Protection, Liquids | 6 | +| Operating Temperature, Min | -30°C | +| Operating Temperature, Max | 85°C | + +--- ## Software Bringup @@ -34,5 +64,8 @@ The driver is hosted on [GitHub](https://github.com/fixposition/fixposition_driv ## Further Reading -1. [Manufacturer Website](https://www.fixposition.com/pages/our-product) -2. [GitHub](https://github.com/fixposition/fixposition_driver) +1. [Datasheet](/assets/pdf/clearpath_robotics_031747-TDS1.pdf) +2. [User Manual](/assets/pdf/clearpath_robotics_031747-TDS2.pdf) +3. [Quickstart Guide](/assets/pdf/clearpath_robotics_031747-TDS3.pdf) +4. [Manufacturer Website](https://www.fixposition.com/pages/our-product) +5. [GitHub](https://github.com/fixposition/fixposition_driver) diff --git a/docs_versioned_docs/version-ros2humble/ros/config/customization.mdx b/docs_versioned_docs/version-ros2humble/ros/config/customization.mdx index f5ad5a89f..95fc868bc 100644 --- a/docs_versioned_docs/version-ros2humble/ros/config/customization.mdx +++ b/docs_versioned_docs/version-ros2humble/ros/config/customization.mdx @@ -62,21 +62,34 @@ mkdir config launch For the final step, modify the `CMakeLists.txt` files in both packages to ensure that the description and bringup files are installed to the workspace. -Add the following entry to the `project_description/CMakeLists.txt` file. +Add the following entry to the `project_description/CMakeLists.txt` file. Add these lines after the `find_package()` command but before the `ament_package()`. ```CMake install(DIRECTORY meshes urdf DESTINATION share/${PROJECT_NAME} ) ``` -And, add the following entry to the `project_bringup/CMakeLists.txt` file. +And, add the following entry to the `project_bringup/CMakeLists.txt` file. Add these lines after the `find_package()` command but before the `ament_package()`. ```CMake install(DIRECTORY config launch DESTINATION share/${PROJECT_NAME} ) ``` -Now, all added files to the `meshes`, `urdf`, `config`, and `launch` directories will be installed to the `colcon_ws/install` directory, such that all other nodes will have access to these. Therefore, create +Now, all added files to the `meshes`, `urdf`, `config`, and `launch` directories will be installed to the `colcon_ws/install` directory, such that all other nodes will have access to these. + +>> As long as these directories exist, even if empty, the package will build. However, if any of these directories to `install` is deleted `colcon build` will fail. + +#### Create a URDF +If custom meshes are required, create a URDF Xacro file in the `urdf` directory named `project_description.urdf.xacro` (swap `project` for the name of the project). By default, use the following skeleton to define the `xml` and `xacro` versions: +```xml + + + + + + +``` ### Include Package Description and Bringup in Configuration Once the packages have been setup and all customization files have been created and installed, it is possible to include these into the configuration file. By including these descriptions and bringups, the Clearpath configuration system will generate holistic, amalgamated files that will at launched at start-up. diff --git a/docs_versioned_docs/version-ros2humble/ros/installation/offboard_pc.mdx b/docs_versioned_docs/version-ros2humble/ros/installation/offboard_pc.mdx index ab9e04f31..8d7e4a795 100644 --- a/docs_versioned_docs/version-ros2humble/ros/installation/offboard_pc.mdx +++ b/docs_versioned_docs/version-ros2humble/ros/installation/offboard_pc.mdx @@ -27,9 +27,30 @@ with an IP address that won't interfere with other devices on the network, such Follow the [official instructions](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html) for installing ROS 2 Humble from debian packages. +### Clearpath Packages + +Clearpath hosts open-source and closed-source ROS packages compiled as debian packages on our own servers. To add +these packages to your system you must add Clearpath's servers to your `apt` sources by opening a terminal and +running the following commands: +```bash +wget https://packages.clearpathrobotics.com/public.key -O - | sudo apt-key add - +sudo sh -c 'echo \ + "deb https://packages.clearpathrobotics.com/stable/ubuntu $(lsb_release -cs) main" > \ + /etc/apt/sources.list.d/clearpath-latest.list' +sudo apt-get update +``` + +To update `rosdep` dependencies with the package built & hosted on Clearpath's servers, run +```bash +sudo wget \ + https://raw.githubusercontent.com/clearpathrobotics/public-rosdistro/master/rosdep/50-clearpath.list \ + -O /etc/ros/rosdep/sources.list.d/50-clearpath.list +rosdep update +``` + ### Clearpath Desktop metapackage -Once the ROS 2 Humble has been installed, the [Clearpath Desktop](https://github.com/clearpathrobotics/clearpath_desktop) +Once ROS 2 Humble has been installed, the [Clearpath Desktop](https://github.com/clearpathrobotics/clearpath_desktop) metapackage can be installed. ``` diff --git a/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/img/phidgets_spatial.png b/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/img/phidgets_spatial.png new file mode 100644 index 000000000..2b76338df Binary files /dev/null and b/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/img/phidgets_spatial.png differ diff --git a/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/phidgets_spatial.mdx b/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/phidgets_spatial.mdx new file mode 100644 index 000000000..2ba939f02 --- /dev/null +++ b/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/phidgets_spatial.mdx @@ -0,0 +1,31 @@ + + + + + +
+
+
+ +
+
+
+ +```yaml + imu: + - model: phidgets_spatial + urdf_enabled: true + launch_enabled: true + parent: base_link + xyz: [0.0, 0.0, 0.0] + rpy: [0.0, 0.0, 0.0] + ros_parameters: + phidgets_spatial: + data_interval_ms: 20 +``` +
+ +#### Package and Setup +The Phidgets devices use the `phidgets_spatial` ROS 2 package. The driver is open source, maintained by ROS community, and hosted on [GitHub](https://github.com/ros-drivers/phidgets_drivers). + +For more specifics on the way Clearpath's configuration system launches the `phidgets_spatial` driver, see the `phidgets_spatial` [launch file](https://github.com/clearpathrobotics/clearpath_robot/blob/jazzy/clearpath_sensors/launch/phidgets_spatial.launch.py) and the [default parameter file](https://github.com/clearpathrobotics/clearpath_robot/blob/jazzy/clearpath_sensors/config/phidgets_spatial.yaml) in `clearpath_sensors`. diff --git a/docs_versioned_docs/version-ros2jazzy/ros/changelog.mdx b/docs_versioned_docs/version-ros2jazzy/ros/changelog.mdx index aa861c451..c05e6f592 100644 --- a/docs_versioned_docs/version-ros2jazzy/ros/changelog.mdx +++ b/docs_versioned_docs/version-ros2jazzy/ros/changelog.mdx @@ -8,6 +8,64 @@ import Style from '/assets/css/changelog.css';
+## Current versions: + +:::note +Nested packages are part of the top repository. +::: + +- clearpath_msgs: ![GitHub Tag](https://img.shields.io/github/v/tag/clearpathrobotics/clearpath_msgs?label=latest) + - clearpath_motor_msgs + - clearpath_msgs + - clearpath_platform_msgs +- clearpath_config: ![GitHub Tag](https://img.shields.io/github/v/tag/clearpathrobotics/clearpath_config?label=latest) +- clearpath_common: ![GitHub Tag](https://img.shields.io/github/v/tag/clearpathrobotics/clearpath_common?label=latest) + - clearpath_bt_joy + - clearpath_common + - clearpath_control + - clearpath_customization + - clearpath_description + - clearpath_diagnostics + - clearpath_generator_common + - clearpath_manipulators + - clearpath_manipulators_description + - clearpath_mounts_description + - clearpath_platform_description + - clearpath_sensors_description +- clearpath_robot: ![GitHub Tag](https://img.shields.io/github/v/tag/clearpathrobotics/clearpath_robot?label=latest) + - clearpath_generator_robot + - clearpath_platform + - lynx_motor_driver + - puma_motor_driver + - clearpath_robot + - clearpath_sensors + - clearpath_tests + + + + +## [2.6] 2025-07-04 + +### New Features +- Added Lynx 1.0.1 firmware for A300 motor controllers (see [here](https://docs.clearpathrobotics.com/docs_robots/outdoor_robots/husky/a300/maintenance_husky#maintenance_husky_motor_controller_firmware) to update) with many performance improvements +- Added travel field to Lynx feedback +- Added MCU service for clearing needs_reset on A300 +- Updated Power.msg CC01 enums +- Added sensor sample for phidgets_spatial +- Added support for W200 +- Enabled foxglove bridge by default +- Added A300 AMP attachments, samples +- Added foxglove dependency +- Enabled dependency on sevcon and valence bms +- Updated grab-diagnostics to latest + +### Fixed +- Fixed W200 Diff Drive Parameters +- Re-enable publishing controller input to joy_teleop/cmd_vel +- Dropped A200 controller manager update rate +- Fixed expected diagnostics rates +- Fixed missing dependency lms1xx + ## [2.5] 2025-05-30 ### New Features diff --git a/docs_versioned_docs/version-ros2jazzy/ros/config/customization.mdx b/docs_versioned_docs/version-ros2jazzy/ros/config/customization.mdx index e65c864ce..e404c4a94 100644 --- a/docs_versioned_docs/version-ros2jazzy/ros/config/customization.mdx +++ b/docs_versioned_docs/version-ros2jazzy/ros/config/customization.mdx @@ -62,21 +62,34 @@ mkdir config launch For the final step, modify the `CMakeLists.txt` files in both packages to ensure that the description and bringup files are installed to the workspace. -Add the following entry to the `project_description/CMakeLists.txt` file. +Add the following entry to the `project_description/CMakeLists.txt` file. Add these lines after the `find_package()` command but before the `ament_package()`. ```CMake install(DIRECTORY meshes urdf DESTINATION share/${PROJECT_NAME} ) ``` -And, add the following entry to the `project_bringup/CMakeLists.txt` file. +And, add the following entry to the `project_bringup/CMakeLists.txt` file. Add these lines after the `find_package()` command but before the `ament_package()`. ```CMake install(DIRECTORY config launch DESTINATION share/${PROJECT_NAME} ) ``` -Now, all added files to the `meshes`, `urdf`, `config`, and `launch` directories will be installed to the `colcon_ws/install` directory, such that all other nodes will have access to these. Therefore, create +Now, all added files to the `meshes`, `urdf`, `config`, and `launch` directories will be installed to the `colcon_ws/install` directory, such that all other nodes will have access to these. + +>> As long as these directories exist, even if empty, the package will build. However, if any of these directories to `install` is deleted `colcon build` will fail. + +#### Create a URDF +If custom meshes are required, create a URDF Xacro file in the `urdf` directory named `project_description.urdf.xacro` (swap `project` for the name of the project). By default, use the following skeleton to define the `xml` and `xacro` versions: +```xml + + + + + + +``` ## Include Package Description and Bringup in Configuration Once the packages have been setup and all customization files have been created and installed, it is possible to include these into the configuration file. By including these descriptions and bringups, the Clearpath configuration system will generate holistic, amalgamated files that will at launched at start-up. diff --git a/docs_versioned_docs/version-ros2jazzy/ros/config/yaml/sensors/imu.mdx b/docs_versioned_docs/version-ros2jazzy/ros/config/yaml/sensors/imu.mdx index 7fed94f2b..cbabddad8 100644 --- a/docs_versioned_docs/version-ros2jazzy/ros/config/yaml/sensors/imu.mdx +++ b/docs_versioned_docs/version-ros2jazzy/ros/config/yaml/sensors/imu.mdx @@ -8,6 +8,7 @@ toc_max_heading_level: 4 import CHRoboticsUM6 from "/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/chrobotics_um6.mdx"; import RedShiftUM7 from "/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/redshift_um7.mdx"; import MicrostrainIMU from "/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/microstrain_imu.mdx"; +import PhidgetsIMU from "/docs_versioned_docs/version-ros2jazzy/components/yaml/sensors/phidgets_spatial.mdx"; Inertial measurement units are sensors that publish messages of the type `sensor_msgs/Imu`. These messages contain orientation, angular velocity, and/or linear acceleration depending on the device. @@ -16,6 +17,9 @@ Inertial measurement units are sensors that publish messages of the type `sensor ### Microstrain IMU +### Phidgets IMU + + ### CHRobotics UM6 diff --git a/docs_versioned_docs/version-ros2jazzy/ros/installation/offboard_pc.mdx b/docs_versioned_docs/version-ros2jazzy/ros/installation/offboard_pc.mdx index 6418e6320..14456cfe6 100644 --- a/docs_versioned_docs/version-ros2jazzy/ros/installation/offboard_pc.mdx +++ b/docs_versioned_docs/version-ros2jazzy/ros/installation/offboard_pc.mdx @@ -27,9 +27,30 @@ with an IP address that won't interfere with other devices on the network, such Follow the [official instructions](https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debs.html) for installing ROS 2 Jazzy from debian packages. +## Clearpath Packages + +Clearpath hosts open-source and closed-source ROS packages compiled as debian packages on our own servers. To add +these packages to your system you must add Clearpath's servers to your `apt` sources by opening a terminal and +running the following commands: +```bash +wget https://packages.clearpathrobotics.com/public.key -O - | sudo apt-key add - +sudo sh -c 'echo \ + "deb https://packages.clearpathrobotics.com/stable/ubuntu $(lsb_release -cs) main" > \ + /etc/apt/sources.list.d/clearpath-latest.list' +sudo apt-get update +``` + +To update `rosdep` dependencies with the package built & hosted on Clearpath's servers, run +```bash +sudo wget \ + https://raw.githubusercontent.com/clearpathrobotics/public-rosdistro/master/rosdep/50-clearpath.list \ + -O /etc/ros/rosdep/sources.list.d/50-clearpath.list +rosdep update +``` + ## Clearpath Desktop metapackage -Once the ROS 2 Jazzy has been installed, the [Clearpath Desktop](https://github.com/clearpathrobotics/clearpath_desktop) +Once ROS 2 Jazzy has been installed, the [Clearpath Desktop](https://github.com/clearpathrobotics/clearpath_desktop) metapackage can be installed. ``` diff --git a/docs_versioned_docs/version-ros2jazzy/ros/troubleshooting.mdx b/docs_versioned_docs/version-ros2jazzy/ros/troubleshooting.mdx index 7616096c3..34a6b5c32 100644 --- a/docs_versioned_docs/version-ros2jazzy/ros/troubleshooting.mdx +++ b/docs_versioned_docs/version-ros2jazzy/ros/troubleshooting.mdx @@ -7,6 +7,8 @@ sidebar_position: 9 The following are common problems our [support team](https://support.clearpathrobotics.com/hc/en-us) have received. Before [submitting a request](https://support.clearpathrobotics.com/hc/en-us/requests/new) please review the items below to see if they resolve your problem. If your problem is not resolved, download a [diagnostic capture](./cockpit/ros2_diagnostics.mdx#capture-diagnostics) from the [Cockpit webserver](./cockpit/overview.mdx) and attach it to the support request. +An alternative to Cockpit diagnostic capture is running `ros2 run clearpath_robot grab-diagnostics` which will grab all the typical data needed for troubleshooting and place it into a compressed folded. +It can be copied off the computer using a tool such as `scp`. Our [getting started](/docs/ros) section may also help answer some questions. diff --git a/docs_versioned_docs/version-ros2jazzy/ros/tutorials/navigation_demos/overview.mdx b/docs_versioned_docs/version-ros2jazzy/ros/tutorials/navigation_demos/overview.mdx index 278f99d0a..e90108807 100644 --- a/docs_versioned_docs/version-ros2jazzy/ros/tutorials/navigation_demos/overview.mdx +++ b/docs_versioned_docs/version-ros2jazzy/ros/tutorials/navigation_demos/overview.mdx @@ -1,5 +1,5 @@ --- -title: Navitation Demos +title: Navigation Demos sidebar_label: Navigation Demos sidebar_position: 1 toc_min_heading_level: 2 diff --git a/docusaurus.config.js b/docusaurus.config.js index 43dd75b29..4c48edf21 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -14,7 +14,8 @@ const config = { url: "https://docs.clearpathrobotics.com", baseUrl: "/", onBrokenLinks: "throw", - onBrokenMarkdownLinks: "warn", + onBrokenMarkdownLinks: "throw", + onBrokenAnchors: "throw", favicon: "img/website_images/favicon.ico", i18n: { diff --git a/package-lock.json b/package-lock.json index d58f2cc91..1667ba3b9 100644 --- a/package-lock.json +++ b/package-lock.json @@ -5377,9 +5377,9 @@ } }, "node_modules/caniuse-lite": { - "version": "1.0.30001690", - "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001690.tgz", - "integrity": "sha512-5ExiE3qQN6oF8Clf8ifIDcMRCRE/dMGcETG/XGMD8/XiXm6HXQgQTh1yZYLXXpSOsEUlJm1Xr7kGULZTuGtP/w==", + "version": "1.0.30001723", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001723.tgz", + "integrity": "sha512-1R/elMjtehrFejxwmexeXAtae5UO9iSyFn6G/I806CYC/BLyyBk1EPhrKBkWhy6wM6Xnm47dSJQec+tLJ39WHw==", "funding": [ { "type": "opencollective", @@ -21577,9 +21577,9 @@ } }, "caniuse-lite": { - "version": "1.0.30001690", - "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001690.tgz", - "integrity": "sha512-5ExiE3qQN6oF8Clf8ifIDcMRCRE/dMGcETG/XGMD8/XiXm6HXQgQTh1yZYLXXpSOsEUlJm1Xr7kGULZTuGtP/w==" + "version": "1.0.30001723", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001723.tgz", + "integrity": "sha512-1R/elMjtehrFejxwmexeXAtae5UO9iSyFn6G/I806CYC/BLyyBk1EPhrKBkWhy6wM6Xnm47dSJQec+tLJ39WHw==" }, "ccount": { "version": "2.0.1", diff --git a/static/assets/pdf/clearpath_robotics_027110.pdf b/static/assets/pdf/clearpath_robotics_027110.pdf index 61ecfb66e..2dab7bf7c 100644 Binary files a/static/assets/pdf/clearpath_robotics_027110.pdf and b/static/assets/pdf/clearpath_robotics_027110.pdf differ diff --git a/static/assets/pdf/clearpath_robotics_028859.pdf b/static/assets/pdf/clearpath_robotics_028859.pdf index 869074317..c10ceb427 100644 Binary files a/static/assets/pdf/clearpath_robotics_028859.pdf and b/static/assets/pdf/clearpath_robotics_028859.pdf differ diff --git a/static/assets/pdf/clearpath_robotics_031747-TDS1.pdf b/static/assets/pdf/clearpath_robotics_031747-TDS1.pdf new file mode 100644 index 000000000..dc72d1120 Binary files /dev/null and b/static/assets/pdf/clearpath_robotics_031747-TDS1.pdf differ diff --git a/static/assets/pdf/clearpath_robotics_031747-TDS2.pdf b/static/assets/pdf/clearpath_robotics_031747-TDS2.pdf new file mode 100644 index 000000000..a914db24c Binary files /dev/null and b/static/assets/pdf/clearpath_robotics_031747-TDS2.pdf differ diff --git a/static/assets/pdf/clearpath_robotics_031747-TDS3.pdf b/static/assets/pdf/clearpath_robotics_031747-TDS3.pdf new file mode 100644 index 000000000..0e6f45a7f Binary files /dev/null and b/static/assets/pdf/clearpath_robotics_031747-TDS3.pdf differ diff --git a/static/assets/pdf/clearpath_robotics_033044-TDS1.pdf b/static/assets/pdf/clearpath_robotics_033044-TDS1.pdf new file mode 100644 index 000000000..f359df9da Binary files /dev/null and b/static/assets/pdf/clearpath_robotics_033044-TDS1.pdf differ diff --git a/static/assets/pdf/clearpath_robotics_033044-TDS2.pdf b/static/assets/pdf/clearpath_robotics_033044-TDS2.pdf new file mode 100644 index 000000000..bb109abfa Binary files /dev/null and b/static/assets/pdf/clearpath_robotics_033044-TDS2.pdf differ diff --git a/static/img/robot_images/husky_a300_images/husky_a300_base_link.png b/static/img/robot_images/husky_a300_images/husky_a300_base_link.png index a4ff54aa0..94eb0cd1b 100644 Binary files a/static/img/robot_images/husky_a300_images/husky_a300_base_link.png and b/static/img/robot_images/husky_a300_images/husky_a300_base_link.png differ