Contiki 2.6

cc2420-aes.h

Go to the documentation of this file.
00001 /*
00002  * Copyright (c) 2008, Swedish Institute of Computer Science.
00003  * All rights reserved.
00004  *
00005  * Redistribution and use in source and binary forms, with or without
00006  * modification, are permitted provided that the following conditions
00007  * are met:
00008  * 1. Redistributions of source code must retain the above copyright
00009  *    notice, this list of conditions and the following disclaimer.
00010  * 2. Redistributions in binary form must reproduce the above copyright
00011  *    notice, this list of conditions and the following disclaimer in the
00012  *    documentation and/or other materials provided with the distribution.
00013  * 3. Neither the name of the Institute nor the names of its contributors
00014  *    may be used to endorse or promote products derived from this software
00015  *    without specific prior written permission.
00016  *
00017  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
00018  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00019  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00020  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
00021  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
00022  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
00023  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
00024  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
00025  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
00026  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00027  * SUCH DAMAGE.
00028  *
00029  * This file is part of the Contiki operating system.
00030  *
00031  * $Id: cc2420-aes.h,v 1.3 2010/03/15 23:04:54 nifi Exp $
00032  */
00033 
00034 /**
00035  * \file
00036  *         Interface to the CC2420 AES encryption/decryption functions
00037  * \author
00038  *         Adam Dunkels <adam@sics.se>
00039  */
00040 
00041 #ifndef __CC2420_AES_H__
00042 #define __CC2420_AES_H__
00043 
00044 /**
00045  * \brief      Setup an AES key
00046  * \param key  A pointer to a 16-byte AES key
00047  * \param index The key index: either 0 or 1.
00048  *
00049  *             This function sets up an AES key with the CC2420
00050  *             chip. The AES key can later be used with the
00051  *             cc2420_aes_cipher() function to encrypt or decrypt
00052  *             data.
00053  *
00054  *             The CC2420 can store two separate keys in its
00055  *             memory. The keys are indexed as 0 or 1 and the key
00056  *             index is given by the 'index' parameter.
00057  *
00058  */
00059 void cc2420_aes_set_key(const uint8_t *key, int index);
00060 
00061 
00062 /**
00063  * \brief      Encrypt/decrypt data with AES
00064  * \param data A pointer to the data to be encrypted/decrypted
00065  * \param len  The length of the data to be encrypted/decrypted
00066  * \param key_index The key to use. The key must have previously been set up with cc2420_aes_set_key().
00067  *
00068  *             This function encrypts/decrypts data with AES. A
00069  *             pointer to the data is passed as a parameter, and the
00070  *             function overwrites the data with the encrypted data.
00071  *
00072  */
00073 void cc2420_aes_cipher(uint8_t *data, int len, int key_index);
00074 
00075 
00076 #endif /* __CC2420_AES_H__ */