1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/drivers/include/cc110x_legacy/cc110x-interface.h

185 lines
5.1 KiB
C
Raw Normal View History

/*
2013-06-21 22:36:48 +02:00
* Copyright (C) 2009 Freie Universität Berlin
* Copyright (C) 2013 INRIA
2013-06-21 22:36:48 +02:00
*
2014-08-23 15:43:13 +02:00
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @defgroup drivers_cc110x_legacy CC110x_legacy
* @brief Driver for Texas Instruments CC110x (without MAC protocol)
* @ingroup drivers
2013-06-21 22:36:48 +02:00
* @{
*
* @file
* @brief Data structures and variables for the cc110x driver interface
*
* @author Oliver Hahm <oliver.hahm@inria.fr>
2013-06-21 22:36:48 +02:00
*/
#ifndef CC110X_LEGACY_INTERFACE_H
#define CC110X_LEGACY_INTERFACE_H
#include <stdint.h>
2013-12-16 17:54:58 +01:00
#include "radio/radio.h"
#include "radio/types.h"
#include "cc110x-config.h"
#include "kernel_types.h"
#include "transceiver.h"
#ifdef __cplusplus
extern "C" {
#endif
#define CC1100_MAX_DATA_LENGTH (58)
#define CC1100_HEADER_LENGTH (3) /**< Header covers SRC, DST and FLAGS */
#define CC1100_BROADCAST_ADDRESS (0x00) /**< CC1100 broadcast address */
#define MAX_UID (0xFF) /**< Maximum UID of a node is 255 */
#define MIN_UID (0x01) /**< Minimum UID of a node is 1 */
#define MIN_CHANNR (0) /**< Minimum channel number */
#define MAX_CHANNR (24) /**< Maximum channel number */
#define MIN_OUTPUT_POWER (0) /**< Minimum output power value */
#define MAX_OUTPUT_POWER (11) /**< Maximum output power value */
#define PACKET_LENGTH (0x3E) /**< Packet length = 62 Bytes. */
#define CC1100_SYNC_WORD_TX_TIME (90000) /**< loop count (max. timeout ~15 ms)
* to wait for sync word to be
* transmitted (GDO2 from low to high) */
/**
* @name Defines used as state values for state machine
* @{
*/
#define RADIO_UNKNOWN (0)
#define RADIO_AIR_FREE_WAITING (1)
#define RADIO_WOR (2)
#define RADIO_IDLE (3)
#define RADIO_SEND_BURST (4)
#define RADIO_RX (5)
#define RADIO_SEND_ACK (6)
#define RADIO_PWD (7)
/** @} */
extern volatile cc110x_flags rflags; /**< Radio flags */
extern char cc110x_conf[];
/**
* @brief CC1100 layer 0 protocol
*
* <pre>
---------------------------------------------------
| | | | | |
| Length | Address | PhySrc | Flags | Data |
| | | | | |
---------------------------------------------------
1 byte 1 byte 1 byte 1 byte <= 58 bytes
Flags:
Bit | Meaning
--------------------
7:4 | -
3:1 | Protocol
0 | Identification
</pre>
Notes:
\li length & address are given by CC1100
\li Identification is increased is used to scan duplicates. It must be increased
for each new packet and kept for packet retransmissions.
*/
2013-06-21 22:36:48 +02:00
typedef struct __attribute__((packed))
{
uint8_t length; /**< Length of the packet (without length byte) */
uint8_t address; /**< Destination address */
uint8_t phy_src; /**< Source address (physical source) */
uint8_t flags; /**< Flags */
uint8_t data[CC1100_MAX_DATA_LENGTH]; /**< Data (high layer protocol) */
2013-06-21 22:36:48 +02:00
}
cc110x_packet_t;
typedef struct {
uint8_t rssi;
uint8_t lqi;
cc110x_packet_t packet;
} rx_buffer_t;
enum radio_mode {
RADIO_MODE_GET = -1, /**< leave mode unchanged */
RADIO_MODE_OFF = 0, /**< turn radio off */
RADIO_MODE_ON = 1 /**< turn radio on */
};
2013-06-21 22:36:48 +02:00
extern rx_buffer_t cc110x_rx_buffer[];
extern volatile uint8_t rx_buffer_next; /**< Next packet in RX queue */
extern volatile uint8_t radio_state; /**< Radio state */
extern cc110x_statistic_t cc110x_statistic;
void cc110x_init(kernel_pid_t transceiver_pid);
void cc110x_rx_handler(void);
int8_t cc110x_send(cc110x_packet_t *pkt);
uint8_t cc110x_get_buffer_pos(void);
void cc110x_setup_rx_mode(void);
void cc110x_switch_to_rx(void);
void cc110x_wakeup_from_rx(void);
void cc110x_switch_to_pwd(void);
void cc110x_disable_interrupts(void);
int16_t cc110x_set_config_channel(uint8_t channr);
int16_t cc110x_set_channel(uint8_t channr);
int16_t cc110x_get_channel(void);
radio_address_t cc110x_set_address(radio_address_t addr);
radio_address_t cc110x_set_config_address(radio_address_t addr);
radio_address_t cc110x_get_address(void);
void cc110x_set_monitor(uint8_t mode);
2010-11-24 14:23:32 +01:00
void cc110x_print_config(void);
/**
* @brief GDO0 interrupt handler.
*/
void cc110x_gdo0_irq(void);
/**
* @brief GDO2 interrupt handler.
*
* @note Wakes up MCU on packet reception.
*/
void cc110x_gdo2_irq(void);
#ifdef DBG_IGNORE
/**
* @brief Initialize ignore function
*/
void cc110x_init_ignore(void);
/**
* @brief Adds a address to the ignore list
*
* @param addr The physical address to be ignored
*
* @return 0 if list is full, 1 otherwise
*
*/
uint8_t cc110x_add_ignored(radio_address_t addr);
#endif
#ifdef __cplusplus
}
#endif
/** @} */
#endif /* CC110X_LEGACY_INTERFACE_H */