# The &kmobiletools; Handbook

Marco
Gulino
marco@kmobiletools.org
2007
Marco Gulino
&FDLNotice;
2007-04-29
1.01.00

&kmobiletools; is an application specially designed to manage mobile phones.

KDE
pim
kdepim
mobile
phone

## Introduction

&kmobiletools; is a program that lets you manage mobile phones.

It handles full SMS control, dialing calls, phonebook, and phone status monitoring. It's also integrated with the &kde; environment, so it can be embedd in &kontact;, or import/export from and to &kaddressbook;.

&kmobiletools; is completely modular: the main program can load so called "Engines" which can support different range of devices. Each engine also has a set of wizard pages, so that the user is guided in adding new devices.

- AT Engine has been tested on Motorola, Nokia, Siemens, Sony Ericsson and LG mobile phones. Anyway each AT Command compliant device should be well supported. It allows the user to upload and download the phonebook, view SMS stored on the phone, and write new ones. It also can dial numbers and display phone parameters.

- Gammu Engine uses Gammu as backend to connect to the mobile phone, and so the list of supported phones can be found in the project homepage ( or ). It has almost the same features than the AT Engine, and even something more, but it is younger and less tested. It also supports a smaller list of mobile phones.

&kmobiletools; homepage can be found on . There you will find user documentation, a support forum and contact informations.

## Getting Started

This chapter is just a short introduction to &kmobiletools; as well as its usage so you can start using it right away. More information on using &kmobiletools; can be found in the Using &kmobiletools; section.

When starting &kmobiletools; for the first time, you will see the welcome homepage.

Here's a screenshot of &kmobiletools; main window

### Wizard

Clicking on the Add new mobile phone device link will launch a wizard that will help you in configuring &kmobiletools; to use your mobile phone.

Here's a screenshot of &kmobiletools; new device wizard

The Mobile Phone Name entry will allow you to choose a friendly name to be displayed in &kmobiletools; for your phone. The field below instead is used to choose the engine that will manage your mobile phone. The next wizard pages will be different for each engine.

## Using &kmobiletools;

This Chapter will show you &kmobiletools; usage in the most common tasks.

### &kmobiletools; Main Window

The main windows will show you a list of configured phones. It will display also their current status:

- Not Loaded: the engine relative to this mobile phone is not loaded.

- Not Connected: the engine is loaded, but the phone is not found.

- Connected: the engine is loaded, and the phone was found as manageable.

Here's a screenshot of &kmobiletools; main window

### Mobile Phone HomePage

The Mobile Phone Homepage will show you some useful informations about your mobile phone, like the number of messages, contacts, and a brief summary of the calendar. In the status bar you will also see your network operator (when supported), and the level of battery and network signal, plus a visual representation of currently executing tasks.

Clicking on the Phone details link will also show you more advanced informations, like phone manufacturer and model and the IMEI code,

Here's a screenshot of &kmobiletools; device homepage

### Phonebook Management

&kmobiletools; Phonebook Management page contains a list of entries and a html-like page showing details. While the Phone Contacts tab will show you contacts from the current mobile phone, the Other Contacts tab contains items from other devices, and &kaddressbook;.

Clicking an entry will automatically update the details page. In the details page, at the bottom row there will be a list of tasks to handle contacts, creating new items, removing and modifying current ones. You can also right click a contact in the list, and selecting multiple items will work too, when appropriate.

Here's a screenshot of &kmobiletools; phonebook management page

Adding new contacts is easy! You just need to click the Add new link, then choose the name to assign to this contact in the new dialog window appearing. Remember also to add phone numbers entering it in the Phone numbers text box and clicking the Add button after having selected the proper number type in the combo box above that button. You can also choose where you want to save the new contact.

Here's a screenshot of &kmobiletools; phonebook management page

### Short Text Messages Management

