Skip to the content
2 layers334.5 × 153.8 mmOut, the printed circuit board in 3D

A Programming Language and System for making PCBs

Size
334.5 × 153.8 mm
Copper layers
2
Thickness
1.6 mm
Parts
128
Nets
83
Pads
584
Tracks, vias
0, 0
Routed
Not yet
KiCad
KiCad 5
Created
6 Aug 2019
Updated
18 Feb 2022

Overview

Out is an open-source printed circuit board by bhdl, from the bhdl/bhdl repository on GitHub. It is a 2-layer board of 334.5 × 153.8 mm with 128 parts on 83 nets.

Its parts include 44 diodes and 36 ICs.

README

README.md

Board HDL: A Programming Language and System for making PCBs

Documents can be found at https://bhdl.org

This project is currently developed on a new IDE called CodePod, which is not publicly available yet. The src folder here is exported from CodePod IDE. We're working on making CodePod available for the general public. Issues are being tracked in this repo.

BHDL is a programming language embedded in racket. In addition to the language, the system consists of a layout co-design system based on functional picture, REPL-driven interactive development and visualization, libraries, KiCAD compatible exporter, and placement engines including an optimization-based anlytical placer (ePlace) and simulated annealing based detailed placer.

Setup

Install Racket

Install racket:

sh
apt install racket

On MacOS and Windows, you can download the installer from the Racket website, and setup the commandline properly.

Install BHDL package

Step 2: Install the BHDL directly as a racket package:

text
raco pkg install --auto https://github.com/bhdl/bhdl.git?path=src

You can now run racket and require bhdl. The first time requiring bhdl, it will download footprint library to ~/.config/bhdl/bhdl-footprints (Linux) or ~/Library/Application Support/bhdl/bhdl-footprints (MacOS).

racket
racket
> (require bhdl)

Then try some of the examples.

Update BHDL

In the future, you can update the package if there're updates upstream via:

shell
raco pkg update src

note TODO package name should be bhdl

JupyterLab IDE

In general, you can run racket programs via command line, editor plugins, IDEs. We are not covering them here. Instead, we recommand run the program via jupyter notebook. To set it up, first install jupyter:

shell
pip install jupyterlab

The iracket kernel requires on libzeromq:

shell
sudo apt install libzmq5

note for MacOS

On MacOS, it is a little trickier to setup libzmq. Specifically, you need to copy the library to the racket's library path, otherwise racket won't find it:

shell
brew install zmq
cp /opt/homebrew/Cellar/zeromq/4.3.4/lib/libzmq.5.dylib Library/Racket/8.2/lib

Then install the kernel itself:

shell
raco pkg install iracket
raco iracket install

note: iracket does not allow write access to file system by default. So you have to modify the kernel file with a -t parameter. In short, you need to modify the content of ~/.local/share/jupyter/kernels/racket/kernel.json on your system from ["racket","-l","iracket/iracket","--","{connection_file}"] to ["racket","-l","iracket/iracket","--","-t","{connection_file}"]

Then start the jupyterlab server:

shell
jupyter lab

You'll be able to create racket notebooks in the JupyterLab IDE. Inside the notebook, try (require bhdl) and some of the exampels.

Placement (Optional)

To run the placement engine, you need setup julia. Refer to their installation guide on how to install Julia.

Install the BHDL julia package:

text
julia
]add https://github.com/bhdl/bhdl

Then run the server:

text
import BHDL
BHDL.web_server()

This will listen on http://0.0.0.0:8082. To use this, in racket, set the parameter placer-url, and call circuit-export with #:auto-place #t:

