Solid/Projects/BlueDevil: Difference between revisions

From KDE Community Wiki
(First instance of bluedevil page)
 
m (Fix some spelling)
 
(28 intermediate revisions by 4 users not shown)
Line 2: Line 2:


description=BlueDevil is the codename for the project which aims to integrate the Bluetooth technology into KDE Frameworks and KDE Plasma Desktop.  
description=BlueDevil is the codename for the project which aims to integrate the Bluetooth technology into KDE Frameworks and KDE Plasma Desktop.  
The project is composed of a few components each of them have they own roadmap and maintainer.|
The project is composed of a few components each of them have they own roadmap and maintainer.
===List of components since 1.0:===
*KDE Bluetooth Agent: Alex Fiestas
*Send File: Alex Fiestas
*kio_obexftp: Alex Fiestas
*kio_bluetooth: Alex Fiestas
*Pairing Wizard: Alex Fiestas
*File receiving: Alex Fiestas
*Control Module: Rafael Fernandez Lopez
*System tray: Rafael Fernandez Lopez|


projectStatus=The version 1.0 considered as stable has been released and will receive updates as minor versions (1.0.1 will be the first).
projectStatus=The version 1.0 considered as stable has been released and will receive updates as minor versions (1.0.1 will be the first).  


The version 1.1 is under a heavy development the roadmap can be found here
The version 1.1 is under a heavy development the roadmap can be found here |


documentation=Currently we're lacking a good End user documentation, help is needed.
documentation=Currently we're lacking a good End user documentation, help is needed. |


howToCollaborate=Bluedeivl is a KDE project, so we use the usual ways to communicate to each other, and to work together. |  
howToCollaborate=BlueDevil is a KDE project, so we use the usual ways to communicate to each other, and to work together. |  


projectPage = Currently BlueDevil is under extragear/base
projectPage = Currently BlueDevil is under extragear/base
Line 16: Line 25:


}}
}}
==Debugging==
BlueDevil is composed by a set of components, some of them are debugged in a completely different way.
===KIO's===
The kio's are the hardest part of BlueDevil to debug:
*Execute kdebugdialog --fullmode
*Select kio_bluetooth or kio_obexftp
*In all 4 sections choose the "File" option, and introduce an output path (for example /home/youruser/kio_obexftp.txt
In case that the bug is reproducible in Konqueror and Dolphin, use the first is preferred.
===KCM===
Try to reproduce the bug only using the affected module. For example in case that the affected module were filetransfer, you should execute:
kcmshell4 bluedevilfiletransfer
To get a complete list you can execute:
kcmshell4 --list | grep bluedevil
===Wizard===
Execute kdebugdialog, search "bluedevil" and activate everything. Then execute bluedevil-wizard in the terminal and provide the output.
===Systray===
Try to reproduce the bug step by step, restarting all BlueDevil (in the KCM)
===Reporting===
And finally, we're using http://bugs.kde.org, search twice before post a new bug. If a developer ask for feedback, and it is not provided within the following 30 days, the bug may be closed.
== Testing before release ==
A set of tests must be done before a new version can be released so we can be quite sure that at least no regressions has been introduced.
[[Solid/Projects/BlueDevil/Tests | Tests page]]
== Releases ==
*[[Solid/Projects/BlueDevil/Releases/1.0.1 | 1.0.1]]


== Roadmap ==
== Roadmap ==
===BlueDevil 1.1 ===
*[[Solid/Projects/BlueDevil/Roadmaps/1.1 | BlueDevil 1.1]]
The focus of 1.1 release will be add more Elegance into BlueDevil, for example by adding a better error hanlding, making things reacting as the user expect etc...
 
There is not a release date for it, but can be expected somewhere close to KDE 4.6 release.
===BlueDevil 1.2 ===
We have one simple objective for BlueDevil 1.2, perfectionism
 
====KDE Bluetooth Agent====
{| class="sortable" border="1" cellpadding="3" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
{{TestFail |Research| Research last "unhandler" method |afiestas@kde.org|Alex Fiestas}}
|}
 
====File receiving====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
{{FeatureProjectTodo |Research| Port to obexd |[email protected]| Alex Fiestas}}
|}
 
====Pairing Wizard====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
|}
 
====Send File====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
|}
 
====kio_obexftp====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
{{FeatureProjectTodo |Improvement| We need to have a better error handling, using the kio interface to report the errors|afiestas@kde.org| Alex Fiestas}}
|}
====kio_bluetooth====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
{{FeatureProjectInProgress |Improvement| Show the configured devices first, and discover in the background |afiestas@kde.org| Alex Fiestas}}
|}
====Control Module====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
{{FeatureProjectTodo |Feature| Add a Connect button in configure devices (like systray has) |ereslibre@kde.org|Rafael Fernandez Lopez}}
|}
 
====System tray====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
{{FeatureProjectTodo |Improvement| Improve way to connect and disconnect services |ereslibre@kde.org| Rafael Fernández López}}
{{FeatureProjectTodo |Improvement| Global disconnect from device (all services and device itself) |ereslibre@kde.org| Rafael Fernández López}}
|}


