Changes between Initial Version and Version 1 of Software/Gateway


Ignore:
Timestamp:
08/31/10 16:51:38 (14 years ago)
Author:
art
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Software/Gateway

    v1 v1  
     1 
     2== IBus Gateway == 
     3OpenBM-Gateway is a linux daemon running in the background and acting as a gateway between BMW's IBus and local network TCP stack. In this case an IBus interface is connected to the PC's serial port. The interface must support CTS line. Hence some hardware collision detection, or at least a simple bit comparator must be implemented. This function is provided for example by the [http://www1.futureelectronics.com/doc/MELEXIS/TH3122.4+KDF-TU.pdf TH3122] ic, which I am also using in this project. 
     4 
     5The software exists as a Debian package for simple installation in my own small repository. In order to install it, either download it directly from the repository or add the repository address into the list of repository servers on your system. Currently there is only Debian packages available. The package consists of only one executable file. 
     6 
     7The repository where to find the '''openbm-gateway''' package is (or download it [http://projects.tevs.eu/OpenBM/downloads here]): 
     8{{{ 
     9deb http://deb.tevs.eu/ binary/ 
     10}}} 
     11 
     12For information about parameters use 
     13{{{ 
     14openbm-gateway -h 
     15}}} 
     16 
     17 
     18== Features == 
     19 - low CPU and memory usage (one thread per client + 3 server threads) 
     20 - forward IBus messages to connected clients over TCP/IPv4 and vice versa 
     21 - retransmit messages on collision 
     22 - completely asynchronous (receive and send messages over IBus and TCP/IP without blocking or intercepting) 
     23 - can act as a simple IBus logger 
     24 - code is actually platform independent (except of some extensions I had to made for [http://www.boost.org/doc/libs/1_38_0/doc/html/boost_asio.html boost's asio] library). So there is a possibility to implement this on Windows too. 
     25 
     26== IBus logger functionality == 
     27The daemon can also act as a simple IBus logger. This can be usefull if you just want to log ibus messages passend on the bus. In order to run the daemon as simple logger execute it as 
     28{{{ 
     29openbm-gateway -l 4 -f ibus.log 
     30}}} 
     31Which will protocol ibus actions to the ibus.log file. The log file will look like this: 
     32{{{ 
     33... 
     342010-Jul-20 10:07:00.767817: C0 04 68 32 11 8F 
     352010-Jul-20 10:07:00.891897: C0 04 68 32 11 8F 
     362010-Jul-20 10:07:00.928066: C0 04 68 32 10 8E 
     372010-Jul-20 10:07:00.943753: C0 04 68 32 10 8E 
     382010-Jul-20 10:07:01.116929: C0 03 68 01 AA 
     392010-Jul-20 10:07:01.140001: 68 04 BF 02 00 D1 
     40... 
     41}}} 
     42Note there is currently no analysis going on, just a simple logging.  
     43 
     44== TCP/IPv4 server == 
     45 
     46 
     47== FAQ ==