INSTALL of gnokii-sync
=======================

REQUIREMENTS
^^^^^^^^^^^^
	OpenSync	>= 0.30		http://www.opensync.org
	gnokii		>= 0.6.15	http://www.gnokii.org

	If you use packages of your distribution don't forget
	to install the -devel packages of above requirements.

INSTALL 
^^^^^^^
	scons prefix=/usr/local install	


CONFIGURATION
^^^^^^^^^^^^^

	Example of a sync pair with kdepim:

	msynctool --addgroup gnokii-kdepim
	msynctool --addmember gnokii-kdepim gnokii-sync
	msynctool --addmember gnokii-kdepim kdepim-sync
	msynctool --configure gnokii-kdepim 1		# first plugin configuration (gnokii-sync)


	(Hint:

	 Instead of FF:FF:FF:FF:FF:FF insert your MAC of your cellphone.
	 You can get your bluetooth MAC of your phone with:

	 	hcitool scan

	 hcitool is part of the bluez-utils)	

	Example config file for a Nokia 6230 via Bluetooth:

	<config>
	  <connection>bluetooth</connection>
	  <port>FF:FF:FF:FF:FF:FF</port>
	  <model>6230</model>
	</config>

	Example config file for a Nokia 6020 via irda:

	[Quick instruction to setup irda connection:]
	 1. modprobe *your irda module*
	 2. modprobe irda-ircomm
	 3. irattach -s /dev/ircomm0
	[End of irda setup. Thanks for this Asuhra !] 
	
	<config>
	  <connection>irda</connection>
	  <port>/dev/ircomm0</port>
	  <model>6510</model>
	</config>

	Example config file for a Nokia 6230 via DKU2 Cable (libusb driver):

	<config>
	  <connection>dku2libusb</connection>
  	  <model>6230</model>
	  <port>dontkillme</port>
	</config>	  

	Example config file for a Nokia Series 60 (6670, ...) via Bluetooth:

	[sdptool browse <MAC> should list the rfcomm channel number] 

	<config>
	  <connection>bluetooth</connection>
	  <port>FF:FF:FF:FF:FF:FF</port>
	  <model>series60</model>
	  <rfcomm_channel>14</rfcomm_channel>
	  <debug>on</debug>
	</config>



TROUBLESHOOTING
^^^^^^^^^^^^^^^

	Synchronization problems:
	========================

		* Read the KNOWN PROBLEMS section

		* Read the TODO section
		
		* set $OSYNC_TRACE to get more detailed information:

			export OSYNC_TRACE=/tmp/gnokii_trace/
			mkdir $OSYNC_TRACE
			# SYNC YOUR DEVICE

		* Add debug config node for gnokii-sync plugin to get 
	          libgnokii debug information:
	  		
			<config>
	      		  ...
			  <debug>on</debug>
  			</config>			  

		

	Connection problems:
	====================
		
	General:
	########

		* try to setup a connection with the command line tool gnokii
		  to check if it is a configuration problem or a plugin problem
	          Example:

			gnokii --identify

		  Should this work the configuration of the gnokii-sync plugin is
		  wrong. Compare model, port, connection of the plugin config and your gnokiirc.

		* otherwise check if your phone is on :P

		* get additional debugging output from libgnokii add <debug> 
		  to your gnokii-sync configuration:
			<config>
				...
				<debug>on</debug>
				...
			</config>	

	Bluetooth:
	##########

		* check if your bluetooth services working and if your 
		  cellphone is in range:
		
			hcitool scan
		  
		  hcitool is part of the bluez-utils package.			

	DKU2 Cable (libusb):
	####################	
		
		* check for permisson for your user. If `gnokii --identify` works as root user
		  then it seems to be a permission problem. Could be solved with additional udev-rules:
		  BUS=="usb", SYSFS{manufacturer}=="Nokia*", SYSFS{product}=="Nokia [0-9]*", MODE="0660", GROUP="users"
		  				                                                               ^^^^^^^^^
													Group of your user(s)
		  
		  
		
		
		
			










HAVE FUN
^^^^^^^^

:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<
:)-\-<
:)->-<
:)-/-<