TBRUN_TBW(1) Retro Project Manual TBRUN_TBW(1) NNAAMMEE tbrun_tbw - ttbbww-based test bench starter SSYYNNOOPPSSIISS ttbbrruunn__ttbbww [_O_P_T_I_O_N]... _T_B_E_N_C_H [_S_T_I_M_F_I_L_E] DDEESSCCRRIIPPTTIIOONN ttbbrruunn__ttbbww is a convenience script for starting ttbbww(1)-based test benches. It will - issue a mmaakkee(1) command to (re)-build _T_B_E_N_C_H. - build a ttbbww(1) command, using _S_T_I_M_F_I_L_E if specified. - create a shell pipe which runs tbw and handles the test bench out- put with ttbbffiilltt(1) to determine success or failure. OOPPTTIIOONNSS Note: ttbbrruunn__ttbbww is implemented as a shell script. If options have an argument it is separated by white space and not by '='! So write '--ghw xxx' and not '--ghw=xxx' ! ----ddrryy dry run, prints the commands but doesn't execute ----nnoommaakkee don't execute make step (_T_B_E_N_C_H neither build nor updated) ----nnoorruunn don't execute test bench (useful to only execute make step) ----llssuuff _s_u_f_f use '__s_u_f_f.log' as a suffix for the log file. Default is '_bsim.log' ----ssttaacckk _n_n_n use _n_n_n as gghhddll(1) stack size ----gghhww _f_n_a_m_e write a ghw file with name '_f_n_a_m_e.ghw' ----ttbbww _o_p_t_s append _o_p_t_s to the ttbbww(1) command ----ppccoomm enables that test bench comments are passed to _s_t_d_o_u_t. EEXXAAMMPPLLEESS ttbbrruunn__ttbbww ttbb__sseerrppoorrtt__uuaarrtt__rrxx Simplest default case, will execute in essence make tb_serport_uart_rx tbw tb_serport_uart_rx 2>&1 | tbfilt The issued command is more involved, defines TIMEFORMAT, adds a bash 'time', and some redirects to ensure that the 'time' output ends up in the log file. SSEEEE AALLSSOO ttbbww(1), ttbbffiilltt(1), gghhddll(1) AAUUTTHHOORR Walter F.J. Mueller Retro Project 2016-08-21 TBRUN_TBW(1)