v2html.man.html

v2html - verilog to html converter 主要为FPGA和ASIC工作人员

<DD>
No unconnected. See <STRONG>-nnm</STRONG>. Makes <STRONG>v2html</STRONG> skip writing the list
of unconnected modules in the hierarchy file.
<P></P>
<DT><STRONG><A NAME="item_%2Dnh"><STRONG>-nh</STRONG></A></STRONG><BR>
<DD>
No hierarchy. Don't print out the hierarchy.
<P></P>
<DT><STRONG><A NAME="item_%2Dnindex"><STRONG>-nindex</STRONG></A></STRONG><BR>
<DD>
No indexes. Don't print out the indexes.
<P></P>
<DT><STRONG><A NAME="item_%2Dni"><STRONG>-ni</STRONG></A></STRONG><BR>
<DD>
By default <STRONG>v2html</STRONG> 'greys out' any code that is ifdefed out. The <STRONG>-ni</STRONG>
turns this greying out off. Note that v2html always ignores code that is
ifdefed out when it is parsing.
<P></P>
<DT><STRONG><A NAME="item_%2Dz"><STRONG>-z</STRONG></A></STRONG><BR>
<DD>
Compress the html files generated (and make sure the links point to
the compressed versions). This can be useful if you convert machine
generated code, like ASIC RAM macros which are huge before they are
converted and even bigger afterwards.
<P></P>
<DT><STRONG><A NAME="item_%2Dzc_compresser"><STRONG>-zc</STRONG>&nbsp;compresser</A></STRONG><BR>
<DD>
The executable to use to compress the html files if <STRONG>-z</STRONG> is used. The
Default is 'compress <CODE>-f</CODE>'. For instance to use gzip use <STRONG>-zc</STRONG> 'gzip <CODE>-f</CODE>'
(the <CODE>-f</CODE> stops gzip prompting you about overwriting files).
<P></P>
<DT><STRONG><A NAME="item_%2Dze_compressed_extension"><STRONG>-ze</STRONG>&nbsp;compressed_extension</A></STRONG><BR>
<DD>
The extension that your compress executable uses. The default is '.Z'. If you
were using gzip then you'd want <STRONG>-ze</STRONG> .gz
<P></P>
<DT><STRONG><A NAME="item_%2DF_%5Bframe_file%2Ehtml%5D"><STRONG>-F</STRONG>&nbsp;[frame_file.html]</A></STRONG><BR>
<DD>
Frame mode. Using <STRONG>-F</STRONG> turns on the generation of framed output
where a top level frame file is generated that creates three
frames in your browser, the top one for the hierarchy the middle
one for the code and the bottom one for any definitions to appear 
in.
<P>The default name for the frame file is frame.html. This default
can be overridden by specifying a file name after the <STRONG>-F</STRONG> option.</P>
<P></P>
<DT><STRONG><A NAME="item_%2DVF_%5Bframe_file%2Ehtml%5D"><STRONG>-VF</STRONG>&nbsp;[frame_file.html]</A></STRONG><BR>
<DD>
Same as <STRONG>-F</STRONG> but arranges the frames vertically so that the hierarchy is
down the side.
<P></P>
<DT><STRONG><A NAME="item_%2Ds"><STRONG>-s</STRONG></A></STRONG><BR>
<DD>
Link to the source. This causes the file name in From field of
the page footer to become a link to the unconverted verilog 
file:
<PRE>
 This page:
         Maintained by:         [e-mail]
         Created:               Thu Nov 6 08:53:37 1997
         From:                  /asic/verilog/test2.v</PRE>
