https://github.com/puuu/espilight
ESPiLight - pilight 433.92 MHz protocols library for Arduino
https://github.com/puuu/espilight
433mhz arduino esp8266 pilight rcswitch
Last synced: 2 months ago
JSON representation
ESPiLight - pilight 433.92 MHz protocols library for Arduino
- Host: GitHub
- URL: https://github.com/puuu/espilight
- Owner: puuu
- License: gpl-3.0
- Created: 2016-06-05T11:56:27.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2023-02-17T16:45:42.000Z (over 2 years ago)
- Last Synced: 2025-04-11T22:43:39.711Z (2 months ago)
- Topics: 433mhz, arduino, esp8266, pilight, rcswitch
- Language: C++
- Homepage:
- Size: 258 KB
- Stars: 118
- Watchers: 15
- Forks: 44
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://travis-ci.org/puuu/ESPiLight)
# ESPiLight
This Arduino library is a port of the [pilight](https://pilight.org/)
433.92MHz protocols to the Arduino platform. It was tested with a
ESP8266. The aim is to transmit, receive and parse many 433.92MHz
protocols, by providing a simple Arduino friendly API. This should
help to implement IoT bridges between the 434MHz-RF band and internet
protocols.
By porting the C modules of the pilight protocols, allows to
participate on the excellent work of the pilight community. Thus,
supporting many protocols for rc switches and weather stations without
reimplementing them.
A list of supported protocols can be found in the pilight manual:
https://manual.pilight.org/protocols/433.92/index.html
## Installation
This library can be easily installed with the Arduino Library Manager.
## Usage
Please have a look to the examples.
### Requirements
This library was tested and developed for the
[ESP8266](https://github.com/esp8266/Arduino). It may not run on a
ATmega-based boards, because of memory usage.
For transmitting and receiving you need 434MHz-RF modules. More
information can be found here:
- https://wiki.pilight.org/receivers
- https://wiki.pilight.org/senders
- https://github.com/sui77/rc-switch/wiki/List_TransmitterReceiverModules
## Contributing
If you find any bug, feel free to open an issue at github. Also, pull
requests are welcome. The development takes place in the `master`
branch. The `release` is used to integrate the pilight files and for
version tagging, like necessary for the Arduino Library Manager
crawler.
To prevent formating issues, please make sure that your code is proper
formatted. We use the `clang-format` tool with the `Google` style.
You can just format the code by calling
```console
$ clang-format -style=Google -i
```
### Install from source
If you are interested to install this library from source, you need to
integrate the pilight source files. Since Arduino build all cpp/c
files in the src directory and sub directories, only necessary files
from pilight will be integrated. This will be done with GNU make.
On Linux you can run:
```console
$ git clone https://github.com/puuu/ESPiLight/
$ cd ESPiLight
$ make
$ ln -s `pwd` ~/Arduino/libraries/
```
On MacOS you can run:
```console
$ git clone https://github.com/puuu/ESPiLight/
$ cd ESPiLight
$ make
$ ln -s `pwd` ~/Documents/Arduino/libraries/
```
#### Update
To update ESPiLight from git run:
```console
$ git pull
$ make update
```
#### New protocols
ESPiLight only supports the 434MHz protocols supported by
[pilight](https://pilight.org/). If you are missing any protocol,
please report it directly to pilight. After the intergratrion into
pilight it can be merged into ESPILight.
To report new protocols, please folow the
[rules](https://forum.pilight.org/showthread.php?tid=761) of the
[pilight forum](https://forum.pilight.org/). It is recommended to use
pilight directly. Alternativly, ESPiLight offers the
[`pilight_debug`](examples/pilight_debug/pilight_debug.ino) and
[`pilight_raw`](examples/pilight_raw/pilight_raw.ino) examples that
mimic tht pilight counterparts.
## Acknowledgement
Big thanks goes to the pilight community, which implemented all the
434MHz protocols. If you want to integrate more protocols, please
contribute directly to [pilight](https://pilight.org/).
[@janLo](https://github.com/janLo) [contributed](https://github.com/puuu/ESPiLight/graphs/contributors) some major cleanups and new functionalities to the library.
## Other similar projects
There are other, more lightweight 434Mhz implementations:
- https://github.com/sui77/rc-switch
- https://bitbucket.org/fuzzillogic/433mhzforarduino/wiki/Home