https://github.com/cbrand/esp32-ir-remote

A micropython project for running esp32 ir remotes
https://github.com/cbrand/esp32-ir-remote

Last synced: 3 months ago
JSON representation

A micropython project for running esp32 ir remotes

• Host: GitHub
• URL: https://github.com/cbrand/esp32-ir-remote
• Owner: cbrand
• License: mit
• Created: 2020-11-29T22:01:27.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2022-07-11T10:38:35.000Z (over 2 years ago)
• Last Synced: 2024-04-29T11:33:12.878Z (6 months ago)
• Language: Python
• Size: 501 KB
• Stars: 9
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-micropython - esp32-ir-remote - A MicroPython project for running ESP32 IR remotes. (Libraries / Communications)

README

        
# ESP32 Remote #

This repository includes code for an IR remote configurable controller. It connects to an MQTT server

and allows to play Scenes. Currently, the following protocols are supported:

- Infrared NEC

- Infrared RC6

- Onkyo EISCP protocol

The firmware runs on an ESP32. It doesn't require additional external PSRAM, at least with the configration provided

here. Most of the python code is directly embedded in the Micropython library. If you want to run everything directly

from the file system, additional PSRAM might be advisable.

## Hardware Layout ##

![Hardware Breadboard](images/wiring-breadboard.png)

![Hardware Layout](images/wiring-layout.png)

## Installation ##

You require an MQTT broker for communication.

For configuration, you should put a `config.json` in the root directory and copy the `main.py` file in there too.

An example of the `config.json` can be found [here](config.example.json).

## Preliminary Software ##



For fully using this application, there also exists a cloud backend and frontend:

- The backend is written in Go and is available [here](https://github.com/cbrand/ir-remote-backend).

- The frontend is written in TypeScript and Vue.js and is availalable [here](https://github.com/cbrand/ir-remote-frontend).

## Caveats ##

I couldn't get with the newest version of micropython propper client side certificates to run. I am not quite sure what the root cause

is and stepped down to authenticate with username and password to the broker. However, if anybody can point me to the issue I would gladly

fix this.

## Used Libraries ##

Some libraries are directly embedded in the repository, but have been taken from somewhere else. For easier reference these are:

### [mqtt_as.py](modules/mqtt_as.py) ### 

[![micropython-mqtt](https://img.shields.io/badge/micropython--mqtt-mqtt__as.py-blue)](https://github.com/peterhinch/micropython-mqtt/blob/9032983936a30c23a9d53bcabe1ca85d7ee99fdd/mqtt_as/mqtt_as.py)

Slightly modified for rebooting the whole ESP32 on various connection issues after an unsuccesful connection as in my experience wrapping

an TLS connection on the ESP32 runs in an endless loop of reconnection issues. My best guess is that something in the TLS pipeline isn't releasing

resources without a hard reboot.

### [ntptime.py](modules/ntptime.py) ###

[![micropython ntptime.py](https://img.shields.io/badge/micropython-ntptime.py-blue)](https://github.com/micropython/micropython/blob/master/ports/esp8266/modules/ntptime.py)

Retrieved from the ESP8266 code base in micropython, it is used to initially synchronize the esp clock on reboot and reconnect.

## License ##

The code is licensed via the MIT license.