Blame view

RIOT/drivers/cc110x/include/cc110x-internal.h 7.8 KB
fb11e647   vrobic   reseau statique a...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
  /*
   * Copyright (C) 2015 Kaspar Schleiser <kaspar@schleiser.de>
   * 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.
   */
  
  /**
   * @ingroup     drivers_cc110x
   * @{
   *
   * @file
   * @brief       Data structures and variables for the cc110x driver interface
   *
   * @author      Oliver Hahm <oliver.hahm@inria.fr>
   * @author      Kaspar Schleiser <kaspar@schleiser.de>
   */
  
  #ifndef CC110X_INTERNAL_H
  #define CC110X_INTERNAL_H
  
  #include <stdint.h>
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  #define CC110X_RXBUF_SIZE           (2)
  #define CC110X_MAX_DATA_LENGTH      (58+64)
  
  #define CC110X_HEADER_LENGTH        (3)     /**< Header covers SRC, DST and
                                                   FLAGS */
  #define CC110X_BROADCAST_ADDRESS    (0x00)  /**< CC110X broadcast address */
  
  #define MIN_UID                     (0x01)  /**< Minimum UID of a node is
                                                   1 */
  #define MAX_UID                     (0xFF)  /**< Maximum UID of a node is
                                                   255 */
  
  #define MIN_CHANNR                  (0)     /**< Minimum channel number */
  #define MAX_CHANNR                  (24)    /**< Maximum channel number */
  
  #define CC110X_PACKET_LENGTH        (0xFF)  /**< max packet length = 255b */
  #define CC110X_SYNC_WORD_TX_TIME    (90000) /**< loop count (max. timeout ~15ms)
                                                   to wait for sync word to be
                                                   transmitted (GDO2 from low to
                                                   high) */
  
  #define RESET_WAIT_TIME             (610)   /**< Reset wait time (in reset
                                                   procedure) */
  #define IDLE_TO_RX_TIME             (122)   /**< Time chip needs to go to RX */
  #define CS_SO_WAIT_TIME             (488)   /**< Time to wait for SO to go low
                                                   after CS */
  #define CC110X_GDO1_LOW_RETRY       (100)   /**< Max. retries for SO to go low
                                                   after CS */
  #ifndef CC110X_DEFAULT_CHANNEL
  #define CC110X_DEFAULT_CHANNEL      (0)     /**< The default channel number */
  #endif
  #define CC110X_MIN_CHANNR           (0)     /**< lowest possible channel number */
  #define CC110X_MAX_CHANNR           (0)     /**< highest possible channel number */
  
  /**
   * @name    State values for state machine
   * @{
   */
  enum {
      RADIO_UNKNOWN,
      RADIO_IDLE,
      RADIO_TX_BUSY,
      RADIO_RX,
      RADIO_RX_BUSY,
      RADIO_PWD,
  };
  /** @} */
  
  /**
   * @brief array holding cc110x register values
   */
  extern char cc110x_conf[];
  
  /**
   * @brief   CC110X layer 0 protocol
   *
   * <pre>
  ---------------------------------------------------
  |        |         |         |       |            |
  | Length | Address | PhySrc  | Flags |    Data    |
  |        |         |         |       |            |
  ---------------------------------------------------
    1 byte   1 byte    1 byte   1 byte   <= 251 bytes
  
  Flags:
          Bit | Meaning
          --------------------
          7:4 | -
          3:1 | Protocol
            0 | Identification
  </pre>
  Notes:
  \li length & address are given by CC110X
  \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[CC110X_MAX_DATA_LENGTH];   /**< Data (high layer protocol) */
  } cc110x_pkt_t;
  
  /**
   * @brief struct holding cc110x packet + metadata
   */
  typedef struct {
      uint8_t rssi;                           /**< RSSI value */
      uint8_t lqi;                            /**< link quality indicator */
      uint8_t pos;                            /**< I have no clue. */
      cc110x_pkt_t packet;                    /**< whole packet */
  } cc110x_pkt_buf_t;
  
  /**
   * @brief enum for holding cc110x radio on/off state */
  enum cc110x_radio_mode {
      RADIO_MODE_GET  = -1,                   /**< leave mode unchanged */
      RADIO_MODE_OFF  = 0,                    /**< turn radio off */
      RADIO_MODE_ON   = 1                     /**< turn radio on */
  };
  
  /**
   * @brief   CC110x register configuration
   */
  typedef struct {
      uint8_t _IOCFG2;      /**< GDO2 output pin configuration */
      uint8_t _IOCFG1;      /**< GDO1 output pin configuration */
      uint8_t _IOCFG0;      /**< GDO0 output pin configuration */
      uint8_t _FIFOTHR;     /**< RX FIFO and TX FIFO thresholds */
      uint8_t _SYNC1;       /**< Sync word, high byte */
      uint8_t _SYNC0;       /**< Sync word, low byte */
      uint8_t _PKTLEN;      /**< Packet length */
      uint8_t _PKTCTRL1;    /**< Packet automation control */
      uint8_t _PKTCTRL0;    /**< Packet automation control */
      uint8_t _ADDR;        /**< Device address */
      uint8_t _CHANNR;      /**< Channel number */
      uint8_t _FSCTRL1;     /**< Frequency synthesizer control */
      uint8_t _FSCTRL0;     /**< Frequency synthesizer control */
      uint8_t _FREQ2;       /**< Frequency control word, high byte */
      uint8_t _FREQ1;       /**< Frequency control word, middle byte */
      uint8_t _FREQ0;       /**< Frequency control word, low byte */
      uint8_t _MDMCFG4;     /**< Modem configuration */
      uint8_t _MDMCFG3;     /**< Modem configuration */
      uint8_t _MDMCFG2;     /**< Modem configuration */
      uint8_t _MDMCFG1;     /**< Modem configuration */
      uint8_t _MDMCFG0;     /**< Modem configuration */
      uint8_t _DEVIATN;     /**< Modem deviation setting */
      uint8_t _MCSM2;       /**< Main Radio Control State Machine configuration */
      uint8_t _MCSM1;       /**< Main Radio Control State Machine configuration */
      uint8_t _MCSM0;       /**< Main Radio Control State Machine configuration */
      uint8_t _FOCCFG;      /**< Frequency Offset Compensation configuration */
      uint8_t _BSCFG;       /**< Bit Synchronization configuration */
      uint8_t _AGCCTRL2;    /**< AGC control */
      uint8_t _AGCCTRL1;    /**< AGC control */
      uint8_t _AGCCTRL0;    /**< AGC control */
      uint8_t _WOREVT1;     /**< High byte Event 0 timeout */
      uint8_t _WOREVT0;     /**< Low byte Event 0 timeout */
      uint8_t _WORCTRL;     /**< Wake On Radio control */
      uint8_t _FREND1;      /**< Front end RX configuration */
      uint8_t _FREND0;      /**< Front end TX configuration */
      uint8_t _FSCAL3;      /**< Frequency synthesizer calibration */
      uint8_t _FSCAL2;      /**< Frequency synthesizer calibration */
      uint8_t _FSCAL1;      /**< Frequency synthesizer calibration */
      uint8_t _FSCAL0;      /**< Frequency synthesizer calibration */
  } cc110x_reg_t;
  
  /**
   * @brief   CC110x radio configuration
   */
  typedef struct {
      cc110x_reg_t reg_cfg;       /**< CC110X register configuration */
      uint8_t pa_power;           /**< Output power setting */
  } cc110x_cfg_t;
  
  /**
   * @brief   Radio Control Flags
   */
  typedef struct {
      uint8_t  _RSSI;             /**< The RSSI value of last received packet */
      uint8_t  _LQI;              /**< The LQI value of the last received packet */
  } cc110x_flags_t;
  
  /**
   * @brief   Statistic interface for debugging
   */
  typedef struct cc110x_statistic {
      uint32_t    packets_in;             /**< total nr of packets received */
      uint32_t    packets_in_crc_fail;    /**< dropped because of invalid crc */
      uint32_t    packets_in_while_tx;    /**< receive while tx */
      uint32_t    raw_packets_out;        /**< packets sent */
  } cc110x_statistic_t;
  
  #ifdef __cplusplus
  }
  #endif
  
  /** @} */
  #endif /* CC110X_INTERNAL_H */