vsf_wifi_crypto.h

Go to the documentation of this file.

/*****************************************************************************
 *   Copyright(C)2009-2022 by VSF Team                                       *
 *                                                                           *
 *  Licensed under the Apache License, Version 2.0 (the "License");          *
 *  you may not use this file except in compliance with the License.         *
 *  You may obtain a copy of the License at                                  *
 *                                                                           *
 *     http://www.apache.org/licenses/LICENSE-2.0                            *
 *                                                                           *
 *  Unless required by applicable law or agreed to in writing, software      *
 *  distributed under the License is distributed on an "AS IS" BASIS,        *
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
 *  See the License for the specific language governing permissions and      *
 *  limitations under the License.                                           *
 *                                                                           *
 ****************************************************************************/
 
#ifndef __VSF_WIFI_CRYPTO_H__
#define __VSF_WIFI_CRYPTO_H__
 
/*============================ INCLUDES ======================================*/
 
#include "./vsf_wifi_cfg.h"
 
#if VSF_USE_WIFI == ENABLED && VSF_WIFI_USE_WPA == ENABLED
 
#include "kernel/vsf_kernel.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/*============================ MACROS ========================================*/
 
/* WPA2-PSK / CCMP key material sizes (octets). */
#define VSF_WIFI_PMK_LEN        32      /* pairwise master key                 */
#define VSF_WIFI_PTK_LEN        48      /* CCMP PTK = KCK(16)+KEK(16)+TK(16)   */
#define VSF_WIFI_KCK_LEN        16      /* EAPOL-Key MIC key                   */
#define VSF_WIFI_KEK_LEN        16      /* EAPOL-Key encryption (GTK) key      */
#define VSF_WIFI_TK_LEN         16      /* CCMP temporal key                   */
#define VSF_WIFI_NONCE_LEN      32      /* ANonce / SNonce                     */
#define VSF_WIFI_MIC_LEN        16      /* EAPOL-Key MIC (HMAC-SHA1 truncated) */
#define VSF_WIFI_CCMP_NONCE_LEN 13      /* CCM nonce: flag(1)+A2(6)+PN(6)      */
#define VSF_WIFI_CCMP_MIC_LEN   8       /* CCMP MIC                            */
 
/*============================ TYPES =========================================*/
/*============================ GLOBAL VARIABLES ==============================*/
/*============================ PROTOTYPES ====================================*/
 
extern vsf_err_t vsf_wifi_pbkdf2_pmk(const char *passphrase,
                const uint8_t *ssid, uint16_t ssid_len, uint8_t pmk[32]);
 
extern vsf_err_t vsf_wifi_prf_ptk(const uint8_t pmk[32],
                const uint8_t aa[6], const uint8_t spa[6],
                const uint8_t anonce[32], const uint8_t snonce[32],
                uint8_t ptk[48]);
 
extern vsf_err_t vsf_wifi_eapol_mic(const uint8_t kck[16],
                const uint8_t *eapol, uint16_t eapol_len, uint8_t mic[16]);
 
extern vsf_err_t vsf_wifi_aes_unwrap(const uint8_t *kek, uint16_t kek_len,
                const uint8_t *in, uint16_t in_len, uint8_t *out);
 
extern vsf_err_t vsf_wifi_ccmp_encrypt(const uint8_t tk[16],
                const uint8_t *aad, uint16_t aad_len,
                const uint8_t nonce[13],
                const uint8_t *plain, uint16_t plain_len,
                uint8_t *cipher, uint8_t mic[8]);
 
extern vsf_err_t vsf_wifi_ccmp_decrypt(const uint8_t tk[16],
                const uint8_t *aad, uint16_t aad_len,
                const uint8_t nonce[13],
                const uint8_t *cipher, uint16_t cipher_len,
                uint8_t *plain, const uint8_t mic[8]);
 
extern vsf_err_t vsf_wifi_crypto_selftest(void);
 
#ifdef __cplusplus
}
#endif
 
#endif      // VSF_USE_WIFI && VSF_WIFI_USE_WPA
#endif      // __VSF_WIFI_CRYPTO_H__
/* EOF */