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 */
65typedef 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 */
74typedef 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
91TI_STATUS mainSecKeysOnly_config(mainSec_t *pMainSec,
92                            TRsnPaeConfig *pPaeConfig);
93
94TI_STATUS mainSecKeysOnly_start(mainSec_t *pMainSec);
95
96TI_STATUS mainSecKeysOnly_stop(mainSec_t *pMainSec);
97
98TI_STATUS mainSecKeysOnly_setSessionKey(mainSec_t *pMainSec, TI_UINT8* pKey, TI_UINT8 keyLen);
99
100TI_STATUS mainSecKeysOnly_getSessionKey(mainSec_t *pMainSec, TI_UINT8* pKey, TI_UINT32* pKeyLen);
101
102TI_STATUS mainSecKeysOnly_reportKeysStatus(mainSec_t *pMainSec, TI_STATUS keyStatus);
103
104/* state machine functions */
105
106TI_STATUS mainSecKeysOnly_startIdle(struct _mainSec_t *pMainSec);
107
108TI_STATUS mainSecKeysOnly_stopStart(struct _mainSec_t *pMainSec);
109
110TI_STATUS mainSecKeysOnly_keysCompleteStart(struct _mainSec_t *pMainSec);
111
112TI_STATUS mainSecKeysOnly_keysTOStart(struct _mainSec_t *pMainSec);
113
114TI_STATUS mainSecKeysOnly_stopAuthorized(struct _mainSec_t *pMainSec);
115
116TI_STATUS mainSecKeysOnly_stopNonAuthorized(struct _mainSec_t *pMainSec);
117
118/* state machine action functions */
119
120TI_STATUS mainSecKeysOnly_StartMainKeySm(void* pData);
121
122TI_STATUS mainSecKeysOnly_StopMainKeySm(void* pData);
123
124TI_STATUS mainSecKeysOnly_ReportAuthSuccess(void* pData);
125
126TI_STATUS mainSecKeysOnly_ReportAuthFailure(void* pData);
127
128TI_STATUS mainSecKeysOnly_Nop(void* pData);
129
130TI_STATUS mainSecKeysOnly_unexpected(void* pData);
131
132#endif
133
134