53 lines
1.8 KiB
ReStructuredText
53 lines
1.8 KiB
ReStructuredText
.. _file_format_pin_table_file:
|
|
|
|
Pin Table File (.csv)
|
|
---------------------
|
|
|
|
.. note:: This file is typically a spreadsheet provided by FPGA vendors. Please contact your vendor for the exact file.
|
|
|
|
.. note:: OpenFPGA will not include or guarantee the correctness of the file!!!
|
|
|
|
The pin table file is the file which describes the pin mapping between a chip and an FPGA inside the chip.
|
|
|
|
An example of the file is shown as follows.
|
|
|
|
.. code-block:: xml
|
|
|
|
orientation,row,col,pin_num_in_cell,port_name,mapped_pin,GPIO_type,Associated Clock,Clock Edge
|
|
TOP,,,,gfpga_pad_IO_A2F[0],pad_fpga_io[0],in,,
|
|
TOP,,,,gfpga_pad_IO_F2A[0],pad_fpga_io[0],out,,
|
|
TOP,,,,gfpga_pad_IO_A2F[4],pad_fpga_io[1],in,,
|
|
TOP,,,,gfpga_pad_IO_F2A[4],pad_fpga_io[1],out,,
|
|
TOP,,,,gfpga_pad_IO_A2F[8],pad_fpga_io[2],in,,
|
|
TOP,,,,gfpga_pad_IO_F2A[8],pad_fpga_io[2],out,,
|
|
TOP,,,,gfpga_pad_IO_A2F[31],pad_fpga_io[3],in,,
|
|
TOP,,,,gfpga_pad_IO_F2A[31],pad_fpga_io[3],out,,
|
|
RIGHT,,,,gfpga_pad_IO_A2F[32],pad_fpga_io[4],in,,
|
|
RIGHT,,,,gfpga_pad_IO_F2A[32],pad_fpga_io[4],out,,
|
|
RIGHT,,,,gfpga_pad_IO_A2F[40],pad_fpga_io[5],in,,
|
|
RIGHT,,,,gfpga_pad_IO_F2A[40],pad_fpga_io[5],out,,
|
|
BOTTOM,,,,gfpga_pad_IO_A2F[64],pad_fpga_io[6],in,,
|
|
BOTTOM,,,,gfpga_pad_IO_F2A[64],pad_fpga_io[6],out,,
|
|
LEFT,,,,gfpga_pad_IO_F2A[127],pad_fpga_io[7],in,,
|
|
LEFT,,,,gfpga_pad_IO_A2F[127],pad_fpga_io[7],out,,
|
|
|
|
An pin table may serve in various purposes. However, for OpenFPGA, the following attributes are required
|
|
|
|
.. option:: orientation
|
|
|
|
Specify on which side the pin locates
|
|
|
|
.. option:: port_name
|
|
|
|
Specify the port name of the FPGA fabric
|
|
|
|
.. option:: mapped_pin
|
|
|
|
Specify the pin name of the FPGA chip
|
|
|
|
.. option:: GPIO_type
|
|
|
|
Specify the pin direction. Can be [``in``|``out``].
|
|
|
|
.. note:: This column can be left as empty if users follow quicklogic style. See details in :ref:`openfpga_setup_commands_pcf2place`
|