1   Vorwort

Dieses Paket und die enthaltene Software und Dokumentation sind ausschließlich für Mitglieder des Aqua Computer Support-Forums gedacht.

Danke an Y0Gi, Clark, Shoggy, Cronix und alle Anderen, die mit ihrer Hilfe und ihren Ideen dieses Programm ermöglicht haben.

Danke auch an alle (Beta-)Tester und Bug-Reporter, die sehr viel Geduld mit dieser schnell zusammengeschriebenen Software hatten und immer noch haben: @re@50, Alex, Anisachse, b0nez, dasc1mt, DrStrange, Eikman, FUNKMAN, gr3if, HansWursT, hurra, JoFreak, KillerX, Kinyar, kite, LeifTech, Lev, maed, Max_Payne, MISZOU, newold, NikoMo, Nini2000, nordy, saUerkraut, scott, sebastian, Sonni, Stefan_K., Tahigwa, TemplarOfSteel, Vitektim, welteken, …

Wer eine funktionierende und stabil laufende 4.x-Version hat, sollte diese weiterhin verwenden - "never touch a running system!"

Diese Version richtet sich in erster Linie an User, die kein Python haben und auch keines installieren dürfen/können/wollen. Weiterhin wurde die integrierte Router-Steuerung komplett umgebaut und deutlich erweitert, um Hilfsprogramme (wie z. B. RouterControl) zu vermeiden.

Es gibt jetzt zwei Versionen:

Python-Version:

Das läuft nur mit installiertem Python-Interpreter, der heute schon fester Bestandteil vieler Betriebssystem-Releases ist. Aktuelle Python-Versionen gibt's unter: http://www.python.org/download/releases/

Aufruf mit: ACmcMain.py <Parameterliste>

Bei manchen Pythons muss der Interpreter explizit angegeben werden: python.exe ACmcMain.py <Parameterliste>

Win32-Version:

Das sollte mit allen 32-Bit-Windows ab 2000 laufen. Diese Version ist sofort lauffähig und benötigt keinerlei Installation.

Aufruf mit: ACmcMain.exe <Parameterliste>

2   Installation/Auspacken

Um allen Problemen vorzubeugen, sollte das Archiv in einen möglichst kurzen Pfad (ohne Leerzeichen) entpackt werden, also z .B. nach D:\. Mit dem Standard-ZIP gibt das dann: D:\ACmcBatch500\....

Der Ordner Eigene Dateien ist keine gute Idee, weil die Pfade (je nach Windows-Version und Netzwerkumgebung) zu lang werden können. Und der Ordner Programme ist eine ganz schlechte Idee, weil das Programm dann u. U. nur noch mit Admin-Rechten läuft.

Wenn Du (von einer früheren Version) noch RouterControl installiert hast und es problemlos läuft, solltest Du es weiterverwenden. Dafür gibt's ein spezielles Router-Modell RoCon, das das Programm vollständig integriert.

3   Ausführung

Um schnell eine Shell (aka DOS-Fenster) mit dem richtigen Arbeitspfad zu öffen gibt's CmdHere aus den XP PowerToys: Damit kann man im Explorer auf den Ordner rechtsklicken (Erweiterung des Kontext-Menues für Ordner).

Neu: Für die Übergabe der Parameter gibt es zwei Möglichkeiten:

• Die Parameter werden in eine einfache Konfigurations-Datei geschrieben: ACmcConf.txt. Diese Datei muß sich im selben Verzeichnis befinden wie ACmcMain.py bzw. ACmcMain.exe. Das Format ist super-einfach: Plain-Text und genau ein Parameter pro Zeile.
• Die Parameter werden auf der Kommandozeile übergeben. Beachte dazu auch die Beispiel-Dateien: Start.bat. Mit "beachten" meine ich nicht ausführen, sondern angucken: Explorer |rarrow| Rechtsklick |rarrow| Bearbeiten. Die Datei HitCity.bat macht genau einen Klick und endet dann. Dazu kann man eine Verknüpfung in den Autostart-Ordner legen.
• Diese beiden Methoden können auch gemischt werden. Die Parameter auf der Kommandozeile haben dabei Vorrang. D. h.: Wenn auf der Kommandozeile nichts steht, gelten die Einstellungen der Konfigurations-Datei. Z. B.: Wenn in der Konfigurations-Datei für die Verzögerungs-Zeit (erster Parameter) ein Wert von 10 Sekunden steht und man das Programm mit ACmcMain.exe 20 ... startet, dann gelten 20 Sekunden.

