https://github.com/tyhil/rotary
Control of lights via a rotary phone dial.
https://github.com/tyhil/rotary
internet-of-things python rotary-dial smartthings
Last synced: 11 months ago
JSON representation
Control of lights via a rotary phone dial.
- Host: GitHub
- URL: https://github.com/tyhil/rotary
- Owner: TyHil
- License: gpl-3.0
- Created: 2023-02-21T03:30:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-05-08T19:41:01.000Z (about 1 year ago)
- Last Synced: 2025-05-12T11:49:59.754Z (about 1 year ago)
- Topics: internet-of-things, python, rotary-dial, smartthings
- Language: Python
- Homepage:
- Size: 2.41 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Rotary
Specialized Python program run on my Raspberry Pi that interfaces with a rotary phone dial to control my bedside lamp and LED Strip. The lights are plugged into smart plugs which allows them to be controlled via Samsung's SmartThings API. The LED strip runs on an Arduino (code [here](https://github.com/TyHil/led-strip-effects-and-game/)) which allows it to be controlled over serial to change mode and act as a light alarm.
> [!IMPORTANT]
> This project requires a SmartThings Personal Access Token (PAT) generated before December 30th 2024. Otherwise, the token will need to be changed every 24 hours.
## Setup
1. Clone the project and install packages:
```
git clone https://github.com/TyHil/rotary.git
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
2. Ensure the Serial interface is enabled by running `sudo raspi-config` and navigating to "Interface Options" then "Serial" and choosing "No" to the login shell over serial and "Yes" to enable the serial hardware.
3. Run `cp src/config.example.py src/config.py` and add your SmartThings token to the new file.
4. Run `cp src/alarms.example.py src/alarms.py` and add your alarm times to the new file.
5. Run `cp rotary.example.service /etc/systemd/system/rotary.service`, edit the new file to have the correct `User` and `ExecStart` for you, and run `sudo systemctl daemon-reload`.
6. Optionally add the contents of `example.bash_aliases` to your `~/.bash_aliases` or run `mv example.bash_aliases ~/.bash_aliases`.
7. Connect your rotary dial to GND and GPIO18 (pins 6 and 12) and your RPI->Arduino to 3V3->3V3, GPIO4->GND, GPIO14->RX, and GPIO15->TX (pins 1, 7, 8, and 12). Use a voltage level-shifter if your Arduino does not run in 3.3 volts.
8. Finally run `source ~/.bash_aliases` and `rotary start` to start the progam.
## License
GPL-3.0 License