Skip to main content

A toolchain bringing the best of software development to the real-world!

Project description

Shows a black logo in light color mode and a white one in dark color mode.


Logo atopile

📖 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.

Discord Banner 3

⚡️ato Code Examples

A simple voltage divider

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

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

Schematics example

Produce schematics for documentation

Schematics example

Discover Full Projects

Checkout out the servo drive project or the swoop motion controller.

🔨 Getting Started

Find our documentation, installation video and getting started video.

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.

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 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

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

atopile-0.2.69.tar.gz (62.0 MB view details)

Uploaded Source

Built Distribution

atopile-0.2.69-py3-none-any.whl (787.7 kB view details)

Uploaded Python 3

File details

Details for the file atopile-0.2.69.tar.gz.

File metadata

  • Download URL: atopile-0.2.69.tar.gz
  • Upload date:
  • Size: 62.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for atopile-0.2.69.tar.gz
Algorithm Hash digest
SHA256 a16722e4a3385cb531d7dd2807d733e984c06579aa16b45a059e3d23ebfc44fd
MD5 776e77e863f971477beb35ca6ad5fc0e
BLAKE2b-256 e45d6db4168931c7d203149b0a32eeb0cec4a979ba3d08c4f3f50abbd477845c

See more details on using hashes here.

File details

Details for the file atopile-0.2.69-py3-none-any.whl.

File metadata

  • Download URL: atopile-0.2.69-py3-none-any.whl
  • Upload date:
  • Size: 787.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for atopile-0.2.69-py3-none-any.whl
Algorithm Hash digest
SHA256 0eca3e8041d34d33b0ba0859027b5c060995d59514eca1a509cc957cec83f8bd
MD5 dc040c180fc2e4209487c01c06d45e3c
BLAKE2b-256 43c19115707e42782051f222d1211ab20a75d8ded728c3356f1149a6f4c13e9d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page