base on Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️ <h1 align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/atopile/atopile/assets/9785003/00f19584-18a2-4b5f-9ce4-1248798974dd"> <source media="(prefers-color-scheme: light)" src="https://github.com/atopile/atopile/assets/9785003/d38941c1-d7c1-42e6-9b94-a62a0996bc19"> <img alt="Shows a black logo in light color mode and a white one in dark color mode." src="https://github.com/atopile/atopile/assets/9785003/d38941c1-d7c1-42e6-9b94-a62a0996bc19"> </picture> </h1> <div align="center"> <a href="#"> <img src="https://img.shields.io/pypi/v/atopile.svg" alt="Version" style="vertical-align:top; margin:6px 4px"> </a> <a href="#"> <img src="https://img.shields.io/github/license/atopile/atopile.svg" alt="License" style="vertical-align:top; margin:6px 4px"> </a> <a href="#"> <img src="https://github.com/atopile/atopile/actions/workflows/ci.yml/badge.svg" alt="Build status" style="vertical-align:top; margin:6px 4px"> </a> </div> <h1 align="center"> <br> <img src="docs/assets/images/code-layout-pcb.png" alt="Logo atopile" title="Logo atopile" /> <br> </h1> ## 📖 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 <h1 align="center"> <picture> <img alt="Schematics example" src="docs/assets/images/block_diagram_example.png" style="width: 80%;"> </picture> </h1> Produce **schematics** for documentation <h1 align="center"> <picture> <img alt="Schematics example" src="docs/assets/images/schematic_example.png" style="width: 80%;"> </picture> </h1> ### 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/ ### Installation `atopile` is published to [pypi.org](https://pypi.org/project/atopile/). We recommend installing into an isolated environment, e.g. with `uv`: ```sh uv tool install atopile ``` Or with `pipx` (requires Python 3.13): ```sh pipx install atopile ``` ## ❓ 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) ", Assign "at most 3 tags" to the expected json: {"id":"7597","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"