Sensor Kit combines external sensor drivers with wheelos_core, which provides the Cyber middleware, component loader, recorder, and monitor. Driver and middleware sources are imported with VCS; Bazel builds the selected tools and drivers.
This quick start builds and runs the Vanjee LiDAR example. It assumes a Linux host, a connected Vanjee LiDAR, and network access to the device.
Install Git, curl, a C++ toolchain, Ninja, vcstool, and
Bazelisk. The repository
selects Bazel 8.8.1 through .bazelversion.
git clone https://github.com/wheelos/sensor-kit.git
cd sensor-kit
sudo apt update
sudo apt install git curl build-essential ninja-build python3-vcstool
vcs import pkgs < deps.reposdeps.repos tracks the latest main branch of each external source
repository. pkgs/ is managed by VCS and ignored by this repository's Git
tracking. Third-party Bazel modules are fetched from the registries configured
in .bazelrc.registry.
bazel build --jobs=4 --config=dev //:vanjeelidar //:core_toolsThe dev profile in .bazelrc.dev maps Bazel modules to the VCS checkouts in
pkgs/. The build does not start the sensor.
The example at
deployment/examples/vanjee/conf/vanjee.pb.txt
uses model vanjee_720_16, host address 192.168.10.3, and LiDAR address
192.168.10.6. Confirm or edit these values for your device and host before
starting it.
In Terminal 1, from the repository directory:
source scripts/env.sh
cyber_launch start "$APOLLO_ROOT_DIR/deployment/examples/vanjee/launch/vanjee.launch"This uses Core's unified launch entry point. Press Ctrl+C to stop the launch.
In Terminal 2, from the repository directory:
source scripts/env.sh
cyber_monitorLook for:
/apollo/sensor/vanjeelidar/up/PointCloud2/apollo/sensor/vanjeelidar/up/Imu
cyber_monitor is interactive and requires a terminal. Stop the launch with
Ctrl+C in Terminal 1 when finished.
In Terminal 3, from the repository directory:
source scripts/env.sh
mkdir -p "$HOME/data"
record_dir="$(mktemp -d "$HOME/data/vanjee.XXXXXX")"
record_base="$record_dir/vanjee.record"
cyber_recorder record \
-c /apollo/sensor/vanjeelidar/up/PointCloud2 \
-c /apollo/sensor/vanjeelidar/up/Imu \
-o "$record_base"Press Ctrl+C to finalize the recording, then inspect the first record segment in the same terminal:
cyber_recorder info "${record_base}.00000"Core writes numbered record files such as vanjee.record.00000. The unique
directory created by mktemp avoids overwriting existing recordings.
- Build and development workflow
- Vanjee configuration, startup, and recording details
- Architecture and path resolution
The supported workflow currently uses source checkouts and Core tools. The installed runtime workflow is not yet available.