Commit 8c5af76e authored by Martin Singer's avatar Martin Singer

Initial commit

* Added a README.md with instructions about creating own libs and
  footprints
* Added schematic lib "EKB" (Ergonomic Keyboard)
  - Includes a simple switch
* Added footprint lib "Cherry-MX.pretty"
  - Includes footprints for "Cherry-MX1A-E1NN"
* Added 3D models for "Cherry-MX1A-E1NW" for the footprint
* Added a LICENSE.md file with GPL

Changes to be committed:
	new file:   LICENSE.md
	new file:   README.md
	new file:   footprints/Cherry-MX.pretty/Cherry-MX1A-E1NN.kicad_mod
	new file:   library/EKB.dcm
	new file:   library/EKB.lib
	new file:   modules/packages3d/Cherry-MX/Cherry-MX1A-E1NW.wings
	new file:   modules/packages3d/Cherry-MX/Cherry-MX1A-E1NW.wrl
parents
This diff is collapsed.
Howto Create a KiCAD Library
============================
Tutorial videos:
* <https://www.youtube.com/watch?v=S63DLV5HOPA>
* <https://www.youtube.com/watch?v=bGp9ejC2vU8>
Create folders
--------------
# mkdir -p /usr/lcoal/share/kicad/library
# mkdir -p /usr/lcoal/share/kicad/footprints/FOOTPRINT-LIB-NAME.pretty
# mkdir -p /usr/lcoal/share/kicad/modules/packages3d/3D-LIB-NAME
# ln -s /usr/local/share/kicad /home/USER/Projects/kicad
# cd /home/USER/Projects/kicad
# chown -R USER:root *
$ git init
Create drawing library
----------------------
1. Select KiCAD main window (start KiCAD)
2. Press button "Schematic library editor" (and select the opening window)
3. Draw Part ...
4. Select menu entry "File --> Save Current Library as"
5. Choose "/usr/local/share/kicad/library/PART-LIB-NAME.lib"
6. Select menu entry "Preferences --> Component Libraries"
7. Press button "Add" at topic "User defined search path"
8. Select path "/usr/local/share/kicad/library/"
9. The folowing dialog asks "Use a relative paht?".
Choose "No" (for an absolute path).
10. Select path "/usr/local/share/kicad/library/"
at topic "Current search path list"
11. Press Button "Add" at topic "Component library file"
12. Choose "/usr/local/share/kicad/library/PART-LIB-NAME.lib"
13. Press button "OK" of the dialog window (on the bottom)
Create foot print library
-------------------------
1. Select KiCAD main window
2. Press button "PCB footprint editor" (and select the opening window)
3. Press button "New footprint"
4. Enter the foot name
5. Draw Part ...
6. Select menu entry "File --> Export Footprint"
7. Choose "/usr/local/share/kicad/footprints/FOOTPRINT-LIB-NAME.pretty/FOOTPRINT-NAME.kicad_mod"
8. Select menu entry "Preferences --> Footprint Libraries Manager"
9. Select Tab "Global Libraries" at topic "Library Tables by Scope"
10. Press button "Append with Wizzard"
11. Select radio button "Files on my computer" and press button "Next >" of the wizzard
12. Choose "/usr/local/share/kicad/footprints/FOOTPRINT-LIB-NAME.pretty" and press button "Next >"
13. Select the Library "FOOTPRINT-LIB-NAME" and press "Next >".
14. Select radio button "To global library configuration (visible by all objects)"
and press button "Finish"
15. Press button "OK" of the dialog window
Create a 3D model for a foot print
----------------------------------
1. Create a 3D model with "FreeCAD" or "OpenSCAD".
2. Export the 3D model as STL (stereo lithography) mesh
to "/usr/local/share/kicad/modules/packages3d/3D-LIB-NAME/3D-MODEL-NAME.stl".
3. If the 3D model is created with "OpenSCAD" import it to "FreeCAD"
and export it again as STL mesh.
This converts the STL file from plain text to binary format.
4. Import the 3D model to "Wings3D" (start Wings3D).
- Choose menu entry "File --> Import --> StereoLithography (.stl)..."
* Don't care about the horizontal Z axis.
* Mouse middle click activates camera view mode
- Mouse movements changes the view angle
- Mouse middle click (again) changes the view position
- Mouse left click exits the view mode
* Notice the the shortcut and tool tips on the bottom of the window!
5. Select menu entry "Window --> Outliner"
6. Select menu entry "Window --> Palette"
7. Select tool bar icon "Change to body selection mode" (the red cube)
8. Select the (whole) 3D model
9. Choose a color from the "Palette" (this defines the ground color)
* By clicking on a gray color field it is possible to define a custom color
10. Deselect the 3D model by clicking on it
10. Select tool bar icon "Change to face selection mode" (cube with red side)
11. Select all triangle faces for one color and choose a color from the "Palette"
12. Deselect the faces and repeat for all colors
13. Select tool bar icon "Change to body selection mode" (the red cube)
14. Select the (whole) 3D model
15. Do mouse right click on the 3D model
16. Choose menu entry "Vertex Attributes" (possibly "More... --> Vertex Attributes")
17. An other menu appears. Choose "Colors to Materials"
18. Do a Mouse click right on the different materials
in child window "Outliner" to config the materials
19. If done select menu entry "File --> Save As..."
20. Choose "/usr/local/share/kicad/modules/packages3d/3D-LIB-NAME/3D-MODEL-NAME.wings"
21. Select menu entry "File --> Export --> VRML 2.0 (.wrl)..."
22. Choose "/usr/local/share/kicad/modules/packages3d/3D-LIB-NAME/3D-MODEL-NAME.wrl"
Add 3D model to foot print library
----------------------------------
1. Select KiCAD main window
2. Press button "PCB footprint editor" (and select the opening window)
3. Press buttin "Set active library", find library "FOOTPRINT-LIB-NAME"
4. Press button "Load footprint from library", find and load footprint "FOOTPRINT-NAME"
5. Press button "Footprint properties"
6. Select tab "3D settings"
7. Press button "Add 3D shape"
8. Select "/usr/local/share/kicad/modules/packages3d/3D-LIB-NAME/3D-MODEL-NAME.wrl"
9. The folowing dialog asks "Use a path relative to '/usr/share/kicad/modules/packages3d'?".
Choose "No" (for an absolute path).
10. If the 3D model is designed in metric (mm) measures, do a "Shape Scale" for X, Y, and Z of 0.39370.
1mm to 10mils: (1mm / (2.54mm / 10mils)) = 0.39370 * 10mils
11. Press button "OK" of the dialog window
12. Select menu entry "View --> 3D Viewer" to view the 3D model on the PCB.
(If there is the PCB only, something went wrong)
(module Cherry-MX1A-E1NN (layer F.Cu) (tedit 581B39DB)
(tags "cherry, mx, key, switch")
(fp_text reference REF** (at 0 8.255) (layer F.SilkS)
(effects (font (size 1 1) (thickness 0.15)))
)
(fp_text value MX1A-E1NN (at 0 -8.255) (layer F.Fab)
(effects (font (size 1 1) (thickness 0.15)))
)
(fp_line (start -7 -7) (end 7 -7) (layer F.SilkS) (width 0.15))
(fp_line (start 7 -7) (end 7 7) (layer F.SilkS) (width 0.15))
(fp_line (start 7 7) (end -7 7) (layer F.SilkS) (width 0.15))
(fp_line (start -7 7) (end -7 -7) (layer F.SilkS) (width 0.15))
(pad "" np_thru_hole circle (at 0 0) (size 4 4) (drill 4) (layers *.Cu))
(pad 1 thru_hole circle (at -3.81 -2.54) (size 2.5 2.5) (drill 1.5) (layers *.Cu *.Mask))
(pad 2 thru_hole circle (at 2.54 -5.08) (size 2.5 2.5) (drill 1.5) (layers *.Cu *.Mask))
(model /usr/local/share/kicad/modules/packages3d/Cherry-MX/Cherry-MX1A-E1NW.wrl
(at (xyz 0 0 0))
(scale (xyz 0.3937 0.3937 0.3937))
(rotate (xyz 0 0 0))
)
)
EESchema-DOCLIB Version 2.0
#
$CMP Switch
D Button, Key, Switch
K button, key, switch
$ENDCMP
#
#End Doc Library
EESchema-LIBRARY Version 2.3
#encoding utf-8
#
# Switch
#
DEF Switch SW 0 40 N N 1 F N
F0 "SW" 0 150 60 H V C CNN
F1 "Switch" 0 -100 60 H V C CNN
F2 "" 0 0 60 H I C CNN
F3 "" 0 0 60 H I C CNN
DRAW
X 1 1 -300 0 175 R 50 50 0 1 P I
X 2 2 300 0 175 L 50 50 0 1 P I
P 2 1 1 0 -150 25 150 100 N
ENDDRAW
ENDDEF
#
#End Library
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment