This page contains my (personal) notes on how Telepathy (and to some degree rtcom) works, in general, and how it works on Fremantle, and how we plan to make it all work.
Accounts are stored in
/home/user/.rtcom-accounts/accounts.cfg on Fremantle, and
HOME/.local/share/telepathy/mission-control/accounts.cfg normally in Telepathy.
It looks like Telepathy mission-control (MC) is the one that actually manages the accounts, and
mc-tool can be used to manage the accounts. This means that likely there are no other tools that read
accounts.cfg on Fremantle, and everything that lists/adds/removes accounts goes through Telepathy MC.
It is not clear to me what adds the initial "sms" account, but there must be something that configures this account initially.
Fremantle logs using the
rtcom-eventlogger package, to a SQLite3 database stored at
/home/user/.rtcom-eventlogger/el-v1.db - all communication related events end up here.
The actual logging to the database is done (as far as I understand) by several different processes:
rtcom-messaging-ui. These both interface with telepathy and log to the database as appropriate. (This is visible by looking at
/proc/pid-of-program/fd on Fremantle - it will show that both programs have a fd open to the database)
Telepathy does come with a program called "Telepathy Logger" which can log to various database formats (and I guess just log all messages), and it also provides a way to read (not just write) log events. I am not sure if this is useful for us, but we could take a look later. For now, I believe our replacement programs for the call and messaging UI will have to log on their own.
telepathy-ring is used to communicate with the modem through ofono. This account has the following options set on my device:
[ring/tel/ring] manager=ring protocol=tel param-account=ring Enabled=true HasBeenOnline=true ConnectAutomatically=true AutomaticPresenceType=2 AutomaticPresenceStatus=available Profile=tel NormalizedName=<SelfHandle>
ConnectAutomatically seems to suggest there is no specific program that starts telepathy-ring (just MC itself), as long as the account is requested (I guess?) by something.
Presence and online accounts
- discuss various other rtcom components/packages (rtcom notification plugin, rtcom presence plugin)
- rtcom accounts ui, how that works
- discuss how presence works
Looks like the right way to use telepathy-qt API is to already have accounts created in Telepathy (use mc-tool or some UI).
Then the AccountManager class can be used to get access to the Account classes (or you can make an account class directly from a D-Bus path). Setting the account presence and it's connection state, and then calling reconnect on the accounts will bring them online.
At this point, using a SimpleTextObserver can be used to monitoring incoming and outgoing messages.
- Expand on many more classes, which ones are useful and how to use them
Telepathy basics for SMS
I think the first step is to make basic Telepathy things work in conversations, this entails manually setting up a sms account using mc-tool and then trying to use it from telepathy-qt: for sending and receiving messages. This probably entails:
- Setting up an account manager, finding the ring account
- Creating a connection from the ring account and making sure it is "ready" / "online"
- Setting up signals for receving messages, and adding a method to send a message
- Creating some code class for the above, so that it can be integrated in Conversations
- Conversations to always run (?)
And then look at integrating this in conversations.
This next step will involve logging sent and received SMS messages to rtcom-eventlogger and further osso-abook integration. We should be able to figure out what contact is who in osso-abook and make sure we log that properly as well.
This probably entails:
- Integrating rtcom-eventlogger in Qt/C++
- Looking at (more) name resolving with osso-abook (might be in rtcom-eventlogger library already)
Extend to IRC, XMPP
This step will require some global notion of if the device is "online" mode (like in Maemo Fremantle). We can set up IRC and XMPP accounts and try use them for messaging as well, and also log to rtcom-eventlogger. We won't worry here yet with showing which of the contacts are 'online'.
Well want to (need to?) reverse engineer (in order of dependencies, not necessarily order we should stick to):
- librtcom-accounts-ui-client0 (14KB)
- libaccounts (32KB)
- librtcom-accounts-widgets0 (108KB) (wants librtcom-accounts-ui-client)
- rtcom-accounts-ui (32KB)
- rtcom-presence-ui (76KB + 6.7KB) (wants librtcom-accounts-ui-client, libmcclient.so.6)
- rtcom-notification-ui (208KB) (wants librtcom-accounts-ui-client.so.0, librtcom-el-plugin-call.so.1, librtcom-el-plugin-sms.so.1, librtcom-el-plugin-chat.so.1)
And there are various accounts plugins, we can probably just recreate those:
- rtcom-accounts-plugin-sip (18KB) (wants librtcom-accounts-ui-client.so.0, libaccounts.so.0, libmcclient.so.6, librtcom-accounts-widgets.so.0)
- rtcom-accounts-plugin-gtalk (FOSS: https://github.com/community-ssu/rtcom-accounts-plugin-gtalk)
- If phone is in offline mode, we cannot send SMSes
- If phone is in non-online mode (for irc, xmpp, etc), then we can't send messages for those protocols
- Nice resource on telepathy architecture: https://www.aosabook.org/en/telepathy.html
- rtcom-eventlogger API docs: http://maemo.org/api_refs/5.0/5.0-final/eventlogger/