Skip to content

Commit d72f8cf

Browse files
authored
Update README.md
1 parent 40c6b39 commit d72f8cf

File tree

1 file changed

+101
-155
lines changed

1 file changed

+101
-155
lines changed

IOT System PCB/README.md

Lines changed: 101 additions & 155 deletions
Original file line numberDiff line numberDiff line change
@@ -1,182 +1,128 @@
1-
This directory contains all PCB design files for the IoT Monitoring System used in the Open Solar Cooling Hub. The design was created using Altium CircuitMaker.
1+
# IoT System PCB – Open Solar Cooling Hub (KiCAD Approach)
22

3-
# How to Open and Modify the PCB Design
4-
5-
# Download CircuitMaker
6-
Visit the official download page:
7-
https://circuitmaker.com/Download
8-
Click “Download CircuitMaker” and follow the instructions for your operating system (Windows only).
9-
10-
# Install CircuitMaker
11-
Run the downloaded .exe file.
12-
Follow the installation wizard steps.
13-
After installation, launch the software.
14-
15-
# Sign In or Register
16-
You will need an Autodesk/Altium account to use CircuitMaker.
17-
If you don’t have one, register during the first launch.
18-
This is required since CircuitMaker uses cloud-based project management.
19-
20-
# Load the Project
21-
Open CircuitMaker.
22-
open this link: https://365.altium.com/files/FD40F198-177B-4D2F-B652-184317044322
23-
Open Solar Cooling Hub PCB Project - Enaccess.PrjPcb
24-
View and edit schematics using .SchDoc
25-
Modify PCB layout using .CmpcbDoc
26-
Generate new Gerber files for manufacturing
27-
Adjust routing, component placement, and net labels
28-
Re-export fabrication files via the .OutJob files
29-
30-
31-
32-
# IoT System PCB – Folder Structure and Content Description
33-
34-
This folder contains all the files required for:
35-
- PCB **fabrication**
36-
- **Assembly** (PCBA)
37-
- **Start 3D case modeling**
38-
- Full **project source files** and **schematics**
39-
40-
The structure follows standard hardware development and manufacturing practices.
41-
42-
---
43-
44-
## 1. FAB – Fabrication Files
45-
46-
Located in:
47-
`FAB-Open Solar Cooling Hub PCB Project - Enaccess-A.1/`
48-
49-
These are the files required by PCB manufacturers to fabricate the **bare PCB** (without components).
50-
51-
### Gerber Files
52-
53-
| Extension | Description |
54-
|-----------|--------------------------------------------|
55-
| `.GTL` | Top copper layer |
56-
| `.GBL` | Bottom copper layer |
57-
| `.GTO` | Top silkscreen layer |
58-
| `.GBO` | Bottom silkscreen layer |
59-
| `.GTS` | Top soldermask |
60-
| `.GBS` | Bottom soldermask |
61-
| `.GTP` | Top paste layer |
62-
| `.GBP` | Bottom paste layer |
63-
| `.GKO` | Board outline / keep-out layer |
64-
| `.GM1``.GM16` | Mechanical layers, documentation |
65-
| `.REP`, `.RUL`, `.apr` | Reports and design rules |
66-
| `.APR_LIB` | Aperture macros used in CAM process |
67-
68-
---
69-
70-
### NC Drill Files
71-
72-
Located in: `NC Drill/`
73-
74-
| File | Description |
75-
|----------------|--------------------------------------|
76-
| `.DRR` | Drill report summary |
77-
| `.TXT` | Excellon drill file (for CNC) |
78-
| `.LDP` | Layer pair definition |
3+
This repository contains the PCB design files for the IoT Monitoring System used in the Open Solar Cooling Hub, created and managed using **KiCAD**. The project includes schematics, PCB layout, fabrication files (Gerbers, drill files), assembly files (BOM, Pick & Place), and a 3D model for enclosure design. This guide explains how to open, modify, and produce the PCB using KiCAD.
794

805
---
816

