Documentation improvements

This commit is contained in:
Wayne Venables
2025-08-26 20:47:11 -07:00
parent 4753b270f6
commit faef620629
517 changed files with 8124 additions and 4888 deletions

View File

@@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.17"/>
<meta name="generator" content="Doxygen 1.9.1"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>PicoVGA: Connections</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
@@ -29,7 +29,7 @@
<td id="projectlogo"><img alt="Logo" src="logo.png"/></td>
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">PicoVGA
&#160;<span id="projectnumber">1.0-cmake</span>
&#160;<span id="projectnumber">1.2-cmake</span>
</div>
<div id="projectbrief">VGA/TV display on Raspberry Pico</div>
</td>
@@ -38,10 +38,10 @@
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.17 -->
<!-- Generated by Doxygen 1.9.1 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
@@ -90,37 +90,36 @@ $(document).ready(function(){initNavTree('connections.html',''); initResizable()
<div class="title">Connections </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><h1><a class="anchor" id="autotoc_md0"></a>
<div class="textblock"><p><a class="anchor" id="md_pages_Connections"></a> </p>
<h1><a class="anchor" id="autotoc_md0"></a>
How to Connect to VGA display</h1>
<p>The following diagram shows how to connect the Pico to VGA:</p>
<div class="image">
<img src="PicoVGA_diagram2.jpg" alt=""/>
</div>
<table class="markdownTable">
<p><img src="PicoVGA_diagram2.jpg" alt="" class="inline"/></p>
<table class="markdownTable">
<tr class="markdownTableHead">
<th class="markdownTableHeadNone">Pico Pin </th><th class="markdownTableHeadNone">Output Wire </th><th class="markdownTableHeadNone">Notes </th></tr>
<th class="markdownTableHeadNone">Pico Pin </th><th class="markdownTableHeadNone">Output Wire </th><th class="markdownTableHeadNone">Notes </th></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">GP0 </td><td class="markdownTableBodyNone">VGA B0 </td><td class="markdownTableBodyNone">Resistor 1K0 to Blue output </td></tr>
<td class="markdownTableBodyNone">GP0 </td><td class="markdownTableBodyNone">VGA B0 </td><td class="markdownTableBodyNone">Resistor 1K0 to Blue output </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">GP1 </td><td class="markdownTableBodyNone">VGA B1 </td><td class="markdownTableBodyNone">Resistor 390 to Blue output </td></tr>
<td class="markdownTableBodyNone">GP1 </td><td class="markdownTableBodyNone">VGA B1 </td><td class="markdownTableBodyNone">Resistor 390 to Blue output </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">GP2 </td><td class="markdownTableBodyNone">VGA G0 </td><td class="markdownTableBodyNone">Resistor 2K2 to Green output </td></tr>
<td class="markdownTableBodyNone">GP2 </td><td class="markdownTableBodyNone">VGA G0 </td><td class="markdownTableBodyNone">Resistor 2K2 to Green output </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">GP3 </td><td class="markdownTableBodyNone">VGA G1 </td><td class="markdownTableBodyNone">Resistor 1K0 to Green output </td></tr>
<td class="markdownTableBodyNone">GP3 </td><td class="markdownTableBodyNone">VGA G1 </td><td class="markdownTableBodyNone">Resistor 1K0 to Green output </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">GP4 </td><td class="markdownTableBodyNone">VGA G2 </td><td class="markdownTableBodyNone">Resistor 470 to Green output </td></tr>
<td class="markdownTableBodyNone">GP4 </td><td class="markdownTableBodyNone">VGA G2 </td><td class="markdownTableBodyNone">Resistor 470 to Green output </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">GP5 </td><td class="markdownTableBodyNone">VGA R0 </td><td class="markdownTableBodyNone">Resistor 2K2 to Red output </td></tr>
<td class="markdownTableBodyNone">GP5 </td><td class="markdownTableBodyNone">VGA R0 </td><td class="markdownTableBodyNone">Resistor 2K2 to Red output </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">GP6 </td><td class="markdownTableBodyNone">VGA R1 </td><td class="markdownTableBodyNone">Resistor 1K0 to Red output </td></tr>
<td class="markdownTableBodyNone">GP6 </td><td class="markdownTableBodyNone">VGA R1 </td><td class="markdownTableBodyNone">Resistor 1K0 to Red output </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">GP7 </td><td class="markdownTableBodyNone">VGA R2 </td><td class="markdownTableBodyNone">Resistor 470 to Red output </td></tr>
<td class="markdownTableBodyNone">GP7 </td><td class="markdownTableBodyNone">VGA R2 </td><td class="markdownTableBodyNone">Resistor 470 to Red output </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">GP8 </td><td class="markdownTableBodyNone">VGA SYNC </td><td class="markdownTableBodyNone">Resistor 100 to HSYNC or CSYNC </td></tr>
<td class="markdownTableBodyNone">GP8 </td><td class="markdownTableBodyNone">VGA SYNC </td><td class="markdownTableBodyNone">Resistor 100 to HSYNC or CSYNC </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">GP9 </td><td class="markdownTableBodyNone">VGA VSYNC </td><td class="markdownTableBodyNone">Resistor 100 to VSYNC (if defined) </td></tr>
<td class="markdownTableBodyNone">GP9 </td><td class="markdownTableBodyNone">VGA VSYNC </td><td class="markdownTableBodyNone">Resistor 100 to VSYNC (if defined) </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">GP19 </td><td class="markdownTableBodyNone">PWM sound </td><td class="markdownTableBodyNone">RC LOW filter 1K5 resistor + 10n capacitor </td></tr>
<td class="markdownTableBodyNone">GP19 </td><td class="markdownTableBodyNone">PWM sound </td><td class="markdownTableBodyNone">RC LOW filter 1K5 resistor + 10n capacitor </td></tr>
</table>
<p>See below for a more detailed wiring diagram</p>
<h1><a class="anchor" id="autotoc_md1"></a>
@@ -142,9 +141,9 @@ How to connect Pico to PC with serial port</h1>
<p>Connect USB/UART adaptor PL2303TA: <br />
</p><table class="markdownTable">
<tr class="markdownTableHead">
<th class="markdownTableHeadNone">Wire </th><th class="markdownTableHeadNone">Pico Pin </th></tr>
<th class="markdownTableHeadNone">Wire </th><th class="markdownTableHeadNone">Pico Pin </th></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">red </td><td class="markdownTableBodyNone">+5V VSYS (39) </td></tr>
<td class="markdownTableBodyNone">red </td><td class="markdownTableBodyNone">+5V VSYS (39) </td></tr>
</table>
<p>|black |GND (3)| | |white RxD |UART0_TX GP0 (1) | |green TxD |UART0_RX GP1 (2) |</p>
<p>You need serial program to see demo text. Setup port to 115200 Baud, 8 bits, 1 stop bit, no parity, flow control None.</p>
@@ -152,10 +151,8 @@ How to connect Pico to PC with serial port</h1>
<h1><a class="anchor" id="autotoc_md2"></a>
Wiring diagram</h1>
<p>I don't present here the overall circuit I used, because the library was created as part of a retro gaming computer with Raspberry Pico and is still under development. Here is a simplified wiring diagram of the VGA monitor output (with added audio PWM output):</p>
<div class="image">
<img src="PicoVGA_diagram.jpg" alt=""/>
</div>
<p>The synchronization output is in the format of the CSYNC synchronization mix (composite synchro, HSYNC + VSYNC). Computer monitors support CSYNC mixed sync. The signal is fed to the HSYNC input (also referred to as CSYNC). An audio output is fed to the VSYNC pin of the VGA connector, for case of output to the TV. The VGA monitor has an input impedance of 75 ohms on this pin, this causes the audio signal to be attenuated and ignored by the VGA monitor and not considered as vertical sync. When the audio connector is inserted, the output to the VGA monitor is disconnected and the audio signal is output to the outside (e.g. to audio headphones).</p>
<p><img src="PicoVGA_diagram.jpg" alt="" class="inline"/></p>
<p>The synchronization output is in the format of the CSYNC synchronization mix (composite synchro, HSYNC + VSYNC). Computer monitors support CSYNC mixed sync. The signal is fed to the HSYNC input (also referred to as CSYNC). An audio output is fed to the VSYNC pin of the VGA connector, for case of output to the TV. The VGA monitor has an input impedance of 75 ohms on this pin, this causes the audio signal to be attenuated and ignored by the VGA monitor and not considered as vertical sync. When the audio connector is inserted, the output to the VGA monitor is disconnected and the audio signal is output to the outside (e.g. to audio headphones).</p>
<p>The TV is connected to the VGA output via a reduction that simply connects the pins of the VGA connector to the corresponding pins of the SCART connector. In this case, the audio signal fed to the VGA connector is also used. Thus, it is not necessary for the device to include a special connector for the TV. The 5V voltage from pin 9 is used as the control voltage for the SCART connector - pin 16 of the SCART connector (Blanking) is connected via a 100 ohm resistor and pin 8 (Switch) is connected directly.</p>
<p>The keyboard connection is not draw here. All sample programs are set up so that program control can be used via the console on the USB virtual port. Simply connect the Pico to the PC via the USB cable used for programming, and run a console program that connects to the USB virtual COM port. For a more detailed description of the connection, see the SDK description. </p>
</div></div><!-- contents -->
@@ -164,9 +161,7 @@ Wiring diagram</h1>
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="footer">Generated by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.17 </li>
<li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1 </li>
</ul>
</div>
</body>