Files
b4l-project-template/kicad/libraries/3dmodels/README.md
grabowski 046f66f6eb Refine repository structure for KiCad 9 optimization
- Add dedicated /kicad/ directory with organized subdirectories for libraries, schematics, gerbers, plots, and backups
- Create comprehensive KiCad 9 library structure (symbols, footprints, 3D models)
- Add manufacturing-ready directories for production files (gerbers, drill, pick-and-place)
- Update all README files with KiCad-specific documentation and workflows
- Add KiCad-optimized .gitignore file for proper version control
- Create KICAD-PROJECT-TEMPLATE.md comprehensive usage guide
- Add hardware assembly documentation and BOM management
- Include detailed manufacturing file generation instructions
- Add docs structure with design-notes and user-manual directories
- Provide complete workflow from design to manufacturing with quality checklists
2025-08-03 16:27:46 +07:00

62 lines
2.0 KiB
Markdown

# /kicad/libraries/3dmodels
Custom 3D models for your KiCad project footprints.
## File Formats
- **STEP files (`.step`)**: Preferred for mechanical accuracy and CAD integration
- **VRML files (`.wrl`)**: Legacy format, still supported by KiCad 3D viewer
- **WRL files (`.wrl`)**: Alternative VRML extension
## Naming Convention
- Use descriptive names matching your footprints
- Examples:
- `USB-C_Receptacle.step`
- `STM32F4_LQFP64.step`
- `Header_2x10_2.54mm.wrl`
## Model Guidelines
- **Scale**: Ensure models are in millimeters (KiCad's native unit)
- **Origin**: Position the model origin to match the footprint's origin
- **Orientation**: Align the model with the footprint's orientation
- **Detail Level**: Balance detail with file size for performance
## File Organization
```
3dmodels/
├── connectors/
│ ├── USB-C_Receptacle.step
│ ├── Header_2x10_2.54mm.step
│ └── Terminal_Block_3pin.step
├── mcu/
│ ├── STM32F4_LQFP64.step
│ └── ESP32_Module.step
├── sensors/
│ ├── BME280_LGA8.step
│ └── MPU6050_QFN24.step
└── passive/
├── Resistor_0603.step
├── Capacitor_0805.step
└── LED_0603.step
```
## Associating Models with Footprints
1. Open footprint in KiCad Footprint Editor
2. Go to **Footprint Properties**
3. Click **3D Settings** tab
4. Add 3D model path (use relative paths)
5. Adjust offset, rotation, and scale if needed
## Model Sources
- **Manufacturer websites**: Often provide STEP models
- **Component distributors**: Digi-Key, Mouser, etc.
- **3D model libraries**: GrabCAD, 3D ContentCentral
- **KiCad official libraries**: For standard components
- **Custom modeling**: Create your own in CAD software
## Best Practices
- Use relative paths: `${KIPRJMOD}/kicad/libraries/3dmodels/`
- Keep file sizes reasonable (< 1MB per model when possible)
- Test models in KiCad 3D viewer before finalizing
- Document model sources and modifications
- Version control important custom models