docs: update ackermann sih (#25418)

* docs: update ackermann sih

* Update metadata to fix broken link

---------

Co-authored-by: Hamish Willee <hamishwillee@gmail.com>
This commit is contained in:
chfriedrich98
2025-08-14 11:03:07 +10:00
committed by GitHub
co-authored by Hamish Willee
parent 2333fb2853
commit 72796a9844
6 changed files with 373 additions and 13 deletions
+353 -4
View File
@@ -14274,14 +14274,14 @@ True airspeed measurement noise of the internal wind estimator(s) of the airspee
### ASPD_WERR_THR (`FLOAT`) {#ASPD_WERR_THR}
Horizontal wind uncertainty threshold for synthetic airspeed.
Horizontal wind uncertainty threshold for valid ground-minus-wind.
The synthetic airspeed estimate (from groundspeed and heading) will be declared valid
The airspeed alternative derived from groundspeed and heading will be declared valid
as soon and as long the horizontal wind uncertainty is below this value.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | 0.001 | 5 | | 0.55 | m/s |
| &nbsp; | 0.01 | 5 | | 2. | m/s |
### ASPD_WIND_NSD (`FLOAT`) {#ASPD_WIND_NSD}
@@ -17403,10 +17403,11 @@ Each threshold value is defined by the parameter indicated next to the check. Dr
- `7`: Horizontal speed offset (EKF2_REQ_HDRIFT)
- `8`: Vertical speed offset (EKF2_REQ_VDRIFT)
- `9`: Spoofing
- `10`: GPS fix type (EKF2_REQ_FIX)
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | 0 | 1023 | | 1023 |
| &nbsp; | 0 | 2047 | | 2047 |
### EKF2_GPS_CTRL (`INT32`) {#EKF2_GPS_CTRL}
@@ -18015,6 +18016,26 @@ Required EPV to use GPS.
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | 2 | 100 | | 5.0 | m |
### EKF2_REQ_FIX (`INT32`) {#EKF2_REQ_FIX}
Required GPS fix.
Minimum GPS fix type required for GPS usage.
**Values:**
- `0`: No fix required
- `2`: 2D fix
- `3`: 3D fix
- `4`: RTCM code differential
- `5`: RTK float
- `6`: RTK fixed
- `8`: Extrapolated
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 3 |
### EKF2_REQ_GPS_H (`FLOAT`) {#EKF2_REQ_GPS_H}
Required GPS health time on startup.
@@ -32577,6 +32598,334 @@ INA238 Power Monitor Shunt.
| ------- | ----------- | -------- | ---------- | ------- | ---- |
| &check; | 0.000000001 | 0.1 | .000000001 | 0.0005 |
### MS_ACCEL_RANGE (`INT32`) {#MS_ACCEL_RANGE}
Sets the range of the accelerometer.
-1 = Will not be configured, and will use the device default range,
Each adjustable range has a corresponding integer setting. Refer to the device's User Manual to check the available adjustment ranges.
https://www.hbkworld.com/en/products/transducers/inertial-sensors#!ref_microstrain.com
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | -1 |
### MS_ALIGNMENT (`INT32`) {#MS_ALIGNMENT}
Alignment type.
Select the source of heading alignment
This is a bitfield, you can use more than 1 source
Bit 0 - Dual-antenna GNSS
Bit 1 - GNSS kinematic (requires motion, e.g. a GNSS velocity)
Bit 2 - Magnetometer
Bit 3 - External Heading (first valid external heading will be used to initialize the filter)
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 2 |
### MS_BARO_RATE_HZ (`INT32`) {#MS_BARO_RATE_HZ}
Barometer data rate.
Barometer data rate
Max Limit: 1000
0 - Disable barometer datastream
The max limit should be divisible by the rate
eg: 1000 % MS_BARO_RATE_HZ = 0
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 50 |
### MS_EXT_HEAD_EN (`INT32`) {#MS_EXT_HEAD_EN}
Toggles external heading as an aiding measurement.
0 = Disabled,
1 = Enabled
If enabled, the filter will be configured to accept external heading as an aiding meaurement.
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0 |
### MS_FILT_RATE_HZ (`INT32`) {#MS_FILT_RATE_HZ}
EKF data Rate.
EKF data rate
Max Limit: 1000
0 - Disable EKF datastream
The max limit should be divisible by the rate
eg: 1000 % MS_FILT_RATE_HZ = 0
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 250 |
### MS_GNSS_AID_SRC (`INT32`) {#MS_GNSS_AID_SRC}
GNSS aiding source control.
Select the source of gnss aiding (GNSS/INS)
1 = All internal receivers,
2 = External GNSS messages,
3 = GNSS receiver 1 only
4 = GNSS receiver 2 only
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 1 |
### MS_GNSS_OFF1_X (`FLOAT`) {#MS_GNSS_OFF1_X}
GNSS lever arm offset 1 (X).
Lever arm offset (m) in the X direction for the external GNSS receiver
In the case of a dual antenna setup, this is antenna 1
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_GNSS_OFF1_Y (`FLOAT`) {#MS_GNSS_OFF1_Y}
GNSS lever arm offset 1 (Y).
Lever arm offset (m) in the Y direction for the external GNSS receiver
In the case of a dual antenna setup, this is antenna 1
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_GNSS_OFF1_Z (`FLOAT`) {#MS_GNSS_OFF1_Z}
GNSS lever arm offset 1 (Z).
Lever arm offset (m) in the Z direction for the external GNSS receiver
In the case of a dual antenna setup, this is antenna 1
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_GNSS_OFF2_X (`FLOAT`) {#MS_GNSS_OFF2_X}
GNSS lever arm offset 2 (X).
Lever arm offset (m) in the X direction for antenna 2
This will only be used if the device supports a dual antenna setup
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_GNSS_OFF2_Y (`FLOAT`) {#MS_GNSS_OFF2_Y}
GNSS lever arm offset 2 (Y).
Lever arm offset (m) in the Y direction for antenna 2
This will only be used if the device supports a dual antenna setup
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_GNSS_OFF2_Z (`FLOAT`) {#MS_GNSS_OFF2_Z}
GNSS lever arm offset 2 (Z).
Lever arm offset (m) in the X direction for antenna 2
This will only be used if the device supports a dual antenna setup
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_GNSS_RATE_HZ (`INT32`) {#MS_GNSS_RATE_HZ}
GNSS data Rate.
GNSS receiver 1 and 2 data rate
Max Limit: 5
The max limit should be divisible by the rate
0 - Disable GNSS datastream
eg: 5 % MS_GNSS_RATE_HZ = 0
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 5 |
### MS_GYRO_RANGE (`INT32`) {#MS_GYRO_RANGE}
Sets the range of the gyro.
-1 = Will not be configured, and will use the device default range,
Each adjustable range has a corresponding integer setting. Refer to the device's User Manual to check the available adjustment ranges.
https://www.hbkworld.com/en/products/transducers/inertial-sensors#!ref_microstrain.com
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | -1 |
### MS_IMU_RATE_HZ (`INT32`) {#MS_IMU_RATE_HZ}
IMU Data Rate.
IMU (Accelerometer and Gyroscope) data rate
The INS driver will be scheduled at a rate 2\*MS_IMU_RATE_HZ
Max Limit: 1000
0 - Disable IMU datastream
The max limit should be divisible by the rate
eg: 1000 % MS_IMU_RATE_HZ = 0
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 500 |
### MS_INT_HEAD_EN (`INT32`) {#MS_INT_HEAD_EN}
Toggles internal heading as an aiding measurement.
0 = Disabled,
1 = Enabled
If dual antennas are supported (CV7-GNSS/INS). The filter will be configured to use dual antenna heading as an aiding measurement.
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0 |
### MS_INT_MAG_EN (`INT32`) {#MS_INT_MAG_EN}
Toggles internal magnetometer aiding in the device filter.
0 = Disabled,
1 = Enabled
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0 |
### MS_MAG_RATE_HZ (`INT32`) {#MS_MAG_RATE_HZ}
Magnetometer Data Rate.
Magnetometer data rate
Max Limit: 1000
0 - Disable magnetometer datastream
The max limit should be divisible by the rate
eg: 1000 % MS_MAG_RATE_HZ = 0
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 50 |
### MS_MODE (`INT32`) {#MS_MODE}
Toggles using the device as the primary EKF.
Setting to 1 will publish data from the device to the vehicle topics (global_position, attitude, local_position, odometry), estimator_status and sensor_selection
Setting to 0 will publish data from the device to the external_ins topics (global position, attitude, local position)
Restart Required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 1 |
### MS_SENSOR_PTCH (`FLOAT`) {#MS_SENSOR_PTCH}
Sensor to Vehicle Transform (Pitch).
The orientation of the device (Radians) with respect to the vehicle frame around the y axis
Requires MS_SVT_EN to be enabled to be used
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_SENSOR_ROLL (`FLOAT`) {#MS_SENSOR_ROLL}
Sensor to Vehicle Transform (Roll).
The orientation of the device (Radians) with respect to the vehicle frame around the x axis
Requires MS_SVT_EN to be enabled to be used
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_SENSOR_YAW (`FLOAT`) {#MS_SENSOR_YAW}
Sensor to Vehicle Transform (Yaw).
The orientation of the device (Radians) with respect to the vehicle frame around the z axis
Requires MS_SVT_EN to be enabled to be used
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0.0 |
### MS_SVT_EN (`INT32`) {#MS_SVT_EN}
Enables sensor to vehicle transform.
0 = Disabled,
1 = Enabled
If the sensor has a different orientation with respect to the vehicle. This will enable a transform to correct itself.
The transform is described by MS_SENSOR_ROLL, MS_SENSOR_PITCH, MS_SENSOR_YAW
Restart required
This parameter is specific to the MicroStrain driver.
| Reboot | minValue | maxValue | increment | default | unit |
| ------ | -------- | -------- | --------- | ------- | ---- |
| &nbsp; | | | | 0 |
### PCF8583_MAGNET (`INT32`) {#PCF8583_MAGNET}
PCF8583 rotorfreq (i2c) pulse count.