
Haxophone001
cardonabits/haxo-hw
Haxophone, an electronic musical instrument that resembles a saxophone

A Breakout and visualization board for monitoring PiStorm outputs.
PistormTester is an open-source printed circuit board by abrugsch, from the abrugsch/PistormTester repository on GitHub. It is a 2-layer board of 99.8 × 99.8 mm with 92 parts on 127 nets, routed with 1,086 tracks and 137 vias.
Its parts include 60 diodes, 9 connectors, 4 capacitors, 2 ICs and 1 resistor.

If you've gone through the instructions below and watched the video and you need more help decoding what the board is telling you (some things are not so obvious if you're not ultra familiar with the PiStorm schematic) then feel free to hit me up. the best way is usually through Discord via the PiStorm server and I'm @ABrugsch on there too.
If you build these, consider Buying me a coffee
I have spent a considerable amount of time refining the board and the tests that go with them, and will often help people understand what their ZZ9 is telling them. A little coffee goes a long way to helping me keep my sanity 🙂
PiStorm Tester is a PCB that exposes all the IO's of the 68000 DIP64 socket that PiStorm uses. There are status LED's on all the control/Address/Data Bus lines to easily see if a single line is stuck high or low. Each IO is also broken out to a header for easy connection to an external microcontroller such as an arduino for more accurate analysis of the outputs, or for pulling inputs high or low as required. where the line is either an input or bi-directional (such as the Data bus) the headers have a handy VCC and GND rail adjacent for easy jumpering. Combined with testing programs on the pi such as buptest, it becomes easy to narrow down individual faults such as unsoldered or broken individual flip-flops.
You can build them by hand. submit the gerbers (Rev C gerbers have adjustments made for ZIF sockets with bigger pins. If you definitely don't want to use a ZIF, a Rev-B board might fit better but RevC should be universal) to a PCB fab of your choice (AllPCB has a free promotion ATM) but then you have to place and solder 60 0603 LED's and 15 4x0402 resistor arrays by hand. That's pretty tedious so I've also included the JLCPCB production files to get them assembled. All the JLC parts are basic parts so it costs barely more to get them assembled than to just order the bare boards. (10x costs around $50 including UK delivery by courier)
The big caveat is that they(JLCPCB assembly) don't have a 5v 7-ish MHz oscillator in their assembly catalog so that part has an LCSC part number (C387338) but must be sourced and placed separately. As of RevC.1 there is now a 3.3v oscillator and regulator so that all parts can be assembled by JLC with the included BOM. There are even alternative 3.3v Oscillators if the one in the BOM is out of stock. If you use a RevC or older gerber set, then the BOM and position files will be incorrect so please roll them back to earlier versions.
IMPORTANT There is now a jumper 0 Ohm resistor in the BOM and position file. If you use the 3.3v regulator and oscillator you MUST exclude R1 from the build. If you use a 5v Oscillator you MUST exclude U1, C3 and C4 from the build and keep R1.
If you do a JLC run of 10 boards, they should come in at around $30 (plus taxes and delivery - Total cost to the UK using an SMD voucher and their cheapest (about 2 weeks) delivery was $37 last time I did a batch, £35 for all red LEDs.)
The biggest costs in producing these boards are the LED's and the oscillator. If you don't care about colo(u)r of LEDs the cheapest option is to use all red ones as they are significantly cheaper than any other colo(u)r so there is an alternative BOM file with all the LED's using the cheaper RED part. (Although now that the BOM LCSC part numbers have been tweaked to put more expensive ones on places where the lowest quantity are, the difference isn't so great: about $2 between All-Red and different colours.)
The code folder of this repo has some simple tests for checking that the address and data busses are behaving correctly. Here are the instructions for using them on PiStorm. For more advanced tests, see the note at the bottom of this readme.
If you have a recent pull of the main PiStorm repo then you do not need to copy any files as the test files are now included in the PiStorm root folder, though you will still need to follow the build instructions below, but the code files are probably already in your PiStorm folder.
If not, then copy the files in the code folder of this repo to your pistorm folder on your pi. (put the files in directly, not in a subfolder.)
Run
./build_zz9tests.sh
to build the test program just like buptest.
Then run
sudo ./zz9fulltest
Any discrepancies at this point can be referenced to the schematic to find the appropriate pin that might need attention.
For a more thorough test of the data reads there is also zz9readloop which will loop for 2 minutes reading the data bus and displaying the results on screen in Hex and Binary.
simply run
sudo ./zz9readloop
and then modify data bits using the tweak headers and see what comes on the screen. A-variant flip-flops (LVC16373A or LVC16374A) will hold the data after you set it, allowing you to set multiple bits at a time while only using one wire/resistor to do it.
The program will read at half second intervals for 2 minutes.
ctrl-c will terminate early
There is now a video demonstrating the use of the ZZ9 board:

