Skip to content

Commit

Permalink
Initial addition of Blackfly instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
hilary-luo committed Oct 29, 2023
1 parent d7558a1 commit 127d49d
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 4 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -38,10 +38,17 @@ import Support from "/components/support.mdx";

## 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.
This sensor is included in the Clearpath Robotics robot package that is installed on all of our robots.
This allows you to add or remove the sensor from your robot's software description by modifying the
[robot configuration yaml](../../../../ros/config/yaml.mdx#cameras).

Refer to this page's Further Reading section for more details.
This sensor also requires additional changes beyond the robot.yaml file. These changes are included by default in the
Clearpath ISO, but can also be applied using the following command:

```bash
ros2 run spinnaker_camera_driver linux_setup_flir
```
or by following the [manual setup instructions](https://github.com/ros-drivers/flir_camera_driver/blob/humble-devel/spinnaker_camera_driver/docs/linux_setup_flir.md).

---

Expand Down
15 changes: 15 additions & 0 deletions docs_versioned_docs/version-ros2humble/ros/config/yaml.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -806,6 +806,21 @@ camera:
pointcloud.enable: true
```

- **_flir_blackfly:_**

```yaml
camera:
- model: flir_blackfly
urdf_enabled: true
launch_enabled: true
parent: fath_pivot_0_mount
xyz: [0.0, 0.0, 0.0]
rpy: [0.0, 0.0, 0.0]
ros_parameters:
flir_blackfly:
serial_number: 0
```

### GPS

- **_swift_nav:_**
Expand Down
12 changes: 12 additions & 0 deletions docs_versioned_docs/version-ros2humble/ros/installation/robot.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -125,6 +125,12 @@ To start the services, call
sudo systemctl daemon-reload && sudo systemctl start clearpath-robot.service
```

#### Additional settings

Certain sensors may require additional setup, please review the [Accessories](../../robots/accessories/accessories.mdx) pages
for any additional instructions for the sensors that you are using. For example, the Blackfly camera has additional instructions
listed under [software bringup](../../robots/accessories/sensors/cameras/flir_blackfly_s#software-bringup).

### Option 2: Manual Source Install

#### ROS 2 Humble
Expand Down Expand Up @@ -259,3 +265,9 @@ Add the following line to your `~/.bashrc` file to automatically source the gene
```
source /etc/clearpath/setup.bash
```

#### Additional settings

Certain sensors may require additional setup, please review the [Accessories](../../robots/accessories/accessories.mdx) pages
for any additional instructions for the sensors that you are using. For example, the Blackfly camera has additional instructions
listed under [software bringup](../../robots/accessories/sensors/cameras/flir_blackfly_s#software-bringup).
2 changes: 1 addition & 1 deletion docs_versioned_docs/version-ros2humble/ros/ros.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ sensors that have been validated by Clearpath.
| [Garmin GPS 18x](../robots/accessories/sensors/gps/garmin_gps_18x.mdx) | GPS | Source | [nmea_navsat_driver](https://github.com/ros-drivers/nmea_navsat_driver/tree/ros2) |
| NovAtel SMART6 and SMART7 | GPS | Debian | [nmea_navsat_driver](https://github.com/ros-drivers/nmea_navsat_driver/tree/ros2) |
| [Swift Navigation Duro](../robots/accessories/sensors/gps/swift_navigation_duro.mdx) | GPS | Source | [duro_gps_driver](https://github.com/szenergy/duro_gps_driver/tree/ros2-humble) |
| [Flir Blackfly S](../robots/accessories/sensors/cameras/flir_blackfly_s.mdx) | Camera | Source | [flir_camera_driver](https://github.com/ros-drivers/flir_camera_driver/tree/humble-devel) |
| [Flir Blackfly S](../robots/accessories/sensors/cameras/flir_blackfly_s.mdx) | Camera | Debian | [flir_camera_driver](https://github.com/ros-drivers/flir_camera_driver/tree/humble-devel) |
| [Intel Realsense D435](../robots/accessories/sensors/cameras/realsense_d435.mdx) | Depth Camera | Debian | [realsense-ros](https://github.com/IntelRealSense/realsense-ros/tree/ros2-development) |
| [Stereolabs Zed 2](../robots/accessories/sensors/cameras/stereolabs_zed_2.mdx) | Depth Camera | Source | [zed-ros2-wrapper](https://github.com/stereolabs/zed-ros2-wrapper.git) |

Expand Down

0 comments on commit 127d49d

Please sign in to comment.