En esta entrada relato el camino un tanto sinuoso de comprensión de que es un archivo XDC que he seguido.
Siguiendo
los tutoriales de Vivado, que son muy claros, llegué a la parte de los constraints, los archivos XDC que dicen como se van a conectar las patitas del FPGA con los periféricos de la placa que tengas, en mi caso
Nexys-4 DDR. Si, en la página dice "retired". Entre que la pedí y llegó, eso pasó.
Previamente, había comenzado con
información específica de la placa que tengo, de seguir vos este camino con otra placa, tendrías que adaptarte.
En el paso 6 del tutorial dice de
bajarte el zip de constraints, pero preferí pegarle al repo:
git clone https://github.com/Digilent/digilent-xdc
Este es el momento en que uno debería leer la documentación para comprender que es un XDC, pero como siempre elegí arrojarme contra los archivos a ver que se puede comprender y dejar el manual para más tarde, esto es lo que hice y me funcionó bastante bien, me las puede arreglar con la adaptación de proyectos ISE a Vivado, lo que implica algo de
uso de los XDC pues hay que recrearlos a partir de los UCF y de las
interfaces del top module. Esto lo mostraré en Para estudiar Programming FPGAs: Getting Started with Verilog, cuando termine.
Volviendo, hay varios proyectos de ejempo y de ahí obtuve los links a los demos y en cada uno a los repos:
Los cloné:
git clone https://github.com/Digilent/Nexys-4-DDR-GPIO.git
git clone https://github.com/Digilent/Nexys-4-DDR-Keyboard.git
git clone https://github.com/Digilent/Nexys-4-DDR-OOB
git clone https://github.com/Digilent/Nexys-4-DDR-XADC.git
Busqué los XDC:
find Nexys-4-DDR-* -iname "*xdc"
Nexys-4-DDR-GPIO/src/constraints/Nexys4DDR_Master.xdc
Nexys-4-DDR-Keyboard/src/constraints/Nexys4DDR_Master.xdc
Nexys-4-DDR-OOB/src/constraints/Nexys4DDR_C.xdc
Nexys-4-DDR-XADC/src/constraints/Nexys4DDR_Master.xdc
Y a jugar con kdiff3 o tu herramienta de comparación preferida.
A mi me gusta esta:
kdiff3 Nexys-4-DDR-GPIO/src/constraints/Nexys4DDR_Master.xdc \
Nexys-4-DDR-XADC/src/constraints/Nexys4DDR_Master.xdc \
Nexys-4-DDR-Keyboard/src/constraints/Nexys4DDR_Master.xdc
Comparé entonces entre los cuatro proyectos y contra digilent-xdc y pensé que por algún perverso motivo, en los
get_ports los nombres cambian. Luego encontré que responde a un motivo muy sencillo: son los nombres que se le dan en los módulos a los pines, pueden venir de un diseño genérico, de otra placa, no hay manera que esos nombres sean los mismos en distintos proyectos.
Esto es el proyecto de GPIO vs el XDC virgen, en los botones cambian los nombres y en los pines de los 7 segmentos, además cambia el tipo.
Lo que dice luego es que más allá de des/comentar no es recomendado cambiar nada al menos del clock.
El proyecto más interesante es el OOB, pues toca casi todos los periféricos.
Dejando un poco de lado la exploración, que a mi me gusta y sirve pues es divertida y me hace hallar muchas preguntas que luego la documentación me responde, he aquí lo que he aprendido en la
documentación:
En una CPU y cualquier integrado "común", los pines tienen funcionalidad fijas: uno es clock(), otro es IO y así.
 |
| By Bill Bertram - Own work, CC BY 2.5, https://commons.wikimedia.org/w/index.php?curid=473063 |
En un microcontrolador, que contiene un CPU y periféricos,
cada pin tiene una o más posibles funcionalidades y un mecanismo para
configurar cual de ellas es elegida. Los pines configurables, permiten
entonces conectarse internamente a ciertos periféricos internos para
exponer su funcionalidad al exterior del chip
En esta imagen sacada del
documento elaborado por Eric Pernia que también aportó el párrafo anterior y la siguiente enumeración (gracias Eric), se pueden apreciar las funciones:
- Nombre
del pin de la serigrafía o donde está conectado (ej. LCD1 es un nombre
de pin de la serigrafía, es horrible la serigrafía de la EDU-CIAA-NXP,
confunde más de lo que ayuda).
- Número de pin del microcontrolador
(ej. 9).
- Nombre del pin que le da el fabricante
(ej. P4_4).
- Función 0
(ej. GPIO2[4]).
- Función 1
(ej. CTOUT_2).
- Función 2
(ej. LCD_VD1).
- Función 3 (ej. Reserved).
Función 4
(ej. Reserved).
- Función 5
(ej. LCD_VD20).
Función 6 (ej. U3_DIR).
- Función 7
(ej. SGPIO10).
- ANALOG_SEL (ej. DAC).
 |
| El resto de los diagramas del proyecto CIAA están aquí. |
Una FPGA puede mapear casi cualquier cosa que tenga adentro a casi cualquier pin y digo "casi" por las dudas para no decir "todo".
Pero, la FPGA está físicamente soldada a una placa entonces sus pines ya están fijados a ciertos cirtuitos electrónicos físicos inamovibles. Eso nos regresa a la situación de la CPU con respecto a algunos pines. Otros son como los de un microcontralador.
El XDC tiene entonces ese mapeo y lo provée el fabricante de la placa.
A fines prácticos:
set_property -dict { PACKAGE_PIN H17 IOSTANDARD LVCMOS33 } [get_ports { running_led }];
#IO_L18P_T2_A24_15 Sch=led[0]
PACKAGE_PIN: dice cuál pin físico es, no habría que tocar.
IOSTANDARD: tiene que ver con características electrónicas, setea a
LVCMOS33, que es GPIO.
Para el pmod JXADC tiene
IOSTANDARD LVDS, entiendo son entradas analógicas.
get_ports: dice como se va a llamar y es lo único que los básicos como yo podemos modificar.
El
comentario es útil dejarlo para saber cual era el nombre original.
En Zynq, que es un chip con un microcontrolador y una FPGA, mmh, ahí la cosa se debe complicar, cuando llegue agregaré acá o en otra entrada.
Tambien quedará para el futuro el clock:
set_property -dict { PACKAGE_PIN E3 IOSTANDARD LVCMOS33 } [get_ports { CLK }];
#IO_L12P_T1_MRCC_35 Sch=clk100mhz
create_clock -add -name sys_clk_pin -period 10.00 -waveform {0 5} [get_ports { CLK }];
A fines más prácticos, el modo de usarlo que he destilado es:
- Tener el archivo, por ejemplo en mi caso Nexys-4-DDR-Master.xdc en algún lugar accesible, con permisos 644.
- Crear el proyecto
- Copiarlo y cambiarle los permisos a 664.
- Ajustar
¿Por qué el asuntito de los permisos? Por que si al agregarlo al proyecto desde Vivado te equivocás y no le ponés "copiar", te puede quedar referenciado a tu archivo común y cuando lo modifiques rompes los otros proyectos que puedan tener el mismo defecto. Le pasó a un amigo y yo te cuento.