The SMS Page is similar to a mail application like &kmail; The left list shows the count of messages and their position, while the right one shows the sender number (or the name, if it is found in the phonebook), the date of the message and the subject. Finally, the page at down will show the message text, plus some actions allowing you to remove messages, or write a new one.

Here's a screenshot of &kmobiletools; sms list page

Clicking the Write New link will pop up a simple dialog window that will guide you in writing a new SMS Message. Just remember to add a recipient first, by both writing the number in the text box or picking it from the phonebook clicking the Browse button, and then the Add button. You will now need to write the message itself in the box below, and then clicking one of the Send or Store buttons.

Here's a screenshot of &kmobiletools; sms list page

## Command Reference

### The main &kmobiletools; window

#### The File Menu

&Ctrl;N File New

  Creates a new document

&Ctrl;S File Save

  Saves the document

&Ctrl;Q File Quit

  Quits &kmobiletools;

#### The Help Menu

&help.menu.documentation;

## Developer's Guide to &kmobiletools;

Programming &kmobiletools; plugins is a joy to behold. Just read through the next 66 pages of API's to learn how!

XtUnmanageChildren
Xt - Geometry Management

### XtUnmanageChildren

remove a list of children from a parent widget's managed list.
4 March 1996

    void XtUnmanageChildren(children, num_children)
        WidgetList children;
        Cardinal num_children;

#### Inputs

children

  Specifies an array of child widgets. Each child must be of class RectObj or any subclass thereof.

num_children

  Specifies the number of elements in children.

#### Description

`XtUnmanageChildren()` unmaps the specified widgets and removes them from their parent's geometry management. The widgets will disappear from the screen, and (depending on its parent) may no longer have screen space allocated for them.

Each of the widgets in the children array must have the same parent.

See the “Algorithm” section below for full details of the widget unmanagement procedure.

#### Usage

Unmanaging widgets is the usual method for temporarily making them invisible. They can be re-managed with `XtManageChildren()`.

You can unmap a widget, but leave it under geometry management by calling `XtUnmapWidget()`. You can destroy a widget's window without destroying the widget by calling `XtUnrealizeWidget()`. You can destroy a widget completely with `XtDestroyWidget()`.

If you are only going to unmanage a single widget, it is more convenient to call `XtUnmanageChild()`. It is often more convenient to call `XtUnmanageChild()` several times than it is to declare and initialize an array of widgets to pass to `XtUnmanageChildren()`. Calling `XtUnmanageChildren()` is more efficient, however, because it only calls the parent's `change_managed()` method once.

#### Algorithm

`XtUnmanageChildren()` performs the following:

-

  Ignores the child if it already is unmanaged or is being destroyed.

-

  Otherwise, if the child is realized, it makes it nonvisible by unmapping it.

#### Structures

The WidgetList type is simply an array of widgets:

    typedef Widget *WidgetList;

## Questions and Answers

&reporting.bugs; &updating.documentation;

My Mouse doesn't work. How do I quit &kmobiletools;?

You silly goose! Check out the Commands Section for the answer.

Why cannot I twiddle my documents?

You can only twiddle your documents if you have the foobar.lib installed.

## Credits and License

&kmobiletools;

Program copyright 2007 Marco Gulino marco@kmobiletools.org

Contributors:

Documentation Copyright © 1999 George N. Ugnacious gnu@kde.org

&underFDL;

&underGPL;

## Installation

### How to obtain &kmobiletools;

&install.intro.documentation;

### Requirements

To use &kmobiletools; you need to properly configure your distribution, try reading documentation in your distribution first. &kmobiletools; needs that you already have the devices created in /dev (manually or with udev), and that you have read/write permissions. You should also ensure that your mobile phone is properly configured.

You can find a list of changes at http://www.kmobiletools.org.

### Compilation and Installation

&install.compile.documentation;

### Configuration

Don't forget to tell your system to start the `dtd` dicer-toaster daemon first, or &kmobiletools; won't work !

&documentation.index;