Connecting to sources…

How to build Viam Rover (open-design learning rover: Viam Rover 2 / Rover 1): the whole process

70 steps to build Viam Rover (open-design learning rover: Viam Rover 2 / Rover 1), from buying parts, printing and assembly to software, calibration and training, with t…

No longer sold and no price on the official pages; the BOM lists parts and replacement links but no prices or total. A self-build also needs outsourced laser-cut plates, custom standoffs and springs and two circuit boards, plus a Raspberry Pi 4 (or another supported board), four 18650 cells or an RC battery with a charger, and a microSD card

Buy parts

  • Purchase a Raspberry Pi 4

    Purchase a Raspberry Pi 4 separately. The Viam Rover 2 is primarily designed for use with a Raspberry Pi 4.

  • Purchase batteries and a charger

    Purchase four 18650 batteries, or an RC-type battery no greater than 142mm x 47mm x 60mm (LxWxH), with a charger.

  • Purchase a MicroSD card and reader

    Purchase a MicroSD card and an adapter or reader separately.

  • Buy extra parts for an alternative board

    If using Jetson Nano, Orin Nano, Rock Pi S, Raspberry Pi Zero 2W, Raspberry Pi 5, or Orange Pi Zero 2, purchase additional parts; these boards do not work out of the box with the Viam Rover 2.

  • Purchase a separate battery charger

    With either battery option, you must purchase a charger separately.

  • Select four 18650 batteries

    Select four 18650 lithium-ion rechargeable batteries for the Viam Rover 2; button-top type is recommended, though flat-top type also works.

  • Select a larger RC-type battery

    Select a larger-capacity RC-type lithium-ion rechargeable battery and always comply with battery safety requirements.

  • Select a compatible RC battery

    Select an RC-type battery no larger than 142mm x 47mm x 60mm (LxWxH); a 4S RC-type battery (14.8V) is recommended. Only users comfortable handling electrical assemblies should perform the rewiring, as improper power-supply configuration may damage the battery and pose a fire hazard.

  • Purchase the Required Hardware Separately

    If you have your own Viam Rover, purchase a Raspberry Pi 4, four 18650 batteries or an RC-type battery with charger, and a MicroSD card with an adapter or reader separately.

Print and make

  • Print the RPlidar A1 Adapter Plate

    If your RPlidar A1 needs a mount plate, 3D print the adapter plate using the provided STL file.

