Skip to the content
4 layers101.6 × 53.3 mmHackeeg shield, the printed circuit board in 3D

Hackeeg shield

Tahacrpc/EEG-I-LAB1

ADS1299 Tabanlı 8 Kanallı EEG Tasarımı

Size
101.6 × 53.3 mm
Copper layers
4
Thickness
1.61 mm
Parts
151
Nets
183
Pads
560
Tracks, vias
1,463, 166
Pours
27
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
26 Aug 2026
Updated
27 Oct 2026

Overview

Hackeeg shield is an open-source printed circuit board by Tahacrpc, from the Tahacrpc/EEG-I-LAB repository on GitHub. It is a 4-layer board of 101.6 × 53.3 mm with 151 parts on 183 nets, routed with 1,463 tracks and 166 vias.

It is built around the 24AA256UID-I/P and ADS1299IPAG. Its parts include 71 capacitors, 29 resistors, 10 ICs, 4 inductors and 2 diodes.

Main components

2

README

README.md

EEG-I-LAB

8-channel EEG acquisition prototype based on the TI ADS1299

EEG-I-LAB is a hardware and firmware project to build and validate an eight-channel EEG acquisition board. The hardware is derived from the open-source HackEEG Shield by Adam Feuer / Starcat LLC, which is licensed under the CERN OHL v1.2. The aim is a verified, reproducible platform for later signal-processing and BCI research.

Safety: bench use only. This board has no patient isolation. Do not connect electrodes to a person, or to any animal, until the complete system has passed a separate electrical and patient-safety validation. Until then, use only electrical checks, the ADS1299 internal test signal and suitable laboratory signal sources. No medical-device certification or clinical suitability is claimed.


1. Status at a glance (2026-10-27)

AreaStatus
PCB design (Altium)Released for prototype manufacturing as REV_MFG_2026-10-07. Not yet ordered.
Manufacturing packageApproved JLCPCB ZIP, SHA-256 189464c80a5fc6bac3b1d4c8ed5a5303f555be72a446daadbe1281b81af7f7ff
Known PCB defectRESV1 (ADS1299 pin 31) is floating. Every board of this revision needs a bodge wire (see §7).
KiCad migrationCandidate CP01: electrically equivalent to the Altium release, but not the source of truth. Open items remain (see §6).
FirmwareESP32 DevKit V1 and STM32 Nucleo bring-up sketches compile with 0 errors and 0 warnings. Not yet run on hardware.
BOM / sourcingPurchase-ready for 3 boards + spares through Türkiye-based suppliers. Nothing ordered.
PrototypeNot manufactured, assembled or tested. No measured performance yet.

2. System architecture

text
Electrodes ─► input RC filters ─► ADS1299 (8 ch, 24-bit, PGA 1–24, up to 16 kSPS)
                                        │ SPI (mode 1)
                              TXB0108 / TXS0102 level shifters
                                        │ 15 jumper wires (bench)
                      ESP32 DevKit V1  or  STM32 Nucleo (fallback)
                                        │ USB serial, 460 800 baud
                               Host PC (firmware/host/ads1299_bringup_check.py)
ParameterValue
Analog front endTexas Instruments ADS1299 (ADS1299IPAGR, TQFP-64)
Channels8 differential / single-ended inputs
Resolution24-bit ΔΣ
Analog supply±2.5 V: TPS73225 for +2.5 V; TPS60403 charge pump feeding a TPS72325 for −2.5 V
Digital supply3.3 V DVDD, taken from the controller during bring-up
ReferenceADS1299 internal 4.5 V reference
GroundOne ground net (AGND), shared by the ADS1299 AGND and DGND pins
PCB4 layers (Top / AGND / DVDD / Bottom), 1.6 mm, ≈ 101.6 × 53.3 mm (Arduino Mega shield outline)

The original shield plugs into an Arduino Due. This project uses the shield unmounted instead: it is wired to an ESP32 DevKit V1 (primary) or an STM32 Nucleo (fallback) with 15 reversible jumper wires.

3. Repository layout

