Homehw​.s‑ol.nu

low-profile hexagon keyboards.

troubleshooting

TRS MIDI issues

  • Is the MIDI output channel correctly set?

    You can find the MIDI channel setting on the MIDI page. There is both a TRS MIDI channel and a USB MIDI channel setting, so watch out for the right one.

  • Are you using the right adapter cable?

    The 0x33.board usually ships with a Type-A TRS MIDI jack, but this can be changed by cutting and soldering jumpers on the board. A Type-B TRS MIDI cable won’t work.

  • Are you using the right port?

    The MIDI port is the leftmost port when viewing the 0x33.board from the top.

  • Is everything else working?

    When pressing keys, they should light up and the corresponding notes should appear on the screen. If this is not the case, look in another section.

USB MIDI issues

  • Does the 0x33.board show up on your computer?

    You can use lsusb (Linux), the “Device Manager” (Windows) or “Audio MIDI Setup” (Mac OS) to verify that it connects properly.

    • If it doesn’t, is your USB-C cable working?

      Test your cable with a different device or try another cable. Note that a cable could allow the 0x33.board to turn on, yet have damaged signal lines that don’t allow it to communicate with your computer.

  • Is the MIDI output channel correctly set?

    You can find the MIDI channel setting on the MIDI page. There is both a TRS MIDI channel and a USB MIDI channel setting, so watch out for the right one.

no response when plugging in

  • Does the 0x33.board show up on your computer?

    You can use lsusb (Linux), the “Device Manager” (Windows) or “Audio MIDI Setup” (Mac OS) to verify that the USB connection is successful.

    • If it doesn’t, is your USB-C cable working?

      Test your cable with a different device or try another cable. Note that a cable could allow the 0x33.board to turn on, yet have damaged signal lines that don’t allow it to communicate with your computer.

  • Are there messages in the Serial Console?

    Try following the Adafruit guide for connecting to the CircuitPython Serial Console for your operating system and see if there are any error messages. After connecting, reset the board using the RESET button in the small hole on the bottom of the 0x33.board.

  • Try updating or reinstalling CircuitPython:

    1. Download the latest CircuitPython build (.uf2 file) [for the Solderparty RP2040 Stamp][cpy]
    2. Connect the 0x33.board to a computer
    3. Reset the board into bootloader mode by double-pressing the RESET button in the small hole on the bottom of the 0x33.board. A new removable drive with the UF2 bootloader should appear.
    4. Copy the .uf2 file to the removable drive. The drive should disappear and reappear with a different name.
    5. Reinstall the hex33board firmware.