Nearist greatly accelerates big data searches through a revolutionary new hardware platform specifically engineered to handle the computationally demanding task of performing Nearest Neighbor Search on vector representations of content—enabling your search routines to deliver results several orders of magnitude faster than anything else on the market.
This repository contains the tool required to program the 21 Distance Calculation Engines (DCEs) via the host instead of JTAG. for more information about the DCE see the !!!vsx-core-dce repository!!! spi_cfg hooks onto the VSX spi programming device files.
Run CMake cmake CMakeLists.txt
Run make make
spi_cfg executable will be in './bin'
Usage example:
spi_cfg (-b|--board) integer (-l|--lane) integer (-c|--cmd) string [(-h|--help)] [(-a|--sea) string] [(-d|--sed) string] [(-m|--mask) integer] [(-f|--freq) integer] [(-p|--pol) integer] [(-o|--phase) integer]
Options:
-h or --help: Displays this information.
-b or --board integer: Board number. Required.
-l or --lane integer: Lane number. Required.
-c or --cmd string: Command. Required.
-a or --sea string: SEA file.
-d or --sed string: SED file.
-m or --mask integer: FPGA Select.
-f or --freq integer: SPI Frequency.
-p or --pol integer: SPI Polarity.
-o or --phase integer: SPI Phase.
| flag | description | normal value | accepted range |
|---|---|---|---|
| -h | help, displays above | n/a | n/a |
| -b | board #, determines the set of device files the utility will hook to in a multiVSX system (mandatory argument) | 0 | 0-99 |
| -l | lane #, selects between the 3 lanes of the DCEs on the board selected (mandatory argument) | 0 | 0-2 |
| -c | command, see table below for more information (mandatory argument) | n/a | n/a |
| -a | fully qualified path to Algorithm file to be programmed | n/a | n/a |
| -d | fully qualified path to Data file to be programmed | n/a | n/a |
| -m | selects which of the 7 DCE fpgas of the lane and board selected will be programmed with the SED file | 0x7f | 0x01-0x7f |
| -f | SPI sck Frequency | 10 | 2-10 |
| -p | SPI Polarity | 0 | 0-1 |
| -o | SPI Phase | 0 | 0-1 |
This is a binary mask. the values in the above table are hexadecimal values. 0x7F in binary is 0111 1111. The value is in big-endian format.
Command Options (-c)
| Command | Description | Req Arguments |
|---|---|---|
| reset_all | sends a reset command that puts all selected DCE FPGAs into a null state (-m has no effect) | n/a |
| spi_cfg | configure setting of the SPI controller in the Artix 7 Agent FPGA | -f,-p,-o |
| prog_pulse | sends a test pulse down the SPI lines to ensure everything is initialized correctly | n/a |
| prog_fpga | programs the selected DCE FPGAs with the programming files | -a,-d,-m |
see scripts in /bin for usage examples