HTTP API Reference Guide
This reference guide documents the interface for HTTP API and is accessible via /api/v1
on the sensor hosted HTTP server.
The sensor can be queried and configured using an HTTP GET requests. This can be done using several different tools such as httpie, curl, Advanced REST Client, etc.
Here is an example using curl command:
$ curl --request GET --url http://169.254.198.184/api/v1/sensor/metadata/lidar_intrinsics
{
"lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]
}
Sensor Metadata
GET /api/v1/sensor/metadata/sensor_info
-
GET
169.254.198.184/api/v1/sensor/metadata/sensor_info
Get the sensor information
http
GET /api/v1/sensor/metadata/sensor_info HTTP/1.1 Host: 169.254.198.184 HTTP/1.1 200 OK content-length: 321 content-type: application/json { "base_pn": "", "base_sn": "", "build_date": "2022-03-31T23:38:32Z", "build_rev": "v2.3.0-rc.2", "image_rev": "ousteros-image-prod-aries-v2.3.0-rc.2+20220401070201.staging", "initialization_id": 5431288, "prod_line": "OS-1-128", "prod_pn": "840-103575-06", "prod_sn": "992139000666", "proto_rev": "", "status": "RUNNING" }
curl
curl -i http://169.254.198.184/api/v1/sensor/metadata/sensor_info --data-raw 'HTTP/1.1 200 OK content-length: 321 content-type: application/json { "base_pn": "", "base_sn": "", "build_date": "2022-03-31T23:38:32Z", "build_rev": "v2.3.0-rc.2", "image_rev": "ousteros-image-prod-aries-v2.3.0-rc.2+20220401070201.staging", "initialization_id": 5431288, "prod_line": "OS-1-128", "prod_pn": "840-103575-06", "prod_sn": "992139000666", "proto_rev": "", "status": "RUNNING" }'
httpie
echo 'HTTP/1.1 200 OK content-length: 321 content-type: application/json { "base_pn": "", "base_sn": "", "build_date": "2022-03-31T23:38:32Z", "build_rev": "v2.3.0-rc.2", "image_rev": "ousteros-image-prod-aries-v2.3.0-rc.2+20220401070201.staging", "initialization_id": 5431288, "prod_line": "OS-1-128", "prod_pn": "840-103575-06", "prod_sn": "992139000666", "proto_rev": "", "status": "RUNNING" }' | http http://169.254.198.184/api/v1/sensor/metadata/sensor_info
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/metadata/sensor_info', data='HTTP/1.1 200 OK\r\n\ncontent-length: 321\r\n\ncontent-type: application/json\r\n\n\r\n\n {\r\n\n "base_pn": "",\r\n\n "base_sn": "",\r\n\n "build_date": "2022-03-31T23:38:32Z",\r\n\n "build_rev": "v2.3.0-rc.2",\r\n\n "image_rev": "ousteros-image-prod-aries-v2.3.0-rc.2+20220401070201.staging",\r\n\n "initialization_id": 5431288,\r\n\n "prod_line": "OS-1-128",\r\n\n "prod_pn": "840-103575-06",\r\n\n "prod_sn": "992139000666",\r\n\n "proto_rev": "",\r\n\n "status": "RUNNING"\r\n\n }')
- statuscode 200
No error
- Description
Returns JSON-formatted response that includes serial number, product number, FW image revision and sensor status along with other parameters as shown is provided.
GET /api/v1/sensor/metadata/lidar_data_format
-
GET
169.254.198.184/api/v1/sensor/metadata/lidar_data_format
Get the sensor lidar data format
http
GET /api/v1/sensor/metadata/lidar_data_format HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-type: application/json
content-length: 661
{
"column_window": [256, 768],
"pixel_shift_by_row": [24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0],
"columns_per_packet": 16,
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL"
"udp_profile_imu": "LEGACY",
"pixels_per_column": 128,
"columns_per_frame": 1024,
}
curl
curl -i http://169.254.198.184/api/v1/sensor/metadata/lidar_data_format --data-raw 'HTTP/1.1 200 OK
content-type: application/json
content-length: 661
{
"column_window": [256, 768],
"pixel_shift_by_row": [24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0],
"columns_per_packet": 16,
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL"
"udp_profile_imu": "LEGACY",
"pixels_per_column": 128,
"columns_per_frame": 1024,
}'
httpie
echo 'HTTP/1.1 200 OK
content-type: application/json
content-length: 661
{
"column_window": [256, 768],
"pixel_shift_by_row": [24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0],
"columns_per_packet": 16,
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL"
"udp_profile_imu": "LEGACY",
"pixels_per_column": 128,
"columns_per_frame": 1024,
}' | http http://169.254.198.184/api/v1/sensor/metadata/lidar_data_format
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/metadata/lidar_data_format', data='HTTP/1.1 200 OK\r\n\ncontent-type: application/json\r\n\ncontent-length: 661\r\n\n\r\n\n {\r\n\n "column_window": [256, 768],\r\n\n "pixel_shift_by_row": [24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0],\r\n\n "columns_per_packet": 16,\r\n\n "udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL"\r\n\n "udp_profile_imu": "LEGACY",\r\n\n "pixels_per_column": 128,\r\n\n "columns_per_frame": 1024,\r\n\n }')
- statuscode 200
No error
- Description
Returns JSON-formatted response that describes the structure of a lidar packet.
columns_per_frame
: Number of measurement columns per frame. This can be 512, 1024, or 2048, depending upon the set lidar mode.columns_per_packet
: Number of measurement blocks contained in a single lidar packet. Currently in v2.2.0 and earlier, this is 16. Note: This is not user configurable.pixel_shift_by_row
: Offset in terms of pixel count. Can be used to destagger image. Varies by lidar mode. Length of this array is equal to the number of channels of the sensor.pixels_per_column
: Number of channels of the sensor.column_window
: Index of measurement blocks that are active. Default is [0, lidar_mode-1], e.g. [0,1023]. If there is an azimuth window set, this parameter will reflect which measurement blocks of data are within the region of interest.udp_profile_lidar
: Lidar data profile format. Default LEGACY.udp_profile_lidar
: Lidar data profile format. Default LEGACY.udp_profile_imu
: IMU data profile format. Default LEGACY.NOTE: This command only works when the sensor is in RUNNING status.
GET /api/v1/sensor/metadata/beam_intrinsics
-
GET
169.254.198.184/api/v1/sensor/metadata/beam_intrinsics
Get the sensor beam intrinsics
http
GET /api/v1/sensor/metadata/beam_intrinsics HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-type: application/json
content-length: 4506
{
"beam_azimuth_angles": [4.2300000000000004, 1.4099999999999999, -1.3999999999999999, -4.21,
4.2199999999999998, 1.4199999999999999, -1.4099999999999999, -4.2199999999999998, 4.2300000000000004,
1.4099999999999999, -1.4199999999999999, -4.21, 4.2300000000000004, 1.4199999999999999,
-1.3999999999999999, -4.2000000000000002, 4.2300000000000004, 1.4099999999999999, -1.3899999999999999,
-4.21, 4.25, 1.4299999999999999, -1.4099999999999999, -4.2199999999999998, 4.2400000000000002,
1.4399999999999999, -1.4099999999999999, -4.2199999999999998, 4.2300000000000004, 1.4199999999999999,
-1.3799999999999999, -4.2199999999999998, 4.2400000000000002, 1.4199999999999999, -1.3999999999999999,
-4.2300000000000004, 4.2599999999999998, 1.4399999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4399999999999999, -1.4099999999999999, -4.2300000000000004, 4.2400000000000002,
1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999,
-1.3899999999999999, -4.2199999999999998, 4.25, 1.4099999999999999, -1.3999999999999999,
-4.2300000000000004, 4.2400000000000002, 1.4299999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4199999999999999, -1.4099999999999999, -4.2300000000000004, 4.25,
1.4199999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002, 1.4399999999999999,
-1.3999999999999999, -4.2400000000000002, 4.2400000000000002, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4299999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4199999999999999, -4.2199999999999998, 4.2400000000000002, 1.4299999999999999,
-1.3999999999999999, -4.2400000000000002, 4.25, 1.4399999999999999, -1.4099999999999999,
-4.2400000000000002, 4.25, 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4099999999999999, -4.25, 4.2599999999999998, 1.4299999999999999,
-1.4099999999999999, -4.2599999999999998, 4.2699999999999996, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4299999999999999, -1.3999999999999999, -4.2400000000000002,
4.2599999999999998, 1.4199999999999999, -1.3999999999999999, -4.25, 4.2599999999999998,
1.4299999999999999, -1.4099999999999999, -4.2599999999999998, 4.2599999999999998, 1.4199999999999999,
-1.4199999999999999, -4.2599999999999998, 4.25, 1.4199999999999999, -1.4199999999999999,
-4.2699999999999996],
"beam_altitude_angles": [21.010000000000002, 20.719999999999999,
20.420000000000002, 20.100000000000001, 19.789999999999999, 19.48, 19.170000000000002, 18.84,
18.550000000000001, 18.219999999999999, 17.899999999999999, 17.600000000000001, 17.27,
16.960000000000001, 16.649999999999999, 16.32, 15.970000000000001, 15.65, 15.34, 15.01, 14.67, 14.35,
14.01, 13.68, 13.33, 13.02, 12.67, 12.34, 11.99, 11.65, 11.33, 10.98, 10.640000000000001,
10.279999999999999, 9.9499999999999993, 9.6099999999999994, 9.2699999999999996, 8.9199999999999999,
8.5700000000000003, 8.2300000000000004, 7.8799999999999999, 7.54, 7.1799999999999997,
6.8399999999999999, 6.4699999999999998, 6.1299999999999999, 5.7800000000000002, 5.4500000000000002,
5.0899999999999999, 4.7300000000000004, 4.4100000000000001, 4.0499999999999998, 3.6899999999999999,
3.3199999999999998, 2.98, 2.6299999999999999, 2.27, 1.9299999999999999, 1.5700000000000001, 1.22,
0.84999999999999998, 0.5, 0.14999999999999999, -0.19, -0.55000000000000004, -0.92000000000000004,
-1.25, -1.6299999999999999, -1.98,-2.3100000000000001, -2.6699999999999999, -3.04,
-3.3999999999999999, -3.7400000000000002, -4.0899999999999999, -4.4500000000000002,
-4.7999999999999998, -5.1500000000000004, -5.5, -5.8700000000000001, -6.21, -6.5700000000000003,
-6.9100000000000001, -7.25, -7.6200000000000001, -7.9500000000000002, -8.3000000000000007,
-8.6500000000000004, -9.0099999999999998, -9.3499999999999996, -9.6899999999999995,
-10.050000000000001, -10.390000000000001, -10.74, -11.09, -11.42, -11.77, -12.109999999999999,
-12.449999999999999, -12.800000000000001, -13.140000000000001, -13.470000000000001,
-13.81, -14.15, -14.48, -14.82, -15.130000000000001, -15.470000000000001, -15.81,
-16.149999999999999, -16.48, -16.800000000000001, -17.149999999999999, -17.48, -17.789999999999999,
-18.120000000000001, -18.469999999999999, -18.77, -19.09, -19.420000000000002, -19.73,
-20.059999999999999, -20.359999999999999, -20.690000000000001, -21, -21.32, -21.620000000000001,
-21.940000000000001],
"lidar_origin_to_beam_origin_mm": 15.805999999999999
}
curl
curl -i http://169.254.198.184/api/v1/sensor/metadata/beam_intrinsics --data-raw 'HTTP/1.1 200 OK
content-type: application/json
content-length: 4506
{
"beam_azimuth_angles": [4.2300000000000004, 1.4099999999999999, -1.3999999999999999, -4.21,
4.2199999999999998, 1.4199999999999999, -1.4099999999999999, -4.2199999999999998, 4.2300000000000004,
1.4099999999999999, -1.4199999999999999, -4.21, 4.2300000000000004, 1.4199999999999999,
-1.3999999999999999, -4.2000000000000002, 4.2300000000000004, 1.4099999999999999, -1.3899999999999999,
-4.21, 4.25, 1.4299999999999999, -1.4099999999999999, -4.2199999999999998, 4.2400000000000002,
1.4399999999999999, -1.4099999999999999, -4.2199999999999998, 4.2300000000000004, 1.4199999999999999,
-1.3799999999999999, -4.2199999999999998, 4.2400000000000002, 1.4199999999999999, -1.3999999999999999,
-4.2300000000000004, 4.2599999999999998, 1.4399999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4399999999999999, -1.4099999999999999, -4.2300000000000004, 4.2400000000000002,
1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999,
-1.3899999999999999, -4.2199999999999998, 4.25, 1.4099999999999999, -1.3999999999999999,
-4.2300000000000004, 4.2400000000000002, 1.4299999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4199999999999999, -1.4099999999999999, -4.2300000000000004, 4.25,
1.4199999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002, 1.4399999999999999,
-1.3999999999999999, -4.2400000000000002, 4.2400000000000002, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4299999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4199999999999999, -4.2199999999999998, 4.2400000000000002, 1.4299999999999999,
-1.3999999999999999, -4.2400000000000002, 4.25, 1.4399999999999999, -1.4099999999999999,
-4.2400000000000002, 4.25, 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4099999999999999, -4.25, 4.2599999999999998, 1.4299999999999999,
-1.4099999999999999, -4.2599999999999998, 4.2699999999999996, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4299999999999999, -1.3999999999999999, -4.2400000000000002,
4.2599999999999998, 1.4199999999999999, -1.3999999999999999, -4.25, 4.2599999999999998,
1.4299999999999999, -1.4099999999999999, -4.2599999999999998, 4.2599999999999998, 1.4199999999999999,
-1.4199999999999999, -4.2599999999999998, 4.25, 1.4199999999999999, -1.4199999999999999,
-4.2699999999999996],
"beam_altitude_angles": [21.010000000000002, 20.719999999999999,
20.420000000000002, 20.100000000000001, 19.789999999999999, 19.48, 19.170000000000002, 18.84,
18.550000000000001, 18.219999999999999, 17.899999999999999, 17.600000000000001, 17.27,
16.960000000000001, 16.649999999999999, 16.32, 15.970000000000001, 15.65, 15.34, 15.01, 14.67, 14.35,
14.01, 13.68, 13.33, 13.02, 12.67, 12.34, 11.99, 11.65, 11.33, 10.98, 10.640000000000001,
10.279999999999999, 9.9499999999999993, 9.6099999999999994, 9.2699999999999996, 8.9199999999999999,
8.5700000000000003, 8.2300000000000004, 7.8799999999999999, 7.54, 7.1799999999999997,
6.8399999999999999, 6.4699999999999998, 6.1299999999999999, 5.7800000000000002, 5.4500000000000002,
5.0899999999999999, 4.7300000000000004, 4.4100000000000001, 4.0499999999999998, 3.6899999999999999,
3.3199999999999998, 2.98, 2.6299999999999999, 2.27, 1.9299999999999999, 1.5700000000000001, 1.22,
0.84999999999999998, 0.5, 0.14999999999999999, -0.19, -0.55000000000000004, -0.92000000000000004,
-1.25, -1.6299999999999999, -1.98,-2.3100000000000001, -2.6699999999999999, -3.04,
-3.3999999999999999, -3.7400000000000002, -4.0899999999999999, -4.4500000000000002,
-4.7999999999999998, -5.1500000000000004, -5.5, -5.8700000000000001, -6.21, -6.5700000000000003,
-6.9100000000000001, -7.25, -7.6200000000000001, -7.9500000000000002, -8.3000000000000007,
-8.6500000000000004, -9.0099999999999998, -9.3499999999999996, -9.6899999999999995,
-10.050000000000001, -10.390000000000001, -10.74, -11.09, -11.42, -11.77, -12.109999999999999,
-12.449999999999999, -12.800000000000001, -13.140000000000001, -13.470000000000001,
-13.81, -14.15, -14.48, -14.82, -15.130000000000001, -15.470000000000001, -15.81,
-16.149999999999999, -16.48, -16.800000000000001, -17.149999999999999, -17.48, -17.789999999999999,
-18.120000000000001, -18.469999999999999, -18.77, -19.09, -19.420000000000002, -19.73,
-20.059999999999999, -20.359999999999999, -20.690000000000001, -21, -21.32, -21.620000000000001,
-21.940000000000001],
"lidar_origin_to_beam_origin_mm": 15.805999999999999
}'
httpie
echo 'HTTP/1.1 200 OK
content-type: application/json
content-length: 4506
{
"beam_azimuth_angles": [4.2300000000000004, 1.4099999999999999, -1.3999999999999999, -4.21,
4.2199999999999998, 1.4199999999999999, -1.4099999999999999, -4.2199999999999998, 4.2300000000000004,
1.4099999999999999, -1.4199999999999999, -4.21, 4.2300000000000004, 1.4199999999999999,
-1.3999999999999999, -4.2000000000000002, 4.2300000000000004, 1.4099999999999999, -1.3899999999999999,
-4.21, 4.25, 1.4299999999999999, -1.4099999999999999, -4.2199999999999998, 4.2400000000000002,
1.4399999999999999, -1.4099999999999999, -4.2199999999999998, 4.2300000000000004, 1.4199999999999999,
-1.3799999999999999, -4.2199999999999998, 4.2400000000000002, 1.4199999999999999, -1.3999999999999999,
-4.2300000000000004, 4.2599999999999998, 1.4399999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4399999999999999, -1.4099999999999999, -4.2300000000000004, 4.2400000000000002,
1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999,
-1.3899999999999999, -4.2199999999999998, 4.25, 1.4099999999999999, -1.3999999999999999,
-4.2300000000000004, 4.2400000000000002, 1.4299999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4199999999999999, -1.4099999999999999, -4.2300000000000004, 4.25,
1.4199999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002, 1.4399999999999999,
-1.3999999999999999, -4.2400000000000002, 4.2400000000000002, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4299999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4199999999999999, -4.2199999999999998, 4.2400000000000002, 1.4299999999999999,
-1.3999999999999999, -4.2400000000000002, 4.25, 1.4399999999999999, -1.4099999999999999,
-4.2400000000000002, 4.25, 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4099999999999999, -4.25, 4.2599999999999998, 1.4299999999999999,
-1.4099999999999999, -4.2599999999999998, 4.2699999999999996, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4299999999999999, -1.3999999999999999, -4.2400000000000002,
4.2599999999999998, 1.4199999999999999, -1.3999999999999999, -4.25, 4.2599999999999998,
1.4299999999999999, -1.4099999999999999, -4.2599999999999998, 4.2599999999999998, 1.4199999999999999,
-1.4199999999999999, -4.2599999999999998, 4.25, 1.4199999999999999, -1.4199999999999999,
-4.2699999999999996],
"beam_altitude_angles": [21.010000000000002, 20.719999999999999,
20.420000000000002, 20.100000000000001, 19.789999999999999, 19.48, 19.170000000000002, 18.84,
18.550000000000001, 18.219999999999999, 17.899999999999999, 17.600000000000001, 17.27,
16.960000000000001, 16.649999999999999, 16.32, 15.970000000000001, 15.65, 15.34, 15.01, 14.67, 14.35,
14.01, 13.68, 13.33, 13.02, 12.67, 12.34, 11.99, 11.65, 11.33, 10.98, 10.640000000000001,
10.279999999999999, 9.9499999999999993, 9.6099999999999994, 9.2699999999999996, 8.9199999999999999,
8.5700000000000003, 8.2300000000000004, 7.8799999999999999, 7.54, 7.1799999999999997,
6.8399999999999999, 6.4699999999999998, 6.1299999999999999, 5.7800000000000002, 5.4500000000000002,
5.0899999999999999, 4.7300000000000004, 4.4100000000000001, 4.0499999999999998, 3.6899999999999999,
3.3199999999999998, 2.98, 2.6299999999999999, 2.27, 1.9299999999999999, 1.5700000000000001, 1.22,
0.84999999999999998, 0.5, 0.14999999999999999, -0.19, -0.55000000000000004, -0.92000000000000004,
-1.25, -1.6299999999999999, -1.98,-2.3100000000000001, -2.6699999999999999, -3.04,
-3.3999999999999999, -3.7400000000000002, -4.0899999999999999, -4.4500000000000002,
-4.7999999999999998, -5.1500000000000004, -5.5, -5.8700000000000001, -6.21, -6.5700000000000003,
-6.9100000000000001, -7.25, -7.6200000000000001, -7.9500000000000002, -8.3000000000000007,
-8.6500000000000004, -9.0099999999999998, -9.3499999999999996, -9.6899999999999995,
-10.050000000000001, -10.390000000000001, -10.74, -11.09, -11.42, -11.77, -12.109999999999999,
-12.449999999999999, -12.800000000000001, -13.140000000000001, -13.470000000000001,
-13.81, -14.15, -14.48, -14.82, -15.130000000000001, -15.470000000000001, -15.81,
-16.149999999999999, -16.48, -16.800000000000001, -17.149999999999999, -17.48, -17.789999999999999,
-18.120000000000001, -18.469999999999999, -18.77, -19.09, -19.420000000000002, -19.73,
-20.059999999999999, -20.359999999999999, -20.690000000000001, -21, -21.32, -21.620000000000001,
-21.940000000000001],
"lidar_origin_to_beam_origin_mm": 15.805999999999999
}' | http http://169.254.198.184/api/v1/sensor/metadata/beam_intrinsics
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/metadata/beam_intrinsics', data='HTTP/1.1 200 OK\r\n\ncontent-type: application/json\r\n\ncontent-length: 4506\r\n\n\r\n\n {\r\n\n "beam_azimuth_angles": [4.2300000000000004, 1.4099999999999999, -1.3999999999999999, -4.21,\r\n\n 4.2199999999999998, 1.4199999999999999, -1.4099999999999999, -4.2199999999999998, 4.2300000000000004,\r\n\n 1.4099999999999999, -1.4199999999999999, -4.21, 4.2300000000000004, 1.4199999999999999,\r\n\n -1.3999999999999999, -4.2000000000000002, 4.2300000000000004, 1.4099999999999999, -1.3899999999999999,\r\n\n -4.21, 4.25, 1.4299999999999999, -1.4099999999999999, -4.2199999999999998, 4.2400000000000002,\r\n\n 1.4399999999999999, -1.4099999999999999, -4.2199999999999998, 4.2300000000000004, 1.4199999999999999,\r\n\n -1.3799999999999999, -4.2199999999999998, 4.2400000000000002, 1.4199999999999999, -1.3999999999999999,\r\n\n -4.2300000000000004, 4.2599999999999998, 1.4399999999999999, -1.4099999999999999, -4.2300000000000004,\r\n\n 4.2400000000000002, 1.4399999999999999, -1.4099999999999999, -4.2300000000000004, 4.2400000000000002,\r\n\n 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999,\r\n\n -1.3899999999999999, -4.2199999999999998, 4.25, 1.4099999999999999, -1.3999999999999999,\r\n\n -4.2300000000000004, 4.2400000000000002, 1.4299999999999999, -1.4099999999999999, -4.2300000000000004,\r\n\n 4.2400000000000002, 1.4199999999999999, -1.4099999999999999, -4.2300000000000004, 4.25,\r\n\n 1.4199999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002, 1.4399999999999999,\r\n\n -1.3999999999999999, -4.2400000000000002, 4.2400000000000002, 1.4299999999999999, -1.3999999999999999,\r\n\n -4.2400000000000002, 4.25, 1.4299999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,\r\n\n 1.4199999999999999, -1.4199999999999999, -4.2199999999999998, 4.2400000000000002, 1.4299999999999999,\r\n\n -1.3999999999999999, -4.2400000000000002, 4.25, 1.4399999999999999, -1.4099999999999999,\r\n\n -4.2400000000000002, 4.25, 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,\r\n\n 1.4199999999999999, -1.4099999999999999, -4.25, 4.2599999999999998, 1.4299999999999999,\r\n\n -1.4099999999999999, -4.2599999999999998, 4.2699999999999996, 1.4299999999999999, -1.3999999999999999,\r\n\n -4.2400000000000002, 4.25, 1.4299999999999999, -1.3999999999999999, -4.2400000000000002,\r\n\n 4.2599999999999998, 1.4199999999999999, -1.3999999999999999, -4.25, 4.2599999999999998,\r\n\n 1.4299999999999999, -1.4099999999999999, -4.2599999999999998, 4.2599999999999998, 1.4199999999999999,\r\n\n -1.4199999999999999, -4.2599999999999998, 4.25, 1.4199999999999999, -1.4199999999999999,\r\n\n -4.2699999999999996],\r\n\n "beam_altitude_angles": [21.010000000000002, 20.719999999999999,\r\n\n 20.420000000000002, 20.100000000000001, 19.789999999999999, 19.48, 19.170000000000002, 18.84,\r\n\n 18.550000000000001, 18.219999999999999, 17.899999999999999, 17.600000000000001, 17.27,\r\n\n 16.960000000000001, 16.649999999999999, 16.32, 15.970000000000001, 15.65, 15.34, 15.01, 14.67, 14.35,\r\n\n 14.01, 13.68, 13.33, 13.02, 12.67, 12.34, 11.99, 11.65, 11.33, 10.98, 10.640000000000001,\r\n\n 10.279999999999999, 9.9499999999999993, 9.6099999999999994, 9.2699999999999996, 8.9199999999999999,\r\n\n 8.5700000000000003, 8.2300000000000004, 7.8799999999999999, 7.54, 7.1799999999999997,\r\n\n 6.8399999999999999, 6.4699999999999998, 6.1299999999999999, 5.7800000000000002, 5.4500000000000002,\r\n\n 5.0899999999999999, 4.7300000000000004, 4.4100000000000001, 4.0499999999999998, 3.6899999999999999,\r\n\n 3.3199999999999998, 2.98, 2.6299999999999999, 2.27, 1.9299999999999999, 1.5700000000000001, 1.22,\r\n\n 0.84999999999999998, 0.5, 0.14999999999999999, -0.19, -0.55000000000000004, -0.92000000000000004,\r\n\n -1.25, -1.6299999999999999, -1.98,-2.3100000000000001, -2.6699999999999999, -3.04,\r\n\n -3.3999999999999999, -3.7400000000000002, -4.0899999999999999, -4.4500000000000002,\r\n\n -4.7999999999999998, -5.1500000000000004, -5.5, -5.8700000000000001, -6.21, -6.5700000000000003,\r\n\n -6.9100000000000001, -7.25, -7.6200000000000001, -7.9500000000000002, -8.3000000000000007,\r\n\n -8.6500000000000004, -9.0099999999999998, -9.3499999999999996, -9.6899999999999995,\r\n\n -10.050000000000001, -10.390000000000001, -10.74, -11.09, -11.42, -11.77, -12.109999999999999,\r\n\n -12.449999999999999, -12.800000000000001, -13.140000000000001, -13.470000000000001,\r\n\n -13.81, -14.15, -14.48, -14.82, -15.130000000000001, -15.470000000000001, -15.81,\r\n\n -16.149999999999999, -16.48, -16.800000000000001, -17.149999999999999, -17.48, -17.789999999999999,\r\n\n -18.120000000000001, -18.469999999999999, -18.77, -19.09, -19.420000000000002, -19.73,\r\n\n -20.059999999999999, -20.359999999999999, -20.690000000000001, -21, -21.32, -21.620000000000001,\r\n\n -21.940000000000001],\r\n\n "lidar_origin_to_beam_origin_mm": 15.805999999999999\r\n\n }')
- status code 200
No error
- Description
Returns JSON-formatted beam altitude and azimuth offsets, in degrees. Length of arrays is equal to the number of channels in the sensor. Also returns distance between lidar origin and beam origin in mm, to be used for point cloud calculations.
GET /api/v1/sensor/metadata/imu_intrinsics
-
GET
169.254.198.184/api/v1/sensor/metadata/imu_intrinsics
Get the sensor imu intrinsics
http
GET /api/v1/sensor/metadata/imu_intrinsics HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-type: application/json
content-length: 117
{
"imu_to_sensor_transform": [1, 0, 0, 6.2530000000000001,
0, 1, 0, -11.775, 0, 0, 1, 7.6449999999999996, 0, 0, 0, 1]
}
curl
curl -i http://169.254.198.184/api/v1/sensor/metadata/imu_intrinsics --data-raw 'HTTP/1.1 200 OK
content-type: application/json
content-length: 117
{
"imu_to_sensor_transform": [1, 0, 0, 6.2530000000000001,
0, 1, 0, -11.775, 0, 0, 1, 7.6449999999999996, 0, 0, 0, 1]
}'
httpie
echo 'HTTP/1.1 200 OK
content-type: application/json
content-length: 117
{
"imu_to_sensor_transform": [1, 0, 0, 6.2530000000000001,
0, 1, 0, -11.775, 0, 0, 1, 7.6449999999999996, 0, 0, 0, 1]
}' | http http://169.254.198.184/api/v1/sensor/metadata/imu_intrinsics
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/metadata/imu_intrinsics', data='HTTP/1.1 200 OK\r\n\ncontent-type: application/json\r\n\ncontent-length: 117\r\n\n {\r\n\n "imu_to_sensor_transform": [1, 0, 0, 6.2530000000000001,\r\n\n 0, 1, 0, -11.775, 0, 0, 1, 7.6449999999999996, 0, 0, 0, 1]\r\n\n }')
- status code 200
No error
- Description
Returns JSON-formatted IMU transformation matrix needed to transform to the Sensor Coordinate Frame.
GET /api/v1/sensor/metadata/lidar_intrinsics
-
GET
169.254.198.184/api/v1/sensor/metadata/lidar_intrinsics
Get the sensor lidar intrinsics
http
GET /api/v1/sensor/metadata/lidar_intrinsics HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-type: application/json
content-length: 85
{
"lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]
}
curl
curl -i http://169.254.198.184/api/v1/sensor/metadata/lidar_intrinsics --data-raw 'HTTP/1.1 200 OK
content-type: application/json
content-length: 85
{
"lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]
}'
httpie
echo 'HTTP/1.1 200 OK
content-type: application/json
content-length: 85
{
"lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]
}' | http http://169.254.198.184/api/v1/sensor/metadata/lidar_intrinsics
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/metadata/lidar_intrinsics', data='HTTP/1.1 200 OK\r\n\ncontent-type: application/json\r\n\ncontent-length: 85\r\n\n\r\n\n {\r\n\n "lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]\r\n\n }')
- status code 200
No error
- Description
Returns JSON-formatted lidar transformation matrix needed to transform to the Sensor Coordinate Frame.
GET /api/v1/sensor/metadata/calibration_status
-
GET
169.254.198.184/api/v1/sensor/metadata/calibration_status
Get the sensor calibration status
http
GET /api/v1/sensor/metadata/calibration_status HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-type: application/json
content-length: 69
{
"reflectivity":
{
"timestamp": "2021-10-05T00:02:36",
"valid": true
}
}
curl
curl -i http://169.254.198.184/api/v1/sensor/metadata/calibration_status --data-raw 'HTTP/1.1 200 OK
content-type: application/json
content-length: 69
{
"reflectivity":
{
"timestamp": "2021-10-05T00:02:36",
"valid": true
}
}'
httpie
echo 'HTTP/1.1 200 OK
content-type: application/json
content-length: 69
{
"reflectivity":
{
"timestamp": "2021-10-05T00:02:36",
"valid": true
}
}' | http http://169.254.198.184/api/v1/sensor/metadata/calibration_status
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/metadata/calibration_status', data='HTTP/1.1 200 OK\r\n\ncontent-type: application/json\r\n\ncontent-length: 69\r\n\n\r\n\n {\r\n\n "reflectivity":\r\n\n {\r\n\n "timestamp": "2021-10-05T00:02:36",\r\n\n "valid": true\r\n\n }\r\n\n }')
- status code 200
No error
- Description
Returns JSON formatted calibration status of the sensor reflectivity.
valid
: true/false depending on calibration status.timestamp
: if valid is true; time at which the calibration was completed.
GET /api/v1/sensor/metadata
-
GET
169.254.198.184/api/v1/sensor/metadata
Get the sensor metadata information
http
GET /api/v1/sensor/metadata HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-type: application/json
content-length: 6675
{
"config_params":
{
"signal_multiplier": 1,
"udp_dest": "169.254.175.254",
"multipurpose_io_mode": "OFF",
"udp_port_lidar": 7502,
"nmea_leap_seconds": 0,
"nmea_in_polarity": "ACTIVE_HIGH",
"sync_pulse_out_pulse_width": 10,
"timestamp_mode": "TIME_FROM_INTERNAL_OSC",
"lidar_mode": "1024x10",
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL",
"nmea_ignore_valid_char": 0,
"udp_profile_imu": "LEGACY",
"sync_pulse_out_frequency": 1,
"operating_mode": "NORMAL",
"udp_ip": "169.254.175.254",
"columns_per_packet": 16,
"nmea_baud_rate": "BAUD_9600",
"phase_lock_enable": false,
"azimuth_window": [90000, 270000],
"udp_port_imu": 7503,
"sync_pulse_out_angle": 360,
"auto_start_flag": 1,
"sync_pulse_out_polarity": "ACTIVE_HIGH",
"phase_lock_offset": 0,
"sync_pulse_in_polarity": "ACTIVE_HIGH"
},
"sensor_info":
{
"image_rev": "ousteros-image-prod-aries-v2.3.0-rc.1+20220319004702.staging",
"build_rev": "v2.3.0-rc.1",
"prod_sn": "992139000666",
"initialization_id": 5431287,
"base_sn": "",
"build_date": "2022-03-18T20:00:29Z",
"prod_pn": "840-103575-06",
"prod_line": "OS-1-128",
"proto_rev": "",
"status": "RUNNING",
"base_pn": ""
},
"beam_intrinsics":
{
"beam_azimuth_angles": [4.2300000000000004, 1.4099999999999999, -1.3999999999999999,
-4.21, 4.2199999999999998, 1.4199999999999999, -1.4099999999999999, -4.2199999999999998,
4.2300000000000004, 1.4099999999999999, -1.4199999999999999, -4.21, 4.2300000000000004,
1.4199999999999999, -1.3999999999999999, -4.2000000000000002, 4.2300000000000004,
1.4099999999999999, -1.3899999999999999, -4.21, 4.25, 1.4299999999999999,
-1.4099999999999999, -4.2199999999999998, 4.2400000000000002, 1.4399999999999999,
-1.4099999999999999, -4.2199999999999998, 4.2300000000000004, 1.4199999999999999,
-1.3799999999999999, -4.2199999999999998, 4.2400000000000002, 1.4199999999999999,
-1.3999999999999999, -4.2300000000000004, 4.2599999999999998, 1.4399999999999999,
-1.4099999999999999, -4.2300000000000004, 4.2400000000000002, 1.4399999999999999,
-1.4099999999999999, -4.2300000000000004, 4.2400000000000002, 1.4199999999999999,
-1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999, -1.3899999999999999,
-4.2199999999999998, 4.25, 1.4099999999999999, -1.3999999999999999, -4.2300000000000004,
4.2400000000000002, 1.4299999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4199999999999999, -1.4099999999999999, -4.2300000000000004, 4.25,
1.4199999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002,
1.4399999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002,
1.4299999999999999, -1.3999999999999999, -4.2400000000000002, 4.25, 1.4299999999999999,
-1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999, -1.4199999999999999,
-4.2199999999999998, 4.2400000000000002, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4399999999999999, -1.4099999999999999, -4.2400000000000002,
4.25, 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4099999999999999, -4.25, 4.2599999999999998, 1.4299999999999999,
-1.4099999999999999, -4.2599999999999998, 4.2699999999999996, 1.4299999999999999,
-1.3999999999999999, -4.2400000000000002, 4.25, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.2599999999999998, 1.4199999999999999, -1.3999999999999999, -4.25,
4.2599999999999998, 1.4299999999999999, -1.4099999999999999, -4.2599999999999998,
4.2599999999999998, 1.4199999999999999, -1.4199999999999999, -4.2599999999999998, 4.25,
1.4199999999999999, -1.4199999999999999, -4.2699999999999996],
"beam_altitude_angles": [21.010000000000002, 20.719999999999999, 20.420000000000002,
20.100000000000001, 19.789999999999999, 19.48, 19.170000000000002, 18.84,
18.550000000000001, 18.219999999999999, 17.899999999999999, 17.600000000000001,
17.27, 16.960000000000001, 16.649999999999999, 16.32, 15.970000000000001, 15.65, 15.34,
15.01, 14.67, 14.35, 14.01, 13.68, 13.33, 13.02, 12.67, 12.34, 11.99, 11.65, 11.33,
10.98, 10.640000000000001, 10.279999999999999, 9.9499999999999993, 9.6099999999999994,
9.2699999999999996, 8.9199999999999999, 8.5700000000000003, 8.2300000000000004,
7.8799999999999999, 7.54, 7.1799999999999997, 6.8399999999999999, 6.4699999999999998,
6.1299999999999999, 5.7800000000000002, 5.4500000000000002, 5.0899999999999999,
4.7300000000000004, 4.4100000000000001, 4.0499999999999998, 3.6899999999999999,
3.3199999999999998, 2.98, 2.6299999999999999, 2.27, 1.9299999999999999, 1.5700000000000001,
1.22, 0.84999999999999998, 0.5, 0.14999999999999999, -0.19, -0.55000000000000004,
-0.92000000000000004, -1.25, -1.6299999999999999, -1.98, -2.3100000000000001,
-2.6699999999999999, -3.04, -3.3999999999999999, -3.7400000000000002, -4.0899999999999999,
-4.4500000000000002, -4.7999999999999998, -5.1500000000000004, -5.5, -5.8700000000000001,
-6.21, -6.5700000000000003, -6.9100000000000001, -7.25, -7.6200000000000001,
-7.9500000000000002, -8.3000000000000007, -8.6500000000000004, -9.0099999999999998,
-9.3499999999999996, -9.6899999999999995, -10.050000000000001, -10.390000000000001, -10.74,
-11.09, -11.42, -11.77, -12.109999999999999, -12.449999999999999, -12.800000000000001,
-13.140000000000001, -13.470000000000001, -13.81, -14.15, -14.48, -14.82, -15.130000000000001,
-15.470000000000001, -15.81, -16.149999999999999, -16.48, -16.800000000000001,
-17.149999999999999, -17.48, -17.789999999999999, -18.120000000000001, -18.469999999999999,
-18.77, -19.09, -19.420000000000002, -19.73, -20.059999999999999, -20.359999999999999,
-20.690000000000001, -21, -21.32, -21.620000000000001, -21.940000000000001],
"lidar_origin_to_beam_origin_mm": 15.805999999999999
},
"calibration_status":
{
"reflectivity":
{
"timestamp": "2021-10-05T00:02:36",
"valid": true
}
},
"lidar_intrinsics":
{
"lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]
},
"imu_intrinsics":
{
"imu_to_sensor_transform": [1, 0, 0, 6.2530000000000001, 0, 1, 0, -11.775, 0,
0, 1, 7.6449999999999996, 0, 0, 0, 1]
},
"lidar_data_format":
{
"column_window": [256, 768],
"pixel_shift_by_row": [24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0],
"columns_per_packet": 16,
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL",
"udp_profile_imu": "LEGACY",
"pixels_per_column": 128,
"columns_per_frame": 1024
}
}
curl
curl -i http://169.254.198.184/api/v1/sensor/metadata --data-raw 'HTTP/1.1 200 OK
content-type: application/json
content-length: 6675
{
"config_params":
{
"signal_multiplier": 1,
"udp_dest": "169.254.175.254",
"multipurpose_io_mode": "OFF",
"udp_port_lidar": 7502,
"nmea_leap_seconds": 0,
"nmea_in_polarity": "ACTIVE_HIGH",
"sync_pulse_out_pulse_width": 10,
"timestamp_mode": "TIME_FROM_INTERNAL_OSC",
"lidar_mode": "1024x10",
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL",
"nmea_ignore_valid_char": 0,
"udp_profile_imu": "LEGACY",
"sync_pulse_out_frequency": 1,
"operating_mode": "NORMAL",
"udp_ip": "169.254.175.254",
"columns_per_packet": 16,
"nmea_baud_rate": "BAUD_9600",
"phase_lock_enable": false,
"azimuth_window": [90000, 270000],
"udp_port_imu": 7503,
"sync_pulse_out_angle": 360,
"auto_start_flag": 1,
"sync_pulse_out_polarity": "ACTIVE_HIGH",
"phase_lock_offset": 0,
"sync_pulse_in_polarity": "ACTIVE_HIGH"
},
"sensor_info":
{
"image_rev": "ousteros-image-prod-aries-v2.3.0-rc.1+20220319004702.staging",
"build_rev": "v2.3.0-rc.1",
"prod_sn": "992139000666",
"initialization_id": 5431287,
"base_sn": "",
"build_date": "2022-03-18T20:00:29Z",
"prod_pn": "840-103575-06",
"prod_line": "OS-1-128",
"proto_rev": "",
"status": "RUNNING",
"base_pn": ""
},
"beam_intrinsics":
{
"beam_azimuth_angles": [4.2300000000000004, 1.4099999999999999, -1.3999999999999999,
-4.21, 4.2199999999999998, 1.4199999999999999, -1.4099999999999999, -4.2199999999999998,
4.2300000000000004, 1.4099999999999999, -1.4199999999999999, -4.21, 4.2300000000000004,
1.4199999999999999, -1.3999999999999999, -4.2000000000000002, 4.2300000000000004,
1.4099999999999999, -1.3899999999999999, -4.21, 4.25, 1.4299999999999999,
-1.4099999999999999, -4.2199999999999998, 4.2400000000000002, 1.4399999999999999,
-1.4099999999999999, -4.2199999999999998, 4.2300000000000004, 1.4199999999999999,
-1.3799999999999999, -4.2199999999999998, 4.2400000000000002, 1.4199999999999999,
-1.3999999999999999, -4.2300000000000004, 4.2599999999999998, 1.4399999999999999,
-1.4099999999999999, -4.2300000000000004, 4.2400000000000002, 1.4399999999999999,
-1.4099999999999999, -4.2300000000000004, 4.2400000000000002, 1.4199999999999999,
-1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999, -1.3899999999999999,
-4.2199999999999998, 4.25, 1.4099999999999999, -1.3999999999999999, -4.2300000000000004,
4.2400000000000002, 1.4299999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4199999999999999, -1.4099999999999999, -4.2300000000000004, 4.25,
1.4199999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002,
1.4399999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002,
1.4299999999999999, -1.3999999999999999, -4.2400000000000002, 4.25, 1.4299999999999999,
-1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999, -1.4199999999999999,
-4.2199999999999998, 4.2400000000000002, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4399999999999999, -1.4099999999999999, -4.2400000000000002,
4.25, 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4099999999999999, -4.25, 4.2599999999999998, 1.4299999999999999,
-1.4099999999999999, -4.2599999999999998, 4.2699999999999996, 1.4299999999999999,
-1.3999999999999999, -4.2400000000000002, 4.25, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.2599999999999998, 1.4199999999999999, -1.3999999999999999, -4.25,
4.2599999999999998, 1.4299999999999999, -1.4099999999999999, -4.2599999999999998,
4.2599999999999998, 1.4199999999999999, -1.4199999999999999, -4.2599999999999998, 4.25,
1.4199999999999999, -1.4199999999999999, -4.2699999999999996],
"beam_altitude_angles": [21.010000000000002, 20.719999999999999, 20.420000000000002,
20.100000000000001, 19.789999999999999, 19.48, 19.170000000000002, 18.84,
18.550000000000001, 18.219999999999999, 17.899999999999999, 17.600000000000001,
17.27, 16.960000000000001, 16.649999999999999, 16.32, 15.970000000000001, 15.65, 15.34,
15.01, 14.67, 14.35, 14.01, 13.68, 13.33, 13.02, 12.67, 12.34, 11.99, 11.65, 11.33,
10.98, 10.640000000000001, 10.279999999999999, 9.9499999999999993, 9.6099999999999994,
9.2699999999999996, 8.9199999999999999, 8.5700000000000003, 8.2300000000000004,
7.8799999999999999, 7.54, 7.1799999999999997, 6.8399999999999999, 6.4699999999999998,
6.1299999999999999, 5.7800000000000002, 5.4500000000000002, 5.0899999999999999,
4.7300000000000004, 4.4100000000000001, 4.0499999999999998, 3.6899999999999999,
3.3199999999999998, 2.98, 2.6299999999999999, 2.27, 1.9299999999999999, 1.5700000000000001,
1.22, 0.84999999999999998, 0.5, 0.14999999999999999, -0.19, -0.55000000000000004,
-0.92000000000000004, -1.25, -1.6299999999999999, -1.98, -2.3100000000000001,
-2.6699999999999999, -3.04, -3.3999999999999999, -3.7400000000000002, -4.0899999999999999,
-4.4500000000000002, -4.7999999999999998, -5.1500000000000004, -5.5, -5.8700000000000001,
-6.21, -6.5700000000000003, -6.9100000000000001, -7.25, -7.6200000000000001,
-7.9500000000000002, -8.3000000000000007, -8.6500000000000004, -9.0099999999999998,
-9.3499999999999996, -9.6899999999999995, -10.050000000000001, -10.390000000000001, -10.74,
-11.09, -11.42, -11.77, -12.109999999999999, -12.449999999999999, -12.800000000000001,
-13.140000000000001, -13.470000000000001, -13.81, -14.15, -14.48, -14.82, -15.130000000000001,
-15.470000000000001, -15.81, -16.149999999999999, -16.48, -16.800000000000001,
-17.149999999999999, -17.48, -17.789999999999999, -18.120000000000001, -18.469999999999999,
-18.77, -19.09, -19.420000000000002, -19.73, -20.059999999999999, -20.359999999999999,
-20.690000000000001, -21, -21.32, -21.620000000000001, -21.940000000000001],
"lidar_origin_to_beam_origin_mm": 15.805999999999999
},
"calibration_status":
{
"reflectivity":
{
"timestamp": "2021-10-05T00:02:36",
"valid": true
}
},
"lidar_intrinsics":
{
"lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]
},
"imu_intrinsics":
{
"imu_to_sensor_transform": [1, 0, 0, 6.2530000000000001, 0, 1, 0, -11.775, 0,
0, 1, 7.6449999999999996, 0, 0, 0, 1]
},
"lidar_data_format":
{
"column_window": [256, 768],
"pixel_shift_by_row": [24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0],
"columns_per_packet": 16,
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL",
"udp_profile_imu": "LEGACY",
"pixels_per_column": 128,
"columns_per_frame": 1024
}
}'
httpie
echo 'HTTP/1.1 200 OK
content-type: application/json
content-length: 6675
{
"config_params":
{
"signal_multiplier": 1,
"udp_dest": "169.254.175.254",
"multipurpose_io_mode": "OFF",
"udp_port_lidar": 7502,
"nmea_leap_seconds": 0,
"nmea_in_polarity": "ACTIVE_HIGH",
"sync_pulse_out_pulse_width": 10,
"timestamp_mode": "TIME_FROM_INTERNAL_OSC",
"lidar_mode": "1024x10",
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL",
"nmea_ignore_valid_char": 0,
"udp_profile_imu": "LEGACY",
"sync_pulse_out_frequency": 1,
"operating_mode": "NORMAL",
"udp_ip": "169.254.175.254",
"columns_per_packet": 16,
"nmea_baud_rate": "BAUD_9600",
"phase_lock_enable": false,
"azimuth_window": [90000, 270000],
"udp_port_imu": 7503,
"sync_pulse_out_angle": 360,
"auto_start_flag": 1,
"sync_pulse_out_polarity": "ACTIVE_HIGH",
"phase_lock_offset": 0,
"sync_pulse_in_polarity": "ACTIVE_HIGH"
},
"sensor_info":
{
"image_rev": "ousteros-image-prod-aries-v2.3.0-rc.1+20220319004702.staging",
"build_rev": "v2.3.0-rc.1",
"prod_sn": "992139000666",
"initialization_id": 5431287,
"base_sn": "",
"build_date": "2022-03-18T20:00:29Z",
"prod_pn": "840-103575-06",
"prod_line": "OS-1-128",
"proto_rev": "",
"status": "RUNNING",
"base_pn": ""
},
"beam_intrinsics":
{
"beam_azimuth_angles": [4.2300000000000004, 1.4099999999999999, -1.3999999999999999,
-4.21, 4.2199999999999998, 1.4199999999999999, -1.4099999999999999, -4.2199999999999998,
4.2300000000000004, 1.4099999999999999, -1.4199999999999999, -4.21, 4.2300000000000004,
1.4199999999999999, -1.3999999999999999, -4.2000000000000002, 4.2300000000000004,
1.4099999999999999, -1.3899999999999999, -4.21, 4.25, 1.4299999999999999,
-1.4099999999999999, -4.2199999999999998, 4.2400000000000002, 1.4399999999999999,
-1.4099999999999999, -4.2199999999999998, 4.2300000000000004, 1.4199999999999999,
-1.3799999999999999, -4.2199999999999998, 4.2400000000000002, 1.4199999999999999,
-1.3999999999999999, -4.2300000000000004, 4.2599999999999998, 1.4399999999999999,
-1.4099999999999999, -4.2300000000000004, 4.2400000000000002, 1.4399999999999999,
-1.4099999999999999, -4.2300000000000004, 4.2400000000000002, 1.4199999999999999,
-1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999, -1.3899999999999999,
-4.2199999999999998, 4.25, 1.4099999999999999, -1.3999999999999999, -4.2300000000000004,
4.2400000000000002, 1.4299999999999999, -1.4099999999999999, -4.2300000000000004,
4.2400000000000002, 1.4199999999999999, -1.4099999999999999, -4.2300000000000004, 4.25,
1.4199999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002,
1.4399999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002,
1.4299999999999999, -1.3999999999999999, -4.2400000000000002, 4.25, 1.4299999999999999,
-1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999, -1.4199999999999999,
-4.2199999999999998, 4.2400000000000002, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.25, 1.4399999999999999, -1.4099999999999999, -4.2400000000000002,
4.25, 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,
1.4199999999999999, -1.4099999999999999, -4.25, 4.2599999999999998, 1.4299999999999999,
-1.4099999999999999, -4.2599999999999998, 4.2699999999999996, 1.4299999999999999,
-1.3999999999999999, -4.2400000000000002, 4.25, 1.4299999999999999, -1.3999999999999999,
-4.2400000000000002, 4.2599999999999998, 1.4199999999999999, -1.3999999999999999, -4.25,
4.2599999999999998, 1.4299999999999999, -1.4099999999999999, -4.2599999999999998,
4.2599999999999998, 1.4199999999999999, -1.4199999999999999, -4.2599999999999998, 4.25,
1.4199999999999999, -1.4199999999999999, -4.2699999999999996],
"beam_altitude_angles": [21.010000000000002, 20.719999999999999, 20.420000000000002,
20.100000000000001, 19.789999999999999, 19.48, 19.170000000000002, 18.84,
18.550000000000001, 18.219999999999999, 17.899999999999999, 17.600000000000001,
17.27, 16.960000000000001, 16.649999999999999, 16.32, 15.970000000000001, 15.65, 15.34,
15.01, 14.67, 14.35, 14.01, 13.68, 13.33, 13.02, 12.67, 12.34, 11.99, 11.65, 11.33,
10.98, 10.640000000000001, 10.279999999999999, 9.9499999999999993, 9.6099999999999994,
9.2699999999999996, 8.9199999999999999, 8.5700000000000003, 8.2300000000000004,
7.8799999999999999, 7.54, 7.1799999999999997, 6.8399999999999999, 6.4699999999999998,
6.1299999999999999, 5.7800000000000002, 5.4500000000000002, 5.0899999999999999,
4.7300000000000004, 4.4100000000000001, 4.0499999999999998, 3.6899999999999999,
3.3199999999999998, 2.98, 2.6299999999999999, 2.27, 1.9299999999999999, 1.5700000000000001,
1.22, 0.84999999999999998, 0.5, 0.14999999999999999, -0.19, -0.55000000000000004,
-0.92000000000000004, -1.25, -1.6299999999999999, -1.98, -2.3100000000000001,
-2.6699999999999999, -3.04, -3.3999999999999999, -3.7400000000000002, -4.0899999999999999,
-4.4500000000000002, -4.7999999999999998, -5.1500000000000004, -5.5, -5.8700000000000001,
-6.21, -6.5700000000000003, -6.9100000000000001, -7.25, -7.6200000000000001,
-7.9500000000000002, -8.3000000000000007, -8.6500000000000004, -9.0099999999999998,
-9.3499999999999996, -9.6899999999999995, -10.050000000000001, -10.390000000000001, -10.74,
-11.09, -11.42, -11.77, -12.109999999999999, -12.449999999999999, -12.800000000000001,
-13.140000000000001, -13.470000000000001, -13.81, -14.15, -14.48, -14.82, -15.130000000000001,
-15.470000000000001, -15.81, -16.149999999999999, -16.48, -16.800000000000001,
-17.149999999999999, -17.48, -17.789999999999999, -18.120000000000001, -18.469999999999999,
-18.77, -19.09, -19.420000000000002, -19.73, -20.059999999999999, -20.359999999999999,
-20.690000000000001, -21, -21.32, -21.620000000000001, -21.940000000000001],
"lidar_origin_to_beam_origin_mm": 15.805999999999999
},
"calibration_status":
{
"reflectivity":
{
"timestamp": "2021-10-05T00:02:36",
"valid": true
}
},
"lidar_intrinsics":
{
"lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]
},
"imu_intrinsics":
{
"imu_to_sensor_transform": [1, 0, 0, 6.2530000000000001, 0, 1, 0, -11.775, 0,
0, 1, 7.6449999999999996, 0, 0, 0, 1]
},
"lidar_data_format":
{
"column_window": [256, 768],
"pixel_shift_by_row": [24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,
8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0],
"columns_per_packet": 16,
"udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL",
"udp_profile_imu": "LEGACY",
"pixels_per_column": 128,
"columns_per_frame": 1024
}
}' | http http://169.254.198.184/api/v1/sensor/metadata
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/metadata', data='HTTP/1.1 200 OK\r\n\ncontent-type: application/json\r\n\ncontent-length: 6675\r\n\n {\r\n\n "config_params":\r\n\n {\r\n\n "signal_multiplier": 1,\r\n\n "udp_dest": "169.254.175.254",\r\n\n "multipurpose_io_mode": "OFF",\r\n\n "udp_port_lidar": 7502,\r\n\n "nmea_leap_seconds": 0,\r\n\n "nmea_in_polarity": "ACTIVE_HIGH",\r\n\n "sync_pulse_out_pulse_width": 10,\r\n\n "timestamp_mode": "TIME_FROM_INTERNAL_OSC",\r\n\n "lidar_mode": "1024x10",\r\n\n "udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL",\r\n\n "nmea_ignore_valid_char": 0,\r\n\n "udp_profile_imu": "LEGACY",\r\n\n "sync_pulse_out_frequency": 1,\r\n\n "operating_mode": "NORMAL",\r\n\n "udp_ip": "169.254.175.254",\r\n\n "columns_per_packet": 16,\r\n\n "nmea_baud_rate": "BAUD_9600",\r\n\n "phase_lock_enable": false,\r\n\n "azimuth_window": [90000, 270000],\r\n\n "udp_port_imu": 7503,\r\n\n "sync_pulse_out_angle": 360,\r\n\n "auto_start_flag": 1,\r\n\n "sync_pulse_out_polarity": "ACTIVE_HIGH",\r\n\n "phase_lock_offset": 0,\r\n\n "sync_pulse_in_polarity": "ACTIVE_HIGH"\r\n\n },\r\n\n "sensor_info":\r\n\n {\r\n\n "image_rev": "ousteros-image-prod-aries-v2.3.0-rc.1+20220319004702.staging",\r\n\n "build_rev": "v2.3.0-rc.1",\r\n\n "prod_sn": "992139000666",\r\n\n "initialization_id": 5431287,\r\n\n "base_sn": "",\r\n\n "build_date": "2022-03-18T20:00:29Z",\r\n\n "prod_pn": "840-103575-06",\r\n\n "prod_line": "OS-1-128",\r\n\n "proto_rev": "",\r\n\n "status": "RUNNING",\r\n\n "base_pn": ""\r\n\n },\r\n\n "beam_intrinsics":\r\n\n {\r\n\n "beam_azimuth_angles": [4.2300000000000004, 1.4099999999999999, -1.3999999999999999,\r\n\n -4.21, 4.2199999999999998, 1.4199999999999999, -1.4099999999999999, -4.2199999999999998,\r\n\n 4.2300000000000004, 1.4099999999999999, -1.4199999999999999, -4.21, 4.2300000000000004,\r\n\n 1.4199999999999999, -1.3999999999999999, -4.2000000000000002, 4.2300000000000004,\r\n\n 1.4099999999999999, -1.3899999999999999, -4.21, 4.25, 1.4299999999999999,\r\n\n -1.4099999999999999, -4.2199999999999998, 4.2400000000000002, 1.4399999999999999,\r\n\n -1.4099999999999999, -4.2199999999999998, 4.2300000000000004, 1.4199999999999999,\r\n\n -1.3799999999999999, -4.2199999999999998, 4.2400000000000002, 1.4199999999999999,\r\n\n -1.3999999999999999, -4.2300000000000004, 4.2599999999999998, 1.4399999999999999,\r\n\n -1.4099999999999999, -4.2300000000000004, 4.2400000000000002, 1.4399999999999999,\r\n\n -1.4099999999999999, -4.2300000000000004, 4.2400000000000002, 1.4199999999999999,\r\n\n -1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999, -1.3899999999999999,\r\n\n -4.2199999999999998, 4.25, 1.4099999999999999, -1.3999999999999999, -4.2300000000000004,\r\n\n 4.2400000000000002, 1.4299999999999999, -1.4099999999999999, -4.2300000000000004,\r\n\n 4.2400000000000002, 1.4199999999999999, -1.4099999999999999, -4.2300000000000004, 4.25,\r\n\n 1.4199999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002,\r\n\n 1.4399999999999999, -1.3999999999999999, -4.2400000000000002, 4.2400000000000002,\r\n\n 1.4299999999999999, -1.3999999999999999, -4.2400000000000002, 4.25, 1.4299999999999999,\r\n\n -1.4099999999999999, -4.2400000000000002, 4.25, 1.4199999999999999, -1.4199999999999999,\r\n\n -4.2199999999999998, 4.2400000000000002, 1.4299999999999999, -1.3999999999999999,\r\n\n -4.2400000000000002, 4.25, 1.4399999999999999, -1.4099999999999999, -4.2400000000000002,\r\n\n 4.25, 1.4199999999999999, -1.4099999999999999, -4.2400000000000002, 4.25,\r\n\n 1.4199999999999999, -1.4099999999999999, -4.25, 4.2599999999999998, 1.4299999999999999,\r\n\n -1.4099999999999999, -4.2599999999999998, 4.2699999999999996, 1.4299999999999999,\r\n\n -1.3999999999999999, -4.2400000000000002, 4.25, 1.4299999999999999, -1.3999999999999999,\r\n\n -4.2400000000000002, 4.2599999999999998, 1.4199999999999999, -1.3999999999999999, -4.25,\r\n\n 4.2599999999999998, 1.4299999999999999, -1.4099999999999999, -4.2599999999999998,\r\n\n 4.2599999999999998, 1.4199999999999999, -1.4199999999999999, -4.2599999999999998, 4.25,\r\n\n 1.4199999999999999, -1.4199999999999999, -4.2699999999999996],\r\n\n "beam_altitude_angles": [21.010000000000002, 20.719999999999999, 20.420000000000002,\r\n\n 20.100000000000001, 19.789999999999999, 19.48, 19.170000000000002, 18.84,\r\n\n 18.550000000000001, 18.219999999999999, 17.899999999999999, 17.600000000000001,\r\n\n 17.27, 16.960000000000001, 16.649999999999999, 16.32, 15.970000000000001, 15.65, 15.34,\r\n\n 15.01, 14.67, 14.35, 14.01, 13.68, 13.33, 13.02, 12.67, 12.34, 11.99, 11.65, 11.33,\r\n\n 10.98, 10.640000000000001, 10.279999999999999, 9.9499999999999993, 9.6099999999999994,\r\n\n 9.2699999999999996, 8.9199999999999999, 8.5700000000000003, 8.2300000000000004,\r\n\n 7.8799999999999999, 7.54, 7.1799999999999997, 6.8399999999999999, 6.4699999999999998,\r\n\n 6.1299999999999999, 5.7800000000000002, 5.4500000000000002, 5.0899999999999999,\r\n\n 4.7300000000000004, 4.4100000000000001, 4.0499999999999998, 3.6899999999999999,\r\n\n 3.3199999999999998, 2.98, 2.6299999999999999, 2.27, 1.9299999999999999, 1.5700000000000001,\r\n\n 1.22, 0.84999999999999998, 0.5, 0.14999999999999999, -0.19, -0.55000000000000004,\r\n\n -0.92000000000000004, -1.25, -1.6299999999999999, -1.98, -2.3100000000000001,\r\n\n -2.6699999999999999, -3.04, -3.3999999999999999, -3.7400000000000002, -4.0899999999999999,\r\n\n -4.4500000000000002, -4.7999999999999998, -5.1500000000000004, -5.5, -5.8700000000000001,\r\n\n -6.21, -6.5700000000000003, -6.9100000000000001, -7.25, -7.6200000000000001,\r\n\n -7.9500000000000002, -8.3000000000000007, -8.6500000000000004, -9.0099999999999998,\r\n\n -9.3499999999999996, -9.6899999999999995, -10.050000000000001, -10.390000000000001, -10.74,\r\n\n -11.09, -11.42, -11.77, -12.109999999999999, -12.449999999999999, -12.800000000000001,\r\n\n -13.140000000000001, -13.470000000000001, -13.81, -14.15, -14.48, -14.82, -15.130000000000001,\r\n\n -15.470000000000001, -15.81, -16.149999999999999, -16.48, -16.800000000000001,\r\n\n -17.149999999999999, -17.48, -17.789999999999999, -18.120000000000001, -18.469999999999999,\r\n\n -18.77, -19.09, -19.420000000000002, -19.73, -20.059999999999999, -20.359999999999999,\r\n\n -20.690000000000001, -21, -21.32, -21.620000000000001, -21.940000000000001],\r\n\n "lidar_origin_to_beam_origin_mm": 15.805999999999999\r\n\n },\r\n\n "calibration_status":\r\n\n {\r\n\n "reflectivity":\r\n\n {\r\n\n "timestamp": "2021-10-05T00:02:36",\r\n\n "valid": true\r\n\n }\r\n\n },\r\n\n "lidar_intrinsics":\r\n\n {\r\n\n "lidar_to_sensor_transform": [-1, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1, 36.18, 0, 0, 0, 1]\r\n\n },\r\n\n "imu_intrinsics":\r\n\n {\r\n\n "imu_to_sensor_transform": [1, 0, 0, 6.2530000000000001, 0, 1, 0, -11.775, 0,\r\n\n 0, 1, 7.6449999999999996, 0, 0, 0, 1]\r\n\n },\r\n\n "lidar_data_format":\r\n\n {\r\n\n "column_window": [256, 768],\r\n\n "pixel_shift_by_row": [24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16,\r\n\n 8, 0, 24, 16, 8, 0, 24, 16, 8, 0, 24, 16, 8, 0],\r\n\n "columns_per_packet": 16,\r\n\n "udp_profile_lidar": "RNG19_RFL8_SIG16_NIR16_DUAL",\r\n\n "udp_profile_imu": "LEGACY",\r\n\n "pixels_per_column": 128,\r\n\n "columns_per_frame": 1024\r\n\n }\r\n\n }')
- status code 200
No error
System
GET /api/v1/system/firmware
-
GET
192.0.2.123/api/v1/system/firmware
Get the firmware version of the sensor
http
GET /api/v1/system/firmware HTTP/1.1
Host: 192.0.2.123
curl
curl -i http://192.0.2.123/api/v1/system/firmware
httpie
http http://192.0.2.123/api/v1/system/firmware
python-requests
requests.get('http://192.0.2.123/api/v1/system/firmware')
response
HTTP/1.1 200 OK
Host: 192.0.2.123
content-type: application/json; charset=UTF-8
{
"fw": "ousteros-image-prod-aries-v2.0.0"
}
- >json string fw
Running firmware image name and version.
- statuscode 200
No error
GET /api/v1/system/network
-
GET
192.0.2.123/api/v1/system/network
Get the system network configuration.
http
GET /api/v1/system/network HTTP/1.1
Host: 192.0.2.123
curl
curl -i http://192.0.2.123/api/v1/system/network
httpie
http http://192.0.2.123/api/v1/system/network
python-requests
requests.get('http://192.0.2.123/api/v1/system/network')
response
HTTP/1.1 200 OK
content-type: application/json; charset=UTF-8
{
"carrier": true,
"duplex": "full",
"ethaddr": "bc:0f:a7:00:01:2c",
"hostname": "os-991900123456",
"ipv4": {
"addr": "192.0.2.123/24",
"link_local": "169.254.245.183/16",
"override": null
},
"ipv6": {
"link_local": "fe80::be0f:a7ff:fe00:12c/64"
},
"speed": 1000
}
- >json boolean carrier
State of Ethernet link,
true
when physical layer is connected.- >json string duplex
Duplex mode of Ethernet link,
half
orfull
.- >json string ethaddr
Ethernet hardware (MAC) address.
- >json string hostname
Hostname of the sensor, also used when requesting DHCP address and registering mDNS hostname.
- >json object ipv4
See ipv4 object
- >json string ipv6.link_local
Link-local IPv6 address.
- >json integer speed
Ethernet physical layer speed in Mbps, should be 1000 Mbps.
- statuscode 200
No error
GET /api/v1/system/network/ipv4
-
GET
192.0.2.123/api/v1/system/network/ipv4
Get the IPv4 network configuration.
http
GET /api/v1/system/network/ipv4 HTTP/1.1
Host: 192.0.2.123
curl
curl -i http://192.0.2.123/api/v1/system/network/ipv4
httpie
http http://192.0.2.123/api/v1/system/network/ipv4
python-requests
requests.get('http://192.0.2.123/api/v1/system/network/ipv4')
response
HTTP/1.1 200 OK
content-type: application/json; charset=UTF-8
{
"addr": "192.0.2.123/23",
"link_local": "169.254.245.183/16",
"override": null
}
- >json string addr
Current global or private IPv4 address.
- >json string link_local
Link-local IPv4 address.
- >json string override
Static IP override value, this should match
addr
. This value will benull
when unset and operating in DHCP or link-local modes.- statuscode 200
No error
GET /api/v1/system/network/ipv4/override
-
GET
192.0.2.123/api/v1/system/network/ipv4/override
Get the current IPv4 static IP address override.
http
GET /api/v1/system/network/ipv4/override HTTP/1.1
Host: 192.0.2.123
curl
curl -i http://192.0.2.123/api/v1/system/network/ipv4/override
httpie
http http://192.0.2.123/api/v1/system/network/ipv4/override
python-requests
requests.get('http://192.0.2.123/api/v1/system/network/ipv4/override')
response
HTTP/1.1 200 OK
content-type: application/json; charset=UTF-8
null
- >json string
Static IP override value, this should match
addr
. This value will benull
when unset and operating in DHCP mode.- statuscode 200
No error
PUT /api/v1/system/network/ipv4/override
-
PUT
192.0.2.123/api/v1/system/network/ipv4/override
Override the default dynamic behavior and set a static IP address.
Note
The sensor will reset the network configuration after a short sub second delay (to allow for the HTTP response to be sent). After this delay the sensor will only be reachable on the newly set IPv4 address.
The sensor needs to be reachable either by link-local or dynamic DHCP configuration or by an existing static IP override from the host reconfiguring the sensor.
Warning
If an unreachable network address is set, the sensor will become unreachable. Tools such as avahi-browse, dns-sd, or mDNS browser can help with finding a sensor on a network.
Static IP override should only be used in special use cases. The link-local configuration is recommended where possible.
http
PUT /api/v1/system/network/ipv4/override HTTP/1.1
Content-Type: application/json
Host: 192.0.2.123
"192.0.2.100/24"
curl
curl -i -X PUT http://192.0.2.123/api/v1/system/network/ipv4/override -H 'Content-Type: application/json' --data-raw '"192.0.2.100/24"'
httpie
echo '"192.0.2.100/24"' | http PUT http://192.0.2.123/api/v1/system/network/ipv4/override Content-Type:application/json
python-requests
requests.put('http://192.0.2.123/api/v1/system/network/ipv4/override', headers={'Content-Type': 'application/json'}, json='192.0.2.100/24')
- <json string
Static IP override value with subnet mask
- >json string
Static IP override value that system will set after a short delay.
- statuscode 200
No error
DELETE /api/v1/system/network/ipv4/override
-
DELETE
192.0.2.123/api/v1/system/network/ipv4/override
Delete the static IP override value and return to dynamic configuration.
Note
The sensor will reset the network configuration after a short sub second delay (to allow for the HTTP response to be sent). After this delay the sensor will only be reachable on the newly set IPv4 address.
The sensor may be unreachable for several seconds while a link-local lease is obtained from the network or client machine.
http
DELETE /api/v1/system/network/ipv4/override HTTP/1.1
Host: 192.0.2.123
curl
curl -i -X DELETE http://192.0.2.123/api/v1/system/network/ipv4/override
httpie
http DELETE http://192.0.2.123/api/v1/system/network/ipv4/override
python-requests
requests.delete('http://192.0.2.123/api/v1/system/network/ipv4/override')
- statuscode 204
No error, no content
Time
GET /api/v1/time
-
GET
192.0.2.123/api/v1/time
Get the system time configuration for all timing components of the sensor.
http
GET /api/v1/time HTTP/1.1
Host: 192.0.2.123
HTTP/1.1 200 OK
content-type: application/json; charset=UTF-8
{
"ptp": {
"current_data_set": {
"mean_path_delay": 0.0,
"offset_from_master": 0.0,
"steps_removed": 0
},
"parent_data_set": {
"gm_clock_accuracy": 254,
"gm_clock_class": 255,
"gm_offset_scaled_log_variance": 65535,
"grandmaster_identity": "bc0fa7.fffe.003aa6",
"grandmaster_priority1": 128,
"grandmaster_priority2": 128,
"observed_parent_clock_phase_change_rate": 2147483647,
"observed_parent_offset_scaled_log_variance": 65535,
"parent_port_identity": "bc0fa7.fffe.003aa6-0",
"parent_stats": 0
},
"port_data_set": {
"announce_receipt_timeout": 3,
"delay_mechanism": 1,
"log_announce_interval": 1,
"log_min_delay_req_interval": 0,
"log_min_pdelay_req_interval": 0,
"log_sync_interval": 0,
"peer_mean_path_delay": 0,
"port_identity": "bc0fa7.fffe.003aa6-1",
"port_state": "LISTENING",
"version_number": 2
},
"profile": "default",
"time_properties_data_set": {
"current_utc_offset": 37,
"current_utc_offset_valid": 0,
"frequency_traceable": 0,
"leap59": 0,
"leap61": 0,
"ptp_timescale": 1,
"time_source": 160,
"time_traceable": 0
},
"time_status_np": {
"cumulative_scaled_rate_offset": 0.0,
"gm_identity": "bc0fa7.fffe.003aa6",
"gm_present": false,
"gm_time_base_indicator": 0,
"ingress_time": 0,
"last_gm_phase_change": "0x0000'0000000000000000.0000",
"master_offset": 0,
"scaled_last_gm_phase_change": 0
}
},
"sensor": {
"multipurpose_io": {
"mode": "OFF",
"nmea": {
"baud_rate": "BAUD_9600",
"diagnostics": {
"decoding": {
"date_decoded_count": 0,
"last_read_message": "",
"not_valid_count": 0,
"utc_decoded_count": 0
},
"io_checks": {
"bit_count": 1,
"bit_count_unfiltered": 0,
"char_count": 0,
"start_char_count": 0
}
},
"ignore_valid_char": 0,
"leap_seconds": 0,
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"sync_pulse_out": {
"angle_deg": 360,
"frequency_hz": 1,
"polarity": "ACTIVE_HIGH",
"pulse_width_ms": 10
}
},
"sync_pulse_in": {
"diagnostics": {
"count": 1,
"count_unfiltered": 0,
"last_period_nsec": 0
},
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"timestamp": {
"mode": "TIME_FROM_INTERNAL_OSC",
"time": 311.36525506,
"time_options": {
"internal_osc": 311,
"ptp_1588": 320,
"sync_pulse_in": 1
}
}
},
"system": {
"monotonic": 320.78890018,
"realtime": 320.788918614,
"tracking": {
"frequency": 3.943,
"last_offset": 0.0,
"leap_status": "not synchronised",
"ref_time_utc": 0.0,
"reference_id": "00000000",
"remote_host": "",
"residual_frequency": 0.0,
"rms_offset": 0.0,
"root_delay": 1.0,
"root_dispersion": 1.0,
"skew": 0.0,
"stratum": 0,
"system_time_offset": -1e-09,
"update_interval": 0.0
}
}
}
curl
curl -i http://nohost/api/v1/time --data-raw 'HTTP/1.1 200 OK
content-type: application/json; charset=UTF-8
{
"ptp": {
"current_data_set": {
"mean_path_delay": 0.0,
"offset_from_master": 0.0,
"steps_removed": 0
},
"parent_data_set": {
"gm_clock_accuracy": 254,
"gm_clock_class": 255,
"gm_offset_scaled_log_variance": 65535,
"grandmaster_identity": "bc0fa7.fffe.003aa6",
"grandmaster_priority1": 128,
"grandmaster_priority2": 128,
"observed_parent_clock_phase_change_rate": 2147483647,
"observed_parent_offset_scaled_log_variance": 65535,
"parent_port_identity": "bc0fa7.fffe.003aa6-0",
"parent_stats": 0
},
"port_data_set": {
"announce_receipt_timeout": 3,
"delay_mechanism": 1,
"log_announce_interval": 1,
"log_min_delay_req_interval": 0,
"log_min_pdelay_req_interval": 0,
"log_sync_interval": 0,
"peer_mean_path_delay": 0,
"port_identity": "bc0fa7.fffe.003aa6-1",
"port_state": "LISTENING",
"version_number": 2
},
"profile": "default",
"time_properties_data_set": {
"current_utc_offset": 37,
"current_utc_offset_valid": 0,
"frequency_traceable": 0,
"leap59": 0,
"leap61": 0,
"ptp_timescale": 1,
"time_source": 160,
"time_traceable": 0
},
"time_status_np": {
"cumulative_scaled_rate_offset": 0.0,
"gm_identity": "bc0fa7.fffe.003aa6",
"gm_present": false,
"gm_time_base_indicator": 0,
"ingress_time": 0,
"last_gm_phase_change": "0x0000'0000000000000000.0000",
"master_offset": 0,
"scaled_last_gm_phase_change": 0
}
},
"sensor": {
"multipurpose_io": {
"mode": "OFF",
"nmea": {
"baud_rate": "BAUD_9600",
"diagnostics": {
"decoding": {
"date_decoded_count": 0,
"last_read_message": "",
"not_valid_count": 0,
"utc_decoded_count": 0
},
"io_checks": {
"bit_count": 1,
"bit_count_unfiltered": 0,
"char_count": 0,
"start_char_count": 0
}
},
"ignore_valid_char": 0,
"leap_seconds": 0,
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"sync_pulse_out": {
"angle_deg": 360,
"frequency_hz": 1,
"polarity": "ACTIVE_HIGH",
"pulse_width_ms": 10
}
},
"sync_pulse_in": {
"diagnostics": {
"count": 1,
"count_unfiltered": 0,
"last_period_nsec": 0
},
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"timestamp": {
"mode": "TIME_FROM_INTERNAL_OSC",
"time": 311.36525506,
"time_options": {
"internal_osc": 311,
"ptp_1588": 320,
"sync_pulse_in": 1
}
}
},
"system": {
"monotonic": 320.78890018,
"realtime": 320.788918614,
"tracking": {
"frequency": 3.943,
"last_offset": 0.0,
"leap_status": "not synchronised",
"ref_time_utc": 0.0,
"reference_id": "00000000",
"remote_host": "",
"residual_frequency": 0.0,
"rms_offset": 0.0,
"root_delay": 1.0,
"root_dispersion": 1.0,
"skew": 0.0,
"stratum": 0,
"system_time_offset": -1e-09,
"update_interval": 0.0
}
}
}'
httpie
echo 'HTTP/1.1 200 OK
content-type: application/json; charset=UTF-8
{
"ptp": {
"current_data_set": {
"mean_path_delay": 0.0,
"offset_from_master": 0.0,
"steps_removed": 0
},
"parent_data_set": {
"gm_clock_accuracy": 254,
"gm_clock_class": 255,
"gm_offset_scaled_log_variance": 65535,
"grandmaster_identity": "bc0fa7.fffe.003aa6",
"grandmaster_priority1": 128,
"grandmaster_priority2": 128,
"observed_parent_clock_phase_change_rate": 2147483647,
"observed_parent_offset_scaled_log_variance": 65535,
"parent_port_identity": "bc0fa7.fffe.003aa6-0",
"parent_stats": 0
},
"port_data_set": {
"announce_receipt_timeout": 3,
"delay_mechanism": 1,
"log_announce_interval": 1,
"log_min_delay_req_interval": 0,
"log_min_pdelay_req_interval": 0,
"log_sync_interval": 0,
"peer_mean_path_delay": 0,
"port_identity": "bc0fa7.fffe.003aa6-1",
"port_state": "LISTENING",
"version_number": 2
},
"profile": "default",
"time_properties_data_set": {
"current_utc_offset": 37,
"current_utc_offset_valid": 0,
"frequency_traceable": 0,
"leap59": 0,
"leap61": 0,
"ptp_timescale": 1,
"time_source": 160,
"time_traceable": 0
},
"time_status_np": {
"cumulative_scaled_rate_offset": 0.0,
"gm_identity": "bc0fa7.fffe.003aa6",
"gm_present": false,
"gm_time_base_indicator": 0,
"ingress_time": 0,
"last_gm_phase_change": "0x0000'"'"'0000000000000000.0000",
"master_offset": 0,
"scaled_last_gm_phase_change": 0
}
},
"sensor": {
"multipurpose_io": {
"mode": "OFF",
"nmea": {
"baud_rate": "BAUD_9600",
"diagnostics": {
"decoding": {
"date_decoded_count": 0,
"last_read_message": "",
"not_valid_count": 0,
"utc_decoded_count": 0
},
"io_checks": {
"bit_count": 1,
"bit_count_unfiltered": 0,
"char_count": 0,
"start_char_count": 0
}
},
"ignore_valid_char": 0,
"leap_seconds": 0,
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"sync_pulse_out": {
"angle_deg": 360,
"frequency_hz": 1,
"polarity": "ACTIVE_HIGH",
"pulse_width_ms": 10
}
},
"sync_pulse_in": {
"diagnostics": {
"count": 1,
"count_unfiltered": 0,
"last_period_nsec": 0
},
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"timestamp": {
"mode": "TIME_FROM_INTERNAL_OSC",
"time": 311.36525506,
"time_options": {
"internal_osc": 311,
"ptp_1588": 320,
"sync_pulse_in": 1
}
}
},
"system": {
"monotonic": 320.78890018,
"realtime": 320.788918614,
"tracking": {
"frequency": 3.943,
"last_offset": 0.0,
"leap_status": "not synchronised",
"ref_time_utc": 0.0,
"reference_id": "00000000",
"remote_host": "",
"residual_frequency": 0.0,
"rms_offset": 0.0,
"root_delay": 1.0,
"root_dispersion": 1.0,
"skew": 0.0,
"stratum": 0,
"system_time_offset": -1e-09,
"update_interval": 0.0
}
}
}' | http http://nohost/api/v1/time
python-requests
requests.get('http://nohost/api/v1/time', data='HTTP/1.1 200 OK\r\n\n content-type: application/json; charset=UTF-8\r\n\n\r\n\n {\r\n\n "ptp": {\r\n\n "current_data_set": {\r\n\n "mean_path_delay": 0.0,\r\n\n "offset_from_master": 0.0,\r\n\n "steps_removed": 0\r\n\n },\r\n\n "parent_data_set": {\r\n\n "gm_clock_accuracy": 254,\r\n\n "gm_clock_class": 255,\r\n\n "gm_offset_scaled_log_variance": 65535,\r\n\n "grandmaster_identity": "bc0fa7.fffe.003aa6",\r\n\n "grandmaster_priority1": 128,\r\n\n "grandmaster_priority2": 128,\r\n\n "observed_parent_clock_phase_change_rate": 2147483647,\r\n\n "observed_parent_offset_scaled_log_variance": 65535,\r\n\n "parent_port_identity": "bc0fa7.fffe.003aa6-0",\r\n\n "parent_stats": 0\r\n\n },\r\n\n "port_data_set": {\r\n\n "announce_receipt_timeout": 3,\r\n\n "delay_mechanism": 1,\r\n\n "log_announce_interval": 1,\r\n\n "log_min_delay_req_interval": 0,\r\n\n "log_min_pdelay_req_interval": 0,\r\n\n "log_sync_interval": 0,\r\n\n "peer_mean_path_delay": 0,\r\n\n "port_identity": "bc0fa7.fffe.003aa6-1",\r\n\n "port_state": "LISTENING",\r\n\n "version_number": 2\r\n\n },\r\n\n "profile": "default",\r\n\n "time_properties_data_set": {\r\n\n "current_utc_offset": 37,\r\n\n "current_utc_offset_valid": 0,\r\n\n "frequency_traceable": 0,\r\n\n "leap59": 0,\r\n\n "leap61": 0,\r\n\n "ptp_timescale": 1,\r\n\n "time_source": 160,\r\n\n "time_traceable": 0\r\n\n },\r\n\n "time_status_np": {\r\n\n "cumulative_scaled_rate_offset": 0.0,\r\n\n "gm_identity": "bc0fa7.fffe.003aa6",\r\n\n "gm_present": false,\r\n\n "gm_time_base_indicator": 0,\r\n\n "ingress_time": 0,\r\n\n "last_gm_phase_change": "0x0000\'0000000000000000.0000",\r\n\n "master_offset": 0,\r\n\n "scaled_last_gm_phase_change": 0\r\n\n }\r\n\n },\r\n\n "sensor": {\r\n\n "multipurpose_io": {\r\n\n "mode": "OFF",\r\n\n "nmea": {\r\n\n "baud_rate": "BAUD_9600",\r\n\n "diagnostics": {\r\n\n "decoding": {\r\n\n "date_decoded_count": 0,\r\n\n "last_read_message": "",\r\n\n "not_valid_count": 0,\r\n\n "utc_decoded_count": 0\r\n\n },\r\n\n "io_checks": {\r\n\n "bit_count": 1,\r\n\n "bit_count_unfiltered": 0,\r\n\n "char_count": 0,\r\n\n "start_char_count": 0\r\n\n }\r\n\n },\r\n\n "ignore_valid_char": 0,\r\n\n "leap_seconds": 0,\r\n\n "locked": 0,\r\n\n "polarity": "ACTIVE_HIGH"\r\n\n },\r\n\n "sync_pulse_out": {\r\n\n "angle_deg": 360,\r\n\n "frequency_hz": 1,\r\n\n "polarity": "ACTIVE_HIGH",\r\n\n "pulse_width_ms": 10\r\n\n }\r\n\n },\r\n\n "sync_pulse_in": {\r\n\n "diagnostics": {\r\n\n "count": 1,\r\n\n "count_unfiltered": 0,\r\n\n "last_period_nsec": 0\r\n\n },\r\n\n "locked": 0,\r\n\n "polarity": "ACTIVE_HIGH"\r\n\n },\r\n\n "timestamp": {\r\n\n "mode": "TIME_FROM_INTERNAL_OSC",\r\n\n "time": 311.36525506,\r\n\n "time_options": {\r\n\n "internal_osc": 311,\r\n\n "ptp_1588": 320,\r\n\n "sync_pulse_in": 1\r\n\n }\r\n\n }\r\n\n},\r\n\n"system": {\r\n\n "monotonic": 320.78890018,\r\n\n "realtime": 320.788918614,\r\n\n "tracking": {\r\n\n "frequency": 3.943,\r\n\n "last_offset": 0.0,\r\n\n "leap_status": "not synchronised",\r\n\n "ref_time_utc": 0.0,\r\n\n "reference_id": "00000000",\r\n\n "remote_host": "",\r\n\n "residual_frequency": 0.0,\r\n\n "rms_offset": 0.0,\r\n\n "root_delay": 1.0,\r\n\n "root_dispersion": 1.0,\r\n\n "skew": 0.0,\r\n\n "stratum": 0,\r\n\n "system_time_offset": -1e-09,\r\n\n "update_interval": 0.0\r\n\n }\r\n\n }\r\n\n}')
- >json string
See sub objects for details.
- statuscode 200
No error
GET /api/v1/time/sensor
-
GET
169.254.198.184/api/v1/time/sensor
Get the sensor time information
http
GET /api/v1/time/sensor HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-type: application/json
content-length: 773
{
"multipurpose_io": {
"mode": "OFF",
"nmea": {
"baud_rate": "BAUD_9600",
"diagnostics": {
"decoding": {
"date_decoded_count": 0,
"last_read_message": "",
"not_valid_count": 0,
"utc_decoded_count": 0
},
"io_checks": {
"bit_count": 1,
"bit_count_unfiltered": 0,
"char_count": 0,
"start_char_count": 0
}
},
"ignore_valid_char": 0,
"leap_seconds": 0,
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"sync_pulse_out": {
"angle_deg": 360,
"frequency_hz": 1,
"polarity": "ACTIVE_HIGH",
"pulse_width_ms": 10
}
},
"sync_pulse_in": {
"diagnostics": {
"count": 1,
"count_unfiltered": 0,
"last_period_nsec": 0
},
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"timestamp": {
"mode": "TIME_FROM_INTERNAL_OSC",
"time": 27784.88125111,
"time_options": {
"internal_osc": 27784,
"ptp_1588": 27795,
"sync_pulse_in": 1
}
}
}
curl
curl -i http://169.254.198.184/api/v1/time/sensor --data-raw 'HTTP/1.1 200 OK
content-type: application/json
content-length: 773
{
"multipurpose_io": {
"mode": "OFF",
"nmea": {
"baud_rate": "BAUD_9600",
"diagnostics": {
"decoding": {
"date_decoded_count": 0,
"last_read_message": "",
"not_valid_count": 0,
"utc_decoded_count": 0
},
"io_checks": {
"bit_count": 1,
"bit_count_unfiltered": 0,
"char_count": 0,
"start_char_count": 0
}
},
"ignore_valid_char": 0,
"leap_seconds": 0,
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"sync_pulse_out": {
"angle_deg": 360,
"frequency_hz": 1,
"polarity": "ACTIVE_HIGH",
"pulse_width_ms": 10
}
},
"sync_pulse_in": {
"diagnostics": {
"count": 1,
"count_unfiltered": 0,
"last_period_nsec": 0
},
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"timestamp": {
"mode": "TIME_FROM_INTERNAL_OSC",
"time": 27784.88125111,
"time_options": {
"internal_osc": 27784,
"ptp_1588": 27795,
"sync_pulse_in": 1
}
}
}'
httpie
echo 'HTTP/1.1 200 OK
content-type: application/json
content-length: 773
{
"multipurpose_io": {
"mode": "OFF",
"nmea": {
"baud_rate": "BAUD_9600",
"diagnostics": {
"decoding": {
"date_decoded_count": 0,
"last_read_message": "",
"not_valid_count": 0,
"utc_decoded_count": 0
},
"io_checks": {
"bit_count": 1,
"bit_count_unfiltered": 0,
"char_count": 0,
"start_char_count": 0
}
},
"ignore_valid_char": 0,
"leap_seconds": 0,
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"sync_pulse_out": {
"angle_deg": 360,
"frequency_hz": 1,
"polarity": "ACTIVE_HIGH",
"pulse_width_ms": 10
}
},
"sync_pulse_in": {
"diagnostics": {
"count": 1,
"count_unfiltered": 0,
"last_period_nsec": 0
},
"locked": 0,
"polarity": "ACTIVE_HIGH"
},
"timestamp": {
"mode": "TIME_FROM_INTERNAL_OSC",
"time": 27784.88125111,
"time_options": {
"internal_osc": 27784,
"ptp_1588": 27795,
"sync_pulse_in": 1
}
}
}' | http http://169.254.198.184/api/v1/time/sensor
python-requests
requests.get('http://169.254.198.184/api/v1/time/sensor', data='HTTP/1.1 200 OK\r\n\ncontent-type: application/json\r\n\ncontent-length: 773\r\n\n\r\n\n\r\n\n {\r\n\n "multipurpose_io": {\r\n\n "mode": "OFF",\r\n\n "nmea": {\r\n\n "baud_rate": "BAUD_9600",\r\n\n "diagnostics": {\r\n\n "decoding": {\r\n\n "date_decoded_count": 0,\r\n\n "last_read_message": "",\r\n\n "not_valid_count": 0,\r\n\n "utc_decoded_count": 0\r\n\n },\r\n\n "io_checks": {\r\n\n "bit_count": 1,\r\n\n "bit_count_unfiltered": 0,\r\n\n "char_count": 0,\r\n\n "start_char_count": 0\r\n\n }\r\n\n },\r\n\n "ignore_valid_char": 0,\r\n\n "leap_seconds": 0,\r\n\n "locked": 0,\r\n\n "polarity": "ACTIVE_HIGH"\r\n\n },\r\n\n "sync_pulse_out": {\r\n\n "angle_deg": 360,\r\n\n "frequency_hz": 1,\r\n\n "polarity": "ACTIVE_HIGH",\r\n\n "pulse_width_ms": 10\r\n\n }\r\n\n },\r\n\n "sync_pulse_in": {\r\n\n "diagnostics": {\r\n\n "count": 1,\r\n\n "count_unfiltered": 0,\r\n\n "last_period_nsec": 0\r\n\n },\r\n\n "locked": 0,\r\n\n "polarity": "ACTIVE_HIGH"\r\n\n },\r\n\n "timestamp": {\r\n\n "mode": "TIME_FROM_INTERNAL_OSC",\r\n\n "time": 27784.88125111,\r\n\n "time_options": {\r\n\n "internal_osc": 27784,\r\n\n "ptp_1588": 27795,\r\n\n "sync_pulse_in": 1\r\n\n }\r\n\n }\r\n\n }')
- status code 200
No error
- Description
Returns JSON-formatted sensor timing configuration and status of udp
timestamp
,sync_pulse_in
, andmultipurpose_io
. For more information on these parameters refer to theget_time_info
TCP command.
GET /api/v1/time/system
-
GET
192.0.2.123/api/v1/time/system
Get the operating system time status. These values relate to the sensor operating system clocks, and not clocks related to hardware timestamp data from the lidar sensor.
http
GET /api/v1/time/system HTTP/1.1
Host: 192.0.2.123
curl
curl -i http://192.0.2.123/api/v1/time/system
httpie
http http://192.0.2.123/api/v1/time/system
python-requests
requests.get('http://192.0.2.123/api/v1/time/system')
response
HTTP/1.1 200 OK
content-type: application/json; charset=UTF-8
{
"monotonic": 345083.599570944,
"realtime": 1551814510.730453,
"tracking": {
"frequency": -6.185,
"last_offset": -3.315e-06,
"leap_status": "normal",
"ref_time_utc": 1551814508.1982567,
"reference_id": "70747000",
"remote_host": "ptp",
"residual_frequency": -0.019,
"rms_offset": 4.133e-06,
"root_delay": 1e-09,
"root_dispersion": 0.000128737,
"skew": 1.14,
"stratum": 1,
"system_time_offset": 4.976e-06,
"update_interval": 2
}
}
- >json float monotonic
Monotonic time of operating system. This timestamp never counts backwards and is the time since boot in seconds.
- >json float realtime
Time in seconds since the Unix epoch, should match wall time if synchronized with external time source.
- >json object tracking
Operating system time synchronization tracking status. See chronyc tracking documentation for more information.
- statuscode 200
No error
System
tracking
fields of interest:- rms_offset
Long-term average of the offset value.
- system_time_offset
Time delta (in seconds) between the estimate of the operating system time and the current true time.
- last_offset
Estimated local offset on the last clock update.
- ref_time_utc
UTC Time at which the last measurement from the reference source was processed.
- remote_host
This is either
ptp
if the system is synchronizing to a PTP time source or the address of a remote NTP server the system has selected if the sensor is connected to the Internet.
GET /api/v1/time/ptp
-
GET
192.0.2.123/api/v1/time/ptp
Get the status of the PTP time synchronization daemon.
Note
See the IEEE 1588-2008 standard for more details on the standard management messages.
http
GET /api/v1/time/ptp HTTP/1.1
Host: 192.0.2.123
curl
curl -i http://192.0.2.123/api/v1/time/ptp
httpie
http http://192.0.2.123/api/v1/time/ptp
python-requests
requests.get('http://192.0.2.123/api/v1/time/ptp')
response
HTTP/1.1 200 OK
content-type: application/json; charset=UTF-8
{
"current_data_set": {
"mean_path_delay": 30110,
"offset_from_master": 224159,
"steps_removed": 1
},
"parent_data_set": {
"gm_clock_accuracy": 33,
"gm_clock_class": 6,
"gm_offset_scaled_log_variance": 20061,
"grandmaster_identity": "001747.fffe.700038",
"grandmaster_priority1": 128,
"grandmaster_priority2": 128,
"observed_parent_clock_phase_change_rate": 2147483647,
"observed_parent_offset_scaled_log_variance": 65535,
"parent_port_identity": "001747.fffe.700038-1",
"parent_stats": 0
},
"port_data_set": {
"announce_receipt_timeout": 3,
"delay_mechanism": 1,
"log_announce_interval": 1,
"log_min_delay_req_interval": 0,
"log_min_pdelay_req_interval": 0,
"log_sync_interval": 0,
"peer_mean_path_delay": 0,
"port_identity": "bc0fa7.fffe.00012c-1",
"port_state": "SLAVE",
"version_number": 2
},
"time_properties_data_set": {
"current_utc_offset": 37,
"current_utc_offset_valid": 1,
"frequency_traceable": 1,
"leap59": 0,
"leap61": 0,
"ptp_timescale": 1,
"time_source": 32,
"time_traceable": 1
},
"time_status_np": {
"cumulative_scaled_rate_offset": 0,
"gm_identity": "001747.fffe.700038",
"gm_present": true,
"gm_time_base_indicator": 0,
"ingress_time": 1551814546772493800,
"last_gm_phase_change": "0x0000'0000000000000000.0000",
"master_offset": 224159,
"scaled_last_gm_phase_change": 0
}
}
- >json object current_data_set
Result of the PMC
GET CURRENT_DATA_SET
command.- >json object parent_data_set
Result of the PMC
GET PARENT_DATA_SET
command.- >json object port_data_set
Result of the PMC
GET PORT_DATA_SET
command.- >json object time_properties_data_set
Result of the PMC
GET TIME_PROPERTIES_DATA_SET
command.- >json object time_status_np
Result of the PMC
GET TIME_STATUS_NP
command. This is a linuxptp non-portable command.- statuscode 200
No error
Fields of interest:
- current_data_set.offset_from_master
Offset from master time source in nanoseconds as calculated during the last update from master.
- parent_data_set.grandmaster_identity
This should match the local grandmaster clock. If this displays the sensor’s clock identity (derived from Ethernet hardware address) then this indicates the sensor is not properly synchronized to a grandmaster.
- parent_data_set
Various information about the selected master clock.
- port_data_set.port_state
This value will be
SLAVE
when a remote master clock is selected. Seeparent_data_set
for selected master clock.- port_data_set
Local sensor PTP configuration values. Grandmaster clock needs to match these for proper time synchronization.
- time_properties_data_set
PTP properties as given by master clock.
- time_status_np.gm_identity
Selected grandmaster clock identity.
- time_status_np.gm_present
True when grandmaster has been detected. This may stay true even if grandmaster goes off-line. Use
port_data_set.port_state
to determine up-to-date synchronization status. When this is false then the local clock is selected.- time_status_np.ingress_time
Indicates when the last PTP message was received. Units are in nanoseconds.
- time_status_np
Linux PTP specific diagnostic values. The Red Hat manual provides some more information on these fields
GET /api/v1/time/ptp/profile
-
GET
192.0.2.123/api/v1/time/ptp/profile
Get the active PTP profile of the Ouster sensor
http
GET /api/v1/time/ptp/profile HTTP/1.1
Content-Type: application/json
Host: 192.0.2.123
curl
curl -i http://nohost/api/v1/time/ptp/profile
httpie
http http://nohost/api/v1/time/ptp/profile
python-requests
requests.get('http://nohost/api/v1/time/ptp/profile')
response
HTTP/1.1 200 OK
content-length: 9
content-type: application/json; charset=UTF-8
"gptp"
- >json string
Active PTP profile.
- statuscode 200
No error
PUT /api/v1/time/ptp/profile
-
PUT
192.0.2.123/api/v1/time/ptp/profile
Change the PTP profile of the Ouster sensor
http
PUT /api/v1/time/ptp/profile HTTP/1.1
Content-Type: application/json
Host: 192.0.2.123
"gptp"
curl
curl -i -X PUT http://nohost/api/v1/time/ptp/profile --data-raw '"gptp"'
httpie
echo '"gptp"' | http PUT http://nohost/api/v1/time/ptp/profile
python-requests
requests.put('http://nohost/api/v1/time/ptp/profile', data='"gptp"')
response
HTTP/1.1 200 OK
content-length: 9
content-type: application/json; charset=UTF-8
"gptp"
- <json string
PTP profile to be activated, valid options are
"default"
,"gptp"
, and"automotive-slave"
- >json string
Active PTP profile.
- statuscode 200
No error
Alerts, Diagnostics and Telemetry
GET /api/v1/sensor/alerts
-
GET
169.254.198.184/api/v1/sensor/alerts
Get the sensor lidar intrinsics
http
GET /api/v1/sensor/alerts HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-length: 3941
content-type: application/json
{
"active": [
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 8,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "1309574110356"
}
],
"log": [
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 0,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "87914851559"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 1,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Failed to send lidar UDP data to destination host 169.254.28.205:7502",
"realtime": "88906828916"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 2,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "171640501848"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 3,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor matches
client IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "171640962692"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 4,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "188178225997"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 5,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Failed to send lidar UDP data to destination host 169.254.28.205:7502",
"realtime": "189169539737"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 6,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "1293004145514"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 7,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "1293004551057"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 8,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "1309574110356"
}
],
"next_cursor": 9
}
curl
curl -i http://169.254.198.184/api/v1/sensor/alerts --data-raw 'HTTP/1.1 200 OK
content-length: 3941
content-type: application/json
{
"active": [
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 8,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "1309574110356"
}
],
"log": [
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 0,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "87914851559"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 1,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Failed to send lidar UDP data to destination host 169.254.28.205:7502",
"realtime": "88906828916"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 2,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "171640501848"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 3,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor matches
client IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "171640962692"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 4,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "188178225997"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 5,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Failed to send lidar UDP data to destination host 169.254.28.205:7502",
"realtime": "189169539737"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 6,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "1293004145514"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 7,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "1293004551057"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 8,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "1309574110356"
}
],
"next_cursor": 9
}'
httpie
echo 'HTTP/1.1 200 OK
content-length: 3941
content-type: application/json
{
"active": [
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 8,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "1309574110356"
}
],
"log": [
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 0,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "87914851559"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 1,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Failed to send lidar UDP data to destination host 169.254.28.205:7502",
"realtime": "88906828916"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 2,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "171640501848"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 3,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor matches
client IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "171640962692"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 4,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "188178225997"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 5,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Failed to send lidar UDP data to destination host 169.254.28.205:7502",
"realtime": "189169539737"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 6,
"id": "0x01000015",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided lidar data port;
check that udp_dest and udp_port_lidar configured on the sensor matches client
IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "1293004145514"
},
{
"active": false,
"category": "UDP_TRANSMISSION",
"cursor": 7,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Cleared by reinitialization.",
"realtime": "1293004551057"
},
{
"active": true,
"category": "UDP_TRANSMISSION",
"cursor": 8,
"id": "0x01000018",
"level": "WARNING",
"msg": "Client machine announced it is not reachable on the provided not reachable on
IMU data port; check that udp_dest and udp_port_imu configured on the sensor
matches client IP and port.",
"msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",
"realtime": "1309574110356"
}
],
"next_cursor": 9
}' | http http://169.254.198.184/api/v1/sensor/alerts
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/alerts', data='HTTP/1.1 200 OK\r\n\ncontent-length: 3941\r\n\ncontent-type: application/json\r\n\n\r\n\n {\r\n\n "active": [\r\n\n {\r\n\n "active": true,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 8,\r\n\n "id": "0x01000018",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided not reachable on\r\n\n IMU data port; check that udp_dest and udp_port_imu configured on the sensor\r\n\n matches client IP and port.",\r\n\n "msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",\r\n\n "realtime": "1309574110356"\r\n\n }\r\n\n ],\r\n\n "log": [\r\n\n {\r\n\n "active": true,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 0,\r\n\n "id": "0x01000018",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided not reachable on\r\n\n IMU data port; check that udp_dest and udp_port_imu configured on the sensor\r\n\n matches client IP and port.",\r\n\n "msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",\r\n\n "realtime": "87914851559"\r\n\n },\r\n\n {\r\n\n "active": true,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 1,\r\n\n "id": "0x01000015",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided lidar data port;\r\n\n check that udp_dest and udp_port_lidar configured on the sensor matches client\r\n\n IP and port.",\r\n\n "msg_verbose": "Failed to send lidar UDP data to destination host 169.254.28.205:7502",\r\n\n "realtime": "88906828916"\r\n\n },\r\n\n {\r\n\n "active": false,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 2,\r\n\n "id": "0x01000015",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided lidar data port;\r\n\n check that udp_dest and udp_port_lidar configured on the sensor matches client\r\n\n IP and port.",\r\n\n "msg_verbose": "Cleared by reinitialization.",\r\n\n "realtime": "171640501848"\r\n\n },\r\n\n {\r\n\n "active": false,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 3,\r\n\n "id": "0x01000018",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided not reachable on\r\n\n IMU data port; check that udp_dest and udp_port_imu configured on the sensor matches\r\n\n client IP and port.",\r\n\n "msg_verbose": "Cleared by reinitialization.",\r\n\n "realtime": "171640962692"\r\n\n },\r\n\n {\r\n\n "active": true,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 4,\r\n\n "id": "0x01000018",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided not reachable on\r\n\n IMU data port; check that udp_dest and udp_port_imu configured on the sensor\r\n\n matches client IP and port.",\r\n\n "msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",\r\n\n "realtime": "188178225997"\r\n\n },\r\n\n {\r\n\n "active": true,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 5,\r\n\n "id": "0x01000015",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided lidar data port;\r\n\n check that udp_dest and udp_port_lidar configured on the sensor matches client\r\n\n IP and port.",\r\n\n "msg_verbose": "Failed to send lidar UDP data to destination host 169.254.28.205:7502",\r\n\n "realtime": "189169539737"\r\n\n },\r\n\n {\r\n\n "active": false,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 6,\r\n\n "id": "0x01000015",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided lidar data port;\r\n\n check that udp_dest and udp_port_lidar configured on the sensor matches client\r\n\n IP and port.",\r\n\n "msg_verbose": "Cleared by reinitialization.",\r\n\n "realtime": "1293004145514"\r\n\n },\r\n\n {\r\n\n "active": false,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 7,\r\n\n "id": "0x01000018",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided not reachable on\r\n\n IMU data port; check that udp_dest and udp_port_imu configured on the sensor\r\n\n matches client IP and port.",\r\n\n "msg_verbose": "Cleared by reinitialization.",\r\n\n "realtime": "1293004551057"\r\n\n },\r\n\n {\r\n\n "active": true,\r\n\n "category": "UDP_TRANSMISSION",\r\n\n "cursor": 8,\r\n\n "id": "0x01000018",\r\n\n "level": "WARNING",\r\n\n "msg": "Client machine announced it is not reachable on the provided not reachable on\r\n\n IMU data port; check that udp_dest and udp_port_imu configured on the sensor\r\n\n matches client IP and port.",\r\n\n "msg_verbose": "Failed to send imu UDP data to destination host 169.254.28.205:7503",\r\n\n "realtime": "1309574110356"\r\n\n }\r\n\n ],\r\n\n "next_cursor": 9\r\n\n }')
- status code 200
No error
- Description
Returns JSON-formatted sensor diagnostic information. - The
log
list contains alerts when they were activated or deactivated. An optionalSTART_CURSOR
argument specifies where the log should start. - Theactive
list contains all currently active alerts.
GET /api/v1/diagnostics/dump
-
GET
192.0.2.123/api/v1/diagnostics/dump
Get the diagnostics files of the sensor
http
GET /api/v1/diagnostics/dump HTTP/1.1
Host: 192.0.2.123
curl
curl -i http://192.0.2.123/api/v1/diagnostics/dump
httpie
http http://192.0.2.123/api/v1/diagnostics/dump
python-requests
requests.get('http://192.0.2.123/api/v1/diagnostics/dump')
response
HTTP/1.1 200 OK
content-disposition: attachment; filename="192.0.2.123_diagnostics-dump_29811b9e-2afc-11eb-ae01-bc0fa700190c.bin"
content-type: application/octet-stream
{binary data}
- statuscode 200
No error
GET /api/v1/sensor/telemetry
-
GET
169.254.198.184/api/v1/sensor/telemetry
Get the sensor telemetry information
http
GET /api/v1/sensor/telemetry HTTP/1.1
Host: 169.254.198.184
HTTP/1.1 200 OK
content-length: 150
content-type: application/json
{
"input_current_ma": 758,
"input_voltage_mv": 23606,
"internal_temperature_deg_c": 45,
"phase_lock_status": "DISABLED",
"timestamp_ns": 2962666299310
}
curl
curl -i http://169.254.198.184/api/v1/sensor/telemetry --data-raw 'HTTP/1.1 200 OK
content-length: 150
content-type: application/json
{
"input_current_ma": 758,
"input_voltage_mv": 23606,
"internal_temperature_deg_c": 45,
"phase_lock_status": "DISABLED",
"timestamp_ns": 2962666299310
}'
httpie
echo 'HTTP/1.1 200 OK
content-length: 150
content-type: application/json
{
"input_current_ma": 758,
"input_voltage_mv": 23606,
"internal_temperature_deg_c": 45,
"phase_lock_status": "DISABLED",
"timestamp_ns": 2962666299310
}' | http http://169.254.198.184/api/v1/sensor/telemetry
python-requests
requests.get('http://169.254.198.184/api/v1/sensor/telemetry', data='HTTP/1.1 200 OK\r\n\ncontent-length: 150\r\n\ncontent-type: application/json\r\n\n\r\n\n {\r\n\n "input_current_ma": 758,\r\n\n "input_voltage_mv": 23606,\r\n\n "internal_temperature_deg_c": 45,\r\n\n "phase_lock_status": "DISABLED",\r\n\n "timestamp_ns": 2962666299310\r\n\n }')
- status code 200
No error
- Description
Returns JSON-formatted response that provides sensor system state information. This includes the FPGA Timestamp in
ns
(Nanoseconds) at which the information was collected from the FPGA, Lidar Input Voltage inmv
(Millivolt), Lidar Input Current inma
(Milliamp), Internal Temperature of the sensor inºC
(Degree Celsius) and Phase Lock status namelyLOCKED
,LOST
,DISABLED
..
Note
Internal temperature can only be measured with Rev 06 and above sensors.
Note
Phase lock output will not indicate loss of lock if the PTP source is lost.