GWSTART(1) Retro Project Manual GWSTART(1) NNAAMMEE gwstart - gtkwave starter SSYYNNOOPPSSIISS ggwwssttaarrtt [_-_n_w] _F_I_L_E DDEESSCCRRIIPPTTIIOONN ggwwssttaarrtt starts ggttkkwwaavvee(1) with wave file _F_I_L_E and adds several Tcl com- mands that provide a convenient interface for the inspection of the signal hierarchy generated by gghhddll(1) and the definition of display traces. The additional Tcl commands are: ggwwllssssiigg list signals ggwwaaddddssiigg add a signal trace to the display ggwwaaddddccoomm add a comment separator to the display ggwwaadddd add a signal definition set to the display The typical usage is to first explore the signal hierarchy interac- tively with ggwwllssssiigg and to create a display with the relevant signals with ggwwaaddddssiigg. In a second step, signal definition sets, usually just lists of ggwwaaddddssiigg and ggwwaaddddccoomm commands, are defined and stored in project-specific files. After that, ggwwssttaarrtt is usually started with the environment variable GGWWSSTTAARRTT__LLIIBB, which points to the directory of the project-specific signal definition set files. The definition of a dis- play is then quickly done with one or more ggwwaadddd commands. OOPPTTIIOONNSS --nnww Disables Tcl command line input on _s_t_d_i_o. TTCCLL CCOOMMMMAANNDDSS ggwwllssssiigg [_-_r_e] [_S_I_G_N_A_M]... Lists all signals that match _S_I_G_N_A_M. By default _S_I_G_N_A_M is interpreted as a glob pattern, where a '*' wildcard matches name components between the hierarchy separator '.' and a '**' wildcard matches name components across hierarchy separator boundaries. If the --rree option is specified, _S_I_G_N_A_M is interpreted as a regular expression. If no _S_I_G_N_A_M is speci- fied, all available signals are listed. See EXAMPLES - TCL section. ggwwaaddddssiigg [_O_P_T_I_O_N]... [_S_I_G_N_A_M]... Adds all signals that match _S_I_G_N_A_M to the display. The _S_I_G_N_A_M name syn- tax is the same as for the ggwwllssssiigg command. The available _O_P_T_I_O_Ns are --rree interpret _S_I_G_N_A_M as regular expression, default is glob --bbiinn use binary as data format --oocctt use octal as data format --ddeecc use decimal as data format --ssddeecc use signed decimal as data format --hheexx use hexadecimal as data format --aasscc use ASCII as data format ggwwaaddddccoomm _T_E_X_T Add a comment separator with text _T_E_X_T to the display. ggwwaadddd _S_E_T_N_A_M_E Process the signal definition set _S_E_T_N_A_M_E. The command searches for a file _S_E_T_N_A_M_E.tcl in the gwadd search path and sources it. The file must contain Tcl commands that are valid in the ggttkkwwaavvee(1) environment. Usually, these files contain only ggwwaaddddccoomm and ggwwaaddddssiigg commands. The search path is defined via the GGWWSSTTAARRTT__LLIIBB environment variable. EENNVVIIRROONNMMEENNTT GGWWSSTTAARRTT__LLIIBB Defines a ':' separated path list used by the ggwwaadddd command. If not defined, the default '.' is used. EEXXAAMMPPLLEESS -- CCOOMMMMAANNDD ggwwssttaarrtt ttbb__ww1111aa__cc77..gghhww Starts ggttkkwwaavvee(1) with Tcl command line input enabled on _s_t_d_i_o and reads the file _t_b___w_1_1_a___c_7_._g_h_w. EEXXAAMMPPLLEESS -- TTCCLL Some examples for the additional Tcl commands provided by ggwwssttaarrtt. ggwwllssssiigg {{****..ccllkk}} Lists all signals with the name _c_l_k. The leading _*_*_. matches all instances of the hierarchy. ggwwllssssiigg --rree {{..**..ccllkk}} Same result as previous example, now with regular expression match instead of glob match. Lists all signals with the name _c_l_k. ggwwllssssiigg {{****..ttrreeqq__**}} Lists all signals with a name starting with _t_r_e_q__. Output like top.tb_cmoda7_sram.uut.sys70.w11a.seq.r_status.treq_mmu top.tb_cmoda7_sram.uut.sys70.w11a.seq.r_status.treq_tbit top.tb_cmoda7_sram.uut.sys70.w11a.seq.r_status.treq_ysv ggwwaaddddssiigg {{****..sseeqq..rr__ssttaattuuss..ttrreeqq__**}} Add all signals with a name starting with _t_r_e_q__ of the entity _*_*_._s_e_q_._r___s_t_a_t_u_s to the display. A leading '**.' is often used to shorten the name pattern and write only the minimal required for uniqueness. ggwwaaddddssiigg --oocctt {{****..vvmmbbooxx..vvmm__aaddddrr}} Add the signal _a_d_d_r from entity _*_*_._v_m_b_o_x to the display and use oc- tal as data format. ggwwaaddddccoomm mmmmuu Adds a comment separator titled "mmu" to the display. ggwwaadddd vvmmbbooxx Process the signal definition set _v_m_b_o_x. The command will search for a file _m_m_u_._t_c_l in the gwadd seach path and source it. SSEEEE AALLSSOO ggttkkwwaavvee(1), gghhddll(1) AAUUTTHHOORR Walter F.J. Mueller Retro Project 2023-02-07 GWSTART(1)