LED-Clock/README.md

# Anleitung RGB LED Uhr

Nach jeden Neustart wird der eigene WiFi Accesspoint für 30 Sekunden aktiviert. Verbindet man sich mit diesem, so kann man etwaige Fehler korrigieren. 
# Schnellstart
Sobald die Uhr mit Strom versorgt wird ( 5V, 500mAh) bietet das Board (Lolin32lite) einen WiFi Accesspoint "NTP-Clock-RGBLED" an und drei LEDs in roten Farben kreisen schnell herum. Zu diesem kann man sich verbinden (Passwort: 12345678) bzw. das Smartphone meldet, dass eine Anmeldung erforderlich ist. Man kommt zunächst auf der Übersichtsseite an. Diese ist später erst interessant, stattdessen muss die Internetverbindung konfiguriert werden. Hierzu klickt man auf "Config" und trägt die folgenden drei Dinge ein:

 - Ein Passwort für die Uhr bzw den temporären Accesspoint
 - Den Namen des Wlans
 - Das Passwort des Wlans

Der Rest ist nicht notwendig. Sobald man die Werte gespeichert hat, trennt man das Smartphone vom WLAN der Uhr. Die drei kreisenden LEDs können dann weiß kurz aufleuchten. Üblicherweise sieht man dies nicht, da sobald die Uhrzeit verfügbar ist, diese angezeigt wird. In seltenen Fällen wird der Ring weiß beleuchtet und drei schwarze LEDs kreisen. Dies bedeutet, dass keine Uhrzeit zur Verfügung steht. Ansonsten ist damit die Uhr konfiguriert.
Ab sofort ist die Uhr unter einer neuen IP erreichbar (nachzusehen im Router), sodass dort weitere Einstellungen vorgenommen werden können. Die Uhr merkt sich auch die getätigten Einstellungen.
# erweiterte Einstellungen
 Es wird unter der IP 192.168.4.1 ein Webserver angeboten (sofern über den Accesspoint direkt verbunden), der zwei Webseiten anzeigen kann. Primär wird die Statusseite angezeigt, die alle wesentlichen Parameter auflistet:
 - Aktuelle NTP Zeit
 - der gewählte NTP Server
 - aktuelle Helligkeit
 - maximale Helligkeit
 - Anzeige der einzelnen Sekunden
 - Aufleuchten aller LEDs
 - Folgende Stunde (wie auf einer analogen Uhr)
 - Farbwahl der 12Uhr Markierung
 - Farbwahl der aktuelle Stunde (3LED)
 - Farbwahl der aktuellen Minute (1LED)
 - Farbwahl der aktuellen Sekunde (1LED)
 - Farbwahl der übrigen LEDs
 - Farbwahl der restlichen Stunden (10 LEDs)

Unten auf der Statusseite gibt es einen Link zur Konfigurationsseite, eine Möglichkeit für den Upload einer neuen Firmware sowie die aktuelle Firmwareversion wird angezeigt.

## technische Details

 - ESP32 (Lolin32 Lite)
 - SK6812 or WS2812B 60 LED ring
 - LDR over Resistor voltage divider
 - LED ring powered over 3.3V (WS2812B) rail or USB VCC (SK6812)
 - LED Output Pin 17 (requirement for NeoPixel library as I2S is used)
 - LDR analog measure pin A6

## Konfigurationsseite

  # System configuration
  - Thing name
  - AP password
  - WiFi SSID
  - WiFi password
  - Startup delay (seconds)
  # Time settings
  - NTP server
  # LED settings
  - MAX Brightness
  - Show Seconds
  - all Dots lighten up
  - following Hour
  - hourColor
  - minuteColor
  - secondsColor
  - highnoonColor
  - backlightColor
  - hourMarkingColor

 - firmware update link
 - Firmware config version 'xxxx'

## ausstehende Verbesserungen
 - [ ] flüssige Helligkeitsadaptierung
 - [ ] härtes non-blocking Verhalten
  - offensichtliche delay/yield aufgelöst
 - [ ] finde WDT reset beim WiFi connect
  - Wechsel des lwip bringt eine Verbesserung
 - [ ] schnelleres Berechnen des followingHour Offset
iotwebconf 3.0.0 migration 2021-01-01 15:44:50 +00:00			`# Anleitung RGB LED Uhr`

minor markdown fixes 2021-01-31 15:43:30 +00:00			`Nach jeden Neustart wird der eigene WiFi Accesspoint für 30 Sekunden aktiviert. Verbindet man sich mit diesem, so kann man etwaige Fehler korrigieren.`
iotwebconf 3.0.0 migration 2021-01-01 15:44:50 +00:00			`# Schnellstart`
update README 2021-02-12 07:25:28 +00:00			Sobald die Uhr mit Strom versorgt wird ( 5V, 500mAh) bietet das Board (Lolin32lite) einen WiFi Accesspoint "NTP-Clock-RGBLED" an und drei LEDs in roten Farben kreisen schnell herum. Zu diesem kann man sich verbinden (Passwort: 12345678) bzw. das Smartphone meldet, dass eine Anmeldung erforderlich ist. Man kommt zunächst auf der Übersichtsseite an. Diese ist später erst interessant, stattdessen muss die Internetverbindung konfiguriert werden. Hierzu klickt man auf "Config" und trägt die folgenden drei Dinge ein:

			`- Ein Passwort für die Uhr bzw den temporären Accesspoint`
