Skip to content

Latest commit

 

History

History
55 lines (33 loc) · 3.13 KB

File metadata and controls

55 lines (33 loc) · 3.13 KB

Martin Jerry MJ-ST01 Switch ESPHome Configuration

This is a modern, functional ESPHome configuration for the Martin Jerry MJ-ST01 in-wall 3-Way Smart switch. Link to Amazon page.

Download binaries at the latest release: GitHub Release

Motivations

There was no good YAML config for this device, as the one on ESPHome Devices similar to this is more like the MJ-ST02 with a Tuya MCU rather than this which is a direct relay/LED connection.

Key Features

  • The config is normalized for recent (2025+) ESPHome versions, including an easier setup process. A pre-built binary in AP mode is available, ready to be flashed with esptool and adopted easily by HomeAssistant (see below).

  • Aside from the naming it is functionally identical to the MJ-S01 config.

Installing

As of my purchase of 3 units from Amazon in March 2025, tuya-convert seems like the most reliable option; it worked perfectly on the first try, though future revisions might not work any longer.

  1. Install tuya-convert following their instructions.

  2. Download the mj-st01.bin file from the Releases section, or compile the configuration yourself.

  3. Put the mj-st01.bin binary into your tuya-convert/files/ directory.

  4. Power on the switch and put it in "fast blink" mode by holding down the power button for ~5 seconds.

  5. Run ./start_flash.sh and let it perform the initial jailbreak.

  6. When prompted "Ready to flash third party firmware!", select the mj-st01.bin file.

Once flashed, the switch will boot into AP mode, ready to be configured via another device to connect to your WiFi and be adopted by the ESPHome Builder in Home Assistant. It leverages a standard "pull the remote config" to permit configuring only the minimum required in the ESPHome Builder, while all functionality is managed by this repository.

Reporting Bugs or Feature Requests

If you find a bug, please report it by opening an issue.

This device is basic enough that I don't think there's many features to add, but if you come up with one, I'm happy to review it.

Entities

Controls entities
Main device information.

Controls entities
Controls entities.

Sensors entities
Sensors entities.

Diagnostic entities
Diagnostic entities, including reboot and factory reset if required.