Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/atopile/atopile
Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️
https://github.com/atopile/atopile
cad eda electronics engineering tools-and-automation
Last synced: about 1 month ago
JSON representation
Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️
- Host: GitHub
- URL: https://github.com/atopile/atopile
- Owner: atopile
- License: apache-2.0
- Created: 2023-12-19T20:52:13.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-08-07T20:33:02.000Z (3 months ago)
- Last Synced: 2024-08-07T23:31:34.121Z (3 months ago)
- Topics: cad, eda, electronics, engineering, tools-and-automation
- Language: Python
- Homepage: https://atopile.io
- Size: 74.2 MB
- Stars: 1,861
- Watchers: 15
- Forks: 107
- Open Issues: 62
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Roadmap: docs/roadmap.md
Awesome Lists containing this project
README
## 📖 What Is `atopile`?
`atopile` is a tool to build electronic circuit boards with code.
## 🗣️ Join Us On Discord
What's your story in electronics? What would you like us to build? Come talk on discord.
[](https://discord.gg/nr5V3QRUd3)
## ⚡️`ato` Code Examples
### A simple voltage divider
```python
from "generics/resistors.ato" import Resistor
from "generics/interfaces.ato" import Power, Pair
module VDiv: #this name needs to match the name in the ato.yaml config file
power = new Power
output = new Pair
r_top = new Resistor
r_top.package = "0402"
r_bottom = new Resistor
r_bottom.package = "0402"
power.vcc ~ r_top.p1; r_top.p2 ~ output.io
output.io ~ r_bottom.p1; r_bottom.p2 ~ power.gnd; power.gnd ~ output.gnd
v_in: voltage
v_out: voltage
i_q: current
assert v_in * r_bottom.value / (r_top.value + r_bottom.value) within v_out
assert v_in / (r_bottom.value + r_top.value) within i_q
v_in = 3.3V +/- 2%
v_out = 1.8V +/- 5%
i_q = 1mA +/- 10%
```
### The classic "Blinky" circuit
Define your design with **ato code**
```python
import RP2040Kit from "rp2040/RP2040Kit.ato" # run `ato install rp2040` to install
import LEDIndicatorRed from "generics/leds.ato"
import LV2842Kit from "lv2842xlvddcr/lv2842kit.ato" # run `ato install lv2842xlvddcr` to install
import USBCConn from "usb-connectors/usb-connectors.ato" # run `ato install usb-connectors` to install
module Blinky:
micro_controller = new RP2040Kit
led_indicator = new LEDIndicatorRed
voltage_regulator = new LV2842Kit
usb_c_connector = new USBCConn
usb_c_connector.power ~ voltage_regulator.power_in
voltage_regulator.power_out ~ micro_controller.power
micro_controller.gpio13 ~ led_indicator.input
micro_controller.power.gnd ~ led_indicator.gnd
led_indicator.v_in = 3.3volt +/-10%
```
Generate a **block diagram** from code
Produce **schematics** for documentation
### Discover Full Projects
Checkout out the [servo drive project](https://github.com/atopile/spin-servo-drive) or the [swoop motion controller](https://github.com/atopile/swoop).
## 🔨 Getting Started
Find our [documentation](https://atopile.io/), [installation video](https://www.youtube.com/watch?v=XqFhFs-FhQ0) and getting started [video](https://www.youtube.com/watch?v=7aeZLlA_VYA).
`atopile` is on pypi.org: https://pypi.org/project/atopile/
### Most Basic Installation
`atopile` requires *python3.11* or later, which you can install using your package manager or from [python.org](https://www.python.org/downloads/).
Then just `pipx install atopile` and you're good to go!
## ❓ Why Atopile?
The objective of atopile is to help push forward these paradigms from the software world to hardware, mainly these points:
* **Intelligent Design Capture**: Define hardware specifications like ratios and tolerances in code, enabling precise control and easy reuse of designs.
* **Version Control Integration**: Use git to manage design changes, facilitating collaboration and ensuring each iteration is thoroughly reviewed and validated.
* **Continuous Integration (CI)**: Implement CI to guarantee high-quality, compliant designs with every commit, represented by a green checkmark for assurance.
Describing hardware with code might seem odd at first glance. But once you realize it introduces software development paradigms and toolchains to hardware design, you'll be hooked, just like we've become.
Code can **capture the intelligence** you put into your work. Imagine configuring not the resistance values of a voltage divider, but its ratio and total resistance, all using **physical units** and **tolerances**. You can do this because someone before you described precisely what this module is and described the relationships between the values of the components and the function you care about. Now instead imagine what you can gain from **reusing** a buck design you can merely **configure** the target voltage and ripple of. Now imagine **installing** a [servo drive](https://github.com/atopile/spin-servo-drive) the same way you might numpy.
Version controlling your designs using **git** means you can deeply **validate** and **review** changes a feature at a time, **isolated** from impacting others' work. It means you can detangle your organisation and **collaborate** on an unprecedented scale. We can forgo half-baked "releases" in favor of stamping a simple git-hash on our prototypes, providing an anchor off which to **associate test data** and expectations.
Implementing CI to **test** our work ensures both **high-quality** and **compliance**, all summarised in a green check mark, emboldening teams to target excellence.
## 🔍 Discover what people build
Browse and submit your modules at [packages.atopile.io](https://packages.atopile.io)