READ16: read data: 0x0008(hex) 0000000000001000 (binary)| bank | chip | pin |
|---|---|---|
| A1-7 | U2 | 1 |
| A8-15 | U2 | 24 |
| A16-23 | U6 | 1 |
| D0-7 | U5 | 1 |
| D8-15 | U5 | 24 |
If you need to address any of these issues, here's where to start:
Data read is handled by U3 on the PiStorm
Data write is handled by U5
Address bus (write only) A1-A15 is handled by U2
Address bus A16-A23 is handled by U6
Reference the Pistorm schematic for further details of specific pins to target
Currently the included tests only cover the address and data busses. There are 18 other signal lines that are handled by this tester and at the moment nothing has been written to assess these other lines.
When viewing the board, in normal operation the following should be lit (dimly as they are being strobed)
This only covers the output of the 384 data buffers, and therefore there could also be hidden disconnections between the 384's and the CPLD.
Example: a disconnected pin on the 384 on the CPLD side of the RST line meant the CPLD I/O was floating. The test board appeared correct (light off) but in use the emulator wouldn't start because RST was toggling on and off due to floating. Re-flowing the suspect 384 resolved the problem.
Testing of the supporting signals will probably have to be done with a logic analyzer or a complementing microcontroller dev board such as an arduino (one that's 5v tolerant) to read the pins and log what states they take. This board was originally intended to have a socket for a mini/micro arduino but for the sake of flexibility was left off.
As Advanced tests are created by myself or the PiStorm community, they will be documented here. (please submit issues or pull requests for any suitable tests you need or have come up with)
| Qty | Value | Footprint | References |
|---|---|---|---|
| 15 | R_Pack04 | Resistor_SMD:R_Array_Concave_4x0402 | RN1, RN2, RN3, RN4, RN5, RN6, RN7, RN8, RN9, RN10, RN11, RN12, RN13, RN14, RN15 |
| 3 | Conn_01x16_Female | Connector_PinSocket_2.54mm:PinSocket_1x16_P2.54mm_Vertical | J4, J5, J6 |
| 2 | 1uF | Capacitor_SMD:C_0402_1005Metric | C3, C4 |
| 1 | 0 R | Resistor_SMD:R_0402_1005Metric | R1 |
| 1 | 0.1uF | Capacitor_SMD:C_0402_1005Metric | C1 |
| 1 | 15pF | Capacitor_SMD:C_0402_1005Metric | C2 |
| 1 | 68000D | ZZ9 parts:DIP-64_W22.86mm_Socket_LongPads-big_holes | U2 |
| 1 | 8MHz | Oscillator:Oscillator_SMD_EuroQuartz_XO32-4Pin_3.2x2.5mm | X1 |
| 1 | AP2127N-1.0 | Package_TO_SOT_SMD:SOT-23 | U1 |
| 1 | Conn_01x02 | Connector_PinSocket_2.54mm:PinSocket_1x02_P2.54mm_Vertical | J9 |
| 1 | Conn_01x06_Female | Connector_PinSocket_2.54mm:PinSocket_1x06_P2.54mm_Vertical | J3 |
| 1 | Conn_01x13 | Connector_PinSocket_2.54mm:PinSocket_1x13_P2.54mm_Vertical | J8 |
| 1 | Conn_02x12_Odd_Even | Connector_PinSocket_2.54mm:PinSocket_2x12_P2.54mm_Vertical | J2 |
| 1 | Conn_02x13_Odd_Even | Connector_PinSocket_2.54mm:PinSocket_2x13_P2.54mm_Vertical | J7 |
| 1 | LED_A1 | LED_SMD:LED_0603_1608Metric | D1 |
| 1 | LED_A10 | LED_SMD:LED_0603_1608Metric | D10 |
| 1 | LED_A11 | LED_SMD:LED_0603_1608Metric | D11 |
| 1 | LED_A12 | LED_SMD:LED_0603_1608Metric | D12 |
| 1 | LED_A13 | LED_SMD:LED_0603_1608Metric | D13 |
| 1 | LED_A14 | LED_SMD:LED_0603_1608Metric | D14 |
| 1 | LED_A15 | LED_SMD:LED_0603_1608Metric | D15 |
| 1 | LED_A16 | LED_SMD:LED_0603_1608Metric | D16 |
| 1 | LED_A17 | LED_SMD:LED_0603_1608Metric | D17 |
| 1 | LED_A18 | LED_SMD:LED_0603_1608Metric | D18 |
| 1 | LED_A19 | LED_SMD:LED_0603_1608Metric | D19 |
| 1 | LED_A2 | LED_SMD:LED_0603_1608Metric | D2 |
| 1 | LED_A20 | LED_SMD:LED_0603_1608Metric | D20 |
| 1 | LED_A21 | LED_SMD:LED_0603_1608Metric | D21 |
| 1 | LED_A22 | LED_SMD:LED_0603_1608Metric | D22 |
| 1 | LED_A23 | LED_SMD:LED_0603_1608Metric | D23 |
| 1 | LED_A3 | LED_SMD:LED_0603_1608Metric | D3 |
| 1 | LED_A4 | LED_SMD:LED_0603_1608Metric | D4 |
| 1 | LED_A5 | LED_SMD:LED_0603_1608Metric | D5 |
| 1 | LED_A6 | LED_SMD:LED_0603_1608Metric | D6 |
| 1 | LED_A7 | LED_SMD:LED_0603_1608Metric | D7 |
| 1 | LED_A8 | LED_SMD:LED_0603_1608Metric | D8 |
| 1 | LED_A9 | LED_SMD:LED_0603_1608Metric | D9 |
| 1 | LED_AS | LED_SMD:LED_0603_1608Metric | D24 |
| 1 | LED_BERR | LED_SMD:LED_0603_1608Metric | D58 |
| 1 | LED_BG | LED_SMD:LED_0603_1608Metric | D42 |
| 1 | LED_BGACK | LED_SMD:LED_0603_1608Metric | D55 |
| 1 | LED_BR | LED_SMD:LED_0603_1608Metric | D56 |
| 1 | LED_D0 | LED_SMD:LED_0603_1608Metric | D25 |
| 1 | LED_D1 | LED_SMD:LED_0603_1608Metric | D26 |
| 1 | LED_D10 | LED_SMD:LED_0603_1608Metric | D35 |
| 1 | LED_D11 | LED_SMD:LED_0603_1608Metric | D36 |
| 1 | LED_D12 | LED_SMD:LED_0603_1608Metric | D37 |
| 1 | LED_D13 | LED_SMD:LED_0603_1608Metric | D38 |
| 1 | LED_D14 | LED_SMD:LED_0603_1608Metric | D39 |
| 1 | LED_D15 | LED_SMD:LED_0603_1608Metric | D40 |
| 1 | LED_D2 | LED_SMD:LED_0603_1608Metric | D27 |
| 1 | LED_D3 | LED_SMD:LED_0603_1608Metric | D28 |
| 1 | LED_D4 | LED_SMD:LED_0603_1608Metric | D29 |
| 1 | LED_D5 | LED_SMD:LED_0603_1608Metric | D30 |
| 1 | LED_D6 | LED_SMD:LED_0603_1608Metric | D31 |
| 1 | LED_D7 | LED_SMD:LED_0603_1608Metric | D32 |
| 1 | LED_D8 | LED_SMD:LED_0603_1608Metric | D33 |
| 1 | LED_D9 | LED_SMD:LED_0603_1608Metric | D34 |
| 1 | LED_E | LED_SMD:LED_0603_1608Metric | D44 |
| 1 | LED_FC0 | LED_SMD:LED_0603_1608Metric | D45 |
| 1 | LED_FC1 | LED_SMD:LED_0603_1608Metric | D46 |
| 1 | LED_FC2 | LED_SMD:LED_0603_1608Metric | D47 |
| 1 | LED_HALT | LED_SMD:LED_0603_1608Metric | D51 |
| 1 | LED_IPL0 | LED_SMD:LED_0603_1608Metric | D53 |
| 1 | LED_IPL1 | LED_SMD:LED_0603_1608Metric | D41 |
| 1 | LED_IPL2 | LED_SMD:LED_0603_1608Metric | D54 |
| 1 | LED_LDS | LED_SMD:LED_0603_1608Metric | D49 |
| 1 | LED_RST | LED_SMD:LED_0603_1608Metric | D52 |
| 1 | LED_RW | LED_SMD:LED_0603_1608Metric | D50 |
| 1 | LED_SPARE1 | LED_SMD:LED_0603_1608Metric | D59 |
| 1 | LED_SPARE2 | LED_SMD:LED_0603_1608Metric | D60 |
| 1 | LED_UDS | LED_SMD:LED_0603_1608Metric | D48 |
| 1 | LED_VMA | LED_SMD:LED_0603_1608Metric | D43 |
| 1 | LED_VPA | LED_SMD:LED_0603_1608Metric | D57 |
| 1 | USB_B_Micro | My_parts:micro_usb_U-F-M5SS-W-1 | J1 |

cardonabits/haxo-hw
Haxophone, an electronic musical instrument that resembles a saxophone

Allen-Synthesis/EuroPi
EuroPi: A reprogrammable Eurorack module based on the Raspberry Pi Pico

mmccoyd/hillside
Family of split ergonomic keyboards with three rows of six or five keys and a generous thumb arc

ChrisChrisLoLo/keezyboost40
4x10 ortholinear with an LCD in the middle. Uses the Raspberry Pi Pico, as well as Rust firmware

nodestark/mdb-esp32-cashless
ESP32-based MDB cashless device for vending machines, supporting EVA DTS DEX/DDCMP telemetry and payments over the MDB protocol via Bluetooth and MQTT



cnlohr/cnhardware
My dumping grounds for all my kicad projects and random hardware bringup.
It measures 99.8 × 99.8 mm and has 2 copper layers, 1.6 mm thick.
92 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.
From the abrugsch/PistormTester repository on GitHub, at the commit this page was made from: the board is PistormTester.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask abrugsch before reusing the design.