82-
### ODB++ Format
83-
84-
Located in: `ODB/`
85-
86-
This is a **comprehensive PCB manufacturing format** used by advanced fabrication services.
87-
88-
Contains:
89-
- Layer definitions (copper, soldermask, silkscreen)
90-
- Stackups and materials
91-
- Drill and via data
92-
- Netlists
93-
- Profile and board outline
7+
## Prerequisites
948

95-
Use this folder if your manufacturer supports **ODB++** instead of Gerbers.
9+
1. **Install KiCAD**:
10+
- Download KiCAD (v7 or later recommended) from [kicad.org](https://www.kicad.org/download/) for Windows, macOS, or Linux.
11+
- Install and launch KiCAD.
9612

97-
---
98-
99-
## 2. ExportSTEP – 3D Mechanical Model
100-
101-
| File | Purpose |
102-
|----------------------------|----------------------------------|
103-
| `IOT B oard FIle.step` | 3D model of the PCB for enclosure design in CAD tools like OpenSCAD, Fusion 360 or SolidWorks |
13+
2. **Required Files**:
14+
- `Solar Cooling Project.kicad_pro`: KiCAD project file.
15+
- `Solar Cooling Project.kicad_sch`: Schematic file.
16+
- `Solar Cooling Project.kicad_pcb`: PCB layout file.
17+
- Reference files (from original Altium design for validation):
18+
- Gerber files (`Solar Cooling Project-F_Cu.gbr`, `B_Cu.gbr`, etc.)
19+
- Drill files (`Solar Cooling Project-PTH.drl`, `NPTH.drl`)
20+
- BOM (`BOM_PartType-Open Solar Cooling Hub PCB Project.xlsx`)
21+
- Pick & Place (`Pick Place for IOT B oard FIle.txt`)
22+
- Assembly PDF (`Assembly.PDF`)
23+
- 3D model (`IOT B oard FIle.step`)
10424

10525
---
10626

107-
## 3. PCBA – Assembly Files
108-
109-
Located in:
110-
`PCBA-Open Solar Cooling Hub PCB Project - Enaccess-[NO VARIATIONS]-A.1/`
111-
112-
These are used during **component assembly** (manual or SMT machine).
27+
## Folder Structure and Content Description
11328

114-
### 📋 Bill of Materials (BOM)
29+
The project follows standard hardware development practices, with files organized for PCB fabrication, assembly, and modification.
11530

116-
| File Name | Description |
117-
|--------------------------------------------------------------|-----------------------------------------|
118-
| `BOM_PartType-Open Solar Cooling Hub PCB Project.xlsx` | List of all components, part numbers, footprints, and reference designators |
119-
120-
### Pick & Place File
121-
122-
| File Name | Description |
123-
|---------------------------------------|--------------------------------------|
124-
| `Pick Place for IOT B oard FIle.txt` | X/Y coordinates and orientation for all components |
125-
126-
### Assembly Drawing
127-
128-
| File Name | Description |
129-
|-------------------|-------------------------------------|
130-
| `Assembly.PDF` | Visual layout of components for QC and hand assembly |
31+
| Folder/File | Purpose |
32+
|-------------|---------|
33+
| `Gerber/` | PCB fabrication layers (copper, soldermask, silkscreen, etc.) |
34+
| `NC Drill/` | Drill files for PTH and NPTH holes |
35+
| `PCBA/` | Assembly files (BOM, Pick & Place, Assembly PDF) |
36+
| `ExportSTEP/` | 3D STEP model for enclosure design |
37+
| `Solar Cooling Project.kicad_pro` | KiCAD project file |
38+
| `Solar Cooling Project.kicad_sch` | Schematic file |
39+
| `Solar Cooling Project.kicad_pcb` | PCB layout file |
40+
| `README.md` | Project documentation |
13141

13242
---
13343

134-
## 4. Schematic & Project Source Files
135-
136-
These files allow others to **modify, recompile, or regenerate** the PCB from source using **Circuitmaker PCB Designer** or **compatible EDA tools**.
137-
138-
| File Name | Description |
139-
|----------------------------------------------|-------------------------------------------|
140-
| `IOT Schematic File.SchDoc` | Main schematic diagram |
141-
| `IOT B oard FIle.CMPcbDoc` | PCB layout file |
142-
| `Open Solar Cooling Hub PCB Project - Enaccess.PrjPcb` | Project file referencing schematic and PCB layout |
143-
| `Open Solar Cooling Hub PCB Project - Enaccess.PrjPcbStructure` | Project structure definition |
144-
| `Assembly.OutJob` | Altium job file for exporting assembly files |
145-
| `Fabrication.OutJob` | Altium job file for generating Gerbers, drills, etc. |
146-
| `readme` | Notes about the project (may be edited) |
44+
## How to Open and Modify the PCB Design in KiCAD
45+
46+
### 1. Open the Project
47+
1. Launch KiCAD and open `Solar Cooling Project.kicad_pro` in the project manager.
48+
2. This loads the schematic (`Solar Cooling Project.kicad_sch`) and PCB layout (`Solar Cooling Project.kicad_pcb`).
49+
50+
### 2. Edit the Schematic
51+
1. Open the schematic editor (Eeschema) by clicking the schematic icon in the project manager.
52+
2. Verify components, connections, and net labels against the original BOM and schematic reference (e.g., exported PDF from Altium or `IOT Schematic File.SchDoc`).
53+
3. **Modify (if needed)**:
54+
- Add/remove components using KiCAD’s symbol libraries or create custom symbols.
55+
- Update net labels for clarity.
56+
- Assign footprints to each symbol via the “Assign Footprints” tool, ensuring compatibility with the BOM and Pick & Place file.
57+
4. Generate a netlist (File > Export > Netlist) for PCB layout.
58+
59+
### 3. Edit the PCB Layout
60+
1. Open the PCB editor (Pcbnew) by clicking the PCB icon in the project manager.
61+
2. Import the netlist (File > Import > Netlist) to populate components.
62+
3. **Validate Layout**:
63+
- Compare the board outline with `Solar Cooling Project-Edge_Cuts.gbr`.
64+
- Verify component placements using `Pick Place for IOT B oard FIle.txt` (import via File > Import > Placement File).
65+
- Check routing against Gerber files (`F_Cu.gbr`, `B_Cu.gbr`) using KiCAD’s Gerber Viewer (File > Import > Gerber Files).
66+
4. **Modify (if needed)**:
67+
- Adjust component positions in Pcbnew.
68+
- Reroute traces to optimize the layout.
69+
- Update the board outline on the `Edge.Cuts` layer.
70+
5. **Import Drill Files**:
71+
- Import `Solar Cooling Project-PTH.drl` and `NPTH.drl` (File > Import > Drill Files) to ensure correct via and hole placement.
72+
6. **3D Verification**:
73+
- View the PCB in 3D (View > 3D Viewer) and compare with `IOT B oard FIle.step`.
74+
- Assign 3D models to footprints if needed (Footprint Properties > 3D Settings).
75+
76+
### 4. Generate Fabrication and Assembly Files
77+
1. **Gerber Files**:
78+
- In Pcbnew, go to File > Plot.
79+
- Select layers: `F.Cu`, `B.Cu`, `F.Silkscreen`, `B.Silkscreen`, `F.Mask`, `B.Mask`, `Edge.Cuts`.
80+
- Output to a `Gerber/` folder.
81+
- Verify against original Gerbers using a Gerber viewer (e.g., KiCAD’s Gerber Viewer or Gerbv).
82+
2. **Drill Files**:
83+
- In Pcbnew, go to File > Fabrication Outputs > Drill Files.
84+
- Generate Excellon drill files for PTH and NPTH.
85+
- Output to a `NC Drill/` folder.
86+
3. **Bill of Materials (BOM)**:
87+
- In Eeschema, go to Tools > Generate Bill of Materials.
88+
- Export as CSV or XLSX to `PCBA/BOM.xlsx`.
89+
- Cross-check with `BOM_PartType-Open Solar Cooling Hub PCB Project.xlsx`.
90+
4. **Pick & Place File**:
91+
- In Pcbnew, go to File > Fabrication Outputs > Component Placement File.
92+
- Output to `PCBA/Pick_Place.txt`.
93+
- Verify against `Pick Place for IOT B oard FIle.txt`.
94+
5. **Assembly Drawing**:
95+
- In Pcbnew, go to File > Plot and export a PDF of the board layout to `PCBA/Assembly.pdf`.
96+
6. **3D Model**:
97+
- In Pcbnew, go to File > Export > STEP.
98+
- Save to `ExportSTEP/Solar_Cooling_Project.step`.
99+
100+
### 5. Validate Outputs
101+
- **Gerber Comparison**: Use a Gerber viewer to ensure KiCAD-generated Gerbers match the original Altium Gerbers.
102+
- **BOM and Pick & Place**: Confirm component lists and placements align with the original files.
103+
- **Fabrication Test**: Send Gerber and drill files to a PCB manufacturer (e.g., JLCPCB) to verify acceptance.
104+
- **Assembly Check**: Provide BOM, Pick & Place, and Assembly PDF to an SMT service for validation.
147105

148106
---
149107

150-
## Summary of Folder Contents
108+
## How to Use the Outputs
151109

152-
| Folder / File | Purpose |
153-
|----------------------------------------------|---------------------------------------------|
154-
| `Gerber/` | PCB fabrication layers |
155-
| `NC Drill/` | Hole/via definitions |
156-
| `ODB/` | Consolidated PCB data |
157-
| `ExportSTEP/` | 3D mechanical model |
158-
| `PCBA-.../BOM.xlsx` | Component sourcing |
159-
| `PCBA-.../Pick Place.txt` | SMT assembly automation |
160-
| `PCBA-.../Assembly.PDF` | Human-readable component placement |
161-
| `.SchDoc`, `.CMPcbDoc`, `.PrjPcb`, `.OutJob` | Editable source files for schematic/layout |
110+
- **Fabrication**: Send the `Gerber/` and `NC Drill/` folders to a PCB manufacturer (e.g., JLCPCB, PCBWay).
111+
- **Assembly**: Provide `PCBA/BOM.xlsx`, `PCBA/Pick_Place.txt`, and `PCBA/Assembly.pdf` to an SMT assembly service.
112+
- **Modify/Rebuild**: Use `Solar Cooling Project.kicad_sch` and `.kicad_pcb` in KiCAD to edit the design and regenerate outputs.
113+
- **Enclosure Design**: Use `ExportSTEP/Solar_Cooling_Project.step` in CAD tools like FreeCAD or Fusion 360.
162114

163115
---
164116

165-
## How to Use
166-
167-
### To fabricate the board:
168-
Send the contents of the **Gerber**, **NC Drill**, and optionally **ODB** folders to a PCB manufacturer like JLCPCB.
117+
## Licensing
169118

170-
### To assemble components:
171-
Send the **BOM**, **Pick & Place**, and **Assembly PDF** to an SMT service provider like JLCPCB.
172-
173-
### To modify or rebuild the design:
174-
Open the schematic and PCB files using **Circuitmaker**, then use the **OutJob files** to regenerate outputs.
119+
This project is licensed under the **CERN Open Hardware License v2.0**. Ensure all modifications and derivatives retain this license.
175120

176121
---
177122

178-
## Licensing Note
179-
180-
All design files are licensed under the **CERN Open Hardware License v2.0**.
123+
## Notes
181124

125+
- If the existing `.kicad_sch` or `.kicad_pcb` files are incomplete, reference the original Altium outputs (Gerbers, BOM, etc.) to rebuild the schematic and layout.
126+
- Use KiCAD’s built-in libraries or external sources (e.g., DigiKey, SnapEDA) for symbols and footprints not included in the project.
127+
- For complex modifications, consult the original Assembly PDF and 3D STEP file to ensure accuracy.
182128

0 commit comments

Comments
 (0)