src/extras/fileserver/README.txt
changeset 0 ca70ae20a155
equal deleted inserted replaced
-1:000000000000 0:ca70ae20a155
       
     1 Python File Server
       
     2 ------------------
       
     3 
       
     4 This package implements a simple file server that makes it possible to
       
     5 update the files on the phone faster than by sending them over OBEX.
       
     6 
       
     7 Disclaimer
       
     8 ----------
       
     9 
       
    10 After connecting the phone to the PC, the PC has the power to execute
       
    11 arbitrary code and to rewrite any file on the phone. It goes without
       
    12 saying that you should connect only to targets that are known to be
       
    13 safe.
       
    14 
       
    15 Prerequisites
       
    16 -------------
       
    17 
       
    18 - PyS60 installed on phone. Any version should work.
       
    19 - Cygwin version of Python 2.4 installed on the PC
       
    20 - Bluetooth connectivity on the PC
       
    21 
       
    22 Usage
       
    23 -----
       
    24 
       
    25 1. Install fileserver.py to the phone as a library, and fsgui.py as a
       
    26 script.
       
    27 
       
    28 2. Add a Bluetooth serial port to the PC. You will probably want to
       
    29 have _two_ BT serial ports available: one for the file server and one
       
    30 for the Bluetooth console.
       
    31 
       
    32 3. Edit the end of fctool so it connects to the correct serial
       
    33 port. /dev/ttyS4 == COM5, /dev/ttyS5 == COM6 etc.
       
    34 
       
    35 4. Place fileclient.py into /lib/python2.4/site-packages in your Cygwin
       
    36 environment, and fctool into your PATH.
       
    37 
       
    38 5. Start fsgui.py, and select the serial port you want to use.
       
    39 
       
    40 6. Run "fctool ping". If it says that the file server is alive, all is well.
       
    41 
       
    42 7. Write a synchronization script. An example (dosync) is included.
       
    43 
       
    44 Notes
       
    45 -----
       
    46 
       
    47 The fsgui.py script will store the Bluetooth address and port in the file
       
    48 C:\system\apps\python\fileserver_conf.txt. If Python is installed on other
       
    49 drive than C: then this file is not automatically removed when Python is
       
    50 uninstalled.