##// END OF EJS Templates
Étiquette 3.2.0.22 ajoutée à la révision 9d5e16586c2c
Étiquette 3.2.0.22 ajoutée à la révision 9d5e16586c2c

File last commit:

r390:1c936ff95146 No PWD scrub with...
r401:e2418ff35b1b R3++
Show More
tc_acceptance.c
504 lines | 14.5 KiB | text/x-c | CLexer
Added GPL header and documented some more functions
r390 /*------------------------------------------------------------------------------
-- Solar Orbiter's Low Frequency Receiver Flight Software (LFR FSW),
-- This file is a part of the LFR FSW
-- Copyright (C) 2012-2018, Plasma Physics Laboratory - CNRS
--
-- This program is free software; you can redistribute it and/or modify
-- it under the terms of the GNU General Public License as published by
-- the Free Software Foundation; either version 2 of the License, or
-- (at your option) any later version.
--
-- This program is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-- GNU General Public License for more details.
--
-- You should have received a copy of the GNU General Public License
-- along with this program; if not, write to the Free Software
-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-------------------------------------------------------------------------------*/
/*-- Author : Paul Leroy
-- Contact : Alexis Jeandet
-- Mail : alexis.jeandet@lpp.polytechnique.fr
----------------------------------------------------------------------------*/
paul
Minor changes in .h inclusion
r45 /** Functions related to TeleCommand acceptance.
*
* @file
* @author P. LEROY
*
* A group of functions to handle TeleCommands parsing.\n
*
*/
#include "tc_acceptance.h"
paul
#427 corrected
r209 #include <stdio.h>
paul
Minor changes in .h inclusion
r45
paul
Bug #796 Don_Initialisation_P1
r321 unsigned int lookUpTableForCRC[CONST_256] = {0};
paul
Minor changes in .h inclusion
r45
//**********************
// GENERAL USE FUNCTIONS
unsigned int Crc_opt( unsigned char D, unsigned int Chk)
{
/** This function generate the CRC for one byte and returns the value of the new syndrome.
*
* @param D is the current byte of data.
* @param Chk is the current syndrom value.
paul
fsw-0-20...
r51 *
paul
Minor changes in .h inclusion
r45 * @return the value of the new syndrome on two bytes.
*
*/
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 return(((Chk << SHIFT_1_BYTE) & BYTE0_MASK)^lookUpTableForCRC [(((Chk >> SHIFT_1_BYTE)^D) & BYTE1_MASK)]);
paul
Minor changes in .h inclusion
r45 }
void initLookUpTableForCRC( void )
{
/** This function is used to initiates the look-up table for fast CRC computation.
*
* The global table lookUpTableForCRC[256] is initiated.
*
*/
unsigned int i;
unsigned int tmp;
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 for (i=0; i<CONST_256; i++)
paul
Minor changes in .h inclusion
r45 {
tmp = 0;
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if((i & BIT_0) != 0) {
tmp = tmp ^ CONST_CRC_0;
paul
Minor changes in .h inclusion
r45 }
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if((i & BIT_1) != 0) {
tmp = tmp ^ CONST_CRC_1;
paul
Minor changes in .h inclusion
r45 }
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if((i & BIT_2) != 0) {
tmp = tmp ^ CONST_CRC_2;
paul
Minor changes in .h inclusion
r45 }
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if((i & BIT_3) != 0) {
tmp = tmp ^ CONST_CRC_3;
paul
Minor changes in .h inclusion
r45 }
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if((i & BIT_4) != 0) {
tmp = tmp ^ CONST_CRC_4;
paul
Minor changes in .h inclusion
r45 }
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if((i & BIT_5) != 0) {
tmp = tmp ^ CONST_CRC_5;
paul
Minor changes in .h inclusion
r45 }
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if((i & BIT_6) != 0) {
tmp = tmp ^ CONST_CRC_6;
paul
Minor changes in .h inclusion
r45 }
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if((i & BIT_7) != 0) {
tmp = tmp ^ CONST_CRC_7;
paul
Minor changes in .h inclusion
r45 }
lookUpTableForCRC[i] = tmp;
}
}
void GetCRCAsTwoBytes(unsigned char* data, unsigned char* crcAsTwoBytes, unsigned int sizeOfData)
{
/** This function calculates a two bytes Cyclic Redundancy Code.
*
* @param data points to a buffer containing the data on which to compute the CRC.
* @param crcAsTwoBytes points points to a two bytes buffer in which the CRC is stored.
* @param sizeOfData is the number of bytes of *data* used to compute the CRC.
*
* The specification of the Cyclic Redundancy Code is described in the following document: ECSS-E-70-41-A.
*
*/
unsigned int Chk;
int j;
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 Chk = CRC_RESET; // reset the syndrom to all ones
paul
Minor changes in .h inclusion
r45 for (j=0; j<sizeOfData; j++) {
Chk = Crc_opt(data[j], Chk);
}
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 crcAsTwoBytes[0] = (unsigned char) (Chk >> SHIFT_1_BYTE);
crcAsTwoBytes[1] = (unsigned char) (Chk & BYTE1_MASK);
paul
Minor changes in .h inclusion
r45 }
//*********************
// ACCEPTANCE FUNCTIONS
paul
the interrupt sub routine related to the waveform picker is now lighter...
r112 int tc_parser(ccsdsTelecommandPacket_t * TCPacket, unsigned int estimatedPacketLength, unsigned char *computed_CRC)
paul
Minor changes in .h inclusion
r45 {
/** This function parses TeleCommands.
*
* @param TC points to the TeleCommand that will be parsed.
paul
the interrupt sub routine related to the waveform picker is now lighter...
r112 * @param estimatedPacketLength is the PACKET_LENGTH field calculated from the effective length of the received packet.
paul
Ignore doc files...
r46 *
paul
Minor changes in .h inclusion
r45 * @return Status code of the parsing.
*
* The parsing checks:
* - process id
* - category
* - length: a global check is performed and a per subtype check also
* - type
* - subtype
* - crc
*
*/
int status;
paul
Bug #596...
r68 int status_crc;
paul
Minor changes in .h inclusion
r45 unsigned char pid;
unsigned char category;
paul
the interrupt sub routine related to the waveform picker is now lighter...
r112 unsigned int packetLength;
paul
Minor changes in .h inclusion
r45 unsigned char packetType;
unsigned char packetSubtype;
paul
Ignore doc files...
r46 unsigned char sid;
paul
Minor changes in .h inclusion
r45
status = CCSDS_TM_VALID;
// APID check *** APID on 2 bytes
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 pid = ((TCPacket->packetID[0] & BITS_PID_0) << SHIFT_4_BITS)
+ ( (TCPacket->packetID[1] >> SHIFT_4_BITS) & BITS_PID_1 ); // PID = 11 *** 7 bits xxxxx210 7654xxxx
category = (TCPacket->packetID[1] & BITS_CAT); // PACKET_CATEGORY = 12 *** 4 bits xxxxxxxx xxxx3210
packetLength = (TCPacket->packetLength[0] * CONST_256) + TCPacket->packetLength[1];
paul
the interrupt sub routine related to the waveform picker is now lighter...
r112 packetType = TCPacket->serviceType;
packetSubtype = TCPacket->serviceSubType;
sid = TCPacket->sourceID;
paul
Minor changes in .h inclusion
r45
if ( pid != CCSDS_PROCESS_ID ) // CHECK THE PROCESS ID
{
status = ILLEGAL_APID;
}
if (status == CCSDS_TM_VALID) // CHECK THE CATEGORY
{
if ( category != CCSDS_PACKET_CATEGORY )
{
status = ILLEGAL_APID;
}
}
paul
the interrupt sub routine related to the waveform picker is now lighter...
r112 if (status == CCSDS_TM_VALID) // CHECK THE PACKET_LENGTH FIELD AND THE ESTIMATED PACKET_LENGTH COMPLIANCE
paul
Minor changes in .h inclusion
r45 {
paul
the interrupt sub routine related to the waveform picker is now lighter...
r112 if (packetLength != estimatedPacketLength ) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
}
if (status == CCSDS_TM_VALID) // CHECK THAT THE PACKET DOES NOT EXCEED THE MAX SIZE
{
paul
Bug #649 corrected, TC with Length > 228 are dropped by the driver, not parsed
r316 if ( packetLength > CCSDS_TC_PKT_MAX_SIZE ) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
}
if (status == CCSDS_TM_VALID) // CHECK THE TYPE
{
status = tc_check_type( packetType );
}
if (status == CCSDS_TM_VALID) // CHECK THE SUBTYPE
{
paul
rev 1.0.0.2...
r104 status = tc_check_type_subtype( packetType, packetSubtype );
paul
Minor changes in .h inclusion
r45 }
paul
Ignore doc files...
r46 if (status == CCSDS_TM_VALID) // CHECK THE SID
{
status = tc_check_sid( sid );
}
paul
Minor changes in .h inclusion
r45 if (status == CCSDS_TM_VALID) // CHECK THE SUBTYPE AND LENGTH COMPLIANCE
{
paul
the interrupt sub routine related to the waveform picker is now lighter...
r112 status = tc_check_length( packetSubtype, packetLength );
paul
Minor changes in .h inclusion
r45 }
paul
the interrupt sub routine related to the waveform picker is now lighter...
r112 status_crc = tc_check_crc( TCPacket, estimatedPacketLength, computed_CRC );
paul
Minor changes in .h inclusion
r45 if (status == CCSDS_TM_VALID ) // CHECK CRC
{
paul
Bug #596...
r68 status = status_crc;
paul
Minor changes in .h inclusion
r45 }
return status;
}
int tc_check_type( unsigned char packetType )
{
/** This function checks that the type of a TeleCommand is valid.
*
* @param packetType is the type to check.
paul
Ignore doc files...
r46 *
paul
Minor changes in .h inclusion
r45 * @return Status code CCSDS_TM_VALID or ILL_TYPE.
*
*/
int status;
paul
Bug #801 Don_Initialisation_P2
r320 status = ILL_TYPE;
paul
Minor changes in .h inclusion
r45 if ( (packetType == TC_TYPE_GEN) || (packetType == TC_TYPE_TIME))
{
status = CCSDS_TM_VALID;
}
else
{
status = ILL_TYPE;
}
return status;
}
paul
rev 1.0.0.2...
r104 int tc_check_type_subtype( unsigned char packetType, unsigned char packetSubType )
paul
Minor changes in .h inclusion
r45 {
paul
rev 1.0.0.2...
r104 /** This function checks that the subtype of a TeleCommand is valid and coherent with the type.
paul
Minor changes in .h inclusion
r45 *
paul
rev 1.0.0.2...
r104 * @param packetType is the type of the TC.
paul
Minor changes in .h inclusion
r45 * @param packetSubType is the subtype to check.
paul
Ignore doc files...
r46 *
paul
Minor changes in .h inclusion
r45 * @return Status code CCSDS_TM_VALID or ILL_SUBTYPE.
*
*/
int status;
paul
rev 1.0.0.2...
r104 switch(packetType)
paul
Minor changes in .h inclusion
r45 {
paul
rev 1.0.0.2...
r104 case TC_TYPE_GEN:
if ( (packetSubType == TC_SUBTYPE_RESET)
|| (packetSubType == TC_SUBTYPE_LOAD_COMM)
|| (packetSubType == TC_SUBTYPE_LOAD_NORM) || (packetSubType == TC_SUBTYPE_LOAD_BURST)
|| (packetSubType == TC_SUBTYPE_LOAD_SBM1) || (packetSubType == TC_SUBTYPE_LOAD_SBM2)
|| (packetSubType == TC_SUBTYPE_DUMP)
|| (packetSubType == TC_SUBTYPE_ENTER)
|| (packetSubType == TC_SUBTYPE_UPDT_INFO)
paul
TC_LFR_LOAD_KCOEFFICIENTS...
r194 || (packetSubType == TC_SUBTYPE_EN_CAL) || (packetSubType == TC_SUBTYPE_DIS_CAL)
|| (packetSubType == TC_SUBTYPE_LOAD_K) || (packetSubType == TC_SUBTYPE_DUMP_K)
paul
TC_LFR_LOAD_PAS_FILTER_PAR added to the authorized telecommands...
r282 || (packetSubType == TC_SUBTYPE_LOAD_FBINS)
paul
ICD 4.1 taken into account
r283 || (packetSubType == TC_SUBTYPE_LOAD_FILTER_PAR))
paul
rev 1.0.0.2...
r104 {
status = CCSDS_TM_VALID;
}
else
{
status = ILL_SUBTYPE;
}
break;
case TC_TYPE_TIME:
if (packetSubType == TC_SUBTYPE_UPDT_TIME)
{
status = CCSDS_TM_VALID;
}
else
{
status = ILL_SUBTYPE;
}
break;
default:
paul
fsw-0-20...
r51 status = ILL_SUBTYPE;
paul
rev 1.0.0.2...
r104 break;
paul
Minor changes in .h inclusion
r45 }
return status;
}
paul
Ignore doc files...
r46 int tc_check_sid( unsigned char sid )
{
/** This function checks that the sid of a TeleCommand is valid.
*
* @param sid is the sid to check.
*
* @return Status code CCSDS_TM_VALID or CORRUPTED.
*
*/
int status;
paul
Bug #801 Don_Initialisation_P2
r320 status = WRONG_SRC_ID;
paul
rev 1.0.0.2...
r104 if ( (sid == SID_TC_MISSION_TIMELINE) || (sid == SID_TC_TC_SEQUENCES) || (sid == SID_TC_RECOVERY_ACTION_CMD)
paul
Ignore doc files...
r46 || (sid == SID_TC_BACKUP_MISSION_TIMELINE)
|| (sid == SID_TC_DIRECT_CMD) || (sid == SID_TC_SPARE_GRD_SRC1) || (sid == SID_TC_SPARE_GRD_SRC2)
|| (sid == SID_TC_OBCP) || (sid == SID_TC_SYSTEM_CONTROL) || (sid == SID_TC_AOCS)
|| (sid == SID_TC_RPW_INTERNAL))
{
status = CCSDS_TM_VALID;
}
else
{
paul
fsw-0-20...
r51 status = WRONG_SRC_ID;
paul
Ignore doc files...
r46 }
return status;
}
paul
Minor changes in .h inclusion
r45 int tc_check_length( unsigned char packetSubType, unsigned int length )
{
/** This function checks that the subtype and the length are compliant.
*
* @param packetSubType is the subtype to check.
* @param length is the length to check.
paul
Ignore doc files...
r46 *
paul
Minor changes in .h inclusion
r45 * @return Status code CCSDS_TM_VALID or ILL_TYPE.
*
*/
int status;
status = LFR_SUCCESSFUL;
switch(packetSubType)
{
case TC_SUBTYPE_RESET:
if (length!=(TC_LEN_RESET-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_LOAD_COMM:
if (length!=(TC_LEN_LOAD_COMM-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_LOAD_NORM:
if (length!=(TC_LEN_LOAD_NORM-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_LOAD_BURST:
if (length!=(TC_LEN_LOAD_BURST-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_LOAD_SBM1:
if (length!=(TC_LEN_LOAD_SBM1-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_LOAD_SBM2:
if (length!=(TC_LEN_LOAD_SBM2-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_DUMP:
if (length!=(TC_LEN_DUMP-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_ENTER:
if (length!=(TC_LEN_ENTER-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_UPDT_INFO:
if (length!=(TC_LEN_UPDT_INFO-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_EN_CAL:
if (length!=(TC_LEN_EN_CAL-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_DIS_CAL:
if (length!=(TC_LEN_DIS_CAL-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
paul
TC_LFR_LOAD_KCOEFFICIENTS...
r194 case TC_SUBTYPE_LOAD_K:
if (length!=(TC_LEN_LOAD_K-CCSDS_TC_TM_PACKET_OFFSET)) {
status = WRONG_LEN_PKT;
}
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_DUMP_K:
if (length!=(TC_LEN_DUMP_K-CCSDS_TC_TM_PACKET_OFFSET)) {
status = WRONG_LEN_PKT;
}
else {
status = CCSDS_TM_VALID;
}
break;
case TC_SUBTYPE_LOAD_FBINS:
if (length!=(TC_LEN_LOAD_FBINS-CCSDS_TC_TM_PACKET_OFFSET)) {
status = WRONG_LEN_PKT;
}
else {
status = CCSDS_TM_VALID;
}
break;
paul
ICD 4.1 taken into account
r283 case TC_SUBTYPE_LOAD_FILTER_PAR:
if (length!=(TC_LEN_LOAD_FILTER_PAR-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
TC_LFR_LOAD_PAS_FILTER_PAR added to the authorized telecommands...
r282 status = WRONG_LEN_PKT;
}
else {
status = CCSDS_TM_VALID;
}
break;
paul
Minor changes in .h inclusion
r45 case TC_SUBTYPE_UPDT_TIME:
if (length!=(TC_LEN_UPDT_TIME-CCSDS_TC_TM_PACKET_OFFSET)) {
paul
fsw-0-20...
r51 status = WRONG_LEN_PKT;
paul
Minor changes in .h inclusion
r45 }
else {
status = CCSDS_TM_VALID;
}
break;
default: // if the subtype is not a legal value, return ILL_SUBTYPE
status = ILL_SUBTYPE;
break ;
}
return status;
}
int tc_check_crc( ccsdsTelecommandPacket_t * TCPacket, unsigned int length, unsigned char *computed_CRC )
{
/** This function checks the CRC validity of the corresponding TeleCommand packet.
*
* @param TCPacket points to the TeleCommand packet to check.
* @param length is the length of the TC packet.
paul
Ignore doc files...
r46 *
paul
Minor changes in .h inclusion
r45 * @return Status code CCSDS_TM_VALID or INCOR_CHECKSUM.
*
*/
int status;
unsigned char * CCSDSContent;
paul
Bug #801 Don_Initialisation_P2
r320 status = INCOR_CHECKSUM;
paul
Minor changes in .h inclusion
r45 CCSDSContent = (unsigned char*) TCPacket->packetID;
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 GetCRCAsTwoBytes(CCSDSContent, computed_CRC, length + CCSDS_TC_TM_PACKET_OFFSET - BYTES_PER_CRC); // 2 CRC bytes removed from the calculation of the CRC
paul
#427 corrected
r209
paul
Many corrections, mainly related to #807 Don_Enumeration
r318 if (computed_CRC[0] != CCSDSContent[length + CCSDS_TC_TM_PACKET_OFFSET - BYTES_PER_CRC]) {
paul
Minor changes in .h inclusion
r45 status = INCOR_CHECKSUM;
}
else if (computed_CRC[1] != CCSDSContent[length + CCSDS_TC_TM_PACKET_OFFSET -1]) {
status = INCOR_CHECKSUM;
}
else {
status = CCSDS_TM_VALID;
}
return status;
}