Skip to content

Commit f0ca142

Browse files
committed
readme about ouster and zed
1 parent f410872 commit f0ca142

File tree

1 file changed

+57
-1
lines changed

1 file changed

+57
-1
lines changed

README.md

Lines changed: 57 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,19 @@
22
# Sensor Setup
33

44
[![ROS2](https://img.shields.io/badge/ROS2-Humble-blue)](https://docs.ros.org/en/humble/)
5+
[![Ubuntu](https://img.shields.io/badge/Ubuntu-22.04-orange)](https://releases.ubuntu.com/22.04/)
6+
[![ZED SDK](https://img.shields.io/badge/ZED_SDK-4.1+-red)](https://www.stereolabs.com/developers/release/)
7+
[![Ouster SDK](https://img.shields.io/badge/Ouster_SDK-0.11.1-lightred)](https://static.ouster.dev/sdk-docs/index.html)
58

69
A ROS2 package for configuring, testing, and operating sensors, specifically:
710
- ZED2 Camera (Monocular Mode)
811
- Ouster OS-1 LiDAR
912

1013
## 📋 Table of Contents
14+
- [System Requirements](#-system-requirements)
15+
- [Basic Requirements](#basic-requirements)
16+
- [ZED SDK Installation](#zed-sdk-installation)
17+
- [Ouster SDK Installation](#ouster-sdk-installation)
1118
- [Quick Start](#-quick-start)
1219
- [Usage](#-usage)
1320
- [Launch Options](#launch-options)
@@ -21,6 +28,52 @@ A ROS2 package for configuring, testing, and operating sensors, specifically:
2128
- [Recording](#recording)
2229
- [Playback](#playback)
2330

31+
32+
## 💻 System Requirements
33+
34+
### Basic Requirements
35+
- **Operating System**: Ubuntu 22.04 LTS (Jammy Jellyfish)
36+
- **ROS2 Distribution**: Humble Hawksbill
37+
- **Python**: 3.10 or higher
38+
- **CUDA**: 12.1 or higher (for ZED SDK)
39+
40+
### ZED SDK Installation
41+
1. Download ZED SDK for Ubuntu 22.04:
42+
```bash
43+
wget https://download.stereolabs.com/zedsdk/4.0/cu117/ubuntu22 -O zed_sdk.run
44+
```
45+
46+
2. Make the installer executable:
47+
```bash
48+
chmod +x zed_sdk.run
49+
```
50+
51+
3. Run the installer:
52+
```bash
53+
./zed_sdk.run
54+
```
55+
56+
4. Install ZED ROS2 wrapper:
57+
```bash
58+
cd ~/ros2_sensor_ws/src
59+
git clone --recursive https://github.com/stereolabs/zed-ros2-wrapper.git
60+
cd ..
61+
colcon build --symlink-install
62+
source install/setup.bash
63+
```
64+
65+
### Ouster SDK Installation
66+
- Install Ouster SDK:
67+
```bash
68+
pip3 install ouster-sdk
69+
```
70+
71+
### Network Configuration for Ouster LiDAR
72+
1. after connecting the lidar to your IPC / computer via Eternet cable check if network is working.
73+
follow this video for more information : [Connecting ouster tutorial](https://www.youtube.com/watch?v=nTm2HY2OEfs&ab_channel=Ouster)
74+
75+
2. To verify connection and test visulization with ouster-cli, follow this video [Visualize Ouster](https://www.youtube.com/watch?v=m0ANVFunObU&ab_channel=Ouster)
76+
2477
## 🚀 Quick Start
2578

2679
1. Create a ROS2 workspace:
@@ -149,4 +202,7 @@ ros2 bag play my_rosbag --clock 100
149202
- Set `use_sim_time` in node constructor for nodes created after playback
150203
- Configure time settings in launch files when possible
151204
- Verify settings: `ros2 param get /your_node use_sim_time`
152-
- Review config files before sensor startup
205+
- Review config files before sensor startup
206+
207+
208+

0 commit comments

Comments
 (0)