CONFIG_WRAPPER(1) Retro Project Manual CONFIG_WRAPPER(1) NNAAMMEE config_wrapper - configure FPGA via ISE impact or Linux jtag SSYYNNOOPPSSIISS ccoonnffiigg__wwrraappppeerr [----bbooaarrdd==_b] [----ppaatthh==_p] _C_O_M_M_A_N_D _F_I_L_E ccoonnffiigg__wwrraappppeerr ----hheellpp DDEESSCCRRIIPPTTIIOONN Wrapper script to handle the configuration of an FPGA board with either a XILINX JTAG programming cable and the ISE iimmppaacctt program or with an onboard Cypress FX2 USB controller and the jjttaagg(1) program. The _C_O_M_- _M_A_N_D argument controls the action: iiccoonnffiigg configure using iimmppaacctt with _._b_i_t file _F_I_L_E jjccoonnffiigg configure using jjttaagg(1) with _._s_v_f file _F_I_L_E bbiitt22ssvvff create a _._s_v_f file from the _._b_i_t file _F_I_L_E OOPPTTIIOONNSS ----bbooaarrdd==_b determines the type of board to be configured. The default is 's3board', currently supported boards are: ss33bbooaarrdd Digilent S3BOARD. Default path: xc3s1000 nneexxyyss22 Digilent Nexys2. Default path: xc3s1200e nneexxyyss33 Digilent Nexys3. Default path: xc6slx16 aattllyyss Digilent Atlys. Default path: xc6slx45 sspp660055 Xilinx SP605. Default path: xc6slx45t ----ppaatthh==_p determines the type of FPGA to be configured. It is usually properly defaulted based on the ----bbooaarrdd option. Only in cases where a board is available with several die sizes this option will be needed. ----hheellpp print help text and exit. CCOOMMMMAANNDDSS bbiitt22ssvvff Convert an FPGA configuration file from _._b_i_t format (the native XILINX format) to _._s_v_f format (the portable Serial Vector For- mat). The XILINX ISE iimmppaacctt program is used, the input _F_I_L_E must be in _._b_i_t format. iiccoonnffiigg Configure an FPGA with XILINX ISE iimmppaacctt. The input _F_I_L_E must be in _._b_i_t format. jjccoonnffiigg Configure an FPGA with jjttaagg(1). The input _F_I_L_E must be in _._s_v_f format. This subcommand is usually used for boards with a Cy- press FX2 USB controller, like the Digilent Nexys2, Nexys3, or Atlys, and an FX2 firmware that emulates an Altera USB-Blaster programming cable. The USB device path is defined by the environment variables RREETTRROO__FFXX22__VVIIDD and RREETTRROO__FFXX22__PPIIDD, or defaults to vid=16c0 and pid=03ef. Use the ffxx22llooaadd__wwrraappppeerr(1) command to ensure that the proper firmware is loaded in the Cypress FX2 USB controller. The bbiitt22ssvvff subcommand can be used to create a _._s_v_f from a _._b_i_t file. EEXXIITT SSTTAATTUUSS In case of an error, an exit status 1 is returned. EENNVVIIRROONNMMEENNTT RREETTRROO__FFXX22__VVIIDD,, RREETTRROO__FFXX22__PPIIDD Used by the jjccoonnffiigg subcommand to define the USB path of the Cy- press FX2 USB controller emulating an Altera USB-Blaster cable. XXIILLIINNXX Path to current XILINX ISE installation. Required by all subcom- mands, mainly to locate the _._b_s_d_l files which describe the JTAG commands of all devices in the JTAG chain. The best is to use ccoonnffiigg__wwrraappppeerr with the xxttwwii(1) wrapper, this will automatically define this environment variable. EEXXAAMMPPLLEESS ccoonnffiigg__wwrraappppeerr bbiitt22ssvvff tteesstt..bbiitt Creates _t_e_s_t_._s_v_f from _t_e_s_t_._b_i_t. ccoonnffiigg__wwrraappppeerr ----bbooaarrdd==nneexxyyss22 iiccoonnffiigg tteesstt..bbiitt Configures a Nexys2 board with _t_e_s_t_._b_i_t using ISE iimmppaacctt. ccoonnffiigg__wwrraappppeerr ----bbooaarrdd==nneexxyyss33 jjccoonnffiigg tteesstt..ssvvff Configures a Nexys3 board with _t_e_s_t_._s_v_f using jjttaagg(1). SSEEEE AALLSSOO jjttaagg(1), ffxx22llooaadd__wwrraappppeerr(1), xxttwwii(1) AAUUTTHHOORR Walter F.J. Mueller Retro Project 2013-01-02 CONFIG_WRAPPER(1)