Initial check in

This commit is contained in:
2026-01-03 19:05:48 +01:00
commit 1254878a31
253 changed files with 30484 additions and 0 deletions
@@ -0,0 +1,275 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>GPIF</title>
<meta name="generator" content="BBEdit 6.0">
</head>
<body bgcolor="white">
<table border="0" cellpadding="0" cellspacing="0" width="90%" align="center">
<tr valign="top">
<td colspan="1" align="left">
<p align="center"><font face="verdana, arial, helvetica, sans-serif" size="2" color="black"><b><a name="File"></a>File
Menu</b></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black"><b><br>&nbsp;</b></font>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<p>
<font face="verdana, arial, helvetica, sans-serif" size="1" color="black">The
File menu allows GPIF Designer projects to be loaded from and saved
to disk. &nbsp;It also provides a simple mechanism for starting
fresh, with a pristine, new project. &nbsp;Finally, some non-waveform-specific
project properties are also accessed&nbsp;from this menu.<br>
<br>
</font>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<font face="verdana, arial, helvetica, sans-serif" size="1" color="black"><b><a name="New"></a>New</b></font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p>
<font face="verdana, arial, helvetica, sans-serif" size="1" color="black">The
</font><font face="Verdana,Arial" size="1" color="black"><i>File|New
</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">menu
item erases all user-placed </font><a href="WavefmEditors.htm#ActionPoints"><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">waveform
action points</font></a><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
and&nbsp;resets all block diagram settings to default values
for the selected chip.<br><br>Selection of </font><font face="Verdana,Arial" size="1" color="black"><i>File|New</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
will bring-up the </font><a href="BlockDiagram.htm#Chip"><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">Chip
Selection</font></a><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
dialog box. &nbsp;The selection of a chip is needed in order
to determine default values for the new block diagram.<br><br>The
</font><font face="Verdana,Arial" size="1" color="black"><i>File|New</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
item severs any attachment to a GPIF Designer project file.
&nbsp;So, the </font><font face="Verdana,Arial" size="1" color="black"><i>File|Save</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
operation is temporarily disabled until the new project has
been saved using the </font><font face="Verdana,Arial" size="1" color="black"><i>File|Save
As . . .</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
menu item.<br>&nbsp;</font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<font face="verdana, arial, helvetica, sans-serif" size="1" color="black"><b><a name="Open"></a>Open</b></font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p>
<font face="Verdana,Arial" size="1" color="black"><i>File|Open</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
has the expected functionality of allowing the user to select
a previously saved GPIF Designer project file.<br><br>When the
program launches, the default directory for &nbsp;</font><font face="Verdana,Arial" size="1" color="black"><i>File|Open</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
is set to the directory in which GPIF Designer exectable file
is located. &nbsp;When a Designer project file (.gpf) has been
opened, the starting directory for </font><font face="Verdana,Arial" size="1" color="black"><i>File|Open</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
is set to the directory of&nbsp;the current project file.<br><br>One important side effect
of </font><font face="Verdana,Arial" size="1" color="black"><i>File|Open</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black"> is that, if GPIF
Designer finds a file named &quot;app_note.htm&quot; in the
directory from which the project file is loaded, that file will
be accessible from the </font><a href="HelpMenu.htm#Project"><font face="Verdana,Arial" size="1" color="black"><i>This
Project</i></font></a><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
item of the Help menu.<br><br>The name and path of the currently
open (i.e. active) project file is displayed in the caption
of the GPIF Designer main window.<br>&nbsp;</font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<font face="verdana, arial, helvetica, sans-serif" size="1" color="black"><b><a name="Save"></a>Save</b></font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p>
<font face="Verdana,Arial" size="1" color="black"><i>File|Save</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
writes all the block diagram and waveform information to the
currently active&nbsp;GPIF Designer project file. &nbsp;The
waveforms of all enabled </font><a href="ToolsMenu.htm#SelectBank"><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">banks</font></a><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
are saved.<br>&nbsp;</font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<font face="verdana, arial, helvetica, sans-serif" size="1" color="black"><b><a name="SaveAs"></a>Save
As</b></font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p>
<font face="Verdana,Arial" size="1" color="black"><i>File|Save
As</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
prompts for a name and location of the new GPIF Designer project
file in which to save all the block diagram and waveform information.
&nbsp;After saving the data, the new file becomes the currently
open (i.e. active) project file.<br><br>GPIF Designer project
files should have the suffix .gpf.&nbsp; <br>
</font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<font face="verdana, arial, helvetica, sans-serif" size="1" color="black"><b><a name="Properties"></a>Properties</b></font>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p>
<font face="verdana, arial, helvetica, sans-serif" size="1" color="black">The
</font><font face="Verdana,Arial" size="1" color="black"><i>File|Properties</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
menu item brings-up the Properties dialog box shown below.<br></font>
<p align="center"><img src="images/FileProps.gif" width="432" height="327" border="0"></p>
<p><font face="verdana, arial, helvetica, sans-serif" size="1" color="black"><br>The
</font><font face="Verdana,Arial" size="1" color="black"><i>Show
vertical grid on waveform diagrams</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
checkbox allows modification of&nbsp;the waveform appearance
to show or hide the vertical grid lines. &nbsp;Below is an example
of a waveform without the grid lines. &nbsp;</font></p>
<p align="center"><img src="images/NoGrid.gif" width="432" height="327" border="0"></p>
<p><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">By
default, the vertical grid lines are turned-on when </font><font face="Verdana,Arial" size="1" color="black"><i>File|New</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
is invoked.&nbsp;&nbsp;This setting is saved along with all
other parameters to the GPIF Designer project files (*.gpf)
when the </font><font face="Verdana,Arial" size="1" color="black"><i>File|Save</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
or </font><font face="Verdana,Arial" size="1" color="black"><i>File|Save
As</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
operations are performed. &nbsp;<br><br></font></p>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p><font face="Verdana,Arial" size="1" color="black"><b><a name="DebugOutput"></a></b></font><font face="Verdana" size="1" color="black"><b>Debug
Output</b></font></p>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">The
</font><font face="Verdana,Arial" size="1" color="black"><i>Enable
GPIF Debug Output on PE[2:0]</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
checkbox controls the value of the GSTATE bit (b2) of the IFCONFIG
register. &nbsp;Check this box in order to read the values of
GSTATE bits [2:0]&nbsp;on lines&nbsp;[2:0] of port E.<br>&nbsp;</font></p>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p><font face="Verdana,Arial" size="1" color="black"><b><a name="EnableBanks"></a>Waveform
Banks Enabled</b></font></p>
</ul>
</td>
</tr>
<tr valign="top">
<td colspan="1" align="left">
<ul>
<p><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">GPIF
Designer is able to manage up to 8 sets (i.e. banks) of waveform
descriptors. &nbsp;Each bank&nbsp;consists of 4 waveform descriptors,
which are displayed on the 4 waveform editor tab pages. &nbsp;At
any one time, only one bank of waveform descriptors is displayed.
&nbsp;However, the displayed bank of descriptors can be switched
via the </font><a href="ToolsMenu.htm#SelectBank"><i><font face="Verdana,Arial" size="1" color="black">Tools|Select
Waveform Bank</font></i></a><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
menu item.<br><br>The number of waveform banks available is
configured using the </font><font face="Verdana,Arial" size="1" color="black"><i>Waveform
Banks Enabled</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
field of the </font><font face="Verdana,Arial" size="1" color="black"><i>File|Properties</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
dialog box. &nbsp;<br></font></p>
<p align="center"><img src="images/FileProps.gif" width="432" height="327" border="0"></p>
<p><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">When the
</font><font face="Verdana,Arial" size="1" color="black"><i>Tools|Export
to GPIF.c</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
file menu item is invoked, waveform
descriptor data structures are exported for all enabled banks. &nbsp;If
more than 1 bank is enabled, the resulting &quot;*.c&quot; file will
be larger
and more complex.<br><br>It is more common to use the multiple
banks to store variations of similar waveforms, for training purposes,
than to actually generate multiple waveform descriptor data
structures in an exported .c file.<br><br>By default, only 1
waveform bank is enabled when </font><font face="Verdana,Arial" size="1" color="black"><i>File|New</i></font><font face="verdana, arial, helvetica, sans-serif" size="1" color="black">
is invoked.</font></p>
</ul>
</td>
</tr>
</table>
<p>&nbsp;</p>
</font>
</body>
</html>