| -rw-r--r-- | bin/kdepim/korganizer/howtoSYNC.txt | 333 |
1 files changed, 301 insertions, 32 deletions
diff --git a/bin/kdepim/korganizer/howtoSYNC.txt b/bin/kdepim/korganizer/howtoSYNC.txt index e73709b..ad765d3 100644 --- a/bin/kdepim/korganizer/howtoSYNC.txt +++ b/bin/kdepim/korganizer/howtoSYNC.txt @@ -1,3 +1,3 @@ -NOTE: +WARNING: YOU MAY GET UNEXSPECTED (I.E. WRONG) SYNCHRONIZATION RESULTS, IF YOU CHANGE AN EVENT ON THE FIRST DEVICE AND SYNC IMMEDIATELY FROM @@ -5,4 +5,7 @@ THE OTHER DEVICE WITH THIS DEVICE, IF THE CLOCKS OF THE TWO DEVICES HAVE TOO MUCH DIFFERENCE. +In other words: Please make shure, that the clocks of the devices +you want to sync have only a difference of some seconds! + CONTENT: @@ -13,4 +16,5 @@ CONTENT: 3) Syncing background 4) Sync preferences +5) Details about sync profile kinds ************************************************************************* @@ -18,20 +22,40 @@ CONTENT: ************************************************************************* -In KO/Pi you can synchronize ( sync ) your calendar -with another calendar, by syncing your (local) calendar with a -(remote) file. This remote file may on your local filesystem +Note: +The recommended and easiest way to syncronize two devices where +KO/Pi or KA/Pi is installed, is the profile kind "Pi-Sync". +Details about that in 5) b). + +In KDE-Pim/Pi you can synchronize ( sync ) your calendar/addressbook +with another calendar/addressbook , by syncing your +(local) calendar/addressbook with a (remote) file. +This remote file may on your local filesystem or on another (remote) device. -If it is on another device, you have to specify a + +If you want to sync with another remote device, +you have two create a sync profile. +You have two choices for choosing the profil kind: +I) You have to choose profile kind "Remote file" and to specify a command line download/upload command ( like scp, ftp, ...) to a) download the remote file to your local machine to a temp file b) sync with this temp file c) upload the synced file to the remote device +II) If you want to sync with a device, where KO/Pi( or KA/Pi ) is + installed, you can easily get the remote file via network + with the build in file transfer feature: + Choose profile kind "Pi-Sync" and + a) Start KO/Pi or KA/Pi on remote device and + enable "Pi-Sync" on remote device with password and port. + b) Specify password, port and IP address in your profile. + -You should create for every device, to sync with, a sync profile. +You can sync with your mobile phone as well. +Everything is explained in more details below. NOTE: -Before syncing, it is recommended to close -a running KO/Pi on the remote device. -(Note: KO/Pi running on Zaurus with +If you do not use profile kind "Pi-Sync", +it is recommended to close +a running KO/Pi ( or KA/Pi) on the remote device. +(Note: KO/Pi( or KA/Pi) running on Zaurus with FastLoad enabled will never be closed!) After syncing with a running KO/Pi on the remote device, @@ -44,27 +68,31 @@ you will get the new data showing in remote KO/Pi. ************************************************************************* -a) Open sync settings dialog +a) Open sync settings dialog (Menu Synchronize - Configure...) b) Give your device a unique name. (unique in the set of all devices you want to sync with). If you have already configured another devive and created there a sync profile to sync with this device, give your device - the same name as this sync profile! The same name is important! + the same name as this sync profile! The same name is important, + because it makes it possible to sync first A->B + (A local device, that performs the sync, B remote device) + and then B->A. Such that the B->A sync knows about the + already performed A->B sync. + That means: It is unimportant if you sync A->B or B->A, + the devices A and B will be synced properly. c) Create a new sync profile and give it a unique name. (unique in the set of all sync profiles on this device). If you want to sync with a device, where KO/Pi is already installed and which has a given unique device name, use this device name as - your profile name. + your profile name ( refer to b) ). d) Coose the profile kind of your syncing method: (i) Local file or - (ii) Remote file -c) If you did choose (i), - specify the file name you want to sync with. - If you did choose (ii), - specify the system (command line) - download/upload command of the remote file. -d) Choose the other profile options. - Detailed explanation in 2.) -e) Close sync dialog with OK. -f) Sync. + (ii) Pi-Sync or + (iii) Remote file or + (iiii) Mobile Phone. + Detailed explanation in 5) +e) Choose the other profile options. + Detailed explanation in 2) +f) Close sync dialog with OK. +g) Sync. NOTE: @@ -95,16 +123,25 @@ f) Show summary after sync: Check this to get a small summary dialog after sync about number of added/changed/deleted events on local/remote. -g) Write back existing entries only: - Check this to update the remote calendar only. - I.e. no event/todo from yor local calendar is added to the - remote calendar. You may use this option to - sync against some kind of "public calendar" without - writing back your personal data. -h) Write back file: - Check this to update the local calendar only. +g) Write back synced data: + Uncheck this to update the local calendar only. I.e. your local calendar is synced with the remote calendar but nothing on the remote calendar is changed. -i) Profile kind: - -> 1) d) + If you uncheck "Write back synced data", the settings + under h) and i) are ignored, of course. +h) --Write back (on remote) existing entries only: + Check this to update the remote data only. + I.e. no data from yor local calendar/addressbook is added to the + remote device. You may use this option to + sync against some kind of "public calendar/addressbook" without + writing back your personal data. +i) --Write back (calendar) entries in future only: + Check this to write back only calendar entries in future. + (Useful when syncing with mobile phones.) + You can specify the date range in weeks with + ---- Max. weeks in future. + Note: The date range starts always 7 days before the actual date! + I.e. the calendar events of the last week are written back always. +j) Profile kind: + Details -> 5) ************************************************************************* @@ -112,4 +149,6 @@ i) Profile kind: ************************************************************************* +The same mentioned for calendars is valid for addressbooks as well. + Synchronizing calendars ( i.e. files ) means, to merge two calendars in a useful way. @@ -196,2 +235,232 @@ SYNC PREFERENCES: "Force: Take local entry always" +************************************************************************* +5) Details about sync profile kinds +************************************************************************* + +a) Local file + Please specify a local file you want to sync with. + +b) Pi-Sync (direct Kx/Pi to Kx/Pi sync) + We mention here only KO/Pi, but the same is valid for KA/Pi. + If you want to sync with a device, where KO/Pi is + installed, you can easily get the remote file via network + with the build in file transfer feature "Pi-Sync": + You have first to enable file transfer on the remote device: + - Start KO/Pi on the remote device. + - Choose Menu Synchronize-Enable Pi-Sync. + - Choose a port number, where KO/Pi should listen for + file sending requests. Valid port numbers are numbers + between 1 and 65565. Do not specify port numbers, that are + used by other applications. A port number between 9000 and 9999 + is most likely not used by another application. + The default port number is 9197 for KO/Pi. + If you specify a port number, which is already in use, + you will get an error message when closing this dialog. + - Choose a password. + - Click OK. + Now KO/Pi will send the calendar data via the network, + if some other device is sending a "please send calendar" + request on the given port using the given password. + If you want to be sure, nobody can access your calendar + data, simply disable the file transfer feature on the + remote device after the syncing is done by choosing: + Menu Synchronize-Disable Pi-Sync. + + On your local device, create a new profile and choose + profile kind "Pi-Sync". + Fill in the needed values: + - Password for remote access: + The password you specified on the remote device. + - Remote IP address: + The IP address of the remote device. + - Remote port number: + The port number you specified on the remote device. + + Now you can syncronize your local device easily with your + remote device. This works well for all platforms KO/Pi is + running on, e.g. syncing a KO/Pi on Zaurus with KO/Pi on Windows + is now very easy. + +c) Remote file + Syncing with the profile kind "Remote file" is performed in three steps: + i) download the remote file to your local machine to a temp file + ii) sync with this temp file + iii) upload the synced file to the remote device + + The down-/uploading if i) and iii) is done via a command line command. + Please specify the download/upload command ( like scp, ftp, ...) and the + file name of the temp file in the corresponding fields. + +d) Mobile device (cell phone) + We mention here only KO/Pi, but the same is valid for KA/Pi. + Note: + It is only possible to sync a mobile phone with one particular device + running KO/Pi. If you want to be able to write data of more than one device + to the mobile phone (e.g. from your Zaurus and from your Windows Laptop) + do not sync with the mobile phone at all, but use the + "Export to phone" functionality from the different devices. + Using "Export to phone" makes it not possible to get back data from the + phone, if it was changed there, of course. + If you sync with the phone, do not use "Export to phone" from any device. + (And do not sync, as mentioned above, from any other device with that phone). + It would delete the needed information for syncing with that phone! + + We are using Gammu (Version: 0.98.9) ( http://freshmeat.net/projects/gammu/ ) + for accessing the phones. + Note: You cannot use the original Gammu for syncing KDE-Pim/Pi, because + we have modified the original version to make it useable for syncing! + Gammu allows access to many phones in many ways (Irda, Bluetooth, serial,...). + The recommended phone access using Gammu with KDE-Pim/Pi is Irda (infrared). + Bluetooth access is disabled on the Zaurus, but may work on Windows. + Please look at the Gammu homepage and documentation about more details + configuring Gammu how to access your phone. + If you have problems accessing your phone, start KO/Pi from the konsole + and you will get a more detailed output what went wrong. + About Gammu from the Gammu homepage: + Gammu (formerly known as MyGnokii2) is a cellular + manager for various mobile phones/modems. + It supports the Nokia 2100, 3100, 32xx, 33xx, + 3410, 35xx, 51xx, 5210, 5510, 61xx, 62xx, + 63xx, 6510, 6610, 6800, 71xx, 7210, 7250, + 7250i, 82xx, 83xx, 8910, 9110, 9210 + and compatible and AT devices (Siemens, Alcatel, + Falcom, WaveCom, IPAQ, Samsung, SE, and others) + over cables/infrared/BlueTooth. + + Here is an example what to specify to access a Nokia 6310i via infrared: + On Linux (Zaurus): + I/O device: /dev/ircomm + Connection: irda + Model: <leave empty> + + On Windows: + I/O device: <ignored - i.e. leave empty> + Connection: irda + Model: <leave empty> + + Here is the overview from the Gammu documentation, + how to specify the connection settings for + I/O device: + Connection: + Model: + + Note: The documentation uses the term "port", + where we use the term "I/O device". + Note: You do not have to create/change the gammurc configuration file. + That will do KO/Pi for you. + Note: For a known model, leave "Model:" always empty, + such that Gammu can auto detect the model. + +# This is a sample ~/.gammurc file. +# In Unix/Linux copy it into your home directory and name it .gammurc +# or into /etc and name it gammurc +# In Win32 copy it into directory with Gammu.exe and name gammurc +# More about parameters later +# ----------------------------------------------------------------------------- + +[gammu] + +port = com8: +#model = 6110 +connection = fbusblue +#synchronizetime = yes +#logfile = gammulog +#logformat = textall +#use_locking = yes +#gammuloc = locfile +#startinfo = yes +#gammucoding = utf8 + +[gammu1] + +port = com8: +#model = 6110 +connection = fbusblue +#synchronizetime = yes +#logfile = gammulog +#logformat = textall +#use_locking = yes +#gammuloc = locfile +#startinfo = yes +#gammucoding = utf8 + +# ----------------------------------------------------------------------------- +# Now info about "Connection" parameter and connected with it port type +# (more about port types later) +# ----------------------------------------------------------------------------- +# "Connection" parameter | Port type | More details +# -----------------------|-----------|----------------------------------------- +# "fbus" | serial | Nokia FBUS2 +# "fbusirda"/"infrared" | serial | Nokia FBUS2 over direct infrared device +# "fbusdlr3"/"dlr3" | serial | Nokia FBUS2 with DLR3 cable +# "fbusdku5" | dku5 | Nokia FBUS2 with DKU5 cable. WIN32 ONLY +# "fbuspl2303" | usb | Nokia FBUS2 with USB cable based on +# | | PL2303 chip. +# "fbusblue" | serial | Nokia FBUS2 over Bluetooth serial device +# "phonetblue" | serial | Nokia PHONET FBUS over Bluetooth serial +# | | device +# "mrouterblue" | serial | +# "mbus" | serial | Nokia MBUS2 +# "at19200"/"at115200"/..| serial | AT commands.8 bits, None parity, 1 stop +# | | bit, no flow control +# -----------------------|-----------|----------------------------------------- +# "irdaphonet"/"irda" | irda | Nokia PHONET FBUS over socket infrared +# "irdaat" | irda | AT commands with socket infrared +# "irdaobex" | irda | OBEX over socket infrared. MODEL "obex" +# -----------------------|-----------|----------------------------------------- +# "bluephonet" | BT | Nokia PHONET FBUS with Bluetooth stack +# "bluefbus"/"dlr3blue" | BT | Nokia FBUS2 with Bluetooth stack +# "blueat"/"atblue" | BT | AT commands with Bluetooth stack +# "blueobex" | BT | OBEX with Bluetooth. MODEL "obex" +# +# Now more about port types and connected with it "Port" parameter +# ----------------------------------------------------------------------------- +# Port type | "Port" parameter in Windows/DOS | "Port" parameter in Linux/Unix +# ----------|---------------------------------|-------------------------------- +# serial | "com*:" | "/dev/ttyS*" +# | (example "com1:") | (example "/dev/ttyS1") +# | | or "/dev/tts/**" (with DevFS) +# ----------|---------------------------------|-------------------------------- +# irda | ignored (can be empty) | "/dev/ircomm*" +# ----------|---------------------------------|-------------------------------- +# BT | Bluetooth device address +# | (example "") +# ----------|---------------------------------|-------------------------------- +# dku5 | ignored (can be empty) | connection with it not possible +# ----------|---------------------------------|-------------------------------- +# usb | connection with it not possible | "/dev/ttyUSB*" +# +# Other config parameters +# ----------------------------------------------------------------------------- +# Parameter name | Description +# ----------------|------------------------------------------------------------ +# Model | use only, when Gammu doesn't recognize your phone model. +# | Put it here. Example values: "6110", "6150", "6210", "8210" +# SynchronizeTime | if you want to set time from computer to phone during +# | starting connection. Do not rather use this option when +# | when to reset phone during connection (in some phones need +# | to set time again after restart) +# GammuLoc | name of localisation file +# StartInfo | this option allow to set, that you want (setting "yes") +# | to see message on the phone screen or phone should enable +# | light for a moment during starting connection. Phone +# | WON'T beep during starting connection with this option. +# GammuCoding | forces using specified codepage (in win32 - for example +# | "1250" will force CP1250) or UTF8 (in Linux - "utf8") +# ----------------|------------------------------------------------------------ +# Logfile | Use, when want to have logfile from communication. +# Logformat | What debug info and format should be used: +# | "nothing" - no debug level (default) +# | "text" - transmission dump in text format +# | "textall" - all possible info in text format +# | "errors" - errors in text format +# | "binary" - transmission dump in binary format +# ----------------|------------------------------------------------------------ +# Use_Locking | under Unix/Linux use "yes", if want to lock used device +# | to prevent using it by other applications. In win32 ignored + + + + +
\ No newline at end of file |