PathContents
hardware/altium-release/Approved Altium project. This is the fabrication source of truth.
hardware/kicad-cp01/KiCad 10 migration candidate CP01: a verbatim checkpoint with its own SHA256SUMS.txt.
hardware/upstream-hackeeg-shield/Original upstream EAGLE sources, docs, CAM rules, 3D models and licence.
manufacturing/approved/Approved JLCPCB upload ZIP, its SHA-256 files and the release notes.
manufacturing/release-outputs/Full Altium output of the release: Gerber X2, NC drill, paste layers and reports, with SHA256SUMS.txt.
manufacturing/verification/Release verification: Gerber, connectivity, silkscreen and DRC checks, plus visual checks.
firmware/ESP32 and STM32 bring-up sketches, plus the host PASS/FAIL script.
bom/Final BOM, Türkiye order lists and procurement CSVs.
docs/assembly/Assembly checklist and the RESV1 decision package.
docs/bringup/Bring-up plans for the ESP32 and the STM32 Nucleo.
docs/procurement/Sourcing reports (Türkiye single-seller route, route comparison).
docs/kicad-migration/KiCad migration reports and equivalence evidence.
reports/Electrical verification, manufacturing audit and review reports.
tools/Python scripts used for verification, migration and BOM generation.
docs/PROVENANCE.mdMap from the working paths cited in the reports to their repository locations.
LICENSE, LICENSES/, NOTICE.mdLicence overview, full licence texts, attribution and modification notices.

4. Hardware revision and design provenance

  1. Upstream: the HackEEG Shield EAGLE design (hardware/upstream-hackeeg-shield/eagle/hackeeg-shield.sch and .brd), © 2013–2020 Adam Feuer / Starcat LLC.
  2. 2026-10-03: Altium import and Phase 1 verification. The EAGLE design was imported into Altium Designer.
    • At pad level, the imported PCB is identical to the EAGLE board: 554 pads, 183 connectivity groups, 166 vias.
    • The imported schematic had one import defect: the six ADS1299 AVDD pins were isolated from the AVDD net. It was repaired before release, and the schematic and PCB then matched.
    • The 260 Altium ECO differences were all classified.
    • Reports: reports/VERIFICATION_REPORT.md and reports/PCB_MANUFACTURING_AUDIT.md.
  3. 2026-10-07: manufacturing release REV_MFG_2026-10-07.
    • 11 PCB-only changes: design rules, the JLC04161H-7628 stack-up, via tenting, silkscreen normalisation, removal of duplicate cutouts, and moving the copyright text to silk.
    • No schematic, netlist, component, pad or track change.
    • Final DRC: 0 shorts, 0 unrouted nets, 0 different-net clearance violations. Schematic ↔ PCB connectivity: 183/183 net groups identical.
    • Report: reports/FINAL_MANUFACTURING_REVIEW.md.
  4. 2026-10-20: KiCad migration to candidate CP01 (§6).
  5. 2026-10-21: electrical audit against the ADS1299 datasheet (reports/ELECTRICAL_AUDIT_2026-10-21.md). It found the RESV1 defect, which was inherited from upstream.

5. Approved Altium fabrication source

hardware/altium-release/ holds the released Altium project. Its design hashes, as recorded in the release review:

FileSHA-256
hackeeg-shield.PcbDoc (= 07_RELEASE.PcbDoc, release record)60f874cfe183e69fc3a3375b63372f45e7ec3f72b90f1e84129928fc10e5c5f1
hackeeg-shield.PcbDoc (published privacy-sanitized copy)9c88507767b568271cb94e296314fb4147db69be5de82d40a385c1d1574257e5
hackeeg-shield.PrjPcb143dce90f404c46b4a496c9ffb21e2a4ee94c737501daf80df9ae3f87c7ba85a
hackeeg-shield_0.SchDocea3969fcb6acf7bda55f7e5c8bcdedec044c7a30fb5fbf4fbfbae8beaa08b209
hackeeg-shield_1.SchDoce6c78a13f5417ccf379c3cf8ac78be125419ff929b26b00c99aeb4298af64a3b
hackeeg-shield_2.SchDoc46a28ff5bf8e5ff8371614bcfb56cffc9e159702f60bf7554957eed3b1002e6d

The PrjPcb and the three SchDocs are the unmodified release files. In the published PcbDoc and the 14 PcbLibs, a local Windows account name and an Altium installation GUID, both inside one Altium settings path, were replaced by same-length placeholders. No design data changed, and equivalence was verified. Details and the per-file hashes are in hardware/altium-release/PUBLICATION_SANITIZATION.md.

Open hackeeg-shield.PrjPcb in Altium Designer. 33 of the 34 documents it references are in the same folder and use relative paths. The exception is hackeeg-shield.IntLib, an unused generated library that was withheld for privacy. Altium lists it as missing; this does not affect the design.

For this revision, the fabrication files are the ZIP in manufacturing/approved/. Upload it unchanged; do not regenerate Gerbers for the order.

6. KiCad migration status and known limitations

The CP01 candidate is hardware/kicad-cp01/04_repair_candidate/hackeeg-shield.kicad_pro (KiCad 10.0.4).

