MIP_SDK  v3.0.0
MicroStrain Communications Library for embedded systems
Classes | Typedefs | Enumerations | Functions
(0x0C,0x21) Constellation Settings

This command configures which satellite constellations are enabled and how many channels are dedicated to tracking each constellation. More...

Classes

struct  mip::C::mip_3dm_constellation_settings_command_settings
 
struct  mip::C::mip_3dm_constellation_settings_command
 
struct  mip::C::mip_3dm_constellation_settings_response
 

Typedefs

typedef enum mip_3dm_constellation_settings_command_constellation_id mip::C::mip_3dm_constellation_settings_command_constellation_id
 
typedef uint16_t mip::C::mip_3dm_constellation_settings_command_option_flags
 
typedef struct mip_3dm_constellation_settings_command_settings mip::C::mip_3dm_constellation_settings_command_settings
 
typedef struct mip_3dm_constellation_settings_command mip::C::mip_3dm_constellation_settings_command
 
typedef struct mip_3dm_constellation_settings_response mip::C::mip_3dm_constellation_settings_response
 

Enumerations

enum  mip::C::mip_3dm_constellation_settings_command_constellation_id {
  mip::C::MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_GPS = 0, mip::C::MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_SBAS = 1, mip::C::MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_GALILEO = 2, mip::C::MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_BEIDOU = 3,
  mip::C::MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_QZSS = 5, mip::C::MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_GLONASS = 6
}
 

Functions

void mip::C::insert_mip_3dm_constellation_settings_command_settings (microstrain_serializer *serializer, const mip_3dm_constellation_settings_command_settings *self)
 
void mip::C::extract_mip_3dm_constellation_settings_command_settings (microstrain_serializer *serializer, mip_3dm_constellation_settings_command_settings *self)
 
void mip::C::insert_mip_3dm_constellation_settings_command (microstrain_serializer *serializer, const mip_3dm_constellation_settings_command *self)
 
void mip::C::extract_mip_3dm_constellation_settings_command (microstrain_serializer *serializer, mip_3dm_constellation_settings_command *self)
 
void mip::C::insert_mip_3dm_constellation_settings_response (microstrain_serializer *serializer, const mip_3dm_constellation_settings_response *self)
 
void mip::C::extract_mip_3dm_constellation_settings_response (microstrain_serializer *serializer, mip_3dm_constellation_settings_response *self)
 
mip_cmd_result mip::C::mip_3dm_write_constellation_settings (mip_interface *device, uint16_t max_channels, uint8_t config_count, const mip_3dm_constellation_settings_command_settings *settings)
 
mip_cmd_result mip::C::mip_3dm_read_constellation_settings (mip_interface *device, uint16_t *max_channels_available_out, uint16_t *max_channels_use_out, uint8_t *config_count_out, uint8_t config_count_out_max, mip_3dm_constellation_settings_command_settings *settings_out)
 
mip_cmd_result mip::C::mip_3dm_save_constellation_settings (mip_interface *device)
 
mip_cmd_result mip::C::mip_3dm_load_constellation_settings (mip_interface *device)
 
mip_cmd_result mip::C::mip_3dm_default_constellation_settings (mip_interface *device)
 

Detailed Description

This command configures which satellite constellations are enabled and how many channels are dedicated to tracking each constellation.

Maximum number of tracking channels to use (total for all constellations): 0 to max_channels_available (from reply message)

For each constellation you wish to use, include a ConstellationSettings struct. Note the following:

Total number of tracking channels (sum of "reserved_channels" for all constellations) must be <= 32: 0 -> 32 Number of reserved channels 0 -> 32 Max number of channels (>= reserved channels)

The factory default setting is: GPS and GLONASS enabled. Min/Max for GPS = 8/16, GLONASS = 8/14, SBAS = 1/3, QZSS = 0/3.

Warning: SBAS functionality shall not be used in "safety of life" applications! Warning: Any setting that causes the total reserved channels to exceed 32 will result in a NACK. Warning: You cannot enable GLONASS and BeiDou at the same time. Note: Enabling SBAS and QZSS augments GPS accuracy. Note: It is recommended to disable GLONASS and BeiDou if a GPS-only antenna or GPS-only SAW filter is used.

Typedef Documentation

◆ mip_3dm_constellation_settings_command

◆ mip_3dm_constellation_settings_command_constellation_id

◆ mip_3dm_constellation_settings_command_option_flags

◆ mip_3dm_constellation_settings_command_settings

◆ mip_3dm_constellation_settings_response

Enumeration Type Documentation

◆ mip_3dm_constellation_settings_command_constellation_id

Enumerator
MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_GPS 

GPS (G1-G32)

MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_SBAS 

SBAS (S120-S158)

MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_GALILEO 

GALILEO (E1-E36)

MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_BEIDOU 

BeiDou (B1-B37)

MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_QZSS 

QZSS (Q1-Q5)

MIP_3DM_CONSTELLATION_SETTINGS_COMMAND_CONSTELLATION_ID_GLONASS 

GLONASS (R1-R32)

Function Documentation

◆ extract_mip_3dm_constellation_settings_command()

void mip::C::extract_mip_3dm_constellation_settings_command ( microstrain_serializer serializer,
mip_3dm_constellation_settings_command self 
)

◆ extract_mip_3dm_constellation_settings_command_settings()

void mip::C::extract_mip_3dm_constellation_settings_command_settings ( microstrain_serializer serializer,
mip_3dm_constellation_settings_command_settings self 
)

◆ extract_mip_3dm_constellation_settings_response()

void mip::C::extract_mip_3dm_constellation_settings_response ( microstrain_serializer serializer,
mip_3dm_constellation_settings_response self 
)

◆ insert_mip_3dm_constellation_settings_command()

void mip::C::insert_mip_3dm_constellation_settings_command ( microstrain_serializer serializer,
const mip_3dm_constellation_settings_command self 
)

◆ insert_mip_3dm_constellation_settings_command_settings()

void mip::C::insert_mip_3dm_constellation_settings_command_settings ( microstrain_serializer serializer,
const mip_3dm_constellation_settings_command_settings self 
)

◆ insert_mip_3dm_constellation_settings_response()

void mip::C::insert_mip_3dm_constellation_settings_response ( microstrain_serializer serializer,
const mip_3dm_constellation_settings_response self 
)

◆ mip_3dm_default_constellation_settings()

mip_cmd_result mip::C::mip_3dm_default_constellation_settings ( mip_interface device)

◆ mip_3dm_load_constellation_settings()

mip_cmd_result mip::C::mip_3dm_load_constellation_settings ( mip_interface device)

◆ mip_3dm_read_constellation_settings()

mip_cmd_result mip::C::mip_3dm_read_constellation_settings ( mip_interface device,
uint16_t *  max_channels_available_out,
uint16_t *  max_channels_use_out,
uint8_t *  config_count_out,
uint8_t  config_count_out_max,
mip_3dm_constellation_settings_command_settings settings_out 
)

◆ mip_3dm_save_constellation_settings()

mip_cmd_result mip::C::mip_3dm_save_constellation_settings ( mip_interface device)

◆ mip_3dm_write_constellation_settings()

mip_cmd_result mip::C::mip_3dm_write_constellation_settings ( mip_interface device,
uint16_t  max_channels,
uint8_t  config_count,
const mip_3dm_constellation_settings_command_settings settings 
)