| 1 | Introduction |
|---|
| 2 | ============ |
|---|
| 3 | |
|---|
| 4 | ObexFTP implements the Object Exchange (OBEX) protocols file transfer feature. |
|---|
| 5 | |
|---|
| 6 | The standard is defined in more detail in section K12.5 (Profiles: OBEX FTP) |
|---|
| 7 | in Bluetooth V1.1 Profile Specifications. |
|---|
| 8 | |
|---|
| 9 | ObexFTP works out-of-the-box with all protocols supported by OpenOBEX. |
|---|
| 10 | Currently IrDA and the there is an upcoming BlueTooth support. |
|---|
| 11 | ObexFTP comes with ready to use custom support for some mobile phones serial |
|---|
| 12 | cables. |
|---|
| 13 | |
|---|
| 14 | It's well tested with Siemens (S/ME45 and SL45) as well as |
|---|
| 15 | Ericsson (T68i) mobile phones. |
|---|
| 16 | |
|---|
| 17 | This ObexFTP distribution contains libraries as well as some applications. |
|---|
| 18 | |
|---|
| 19 | Applications to access e.g. Flex. Memory and Multimedia Card memory on Siemens |
|---|
| 20 | mobile equipment, i.e. S45, ME45 and SL42/SL45/SL45i (IrDA only, for now): |
|---|
| 21 | |
|---|
| 22 | - obexls - list the mobiles contents |
|---|
| 23 | - obexcp - copy to/from mobile |
|---|
| 24 | - obexmd - create a directory on the mobile |
|---|
| 25 | - obexrd - remove an empty directory on the mobile |
|---|
| 26 | - obexrm - remove files on the mobile |
|---|
| 27 | - flexmem - all in one application (heavy on options) |
|---|
| 28 | |
|---|
| 29 | Applications to hack Siemens mobile equipment using datalink cable |
|---|
| 30 | |
|---|
| 31 | - bfb_keysim - simulate key presses on the mobile |
|---|
| 32 | - bfb_eeprom - list and examine the user eeprom on the mobile |
|---|
| 33 | |
|---|
| 34 | Library parts to be used in other applications |
|---|
| 35 | |
|---|
| 36 | - obexftp - high level abstraction of OBEX FTP protocol |
|---|
| 37 | - cobex_pe - cable OBEX for Ericsson phones (i.e. T68i) |
|---|
| 38 | - cobex_bfb - cable OBEX for Siemens phones (i.e. x45, x35, x25) |
|---|
| 39 | - bfb - Siemens mobile datalink cable protocol layer |
|---|
| 40 | |
|---|
| 41 | |
|---|
| 42 | Short Installation Instructions |
|---|
| 43 | =============================== |
|---|
| 44 | |
|---|
| 45 | To compile and install: |
|---|
| 46 | # ./configure |
|---|
| 47 | # make |
|---|
| 48 | # make install (as superuser) |
|---|
| 49 | |
|---|
| 50 | Consider using pedantic error checking: |
|---|
| 51 | CFLAGS="$CFLAGS -Werror" ./configure |
|---|
| 52 | |
|---|
| 53 | |
|---|
| 54 | Further Development |
|---|
| 55 | =================== |
|---|
| 56 | |
|---|
| 57 | If you find this tool useful or actually like it let me know. |
|---|
| 58 | Development will focus on your needs. Currently I know of 20 people |
|---|
| 59 | using this tool (including me). So that proposal is not too |
|---|
| 60 | unfair, see? |
|---|
| 61 | |
|---|
| 62 | This package lacks a full featured GUI. There is some proof of concept |
|---|
| 63 | code for GTK and GNOME-VFS. Somebody needs to work on that or perhaps a |
|---|
| 64 | KDE tool though. |
|---|
| 65 | |
|---|
| 66 | If you are a developer and want to use obexftp library or even |
|---|
| 67 | cobex/bfb library do so. But please keep me informed - I'll send |
|---|
| 68 | you pre-releases. That way your application is able to exploit the |
|---|
| 69 | newest library features. |
|---|
| 70 | |
|---|
| 71 | |
|---|
| 72 | Debugging |
|---|
| 73 | ========= |
|---|
| 74 | |
|---|
| 75 | remove all ObexFTP installations from your system. Build using |
|---|
| 76 | CFLAGS="-DOBEXFTP_DEBUG=5" ./configure |
|---|
| 77 | make |
|---|
| 78 | Start debugging using |
|---|
| 79 | ./apps/obexftp [...] |
|---|
| 80 | |
|---|
| 81 | |
|---|
| 82 | Author and Contact |
|---|
| 83 | ================== |
|---|
| 84 | |
|---|
| 85 | Author: Christian W. Zuckschwerdt <zany@triq.net> |
|---|
| 86 | http://triq.net/obexftp and http://savannah.gnu.org/projects/obexftp/ |
|---|
