Simple Microservice to control 433Mhz wireless sockets over HTTP, e.g. on a RaspberryPi

Last update: Jan 09, 2022

Overview

REST-light is a simple microservice to control 433Mhz wireless sockets over HTTP, e.g. on a RaspberryPi. The main usage is an easy integration of 433Mhz wireless sockets in SmartHome Tools like openHAB or ioBroker.

The project is an API-Wrapper around the famous 443Utils project.

How to Use

The setup is very simple. There is nothing to configure, except running the container. For the app to be able to persist the API-Key, ensure the mounted volume is writeable for UID/GID 33.

Install Docker on your RaspberryPi
Attach a 433Mhz transmitter to WiringPi Pin 2 of your RaspberryPi
Run REST-light and receive the generated API-Key from docker logs on first startup.
Try your first request! For an example, see section "curl request example"

GPIO access

For the app to be able to use the Pi's GPIO-PINs, they need to be exposed to the container. There are multiple options to do this, as explained here.

From the ones available, i had the best experience using the "device-approach" as stated below.

docker run

docker run -d --device /dev/gpiomem -v <your-path>/rest-light:/etc/rest-light -p 4242:4242 uupascal/rest-light:DEV-latest

docker-compose

version: "3.8"

services:
  rest-light:
    container_name: REST-light
    image: "uupascal/rest-light:latest"
    restart: unless-stopped
    volumes:
        - "<your-path>/rest-light:/etc/rest-light"
    devices:
        - /dev/gpiomem
    ports:
        - 4242

curl request example

curl http://127.0.0.1:4242/send \
    --data-urlencode "api_key=<key from docker logs>" \
    --data-urlencode "system_code=10000" \
    --data-urlencode "unit_code=2" \
    --data-urlencode "state=0" 

curl http://127.0.0.1:4242/codesend \
    --data-urlencode "api_key=<key from docker logs>" \
    --data-urlencode "decimalcode=500000"

Security considerations

Although this project was developed with current security best-practices in mind, it is still built around software which was not updated for at least 6 years. I would therefor strongly encourage you to only use this container on private & trusted networks and to never expose it to the internet. As the license implies, this software is provided without warranty of any kind.

Versioning & docker tags

Use the docker tag latest to always get the latest stable image.

The images are also tagged with the current timestamp, so to pin to a static version, you can for example use the tag 2022.01.09-1746.

Unstable/Development versions are prefixed with DEV- and should only be used for testing purposes.

Contribution

We love your input! For details see CONTRIBUTING.md

Credits

The project relies on 443Utils.

A script for performing OTA update over BLE on ESP32

18 Dec 15, 2022

Python code written to utilize the Korlan usb2can hardware to send and receive data over the can-bus on a 2008 Nissan 350z

nissan_ecu_hacking Python code written to utilize the Korlan usb2can hardware to send and receive data over the can-bus on a 2008 Nissan 350z My goal

11 Sep 24, 2022

Ingeniamotion is a library that works over ingenialink and aims to simplify the interaction with Ingenia's drives.

Ingeniamotion Ingeniamotion is a library that works over ingenialink and aims to simplify the interaction with Ingenia's drives. Requirements Python 3

7 Dec 15, 2022

ESP32 recording button presses, and serving webpage that graphs the numbers over time.

ESP32-IoT-button-graph-test ESP32 recording button presses, and serving webpage via webSockets in order to graph the responses. The objective was to t

1 Nov 30, 2021

Iec62056-21-mqtt - Publish DSMR P1 telegrams acquired over IEC62056-21 to MQTT

IEC 62056-21 Publish DSMR P1 telegrams acquired over IEC62056-21 to MQTT. -21 is

1 Jun 5, 2022

Quasi-static control of the centroid of quadruped robot

Quasi-static control of quadruped robot 　　This is a demo of the quasi-static controller for the centroid of the quadruped robot. The Quadratic Program

21 Dec 12, 2022

raspberry pi servo control using pca9685

RPi_servo-control_pca9685 raspberry pi 180° servo control using pca9685 Requirements Requires you to have the adafruit servokit library installed You

1 Jan 10, 2022

I made this so I can control my Tapo L510 light bulb and Govee H6159 light strip using the PyP100 module and the Govee public API

