mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
161 lines
4.6 KiB
C
161 lines
4.6 KiB
C
/*
|
|
* Copyright (C) 2014 Freie Universität Berlin
|
|
* Copyright (C) 2013 INRIA
|
|
*
|
|
* 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 CC110X
|
|
* @brief Driver for Texas Instruments CC110x (without MAC protocol)
|
|
* @ingroup drivers
|
|
* @{
|
|
*
|
|
* @file cc110x-interface.h
|
|
* @brief Data structures and variables for the cc110x driver interface
|
|
*
|
|
* @author Oliver Hahm <oliver.hahm@inria.fr>
|
|
*/
|
|
|
|
#ifndef CC110X_INTERFACE_H
|
|
#define CC110X_INTERFACE_H
|
|
|
|
#include <stdint.h>
|
|
#include "radio/radio.h"
|
|
#include "radio/types.h"
|
|
#include "cc110x-config.h"
|
|
#include "kernel_types.h"
|
|
#include "transceiver.h"
|
|
#include "netdev/base.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_IDLE (1)
|
|
#define RADIO_SEND_BURST (2)
|
|
#define RADIO_RX (3)
|
|
#define RADIO_PWD (4)
|
|
|
|
/** @} */
|
|
|
|
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.
|
|
*/
|
|
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)
|
|
}
|
|
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
|
|
};
|
|
|
|
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;
|
|
|
|
#ifdef MODULE_TRANSCEIVER
|
|
void cc110x_init(kernel_pid_t transceiver_pid);
|
|
#endif
|
|
|
|
int cc110x_initialize(netdev_t *dev);
|
|
|
|
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);
|
|
|
|
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);
|
|
|
|
void cc110x_print_config(void);
|
|
|
|
/**
|
|
* @brief GDO2 interrupt handler.
|
|
*
|
|
* @note Wakes up MCU on packet reception.
|
|
*/
|
|
void cc110x_rx_handler(void *args);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/** @} */
|
|
#endif /* CC110X_INTERFACE_H */
|