Beim Aufruf des Programmes (ACmcMain.py bzw. ACmcMain.exe) ohne Parameter gibt's eine kleine Hilfe und eine Liste der unterstützten Router.

Neu: Das Programm wartet jetzt auf die Eingabetaste (Enter/Return). Beim "Windows-Doppelklick" wird sonst das Fenster gleich wieder geschlossen und man sieht nix.

Wenn's nicht läuft sollte man das Programm nicht mit einem Doppelklick oder per Windows-Verknüpfung sondern in einer Shell starten. Nur so hat man die Möglichkeit, alle Fehlermeldungen und Fehler-Zustände zu entdecken:

4   Die Parameter im Einzelnen

4.1   Kurzversion (für Lesefaule)

ACmcMain.exe <Delay> <WorkFile> <Betriebsstunden> <Router-Typ> [Router-Parameter]

• Parameter 1: Delay (1 .. 200 Sekunden | 0 = Auto-Timer | T = Test der Router-Steuerung)
• Parameter 2: WorkFile (0 = keine ArbeitsDatei | 1 = Default-Einstellung | Drive:Path\Name)
• Parameter 3: Betriebsstunden (A = 24h | 24* R|W|E, R = Run, W = Wait, E = Exit)
• Parameter 4: Router-Typ (None | Batch | X | UPnP | UPnPa | Get | Post | <model> gemäß Router-Liste)
• Parameter 5 und weiter: je nach Router-Typ (Parameter 4)
  • None (keine Parameter)
  • Batch (keine Parameter)
  • Fritz (keine Parameter) - für AVM FritzBox via UPnP
  • X <Programmaufruf mit Parametern>: Externes Programm (RouterControl, cURL, DisConnect usw.) und Parameterliste
  • UPnPa <Adresse>
  • UPnP <Adresse> <Port>
  • Get <Adresse> <Username> <Passwort> <DocPath>
  • Post <Adresse> <Username> <Passwort> <DocPath> <Data> (=/&-encoded)
  • model <Adresse> [Username] [Passwort]

Bei mir sieht das dann z. B. so aus:

5   Programmaufruf

5.2   Windows-Verknüpfung (mit Parameter-Übergabe)

Zuerst eine Verknüpfung für ACmcMain.exe erstellen und diese Verknüpfung dann bearbeiten.

Für eine AVM FritzBox sieht das dann etwa so aus:

Geübte Tastatur-Akrobaten können die Parameter natürlich auch jedesmal von Hand neu eintippen ;-)

6   Bildschirmausgabe

7   Spezielles

• Prinzipiell kann unter X jedes Programm aufgerufen werden.

  Da bietet sich dann natürlich cURL an, das für jede beliebige Plattform verfügbar ist. Die aktuelle cURL-Version für deine Plattform gibt es auf http://curl.haxx.se/download.html

  Connect/Disconnect-Befehle für alle möglichen Router gibt's hier: http://reconnect.thau-ex.de/

• Disconnect-Befehle lassen sich auch direkt mit Get und Post absenden.

  • Die cURL-Befehle (aus oben genannter Quelle) müssen nur noch vom Batch- und cURL-Overhead befreit werden. Es werden nur die HTTP-Methoden GET und POST (cURL-Parameter -d) via HTTP-Port 80 sowie Standard-Authentifizierung unterstützt. Für alle andere Methoden, Ports und Authentifizierungen (z. B. via Cookie) mußt du cURL als Programm einbinden.

  • In den Strings können folgende Platzhalter verwendet werden:

    @IP@

    IP-Adresse des Routers

    @US@

    Benutzername

    @PW@

    Passwort

• to be continued …

8   Changelog

9   TODO

• Testen, testen, testen
• Ausbau der Router-Datenbank
• E-Mail-/SMS-Notify - work in progress (tnx 2 Y0Gi)
• Übersetzung dieser Dokumentation ins Englische - vielleicht hat da ja mal jemand die Muße

Das war eigentlich schon alles. Jetzt wünsch' ich Dir viel Spaß beim Aufbau unserer Stadt!

10   Allgemeines/Disclaimer

Bei der vorliegenden Software wird garantiert, daß diese Platz auf der Platte verschwendet. Weitere Funktionen sind rein zufällig und vom Author gar nicht beabsichtigt. Vor dem Ausführen irgendeiner dieser Anwendungen wird hiermit ausdrücklich gewarnt.

Die enthaltenen Quelltexte sind "mal eben schnell zusammengehackt" und sollten in dieser Ursprungsform nicht für Lehr- und Schulungszwecke verwendet werden ;-)

-- Tom, 2008