Hypno Firmware

Directions for updating Hypno.

Firmware Images

Warning: Updating will wipe your presets. Save them to your USB Drive! (Recall your preset, plug in a USB Drive into Hypno and re-save your preset, it will save to USB automatically when a drive is found, check the presets directory on drive after)

Which Firmware Do I Need?

  • Hypno (Old Version Based on CM3+) download the PI3/CM3 image.

  • Hypno w/ Fullsize Pi - Download the PI3 or PI4/CM4 version based on Pi used.

PAL/NTSC Composite can be switched by the user, see Hypno Manual.

Thanks for your patience with downloading these images.

Feb 2024: Hypno 2.4 NTSC PI3/CM3 | Hypno 2.4 NTSC PI4/CM4 | Forum Thread

  • Graphics Engine Resolution scaling

  • Display mode selection for pi4 (pi3 just auto selects the first mode like before)

    • config.txt entry "hypno_preferred_width="

  • Reworked midi scanning

    • Multiple MIDI devices now useable at once

  • CC echoes for midi controller UI setting

    • simply echoes the set value to the map's CC back to the controller

  • New MIDI Map options

    • Notes 117 + are reserved for system functions for Mezzz integration

    • Shape toggles moved to single notes instead of all sharps

      • adds more preset slots

    • Button patching can be toggled via note mesages

    • Button modes selectable via CC

  • Raspberry Pi OS updated so modern runs of PI3 (2022 PCB marking) boot normally.

  • Switchable MIDI Channel in /boot/config.txt

  • Bugfix: fractal mod not saving/ disabled on shape change

  • Bugfix: Midi note echoes out crashing Engine on shape/fb switch due to lack of mutex

  • Bugfix: Hue offsets not being saved correctly

  • Any channel Mezzz hypno mode activation with midi note chirp from Mezzz (needs 1.2.1 Mezzz)

  • Known bugs not addressed in this version

    • Midi input pauses briefly on patch recall due to requiring a full midi state echo for connected controllers.

    • CV offset on startup bug: leaving gain patched with physical cable makes a weird offset to the parameter for that whole session (couldn't figure this one out yet)

    • Help Mode glitching out and showing weird black pixels instead of text.

Dec 2022: NTSC 2.3 PI3/CM3 | NTSC 2.3 PI4 | Forum Thread

  • hue remapping on preset pot 2 (gain), all the way to the right is hue mapping left is gain default

    • help text displays mapping

  • Reset y axis centering on y crop of video shapes

  • On Device fat32 drive formatting for usb stick

    • pop up dialog (Y/N G/R w/ text onscreen)

    • startup center button hold activated

    • default logo video placed on usb @ sleepy/sleepy_loop.mp4

    • (drive still needs to appear in the linux's /dev/ so some USBs may still not format correctly, mac os extended USBs still not format-able)

  • Bugfix: Incorrect midi backend flag.

  • Bugfix: fixed a crash where incorrect conditionals for filename and hidden file filtering caused invalid video input filename strings

  • Bugfix: bug where some files would get skipped by the folder navigation due to a typo in code

  • Bugfix: Video playback freezes when left shape is unpatched

May 2022: NTSC 2.2.3 PI3/CM3 | NTSC 2.2.3 PI4 | Forum Thread

  • Folder-based file navigation for usb loading

    • Help mode: displays file and folder names

  • Fixed bug where presets were not saving to USB

  • Y offset drift

    • Some shapes polarize while others have a Y offset in its place

  • Removed fractal axis and only have a modulation ctl (like scan)

    • Y mod doesn't do anything in polarization shapes, polar mod is independent of fractal mod now

  • Enabled cropping/luma-keying/aspect stretch for most shapes

    • X/Y cropping/alt shaping

      • Sin

        • Dual sin/tri modulator function

      • Tan

        • Dual tan/tan modulator function

      • Circle

        • Diameter and squash

      • Poly (formally square)

        • X/Y stretch

    • Lumakey

      • Sin

      • Tan

      • Circle

      • Poly (formally square)

        • Not actual lumakey but similar effect, controls edge smoothness

    • Aspect stretch

      • Poly (formally square) - num sides (aspect stretch already possible with crop X/Y controls)

    • New manual: Hypno Manual

Nov 2021: NTSC 2.2.2 | Forum Thread

  • USB Stick MP4/JPEG Loading

    • MP4 sample file: Cube

    • JPEG sample file: Triangle

    • Place files in root directory

    • Recommended Filesystem Format FAT32

      • Supported Filesystems: vfat ext2 ext3 ext4 ntfs-3g ntfs exfat hfsplus (may need further real-world testing)

    • Use 640x480 .MP4s (480p30) for best performance (Convert w/ Handbrake, Drop down to 480p30fast)

    • For image loading, Use square or common (640x480 recommended) resolutions.

  • Help Mode shows filenames when indexing through files

  • USB Preset Backup

    • USB source saved via filename

  • NDI now stops sending when it doesn’t sense it is in use.

  • NDI SDK updated to version 5

Jul 2021: NTSC 2.1.7 | PAL 2.1.7

  • MIDI CCs offset by 1 (CC0 is now blank, should be helpful for Elektron machines)

    • Midi map update on the manual

  • Timed 90deg snapping (after 3 secs in deadzone) on all shapes

  • New “Help Mode” ( on/off by holding both of the side buttons and turning center/hue knob all the way up, you will see text to indicate it is on)

  • Trigger ins fixed (before they where failing after long term/many triggers)

  • X Crop now zooms when turned up to preserve scale of video (more zoom!)

  • Presets now recall internal modulation positions

Feb 2021: NTSC 2.1.5 | PAL 2.1.5

  • Video Input button combos reworked ( see new manual page )

    • inputs on channel A and B now have dedicated pages / controls

  • Frequencies are now catching controls just like Gain (LED is off when slider is not in its real position)

  • Firmware number boot splash screen

  • Bugfixing with CV

    • Preset recall should now work as expected with CV ( front panel controls are decoupled/un-caught when recalling)

    • Fixed some instances where catching controls would never catch

  • Infinite feedback and single shape frame rates improved with more intelligent draw call optimization

  • Input rotates the correct way

  • Lumakey works based on input frame luma before gain/recolor (more consistent)

  • Better defaults when input is plugged in (rotation/modulations reset, freq at 0)

How to Update Your Hypno (CM3/4 Onboard eMMC)

  1. Download the latest Hypno Image (See Above)

  2. Extract .gz archive (Optional but speeds up flashing significantly)

  3. Unscrew and remove Hypno from its enclosure, if yours does not have screws and is still not coming out it uses "tab-locks" this video shows you how to remove it.

  4. Flip the switch on the left side of Hypno into the up/ON/update position. (CM4 WS adapter has this switch on the blue pi adapter itself).

  5. Connect Hypno to computer via front usb port

  6. Start Balena Etcher

  7. Open downloaded .img in Etcher and follow the instructions (Hypno shows up as a “Compute Module” & may take a second to initialize)

    1. CM4 based Hypno: Some systems require running Rpiboot before module is recognized

  8. Once flashing is complete, disconnect Hypno, put update switch into the down position and power Hypno.

How to Update Your Hypno (Pi3/4 via SD Card)

  1. Download the latest Hypno Image (Above)

  2. Extract .gz archive (Optional but speeds up flashing significantly)

  3. Unscrew and remove Hypno from its enclosure.

  4. Remove the Pi's SD card and put it into your computer via a card reader.

  5. Start Balena Etcher

  6. Open downloaded .img in Etcher and follow the instructions to flash the SD

  7. Once flashing is complete, disconnect SD card and put back into your Hypno.


Hypno is not booting and only the right LED is glowing a faint green:

This means your pi is not able to boot the image on your storage device.

  • Hypno CM3+ (Original Ver):

    • Make sure the update switch is in the down position

    • Cycle power (Hypno will not boot while in update mode)

  • Hypno Kit: Re-flash firmware onto the SD

    • If this doesn't work try to use your raspberry pi with an image from Raspberry Pi Imager to verify your Pi is functional and booting correctly

    • Re-flash above firmware, making sure to leave enough space (~32GB) on your computer for the image to fully decompress and flash.

    • Try extracting the image before flashing (expand the .gz file)

    • Try booting your Hypno outside of its case before continuing assembly.

Missing Drivers” error in Etcher on Windows:

  • In some cases Windows users will need to install and run RPiboot for the Compute module to be recognized

Compute Module does not initialize in Balena, or is not recognized by my computer

  • Ensure that Hypno is isolated from all accessories

  • Compute module based Hypnos: Make sure the boot switch is on (or toward the word "update")

  • Connect Hypno directly to a computer using the provided USB cable with no hubs or adapters (provided cable has data lines, sometimes other cables are power only)

  • Try another microUSB cable (cables < 6’ are recommended)

  • try to install the rpiboot driver (see above for Windows Instructions, Mac users may need to build rpiboot from source as described here

Still having trouble? Check out the Troubleshooting Guide

Last updated