Verified against the Altium release:

  • All 554 pads keep their nets, and all 183 PCB net groups are identical.
  • 142 components; all 551 schematic pins match.
  • All 166 vias and 1463 tracks match.
  • The Gerber/drill XOR against the approved ZIP shows only documented differences: the MH copper discs (drilled away) and the stroke-font text.
  • KiCad DRC: 0 unconnected items, 0 shorts, 0 clearance violations; the 7 remaining errors are classified.

Known limitations. KiCad is not the source of truth:

  • D6: the symbol footprint fields are not linked to a KiCad footprint library.
  • D7, do not refill the zones: a KiCad refill does not reproduce the approved AGND/DVDD planes (+362 / +393 mm²). The candidate keeps the imported Altium fills.
  • The SPI reference has no number and #PWR? is unannotated. This blocks GUI netlist export and "Update PCB from Schematic". The CLI still works, with a warning.
  • Symbols still load from the Altium .SCHLIB files through sym-lib-table.
  • The RESV1 defect is present here too.

Details are in docs/kicad-migration/TRACK_A_KICAD_RECOVERY_REPORT.md.

7. RESV1 pin 31 bodge wire: required on this revision

The ADS1299 datasheet (TI SBAS499C) says RESV1 (pin 31) must be connected directly to DGND. On REV_MFG_2026-10-07 it is floating, as it is in upstream HackEEG. The chosen option (A) is to fabricate the approved ZIP unchanged and fit a bodge wire to every board, before first power:

  • About 4 mm of insulated 0.1 mm wire (30 AWG Kynar or enamelled), from the IC1 pad 31 toe to C13 pad 2 (AGND = DGND), soldered under a microscope.
  • Ohm checks:
    • pad 31 ↔ AGND (TP3): < 1 Ω
    • pad 31 ↔ pad 32 (AVSS, −2.5 V): open
    • pad 31 ↔ pad 30 (VCAP2): open
  • The proper fix goes into the next PCB revision: a via-in-pad, or re-routing the AVSS/VCAP2 traces.

See docs/assembly/RESV1_DECISION_PACKAGE.md and docs/assembly/ASSEMBLY_CHECKLIST_3_BOARDS.md §3 and §7.

Other audit findings, none of them blocking:

  • The SRB1/SRB2 net labels are swapped relative to the chip pins.
  • BIASREF (pin 60) is unconnected; the firmware sets BIASREF_INT = 1.

8. Firmware status

TargetSketchStatus
ESP32 DevKit V1 (ESP32-WROOM-32), primaryfirmware/esp32/hackeeg_esp32_bringup/arduino-cli, core esp32:esp32 3.3.12, FQBN esp32:esp32:esp32: 0 errors, 0 warnings (2026-10-21). Not run on hardware.
STM32 Nucleo F446RE / F767ZI / L4R5ZI, fallbackfirmware/stm32/hackeeg_nucleo_bringup/Core STMicroelectronics:stm32 3.0.0: 0 errors, 0 warnings. Not run on hardware.
Host PCfirmware/host/ads1299_bringup_check.pyPASS/FAIL judge. Tested on synthetic data only.

Both sketches accept the same serial commands:

CommandAction
iRead the ID and dump the registers
tStream the internal test signal (gain 1)
sStream with shorted inputs, for noise (gain 24)
xStop streaming
rHardware reset

The wiring tables and the power checks to do before connecting anything are in docs/bringup/BRINGUP_PLAN_ESP32.md and, for the STM32, docs/bringup/BRINGUP_PLAN.md.

Bring-up pass gates:

  1. Rails at ±2.50 V ± 2 % and 3.3 V; VREFP ≈ 2.0 V above AGND.
  2. VCAP1 ≈ AVSS + 1.2 V.
  3. The ADS1299 ID reads 0x3E.
  4. Test signal ≈ 3.75 mV p-p at 0.98 Hz on all 8 channels.
  5. Shorted-input noise < 1 µVrms.

9. BOM and Türkiye sourcing

  • BOM and order lists:
  • Suppliers: e-Komponent for almost everything. e-Komponent is EKOM, DigiKey's authorized reseller in Türkiye. Özdisan supplies the TXS0102.
  • Cost: ≈ 33,500 TL for 3 boards + spares, of which ≈ 693 TL is estimated. Prices and stock are as of 2026-10-21; re-check them before ordering.
  • Quantities: 4 × ADS1299IPAGR (3 + 1 spare).
  • Fitting decisions:
    • OPA376 (IC7/IC8): DNP. The isolation was verified first.
    • C17/C25: exact MPN Taiyo Yuden LMK325ABJ107MM-T.
    • R6: 4.02 k preferred, 3.9 k as fallback.
    • D2: green LED.
    • JP16: deferred.

