YDLIDAR X4 User manual

1
YDLIDAR X4
USER MANUAL
Doc#：01.13.000002

www.ydlidar.com Copyright 2015-2019 YDLIDAR
2 / 14
CONTENTS
CONTENTS
YDLIDAR X4 DEVELOPMENT KIT...............................................................................................................................................3
WINDOWS USAGE GUIDE...............................................................................................................................................................4
START SCANNING..................................................................................................................................................................... 7
SYSTEM SETTINGS....................................................................................................................................................................8
SAVE DATA.................................................................................................................................................................................8
Ranging frequency.........................................................................................................................................................................9
ANGLE CALIBRATION..............................................................................................................................................................9
(1) Unlock calibration function..................................................................................................................................................... 9
(2) setting the baseline...................................................................................................................................................................9
(3) Adjusting the angle.................................................................................................................................................................. 9
(4) save configuration....................................................................................................................................................................9
(5) Lock calibration function.......................................................................................................................................................10
FIRMWARE UPGRADE............................................................................................................................................................10
SOFTWARE UPGRADE............................................................................................................................................................10
LINUX ROS OPERATION...............................................................................................................................................................11
Document description..................................................................................................................................................................11
Device connection....................................................................................................................................................................... 11
ROS Driver Installation............................................................................................................................................................... 11
RVIZ installation......................................................................................................................................................................... 12
RVIZ Check the scan results....................................................................................................................................................... 12
Modify the scan angle problem................................................................................................................................................... 12
USE CAUTION.................................................................................................................................................................................. 14

www.ydlidar.com Copyright 2015-2019 YDLIDAR
3 / 14
YDLIDAR X4 DEVELOPMENT KIT
The YDLIDAR X4 (hereafter abbreviated as X4) development kit is designed to facilitate users'
performance evaluation and early development of the X4. By using the X4 development kit and
matching evaluation software, point cloud data scanned by X4 to the environment can be observed
on the PC or developed on the SDK.
Development Kit
The X4 development kit has the following components:
YDLIDAR X4
USB Cable
USB Adapter
board
PH2.0-8P
Cable
FIG 1 YDLIDAR X4 DEVELOPMENT KIT
CHART 1 YDLIDAR X4 DEVELOPMENT KIT DESCRIPTION
Item
Qty
Description
X4 Lidar
1
Standard version of the X4 Lidar. The X4 has an integrated motor drive for motor
control.
USB cable
1
Use with USB adapter board to connect X4 and PC.
It is both a power supply line and a data line.
USB adapter board
1
This component is used for USB to UART functions, enabling X4 and PC to be
quickly interconnected.
Also supports the serial port DTR signal to the X4 motor stop control.
A MicroUSB Power Interface (PWR) for auxiliary power supply is also provided.
PH2.0-8P cable
1
This component meets the user's development needs in a multi-platform
environment.
Note: USB adapter board has two MicroUSB interfaces: USB_DATA, USB_PWR.
USB_DATA: Data supply multiplex interface. In most cases, just using this interface can meet the power
and communication needs.
USB_PWR: Auxiliary power interface. The USB interface of some development platforms has a weak
current drive capability, and auxiliary power can be used.

www.ydlidar.com Copyright 2015-2019 YDLIDAR
4 / 14
5V power supply
WINDOWS USAGE GUIDE
Device connection
When evaluating and developing X4 under windows, you need to interconnect X4 and PC. The
specific process is as follows:
FIG 2 YDLIDAR X4 CONNECTION STEP 1
FIG 3 YDLIDAR X4 CONNECTION STEP 2
Connect the adapter board and X4 first, and then connect the USB cable to the USB port on the
adapter board and the PC. Note that the USB interface's Micro interface is connected to the USB
adapter's USB_DATA. After the X4 is powered on, it is in idle mode and the motor does not turn.
The drive current of the USB interface of some development platforms or PCs is weak, and the X4
needs to access the +5V auxiliary power supply, otherwise the radar will work abnormally.
FIG 4 YDLIDAR X4 AUXILIARY POWER SUPPLY
PC

