//
// Copyright 2010 Ettus Research LLC
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see .
//
#include "b100_iface.hpp"
#include "usrp_commands.h"
#include
#include
#include
#include
#include
#include
#include
//FOR TESTING ONLY
#include "b100_regs.hpp"
#include
#include "usrp_i2c_addr.h"
using namespace uhd;
using namespace uhd::usrp;
using namespace uhd::transport;
/***********************************************************************
* Constants
**********************************************************************/
static const bool iface_debug = true;
static const boost::uint16_t USRP_B_FW_COMPAT_NUM = 0x02;
static const boost::uint16_t USRP_B_FPGA_COMPAT_NUM = 0x03;
/***********************************************************************
* I2C + FX2 implementation wrapper
**********************************************************************/
class b100_i2c_fx2_iface : public i2c_iface{
public:
b100_i2c_fx2_iface(uhd::usrp::fx2_ctrl::sptr fx2_ctrl){
_fx2_ctrl = fx2_ctrl;
}
void write_i2c(boost::uint8_t addr, const byte_vector_t &bytes)
{
UHD_ASSERT_THROW(bytes.size() < max_i2c_data_bytes);
unsigned char buff[max_i2c_data_bytes];
std::copy(bytes.begin(), bytes.end(), buff);
int ret = _fx2_ctrl->usrp_i2c_write(addr & 0xff,
buff,
bytes.size());
if (iface_debug && (ret < 0))
uhd::runtime_error("USRP: failed i2c write");
}
byte_vector_t read_i2c(boost::uint8_t addr, size_t num_bytes)
{
UHD_ASSERT_THROW(num_bytes < max_i2c_data_bytes);
unsigned char buff[max_i2c_data_bytes];
int ret = _fx2_ctrl->usrp_i2c_read(addr & 0xff,
buff,
num_bytes);
if (iface_debug && ((ret < 0) || (unsigned)ret < (num_bytes)))
uhd::runtime_error("USRP: failed i2c read");
byte_vector_t out_bytes;
for (size_t i = 0; i < num_bytes; i++)
out_bytes.push_back(buff[i]);
return out_bytes;
}
private:
static const size_t max_i2c_data_bytes = 64;
uhd::usrp::fx2_ctrl::sptr _fx2_ctrl;
};
/***********************************************************************
* USRP-E100 interface implementation
**********************************************************************/
class b100_iface_impl : public b100_iface{
public:
/*******************************************************************
* Structors
******************************************************************/
b100_iface_impl(uhd::usrp::fx2_ctrl::sptr fx2_ctrl,
b100_ctrl::sptr fpga_ctrl) :
_fx2_i2c_iface(fx2_ctrl),
_fx2_ctrl(fx2_ctrl),
_fpga_ctrl(fpga_ctrl)
{
this->check_fw_compat();
if (fpga_ctrl.get() != NULL){
enable_gpif(1);
i2c_init();
this->check_fpga_compat();
}
mb_eeprom = mboard_eeprom_t(get_fx2_i2c_iface(), mboard_eeprom_t::MAP_B000);
}
void check_fw_compat(void){
unsigned char data[4]; //useless data buffer
const boost::uint16_t fw_compat_num = _fx2_ctrl->usrp_control_read(
VRQ_FW_COMPAT, 0, 0, data, sizeof(data)
);
if (fw_compat_num != USRP_B_FW_COMPAT_NUM){
throw uhd::runtime_error(str(boost::format(
"Expected firmware compatibility number 0x%x, but got 0x%x:\n"
"The firmware build is not compatible with the host code build."
) % USRP_B_FW_COMPAT_NUM % fw_compat_num));
}
}
void check_fpga_compat(void){
const boost::uint16_t fpga_compat_num = this->peek16(B100_REG_MISC_COMPAT);
if (fpga_compat_num != USRP_B_FPGA_COMPAT_NUM){
throw uhd::runtime_error(str(boost::format(
"Expected FPGA compatibility number 0x%x, but got 0x%x:\n"
"The FPGA build is not compatible with the host code build."
) % USRP_B_FPGA_COMPAT_NUM % fpga_compat_num));
}
}
~b100_iface_impl(void)
{
/* NOP */
}
/*******************************************************************
* Peek and Poke
******************************************************************/
void poke(boost::uint32_t addr, const ctrl_data_t &data) {
boost::mutex::scoped_lock lock(_ctrl_mutex);
_fpga_ctrl->write(addr, data);
}
ctrl_data_t peek(boost::uint32_t addr, size_t len) {
boost::mutex::scoped_lock lock(_ctrl_mutex);
return _fpga_ctrl->read(addr, len);
}
void poke16(boost::uint32_t addr, boost::uint16_t value)
{
ctrl_data_t words(1);
words[0] = value;
poke(addr, words);
}
void poke32(boost::uint32_t addr, boost::uint32_t value)
{
//just a subset of poke() to maintain compatibility
ctrl_data_t words(2);
words[0] = value & 0x0000FFFF;
words[1] = value >> 16;
poke(addr, words);
}
boost::uint32_t peek32(boost::uint32_t addr)
{
ctrl_data_t words = peek(addr, 2);
return boost::uint32_t((boost::uint32_t(words[1]) << 16) | words[0]);
}
boost::uint16_t peek16(boost::uint32_t addr)
{
ctrl_data_t words = peek(addr, 1);
return boost::uint16_t(words[0]);
}
/*******************************************************************
* I2C
******************************************************************/
static const boost::uint32_t i2c_datarate = 400000;
static const boost::uint32_t wishbone_clk = 64000000; //FIXME should go somewhere else
void i2c_init(void) {
//init I2C FPGA interface.
poke16(B100_REG_I2C_CTRL, 0x0000);
//set prescalers to operate at 400kHz: WB_CLK is 64MHz...
boost::uint16_t prescaler = wishbone_clk / (i2c_datarate*5) - 1;
poke16(B100_REG_I2C_PRESCALER_LO, prescaler & 0xFF);
poke16(B100_REG_I2C_PRESCALER_HI, (prescaler >> 8) & 0xFF);
poke16(B100_REG_I2C_CTRL, I2C_CTRL_EN); //enable I2C core
}
static const size_t max_i2c_data_bytes = 64;
void i2c_wait_for_xfer(void)
{
while(this->peek16(B100_REG_I2C_CMD_STATUS) & I2C_ST_TIP)
boost::this_thread::sleep(boost::posix_time::milliseconds(10));
}
bool wait_chk_ack(void) {
i2c_wait_for_xfer();
return (this->peek16(B100_REG_I2C_CMD_STATUS) & I2C_ST_RXACK) == 0;
}
void write_i2c(boost::uint8_t addr, const byte_vector_t &bytes)
{
poke16(B100_REG_I2C_DATA, (addr << 1) | 0); //addr and read bit (0)
poke16(B100_REG_I2C_CMD_STATUS, I2C_CMD_WR | I2C_CMD_START | (bytes.size() == 0 ? I2C_CMD_STOP : 0));
//wait for previous transfer to complete
if(!wait_chk_ack()) {
poke16(B100_REG_I2C_CMD_STATUS, I2C_CMD_STOP);
return;
}
for(size_t i = 0; i < bytes.size(); i++) {
poke16(B100_REG_I2C_DATA, bytes[i]);
poke16(B100_REG_I2C_CMD_STATUS, I2C_CMD_WR | ((i == (bytes.size() - 1)) ? I2C_CMD_STOP : 0));
if(!wait_chk_ack()) {
poke16(B100_REG_I2C_CMD_STATUS, I2C_CMD_STOP);
return;
}
}
}
byte_vector_t read_i2c(boost::uint8_t addr, size_t num_bytes)
{
byte_vector_t bytes;
if(num_bytes == 0) return bytes;
while (peek16(B100_REG_I2C_CMD_STATUS) & I2C_ST_BUSY);
poke16(B100_REG_I2C_DATA, (addr << 1) | 1); //addr and read bit (1)
poke16(B100_REG_I2C_CMD_STATUS, I2C_CMD_WR | I2C_CMD_START);
//wait for previous transfer to complete
if(!wait_chk_ack()) {
poke16(B100_REG_I2C_CMD_STATUS, I2C_CMD_STOP);
}
for(; num_bytes > 0; num_bytes--) {
poke16(B100_REG_I2C_CMD_STATUS, I2C_CMD_RD | ((num_bytes == 1) ? (I2C_CMD_STOP | I2C_CMD_NACK) : 0));
i2c_wait_for_xfer();
boost::uint8_t readback = peek16(B100_REG_I2C_DATA) & 0xFF;
bytes.push_back(readback);
}
return bytes;
}
i2c_iface &get_fx2_i2c_iface(void){
return _fx2_i2c_iface;
}
/*******************************************************************
* SPI interface
* Eventually this will be replaced with a control-channel system
* to let the firmware do the actual write/readback cycles.
* This keeps the bandwidth on the control channel down.
******************************************************************/
void spi_wait(void) {
while(peek32(B100_REG_SPI_CTRL) & SPI_CTRL_GO_BSY);
}
boost::uint32_t transact_spi(int which_slave,
const spi_config_t &config,
boost::uint32_t bits,
size_t num_bits,
bool readback)
{
UHD_ASSERT_THROW((num_bits <= 32) && !(num_bits % 8));
int edge_flags = ((config.miso_edge==spi_config_t::EDGE_FALL) ? SPI_CTRL_RXNEG : 0) |
((config.mosi_edge==spi_config_t::EDGE_FALL) ? 0 : SPI_CTRL_TXNEG)
;
boost::uint16_t ctrl = SPI_CTRL_ASS | (SPI_CTRL_CHAR_LEN_MASK & num_bits) | edge_flags;
poke16(B100_REG_SPI_DIV, 0x0001); // = fpga_clk / 4
poke32(B100_REG_SPI_SS, which_slave & 0xFFFF);
poke32(B100_REG_SPI_TXRX0, bits);
poke16(B100_REG_SPI_CTRL, ctrl);
poke16(B100_REG_SPI_CTRL, ctrl | SPI_CTRL_GO_BSY);
if(readback) {
spi_wait();
return peek32(B100_REG_SPI_TXRX0);
}
else {
return 0;
}
}
void reset_gpif(boost::uint16_t ep) {
_fx2_ctrl->usrp_control_write(VRQ_RESET_GPIF, ep, ep, 0, 0);
}
void enable_gpif(bool en) {
_fx2_ctrl->usrp_control_write(VRQ_ENABLE_GPIF, en ? 1 : 0, 0, 0, 0);
}
void clear_fpga_fifo(void) {
_fx2_ctrl->usrp_control_write(VRQ_CLEAR_FPGA_FIFO, 0, 0, 0, 0);
}
void write_uart(boost::uint8_t, const std::string &) {
throw uhd::not_implemented_error("Unhandled command write_uart()");
}
std::string read_uart(boost::uint8_t) {
throw uhd::not_implemented_error("Unhandled command read_uart()");
}
private:
b100_i2c_fx2_iface _fx2_i2c_iface;
uhd::usrp::fx2_ctrl::sptr _fx2_ctrl;
b100_ctrl::sptr _fpga_ctrl;
boost::mutex _ctrl_mutex;
};
/***********************************************************************
* Public Make Function
**********************************************************************/
b100_iface::sptr b100_iface::make(uhd::usrp::fx2_ctrl::sptr fx2_ctrl,
b100_ctrl::sptr fpga_ctrl)
{
return b100_iface::sptr(new b100_iface_impl(fx2_ctrl, fpga_ctrl));
}