Skip to content

Commit

Permalink
Docs/velodyne puck (#38)
Browse files Browse the repository at this point in the history
* Add documentation for velodyne puck

* Update slambox_setting.md

* Add velodyne LiDAR alignment photo.

* Add downloading mapping file

---------

Co-authored-by: Haneol Kim <hekim@jmarple.ai>
Co-authored-by: Jongkuk Lim <limjk@jmarple.ai>
  • Loading branch information
3 people authored Jan 10, 2024
1 parent c59cff3 commit 11842d4
Show file tree
Hide file tree
Showing 5 changed files with 39 additions and 1 deletion.
31 changes: 31 additions & 0 deletions docs/getting_started/lidar_setting.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Please follow instructions on your LiDAR sensor.
1. Livox [MID-360](#LiDARSetting-MID360)
2. Livox [AVIA](#LiDARSetting-AVIA)
3. Ouster [OS0 Family (OS0-32, OS0-64, and OS0-128)](#LIDARSetting-OusterOS0)
4. Velodyne [Puck (Lite)](#LIDARSetting-VelodynePuck)


[TOC]
Expand Down Expand Up @@ -165,3 +166,33 @@ Make sure LiDAR data is visible in Ouster Studio.
![Ouster Studio visualization](getting_started/lidar_setting/Ouster_Studio_working.jpg)

Now OS0 is ready to connect with SLAMBOX device. Connect OS0 SLAMBOX device via ethernet cable.

# 4. Velodyne Puck (VLP family) {#LIDARSetting-VelodynePuck}

## 4.1. Preparing for LiDAR setup

Before starting the setup process, make sure you have following:

* Compudate with Ethernet ports (Ubuntu, MacOS, or Windows)

## 4.2. Velodyne Configuration Steps

### 4.2.1. Setting Computer IP Address

Set the computer's IP Address to `192.168.1.50`

![IP Address Setting](getting_started/lidar_setting/ip_setting_192_168_1_50.jpg)

Then connect to configuration page with any web browser (chrome, firefox etc.)

The default IP of Velodyne Puck is `192.168.1.201`

![Velodyne configuration page example](getting_started/lidar_setting/velodyne_configuration_image.png)

If the configuration pops up without any problems, then connect the LiDAR and SLAMBOX device via ethernet cable.

**NOTE** Since Velodyne LiDAR does not include an IMU, an internal IMU built in SLAMBOX will be used. Therefore, SLAMBOX is required to align with Velodyne LiDAR as below picture.

![Axis alignment with SLAMBOX and Velodyne LiDAR](getting_started/lidar_setting/velodyne_slambox_align.jpg){width=450px}

**NOTE** The coordinate system of `Odometry` output is based on the LiDAR, however, we advise you to install SLAMBOX as close as possible to the LiDAR for better performance.
1 change: 1 addition & 0 deletions docs/getting_started/slambox_setting.md
Original file line number Diff line number Diff line change
Expand Up @@ -243,6 +243,7 @@ $MAVLINK_TYPE 0#
| 3 | ouster64 |
| 4 | ouster128 |
| 5 | avia |
| 7 | velodyne_puck |
**Example)** Set LiDAR type to `mid360`
```
Expand Down
8 changes: 7 additions & 1 deletion docs/getting_started/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,13 @@ Then, set the device IP like the screen shot below

- Check how to setup LiDAR to *SLAMBOX*, please see here([LiDAR Setting](#LiDARSetting))

# 4. Advanced {#Tutorial-Advanced}
# 4. Download Mapping File {#Tutorial-DownloadMappingFile}

- Mapping results are saved periodically in the SLAMBOX device. The saved mapping file(.PCD) can be downloaded by visiting web URL (http://192.168.101.101:8080).

**NOTE** USB-C (OTG) cable must be plugged into your computer in order to access the URL.

# 5. Advanced {#Tutorial-Advanced}

Please check following pages for the next step.

Expand Down
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.

0 comments on commit 11842d4

Please sign in to comment.