git.gag.com Git - debian/gnuradio/blob - usrp/host/lib/inband/usrp_inband_usb_packet.h

   1 /* -*- c++ -*- */
   2 /*
   3  * Copyright 2007 Free Software Foundation, Inc.
   4  *
   5  * This file is part of GNU Radio
   6  *
   7  * GNU Radio is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 3, or (at your option)
  10  * any later version.
  11  *
  12  * GNU Radio is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  20  */
  21
  22 #ifndef INCLUDED_USRP_INBAND_USB_PACKET_H_
  23 #define INCLUDED_USRP_INBAND_USB_PACKET_H_
  24
  25 #include <usrp_bytesex.h>
  26 #include <mb_mblock.h>
  27 #include <pmt.h>
  28 #include <iostream>
  29
  30 #include <symbols_usrp_low_level_cs.h>
  31
  32 static const int USB_PKT_SIZE = 512;   // bytes
  33 static const int MAX_PAYLOAD = USB_PKT_SIZE-2*sizeof(uint32_t);
  34
  35 class usrp_inband_usb_packet {
  36   //
  37   // keep raw packet in USRP-endian order
  38   //
  39   uint32_t            d_word0;
  40   uint32_t            d_timestamp;
  41   unsigned char   d_payload[MAX_PAYLOAD];
  42
  43 public:
  44
  45   enum opcodes {
  46     OP_PING_FIXED         = 0x00,
  47     OP_PING_FIXED_REPLY   = 0x01,
  48     OP_WRITE_REG          = 0x02,
  49     OP_WRITE_REG_MASKED   = 0x03,
  50     OP_READ_REG           = 0x04,
  51     OP_READ_REG_REPLY     = 0x05,
  52     OP_I2C_WRITE          = 0x06,
  53     OP_I2C_READ           = 0x07,
  54     OP_I2C_READ_REPLY     = 0x08,
  55     OP_SPI_WRITE          = 0x09,
  56     OP_SPI_READ           = 0x0a,
  57     OP_SPI_READ_REPLY     = 0x0b,
  58     OP_DELAY              = 0x0c
  59   };
  60
  61   enum flags {
  62     FL_OVERRUN        = 0x80000000,
  63     FL_UNDERRUN       = 0x40000000,
  64     FL_DROPPED        = 0x20000000,
  65     FL_START_OF_BURST = 0x10000000,
  66     FL_END_OF_BURST   = 0x08000000,
  67     FL_CARRIER_SENSE  = 0x04000000,
  68
  69     FL_ALL_FLAGS      = 0xfc000000
  70   };
  71
  72   static const int FL_OVERRUN_SHIFT = 31;
  73   static const int FL_UNDERRUN_SHIFT = 30;
  74   static const int FL_DROPPED_SHIFT = 29;
  75   static const int FL_END_OF_BURST_SHIFT = 27;
  76   static const int FL_START_OF_BURST_SHIFT = 28;
  77
  78   static const int RSSI_MASK = 0x3f;
  79   static const int RSSI_SHIFT = 21;
  80
  81   static const int CHAN_MASK = 0x1f;
  82   static const int CHAN_SHIFT = 16;
  83
  84   static const int TAG_MASK = 0xf;
  85   static const int TAG_SHIFT = 9;
  86
  87   static const int PAYLOAD_LEN_MASK = 0x1ff;
  88   static const int PAYLOAD_LEN_SHIFT = 0;
  89
  90   // Fixed size for opcode and length fields
  91   static const int CS_FIXED_LEN = 2;
  92
  93   static const int CS_OPCODE_MASK = 0xff;
  94   static const int CS_OPCODE_SHIFT = 24;
  95
  96   static const int CS_LEN_MASK = 0xff;
  97   static const int CS_LEN_SHIFT = 16;
  98
  99   static const int CS_RID_MASK = 0x3f;
 100   static const int CS_RID_SHIFT = 10;
 101
 102   static const int CS_PING_LEN = 2;
 103   static const int CS_PINGVAL_MASK = 0x3ff;
 104   static const int CS_PINGVAL_SHIFT = 0;
 105
 106   static const int CS_WRITEREG_LEN = 6;
 107   static const int CS_WRITEREGMASKED_LEN = 10;
 108   static const int CS_READREG_LEN = 2;
 109   static const int CS_READREGREPLY_LEN = 6;
 110   static const int CS_REGNUM_MASK = 0x3ff;
 111   static const int CS_REGNUM_SHIFT = 0;
 112
 113   static const int CS_DELAY_LEN = 2;
 114   static const int CS_DELAY_MASK = 0xffff;
 115   static const int CS_DELAY_SHIFT = 0;
 116
 117   static const int CS_I2CADDR_MASK = 0x7f;
 118   static const int CS_I2CADDR_SHIFT = 0;
 119
 120   static const int CS_I2CREAD_LEN = 3;
 121   static const int CS_I2CREADBYTES_MASK = 0x7f;
 122   static const int CS_I2CREADBYTES_SHIFT = 24;
 123
 124   static const int CS_SPIOPT_MASK = 0xffff;
 125   static const int CS_SPIOPT_SHIFT = 0;
 126   static const int CS_SPIFORMAT_MASK = 0xff;
 127   static const int CS_SPIFORMAT_SHIFT = 16;
 128   static const int CS_SPIENABLES_MASK = 0xff;
 129   static const int CS_SPIENABLES_SHIFT = 24;
 130   static const int CS_SPIREAD_LEN = 7;
 131   static const int CS_SPINBYTES_MASK = 0xff;
 132   static const int CS_SPINBYTES_SHIFT = 24;
 133
 134 public:
 135
 136   void set_timestamp(uint32_t timestamp){
 137     d_timestamp = host_to_usrp_u32(timestamp);
 138   }
 139
 140   void set_end_of_burst() {
 141     uint32_t word0 = usrp_to_host_u32(d_word0);
 142     word0 |= 1<<FL_END_OF_BURST_SHIFT;
 143     d_word0 = host_to_usrp_u32(word0);
 144   }
 145
 146   void set_header(int flags, int chan, int tag, int payload_len){
 147     uint32_t word0 =  ((flags & FL_ALL_FLAGS)
 148                        | ((chan & CHAN_MASK) << CHAN_SHIFT)
 149                        | ((tag & TAG_MASK) << TAG_SHIFT)
 150                        | ((payload_len & PAYLOAD_LEN_MASK) << PAYLOAD_LEN_SHIFT));
 151     d_word0 = host_to_usrp_u32(word0);
 152   }
 153
 154   uint32_t timestamp() const {
 155     return usrp_to_host_u32(d_timestamp);
 156   }
 157
 158   int rssi() const {
 159     uint32_t word0 = usrp_to_host_u32(d_word0);
 160     return (word0 >> RSSI_SHIFT) & RSSI_MASK;
 161   }
 162
 163   int chan() const {
 164     uint32_t word0 = usrp_to_host_u32(d_word0);
 165     return (word0 >> CHAN_SHIFT) & CHAN_MASK;
 166   }
 167
 168   int tag() const {
 169     uint32_t word0 = usrp_to_host_u32(d_word0);
 170     return (word0 >> TAG_SHIFT) & TAG_MASK;
 171   }
 172
 173   int payload_len() const {
 174     uint32_t word0 = usrp_to_host_u32(d_word0);
 175     return (word0 >> PAYLOAD_LEN_SHIFT) & PAYLOAD_LEN_MASK;
 176   }
 177
 178   int flags() const {
 179     return usrp_to_host_u32(d_word0) & FL_ALL_FLAGS;
 180   }
 181
 182   int overrun() const {
 183     return (usrp_to_host_u32(d_word0) & FL_OVERRUN) >> FL_OVERRUN_SHIFT;
 184   }
 185
 186
 187   int underrun() const {
 188     return (usrp_to_host_u32(d_word0) & FL_UNDERRUN) >> FL_UNDERRUN_SHIFT;
 189   }
 190
 191
 192   int start_of_burst() const {
 193     return (usrp_to_host_u32(d_word0) & FL_START_OF_BURST) >> FL_START_OF_BURST_SHIFT;
 194   }
 195
 196   int end_of_burst() const {
 197     return (usrp_to_host_u32(d_word0) & FL_END_OF_BURST) >> FL_END_OF_BURST_SHIFT;
 198   }
 199
 200   int dropped() const {
 201     return (usrp_to_host_u32(d_word0) & FL_DROPPED) >> FL_DROPPED_SHIFT;
 202   }
 203
 204   unsigned char *payload() {
 205     return d_payload;
 206   }
 207
 208   static int max_payload() {
 209     return MAX_PAYLOAD;
 210   }
 211
 212   static int max_pkt_size() {
 213     return USB_PKT_SIZE;
 214   }
 215
 216   // C/S methods
 217   bool align32();
 218   bool cs_ping(long rid, long ping_val);
 219   bool cs_ping_reply(long rid, long ping_val);
 220   bool cs_write_reg(long reg_num, long val);
 221   bool cs_write_reg_masked(long reg_num, long val, long mask);
 222   bool cs_read_reg(long rid, long reg_num);
 223   bool cs_read_reg_reply(long rid, long reg_num, long reg_val);
 224   bool cs_delay(long ticks);
 225   bool cs_i2c_write(long i2c_addr, uint8_t *i2c_data, size_t data_len);
 226   bool cs_i2c_read(long rid, long i2c_addr, long n_bytes);
 227   bool cs_i2c_read_reply(long rid, long i2c_addr, uint8_t *i2c_data, long i2c_data_len);
 228   bool cs_spi_write(long enables, long format, long opt_header_bytes, uint8_t *spi_data, long spi_data_len);
 229   bool cs_spi_read(long rid, long enables, long format, long opt_header_bytes, long n_bytes);
 230   bool cs_spi_read_reply(long rid, uint8_t *spi_data, long spi_data_len);
 231   int cs_len(int payload_offset);
 232   pmt_t read_subpacket(int payload_offset);
 233 };
 234
 235 #endif