<P>For this to work your web server must have access to the source code.
Also, you must either run v2html in the output directory or use
absolute path names for the verilog files.</P>
<P>For example, if the source is in /home/asic/verilog and the html files
want to end up in /home/www/verilog then there are two ways to run it
to get <STRONG>-s</STRONG> to work:</P>
<PRE>
  1) In the output directory with verilog files specified by relative paths:
        cd /home/www/verilog
        v2html -s ../../asic/verilog/*.v</PRE>
<PRE>
 2) In any directory with verilog files specified by absolute paths:
        cd /anywhere
        v2html -s -o /home/www/verilog   /home/asic/verilog/*.v</PRE>
<P></P>
<DT><STRONG><A NAME="item_%2Dc_%2Fcgi_script_%2Fpath_to_html_files"><STRONG>-c</STRONG>&nbsp;/cgi_script&nbsp;/path_to_html_files</A></STRONG><BR>
<DD>
Activate CGI features which allow the user to hide and show
regions of the hierarchy in a similar way to the old file manager
on windows 3.1. This method only works if you put the files on
a web server.
<P>To use this you must have installed the v2html CGI script on your
web-server. The /cgi_script is the name of the CGI script (with path).
The /path_to_v_files is the directory you are putting your html files.</P>
<P>These paths are the paths your web server sees (not the full paths on
the system) so is the same path that appears after <EM><A HREF="http://server">http://server</A></EM> when 
accessing the files.</P>
<P>Here's an example:</P>
<PRE>
  cp v2html-cgi /opt/CERNhttpd/cgi-bin/ 
  chmod 755 /opt/CERNhttpd/cgi-bin/v2html-cgi</PRE>
<PRE>
  cd /home/web/v2html/example/ex1
  v2html -c /cgi-bin/v2html-cgi /v2html/example/ex1 ../verilog/*.v</PRE>
<P>Note that <STRONG>v2html</STRONG> can't check the parameters to <STRONG>-c</STRONG> while
converting the files. You'll have to do it yourself by viewing the
hierarchy in your web browser and clicking on <STRONG>[Hide&nbsp;All]</STRONG> at the
top of the hierarchy. Make sure you view the file using the web server
(use <EM><A HREF="http://server/v2html/example/ex1/hierarchy.html">http://server/v2html/example/ex1/hierarchy.html</A></EM> rather than
<EM>file:/home/web/v2html/example/ex1/hierarchy.html</EM>).</P>
<P>Depending on your webserver you may also need to use the -css to
specify the full URL to your cascading stylesheet eg:</P>
<PRE>
 v2html -c /cgi-bin/v2html-cgi /v2html/examples/millennium_clock/hier_cgi
  -css <A HREF="http://www.burbleland.com/v2html/examples/millennium_clock/hier_cgi/v2html.css">http://www.burbleland.com/v2html/examples/millennium_clock/hier_cgi/v2html.css</A>
  *.v</PRE>
<P>If you get a message like this when you click on <STRONG>[Hide&nbsp;All]</STRONG>:</P>
<PRE>
  Bad script request -- neither '/opt/CERNhttpd/cgi-bin/v2html-cg' 
        nor '/opt/CERNhttpd/cgi-bin/v2html-cg.pp' is executable</PRE>
<P>Then either there is either a problem with the installation of the cgi
script or you have incorrectly specified the first parameter to <STRONG>-c</STRONG>.</P>
<P>If you get a message like this:</P>
<PRE>
  v2html error.</PRE>
<P>then you have probably got the second parameter to <STRONG>-c</STRONG> wrong.</P>
<P></P>
<DT><STRONG><A NAME="item_%2Dk_key_string"><STRONG>-k</STRONG>&nbsp;key_string</A></STRONG><BR>
<DD>
Specify the key to use for to stop people looking at hierarchy files
that are protected by web-server security. The default is to use a
random key, but this means that you can't have bookmarks of the
hierarchy in various states (because the bookmark will contain the
key, and the key will change each time you run <STRONG>v2html</STRONG>). To get
round this problem you can use <STRONG>-k</STRONG> and always have the same
key string. The key can be any string of digits and letters.
<P></P>
<DT><STRONG><A NAME="item_%2Dnjshier"><STRONG>-njshier</STRONG></A></STRONG><BR>
<DD>
Deactivate Javascript features that allow the user to hide and
collapse regions of the hierarchy.
<P></P>
<DT><STRONG><A NAME="item_%2Dncookies"><STRONG>-ncookies</STRONG></A></STRONG><BR>
<DD>
The Javascript version of the hierarchy uses cookies to remember the state
you left the hierarchy in, so when you next visit the hierarchy page it will
be in the same state. If you hate cookies then use the <STRONG>-ncookies</STRONG> option
to turn them off.
<P></P>
<DT><STRONG><A NAME="item_%2Dnsigpopup"><STRONG>-nsigpopup</STRONG></A></STRONG><BR>
<DD>
Turn off the generation of javascript that does the signal popup window.
Specifying this option also turns off ``Quick Search''.
<P></P>
<DT><STRONG><A NAME="item_%2Dtab_value"><STRONG>-tab</STRONG>&nbsp;value</A></STRONG><BR>
<DD>
Expand tabs to the specified value.
<P></P>
<DT><STRONG><A NAME="item_%2Ddebug"><STRONG>-debug</STRONG></A></STRONG><BR>
<DD>
Turn on lots of debugging information.
<P></P></DL>
<P>
<HR>
<H1><A NAME="author">AUTHOR</A></H1>
<P>Costas Calamvokis &lt;<EM><A HREF="mailto:[e-mail]">[e-mail]</A></EM>&gt;.</P>
<P>
<HR>
<H1><A NAME="examples">EXAMPLES</A></H1>
<P>Here is an example where <STRONG>v2html</STRONG> is run in the directory containing
the verilog files (note the <STRONG>-o</STRONG> option):</P>
<PRE>
  cd /users/jb/verilog_files/
  v2html -F my_frame.html -h my_hier.html -ht chip_top -htf -nu
    -o /users/www/project/verilog -m [e-mail] -s *.v</PRE>
<P>As the verilog files don't have absolute paths and we aren't running
in the destination directory can't use <STRONG>-s</STRONG> (link to source) as the
links <STRONG>v2html</STRONG> will create wouldn't allow the web server to find the
files.</P>
<P>Here is an example where <STRONG>v2html</STRONG> is run in the directory where
we want the html files (no <STRONG>-o</STRONG> option):</P>
<PRE>
  cd  /users/www/project/verilog
  v2html -F my_frame.html -h my_hier.html -ht chip_top -nu -htf
    -m [e-mail] -s  
    -c /cgi-bin/v2html-cgi /project/verilog ../../../jb/verilog_files/*.v</PRE>
<P>Here we can use the <STRONG>-s</STRONG> option because we are running the the destination
directory, so the links <STRONG>v2html</STRONG> creates to the source will work
(providing the web server is allowed to server files from
/users/jb/verilog_files).</P>
<P>
<HR>
<H1><A NAME="diagnostics">DIAGNOSTICS</A></H1>
<P>By default <STRONG>v2html</STRONG> tells you a lot about what it is doing (this is
because it is slow and if it didn't you'd think it had crashed!). These
messages can get in the way of the warnings <STRONG>v2html</STRONG> produces, so if
you have a problem first try <STRONG>-q</STRONG> (quiet) to see if there are any warnings
you missed in the deluge of messages.</P>
<P>Most of the Error messages concern failures to open files, I guess these
will be caused by bad permissions, or you pointing <STRONG>v2html</STRONG> at files
or directories that don't exist.</P>
<P>The errors that say things like:</P>
<PRE>
   Warning: Confused in t.v line 2 (state=SIGNAL_AFTER_NAME):
   wire g  xx;
           ^
mean that you have written some verilog that I wasn't expecting - send
it to me and I'll see what I can do.</PRE>
<P>Most of the warnings concern things that <STRONG>v2html</STRONG> will ignore because
it found more than one of them. The most common is a duplicate module
being found because an old copy of one of the files is lurking in
your source directory. The easiest way around this is to use the
<STRONG>-f</STRONG> option something like this:</P>
<PRE>
  ls /path/*.v | grep -v old_module_file.v &gt; src_files
  v2html -f src_files</PRE>
<P>Generally <STRONG>v2html</STRONG> will ignore duplicate things (so for example
modules won't appear in the hierarchy), but sometimes it will just pick
one of them, so watch those warnings.</P>

</BODY>

</HTML>