It may be worth noting in the tutorial that if you screw up (as I have multiple times) and try to restart by deleting the tutorial1 directory you created that you also (at least on Windows) need to delete \Users\Owner\AppData\Roaming\kicad (at least in my case, your path will be different) because it is storing things in there too and will remember them when you recreate your directory.
Now a bunch more issues as I have moved along in the tutorial listed by section number. If this isn’t an appropriate place for this I assume that someone will tell me . Again indexed by the reference numbers in the tutorial:
7 click on the first corner, do not hold button down while moving to the other corner as that does something different than create the rectangle.
43 Annotate schematic icon is in the tools menu on the top menu bar (I was trying to find it on the screen …)
45 change “Perform Electric Rules check” to tools -> Electrical Rules Checker.
change Click “Test ERC button” to “Run” in both places.
on Windows clicking “create ERC file report” run save file tutorial1.erc results in “No default editor found you must choose it” . I chose c:\windows\notepad.exe and that seems to work. I expect this will be different for Unix (if the $editor environment variable is set it may not come up on Unix) …
46 Change “Click on the Netlist generation icon” to “Click on tools -> Generate Netlist File”
“Click on Netlist then” to “Pcbnew (default) press Generate then save”
47 change " click on the Run Cvpcb icon " to “click on tools -> Assign component footprint”
49 Add "click til you get “filtered by library” only in the bottom right window then click on the specified library in the left window (i.e. Housings for the IC1 footprint). then double click on the appropriate foot print in the right side window.
52 “File -> save as” to “File -> Save edits”
53 change “File ? Save Whole Schematic Project” to “File ? Save Schematic Project”
54/55 While they do no harm, there doesn’t appear to be any point to them either. Netlist doesn’t appear any where in the project manager and we are going back to Eeschema for the next step so why close it and go to project manager. Perhaps move the comment in 55 about the netlist being an editable text file back to step 52 and eliminate 54 and 55?
56 BOM is now in tools -> Generate Bill of Materials not on the tool bar as stated
The add plugins window opens in Kicad\bin to get to the .xls files you need to click on “scripting”
then “plugins” (neither of which is likely obvious to a newbie). As noted the plugins are in KiCad\bin\scripting\plugins\ not /usr/lib/kicad/plugins/ as stated and the file is thus:
xsltproc -o “%O” “C:\Program Files\KiCad\bin\scripting\plugins\bom2csv.xsl” “%I”
not xsltproc -o “%O.csv” “/home//kicad/eeschema/plugins/bom2csv.xsl” “%I”
3.2 Bus connections.
We currently have the tutorial1 schematic open from the BOM step in 56 above. There is no 4 pin connector present. I suspect this example was taken from somewhere else and it needs a schematic (probably other than tutorial1!) created to provide the necessary connectors to connect to the bus or to be only a example for information only (which should then be stated so as to not have changes made to the tutorial one schematic that will trip the user up later).
C:\Users\Owner\Documents\kicad\tutorial1\tutorial1.net shows in the file window, clicking the Browse button opens C:\Program Files\KiCad\bin\scripting\plugins rather than C:\Users\Owner\Documents\kicad\tutorial1\ which in turn has no .net files in it (presumably because the plugins directory was my last reference).
I don’t see how to fix this, but it is likely confusing to a newbie. Obviously they would need to navigate to the correct directory (or just use the one offered in the window, which perhaps is new functionality).
“Click on Read Current netlist then click close” is misleading. It needs to indicate to check the messages window for errors first, because In my case I had screwed up (because going back and verifying the footprints were added fixed it, even though I made no changes) and the message window looked like this (note as it is a unix \n only delimited file, notepad won’t read it properly and I had to use vi in cygwin, it may be an idea to suggest this for windows users in the tutorial as well):
Info: Reading netlist file “C:\Users\Owner\Documents\kicad\tutorial1\tutorial1.net”.
Info: Using references to match components and footprints.
Error: No footprint defined for component ‘R2’.
Error: No footprint defined for component ‘R1’.
Error: No footprint defined for component ‘IC1’.
Error: No footprint defined for component ‘D1’.
Error: No footprint defined for component ‘J1’
which would not have worked at the next step.
6 looks like all components are moved to the center of the screen by default now so this isn’t needed
8 Looks like “hide board ratsnest” button has become “display local ratsnest”
9 Initially I got my friend “clarify selection” when trying to move with “g” but moving out of the window (to notepad where I am documenting this) and then clicking on the tool bar to select the window again, I can now use “g” to move components without the clarify selection window coming up. Confusing to say the least! Documenting how to turn “clarify selection” on and off would be useful (probably early in the tutorial) since I don’t know what I’m doing to invoce it.
11 “Select edge cuts” needs to add “(beteen perform design rules check and show active layer selections)” (preferably with their respective icons) on the tool bar. It was not obvious to me for quite some time what drop down menu you were referring to until I looked at the next screen shot, as a blank rectangle doesn’t appear to be a drop down menu, although in this case it is. As well a screen shot of the finished outline would be useful to know if I had done it correctly. Reminding the user that a double click will terminate the line wouldn’t be a bad bet either.
16 This doesn’t work as stated. An error box saying “Extra Track1 size 0.0100 < min track size” comes up, I assume because the sizes are in mm. I note there is a (inches) at the end of the line. I assume this means the table is intended to be in inches not mm. However there is nothing to tell the newbie how to change from mm to inches here so either that needs to be added (clicking on “in” in the left tool bar did it for me for instance) or the table changed to mm.
19 when the first track is added the rats nest disappears and clicking “display local ratsnest” doesn’t bring it back. In this case with a drawing to refer to that isn’t a problem, and starting a wire on a pin brings up the rats nest for that pin, but it makes it difficult to see when you have connected all the pins.
22 Doesn’t appear to work. With B Cu layer selected, click on Add zones and click on one corner of the board edge rectangle. No dialog box occurs and nothing appears to happen. Moving to the next edge and clicking also causes no change.
This one has me currently stopped until some good person here tells me what I’m doing wrong, because I don’t know how to get the ground plane to place.