www.ydlidar.com Copyright 2015-2019 YDLIDAR
5 / 14
Driver Installation
To evaluate and develop the X4 under Windows, you need to install the serial port driver of the USB
adapter board. The USB adapter board of this kit adopts CP2102 chip to realize serial port (UART)
to USB signal conversion. Its driver can be downloaded from our official website or downloaded
from the official website of Silicon Labs:
http://ydlidar.com/
http://cn.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers
After extracting the driver package, run the CP2102's Windows driver installation file (exe file under
CP210x_VCP_Windows). Please select the 32-bit version (x86) or 64-bit version (x64) installation
program according to the version of the windows operating system.
FIG 5 YDLIDAR X4 DRIVER VERSION SELECTION
Double-click the exe file and follow the prompts to install it
FIG 6 YDLIDAR X4 DRIVER INSTALLATION I
After the installation is complete, you can right-click My Computer and select Properties. Under the
System screen, select Device Manager from the left menu to access the device manager. Expand
[Port] to see the serial port name corresponding to the identified USB adapter, that is, the driver

www.ydlidar.com Copyright 2015-2019 YDLIDAR
6 / 14
installation is successful. The following figure shows COM3. (Note that the port must be checked in
case of X4 and PC interconnection)
Evaluation software
FIG 7 YDLIDAR X4 DRIVE INSTALLATION II
YDLIDAR provides Point Cloud Viewer, a point cloud data visualization software for X4 real-time
scanning. The user can intuitively observe the X4 scan effect picture using this software. YDLIDAR
provides X4 real-time point cloud data and real-time scanning frequency, and X4 version
information can be read at the same time. And can save the scan data offline to an external file for
further analysis.
Before using YDLIDAR, make sure that the X4 USB adapter board serial port driver is installed
successfully, and check whether the X4 and PC USB ports are successfully interconnected. Run the
evaluation software: PointCloudViewer.exe, select the corresponding serial port number and model
number.
FIG 8 YDLIDAR X4 EVALUATION SOFTWARE
Note: The Lidar does not turn on the heartbeat function by default. This function needs to send the scan
command continuously to make it work normally. If the scanning frequency is stopped, the Lidar will stop
scanning. Currently, G4 and F4 are compatible with this function, and X4 and X4 are not compatible.

www.ydlidar.com Copyright 2015-2019 YDLIDAR
7 / 14
After confirmation,you can see the following screen：
FIG 9 POINTCLOUD VIEWER EVALUATION SOFTWARE STARTUP DISPLAY
START SCANNING
Click to start scanning and display the environment point cloud.
Clicking to stop it,as shown below:
FIGURE10 LIDAR SCANNING POINT CLOUD DISPLAY

www.ydlidar.com Copyright 2015-2019 YDLIDAR
8 / 14
SYSTEM SETTINGS
Click System Settings and the following settings box will pop up:
FIGURE 11 CLIENT SETTINGS BOX
As shown in the figure, you can configure and detect the Lidar on this setup page, as well as Lidar
firmware upgrade, client software upgrade, etc.
SAVE DATA
During Lidar scanning,click ，Save the point cloud data as prompted.The system will save the
point cloud information scanned in a circle according to the following format.
FIGURE 12 POINT CLOUD DATA SAVE FORMAT

www.ydlidar.com Copyright 2015-2019 YDLIDAR
9 / 14
Ranging frequency
is used to switch the Lidar's ranging frequency. The X4 supports 4K, 8K, and 9K ranging
frequency switching. Other versions of the Lidar do not support this function, and the click is
invalid. When the Lidar is in the scanning state, you need to click the scanning control again after
switching the ranging frequency.
ANGLE CALIBRATION
During the mechanical assembly of the Lidar, the user may have a deviation in the zero angle.
In this case, the angle calibration function of the client can be used to calibrate according to
actual needs. The specific operations are as follows:
(1) Unlock calibration function
Click the unlock control , the system will pop up the login box, the default password is ydlidar.
The effect of these controls will change after unlocking.
(2) setting the baseline
Click and the system will provide a baseline of the appropriate size as a reference for the
adjustment.
(3) Adjusting the angle
Click to adjust the angle to the appropriate position.
(4) save configuration

www.ydlidar.com Copyright 2015-2019 EAI
10 /
12
After the adjustment is completed, click the system will automatically save the
calibration parameters, and the calibration will take effect after saving.
(5) Lock calibration function
After the calibration is saved, click again to lock the function to prevent misoperation. these
controls will return to normal functionality after being locked.
FIRMWARE UPGRADE
Click System Settings and select Firmware, as shown in Figure 11. Click to get the latest
firmware. When there is a new version, the user can click on the control to perform a firmware
update on the Lidar.
Note:During the upgrade process,keep the Lidar power supply normal,communication
stable,network steady.Do not plug or unplug the Lidar serial port.
SOFTWARE UPGRADE
The client software will be version-changed and users can update to the latest version for a better
experience.
Click System Settings and select Update, as shown below:
FIGURE 13 SYSTEM UPDATE PAGE