Sensor Features

Sensor Networking

Open in Claude

Use this guide to configure the sensor’s own network behavior. For host machine setup, see Host Networking.

By default, the sensor requests an IPv4 address with DHCP and also supports link-local addressing. Use DHCP or link-local addressing unless your network requires a fixed sensor address or a default gateway.

Networking Terminology

Gateway A router address on the same subnet as the sensor static IPv4 address. When configured, the sensor uses the gateway as its default route.

Static IPv4 Override A persistent sensor setting that disables dynamic IPv4 configuration and assigns the sensor a fixed IPv4 address with a subnet prefix, such as 192.0.2.123/24.

Multicast TTL The Time To Live value placed on multicast UDP packets. A value of 1 keeps packets on the local network segment. Higher values allow multicast packets to traverse multicast routers, if the network is configured to route them.

T1 Ethernet Speed Override A sensor setting for automotive Ethernet models that forces the link speed to 100 Mbps. The default speed is 1000 Mbps.

Static IPv4 Override

Set a static IPv4 override only when the sensor must use a fixed address. After the override is applied, the sensor resets its network configuration after a short delay and must be reached at the new address.

Note: If the sensor becomes unreachable after setting a static IPv4 override, reconnect using the sensor’s link-local address or delete the override from a host that can still reach the sensor.

Web Interface

  1. Open the sensor web interface.
  2. Go to System Configuration.
  3. In Static IPv4 Network Settings, enter the IPv4 Address with Subnet Mask, such as 192.0.2.123/24.
  4. Optionally enter a Gateway, such as 192.0.2.1.
  5. Select Apply.
  6. Reconnect to the sensor using the new address.

To return the sensor to DHCP/link-local behavior, delete the network override from the same page.

HTTP API

Get the current static IPv4 override:

Command

$curl http://os-991234567890.local/api/v1/system/network/ipv4/override

Response

1null

Set a static IPv4 address without a gateway:

Command

$curl -X PUT http://os-991234567890.local/api/v1/system/network/ipv4/override \
>  -H 'Content-Type: application/json' \
>  --data '{"addr": "192.0.2.123/24"}'

Response

1"192.0.2.123/24"

Set a static IPv4 address with a gateway:

Command

$curl -X PUT http://os-991234567890.local/api/v1/system/network/ipv4/override \
>  -H 'Content-Type: application/json' \
>  --data '{"addr": "192.0.2.123/24", "gateway": "192.0.2.1"}'

Response

1{
2  "addr": "192.0.2.123/24",
3  "gateway": "192.0.2.1"
4}

Delete the static IPv4 override and return to DHCP/link-local behavior:

Command

$curl -X DELETE http://os-991234567890.local/api/v1/system/network/ipv4/override

Response: (no output)

Note: The gateway can only be set with a static IPv4 override and must be reachable from the configured subnet. The sensor rejects invalid override addresses, including link-local, multicast, loopback, network, and broadcast addresses.

UDP Multicast TTL

The udp_multicast_ttl configuration parameter controls the multicast TTL for lidar and IMU UDP packets. The default value is 1. Valid values are integers from 1 to 255.

Only change this value when sending lidar or IMU UDP data to a multicast destination that must cross multicast routers. Set it with the POST /api/v1/sensor/config endpoint.

Command

$curl -X POST http://os-991234567890.local/api/v1/sensor/config \
>  -H 'Content-Type: application/json' \
>  --data '{"udp_multicast_ttl": 2}'

Response: (no output)

Note: The udp_multicast_ttl setting affects lidar and IMU UDP packets. Zone Monitor multicast TTL is configured separately with udp_multicast_ttl_zm.

T1 Ethernet Speed Override

The speed_override endpoint is only valid for sensors with automotive Ethernet (T1). Use it only when the link partner is configured to match the selected speed. If the link partner does not match, communication with the sensor can be lost.

Set the T1 Ethernet speed override to 100 Mbps:

Command

$curl -X PUT http://os-991234567890.local/api/v1/system/network/speed_override \
>  -H 'Content-Type: application/json' \
>  --data '100'

Response

1100

Reset the T1 Ethernet speed to the default 1000 Mbps with the DELETE /api/v1/system/network/speed_override endpoint:

Command

$curl -X DELETE http://os-991234567890.local/api/v1/system/network/speed_override

Response: (no output)

Note: The speed override is not supported on all platforms. Unsupported sensors return an error for this endpoint.