Readme added

This commit is contained in:
Mal
2026-01-16 22:54:17 +01:00
parent 9577db42bc
commit 053b335e9f
2 changed files with 45 additions and 1 deletions

45
README.md Normal file
View File

@@ -0,0 +1,45 @@
# PortalATtiny
Create a portal from Valve's video game with an oval mirror and a NeoPixel led strip.
## Hardware
You need the following hardware:
- Microcontroller (Arduino Nano/ESP01s/Digispark ATtiny etc.)
- 5V power supply (for the NeoPixel)
- RGB LED strip WS2812B (5V, GND and Din pin)
- optional: 470 ohm resistor to protect the microcrontroller
- optional: 1000 µF capacitor to stabilize
- optional: 3.3V Step Down Module if 5V is too much for your controller (like the ESP01s)
### Setup
Connect the hardware:
- Power pins (+5V and GND) of the led strip with +5V and GND of your power supply.
- Din pin of the led strip with a digital pin of your microcontroller (optionally via the resistor)
- The microcontroller's 5V/3.3V/VIN and GND with the power supply (or the Step Down Module)
- (Put the capacitor to 5V and GND of the power supply)ŵ
## Firmware
Open the ino file inside the [Arduino IDE](https://www.arduino.cc/en/software). Before you flash the code install the library `Adafruit NeoPixel by Adafruit` and do the following configurations:
### Number of leds
Change LEDS to the number of your leds.
```cpp
#define LEDS 43
```
### Led color
Per default the color for the orange portal is used. For the blue portal change it as follows:
```cpp
#define RED 0
#define GREEN 0
#define BLUE 255
```
### Pin
Per default pin 3 is used to control the NeoPixel. Change it if you use another one:
```cpp
#define PIN 3
```