BATTERYDISCHARGER
DOKUMENTATION
VERSION
2022.05.14.0841
BATTERYDISCHARGER.DE
CORPYRIGHT ©2022 TADELSUCHT UG (HAFTUNGSBESCHRÄNKT)
1 Einleitung 2
2 Installation 4
2.1 Windows ................................... 4
2.2 Linux (Ubuntu) ................................ 7
2.2.1 Entpacken .............................. 7
2.2.2 Programm ausführbar machen und starten (GUI) . . . . . . . 9
2.2.3 Programm ausführbar machen und starten (CMD) . . . . . . 12
2.3 macOS ..................................... 13
3 Benutzeroberfläche im Detail (GUI) 16
4 Kommandozeilen (CMD) 21
4.1 Parameterliste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.2 Aufrufbeispiele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.2.1 Windows ............................... 22
4.2.2 Linux (Ubuntu) . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
5 Konfigurationsdateien 23
6 Häufig gestellte Fragen (FAQ) 24
6.1 Was hat das Programm für Systemanforderungen? . . . . . . . . . . . 24
6.2 Das Programm lässt sich nicht starten. [Windows SmartScreen] . . . 24
7 Referenzen 25
1
1
Einleitung
Das Programm bietet eine einfache Möglichkeit die Batterie eines Gerätes mit dem
Betriebsystem Windows, Linux (Ubuntu) oder macOS kontrolliert auf einen vorher
festgelegten Batteriestandes zu entladen und dann beispielsweise herunterzufahren.
Solch eine Entladung kann notwendig werden, wenn kurzfristig der Transport eines
oder mehrerer Geräte mit Lithium-Ionen-Batterien möglichst sicher erfolgen, soll
wie im Flugzeug. Bei dem Transport von Lithium-Ionen-Batterien wird in der Regel
zur Sicherheit und Erhalt der maximal möglichen Kapazität ein Batterielade von
unter 50% genutzt.[2]
Auch alleine für die bloße Einlagerung von Geräten mit Lithium-Ionen-Batterien
ist eine gewisse Entladung förderlich für die Erhaltung der maximalen möglichen
Kapazität, im Vergleich zu einem 100%-Batteriestandes bei der Einlagerung.
Bei der Vorbereitung für einen Transport oder eine Einlagerung kann das Programm
schnell auf allen Geräten verteilt werden und sicherstellen, dass nicht weniger als
die gewünschte Batterieentladung erreicht wird.
Funktionen
Einstellbare Ziel-Batterieentladung (in Prozent)
Verschiedene mögliche Aktionen beim erreichen der gewünschten Batterieent-
ladung (Gerät herunterfahren [Shutdown], Gerät in den Energiesparmodus
2
versetzten [Sleep], Gerät in den Ruhezustand versetzten [Hibernate])
Optionale Beschleunigung der Batterieentladung
Optionale Verhinderung von unerwünschten Ruhezustandes des Systems während
der Battieentladung
Anzeige der aktuellen Akkuladung in Prozent
Anzeige der verbleibenden Minuten bis der ausgewählte Batteriestand erre-
icht wird (Funktioniert nur unter Windows)
Kommandozeilenparameter (inklusive Autostart)
Unterstützung von verschiedenen Sprachen (Deutsch und Englisch sowie maschinell
übersetzt Bulgarisch, Chinesisch, Dänisch, Estnisch, Finnisch, Französisch,
Griechisch, Italienisch, Japanisch, Lettisch, Litauisch, Niederländisch, Pol-
nisch, Portugiesisch, Rumänisch, Russisch, Schwedisch, Slowakisch, Slowenisch,
Spanisch, Tschechisch sowie Ungarisch)
3
2
Installation
Folgend wird die Installation bzw. der erstmalige Start der Anwendung beschrieben
und gezeigt.
2.1 Windows
Die heruntergeladene ZIP-Datei muss entpackt werden und mit einem Doppelkick
auf die entpackte "BatteryDischarger.exe" kann das Programm dann gestartet wer-
den. Die .DLL-Dateien die sich ebenfalls im Ordner befinden sind essentiell und
müssen vorhanden sein, damit das Programm starten kann.
4
B
A
ARechtsklick auf die ZIP-Datei.
BAuf "Alle extrahieren..." klicken zum entpacken.
Auf "Extrahieren" klicken.
5
A
Mit einem Doppelklick auf die "BatteryDischarger.exe" kann dann das Programm
gestartet werden.
6
2.2 Linux (Ubuntu)
2.2.1 Entpacken
7
8
2.2.2 Programm ausführbar machen und starten (GUI)
9
10
11
2.2.3 Programm ausführbar machen und starten (CMD)
1cd Downloads/BatteryDischarger-Linux-x64/
2chmod +x*
3./BatteryDischarger
12
2.3 macOS
Zu beachten: Der Mac wird nur durch das Programm heruntergefahren, wenn die
Anwendung zuvor mit „sudo als Admin gestartet wurde.
13
14
15
3
Benutzeroberfläche im
Detail (GUI)
J
I
H
G
F
E
CD
B
A
16
A Ziel-Batterieladung (in Prozent) An dieser Stelle kann über die Textbox ein
Zahlenwert für die gewünschte Ziel-Batterieladung in Prozent eingetragen werden
oder mittels des Schieberegelers der Wert festgelegt werden.
B Aktion, wenn der ausgewählte Akkuladestand erreich ist: Hier kann zwis-
chen Gerät herunterfahren (Shutdown), Gerät in den Energiesparmodus versetzten
(Sleep) und Gerät in den Ruhezustand versetzten (Hibernate) gewählt werden.
C Batterieentladung beschleunigen: Führt dazu, dass bei der kontrollierten Ent-
ladung zusätzliche sinnlose Berechnungen durchgeführt werden, damit der Prozessor-
Energieverbrauch steigt. Die Auslastung des Prozessors wird dabei aber noch so
gering gehalten, dass das Gerät weiterhin auf Benutzereingaben reagiert.
D Unerwünschten Ruhezustand des Systems verhindern: Versucht den uner-
wünschten Ruhezustand bzw. Energiesparmodus des Systems zu verhindern. Unter
Linux (Ubuntu) kann dabei ggf. vom Programm Superuser-Rechte angefordert wer-
den.
E Kontrollierte Entlatung starten: Startet den Enlatungsvorgang unter Beach-
tung der gemachten Einstellungen.
F Aktuelle Akkuladung in Prozent
G Anzahl der Minuten, bis der ausgewählte Batteriestand erreich ist: Der Wert
kann mit der Auslastung und dem darausfolgenden Energieverbrauch während der
Entladung stark schwanken. Wenn der Wert absurd hoch ist (länger als einen Tag
oder dergleichen) kann dies ein Hinweis darauf sein, dass das Gerät derzeit nicht
entladen wird, weil ggf. noch der Ladestecker im Gerät steckt. (Anzeige funktioniert
nur unter Windows)
H Sprache: Hier kann der Sprache des Programm festgelegt werden. Das Pro-
gramm startet sich bei Änderung mit der nun festgelegten Sprache neu.
I Lizenz-Code: Hier kann der Lizenzschlüssel eingeben werden.
J Rechtliche Hinweise: Hier finden sich Programmlizenztexte und AGB.
17
A
ANachdem ein gültiger Lizenzschlüssel eingeben wurde, ändert sich die Anzeige
von einem roten X zu einem grünen Haken. Ebenso wird der eingegebene Schlüssel
verschleiert und eine Änderung des Schlüssels verhindert.
18
A
AHier kann zwischen Gerät herunterfahren (Shutdown), Gerät in den Energies-
parmodus versetzten (Sleep) und Gerät in den Ruhezustand versetzten (Hibernate)
gewählt werden.
19
B
C
A
Nach dem klick auf "Kontrollierte Entladung starten" ändert sich, wie bei Bzu se-
hen, der Knopf auf "Kontrollierte Entladung stoppen", die Einstellungsmöglichkeiten
(siehe A) werden gesperrt und der kontrollierte Entladevorgang beginnt. Ebenso ist
nun ein sinkender Wert bei der "Anzahl der Minuten, bis der ausgewählte Batterie-
stand erreich ist" (siehe C) zu sehen.
20
4
Kommandozeilen (CMD)
Das Programm kann mit Kommandozeilenparameter gestartet werden, die die Kon-
figuration und den Start des Entladevorgangs per Skript erlaubt. Die grafische Ober-
fläche wird unabhängig von den angebenen Parametern immer gestartet.
4.1 Parameterliste
Folgend eine Auflistung aller verfügbaren Parameter, die in beliebiger Reihenfolge
einzeln oder auch im Verbund genutzt werden können:
21
Parameter Beschreibung
Autostart
Die Angabe des Parameters reicht, damit der
Entladevorgang sofort beim Programmstart
gleich angestartet wird.
LicenseCode XXXXXXXX Über diesen Parameter kann der Lizenzschlüssel
festgelegt werden.
Language XX
Dieser Parameter legt die Programmsprache fest.
Unterstützt folgende Sprachen:
bg, cs, da, de, el, en, es, et, fi, fr, hu, it,
ja, lt, lv, nl, pl, pt, ro, ru, sk, sl, sv, zh
AccelerateBatteryDischarge True Legt fest, ob die Batterieentladung beschleunigt
werden soll. [ True / False ]
PreventUnwantedSystemSleepMode
True
Legt fest, ob bis zum erreichen des gewünschten
Batteriestandes das System vom Ruhezustand
abgehalten werden soll. [ True / False ]
TargetBatteryChargeInPercent 30 Legt die Ziel-Batterieladung in Prozent fest.
4.2 Aufrufbeispiele
In den folgenden Beispielen ist die Maximalausprägungen der Parameter zu sehen.
4.2.1 Windows
1BatteryDischarger.exe Autostart LicenseCode XXXXXXXX Language de
AccelerateBatteryDischarge True PreventUnwantedSystemSleepMode
False TargetBatteryChargeInPercent 30
,
,
2pause
4.2.2 Linux (Ubuntu)
1./BatteryDischarger.exe Autostart LicenseCode XXXXXXXX Language de
AccelerateBatteryDischarge True PreventUnwantedSystemSleepMode
False TargetBatteryChargeInPercent 30
,
,
2read -p"Press any key to resume ..."
22
5
Konfigurationsdateien
Die Anwendung erstellt beim Start die "Configuration.ini", welche folgend beispiel-
haft dargestellt wird und dafür da ist die in der Benutzeroberfläche gemachten Ein-
stellungen zu speichern. Diese Datei wird im Normalfall in dem Order in dem die
.EXE-Datei liegt erstellt. Wenn der ausführende Benutzer jedoch keine Schreibrechte
auf den Ordner besitzt, wird die Datei unter dem Pfad %appdata%\BatteryDischarger\
Configuration.ini erstellt.
Die einzelnen Einstellungen selbst werden in dem Abschnitt 4.1 erläutert, wobei
der Parameter "Autostart" nicht in der Konfigurationsdatei unterstützt wird.
Folgend die Maximalausprägungen:
1[UI]
2Language =de
3TargetBatteryChargeInPercent = 30
4AccelerateBatteryDischarge =True
5PreventUnwantedSystemSleepMode =True
6
7[Software]
8LicenseCode =XXXXXXXX
23
6
Häufig gestellte Fragen
(FAQ)
6.1 Was hat das Programm für Systemanforderungen?
Kompatibel mit Windows (getestet auf Windows 7, Windows 8, Windows 10 und
Windows 11) und Linux (getestet auf Ubuntu 20.04). Es werden ca. 100 MB Spe-
icherplatz benötigt. Das Programm benötigt zu keinem Zeitpunkt eine Internetverbindung
und versucht auch keine aufzubauen.
6.2 Das Programm lässt sich nicht starten. [Windows SmartScreen]
Erscheint bei einem Doppelklick auf die heruntergeladene Programmdatei eine
Meldung, wie „Der Computer wurde durch Windows geschützt” oder „Von Win-
dows Smartscreen wurde der Start einer unbekannten App verhindert, muss zum
Start der Anwendung auf den Text „Weitere Informationen" innerhalb des Fensters
geklickt werden und dann auf „Trotzdem ausführen.
Eine solche Meldung wird von Microsoft angezeigt, wenn ein ausführbares Pro-
gramm relativ neu erstellt wurde und Microsoft noch nicht bekannt ist. Microsoft
wird automatisch im Hintergrund die exe-Datei hochladen, analysieren und erst
diese Meldung bei anderen nicht mehr anzeigen, wenn das Programm in der Ver-
sion schon bereits einige Zeit auf vielen Rechner verwendet wurde. Daher kann das
Problem leider bei jeder neuen Version des Programms erneut auftreten.
24
7
Referenzen
7
References
[1] BatteryDischarger Webseite
https://BatteryDischarger.de/
[2] Lithium-Ion Batteries Hazard and Use Assessmen - Mikolajczak, C. and Kahn,
M. and White, K. and Long, R.T. - Seite 110
https://books.google.co.uk/books?id=V4IVCvgv558C
25
WordPress Appliance - Powered by TurnKey Linux