8000 GitHub - atx/fenykl: Mod loader for older-ish Olympus Micro Four-Thirds cameras (E-PL3 and E-M10 ii) · GitHub
[go: up one dir, main page]

Skip to content
atxPublic

About

Mod loader for older-ish Olympus Micro Four-Thirds cameras (E-PL3 and E-M10 ii)

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

28 Commits

Folders and files

Repository files navigation

fenykl

Prometheus stole fire from the Olympians in a fennel stalk.

Warning

Most of the code and research in this repository was produced by a liberal application of frontier LLMs. But don't worry, I was wearing my hacking bath robe I wore for many CTFs back in my day.

You have been warned.

fenykl is a project providing a firmware mod infrastructure for the E-M10 Mark II and E-PL3. It consists of a small firmware patch that provides a mod loader to load a second stage binary from the SD card and a custom plugin infrastructure allowing plugins written in C to hook the firmware functions and alter the camera functionality.

Warning

This is an early stage experimental project. I do not believe it is ready for care-free users.

Features

Pre-capture A half-press in silent sequential H mode triggers a continuous burst that keeps the latest 6 frames in memory. Fully pressing the shutter button dumps these frames onto the SD card. Needs flash off, long-exposure NR off and S-AF or MF.
Focus distance and Depth of field readout The numbers that end up in EXIF get reported in the HUD too.
Focus meter A contrast bar under the battery readout, showing how much does the AF module think it is focused.
Battery % Shows a guesstimated battery precentage instead of the original stock battery icon
R/B swap Swaps the red and blue channels (useful for IR photography)
Screenshot (can be mapped to Fn in the Fenykl config menu) Saves a PPM screenshot of the live view

Basic info screen with the main plugin

Supported cameras

The E-M10 Mark II is the primary target now. Limited support for the E-PL3 is still available but I have decided to shift my focus.

How to install on the E-M10 Mark II

Caution

This can potentially brick your camera. Make sure you do not care about it enough to not be sad if it gets fucked by installing random software from the internets.

You need Linux with uv (Python 3.12+), and an E-M10 Mark II with body firmware 1.4 (Setup menu > Firmware).

Get the stock firmware OLY_E_120_1400_0000_0000.BIN somewhere. You can find the binaries floating on the internet in dumps from questionable sources, or they might be somehow extractable from the Olympus updater software. Put it into firmware/ in this repository.

Validate it is the correct one:

sha256sum firmware/OLY_E_120_1400_0000_0000.BIN
# ff9d302318ecf6e06c0b31c181fc6a185e93623e819749db31cec7977fa92052

Build the mn10300-elf cross toolchain (GCC 16.2, binutils 2.47) once. It downloads the sources (arguments: download directory, build directory), needs a host C/C++ compiler and make, about 3.5 GB in the build directory and about 15 minutes:

toolchain/build.sh /tmp/fenykl-dl /tmp/fenykl-build

This then installs the toolchain into toolchain/install/ in the repo. in/README.md)).

Patch the firmware:

uv sync
uv run fenykl patch apply em10ii/fenykl-loader --output E1209999.BIN
# wrote E1209999.BIN (69599232 bytes, sha256 6eb1bb10ea34bf58142e6f6554d76d75ca9915fe151a8d83a205b5d4e2a9f371)

Flash it from the SD card:

  1. Charge the battery fully. Take off the lens.
  2. Format a plain SD/SDHC card in the camera.
  3. Create the folder DCOLYMP in the card root and copy E1209999.BIN into it. The name must be exactly DCOLYMP/E1209999.BIN, upper case, and it must be the only E120*.BIN there.
  4. Camera off, card in. Hold OK and switch the camera on. Keep holding OK until the orange lamp on the front lights up, then let go. The screen stays black.
  5. Wait a few minutes until the lamp blinks rapidly. Do not switch off or open the battery or card door while the lamp is lit. An interrupted flash is the main way to brick the camera.
  6. Switch off, delete DCOLYMP from the card (otherwise every power-on with OK held reinstalls it), switch on.

The camera now behaves like stock. Setup menu > Firmware still shows body 1.6.

If the camera just boots into live view in step 4, the update did not start. Try once more, holding OK firmly before switching on.

Caution

Never run a USB firmware update from a PC with FENYKL.BIN on the card.

Building and installing the main plugin

uv run fenykl plugin build sdk/projects/main
uv run fenykl payload info sdk/projects/main/build/em10ii/FENYKL.BIN   # must end with "loader accepts"

Copy sdk/projects/main/build/em10ii/FENYKL.BIN into the root of the SD card.

The plugin stores its settings in FENYKL.CF0/FENYKL.CF1 and writes a log to FENYKL.LOG in the card root. Delete the .CF* files to reset the settings.

If anything goes wrong, switch off (take the battery out if the camera hangs), delete FENYKL.BIN from the card on a PC, and the camera boots like stock again.

Settings page

To configure fenykl and verify that it got loaded, go into MENU > Custom menu, tab K > row Fenykl, then OK on it to get into the custom config screen.

Basic info screen with the main plugin

A changed setting takes effect at once and is saved two seconds later.

Note that this overwrote the Eye-fi configuration option, meaning Eye-fi can no longer be configured with this mod.

About

Mod loader for older-ish Olympus Micro Four-Thirds cameras (E-PL3 and E-M10 ii)

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0