https://github.com/bytespider/meross

Investigating the Meross / Refoss MSS310 Smart Plug and getting these devices to communicate with our private MQTT brokers
https://github.com/bytespider/meross

hardware-hacking home-assistant homeassistant meross mqtt-smarthome refoss smarthome

Last synced: 26 days ago
JSON representation

Investigating the Meross / Refoss MSS310 Smart Plug and getting these devices to communicate with our private MQTT brokers

• Host: GitHub
• URL: https://github.com/bytespider/meross
• Owner: bytespider
• Created: 2019-02-02T17:53:07.000Z (about 6 years ago)
• Default Branch: develop
• Last Pushed: 2025-01-25T14:39:11.000Z (3 months ago)
• Last Synced: 2025-04-04T11:08:52.231Z (26 days ago)
• Topics: hardware-hacking, home-assistant, homeassistant, meross, mqtt-smarthome, refoss, smarthome
• Language: JavaScript
• Homepage:
• Size: 8.66 MB
• Stars: 120
• Watchers: 11
• Forks: 20
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Meross utilities

[![Node.js Package](https://github.com/bytespider/Meross/actions/workflows/npm-ghr-publish.yml/badge.svg)](https://github.com/bytespider/Meross/actions/workflows/npm-ghr-publish.yml)

Tools to help configure the Meross devices for purpose of utilising our own MQTT servers.

Before you can use the tool to setup your device you need to put it into paring mode and connect to it's Access Point. It's IP address is known as the `--gateway` parameter and is typically `10.10.10.1`.

Requires `node` >=18  

For Node.js >=21 you need to prepend commands with `NODE_OPTIONS='--insecure-http-parser'`. This is because the responses from some (if not all) versions of the Meross firmware incorrectly terminate headers with LF instead of CRLF. [CVE-2022-32214](https://nvd.nist.gov/vuln/detail/CVE-2022-32214)

## Home Assistant

It's possible to get these devices to work with Home Assistant (HASSIO).

Setup Home Assistant MQTT

Once paired and linked to your broker, you can use the Meross Lan integration to control the devices.

## Tools

### Info

`npx meross info [--include-wifi]`

Gets information from the device you are connected to in setup mode and optionally the WIFI SSID's it can see.

### Setup

`npx meross setup [options]`

Setup device you are connected to in setup mode