10. Manufacturing and assembly plan

  1. PCB at JLCPCB:
    • 5 pcs (the minimum order), 4 layers, 1.6 mm, stack-up JLC04161H-7628, no impedance control.
    • Upload manufacturing/approved/hackeeg-shield_JLCPCB_4L_1p6mm_REV_MFG_2026-10-07.zip unchanged.
    • Choose the finish, mask colour and silk colour at order time.
  2. Stencil: top side only, 200 × 150 mm frameless, ordered with the PCBs.
    • The approved ZIP deliberately leaves out the paste layers.
    • Give the stencil order the paste layer from manufacturing/release-outputs/hackeeg-shield_Paste_Top.gbr.
  3. Assembly in the lab:
    • Stencil, paste and reflow.
    • Inspect IC1 (0.5 mm pitch) and IC9 under a microscope.
    • Leave the OPA376 unfitted (DNP).
    • Clean the flux around the analog inputs.
    • Fit and check the RESV1 bodge.
  4. Unpowered checks: no rail shorted to AGND, and AVDD not shorted to AVSS.
  5. Bring-up per §8. Record the results for each board.

11. Verifying the files

bash
cd manufacturing/approved && sha256sum -c hackeeg-shield_JLCPCB_4L_1p6mm_REV_MFG_2026-10-07.zip.sha256
cd manufacturing/release-outputs && sha256sum -c SHA256SUMS.txt
sha256sum -c MANIFEST_SHA256.txt

MANIFEST_SHA256.txt covers every file under hardware/ and manufacturing/. .gitattributes turns off line-ending conversion for those two trees, so checked-out files match these checksums byte for byte on every OS. Docs and scripts elsewhere use normal Git line-ending handling.

12. Licence and attribution

EEG-I-LAB is open source:

MaterialLicence
Hardware design and manufacturing documentation (hardware/, manufacturing/, bom/)CERN Open Hardware Licence v1.2, as a modified version of the HackEEG Shield by Adam Feuer / Starcat LLC
Firmware and tools (firmware/, tools/)MIT
Original documentation (README.md, NOTICE.md, docs/, reports/)CC BY-SA 4.0

Full texts are in LICENSES/ and the overview is in LICENSE. Attribution and the dated list of modifications are in NOTICE.md.

The upstream documentation location is https://github.com/starcat-io/hackeeg-shield. Third-party datasheets are not redistributed here; see TI ADS1299.

Maintained by Batuhxn and EEG-I-LAB contributors.


Last updated: 2026-10-27 · Current milestone: procurement and PCB order for 3 bench prototypes.

Parts

151
QtyValueFootprintReferences
241uFSparkFun-Passives:0603-CAPC11, C13, C15, C18, C19, C21, C26, C29, C30, C32, C50, C51, C52, C54, C56, C58 +8
184.99kSparkFun-Passives:0603-RESR24, R25, R34, R35, R36, R37, R38, R39, R40, R41, R42, R43, R44, R45, R46, R47 +2
174.7nFSparkFun-Passives:0603-CAPC34, C35, C36, C37, C38, C39, C40, C41, C42, C43, C44, C45, C46, C47, C48, C49 +1
140.1uFSparkFun-Passives:0603-CAPC8, C10, C12, C14, C20, C23, C33, C53, C55, C57, C59, C63, C71, C73
6, , , , ,
610kSparkFun-Passives:0603-RESR2, R3, R4, R19, R20, R21
610uFSparkFun-Passives:0603-CAPC3, C6, C22, C24, C27, C64
43.3 uHSparkFun-Passives:0805L1, L2, L3, L4
3adafruit:FIDUCIAL_1MMU$2, U$5, U$6
310 uFSparkFun-Passives:0603-CAPC2, C5, C16
32.2uFSparkFun-Passives:0603-CAPC1, C4, C28
2SparkFun-Aesthetics:OSHW-LOGO-LU$1, U$4
20.01uFSparkFun-Passives:0603-CAPC31, C66
2100uFSparkFun-Passives:1210C17, C25
2270SparkFun-Passives:0603-RESR1, R18
22MSparkFun-Passives:0603-RESR22, R23
2OPA376DBVOPA376:SOT23-5IC7, IC8
2TXB0108PWRadafruit:TSSOP20IC10, IC11
1endless-knot:ENDLESSKNOT-MEDIUMU$7
1adafruit:VFSOP-8IC9
1-2.5V-GNDheaders:1X03JP5
124AA256UIDmicrochip:SO-08IC5
13.98KSparkFun-Passives:0603-RESR6
15V-2.5Vheaders:1X03JP4
1ADCHSmartPrj:1X08JP24
1ADCLSmartPrj:1X08JP25
1ADS1299IPAGADS129x:TQFP64IC1
1AGND_TEST_POINTadafruit:1X01TP3
1AVDD_TEST_POINTadafruit:1X01TP1
1AVSS_TEST_POINTadafruit:1X01TP2
1BIASOUT_BIASIN_BIAS_ELECheaders:1X03JP9
1BLUESparkFun-LED:LED-1206D2
1BOARD_ADDRESSheaders:2X04JP3
1COMMUNICATIONSmartPrj:1X08JP22
1CONFIG0headers:2X10JP2
1CONFIG1headers:2X12JP1
1ElectrodesOS302-R241:OST_302-R241JP16
1External SyncSparkFun-Connectors:JST-4-PTHJP15
1POWERSmartPrj:1X08JP26
1PWMHSmartPrj:1X10JP20
1PWMLSmartPrj:1X08JP21
1REDSparkFun-LED:LED-1206D1
1SPISmartPrj:2X03SPI
1SRB1-BIASadafruit:1X03JP6
1SRB1-REF_ELECadafruit:1X03JP8
1SRB2-REF_ELECadafruit:1X03JP7
1TPS60403DBVTTPS604xx:SOT23-5IC6
1TPS72325DBVTTPS723xx:SOT23-5IC2
1TPS73225DBVTTPS32xx:SOT23-5IC3
1VREFP_TEST_POINTadafruit:1X01TP4
1XIOSmartPrj:2X18JP23

