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