diff --git a/README.md b/README.md
index 71990cc..4ad5a87 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,16 @@
 # ceda2vga
 A video adapter for Sanco 8000 series computers, to use your handy flat-screen VGA display.
 
+This project is part of a reverse engineering effort of a Sanco 8003 by [RetrOfficina GLG Programs](https://retrofficina.glgprograms.it/).
+Also see [ceda-home](https://github.com/GLGPrograms/ceda-home).
+
+<img src="img/ceda2vga.jpeg" width="320" />
+<img src="img/vga-detail.jpeg" width="320" />
+
+## How it works
+A Raspberry Pi Pico syncs with a Sanco-generated frame, captures and stores it; then the frame is sent out as a VGA signal.
+This project extensively uses pi2040's PIO peripheral and DMA capabilities.
+
 ## Setup
 ```
 ./setup.sh
@@ -12,3 +22,22 @@ A video adapter for Sanco 8000 series computers, to use your handy flat-screen V
 ./build.sh
 
 ```
+
+## Build
+Circuit is extremely trivial, see [PDF schematics](board/ceda2vga.pdf).
+
+### BOM
+| component                   | # |
+| --------------------------- | - |
+| Raspberry Pi Pico dev board | 1 |
+| DE-15 socket (female)       | 1 |
+| 10kR resistor               | 5 |
+| 1.2kR resistor              | 1 |
+| 200R resistor               | 1 |
+| 82R resistor                | 1 |
+| 1kR resistor                | 1 |
+| push button                 | 1 |
+
+## License
+SPDX-License-Identifier: GPL-3.0-only
+
diff --git a/img/ceda2vga.jpeg b/img/ceda2vga.jpeg
new file mode 100644
index 0000000..ba24b8a
Binary files /dev/null and b/img/ceda2vga.jpeg differ
diff --git a/img/vga-detail.jpeg b/img/vga-detail.jpeg
new file mode 100644
index 0000000..122b7c3
Binary files /dev/null and b/img/vga-detail.jpeg differ