How slamtec/rplidar_ros works
This ROS package exposes RPLIDAR through a ROS node, with a separate console client for viewing scans. The principal flow is sensor communication through the SDK, scan decoding, then ROS-facing scan output for tools such as RViz. The SDK also provides command/protocol definitions, channel abstractions, asynchronous transport, and multiple sample decoders. README documents supported model launch variants and the two viewing workflows; source excerpts and the index show SDK composition, but not the ROS topic wiring or the client’s implementation details.
Main entry points: dataunpacker.cpp Sample unpacker · node.cpp ROS node · sl_lidar_driver.h Driver API · sl_lidar_driver.cpp Driver implementation
Components 15
ROS integration
- ROS node
src/node.cpp - RViz scan view
- Console client
src/client.cpp
LIDAR SDK
- Driver API
sdk/include/sl_lidar_driver.h - Driver implementation
sdk/src/sl_lidar_driver.cpp - Commands and protocol
sdk/include/sl_lidar_cmd.h - Channel interfaces
sdk/include/sl_lidar_driver.h - Async transceiver
sdk/src/sl_async_transceiver.cpp - Platform transports
sdk/src/arch - Scan data structures
sdk/include/sl_lidar_protocol.h
Scan decoding
- Sample unpacker
sdk/src/dataunpacker/dataunpacker.cpp - Capsule decoders
sdk/src/dataunpacker/unpacker/handler_capsules.cpp - HQ node decoder
sdk/src/dataunpacker/unpacker/handler_hqnode.cpp - Normal node decoder
sdk/src/dataunpacker/unpacker/handler_normalnode.cpp
Other components
- Operator
Connections 18
- Operator → ROS node: launches
- ROS node → Driver API: uses
src/node.cpp - Driver implementation → Sample unpacker: feeds samples
sdk/src/sl_lidar_driver.cpp - Driver implementation → Async transceiver: uses
sdk/src/sl_lidar_driver.cpp - Driver implementation → Driver API: implements
sdk/src/sl_lidar_driver.cpp - Driver API → Channel interfaces: defines channels
sdk/include/sl_lidar_driver.h - Sample unpacker → Capsule decoders: dispatches
sdk/src/dataunpacker/dataunpacker.cpp - Sample unpacker → HQ node decoder: dispatches
sdk/src/dataunpacker/dataunpacker.cpp - Sample unpacker → Normal node decoder: dispatches
sdk/src/dataunpacker/dataunpacker.cpp - Capsule decoders → Scan data structures: decodes
sdk/src/dataunpacker/unpacker/handler_capsules.cpp - HQ node decoder → Scan data structures: decodes
sdk/src/dataunpacker/unpacker/handler_hqnode.cpp - Driver API → Commands and protocol: uses commands
sdk/include/sl_lidar_driver.h - Operator → RViz scan view: views scans
- Operator → Console client: runs
- ROS node → RViz scan view: publishes scan for
- Console client → ROS node: connects to
- Channel interfaces → Platform transports: implemented by
- Async transceiver → Channel interfaces: transfers data
sdk/src/sl_async_transceiver.cpp