Assemble

  • Use the included L298N motor driver

    Use the included L298N dual H-Bridge DC motor driver to control the rotation direction and speed of the DC motors.

  • Mount the 720p webcam with microphone

    Mount the kit's standard USB webcam in the rover's custom camera mount; it is a 720p webcam with an integrated microphone.

  • Use the Viam Rover 2 motherboard

    Use the Viam Rover 2 motherboard, which carries the buck converter, motor driver, IMU, and INA219. Its auxiliary Raspberry Pi 4 pinout accepts dupont connectors and provides an auxiliary power input terminal plus 5V, 3.3V, and ground pins.

  • Connect the INA219 to the Raspberry Pi

    Connect the INA219 to the Raspberry Pi 4 through the I2C bus.

  • Connect the 5V buck converter

    Use the OKY3502-4 buck converter; its USB output can provide an additional 5V supply to auxiliary components.

  • Connect the rover power switch

    Connect the slide switch to the rover and use it to turn power on and off.

  • Install the low-voltage cutoff circuit

    Mount the low-voltage cutoff circuit above the switch and set its threshold for turning off rover power when input voltage drops below the threshold.

  • Install the 18650 battery pack

    Install the recommended four-18650 battery pack in the rover and comply with battery safety requirements.

  • Mount and wire the RC battery

    Mount the RC-type battery at the rear of the rover and wire the appropriate connector into the switch circuit.

  • Insert the SD card into the Raspberry Pi

    After Raspberry Pi OS and viam-server are installed, put the SD card into the slot on the Raspberry Pi.

  • Choose the rover power supply

    Use either 18650 batteries or RC-type batteries to power the rover. 18650 batteries are the nominal recommended power supply, while RC-type batteries have higher capacity.

  • Install four 18650 batteries

    Turn the rover over and place four 18650 batteries in the battery housing with the correct polarity, ensuring they contact the terminals; shorter batteries may need to be pushed along. The rover arrives with the 18650 battery pack wired into the power input terminal block.

  • Empty the 18650 battery holder

    Ensure that the 18650 battery holder contains no batteries.

  • Disconnect the 18650 battery leads

    Unscrew the 18650 battery leads from the power input terminal.

  • Move the existing wires aside

    Move the disconnected wires out of the way.

  • Install a matching power lead

    Screw in a power lead that matches the selected battery. Common options include EC-type connectors, XT-connectors, or T-plugs, and the lead must be long enough to reach the battery.

  • Check the power polarity

    Ensure that the polarity is correct according to the polarity marked on the PCB. Failure to do so may permanently damage the Viam Rover 2 when powered on.

  • Check for a terminal short

    Ensure that there is no short between the terminals, such as from a stray strand of wire, and use a multimeter to check continuity across the terminal. Failure to check may damage the battery and pose a fire hazard.

  • Install the RC battery

    Place the battery in the receptacle between the two caster wheels.

  • Connect the battery power

    Connect the battery to the lead wired into the power input terminal. Optionally secure it with a velcro strap through the bottom-plate slots.

  • Open the rover housing

    Use the biggest Allen key to unscrew the top of the rover so the Raspberry Pi can be attached.

  • Mount the Raspberry Pi 4

    Use the smallest Allen key and the provided M2.5 screws to secure the Raspberry Pi through the motherboard standoffs. From above, the Raspberry Pi 4's USB ports should face right.

  • Connect the ribbon cable

    The ribbon cable comes connected to the motherboard. Wrap it over the Raspberry Pi 4 and connect it to the GPIO pins.

  • Connect the webcam

    Connect the webcam's USB lead to any USB port on the Pi.

  • Select the board mounting pattern

    Use the appropriate alternative hole pattern provided on the motherboard for the single-board computer being used.

  • Reposition the standoffs

    Detach the motherboard, unscrew the standoffs, and move them to the correct holes.

  • Attach the alternative board

    Use the smallest Allen key and the provided M2.5 screws to attach the board to the rover through the repositioned standoffs.

  • Connect the Pi Zero 2W ribbon

    With a Raspberry Pi Zero 2W, connect the ribbon cable directly to the board.

  • Mount the Raspberry Pi 5

    Use the same screw placements as for the Raspberry Pi 4. The hardware setup is the same, but the configuration differs.

  • Connect the board USB webcam

    Connect the webcam's USB lead to any USB port on the board.

  • Secure the top plate and power on

    Use the biggest Allen key to screw the top plate back on, then use the power switch to turn on the rover.

  • Wait for the power relay

    Wait one second for the low voltage cutoff relay to trip and provide power to the rover motherboard.

  • Mount and Orient the RPlidar

    Mount the RPlidar on the Rover facing forward in the direction of travel and in the same direction as the included webcam.

Software

  • Apply the Viam Rover 2 fragment

    Add the ViamRover2-2024-rpi4-a fragment to the Raspberry Pi 4’s JSON configuration. It adds the local board, right and left motors, two encoders, a wheeled base, webcam camera, accelerometer, and power sensor; the base has 356 mm between wheel centers, 381 mm wheel circumference, and a spin slip factor of 1.

  • Apply the Viam Rover 1 fragment

    Add the ViamRover202210b fragment to the Raspberry Pi 4’s JSON configuration. It adds the local board with an I²C bus, right and left motors, two encoders, a wheeled base, webcam camera, and accelerometer; the base has 260 mm between wheel centers, 217 mm wheel circumference, and a spin slip factor of 1.

  • Add the Viam Rover 2 fragment

    Add the `ViamRover2-2024-jetson-nano-a` fragment to the Jetson Nano’s JSON configuration. The fragment configures the board, motors, encoders, base, camera, accelerometer, and power sensor.

  • Configure the Jetson board component

    Configure a board component named `local` to represent the Jetson Nano.

  • Configure the two motors

    Configure two GPIO motor components named `right` and `left`. Their configured pin numbers correspond to where the motor drivers are connected to the board.

  • Configure both motor encoders

    Configure two single encoders, with one encoder for each motor.

  • Configure the wheeled base

    Configure a wheeled base that coordinates the right and left motors. Set the width between wheel centers to 356 mm, wheel circumference to 381 mm, and spin slip factor to 1.

  • Configure the webcam camera

    Configure a webcam camera component.

  • Configure the accelerometer

    Configure the accelerometer component using the TDK InvenSense module.

  • Configure the power sensor

    Configure the power sensor component using the Texas Instruments module.

