queryMissionStatusMessage.h

/*****************************************************************************
 *  Copyright (c) 2008, University of Florida
 *  All rights reserved.
 *  
 *  This file is part of OpenJAUS.  OpenJAUS is distributed under the BSD 
 *  license.  See the LICENSE file for details.
 * 
 *  Redistribution and use in source and binary forms, with or without 
 *  modification, are permitted provided that the following conditions 
 *  are met:
 *
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above
 *       copyright notice, this list of conditions and the following
 *       disclaimer in the documentation and/or other materials provided
 *       with the distribution.
 *     * Neither the name of the University of Florida nor the names of its 
 *       contributors may be used to endorse or promote products derived from 
 *       this software without specific prior written permission.
 *
 *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
 *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
 *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 
 *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
 *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
 *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 
 *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 
 *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
 *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ****************************************************************************/
// File Name: queryMissionStatusMessage.h
//
// Written By: Danny Kent (jaus AT dannykent DOT com), Tom Galluzzo 
//
// Version: 3.3.0a
//
// Date: 08/07/08
//
// Description: This file defines the attributes of a QueryMissionStatusMessage
//
// Modified by: David M. Plasil (MountainTop Technology, Inc) to add Planner
//              messages to OpenJAUS: 6/09/08

#ifndef QUERY_MISSION_STATUS_MESSAGE_H
#define QUERY_MISSION_STATUS_MESSAGE_H

#include "jaus.h"

// PV as defined in v3.3
#ifndef JAUS_QUERY_MISSION_STATUS_PV
#define JAUS_QUERY_MISSION_STATUS_PV
#define JAUS_QUERY_MISSION_STATUS_PV_MISSIN_ID_BIT  0 // Field 3
#define JAUS_QUERY_MISSION_STATUS_PV_TASK_ID_BIT    1 // Field 4
#define JAUS_QUERY_MISSION_STATUS_PV_UID_BIT        2 // Field 5
#endif

typedef struct
{
  // Include all parameters from a JausMessage structure:
  // Header Properties
  struct
  {
    // Properties by bit fields
    #ifdef JAUS_BIG_ENDIAN
      JausUnsignedShort reserved:2;
      JausUnsignedShort version:6;
      JausUnsignedShort expFlag:1;
      JausUnsignedShort scFlag:1;
      JausUnsignedShort ackNak:2;
      JausUnsignedShort priority:4; 
    #elif JAUS_LITTLE_ENDIAN
      JausUnsignedShort priority:4; 
      JausUnsignedShort ackNak:2;
      JausUnsignedShort scFlag:1; 
      JausUnsignedShort expFlag:1;
      JausUnsignedShort version:6; 
      JausUnsignedShort reserved:2;
    #else
      #error "Please define system endianess (see jaus.h)"
    #endif
  }properties;

  JausUnsignedShort commandCode; 

  JausAddress destination;

  JausAddress source;

  JausUnsignedInteger dataSize;

  JausUnsignedInteger dataFlag;
  
  JausUnsignedShort sequenceNumber;

  // MESSAGE DATA MEMBERS
  JausByte presenceVector;      //Presence Vector
  JausByte type;                //see MISSION_TYPES
  JausUnsignedShort missionId;  //unique Mission ID to be aborted
  JausUnsignedShort taskId;     //unique Task ID to be reported.  If type = 0
                                //then taskId = 0.
  JausUnsignedShort taskMsgId;  //unique message ID in Task
  
}QueryMissionStatusMessageStruct;

typedef QueryMissionStatusMessageStruct* QueryMissionStatusMessage;

JAUS_EXPORT QueryMissionStatusMessage queryMissionStatusMessageCreate(void);
JAUS_EXPORT void queryMissionStatusMessageDestroy(QueryMissionStatusMessage);

JAUS_EXPORT JausBoolean queryMissionStatusMessageFromBuffer
                                          (QueryMissionStatusMessage message,
                                           unsigned char* buffer,
                                           unsigned int bufferSizeBytes);
JAUS_EXPORT JausBoolean queryMissionStatusMessageToBuffer
                                          (QueryMissionStatusMessage message,
                                           unsigned char *buffer,
                                           unsigned int bufferSizeBytes);

JAUS_EXPORT QueryMissionStatusMessage queryMissionStatusMessageFromJausMessage
                                          (JausMessage jausMessage);
JAUS_EXPORT JausMessage queryMissionStatusMessageToJausMessage
                                          (QueryMissionStatusMessage message);

JAUS_EXPORT unsigned int queryMissionStatusMessageSize
                                          (QueryMissionStatusMessage message);

#endif // QUERY_MISSION_STATUS_MESSAGE_H