neon_samurai

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #go #rust #deep-learning #linux #docker #java #windows #pytorch #mcp #openai

(★ 25)

👺 Unleash the Midi Fighter Twister 🚀

neon_samurai Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <h1>NEON_SAMURAI</h1>

<i>An alternative firmware for the Midifighter Twister</i>

<h4 align="center">
    <a href="#introduction">Introduction</a> -
    <a href="#features">Features</a> -
    <a href="#before-you-flash">Before You Flash</a> -
    <a href="#building">Building</a> -
    <a href="#flashing">Flashing</a> -
    <a href="#wiki">Wiki</a> -
    <a href="#contributing">Contributing</a>
  </h4>

</div>

## Introduction

NEON_SAMURAI is an alternative firmware for the DJ Tech Tools Midi Fighter Twister. It focuses on extending the original functionality and aims to explore new features (see the features section for more info).

If you use this software you must accept the License, please be aware that using this firmware will likely invalidate your warranty with DJ Tech Tools.

## Features

KEY:

- ✅ Feature implemented.
- ⏲ Feature planned, not complete yet.
- Not planned.

| Feature                      |    Status   |
| ---------------------------- | :---------: |
| Configurable Channels        |     ✅      |
| Acceleration                 |     ✅      |
| Firmware Recovery (DJTT)     |     ✅      |
| 14-bit CC/NRPN               |     ✅      |
| Sysex-based Configuration    |     ✅      |
| LFOs                         |     ⏲       |
| Virtual Banks                |     ⏲       |
| HID - Mouse/Keyboard         |     ⏲       |
| Standalone Configuration     |     ⏲       |
| Improved Button/Switch Modes |     ⏲       |
| Hyper Knobs                  |     ✅      |
| Open Sound Control (OSC)     |     ⏲       |
| Traktor Sequencer            | Not planned |
| Midi 2.0                     | Not planned |

## Before You Flash

> **Warning:** Make sure your device has a working recovery path before
> flashing custom firmware. NEON_SAMURAI can enter the bootloader via the
> four-corner encoder gesture or the `bootloader` console command, but both
> depend on the ATxmega's boot section already containing a working DFU
> bootloader. If that section is blank neither path works and the device requires a PDI
> programmer (e.g. a JTAGICE3) to recover. See
> [wiki/BootloaderRecovery.md](wiki/BootloaderRecovery.md) if you hit this.

<i>Using this firmware will void your warranty, the software is provided "as is", without warranty of any kind. Please refer to the license.</i>

## Download

Currently there are no releases available - "watch" the project for notification of future releases.

## Building

```sh
cmake -G Ninja -B build/Release -S . --toolchain=cmake/toolchain.cmake -DCMAKE_BUILD_TYPE=Release
cmake --build build/Release
```

`Debug` and `RelWithDebInfo` build types are also supported - see
`.vscode/tasks.json` for the full set of configure/build/flash tasks.

## Flashing

```sh
scripts/flash.sh [Debug|Release|RelWithDebInfo]
```

Defaults to `RelWithDebInfo`. This only writes the application section -
see [wiki/BootloaderRecovery.md](wiki/BootloaderRecovery.md) for flashing
the bootloader itself, which is a separate, one-time operation per device.

### Configuring

Coming soon.

## Wiki

- [Wiki index](docs/index.md)
- [Features](wiki/Features.md)
- [Installation Guide](wiki/InstallationGuide.md)
- [User Manual](wiki/UserManual.md)
- [Technical](wiki/Technical.md)
- [Bootloader Recovery](wiki/BootloaderRecovery.md)

## Contributing

Contributions to make **neosam** even better are welcomed. If you'd like to get involved, you can:

- Report issues or suggest enhancements on our [Issue Tracker](https://github.com/nic-starke/neon_samurai/issues).
- Fork the project, make changes, and submit a pull request to have your improvements considered for inclusion.
- Join our [Discussions](https://github.com/nic-starke/neon_samurai/discussions) to share your ideas, ask questions, or connect with other users.

### Development Environment

#### Dependencies

- avr-gcc
- avr-libc
- python3
- meson
- cmake
- ninja
- avrdude (for programming flash)
- [bloom](https://bloom.oscillate.io) (for hardware debugging via JTAGICE3/PDI)
- dfu-programmer (for flashing over USB DFU once a bootloader is present - `dfu-util` does not work with Atmel's DFU variant)
- pre-commit (for githooks)

#### Setting up pre-commit

- install pre-commit
- run `pre-commit install-hooks` and then `pre-commit install` in the root of the project from a terminal.

#### Setting up the build system

- Select cpp configuration `midifighter`
- Run the user task `CMake Configure`
- Run the default build task.

#### udev Rules for AVR Programmers

`/etc/udev/rules.d/50-avr-isp.rules`

```bash
SUBSYSTEM!="usb", ACTION!="add", GOTO="avrisp_end"

#Atmel Corp. JTAG ICE mkII
ATTR{idVendor}=="03eb", ATTR{idProduct}=="2103", MODE="660", GROUP="dialout"
#Atmel Corp. AVRISP mkII
ATTR{idVendor}=="03eb", ATTR{idProduct}=="2104", MODE="660", GROUP="dialout"
#Atmel Corp. Dragon
ATTR{idVendor}=="03eb", ATTR{idProduct}=="2107", MODE="660", GROUP="dialout"
#Atmel Corp. ATMEL-ICE
ATTR{idVendor}=="03eb", ATTR{idProduct}=="2141", MODE="660", GROUP="dialout"
#Atmel Corp. JTAGICE3
ATTR{idVendor}=="03eb", ATTR{idProduct}=="2140", MODE="660", GROUP="dialout"
```

If you install [bloom](https://bloom.oscillate.io) via its AUR package, it
installs its own broader udev rule set (covering more debug probes, and the
Atmel DFU bootloader itself) - the rules above are only needed if you're
not using Bloom.

### Contributors

### Sponsors

## Analytics

![Alt](https://repobeats.axiom.co/api/embed/349b4dffd3819c8746b8d91e4de04beaabb05ebe.svg "Repobeats analytics image")

## License

SPDX-License-Identifier: MIT

neon_samurai

neon_samurai Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

neon_samurai

neon_samurai Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README