1 /* 2 * mainSecKeysOnly.h 3 * 4 * Copyright(c) 1998 - 2009 Texas Instruments. All rights reserved. 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 11 * * Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * * Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in 15 * the documentation and/or other materials provided with the 16 * distribution. 17 * * Neither the name Texas Instruments nor the names of its 18 * contributors may be used to endorse or promote products derived 19 * from this software without specific prior written permission. 20 * 21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 24 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 25 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 27 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 32 */ 33 34 /** \file MainSecSm.h 35 * \brief RSN main security SM 36 * 37 * \see MainSecSm.c 38 */ 39 40 41 /***************************************************************************/ 42 /* */ 43 /* MODULE: MainSecSm.h */ 44 /* PURPOSE: RSN main security SM */ 45 /* */ 46 /***************************************************************************/ 47 48 #ifndef _MAIN_SEC_KEYS_ONLY_H 49 #define _MAIN_SEC_KEYS_ONLY_H 50 51 #include "fsm.h" 52 #include "mainSecSm.h" 53 54 /* Constants */ 55 56 /** number of events in the state machine */ 57 #define MAIN_SEC_KEYS_ONLY_NUM_EVENTS 4 58 59 /** number of states in the state machine */ 60 #define MAIN_SEC_KEYS_ONLY_NUM_STATES 4 61 62 /* Enumerations */ 63 64 /* state machine states */ 65 typedef enum 66 { 67 MAIN_KO_STATE_IDLE = 0, 68 MAIN_KO_STATE_START = 1, 69 MAIN_KO_STATE_AUTHORIZED = 2, 70 MAIN_KO_STATE_NONAUTHORIZED = 3 71 } main_keysOnlyStates; 72 73 /* State machine inputs */ 74 typedef enum 75 { 76 MAIN_KO_EVENT_START = 0, 77 MAIN_KO_EVENT_STOP = 1, 78 MAIN_KO_EVENT_KEYS_COMPLETE = 2, 79 MAIN_KO_EVENT_SEC_ATTACK = 3 80 } main_keysOnlyEvents; 81 82 83 /* Typedefs */ 84 85 /* External data definitions */ 86 87 /* External functions definitions */ 88 89 /* Function prototypes */ 90 91 TI_STATUS mainSecKeysOnly_config(mainSec_t *pMainSec, 92 TRsnPaeConfig *pPaeConfig); 93 94 TI_STATUS mainSecKeysOnly_start(mainSec_t *pMainSec); 95 96 TI_STATUS mainSecKeysOnly_stop(mainSec_t *pMainSec); 97 98 TI_STATUS mainSecKeysOnly_setSessionKey(mainSec_t *pMainSec, TI_UINT8* pKey, TI_UINT8 keyLen); 99 100 TI_STATUS mainSecKeysOnly_getSessionKey(mainSec_t *pMainSec, TI_UINT8* pKey, TI_UINT32* pKeyLen); 101 102 TI_STATUS mainSecKeysOnly_reportKeysStatus(mainSec_t *pMainSec, TI_STATUS keyStatus); 103 104 /* state machine functions */ 105 106 TI_STATUS mainSecKeysOnly_startIdle(struct _mainSec_t *pMainSec); 107 108 TI_STATUS mainSecKeysOnly_stopStart(struct _mainSec_t *pMainSec); 109 110 TI_STATUS mainSecKeysOnly_keysCompleteStart(struct _mainSec_t *pMainSec); 111 112 TI_STATUS mainSecKeysOnly_keysTOStart(struct _mainSec_t *pMainSec); 113 114 TI_STATUS mainSecKeysOnly_stopAuthorized(struct _mainSec_t *pMainSec); 115 116 TI_STATUS mainSecKeysOnly_stopNonAuthorized(struct _mainSec_t *pMainSec); 117 118 /* state machine action functions */ 119 120 TI_STATUS mainSecKeysOnly_StartMainKeySm(void* pData); 121 122 TI_STATUS mainSecKeysOnly_StopMainKeySm(void* pData); 123 124 TI_STATUS mainSecKeysOnly_ReportAuthSuccess(void* pData); 125 126 TI_STATUS mainSecKeysOnly_ReportAuthFailure(void* pData); 127 128 TI_STATUS mainSecKeysOnly_Nop(void* pData); 129 130 TI_STATUS mainSecKeysOnly_unexpected(void* pData); 131 132 #endif 133 134