From e274309d9293777aaaecebccaa29a339a05bd4f9 Mon Sep 17 00:00:00 2001 From: Emanoil Kotsev Date: Mon, 12 Nov 2018 21:18:37 +0100 Subject: Based on KDE3 bluez4 version a TDE bluez5 version was created Signed-off-by: Emanoil Kotsev --- doc/en/CMakeLists.txt | 16 ++++ doc/en/bemused.docbook | 10 +++ doc/en/components.docbook | 15 ++++ doc/en/concepts.docbook | 85 ++++++++++++++++++++ doc/en/credits.docbook | 55 +++++++++++++ doc/en/developers.docbook | 25 ++++++ doc/en/download.docbook | 16 ++++ doc/en/faq.docbook | 21 +++++ doc/en/handsfree.docbook | 15 ++++ doc/en/index.docbook | 164 +++++++++++++++++++++++++++++++++++++++ doc/en/installation.docbook | 77 ++++++++++++++++++ doc/en/introduction.docbook | 24 ++++++ doc/en/irmcsynckonnector.docbook | 109 ++++++++++++++++++++++++++ doc/en/kbluelock.docbook | 10 +++ doc/en/kbtobexsrv.docbook | 49 ++++++++++++ doc/en/kbtserialchat.docbook | 44 +++++++++++ doc/en/khciconfig.docbook | 10 +++ doc/en/links.docbook | 27 +++++++ doc/en/news.docbook | 4 + doc/en/othertools.docbook | 31 ++++++++ doc/en/tdebluez.docbook | 53 +++++++++++++ doc/en/tdeio_bluetooth.docbook | 41 ++++++++++ doc/en/tdeio_obex.docbook | 61 +++++++++++++++ doc/en/tdeioclient.docbook | 8 ++ 24 files changed, 970 insertions(+) create mode 100644 doc/en/CMakeLists.txt create mode 100644 doc/en/bemused.docbook create mode 100644 doc/en/components.docbook create mode 100644 doc/en/concepts.docbook create mode 100644 doc/en/credits.docbook create mode 100644 doc/en/developers.docbook create mode 100644 doc/en/download.docbook create mode 100644 doc/en/faq.docbook create mode 100644 doc/en/handsfree.docbook create mode 100644 doc/en/index.docbook create mode 100644 doc/en/installation.docbook create mode 100644 doc/en/introduction.docbook create mode 100644 doc/en/irmcsynckonnector.docbook create mode 100644 doc/en/kbluelock.docbook create mode 100644 doc/en/kbtobexsrv.docbook create mode 100644 doc/en/kbtserialchat.docbook create mode 100644 doc/en/khciconfig.docbook create mode 100644 doc/en/links.docbook create mode 100644 doc/en/news.docbook create mode 100644 doc/en/othertools.docbook create mode 100644 doc/en/tdebluez.docbook create mode 100644 doc/en/tdeio_bluetooth.docbook create mode 100644 doc/en/tdeio_obex.docbook create mode 100644 doc/en/tdeioclient.docbook (limited to 'doc/en') diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt new file mode 100644 index 0000000..9456e01 --- /dev/null +++ b/doc/en/CMakeLists.txt @@ -0,0 +1,16 @@ +################################################# +# +# (C) 2018 Emanoil Kotsev +# deloptes (AT) gmail.com +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# +#KDE_LANG = en +#KDE_DOCS = kdebluetooth + +tde_create_handbook( DESTINATION tdebluez ) + +#tde_create_handbook( LANG de DESTINATION tdebluez ) \ No newline at end of file diff --git a/doc/en/bemused.docbook b/doc/en/bemused.docbook new file mode 100644 index 0000000..0e968c9 --- /dev/null +++ b/doc/en/bemused.docbook @@ -0,0 +1,10 @@ + +Bemused Server: Control your media player with your phone + +The KDE documentation for this component is still being developed. Meanwhile, please visit the Bemused homepage for more information. + + +If you have any questions about it or if you want to complain about the missing documentation, send email to Alex Ibrado. + + + diff --git a/doc/en/components.docbook b/doc/en/components.docbook new file mode 100644 index 0000000..5df0061 --- /dev/null +++ b/doc/en/components.docbook @@ -0,0 +1,15 @@ + +Components +&components.tdebluez; +&components.tdeio_bluetooth; +&components.tdeio_obex; +&components.tdeioclient; + + + + +&components.handsfree; + + + + diff --git a/doc/en/concepts.docbook b/doc/en/concepts.docbook new file mode 100644 index 0000000..a0f2bf7 --- /dev/null +++ b/doc/en/concepts.docbook @@ -0,0 +1,85 @@ + +Concepts + + +Bluetooth security: Pairing devices + + +What is "Pairing"? + +Very often it is required for a device to authenticate iself when it +wants to access a service. In that case the two devices needs to be +paired. +When two devices are paired, they can be sure about the identity of the other +party. Without pairing, you would have to rely on the address or name of +the other device, which can be faked easily. + + +Pairing usually happens one time between two devices. After pairing, connections +between the two devices will be authenticated automatically. + + +Usually the pairing process will be started automatically when it is needed. +You do not have to worry about a device not being paired if you want to access its services. +If they try to authenticate, but fail, the pairing process will be started automatically. + + + + +How does it work? + + +Devices are paired to be sure about the identity of the other side. But the +first step can't be done automatically. You have to make +sure that you know who wants to pair with your device. This is done by entering +a "PIN" number in both devices. The notion "PIN" is widely used, but misleading. +It is not the type of PIN you have to enter to get money from a cash machine. +You don't have to remember it. And after (!) the pairing is done you don't have to +keep it secret. You only have to make sure that nobody else knows that number +until you (or you two) entered this number in each device. + + +To be on the safe side, you should not only keep the PIN secret during the pairing +process, but you should also use a random number, which can't be guessed easily. +TDE Bluetooth assists you here by creating a 8-digit random number itself if possible. +You can also use characters for a pin, but then you might have problems entering +it into the pin dialog on a mobile phone. + + + + +The PIN helper + +But where should the pin be entered? As it was noted before, the devices will simply +ask you for the PIN when is is needed. For BlueZ, things are a bit more complicated. +There are several ways for BlueZ to get the PIN number from the user. + + +TDE Bluetooth makes it simple by offering Authentication Agent that interacts with the +bluetooth subsystem and offers dialogs to confirm or fill in PIN. +Please see the setup instructions on how to set +up the pin helper and what to do if it doesn't work. + + + + +Managing paried devices + +After you have paired many devices you might ask yourself which devices are paired and which one not. You also may want to remove a pairing. + + +First, no device can ever know for sure with which devices it is paired. When two devices are paired, they share a secret link key, which was created during the paring process based on the pin number and some other ingredients. Because the other side may decide to delete a link key without notice, haveing a link key for a given device doesn't guarantee that the link key on the other side still exists. If one link key is gone, the pairing does not exist anymore. Of course you can be sure that you are not paired with a device if you don't have a link key for it. + + +So how can link keys be removed? That depends on the device. Most phones or PDAs have a list of "paired" or "trusted" devices, where you can remove single item from somehow. +In TDE Bluez you can remove the device by using the "Devices..." and then select and delete the device. + + +There is as special annoyance involved, when you frequently switch between different operating system which both use bluetooth (Linux<->Windows usually): When you pair your phone under Linux and then boot Windows, Windows will know nothing about the link keys managed by Bluez. So it appears as if the computer has dropped the link key and you will have to pair again. Depending on your device it might not even be possible to pair again without removing the "old" link key on the device before. + + + + + + + diff --git a/doc/en/credits.docbook b/doc/en/credits.docbook new file mode 100644 index 0000000..24e91a6 --- /dev/null +++ b/doc/en/credits.docbook @@ -0,0 +1,55 @@ + + +Credits and License + + +&The.framework; + + +Program copyright 2003,2004,2020 &The.framework; team + + +Team Members: + + + + +Fred Schättgen kde.sch@ttgen.net + + + + +kbluetoothd +tdeio_bluetooth +tdeio_sdp +kbtserialchat +kbthandsfree (disabled in 1.0) +kcm_kbluetoothd +bemused server +libkbluetooth +kioclient +kbtsearch + + + + + + + + +Documentation Copyright © 2004 Fred Schättgen kde.sch@ttgen.net + + +Documentation Copyright © 2020 &Emanoil.Kotsev; &Emanoil.Kotsev.mail; + + + + + +&underFDL; +&underGPL; + + diff --git a/doc/en/developers.docbook b/doc/en/developers.docbook new file mode 100644 index 0000000..31a5d65 --- /dev/null +++ b/doc/en/developers.docbook @@ -0,0 +1,25 @@ + +Developer Information + + +TDEBluetooth +This section describes how to utilize tdebluez for your own application or access it from scripts to retrieve cached device names or similar. + + + +The tdebluez library + +The library provides access to the implementation of the DBus interfaces specified in the kernel documentation. + + + + +The tdeobex library + +The library provides access to the implementation of the DBus interfaces specified in the kernel documentation the kernel documentation. + + + + + + diff --git a/doc/en/download.docbook b/doc/en/download.docbook new file mode 100644 index 0000000..719aff7 --- /dev/null +++ b/doc/en/download.docbook @@ -0,0 +1,16 @@ + +Getting &the.framework; + +Sources + +&The.framework; is part of TDE - the Trinity Desktop Environment. +You can download and compile the the sources yourself, but we recommend using a package for your distribution. + + + +Or you find the source code in the git repository. + + + + + diff --git a/doc/en/faq.docbook b/doc/en/faq.docbook new file mode 100644 index 0000000..e60263f --- /dev/null +++ b/doc/en/faq.docbook @@ -0,0 +1,21 @@ + +Questions and Answers + + + + +My problem isn't listed in this FAQ. Where else can I get help? + + +You can ask on +Gitea +where you can post your questions and comments or on +gmane.comp.desktop.trinity.devel. +Please look in the archive first before posting, but don't hesitate to ask +us if you didn't find anything helpful. + + + + + + diff --git a/doc/en/handsfree.docbook b/doc/en/handsfree.docbook new file mode 100644 index 0000000..0b6e48f --- /dev/null +++ b/doc/en/handsfree.docbook @@ -0,0 +1,15 @@ + +Dial and talk using your computer + +The handsfree client is an implementation of the Bluetooth handsfree profile. +This protocol is similar to the headset profile, but it provides more +functions than the older headset profile. Originally, the handsfree profile +was designed for use in car handsfree devices, but more and more common +Bluetooth headset support the profile today. + +Modern linux provide ofono as modem manager. For the moment it is possible to +connect the HFP and use external ofono frontends for managing calls. + + + + diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..de24b01 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,164 @@ + +The TDE Bluetooth framework"> + the TDE Bluetooth framework"> + TDE"> + + + FredSchättgen"> + kdebluetooth@0xF.de"> + EmanoilKotsev"> + deloptes@gmail.com"> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + + + + +&The.framework; Handbook + + + + +&Fred.Schaettgen; + +
kde.sch@ttgen.net
+ + + + +&Emanoil.Kotsev; + +
&Emanoil.Kotsev.mail;
+ + + + + + + +2004 +&Fred.Schaettgen; + + + +2020 +&Emanoil.Kotsev; + + + +&FDLNotice; + + + +2020-07-27 +1.0 + + + + + +This is an overview over the TDE Bluetooth Framework. The framework +is a package of several tools and infrastruture for TDE, which are +usually used to communicate with bluetooth devices such as mobile phones +or PDAs. It is built on top of BlueZ 5, the official Bluetooth stack for Linux. + + + + + + +TDE +tdenetwork +tdebluez +Bluetooth +Rfcomm +BlueZ +OBEX +Sync + + + + + + +&introduction; + +&news; + +&download; + +&installation; + +&components; + +&concepts; + +&faq; + +&developers; + +&links; + +&credits; + +&documentation.index; + + diff --git a/doc/en/installation.docbook b/doc/en/installation.docbook new file mode 100644 index 0000000..4df17a1 --- /dev/null +++ b/doc/en/installation.docbook @@ -0,0 +1,77 @@ + +Installation + + +Requirements + +Dependencies: + + + +TDE >=14.0.9 + + +Openobex >=1.5 + + +TQt >=14.0.9 + + +bluez5 >=5.14 + + + + + + + +Compilation and Installation + +Create build directory and "cd build". + + +Run cmake .. + + +make install + + + + + +Setup + +The TDE Bluetooth Framework itself does not need any setup. + + + +Use hciconfig and sdptool to check low level if needed: + + +root:~# hciconfig <- Check if adaptor was found and is up +hci0: Type: USB + BD Address: 00:10:60:A3:8B:DE ACL MTU: 192:8 SCO MTU: 64:8 + UP RUNNING PSCAN ISCAN AUTH ENCRYPT + RX bytes:176023 acl:2046 sco:0 events:1809 errors:0 + TX bytes:23000 acl:971 sco:0 commands:469 errors:0 + +root:~# hcitool inq <- Try to seach for other discoverable devices +Intquiring ... + 00:A0:32:1A:B0:27 clock offset: 0x122b class: 0x000100 + +root:~# sdptool browse FF:FF:FF:00:00:00 +Browsing FF:FF:FF:00:00:00 ... +Service Name: SDP Server +Service Description: Bluetooth service discovery server +Service Provider: BlueZ +Service RecHandle: 0x0 +... +root:~# + + +The first command checks if your bluetooth device is up, the second searches for +other devices in range (they must be set to be discoverable). The last command lists the services that are offered by you to other bluetooth devices. If you have tdebluez running already, you will get the full list of active services here, including obex push etc. If that succeeds you should be able to use tdebluez without any further setup. + + + + diff --git a/doc/en/introduction.docbook b/doc/en/introduction.docbook new file mode 100644 index 0000000..04aa88d --- /dev/null +++ b/doc/en/introduction.docbook @@ -0,0 +1,24 @@ + +Introduction + + + + +The TDE Bluetooth Framework is a set of tools built on top of Linux' +Bluetooth stack BlueZ. Our goal +is to provide easy access to the most common Bluetooth profiles and to make +data exchange with Bluetooth enabled phones and PDAs as straightforward as +possible. + + +The next chapters will explain how to set up tdebluez as a whole; the +following chapters deal with each of the tools, how to use them and how +to set up each of them. + + +Have fun :] + + diff --git a/doc/en/irmcsynckonnector.docbook b/doc/en/irmcsynckonnector.docbook new file mode 100644 index 0000000..c295b70 --- /dev/null +++ b/doc/en/irmcsynckonnector.docbook @@ -0,0 +1,109 @@ + +IrMCSync Konnector for Kitchensync + +This program is a Konnector plugin for kitchensync, it let you sync your device supporting IrMCSync with your local Calendar and/or AddressBook. + + +By now Calendar and AddressBook are supported! + + +I SUGGEST YOU TO MAKE A COPY OF YOUR CALENDAR AND ADDRESSBOOK BEFORE TRYING ANY SYNC. +I'm not responsible if your data will be corrupted or destroyed. + + + + +We need debug infos! + +PLEASE run kitchensync from a shell or redirect stdout and stderr to a file so if you have problems you can send me the konnector output.To enable the debug features you can launch "kdebugdialog" and set on the kitchensync related options (from 5200) and the generic option. + + + + +Compilation. + +The actuall kitchensync from tdepim SVN has more features and work better than the tdepim 3.3.0 version. +I'll suggest to use this version. You have to install at least kitchensync (and all his subprojects) from SVN. + + +There's also a tdepim-3.3.0 version that you can find in the irmcsync_tdepim_3_3_branch but it's not mantained anymore. I'll concentrate my work on the SVN one. +This version depends on tdepim-3.3.0 and the older or younger versions, so you have to get and install it. +If you want to fetch the irmcsync_tdepim_3_3_branch you have to move to +kdebluetooth/irmcsync/irmcsynckonnector and type: + +cvs -f -z3 -q update -d -P -r irmcsync_tdepim_3_3_branch + + + +To enable the compilation of the konnector you have to add the "irmcsync" dir in the SUBDIR variabile of kdebluetooth/Makefile.am + + + + +Using KitchenSync. + +In these days (25/03/2004) KitchenSync is very experimental so you can get various problems. + + +After having launched it, you have to choose the konnectors to use. +you need at least 2 konnector to make a sync, but you can use only one for tests pourpose. + + +To add a konnector go in Settings->Configure Kitchensync + + +If you get some errors and the widget is now well painted try resizing the configure window. Then in the Resources Combobox you'll get various chooses, ALL ARE UNUSEFUL AND DISABLED, only "konnector" is the right. + + +For Example you can add the IrMCSync Konnector and a Local Konnector. + + +In the IrMCSync Konnector select your device, and check the Sync Calendar CheckButton or the AddressBook (for now you can't sync both at the same time). In the Local Konnector Select a Calendar File AND a KAddressBook file (you have to choose both and with right filenames or it will not work). I suggest you to create a temp directory in which you put a copy of you original AB and Calendar so you can make some tests. + + +You can find them usually in these dirs: + + +CALENDAR: $HOME/.kde/share/apps/korganizer/std.ics + + +ADDRESSBOOK: $HOME/.kde/share/apps/tdeabc/std.vcf + + +Then you have to create a profile in Settings->Configure Profiles and for every profile you can add various parts, every part do a different function: + + + + +Synchronize Part : Make the REAL Sync. + + + + +Konnector Debugger: Let you Debug a Konnector. + + + + +Konnector Backup : Make the backup of the data. + + + + +Overview Part : Like the name says. + + + + + +If you want to sync, you have to choose at least the "Synchronize Part". + + +Then, to make the sync, click on the top-left button. + + +You can check the konnector, creating a profile with the Konnector Debugger Part and pressing the Connect Device, then the ReadSyncees button. + + + + diff --git a/doc/en/kbluelock.docbook b/doc/en/kbluelock.docbook new file mode 100644 index 0000000..9150a51 --- /dev/null +++ b/doc/en/kbluelock.docbook @@ -0,0 +1,10 @@ + +Automatic screen unlocker + +There is no documentation for this component. + + +If you have any questions about it or if you want to complain about the missing documentation, send a mail to Mattia Merzi. + + + diff --git a/doc/en/kbtobexsrv.docbook b/doc/en/kbtobexsrv.docbook new file mode 100644 index 0000000..629c7f5 --- /dev/null +++ b/doc/en/kbtobexsrv.docbook @@ -0,0 +1,49 @@ + +OBEX Push Server: Receive files + +Most Bluetooth-enabled cell phones or PDAs will let you send +files from the mobile to your computer. While it might be more +comfortable to use the OBEX FTP tdeioslave +to pull the files from your phone to your computer, not all devices +support this. OBEX Object push on the other hand is supported by most +Bluetooth devices. + + + +Using the OBEX Push server + +The OBEX Push server is managed by kbluetoothd and will be automatically +started if it is enabled and someone tries to send you some files. +Please see the documentation of kbluetoothd for how to +enable or disable +services (The OBEX Push server is listed as kbtobexsrv). + + +When you send a file from your mobile to your computer, the kbluetoothd +tray icon will turn blue and shows a small popup. By default (depending +on your +settings for incoming connections) you will have to accept the +connection first, then the main OBEX Push window should pop up +and start receiving the files. + + +Incoming files are saved to /tmp and will be deleted +after you closed the OBEX Push server. To save to files, you have two options: + + + +Click OK to save all received files to +a predefined location. + + + +Drag one or several files to some other location. This is especially useful +if you want to send files by email, since you can drag the files +directly into kmail without saving them to temporary location first. + + + + + + + diff --git a/doc/en/kbtserialchat.docbook b/doc/en/kbtserialchat.docbook new file mode 100644 index 0000000..9f1c4a6 --- /dev/null +++ b/doc/en/kbtserialchat.docbook @@ -0,0 +1,44 @@ + +kbtserialchat: A very simple chat tool + +The kbtserialchat tool is a very simple chat client&server. +Its primary purpose is for debugging and to serve as an example on how to +write a bluetooth server that is managed by kbluetoothd +and how to write a client that can be started with the +SDP tdeioslave. + + + +Using the chat tool + +kbtserialchat implements the Serial Port protocol, +so when you start it, it will show you all devices which +provide the Serial Port profile. This will include other computers +where the KDE Bluetooth Framework is installed, but also +phones which support this profile. + + +When you are connecting to another kbtserialchat server, then +kbtserialchat will pop up on the other system and you +can happily send each other stupid text messages. +You can also connect to the serial port of Bluetooth phones +and send arbitrary AT-commands. To dial a number for instance, type +ATD<number>;. + + +While it may not make much sense to connect kbtserialchat to +a serial port of a device that uses it to exchange binary +data, you can use it not only to connect to serial port services, but +to every service that's based on Rfcomm, like the handsfree or headset +profile. Since these services are not listed in the dialog on startup, +you can use the following trick: +Browse the services of a device with tdeio_sdp (using a sdp:/-URL). +Then instead of simply clicking on the service, right-click on it and +then select Open with.... +Enter kbtserialchat in the dialog, press enter - and +you're connected. + + + + + diff --git a/doc/en/khciconfig.docbook b/doc/en/khciconfig.docbook new file mode 100644 index 0000000..7956335 --- /dev/null +++ b/doc/en/khciconfig.docbook @@ -0,0 +1,10 @@ + +khciconfig: Explore your Bluetooth configuration + +There is no documentation for this component. + + +If you have any questions about it or if you want to complain about the missing documentation, send a mail to Mattia Merzi. + + + diff --git a/doc/en/links.docbook b/doc/en/links.docbook new file mode 100644 index 0000000..f1f0eb5 --- /dev/null +++ b/doc/en/links.docbook @@ -0,0 +1,27 @@ + +Links + + + +Other projects and documentation + + +BlueZ +This is the official Bluetooth Stack for Linux +and the base for tdebluez. + + + + +Linux BlueZ API +This is the official Linux API and the base for the dbus implementation. + + The implementation is done by using dbusxml2qt3 to generate the interfaces. + + + + + + + + diff --git a/doc/en/news.docbook b/doc/en/news.docbook new file mode 100644 index 0000000..f5b3351 --- /dev/null +++ b/doc/en/news.docbook @@ -0,0 +1,4 @@ + +News + + \ No newline at end of file diff --git a/doc/en/othertools.docbook b/doc/en/othertools.docbook new file mode 100644 index 0000000..526c3eb --- /dev/null +++ b/doc/en/othertools.docbook @@ -0,0 +1,31 @@ + +Additional Integration- and Command Line Tools + +This sections lists all the other smaller tools and script that come +with tdebluez. Most of them are of limited use alone, but supposed +to be called from within scripts or by other programs. + + + +tdeioclient: Access to the TDEIO OBEX framework + +This is a little utility to access tdeioslaves from the command line. +So tdeioclient is actually a general purpose utility. + + +With tdeioclient you can copy, list, delete any +file or directory which is accessible by TDE's TDEIO Framework. You can +copy a file from a FTP server directly to another server using WebDAV +or list a directory via SSH with tdeio_fish. Or - and that's where it +becomes interesting for us - you can access files on your mobile phone +via tdeio_obex. + + +Please note that tdeioclient - even though it is a command line program - still needs to be + run from within KDE, so you won't be able to use it in cronjobs for instance. + + + + + + diff --git a/doc/en/tdebluez.docbook b/doc/en/tdebluez.docbook new file mode 100644 index 0000000..fcb849c --- /dev/null +++ b/doc/en/tdebluez.docbook @@ -0,0 +1,53 @@ + +tdebluez: The Core of the TDE Bluetooth Framework + +TDEBluetooth is a central piece of the TDE Bluetooth framework. It runs all the time in the system tray usually and starts other services like the OBEX Server or +the authentication agent. Its system tray icon tells you about ongoing bluetooth connections and +also gives you quick access to the service configuration, recently used services, devices in range +and more. + + +Programmers who want to integrate their program with tdebluez, should take a look at the developers section for more information. + + + +Starting tdebluez + +You can start TDEBluetooth by typing tdebluez on +the command line or by starting it from the TDE-Menu (usually System/tdebluez). + + + +TDEBluetooth displays and icon in the system tray. + + +When tdebluez is running until the system is shut down, it will be started again automatically next time you log in. To keep tdebluez from starting up automatically, uncheck the "Auto Start" option in the configuration. + + + + + +What tdebluez does + +The goal of tdebluez is to provide user interface and interoperability to the Trinity Desktop Envitonment. The user is able to perform bluetooth related operations such as power on/off, discover, pair and connect varios bluetooth devices. + + + + +Configuring tdebluez + +tdebluez writes its configuration in ~/.trinity/share/config/tdebluezrc +Configuration-> + + + +Local Services + +Services can be enabled and disabled in Configuration-> + + + + + + + diff --git a/doc/en/tdeio_bluetooth.docbook b/doc/en/tdeio_bluetooth.docbook new file mode 100644 index 0000000..0a3d7cf --- /dev/null +++ b/doc/en/tdeio_bluetooth.docbook @@ -0,0 +1,41 @@ + +Bluetooth-tdeioslaves: Devices and services + +The bluetooth-tdeioslaves let you handle bluetooth devices and +list and use their services with konqueror (or any other file manager that can +use TDE's File IO framework). + + +Using the Bluetooth tdeioslves +To search for devices, simply enter +bluetooth:/ with konqueror. You will immediately +see an entry for your own system. + + +You can also click the Bluetooth-Icon in the konqueror sidebar in +the "Services"-tab, next to the LAN- and Audio-CD-Browser. +If you can't see the icon it might help to reset the sidebar +with config-button -> Add new -> Rollback to system default + + +The devices must have been detected and paired, so that the slaves can communicate with them. + + +When you select a device you will get a listing of the services +published by the device. If the service is supported by tdebluez, +you can click it to launch the appropriate application. +Unless you've disabled it, konqueror will pop up the common file-open-dialog. +In case the service is not known, you will get an open-with-dialog instead. + + + + +Current limitations +tdeio_bluetooth has no support for nested browse groups currently. This won't +be hard to add, but wasn't need so far. + +You can not connect to services of your own system. + + + + diff --git a/doc/en/tdeio_obex.docbook b/doc/en/tdeio_obex.docbook new file mode 100644 index 0000000..c58a299 --- /dev/null +++ b/doc/en/tdeio_obex.docbook @@ -0,0 +1,61 @@ + + OBEX-tdeioslave: Browse folders over Bluetooth + + + General + The OBEX protocol is designed for use with mobile devices. If you have "beamed" already a vcard from a mobile device to an other mobile device, you have used OBEX. But there are also other applications for the OBEX protocol. Most notably the filesystem browsing protocol. If the mobile device understands this protocol, you can browse, up and download files to your mobiles filesystem storage using this client implementations. Also syncronisation protocols like IrMCSync or SyncML have OBEX bindings and can be accessed using this client, even if there is no usage for syncronisation in konquerror. + OBEX protocols can use many different transports. The original transport was IrDA, but there also exsist transport bindings for Bluetooth, serial lines and tcp/ip connections. + OBEX supports 2 way authentication. The first, most known way, is authentications of the client by the server. So the server implementation can verify the clients identity. But also the client can verify the servers identity. For authentication a MD5 checksum challenge is used. This enshures that plain passwords are never sent over the transport medium. + + + + URL format + OBEX resources are accessed using URLs. The protocol part is clearly obex: The path component holds the path on the server. The host part is a bit mor complex. + For servers accessible over tcp/ip the host part is as usual. You can use the hostname or ip address of the server host to contact. Also If the server runs on a non standard port (the standard port is 650) you can append the port number as usual. + Example: + OBEX://hostname:port/path + For IrDA or Bluetooth transports you can use the hardware address in the standard notation with octets separated by double colons. Neat, but a bit difficult to remember the hardware address of your Bluetooth device. + Example: + obex://[ef:01:23:45]/path + or + obex://[12:34:ef:01:23:45]/path + Therfore it is possible to define hostaliases for use with the OBEX protocol. These aliases are defined in the OBEX KControl module. You can set up a human readable name, discover devices and finally assign a hardware address to that name. Also Devices ober serial transports are accessible via those aliases. For IrDA and Bluetooth there are handy predefined aliases named irda or bluetooth. Both do device discovery and try to connect to the first device it finds. + Good luck browsing your neighbor's mobile :)) + + + + Tips & Tricks + + Like every other tdeioslave, you can directly open and save files to bluetooth + devices with tdeio_obex. So if you write a shopping list for instance, you can + simply type it with kedit and save it on your phone. + + + You can make this procedure must faster by adding a bookmark to the + bookmark list of the file-save-dialog. + + + + + Limitations + + + OBEX and TDE + Since a tdeioclient can't control the number of slave which are accessing the same destination it is often the case that there are multiple slaves running. But OBEX transports, except the tcp/ip transport, support only one transport connection to the device. This leads to tdeioslaves which fail to connect with "Device or resource Busy". OBEX has a partial solution for that problem. If the server supports this, one can transmit packets for multiple connections on one transport connection. But, I have not seen a device which announced this feature. And this would require a separate transport daemon for each destination. So, if I see devices providing this feature, I will start to implement that daemon. + There is no special method to rename or move a file on the device. So this is done by copying the data from and to the device. This is slow and will start two tdeioslaves which will have the problem described above. + + + + Device compatibility + Since this client implements an open standard There is a real hope that there are much devices out there that will work well. But there are always exceptions. + + + + diff --git a/doc/en/tdeioclient.docbook b/doc/en/tdeioclient.docbook new file mode 100644 index 0000000..0645d80 --- /dev/null +++ b/doc/en/tdeioclient.docbook @@ -0,0 +1,8 @@ + +OBEX Push Client + + What is this? + tdeioclient is a program that let you send files from your PC to any bluetooth device that support the OBEX (Object Exchange) Protocol. This Protocol is supported (probably) by all the older bluetooth cellular phones, palms and of course another PC with a bluetooth device (and possibly tdebluez installed!!!). + + + -- cgit v1.2.1