shift-shell/README.md

plasma-phone-components
=======================

UI components for Plasma Phone

Test on a development machine
=======================

Dependencies:
* KDE Frameworks 5 setup (plasma-framework and its dependencies)
* oFono https://git.kernel.org/cgit/network/ofono/ofono.git
* voicecall https://github.com/nemomobile/voicecall
* libqofono https://github.com/nemomobile/libqofono
* phonesim https://git.kernel.org/cgit/network/ofono/phonesim.git/
* qml contextkit plugin https://github.com/nemomobile/nemo-qml-plugin-contextkit FIXME: ContextKit is deprecated, battery status should be ported to something else

Phonesim will add a fake phone modem, that can be controlled via a Qt based user interface from
which it will be possible to test various aspects of the phone UI: making calls, receiving, signal strength,
send SMS and so on. It will not generate any real call, but only make the UI think a SIM is working and that
a phone call is in progress.

A tutorial how to start phonesym on a desktop system can be found here:
http://comments.gmane.org/gmane.comp.handhelds.ofono/12178

* edit /etc/ofono/modem.conf, uncomment everything so that it looks like
 [phonesim]
 Driver=phonesim
 Address=127.0.0.1
 Port=12345

* start ofonod as root
* start phonesim
  phonesim -p 12345  -gui  /usr/share/phonesim/default.xml
* from the oFono *source* directory, call /test/enable-modem to bring the modem up, the control UI should come up
* start plasma with plasmashell -w -p org.kde.satellite.phone to start the phone homescreen in a window

Note that the oFono/phonesim part is necessary only if it's needed to test some part specific to telephony
Initial commit 2014-08-06 08:03:54 +00:00			`plasma-phone-components`
			`=======================`

			`UI components for Plasma Phone`
add a brief tutorial on how to start on a desktop tutorial on how to start ofono phonesim as well 2014-11-13 20:29:24 +00:00
			`Test on a development machine`
			`=======================`

			`Dependencies:`
			`* KDE Frameworks 5 setup (plasma-framework and its dependencies)`
			`* oFono https://git.kernel.org/cgit/network/ofono/ofono.git`
			`* voicecall https://github.com/nemomobile/voicecall`
			`* libqofono https://github.com/nemomobile/libqofono`
			`* phonesim https://git.kernel.org/cgit/network/ofono/phonesim.git/`
			`* qml contextkit plugin https://github.com/nemomobile/nemo-qml-plugin-contextkit FIXME: ContextKit is deprecated, battery status should be ported to something else`

			`Phonesim will add a fake phone modem, that can be controlled via a Qt based user interface from`
			`which it will be possible to test various aspects of the phone UI: making calls, receiving, signal strength,`
			`send SMS and so on. It will not generate any real call, but only make the UI think a SIM is working and that`
			`a phone call is in progress.`

			`A tutorial how to start phonesym on a desktop system can be found here:`
			`http://comments.gmane.org/gmane.comp.handhelds.ofono/12178`

			`* edit /etc/ofono/modem.conf, uncomment everything so that it looks like`
			`[phonesim]`
			`Driver=phonesim`
			`Address=127.0.0.1`
			`Port=12345`

			`* start ofonod as root`
			`* start phonesim`
			`phonesim -p 12345 -gui /usr/share/phonesim/default.xml`
			`* from the oFono source directory, call /test/enable-modem to bring the modem up, the control UI should come up`
			`* start plasma with plasmashell -w -p org.kde.satellite.phone to start the phone homescreen in a window`

			`Note that the oFono/phonesim part is necessary only if it's needed to test some part specific to telephony`