122 lines
5.2 KiB
Markdown
122 lines
5.2 KiB
Markdown
# Archimajor — AllSpice / DRCY AI Demo
|
||
|
||
This repository is a demo for **AllSpice** featuring **DRCY**, our AI-driven design review assistant. It showcases how DRCY can review PCB design changes, identify potential issues, and suggest corrections — all within your existing Altium-based workflow.
|
||
|
||
|
||
<img src="images/meet_drcy.png" alt="Diagram" width="400">
|
||
|
||
|
||
---
|
||
|
||
## What is Archimajor
|
||
|
||
The demo project is based on the *Archimajor* board: a combined 3D-printer motherboard (RAMBo style) with a 32-bit Atmel SAM3X8E processor, TMC2130 stepper drivers, and multiple other integrated circuits — all on a single PCB. It represents a realistic, moderately complex design so you can see DRCY in action.
|
||
|
||
|
||
|
||
|
||
---
|
||
|
||
## DRCY AI Review Features
|
||
|
||
DRCY is built to assist you in ensuring your PCB designs are robust, manufacturable, and free from common errors. In this demo, DRCY will:
|
||
|
||
- **Track & analyze design changes**: See what’s been modified since the last version (e.g. component changes, layout updates).
|
||
- **Flag errors and potential issues**: e.g. clearance violations, missing vias, signal integrity concerns, thermal problems, component misplacements.
|
||
- **Suggest actionable fixes**: DRCY not only points out what might be wrong — it recommends how to correct it.
|
||
- **Support in design reviews**: Generate review reports you can share with engineers, integrate comments for collaboration, and link back to schematic / PCB files.
|
||
|
||
---
|
||
|
||
## Board Technical Specifications
|
||
|
||
| Feature | Description |
|
||
|---|---|
|
||
| Processor | Atmel SAM3X8E (32-bit) |
|
||
| Motor Drivers | 5 × integrated TMC2130 (256 micro-step) |
|
||
| Outputs | 6 PWM MOSFET outputs |
|
||
| Inputs | 4 thermistor inputs |
|
||
| Communications | SPI for motor current control |
|
||
| Power Rails | Fuse-protected (ATC), multiple rails |
|
||
| USB | Full-speed USB isolated with ADUM |
|
||
| IDE Compatibility | Native Arduino IDE support |
|
||
| Input Power | 12-24 V DC up to ~16 A |
|
||
| Operating Temp | 0 °C – 70 °C |
|
||
|
||
---
|
||
|
||
## Using the Demo
|
||
|
||
Here’s how you can try out DRCY with this demo repo:
|
||
|
||
1. **Clone the repo** to your local environment.
|
||
2. **Open the project** in Altium (or compatible ECAD viewer) to inspect schematic and PCB files.
|
||
3. **Add DRCY to your Design Review** — it will automatically analyze design changes (compared to prior version), flag possible issues, and generate suggested fixes.
|
||
4. **Inspect the flagged items and suggestions** via the Design Reviews tab in AllSpice.
|
||
5. **Use the Issues tab**: see existing issues, and try filing a new one (note: templates are provided).
|
||
6. **Simulate a change** (e.g. move a component, change trace widths, alter thermal vias) and then run DRCY again to see how it responds.
|
||
|
||
---
|
||
|
||
## What You’ll See
|
||
|
||
- A list of *found issues* categorized by severity (critical, warning, etc.)
|
||
- Inline suggestions/comments tied to schematic or PCB layout files
|
||
- Automatically generated reports summarizing the review, optionally exportable
|
||
- Version diff highlighting what changed since the last review — what triggered each flag
|
||
|
||
---
|
||
|
||
## Why This Matters
|
||
|
||
DRCY helps reduce time and risk in your PCB design cycles by:
|
||
|
||
- catching errors early (before manufacturing)
|
||
- reducing manual review overhead
|
||
- enabling more consistent design quality
|
||
- providing educational feedback for less-experienced designers
|
||
|
||
---
|
||
|
||
## Design Review Flowchart
|
||
```mermaid
|
||
flowchart TD
|
||
A[Start design review] --> E["Run simulations<br/>(Capture results)"]
|
||
E --> F["System checks<br/>(Power, I/O, Environment)"]
|
||
F --> G["Component checks<br/>(Specs, Availability, Derating)"]
|
||
G --> H["Schematic review<br/>(Connections, Symbols, Labels)"]
|
||
H --> I["PCB layout review<br/>(Placement, Clearance, Routing)"]
|
||
I --> J["Manufacturing checks<br/>(Stackup, Footprints, Panelization)"]
|
||
J --> K["Testing & compliance<br/>(Test points, ROHS, ESD)"]
|
||
K --> L[Approval & merge]
|
||
L --> M[Tag release]
|
||
```
|
||
## Component library
|
||
|
||
[Archimajor Component Library](https://hub.allspice.io/Allspice-demos/Altium-component-library-demo)
|
||
|
||
## Firmware Repo
|
||
|
||
[Current FW image](https://github.com/ultimachine/Marlin/commit/2f9e3b771e2669118cce922ad52785165e16d1e9)
|
||
|
||
## To Do List
|
||
|
||
To make the most out of this demo we suggest you to:
|
||
|
||
- [ ] Clone this repo to your local env
|
||
- [ ] Review the schematics and PCB files within AllSpice and your local env.
|
||
- [ ] Take a look at the board prints in [this file](https://hub.allspice.io/AllSpice-Demos/Altium-Demo/src/branch/main/Archim2_2.2b_PCB_Prints.PDF)
|
||
- [ ] Review the Design Reviews tab and the comments left
|
||
- [ ] Review the Issues tab and create a new one from the templates.
|
||
- [ ] See the releases for the [repo](https://hub.allspice.io/AllSpice-Demos/Altium-Demo/releases)
|
||
- [ ] Fork the repo and make an update yourself to later do a resign review
|
||
|
||
|
||
## Documentation
|
||
- [Git 101](https://learn.allspice.io/docs/git-101)
|
||
- [AllSpice Crash Course](https://learn.allspice.io/docs/allspice-crash-course)
|
||
- [Design review and merging guide](https://learn.allspice.io/docs/design-reviews-and-merging)
|
||
- Importance of [.gitignore](https://learn.allspice.io/docs/git-101) and [.gitattributes](https://learn.allspice.io/docs/how-to-minimize-files-in-design-review-by-file-pattern-or-extension) files.
|
||
|
||
## Sources
|