Similar boards

  • 6 layers60 × 55 mmPoE Ethernet GPIB Adapter, the printed circuit board in 3D

    PoE Ethernet GPIB Adapter

    Kofen/PoE_Ethernet_GPIB_Adapter

    This folder contains the necessary hardware files for the PoE Ethernet GPIB Adapter project.

    198 parts120GPL-3.0
  • 4 layersVolksEEG, the printed circuit board in 3D

    VolksEEG

    VolksEEG/VolksEEG

    Open Source EEG project

    148 parts77GPL-3.0
  • 4 layers35.6 × 77.5 mmCombined PCB, the printed circuit board in 3D

    Combined PCB

    Keith-Khadar/Gh05t

    This project aims to design and develop a wearable EEG headset with an integrated data acquisition system. Using OpenBCI Ultracortex Mark IV as a template, the headset is designed to map the electrodes according to the…

    43 parts9
  • 4 layers64 × 64 mmConvey, the printed circuit board in 3D

    Convey

    kennito2035/convey

    CONVEY: open 8-channel patient-isolated EEG/sEMG/ECG acquisition board (ADS1299, KiCad 10)

    146 parts4CERN-OHL-S-2.0
  • 4 layers71.8 × 40.5 mmBioamplifier, the printed circuit board in 3D

    Bioamplifier

    RauLLorenzon/DIY_EEG

    8 Channel EEG board, based on the ADS1299

    95 parts4
  • 2 layers39.9 × 50.5 mmEeg, the printed circuit board in 3D

    Eeg

    gianisalive/lucid_candy

    eeg

    77 parts2
  • 4 layers88 × 80 mmNeuronic, the printed circuit board in 3D

    Neuronic

    kamenzh/neuronics-eeg

    A budget-focused EEG brain–computer interface project exploring a custom 8-channel acquisition PCB, ESP32 wireless streaming, and PC-based signal processing and CNN classification for brain-controlled interfaces.

    95 parts2MIT
  • 2 layers74.5 × 49 mmEEG, the printed circuit board in 3D

    EEG

    wangq22/ADS1299-BioAmp

    ADS1299 BioAmp is an 8-channel biopotential acquisition board designed for research and development of EEG, EMG, ECG, and other low-amplitude bioelectrical signals.

    76 parts2

Questions

How big is the Hackeeg shield PCB?

It measures 101.6 × 53.3 mm and has 4 copper layers, 1.61 mm thick.

What parts does the Hackeeg shield use?

151 parts, built around the 24AA256UID-I/P and ADS1299IPAG. 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 Hackeeg shield KiCad files?

From the Tahacrpc/EEG-I-LAB repository on GitHub, at the commit this page was made from: the board is hardware/kicad-cp01/04_repair_candidate/hackeeg-shield.kicad_pcb and its schematic hardware/kicad-cp01/04_repair_candidate/hackeeg-shield.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Hackeeg shield design in my own project?

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