https://github.com/jamezrin/mosmqtt_wakeonlan
Mongoose OS app designed to run on esp8266 to help you wake your PCs remotely in a secure manner.
https://github.com/jamezrin/mosmqtt_wakeonlan
esp8266 esp8266mqtt espressif iot iot-application iot-platform losant mongoose-os mongoose-os-app wake-on-lan wakeonlan wol
Last synced: 4 months ago
JSON representation
Mongoose OS app designed to run on esp8266 to help you wake your PCs remotely in a secure manner.
- Host: GitHub
- URL: https://github.com/jamezrin/mosmqtt_wakeonlan
- Owner: jamezrin
- License: mit
- Created: 2018-03-08T12:35:42.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T15:00:14.000Z (over 1 year ago)
- Last Synced: 2025-04-24T04:09:56.277Z (7 months ago)
- Topics: esp8266, esp8266mqtt, espressif, iot, iot-application, iot-platform, losant, mongoose-os, mongoose-os-app, wake-on-lan, wakeonlan, wol
- Language: C
- Homepage:
- Size: 32.2 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mosmqtt_wakeonlan
This app for esp8266 sends wake on lan packets remotely, through MQTT.
The esp8266 is an IoT device that's both reliable and inexpensive.
It might work on other devices that share the SDK, but that has
not been yet tested.
You can find an esp8266 for around 4\$ in AliExpress or a bit more in Amazon.
## Requirements
To flash this app you'll need:
- The actual esp8266 chip itself (and a micro USB cable)
- A Linux (or Mac) environment so you can run the `reflash.sh` script
- [Mongoose OS tool (mos-tool)](https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md) You will build this code with this tool
- [Mongoose OS Dash Account](https://mdash.net/) This is not actually needed, but it's good to have
- [Losant Account](https://losant.com) You can use other brokers but Losant works great
- Docker if you want to build locally, otherwise remove `--local` from `reflash.sh`
## Building and Flashing
1. Clone this repo
```bash
git clone --recursive https://github.com/jamezrin/mosmqtt_wakeonlan
```
2. Copy `.env.sample` to `.env` and edit it accordingly
- The `WIFI_SSID` and `WIFI_PSK` variables are your WiFi SSID and password respectively
- The `MQTT_CLIENT_ID`, `MQTT_USER` and `MQTT_PASS` variables can be obtained from [losant.com](https://losant.com/)
- The `DASH_TOKEN` variable can be obtained from [mdash.net](https://mdash.net/)
3. Run the flash script. If everything is fine, your device should be detected automatically and you should end up with a flashed device.
```bash
./reflash.sh
```
## Development
If you plan to make changes, you will probably want IntelliSense, for that install the [official extension](https://marketplace.visualstudio.com/items?itemName=mongoose-os.mongoose-os-ide) from Cesanta.
It is also recommended running at least one time the flash script, or at least, `mos build --local`.
Make sure your C/C++ properties look similar to this
```json
{
"configurations": [
{
"name": "Linux",
"includePath": ["${workspaceFolder}/**"],
"defines": ["MG_ENABLE_CALLBACK_USERDATA"],
"compilerPath": "/usr/bin/gcc",
"cStandard": "c11",
"cppStandard": "c++17",
"intelliSenseMode": "clang-x64"
}
],
"version": 4
}
```
[Outdated Tutorial](https://jamezrin.wordpress.com/2018/03/09/wake-on-lan-remotely-and-securely-with-esp8266)