TAPO-And-Govee-Controller I made this so I can control my Tapo L510 light bulb and Govee H6159 light strip using the PyP100 module and the Govee publi

0 Nov 23, 2021

Alarm Control Panel component for Zigbee Keypads using action_transaction field

hass_transaction_alarm_panel Alarm Control Panel component for Zigbee Keypads using action_transaction field. Works together with zigbee2mqtt Supporte

4 Jun 9, 2022

Comments

Missing parameters for codesend
Hello Pascal,

codesend from 433Utils uses some optional paramters which can't be passed with REST-light:

unsigned long code = strtoul(argv[1], &eptr, 10); if (argc >= 3) protocol = atoi(argv[2]); if (argc >= 4) pulseLength = atoi(argv[3]); if (argc >= 5) bitLength = atoi(argv[4]);

https://github.com/ninjablocks/433Utils/blob/master/RPi_utils/codesend.cpp

In my case a pulseLength of 150 is needed to get things working. Can you please add the optional parameters?
opened by Yordan1976 0

Releases(2022.01.16-0801)

2022.01.16-0801(Jan 16, 2022)

Automatically created release for push in main: added compatibility for JSON requests
Source code(tar.gz)
Source code(zip)
2022.01.09-1950(Jan 9, 2022)

Automatically created release for push: in main improve logging & performance
Source code(tar.gz)
Source code(zip)
2022.01.09-1810(Jan 9, 2022)

Automatically created release for pushs in main
Source code(tar.gz)
Source code(zip)
2022.01.09-1746(Jan 9, 2022)

Automatically created release for pushs in main
Source code(tar.gz)
Source code(zip)

Simple Microservice to control 433Mhz wireless sockets over HTTP, e.g. on a RaspberryPi

Related tags

Overview

How to Use

GPIO access

docker run

docker-compose

curl request example

Security considerations

Versioning & docker tags

Contribution

Credits

You might also like...

A script for performing OTA update over BLE on ESP32

Python code written to utilize the Korlan usb2can hardware to send and receive data over the can-bus on a 2008 Nissan 350z

Ingeniamotion is a library that works over ingenialink and aims to simplify the interaction with Ingenia's drives.

ESP32 recording button presses, and serving webpage that graphs the numbers over time.

Iec62056-21-mqtt - Publish DSMR P1 telegrams acquired over IEC62056-21 to MQTT

Quasi-static control of the centroid of quadruped robot

raspberry pi servo control using pca9685

I made this so I can control my Tapo L510 light bulb and Govee H6159 light strip using the PyP100 module and the Govee public API

Alarm Control Panel component for Zigbee Keypads using action_transaction field

Comments

Missing parameters for codesend

Releases(2022.01.16-0801)

2022.01.16-0801(Jan 16, 2022)

2022.01.09-1950(Jan 9, 2022)

2022.01.09-1810(Jan 9, 2022)

2022.01.09-1746(Jan 9, 2022)

Owner

Pascal Höhnel

The main aim of this project is to avoid the accidents in shredding ( Waste Recycling Industry )

Programmable Rainbow Redstone Computer

Brogrammer-keyboard - FIrmware for the Brogrammer Keyboard v1.0

Example for Calculating Robot Dynamics Using Pinocchio Library

This is a collection of python modules that interact with the Ryze Tello drone.

Zev es un Bot/Juego RPG de Discord creado en y para aprender Python.

iot-dashboard: Fully integrated architecture platform with a dashboard for Logistics Monitoring, Internet of Things.

LUNA: a USB multitool & nMigen library

An IoT Trivia app that shows you how to take a JSON web API such as the opentdb.com API and stream and display it on a FeatherS2 in an OLED display.

Control the lights of Alienware computers under GNU/Linux systems.

View your medication from Medisafe Cloud in Home Assistant

Hourglass on the pi pico using circuitpython

This is a python script to grab data from Zyxel NSA310 NAS and display in Home Asisstant as sensors.

Better support for Nuki devices to the Home Assistant

Uses the Duke Energy Gateway to import near real time energy usage into Home Assistant

A raspberrypi tools for python

Estimation of whether or not the persons given information will have diabetes.

FHEM Connector for FHT Heating devices

This allows you to record keyboard and mouse input, and play it back using pynput.

Pi-hole with Inky pHAT ePaper display