Calibrate and test

  • Avoid connecting two power supplies

    Do not connect both power supplies at the same time; these are alternative configurations. Connecting multiple batteries may damage the batteries and rover and can pose a fire hazard.

  • Check the circuit voltage

    Turn on the circuit using the switch. Depending on battery charge status, the LED indicator should show a current voltage level of 14.8–16V.

  • Set the low-voltage cutoff

    Hold the left button until the LED flashes with the low cutoff value. Use the left (+) and right (-) buttons to set 14.7V, or another desired cutoff for a battery with a different nominal voltage.

  • Confirm the cutoff value

    Wait for the LED indicator to stop flashing so the low-voltage cutoff setting is completed.

  • Set the reconnect voltage

    Hold the right button until the LED flashes with the reconnect voltage value. Use the left (+) and right (-) buttons to set 0.2V, then wait for the indicator to stop flashing.

  • Verify cutoff and reconnection

    When voltage drops below 14.8V or reaches the chosen cutoff, the relay disconnects the motherboard. Reconnecting power after charging requires a minimum of 14.9V.

  • Check the Raspberry Pi lights

    Check whether the lights on the Raspberry Pi are on to confirm that the Pi has power.

  • Review the fragment configuration

    Open the fragment in the Viam app to review its configured pin numbers and other values.

  • Add the Viam Rover 2 fragment

    Add the `ViamRover2-2024-nano-orin-a` fragment. It configures the `local` Jetson board, `right` and `left` motors, two encoders, a wheeled base, a webcam camera, an accelerometer, and a power sensor.

  • View the fragment components

    Open the machine’s **CONFIGURE** tab to see cards for all components and services included in the fragment, together with a card for the fragment itself. The wheeled base uses 356 mm between wheel centers, a 381 mm wheel circumference, and a spin slip factor of 1.

  • Override specific fragment settings

    Overwrite sections of the added fragment to modify the rover's configuration.

Data and training

  • Program the rover to move in a square

    Follow the drive-rover tutorial and use a Viam SDK to program the rover to move in a square.

Use it

  • Apply the Viam-provided configuration

    Configure the rover by adding the Viam-provided configuration fragment to it.

  • Mount additional rover components

    Use the aluminum chassis and expandable mounting features to mount additional sensors, LiDAR, robot arms, or other components.

  • Add supported GPS navigation

    GPS navigation supports NMEA using serial and I²C, as well as RTK; the make and model do not matter.

  • Choose an LiDAR scanner

    For LiDAR laser range scanning, the document recommends RPlidar, including the A1.

  • Drive the rover in a square

    Follow the “Drive your rover” tutorial and use a Viam SDK to program the rover to move in a square.

Parts

  • Laser-cut top, bottom, battery and caster-battery plates (from drawings), custom M4 standoffs and low-rate suspension springs
  • Left and right drive units (iSweep X3 robot-vacuum wheel units with encoders) and two casters
  • PCB1 and PCB2 (Gerber data) with their terminals, switch, headers and wires
  • An L298N motor driver, OKY3502‑4 5V buck converter, MPU6050 IMU, INA219 and XH‑M609 low-voltage protector
  • A 720p USB webcam (WB100) with a 3D-printed mount; a 4×18650 battery holder; 40-pin and 6-pin ribbon cables
  • M2.5, M3 and M4 screws, nuts and standoffs; 1.5, 2 and 2.5 mm hex keys

Tools

  • Hex keys (1.5, 2 and 2.5 mm, included in the original box)
  • For a self-build: outsourced laser cutting and board fabrication, and a 3D printer (camera mount)
  • For setup: a computer and a microSD reader

Skills

  • Installing 64-bit Raspberry Pi OS, enabling I²C with raspi-config and installing viam-server
  • Wiring the battery and ribbon cable, and inserting the configuration fragment in the Viam app
  • Programming with a Viam SDK (Python, Go, TypeScript and others); a self-build also means assembling from the CAD and BOM and populating the two boards

Software

  • viam-server (RDK, AGPL‑3.0), running on the Raspberry Pi or a Jetson
  • The Viam web app and Viam's configuration fragments (ViamRover2‑2024‑rpi5 and others)
  • Python, Go, TypeScript, C++ and Flutter SDKs with the “drive a rover” tutorial

Documents