/* * prjpeppercorn -- GateMate FPGAs Bitstream Documentation and Tools * * Copyright (C) 2024 The Project Peppercorn Authors. * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. * */ #include "TileBitDatabase.hpp" #include #include #include #include "Chip.hpp" #include "ChipConfig.hpp" #include "Util.hpp" namespace GateMate { std::vector data_bytes_to_array(const std::vector &data, size_t count) { std::vector result(count * 8); for (size_t j = 0; j < count; j++) { uint8_t val = data[j]; for (size_t i = 0; i < 8; i++) { uint8_t temp = 1 << i; if (val & temp) result[j * 8 + i] = true; else result[j * 8 + i] = false; } } return result; } bool is_array_empty(std::vector &array) { for (bool val : array) if (val) return false; return true; } BaseBitDatabase::BaseBitDatabase(int num_bits) : num_bits(num_bits), known_bits(num_bits, false) {} BaseBitDatabase::~BaseBitDatabase() {} void BaseBitDatabase::add_word_settings(const std::string &name, int start, int end) { if (words.find(name) != words.end()) throw DatabaseConflictError(fmt("word " << name << " already exists in DB")); for (int i = start; i < start + end; i++) { if (known_bits[i]) throw DatabaseConflictError(fmt("bit " << i << " for word " << name << " already mapped")); known_bits[i] = true; } words[name] = {start, start + end}; } void BaseBitDatabase::add_unknowns() { for (int i = 0; i < num_bits; i++) { if (!known_bits[i]) words[stringf("UNKNOWN_%03d", i)] = {i, i + 1}; } } std::vector BaseBitDatabase::bits_to_bytes(std::vector &bits) { std::vector val; size_t pos = 0; for (size_t j = 0; j < bits.size() / 8; j++) { uint8_t data = 0; for (int i = 0; i < 8; i++) { data >>= 1; data |= bits[pos] ? 0x80 : 0x00; pos++; } val.push_back(data); } return val; } std::vector BaseBitDatabase::config_to_data(const TileConfig &cfg) { std::vector tile(num_bits, false); for (auto &w : cfg.cwords) { if (words.count(w.name)) { words[w.name].set_value(tile, w.value); } else { throw std::runtime_error(fmt("unknown word " << w.name << " found while converting data")); } } return bits_to_bytes(tile); } TileConfig BaseBitDatabase::data_to_config(const std::vector &data) { TileConfig cfg; std::vector d = data_bytes_to_array(data, num_bits * 8); for (auto &w : words) { auto val = w.second.get_value(d); if (is_array_empty(val)) continue; cfg.add_word(w.first, val); } return cfg; } void TileBitDatabase::add_sb_big(int index, int start) { add_word_settings(stringf("SB_BIG.P%02d.YDIAG", index), start + 0, 3); add_word_settings(stringf("SB_BIG.P%02d.Y1", index), start + 3, 3); add_word_settings(stringf("SB_BIG.P%02d.Y2", index), start + 6, 3); add_word_settings(stringf("SB_BIG.P%02d.Y3", index), start + 9, 3); add_word_settings(stringf("SB_BIG.P%02d.Y4", index), start + 12, 3); } void TileBitDatabase::add_sb_sml(int index, int start) { add_word_settings(stringf("SB_SML.P%02d.YDIAG", index), start + 0, 3); add_word_settings(stringf("SB_SML.P%02d.Y1", index), start + 3, 2); add_word_settings(stringf("SB_SML.P%02d.Y2", index), start + 5, 2); add_word_settings(stringf("SB_SML.P%02d.Y3", index), start + 7, 2); add_word_settings(stringf("SB_SML.P%02d.Y4", index), start + 9, 2); } void TileBitDatabase::add_sb_drive(int index, int start) { for (int i = 0; i < 4; i++) add_word_settings(stringf("SB_DRIVE.P%02d.D%d", index, i), start + i, 1); } void TileBitDatabase::add_cpe(int index, int start) { add_word_settings(stringf("CPE%d.INIT_L00", index), start + 0, 4); add_word_settings(stringf("CPE%d.INIT_L01", index), start + 4, 4); add_word_settings(stringf("CPE%d.INIT_L02", index), start + 8, 4); add_word_settings(stringf("CPE%d.INIT_L03", index), start + 12, 4); add_word_settings(stringf("CPE%d.INIT_L10", index), start + 16, 4); add_word_settings(stringf("CPE%d.INIT_L11", index), start + 20, 4); add_word_settings(stringf("CPE%d.INIT_L20", index), start + 24, 4); add_word_settings(stringf("CPE%d.INIT_L30", index), start + 28, 4); add_word_settings(stringf("CPE%d.I1", index), start + 32, 1); add_word_settings(stringf("CPE%d.I2", index), start + 33, 1); add_word_settings(stringf("CPE%d.I3", index), start + 34, 1); add_word_settings(stringf("CPE%d.I4", index), start + 35, 1); add_word_settings(stringf("CPE%d.FUNCTION", index), start + 36, 3); add_word_settings(stringf("CPE%d.COMP", index), start + 39, 1); add_word_settings(stringf("CPE%d.COMP_I", index), start + 40, 1); add_word_settings(stringf("CPE%d.HORIZ", index), start + 41, 1); add_word_settings(stringf("CPE%d.SELX", index), start + 42, 1); add_word_settings(stringf("CPE%d.SELY1", index), start + 43, 1); add_word_settings(stringf("CPE%d.SELY2", index), start + 44, 1); add_word_settings(stringf("CPE%d.SEL_C", index), start + 45, 1); add_word_settings(stringf("CPE%d.SEL_P", index), start + 46, 1); add_word_settings(stringf("CPE%d.Y12", index), start + 47, 1); add_word_settings(stringf("CPE%d.CX_I", index), start + 48, 1); add_word_settings(stringf("CPE%d.CY1_I", index), start + 49, 1); add_word_settings(stringf("CPE%d.CY2_I", index), start + 50, 1); add_word_settings(stringf("CPE%d.PX_I", index), start + 51, 1); add_word_settings(stringf("CPE%d.PY1_I", index), start + 52, 1); add_word_settings(stringf("CPE%d.PY2_I", index), start + 53, 1); add_word_settings(stringf("CPE%d.C_P", index), start + 54, 1); add_word_settings(stringf("CPE%d.2D_IN", index), start + 55, 1); add_word_settings(stringf("CPE%d.SN", index), start + 56, 3); add_word_settings(stringf("CPE%d.O1", index), start + 59, 2); add_word_settings(stringf("CPE%d.O2", index), start + 61, 2); add_word_settings(stringf("CPE%d.BR", index), start + 63, 1); add_word_settings(stringf("CPE%d.CLK", index), start + 64, 2); add_word_settings(stringf("CPE%d.EN", index), start + 66, 2); add_word_settings(stringf("CPE%d.R", index), start + 68, 2); add_word_settings(stringf("CPE%d.S", index), start + 70, 2); add_word_settings(stringf("CPE%d.RAM_I1", index), start + 72, 1); add_word_settings(stringf("CPE%d.RAM_I2", index), start + 73, 1); add_word_settings(stringf("CPE%d.RAM_O1", index), start + 74, 1); add_word_settings(stringf("CPE%d.RAM_O2", index), start + 75, 1); add_word_settings(stringf("CPE%d.L_D", index), start + 76, 1); add_word_settings(stringf("CPE%d.EN_SR", index), start + 77, 1); add_word_settings(stringf("CPE%d.CLKSEL", index), start + 78, 1); add_word_settings(stringf("CPE%d.ENSEL", index), start + 79, 1); } void TileBitDatabase::add_ff_init(int index, int start) { add_word_settings(stringf("CPE%d.FF_INIT", index), start, 2); } void TileBitDatabase::add_inmux(int index, int plane, int start) { add_word_settings(stringf("IM%d.P%02d", index, plane), start, 3); } void TileBitDatabase::add_outmux(int index, int plane, int start) { add_word_settings(stringf("OM%d.P%02d", index, plane), start, 2); } void TileBitDatabase::add_gpio(int start) { add_word_settings("GPIO.OPEN_DRAIN", start + 0, 1); add_word_settings("GPIO.SLEW", start + 1, 1); add_word_settings("GPIO.DRIVE", start + 2, 2); add_word_settings("GPIO.INPUT_ENABLE", start + 4, 1); add_word_settings("GPIO.PULLDOWN", start + 5, 1); add_word_settings("GPIO.PULLUP", start + 6, 1); add_word_settings("GPIO.SCHMITT_TRIGGER", start + 7, 1); add_word_settings("GPIO.OUT_SIGNAL", start + 8, 1); add_word_settings("GPIO.OUT1/4", start + 9, 1); add_word_settings("GPIO.OUT2/3", start + 10, 1); add_word_settings("GPIO.OUT23_14_SEL", start + 11, 1); add_word_settings("GPIO.USE_CFG_BIT", start + 12, 1); // Use bit 9 for clock, error in silicon add_word_settings("GPIO.USE_DDR", start + 13, 1); add_word_settings("GPIO.SEL_IN_CLOCK", start + 14, 1); // Use clock signals for IN CLK add_word_settings("GPIO.SEL_OUT_CLOCK", start + 15, 1); // Use clock signals for OUT CLK add_word_settings("GPIO.OE_ENABLE", start + 16, 1); add_word_settings("GPIO.OE_SIGNAL", start + 17, 2); // 0 is constant 1 // 19 unused add_word_settings("GPIO.OUT1_FF", start + 20, 1); add_word_settings("GPIO.OUT2_FF", start + 21, 1); add_word_settings("GPIO.IN1_FF", start + 22, 1); add_word_settings("GPIO.IN2_FF", start + 23, 1); add_word_settings("GPIO.OUT_CLOCK", start + 24, 2); add_word_settings("GPIO.INV_OUT1_CLOCK", start + 26, 1); add_word_settings("GPIO.INV_OUT2_CLOCK", start + 27, 1); add_word_settings("GPIO.IN_CLOCK", start + 28, 2); add_word_settings("GPIO.INV_IN1_CLOCK", start + 30, 1); add_word_settings("GPIO.INV_IN2_CLOCK", start + 31, 1); add_word_settings("GPIO.DELAY_OBF", start + 32, 16); add_word_settings("GPIO.DELAY_IBF", start + 48, 16); add_word_settings("GPIO.LVDS_EN", start + 64, 1); add_word_settings("GPIO.LVDS_BOOST", start + 65, 1); add_word_settings("GPIO.LVDS_IE", start + 66, 1); add_word_settings("GPIO.LVDS_RTERM", start + 67, 1); } void TileBitDatabase::add_edge_io(int index, int start) { for (int i = 0; i < 12; i++) add_word_settings(stringf("IOES%d.SB_IN_{%d}", index, i + 1), start + i, 1); } void TileBitDatabase::add_right_edge(int index, int start) { // 4 * 3 bits + 8 * 1 bit = 20 bits add_word_settings(stringf("RES%d.INIT", index), start, 24); } void TileBitDatabase::add_left_edge(int index, int start) { // 4 * 3 bits + 2 * 2 bits + 2 * 2 bits = 20 bits add_word_settings(stringf("LES%d.INIT", index), start, 24); } void TileBitDatabase::add_top_edge(int index, int start) { // 4 * 3 bits + 8 * 1 bit = 20 bits add_word_settings(stringf("TES%d.INIT", index), start, 24); } void TileBitDatabase::add_bottom_edge(int index, int start) { // 8 * 3 bits + 8 * 2 bits + 4 * 1 bit = 44 bits add_word_settings(stringf("BES%d.INIT", index), start, 48); } TileBitDatabase::TileBitDatabase(const int x, const int y) : BaseBitDatabase(Die::LATCH_BLOCK_SIZE * 8) { bool is_core = false; if (y == 0) { add_bottom_edge(1, 13 * 8); add_bottom_edge(2, 19 * 8); } else if (x == 0) { add_left_edge(1, 13 * 8); add_left_edge(2, 16 * 8); } else if (y == 66 - 1) { add_top_edge(1, 13 * 8); add_top_edge(2, 16 * 8); } else if (x == 82 - 1) { add_right_edge(1, 13 * 8); add_right_edge(2, 16 * 8); } else { is_core = true; for (int i = 0; i < 4; i++) { add_cpe(i + 1, 10 * i * 8); add_ff_init(i + 1, (Die::LATCH_BLOCK_SIZE - 1) * 8 + i * 2); } int pos = 40; for (int i = 0; i < 4; i++) { for (int j = 0; j < 6; j++) { add_inmux(i + 1, j * 2 + 1, pos * 8); add_inmux(i + 1, j * 2 + 2, pos * 8 + 3); pos++; } } for (int i = 0; i < 2; i++) { pos = 54 + i * 6; for (int j = 9; j <= 12; j++) { add_outmux(i ? 4 : 1, j, pos * 8 + 6); pos++; } } } if (!is_core) { add_gpio(0); add_edge_io(1, 9 * 8); add_edge_io(2, 11 * 8); } int pos = 64; // All tiles have switch boxes // 64 SB_BIG plane 1 // 65 SB_BIG plane 1 // 66 SB_DRIVE plane 2,1 // 67 SB_BIG plane 2 // 68 SB_BIG plane 2 // repeated to cover all 12 planes for (int i = 0; i < 6; i++) { add_sb_big(i * 2 + 1, pos * 8); add_sb_drive(i * 2 + 1, (pos + 2) * 8); add_sb_drive(i * 2 + 2, (pos + 2) * 8 + 4); add_sb_big(i * 2 + 2, (pos + 3) * 8); pos += 5; } // 94 SB_SML plane 1 // 95 SB_SML plane 2,1 // 96 SB_SML plane 2 // repeated to cover all 12 planes for (int i = 0; i < 6; i++) { add_sb_sml(i * 2 + 1, pos * 8); add_sb_sml(i * 2 + 2, (pos + 1) * 8 + 4); pos += 3; } add_unknowns(); } RamBitDatabase::RamBitDatabase() : BaseBitDatabase(Die::RAM_BLOCK_SIZE * 8) { add_word_settings("RAM_cfg_forward_a_addr", 0 * 8, 8); add_word_settings("RAM_cfg_forward_b_addr", 1 * 8, 8); add_word_settings("RAM_cfg_forward_a0_clk", 2 * 8, 8); add_word_settings("RAM_cfg_forward_a0_en", 3 * 8, 8); add_word_settings("RAM_cfg_forward_a0_we", 4 * 8, 8); add_word_settings("RAM_cfg_forward_a1_clk", 5 * 8, 8); add_word_settings("RAM_cfg_forward_a1_en", 6 * 8, 8); add_word_settings("RAM_cfg_forward_a1_we", 7 * 8, 8); add_word_settings("RAM_cfg_forward_b0_clk", 8 * 8, 8); add_word_settings("RAM_cfg_forward_b0_en", 9 * 8, 8); add_word_settings("RAM_cfg_forward_b0_we", 10 * 8, 8); add_word_settings("RAM_cfg_forward_b1_clk", 11 * 8, 8); add_word_settings("RAM_cfg_forward_b1_en", 12 * 8, 8); add_word_settings("RAM_cfg_forward_b1_we", 13 * 8, 8); add_word_settings("RAM_cfg_sram_mode_i_cfg", 14 * 8, 8); add_word_settings("RAM_cfg_in_out_cfg", 15 * 8, 8); add_word_settings("RAM_cfg_out_cfg", 16 * 8, 8); add_word_settings("RAM_cfg_out_b1_cfg", 17 * 8, 8); add_word_settings("RAM_cfg_wrmode_outreg", 18 * 8, 8); add_word_settings("RAM_cfg_inversion", 19 * 8, 8); add_word_settings("RAM_cfg_inv_ecc_dyn", 20 * 8, 8); add_word_settings("RAM_cfg_fifo_sync_empty", 21 * 8, 8); add_word_settings("RAM_cfg_fifo_empty", 22 * 8, 8); add_word_settings("RAM_cfg_fifo_aync_full", 23 * 8, 8); add_word_settings("RAM_cfg_fifo_full", 24 * 8, 8); add_word_settings("RAM_cfg_sram_delay", 25 * 8, 8); add_word_settings("RAM_cfg_datbm_cascade", 26 * 8, 8); add_unknowns(); } ConfigBitDatabase::ConfigBitDatabase() : BaseBitDatabase(Die::DIE_CONFIG_SIZE * 8) { int pos = 0; for (int i = 0; i < 4; i++) { add_word_settings(stringf("PLL%d.CFG_A", i), pos, 96); pos += 96; add_word_settings(stringf("PLL%d.CFG_B", i), pos, 96); pos += 96; } add_word_settings("CLKIN.PLL0", pos + 0, 8); add_word_settings("CLKIN.PLL1", pos + 8, 8); add_word_settings("CLKIN.PLL2", pos + 16, 8); add_word_settings("CLKIN.PLL3", pos + 24, 8); add_word_settings("GLBOUT.PLL0", pos + 32, 16); add_word_settings("GLBOUT.PLL1", pos + 48, 16); add_word_settings("GLBOUT.PLL2", pos + 64, 16); add_word_settings("GLBOUT.PLL3", pos + 80, 16); pos = Die::STATUS_CFG_START * 8; add_word_settings("GPIO.BANK_S1", pos + 16, 1); add_word_settings("GPIO.BANK_S2", pos + 17, 1); add_word_settings("GPIO.BANK_CFG", pos + 19, 1); add_word_settings("GPIO.BANK_E1", pos + 20, 1); add_word_settings("GPIO.BANK_E2", pos + 21, 1); add_word_settings("GPIO.BANK_N1", pos + 24, 1); add_word_settings("GPIO.BANK_N2", pos + 25, 1); add_word_settings("GPIO.BANK_W1", pos + 28, 1); add_word_settings("GPIO.BANK_W2", pos + 29, 1); pos += 32; for (int i = 0; i < Die::MAX_PLL; i++) { add_word_settings(stringf("PLL%d.CTRL_A", i), pos + 0, 8); add_word_settings(stringf("PLL%d.CTRL_B", i), pos + 8, 8); pos += 16; } } std::vector WordSettingBits::get_value(const std::vector &tile) const { std::vector val; for (int i = start; i < end; i++) val.push_back(tile[i]); return val; } void WordSettingBits::set_value(std::vector &tile, const std::vector &value) const { for (int i = start; i < end; i++) tile[i] = value[i - start]; } DatabaseConflictError::DatabaseConflictError(const std::string &desc) : runtime_error(desc) {} } // namespace GateMate