diff --git a/docs/architecture/glossary.rst b/docs/architecture/glossary.rst index ef29cec2..5687022a 100644 --- a/docs/architecture/glossary.rst +++ b/docs/architecture/glossary.rst @@ -7,66 +7,130 @@ Glossary BEL basic logic element BLE - For example a LUT5, LUT6, CARRY4, or MUX, but not PIPs. + Basic elements (BELs) or basic logic element (BLEs) + are the basic logic units in an FPGA, including + carry or fast adders (CFAs), flip flops (FFs), lookup tables (LUTs), + multiplexers (MUXes), and other element types. + Note: Programmable interconnects (PIPs) are not counted as BELs. - BELs come in two types: + BELs come in two forms: * Basic BEL - A logic unit which does things. - * Routing BEL - A unit which is statically configured at the routing time. + * Routing BEL - A unit which is statically configured at routing time. - bitstream + Bitstream Binary data that is directly loaded into an FPGA to perform configuration. Contains configuration :term:`frames ` as well as programming sequences and other commands required to load and activate same. - clock domain + Clock domain Portion of a :term:`horizontal clock row` to one side of the global clock spine. Often refers to :term:`tiles ` that are associated with these clocks. - column - Collection of :term:`tiles ` physically organized as a vertical line. + Column + A term used in :term:`bitstream` configuration to denote + a collection of :term:`tiles `, physically organized as + a vertical line, and configured by the same set of configuration frames. + Logic columns span 50 tiles vertically and 2 tiles horizontally + (pairs of logic tiles and interconnect tiles). - configurable logic block CLB - Basic building block of logic. + Configurable logic block + A configurable logic block (CLB) is the configurable logic unit of an FPGA. + Also called a **logic cell**. A CLB is a combination of basic logic elements + (:term:`BELs `). - frame - Fundamental unit of configuration data consisting of 101 :term:`words `. + Database + Text files containing meaningful labels for bit positions within + :term:`segments `. - half + Frame + The fundamental unit of :term:`bitstream` configuration data consisting of + 101 :term:`words `. + Each frame has a 32-bit frame address and 101 payload words, 32 bits each. + The 50th payload word is an EEC. + The 7 LSB bits of the frame address are the frame index within the + configuration :term:`column` (called *minor frame address* in the Xilinx + documentation). The rest of the frame address identifies the configuration + column (called *base frame address* in Project X-Ray nomenclature). + + The bits in an individual frame are spread out over the entire column. + For example, in a logic column with 50 tiles, the first tile is configured + with the first two words in each frame, the next tile with the next two + words, and so on. + + Frame base address + The first configuration frame address for a :term:`column`. A frame base + address has always the 7 LSB bits cleared. + + Fuzzer + Scripts and a makefile to generate one or more :term:`specimens ` + and then convert the data from those specimens into a :term:`database`. + + Half Portion of a device defined by a virtual line dividing the two sets of global - clock buffers present in a device. The two halves are simply referred to as + clock buffers present in a device. The two halves are referred to as the top and bottom halves. - node - Collection of :term:`wires ` spanning one or more tiles. - - programmable interconnect point - PIP - Connection point between two wires in a tile that may be enabled or - disabled by the configuration. - - horizontal clock row + Horizontal clock row Portion of a device including 12 horizontal clocks and the 50 interconnect and function tiles associated with them. A :term:`half` contains one or more horizontal clock rows and each half may have a different number of rows. - site - Portion of a tile where :term:`BELs ` can be placed. :term:`Slices - ` in a :term:`CLB` tile are sites. + Node + A routing node on the device. A node is a collection of :term:`wires ` + spanning one or more :term:`tiles `. + Nodes that are local to a tile map 1:1 to a wire. A node that spans multiple + tiles maps to multiple wires, one in each tile it spans. - slice - Portion of a :term:`CLB` tile that contains :term:`BELs `. + PIP + Programmable interconnect point + A programmable interconnect point (PIP) is a connection point between two + wires in a tile that may be enabled or disabled by the configuration. + + ROI + Region of interest + Region of interest (ROI) is used in *Project X-Ray* to denote a + rectangular region on the FPGA that is the current focus of our study. + The current region of interest is `SLICE_X12Y100:SLICE_X27Y149` + on a `xc7a50tfgg484-1` chip. - tile + Segment + All configuration bits for a horizontal slice of a :term:`column`. + This corresponds to two ranges: a range of :term:`frames ` + and a range of :term:`words ` within frames. A segment of a logic + column is 36 frames wide and 2 words high. + + Site + Portion of a tile where :term:`BELs ` can be placed. The + :term:`slices ` in a :term:`CLB` tile are sites. + + Slice + Portion of a :term:`tile` that contains :term:`BELs `. + A `CLBLL_L/CLBLL_R` tile contains two `SLICEL` slices. + A `CLBLM_L/CLBLM_R` tile contains one `SLICEL` slice and one `SLICEM` slice. + + Specimen + A :term:`bitstream` of a (usually auto-generated) design with additional + files containing information about the placed and routed design. + These additional files are usually generated using Vivado TCL scripts + querying the Vivado design database. + + Tile Fundamental unit of physical structure containing a single type of - resource or function. + resource or function. A container for :term:`sites ` and + :term:`slices `. The whole chip is a grid of tiles. - wire + The most important tile types are left and right interconnect tiles + (`INT_L` and `INT_R`) and left and right :term:`CLB` logic/memory tiles + (`CLBLL_L`, `CLBLL_R`, `CLBLM_L`, `CLBLM_R`). + + Wire Physical wire within a :term:`tile`. - word - 32-bits stored in big-endian order. Fundamental unit of :term:`bitstream` format. + Word + 32 bits stored in big-endian order. Fundamental unit of :term:`bitstream` + format. diff --git a/docs/architecture/overview.rst b/docs/architecture/overview.rst index ec66cfb1..4e1a139a 100644 --- a/docs/architecture/overview.rst +++ b/docs/architecture/overview.rst @@ -28,6 +28,6 @@ may be used within a single clock domain, connected to span both clock domains in a horizontal clock row, or connected to global clocks. Clock domains have a fixed height of 50 :term:`interconnect tiles -` centered around the horizontal clock lines (25 above, 25 +` centered around the horizontal clock lines (25 above, 25 below). Various function tiles, such as :term:`CLBs `, are attached to interconnect tiles.