refdes_renum: warn of possible number clash with non-conforming values
[geda-gaf/whiteaudio.git] / docs / wiki / geda-gschem_warmup.html
blob81b4af5cc614e51a60ff3ed6dc5d84edd50c6e8e
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html>
4 <head>
5 <title></title>
6 <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
7 <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
8 <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 </head>
12 <body>
15 <h1 class="sectionedit1161"><a name="gschem_warmup_for_beginners" id="gschem_warmup_for_beginners">gschem Warmup for Beginners</a></h1>
16 <div class="level1">
18 <p>
20 You need to become familiar with doing a few things in <em><strong>gschem</strong></em>, so just run <em><strong>gschem</strong></em> and start playing around:
21 </p>
23 <p>
24 You get an initial blank page with menus and a toolbar at the top. As you select operations from the menus, notice that there are usually keyboard shortcuts which can alternatively be used to access the menu functions.
25 </p>
27 <p>
28 When drawing a schematic, It&#039;s a good idea to always start by setting some schematic boundaries to draw within, so we will do this by adding a title-block. I find that using a B sized title-block lets my schematics print at a nice size on letter sized paper:
30 </p>
31 <ul>
32 <li class="level1"><div class="li"> Bring up the <strong>Select Component</strong> window by selecting from the menu <strong>Add→Component</strong> or hit keyboard shortcut <strong>i</strong>. Or you could click the add component icon on the toobar (<a href="media/geda/warmup_add_component.png" class="media" target="_blank" title="geda:warmup_add_component.png"><img src="media/geda/warmup_add_component.png" class="media" alt="" /></a>).</div>
33 </li>
34 <li class="level1"><div class="li"> In the <strong>Libraries</strong> list, select <strong>title-block</strong>.</div>
35 </li>
36 <li class="level1"><div class="li"> Under the <strong>Components list</strong>, select <strong>title-B.sym</strong>.</div>
37 </li>
38 <li class="level1"><div class="li"> Move the mouse onto the <em><strong>gschem</strong></em> drawing area and place the title-block symbol by clicking the left mouse button. Then click the right mouse button to abort adding more title-block symbols.</div>
39 </li>
40 </ul>
42 <p>
44 <a href="media/geda/warmup_gschem01.png" class="media" target="_blank" title="geda:warmup_gschem01.png"><img src="media/geda/warmup_gschem01.png" class="media" alt="" /></a>
46 </p>
47 <ul>
48 <li class="level1"><div class="li"> With the mouse in the <em><strong>gschem</strong></em> drawing area, hit the keys <strong>ve</strong> (or select from menu <strong>View→Zoom Extents</strong>) to zoom the view to the title-block symbol extents.</div>
49 </li>
50 <li class="level1"><div class="li"> Back in the select components window, (bring it up again if you closed it), select the <strong>analog</strong> library and then select the component <strong>resistor-1.sym</strong> and place a couple of resistors on the schematic with the left mouse button. Notice that as you place each one it is an orange color and that indicates it is selected.</div>
51 </li>
52 <li class="level1"><div class="li"> Zoom in (keyboard shortcut <strong>z</strong>) and zoom out (keyboard shortcut <strong>SHIFT z</strong>) in the area where you placed the resistors. If you get lost, zoom back to extents with <strong>ve</strong>. Notice that as you zoom in or out the viewable area centers around the mouse cursor.</div>
53 </li>
54 <li class="level1"><div class="li"> Alternate left clicking on both resistors to select them, but notice that if you don&#039;t hit the resistor just right, the title-block is selected instead. We really don&#039;t want to ever select the title-block again, so we can lock it to prevent its irritating selection: click so the title-block IS selected, then select <strong>Edit→Lock</strong>. Now it&#039;s easier to select the resistors as we like.</div>
55 </li>
56 <li class="level1"><div class="li"> Move the resistors around with the middle mouse button.</div>
57 </li>
58 <li class="level1"><div class="li"> Select a resistor and then rotate with the <strong>er</strong> keys or the <strong>Edit→Rotate 90 Mode</strong>.</div>
59 </li>
60 <li class="level1"><div class="li"> Move the resistors relatively close together and then zoom in on them.</div>
61 </li>
62 <li class="level1"><div class="li"> Place the mouse on one of the resistor pins and hit the <strong>n</strong> key to start adding a net. Move the mouse to a pin on the other resistor and left click to attach the net to the pin. Right click to abort adding this net but notice that if you left click again you will start adding another net.</div>
63 </li>
64 </ul>
66 <p>
68 <a href="media/geda/warmup_gschem02.png" class="media" target="_blank" title="geda:warmup_gschem02.png"><img src="media/geda/warmup_gschem02.png" class="media" alt="" /></a>
70 </p>
71 <ul>
72 <li class="level1"><div class="li"> Look at the toolbar and see that your mode has switched to adding nets. Before you can change resistor selections again, you will have to re-enter select mode with the <strong>s</strong> key or by clicking the select toolbar icon or by using the menu <strong>Edit→Select Mode</strong>. But if you try to move a resistor with the middle mouse button, you can do it and you will automatically re-enter select mode. You will have to play with doing things to get used to the <em><strong>gschem</strong></em> modes.</div>
73 </li>
74 <li class="level1"><div class="li"> If when you added the net between the resistors you get something that looks like this:</div>
75 </li>
76 </ul>
78 <p>
80 <a href="media/geda/warmup_gschem03.png" class="media" target="_blank" title="geda:warmup_gschem03.png"><img src="media/geda/warmup_gschem03.png" class="media" alt="" /></a>
81 </p>
83 <p>
84 it means you missed the pin on the right resistor. Look closely and you&#039;ll see the tip of the pin is red and you must start and stop nets with the mouse on this red spot to make a connection to the pin.
85 </p>
86 <ul>
87 <li class="level1"><div class="li"> Select the net between the resistors and delete it with the <strong>Delete</strong> key.</div>
88 </li>
89 <li class="level1"><div class="li"> Select a resistor and hit the <strong>ee</strong> keys. This will pop up the attribute editing window for the resistor. Here you can change existing attribute values or add new attributes with values to the resistor. Practice well with adding attributes and changing attribute values because you will need to be very familiar with managing attributes when using <em><strong>gschem</strong></em>.</div>
90 </li>
91 </ul>
93 <p>
95 Now go back to <a href="geda-gsch2pcb_tutorial.html" class="wikilink1" title="geda-gsch2pcb_tutorial.html">the tutorial</a> and try working through the simple example there. If you encounter steps that aren&#039;t clear, look through the <em><strong>gschem</strong></em> user documentation and attributes documentation on the <a href="geda-gschem_ug.html" class="wikilink1" title="geda-gschem_ug.html">gschem Documentation</a> page.
97 </p>
98 <hr />
101 tutorial by Bill Wilson (bill–at–gkrellm.net)
102 </p>
104 </div>
105 </body>
106 </html>