Module: dvGuidance

This module creates a time varying attitude reference frame message that allows the orbit correction burn direction to rotate at a constant rate.

A message is read in containing the base f$Deltamathbf{v}f$ direction, the burn duration, as well as a nominal rotation axis. A base burn frame is created relative to which a constant rotation about the 3rd frame axis is performed. The output message contains the full reference frame states including the constant angular velocity vector and a zero angular acceleration vector. More information can be found in the PDF Description.

Functions

void SelfInit_dvGuidance(dvGuidanceConfig *configData, int64_t moduleID)

This method initializes the configData for the nominal delta-V maneuver guidance. It checks to ensure that the inputs are sane and then creates the output message

Return

void

Parameters

  • configData: The configuration data associated with the delta-V maneuver guidance

  • moduleID: The unique module identifier

void CrossInit_dvGuidance(dvGuidanceConfig *configData, int64_t moduleID)

This method performs the second stage of initialization for the delta-V maneuver interface. It’s primary function is to link the input messages that were created elsewhere.

Return

void

Parameters

  • configData: The configuration data associated with the attitude maneuver guidance

  • moduleID: The unique module identifier

void Update_dvGuidance(dvGuidanceConfig *configData, uint64_t callTime, int64_t moduleID)

This method takes its own internal variables and creates an output attitude command to use for burn execution. It also flags whether the burn should be happening or not.

Return

void

Parameters

  • configData: The configuration data associated with the delta-V maneuver guidance

  • callTime: The clock time at which the function was called (nanoseconds)

  • moduleID: The unique module identifier

void Reset_dvGuidance(dvGuidanceConfig *configData, uint64_t callTime, int64_t moduleID)

This resets the module.

Return

void

Parameters

  • configData: The configuration data associated with this module

  • callTime: The clock time at which the function was called (nanoseconds)

  • moduleID: The unique module identifier

struct dvGuidanceConfig
#include <dvGuidance.h>

Top level structure for the nominal delta-V guidance.

Public Members

char outputDataName[MAX_STAT_MSG_LENGTH]

The name of the output message.

char inputBurnDataName[MAX_STAT_MSG_LENGTH]
int32_t outputMsgID

(-) ID for the outgoing body estimate message

int32_t inputBurnCmdID

[-] ID for the incoming burn command data

BSKLogger *bskLogger

BSK Logging.