https://github.com/hstarmans/hexastorm
Amaranth HDL framework for laser scanner with motion control
https://github.com/hstarmans/hexastorm
amaranth-hdl cnc-machine esp32-s3 fpga laser laser-scanner micropython raspberry
Last synced: 3 months ago
JSON representation
Amaranth HDL framework for laser scanner with motion control
- Host: GitHub
- URL: https://github.com/hstarmans/hexastorm
- Owner: hstarmans
- License: other
- Created: 2019-12-19T18:06:34.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-07-31T10:53:25.000Z (10 months ago)
- Last Synced: 2025-07-31T14:22:48.532Z (10 months ago)
- Topics: amaranth-hdl, cnc-machine, esp32-s3, fpga, laser, laser-scanner, micropython, raspberry
- Language: Python
- Homepage:
- Size: 4.63 MB
- Stars: 30
- Watchers: 6
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- amaranth-awesome - hexastorm
README
# Laser scanner
[Laser scanning](https://en.wikipedia.org/wiki/Laser_scanning) is the controlled deflection of laser beams, visible or invisible.
In a high-speed polygon scanner system, the laser is deflected by a rotating prism or mirror.
The position of the laser is determined via a photodiode.
Hexastorm is a full toolkit for working with polygon lasers scanners using FPGA technology and provides hardware, gateware, and software
to enable laser scanning applications.
Code is tested on the system shown above, branded as [Hexastorm](https://www.hexastorm.com).
The FreeCAD design is shared [here](https://github.com/hstarmans/hexastorm_design)
and PCB designs are found [here](https://github.com/hstarmans/firestarter).
A blog can be found on [Hackaday](https://hackaday.io/project/21933-open-hardware-fast-high-resolution-laser).
The code took most inspiration from [LDGraphy](https://github.com/hzeller/ldgraphy).
Making a PCB with scanner is shown in the video;
[](http://www.youtube.com/watch?v=dR09Tev0cPk "Making PCB with Laser Direct Imaging").
The alignment procedure is shown in the following video.
[](http://www.youtube.com/watch?v=Ri6DAneEzw4 "Alignment procedure")
## Requirements
Code can be deployed on microcontroller ESP32S3 and FPGA UP5K.
This requires additional library [esp32_hexastorm](https://github.com/hstarmans/esp32_hexastorm).
Part of the code can be run on Micropython, rest is Python only.
# Install
Install the dependency manager uv.
```console
sudo apt install pipx
pipx ensurepath
pipx install uv
```
Use uv to install the dependencies in pyproject.toml.
```console
uv sync
```
Code can be executed as follows.
```console
uv sync --group dev
uv run pdm run test
uv sync --group plot
uv run python -m hexastorm.interpolator.patterns.create
uv run python -m hexastorm.interpolator.interpolator
```