Create and rework data handling, part I

doc/bigxionflasher-usb-src-0.2.4r97/README

@@ -0,0 +1,99 @@
+==========
+ANLEITUNG:
+==========
+
+Lizenz:
+Diese Software steht unter der GPLv3 Lizenz. (siehe http://www.gnu.org/licenses/gpl.html)
+
+Systemvoraussetzungen:
+Um diese Software verwenden zu können wird folgende Hardware benötigt:
+ - ein BionX oder kompatibles Antriebssystem
+ - ein PC oder Laptop mit Linux oder Windows
+ - ein PC-Can Adapter: Tiny-CAN I, Tiny-CAN II-XL (von mir getestet), Tiny-CAN IV-XL
+   mit !!! KORREKT INSTALLIERTER TREIBER SOFTWARE !!!
+   Bitte unbedingt die vom Hersteller des Tiny-CAN gelieferte Software can_view
+   zum laufen bringen. Erst wenn diese funktionert den BigXionFlasher verwenden!
+ - ein BionX CAN-Bus Kabel (weiter unten beschrieben)
+
+1.)
+Zu aller erst muss die Treibersoftware für den Tiny-CAN installert und mit beiliegender
+CAN-View Software getestet werden. Bitte die Hersteller-Web-Site konsultieren
+
+2.)
+Das Bus-Kabel laut unten stehender Anleitung selber herstellen oder
+sich eines bauen lassen. System ausschalten!
+
+3.)
+Die Steckverbindung des BionX-CAN-Bus an einer beliebigen Stelle lösen (z.B. gleich
+nach der Konsole) und das neue Kabel mit den entsprechenden Stecker verbinden.
+
+4.)
+Den TinyCAN Adapter mit dem 9 Sub-D Stecker am Kabel verbinden und das USB-Kabel
+mit dem PC und dem TinyCAN Adapter verbinden.
+
+5.)
+Software installieren: dazu einfach das neueste binary package für das entsprechende
+Betriebssystem herunterladen und in ein beliebiges Verzeichnis ENTPACKEN.
+
+6.)
+Terminal starten:
+ - Ubuntu: Anwendungen -> Zubehör -> Terminal
+ - Windows: Start -> Ausführen -> cmd (eingeben + Enter drücken)
+
+und in das Verzeichnis wechseln wo der Download entpacken wurde.
+
+Nach der Eingabe von  ls  (unter Linux) oder  dir  (unter Windows) muss die Datei
+BigXionFlasher (Linux) oder BigXionFlasher.exe (Windows) angezeigt werden. 
+
+7.)
+Antriebssystem einschalten.
+
+8.)
+Es mehrere Argumente mit denen das Programm gestartet werden kann. Mit dem Argument -h
+bekommt man eine Übersicht über diese. Zuerst startet man am besten mal ohne Argumente
+um zu sehen ob das Kabel und die Software korrekt funktionieren. Der BigXionFalsher
+setzt die Konsole automatisch in den CAN-Salve Modus.
+
+Einige Aufrufbeispiele:
+ - BigXionFlasher -h
+   zeigt eine Hilfeseite an auf der alle verfügbaren Optionen angeführt werden
+
+ - BigXionFlasher -s
+   Zeigt diverse Informationen zu Konsole, Batterie und Motor an
+   und beendet sich dann wieder
+
+ - BigXionFlasher -l 0
+   Hebt das Geschwindigkeitslimit auf und schaltet das System danach ab
+   
+ - BigXionFlasher -l 32
+   Setzt das Geschwindigkeitslimit auf den angegebenen Wert (hier 32 km/h) und
+   schaltet das System danach ab
+
+ - BigXionFlasher -a 3 -l 27.4
+   Setzt die vorgewählte Unterstützungsstufe auf Stufe 3 und das
+   Geschwindigkeitslimit auf 27.4 km/h (als Komma muss ein Punkt eingegeben werden) 
+
+9.)
+!!VORSICHTIG FAHREN!! Ich bin auf einer ebenen Teststrecke mit meinem voll aufgeladenen
+48V System 46 km/h gefahren und hatte immer noch 1 Unterstützungsbalken und Tränen
+in den Augen (wegen dem Wind!).
+
+=========
+KABEL:
+=========
+
+Es werden 2 Stecker, 1 Buchse und 1 6poliges geschirmtes Kabel (50cm - 100cm) benötigt:
+Buchse: HR30-6J-6P
+Stecker: HR30-6P-6S
+Stecker: Sub-D Stecker 9-polig
+
+Die beiden HR30 müssen 1:1 durch verbunden werden inkl. Abschirmung.
+Das ergibt dann eine gängige BionX-Bus Verlängerung. Das Kabel dann in der Mitte
+auftrennen und die 3 CAN-Adern durchtrennen und an den Sub-D stecker löten.
+
+          HR-30      Sub-D      HR-30
+-------------------------------------
+CAN LOW:  2   ....   2   ....   2
+CAN GND:  4   ....   3   ....   4 (Abschirmung)
+CAN HI:   6   ....   7   ....   6
+