====File Sharing====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Component !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureInProgress | kio_bluetooth | Show the configured devices first, and discover in the background | alex@eyeos.org | Alex Fiestas}}
{{FeatureProjectDone |Feature|Be able to share folders and files |afiestas@kde.org|Alex Fiestas}}
{{FeatureTodo| kio_obexftp| We need to have a better error handling, using the kio interface to report the errors|[email protected]| Alex Fiestas}}
{{FeatureProjectDone |Feature| Add a KCM to configure/show the shared files
{{FeatureTodo|Pairing Wizard| Use random 8 digit random PIN |alex@eyeos.org| Alex Fiestas}}
|afiestas@kde.org|Alex Fiestas}}
{{FeatureTodo|Pairing Wizard| Detect when a device can introduce the PIN
{{FeatureProjectTodo |Feature| Indicate in dolphin part with an overlay icon the shared files/folders |afiestas@kde.org|Alex Fiestas}}
|[email protected]| Alex Fiestas}}
{{FeatureProjectTodo |Feature| Be able to share folders/files directly from dolphinpart|afiestas@kde.org|Alex Fiestas}}
{{FeatureTodo|Pairing Wizard| Support all Bluetooth pairing modes |[email protected]| Alex Fiestas}}
{{FeatureTodo|KDE Agent| Support all Bluetooth pairing modes |[email protected]| Alex Fiestas}}
{{FeatureDone|systray| Implement a better order in the systray options |
[email protected] | Alex Fiestas}}
{{FeatureDone|systray| Show a overlay icon when a device is connected |  
alex@eyeos.org | Alex Fiestas}}
{{FeatureDone|systray| Add a tooltip | alex@eyeos.org | Alex Fiestas}}
|}
|}

Latest revision as of 19:52, 22 July 2022

How we work

All Solid projects operates in the same way, be sure to read How we work

Description

BlueDevil is the codename for the project which aims to integrate the Bluetooth technology into KDE Frameworks and KDE Plasma Desktop. The project is composed of a few components each of them have they own roadmap and maintainer.

List of components since 1.0:

  • KDE Bluetooth Agent: Alex Fiestas
  • Send File: Alex Fiestas
  • kio_obexftp: Alex Fiestas
  • kio_bluetooth: Alex Fiestas
  • Pairing Wizard: Alex Fiestas
  • File receiving: Alex Fiestas
  • Control Module: Rafael Fernandez Lopez
  • System tray: Rafael Fernandez Lopez

Project Status

The version 1.0 considered as stable has been released and will receive updates as minor versions (1.0.1 will be the first).

The version 1.1 is under a heavy development the roadmap can be found here

Documentation

Currently we're lacking a good End user documentation, help is needed.

How to collaborate

BlueDevil is a KDE project, so we use the usual ways to communicate to each other, and to work together.

Project Page

Currently BlueDevil is under extragear/base KDE Project Page

Mailing list

We're using the kde-hardware-devel mailing list kde-hardware-devel

Debugging

BlueDevil is composed by a set of components, some of them are debugged in a completely different way.

KIO's

The kio's are the hardest part of BlueDevil to debug:

  • Execute kdebugdialog --fullmode
  • Select kio_bluetooth or kio_obexftp
  • In all 4 sections choose the "File" option, and introduce an output path (for example /home/youruser/kio_obexftp.txt

In case that the bug is reproducible in Konqueror and Dolphin, use the first is preferred.

KCM

Try to reproduce the bug only using the affected module. For example in case that the affected module were filetransfer, you should execute: kcmshell4 bluedevilfiletransfer

To get a complete list you can execute: kcmshell4 --list | grep bluedevil

Wizard

Execute kdebugdialog, search "bluedevil" and activate everything. Then execute bluedevil-wizard in the terminal and provide the output.

Systray

Try to reproduce the bug step by step, restarting all BlueDevil (in the KCM)

Reporting

And finally, we're using http://bugs.kde.org, search twice before post a new bug. If a developer ask for feedback, and it is not provided within the following 30 days, the bug may be closed.

Testing before release

A set of tests must be done before a new version can be released so we can be quite sure that at least no regressions has been introduced.

Tests page

Releases

Roadmap

BlueDevil 1.2

We have one simple objective for BlueDevil 1.2, perfectionism

KDE Bluetooth Agent

Status Type Description Contact

bgcolor="#FFABAB" | FAILED

File receiving

Status Type Description Contact
TODO Research Port to obexd <[email protected]>

Pairing Wizard

Status Type Description Contact

Send File

Status Type Description Contact

kio_obexftp

Status Type Description Contact
TODO Improvement We need to have a better error handling, using the kio interface to report the errors <[email protected]>

kio_bluetooth

Status Type Description Contact
IN PROGRESS Improvement Show the configured devices first, and discover in the background <[email protected]>

Control Module

Status Type Description Contact
TODO Feature Add a Connect button in configure devices (like systray has) <[email protected]>

System tray

Status Type Description Contact
TODO Improvement Improve way to connect and disconnect services <[email protected]>
TODO Improvement Global disconnect from device (all services and device itself) <[email protected]>

File Sharing

Status Type Description Contact
DONE Feature Be able to share folders and files <[email protected]>
DONE Feature Add a KCM to configure/show the shared files <[email protected]>
TODO Feature Indicate in dolphin part with an overlay icon the shared files/folders <[email protected]>
TODO Feature Be able to share folders/files directly from dolphinpart <[email protected]>