racket
;; set placer url
(placer-url "http://0.0.0.0:8082")
(circuit-export three-button #:auto-place #t ...)

This package will detect if Nvidia GPU is available, and use it if possible. The first time invoking the package, julia will download and instantiate the dependencies and download CUDA (julia will not use your system's CUDA setup). The first time the placement is running, Julia will pre-compile the code, thus maybe a little slower. Subsequent placement request will be much faster (which is why we use a server instead of invoking the command for every placement request).

Freerouting (Optional)

To use routing, you need to have freerouting available. We tested on freerouting-v1.4.4. Make sure freerouting-1.4.4-executable.jar is available in your $PATH.

The executable can be downloaded here on the new freerouting maintainer website: https://freerouting.mihosoft.eu/

UPDATE: the jar file is often not an executable command. You'll need

text
java -jar freerouting-1.4.4-executable.jar

Thus, you need to create a executable called freerouting, containing:

text
#!/bin/bash
java -jar /path/to/freerouting-1.4.4-executable.jar

freerouting will need X11 window, even if we are running it in command line. Simulate the X11 session via:

text
sudo apt install xvfb
Xvfb :1

But it seems to be impossible to view the progress. We'll probably need to use VNC if we really want to know what's going on.

Parts

128
QtyValueFootprintReferences
1—D85D85
1—D117D117
1—U108U108
1—U90U90
1—U42U42
1—D125D125
1—D5D5
1—D75D75
1—U56U56
1—U54U54
1—U102U102
1—D71D71
1—D19D19
1—U80U80
1—D87D87
1—D41D41
1—U128U128
1—D29D29
1—D81D81
1—D61D61
1—D123D123
1—U92U92
1—D33D33
1—D53D53
1—U114U114
1—D89D89
1—U40U40
1—U10U10
1—D45D45
1—D111D111
1—U38U38
1—D59D59
1—U76U76
1—D39D39
1—D17D17
1—U52U52
1—U118U118
1—D65D65
1—U58U58
1—D115D115
1—U44U44
1—U6U6
1—D21D21
1—D83D83
1—U88U88
1—D27D27
1—U70U70
1—D119D119
1—D69D69
1—D51D51
1—D103D103
1—U28U28
1—U84U84
1—D97D97
1—D47D47
1—D13D13
1—U8U8
1—U26U26
1—D1D1
1—U50U50
1—U66U66
1—U20U20
1—U100U100
1—D25D25
1—D55D55
1—D121D121
1—D23D23
1—U124U124
1—D113D113
1—D77D77
1—U104U104
1—D11D11
1—U116U116
1—U112U112
1—D15D15
1—D91D91
1—U4U4
1—U62U62
1—D31D31
1—U2U2

The 80 most common of 128 parts.

More from bhdl/bhdl

8
  • 2 layers334.5 × 153.8 mmOut, the printed circuit board in 3D

    Out

    bhdl/bhdl

    A Programming Language and System for making PCBs

    147 parts8
  • 2 layers110.6 × 165.4 mmOut, the printed circuit board in 3D

    Out

    bhdl/bhdl

    A Programming Language and System for making PCBs

    59 parts8
  • 2 layers110.6 × 109.2 mmOut, the printed circuit board in 3D

    Out

    bhdl/bhdl

    A Programming Language and System for making PCBs

    40 parts8
  • 2 layers104.2 × 31.8 mmOut, the printed circuit board in 3D

    Out

    bhdl/bhdl

    A Programming Language and System for making PCBs

    22 parts8
  • 2 layers36.7 × 51.5 mmOut, the printed circuit board in 3D

    Out

    bhdl/bhdl

    A Programming Language and System for making PCBs

    19 parts8
  • 2 layers120.7 × 148 mmOut, the printed circuit board in 3D

    Out

    bhdl/bhdl

    A Programming Language and System for making PCBs

    17 parts8
  • 2 layers80.9 × 23.8 mmOut, the printed circuit board in 3D

    Out

    bhdl/bhdl

    A Programming Language and System for making PCBs

    10 parts8
  • 2 layers32.8 × 30.8 mmOut, the printed circuit board in 3D

    Out

    bhdl/bhdl

    A Programming Language and System for making PCBs

    6 parts8

Similar boards

  • 2 layers98.4 × 190.5 mmChainlinkBase, the printed circuit board in 3D

    ChainlinkBase

    scottbez1/splitflap

    DIY split-flap display

    128 parts4.2k
  • 2 layers39.6 × 99.1 mmESP32-Eurorack Audio, the printed circuit board in 3D

    ESP32-Eurorack Audio

    ctag-fh-kiel/ctag-tbd

    CTAG TBD >>to be determined<< an extendible open source Eurorack sound module

    128 parts260
  • 2 layers165 × 103.8 mmOutput pcb, the printed circuit board in 3D

    Output pcb

    QuinnFreedman/modular

    A collection of free & open source DIY synthesizer module designs for Eurorack

    128 parts116
  • 2 layers141.4 × 115.9 mmKapl, the printed circuit board in 3D

    Kapl

    keyzog/kapl

    The Kapl is a split ergonomic keyboard with 70 keys (7x5)

    128 parts88MIT
  • 2 layers97.2 × 58.9 mmDecentUSB2040, the printed circuit board in 3D

    DecentUSB2040

    bleroy/3d-junkyard

    Random 3D models

    128 parts69
  • 2 layers264 × 141.2 mmKorris, the printed circuit board in 3D

    Korris

    yanghu/unicorne

    A one-piece 40% ortho keyboard design inspired by crkbd, Kyria and Ferris.

    128 parts63MIT
  • 2 layers86 × 86 mmProduction, the printed circuit board in 3D

    Production

    kerikun11/IR-Station

    Infrared Remote Controller with ESP8266 WiFi-module. You can control your home appliances with your smartphone or laptop.

    128 parts54MIT
  • 2 layers149 × 104 mmUaBrain gm e38, the printed circuit board in 3D

    UaBrain gm e38

    rusefi/rusefi-hardware

    128 parts52

Questions

How big is the Out PCB?

It measures 334.5 × 153.8 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Out use?

128 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Out KiCad files?

From the bhdl/bhdl repository on GitHub, at the commit this page was made from: the board is bhdl-test/out/bhdl-key-matrix-module/out.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Out design in my own project?

Its repository states no licence, so its author keeps all rights: ask bhdl before reusing the design.