textual improvement 2021-01-16 17:01:47 +00:00			`- Den Namen des Wlans`
			`- Das Passwort des Wlans`
minor markdown fixes 2021-01-31 15:43:30 +00:00
			`Der Rest ist nicht notwendig. Sobald man die Werte gespeichert hat, trennt man das Smartphone vom WLAN der Uhr. Die drei kreisenden LEDs können dann weiß kurz aufleuchten. Üblicherweise sieht man dies nicht, da sobald die Uhrzeit verfügbar ist, diese angezeigt wird. In seltenen Fällen wird der Ring weiß beleuchtet und drei schwarze LEDs kreisen. Dies bedeutet, dass keine Uhrzeit zur Verfügung steht. Ansonsten ist damit die Uhr konfiguriert.`
update README 2021-02-12 07:25:28 +00:00			`Ab sofort ist die Uhr unter einer neuen IP erreichbar (nachzusehen im Router), sodass dort weitere Einstellungen vorgenommen werden können. Die Uhr merkt sich auch die getätigten Einstellungen.`
add green for status 2021-01-17 17:50:21 +00:00			`# erweiterte Einstellungen`
			`Es wird unter der IP 192.168.4.1 ein Webserver angeboten (sofern über den Accesspoint direkt verbunden), der zwei Webseiten anzeigen kann. Primär wird die Statusseite angezeigt, die alle wesentlichen Parameter auflistet:`
iotwebconf 3.0.0 migration 2021-01-01 15:44:50 +00:00			`- Aktuelle NTP Zeit`
			`- der gewählte NTP Server`
			`- aktuelle Helligkeit`
			`- maximale Helligkeit`
			`- Anzeige der einzelnen Sekunden`
			`- Aufleuchten aller LEDs`
release candidate 0.9 2021-01-08 20:10:16 +00:00			`- Folgende Stunde (wie auf einer analogen Uhr)`
V1.1.2 2021-01-26 20:44:46 +00:00			`- Farbwahl der 12Uhr Markierung`
			`- Farbwahl der aktuelle Stunde (3LED)`
			`- Farbwahl der aktuellen Minute (1LED)`
			`- Farbwahl der aktuellen Sekunde (1LED)`
			`- Farbwahl der übrigen LEDs`
			`- Farbwahl der restlichen Stunden (10 LEDs)`
release candidate 0.9 2021-01-08 20:10:16 +00:00
add green for status 2021-01-17 17:50:21 +00:00			`Unten auf der Statusseite gibt es einen Link zur Konfigurationsseite, eine Möglichkeit für den Upload einer neuen Firmware sowie die aktuelle Firmwareversion wird angezeigt.`
iotwebconf 3.0.0 migration 2021-01-01 15:44:50 +00:00
			`## technische Details`

			`- ESP32 (Lolin32 Lite)`
			`- SK6812 or WS2812B 60 LED ring`
			`- LDR over Resistor voltage divider`
			`- LED ring powered over 3.3V (WS2812B) rail or USB VCC (SK6812)`
release candidate 0.9 2021-01-08 20:10:16 +00:00			`- LED Output Pin 17 (requirement for NeoPixel library as I2S is used)`
iotwebconf 3.0.0 migration 2021-01-01 15:44:50 +00:00			`- LDR analog measure pin A6`

release candidate 0.9 2021-01-08 20:10:16 +00:00			`## Konfigurationsseite`

			`# System configuration`
			`- Thing name`
			`- AP password`
			`- WiFi SSID`
			`- WiFi password`
			`- Startup delay (seconds)`
			`# Time settings`
			`- NTP server`
			`# LED settings`
			`- MAX Brightness`
			`- Show Seconds`
			`- all Dots lighten up`
			`- following Hour`
V1.1.2 2021-01-26 20:44:46 +00:00			`- hourColor`
minor markdown fixes 2021-01-31 15:43:30 +00:00			`- minuteColor`
			`- secondsColor`
			`- highnoonColor`
			`- backlightColor`
			`- hourMarkingColor`
release candidate 0.9 2021-01-08 20:10:16 +00:00
			`- firmware update link`
			`- Firmware config version 'xxxx'`
iotwebconf 3.0.0 migration 2021-01-01 15:44:50 +00:00
			`## ausstehende Verbesserungen`
			`- [ ] flüssige Helligkeitsadaptierung`
minor markdown fixes 2021-01-31 15:43:30 +00:00			`- [ ] härtes non-blocking Verhalten`
brightness adaption 2021-11-26 11:10:53 +00:00			`- offensichtliche delay/yield aufgelöst`
fix loop task 2021-10-14 12:04:14 +00:00			`- [ ] finde WDT reset beim WiFi connect`
brightness adaption 2021-11-26 11:10:53 +00:00			`- Wechsel des lwip bringt eine Verbesserung`
fix loop task 2021-10-14 12:04:14 +00:00			`- [ ] schnelleres Berechnen des followingHour Offset`