voyant_ip_client

Your device ships with the default IP address 192.168.20.20/24. But you can easily configure custom IP addresses for Voyant LiDAR devices.

Use voyant_ip_client --help to see all available options.

Usage

Set Custom IP Address 

voyant_ip_client set --ip-address <IP_ADDRESS> --subnet <SUBNET>

Example:

voyant_ip_client set --ip-address 192.168.100.200 --subnet 24

Use voyant_ip_client set --help for detailed options.

Reset to Factory Default 

voyant_ip_client reset

Connect to Non-Default Device

If your device is already on a custom IP and you want to change to another:

voyant_ip_client --url http://192.168.100.200:8080 set --ip-address 10.42.1.200 --subnet 16

IP Address Configuration

Custom Configuration Options:

IP Address: Choose any IP address in the private network ranges:

  • 10.0.0.1 through 10.255.255.254
  • 172.16.0.1 through 172.31.255.254
  • 192.168.0.1 through 192.168.255.254

Subnet Mask: Choose your network size:

  • /16 (e.g., 192.168.42.0/16) - Up to 65,000 devices on network
  • /24 (e.g., 192.168.42.0/24) - Up to 254 devices on network

Requirements:

  • Your PC must be on the same subnet to communicate with the device
  • If you choose 192.168.100.50/24, your PC needs an IP like 192.168.100.100
  • If you choose 10.42.5.200/16, your PC can use any 10.42.x.x address

Examples:

  • Single device setup: 192.168.100.200/24 (PC at 192.168.100.100)
  • Multiple device setup: 192.168.100.201/24, 192.168.100.202/24, etc.
  • Large facility: 10.42.1.200/16 (allows 10.42.x.x addressing across buildings)

Note: Avoid common ranges like 192.168.1.x and 192.168.0.x which may conflict with routers and other equipment.

Expected Output

Successful Operation 

voyant_ip_client reset

Resetting to factory IP address (192.168.20.20/24)...
Status: 200 OK
✅ IP address reset to factory default successfully
⚠️  You must reboot the device for changes to take effect!

Invalid Configuration

You may see an Error for various reasaons. For example, if you provide an invalid IP address or subnet:

voyant_ip_client set --ip-address 8.8.8.8 --subnet 24

You may see:

❌ Error: invalid value '8.8.8.8' for '--ip-address <IP_ADDRESS>': IP address must be in private ranges (10.x.x.x, 172.16-31.x.x, or 192.168.x.x)

Connection Failure

If the device cannot be reached:

Resetting to factory IP address (192.168.20.20/24)...
Error: reqwest::Error { kind: Request, url: Url { scheme: "http", ... }, source: hyper::Error(Connect, ConnectError("tcp connect error", Os { code: 113, kind: HostUnreachable, message: "No route to host" })) }

Troubleshooting:

  • Verify the device is powered on and connected to your network
  • Check that your PC is on the same subnet as the device
  • If using a custom URL, ensure the IP address and port are correct
  • Ensure IP addresses are in private ranges and subnets are 16 or 24

Important

⚠️ You must reboot the device for changes to take effect!

Copyright © Voyant Photonics, Inc.