Please comment on callhistory API

[rajyalakshmi bommaraju <rajyalakshmi.bommaraju@intel.com>]

[-- Attachment #1: Type: text/plain, Size: 2916 bytes --]

Hello,
Attached Callhistory API , please send me your feedback on it, I will 
extend this include SmsHistory once callhistory API looks good.

Thanks
Raji


							Callhistory Adapter-Agent


	CallHistoryAdapter is a built in plugin for ofono. It uses CallHistoryAgent api exposed by dialer or client daemon to push voice call history information to client. CallHistoryAgent api is an service interface exposed by client over dbus. Plugin exposes CallHistoryAdapter interface that CallHistoryAgent registers and unregisters with. if the CallHistoryAgent registers with Adapter then plugin pushes the history information to dialer as soon as it receives from ofono, otherwise it caches the data in a disk file until agent registers, once agent registers plugin will read the data from the disk file and pushes all the records to it.


Adapter: 

it is going to register and unregister the agent. Calls the methods on the agent for delivering history information whent the agent is up and running. If the record cant be delivered that means agent method returns an error then it will be written to the disk file. If the agent is down it will persist history record in disk file.


CallHistoryAdapter hierarchy
============================

Service 	: org.ofono
Interface	: org.ofono.CallHistoryAdapter
Object path	: freely definable

Methods		void RegisterAgent (objectpath)  

			RegisterAgent method registers the agent object path. Methods on this agent will be called if history needs to push data.  

			Possible Errors: [service].Error.InvalidArguments
					 [service].Error.InvalidFormat
					 [service].Error.InUse

		void UnregisterAgent (objectpath) 

			UnregisterAgent method unregister the already registered agent object path.

			Possible Errors: [service].Error.InvalidArguments
					 [service].Error.InvalidFormat
					 [service].Error.InUse


CallHistoryAgent hierarchy
==========================

Service Name	: Unique Name
Interface	: org.ofono.CallHistoryAgent
Objectpath	: Freely definable

Methods		void SendHistory(array {struct {uint32,uint32,uint8,uint32,uint32} }) 

			This method gets called by ofono to deliver one record of voice call history.
		
			Possible Errors: [service].Error.Unsuccessful

		void SendCachedHistory(array {struct {uint32,uint32,uint8,uint32,uint32} })

			This method gets called by the ofono when CallHistoryAgent starts running. 
			It delivers all the history records as an array of structures.

			Possible Errors: [service].Error.Unsuccessful

		void Release() 
			Cleans up agent, assumes that agent is already unregistered, so not needed to unregister. 

CallHistory Record 
================
 
CallHistoryRecord {
		uint32	uid;
		uint8	voicecalltype;
		char	lineid[20];
		uint32	starttime;
		uint32	endtime;
}

voicecalltype {
	outgoing = 0,
	incoming = 1,
	missed = 2
}