Re: DBus Methods and Signals Introspection or Documentation
Hi Wei, Wei Li wrote: > I am doing a project of middleware on Maemo/N900. I need to find the > methods and signals related to the hardware, for example, HAL > (especially the objects under /com/nokia since it is somehow > proprietary). However, I couldn't find a detailed documentation on that. > And I also used tools such as mdbus2, but since it lacks documentation > and so does DBus itself, I couldn't figure out how to do the > introspection to find the information I want. Anyone knows how to find > that? Thanks! You might find D-feet useful: https://fedorahosted.org/d-feet/ It is a DBus debugger that you can use to see what applications have listeners active, what APIs are supported, etc. I asked some time ago whether there was (a) a way to self-document DBus APIs when registering them (as you can do with the GIMP in plug-ins, for example) or (b) a way to inspect DBus and get something resembling API docs out of it, or (c) some gtk-doc or Doxygen convention we could use to document D-Bus APIs I was told "no" for a and c, and D-feet, dbus-monitor (which David mentioned in that tools wiki page) and dbus-inspector (http://www.vitavonni.de/projekte/dbus-inspector.html.en) are the best I could find. Cheers, Dave. -- maemo.org docsmaster Email: dne...@maemo.org Jabber: bo...@jabber.org ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Hi Wei! On Mon, Jun 7, 2010 at 2:02 PM, Wei Li wrote: > Hi Daniil, > > So you mean the API references are object (component) dependent hence there > is no unified reference to all the services of /com/nokia objects? Each component has it's own team responsible for it and it's pretty natural that every team has it's own documentation package. > I've got to say it is a little bit inconvenient. A unified reference document > will be > much helpful. If we are speaking about internal DBus methods and signals, you are not supposed to use it. Otherwise you can install doc packages and use them with devhelp. > So how about mce and icd? I found the dbus-names.h File > Reference but no luck with icd in the same page. icd2 and mce are documented in API documentation http://maemo.org/development/sdks/maemo_5_api_documentation/ Thanks, Daniil. > Thanks for the help! > > Cheers, > Wei > > > On Mon, Jun 7, 2010 at 12:20 PM, Daniil Ivanov > wrote: >> >> Hi Wei! >> >> CSD stands for cellular services daemon and name explains why API is >> closed. >> >> Thanks, Daniil. >> >> On Mon, Jun 7, 2010 at 12:15 PM, Wei Li wrote: >> > Thanks for all your help! As I mentioned, I am doing a middleware (for >> > energy efficiency) project on N900, hence I need to get the device >> > status >> > information such as battery, WLan card, mce. I need to use DBus to >> > communicate with other components in my work. So the refs on DBus >> > methods >> > and signals will be helpful. Some of such information (for example, the >> > battery) can be queried from HAL which has a defined specification. But >> > some >> > are not. For example, under /com/nokia path, there are many objects like >> > icd, wlancond and in Faheem's example, csd (don't even know what it is. >> > I >> > assumed circuit switch data?), which I couldn't find the docs for them. >> > If >> > anyone knows a general reference to all those objects, like what HAL >> > specification does, it would be great. >> > >> > BTW, in dbus-send command, the --desti argument specifies the "service", >> > meaning the interface? I always get lost with bus name (connection name) >> > and >> > interface. >> > >> > Thanks for all the help! >> > >> > Cheers, >> > Wei >> > >> > On Mon, Jun 7, 2010 at 11:35 AM, Faheem Pervez >> > wrote: >> >> >> >> Hi, >> >> >> >> On Mon, Jun 7, 2010 at 12:15 AM, Wei Li wrote: >> >> > I am doing a project of middleware on Maemo/N900. I need to find the >> >> > methods >> >> > and signals related to the hardware, for example, HAL (especially the >> >> > objects under /com/nokia since it is somehow proprietary). However, I >> >> > couldn't find a detailed documentation on that. And I also used tools >> >> > such >> >> > as mdbus2, but since it lacks documentation and so does DBus itself, >> >> > I >> >> > couldn't figure out how to do the introspection to find the >> >> > information >> >> > I >> >> > want. Anyone knows how to find that? Thanks! >> >> > >> >> >> >> You'll get more information if you specify *what* interface you're >> >> trying to figure out. The best way I found for me was looking, using >> >> strings, in a library that calls a D-Bus method, finding the name of >> >> that method call and working out its arguments by trial and error. >> >> >> >> Graham Cobb's >> >> https://garage.maemo.org/plugins/wiki/index.php?Tools&id=1106&type=g >> >> may also be of help. >> >> >> >> Best regards, >> >> Faheem >> > >> > >> > ___ >> > maemo-developers mailing list >> > maemo-developers@maemo.org >> > https://lists.maemo.org/mailman/listinfo/maemo-developers >> > >> > > > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Hi Daniil, So you mean the API references are object (component) dependent hence there is no unified reference to all the services of /com/nokia objects? I've got to say it is a little bit inconvenient. A unified reference document will be much helpful. So how about mce and icd? I found the dbus-names.h File Reference but no luck with icd in the same page. Thanks for the help! Cheers, Wei On Mon, Jun 7, 2010 at 12:20 PM, Daniil Ivanov wrote: > Hi Wei! > > CSD stands for cellular services daemon and name explains why API is > closed. > > Thanks, Daniil. > > On Mon, Jun 7, 2010 at 12:15 PM, Wei Li wrote: > > Thanks for all your help! As I mentioned, I am doing a middleware (for > > energy efficiency) project on N900, hence I need to get the device status > > information such as battery, WLan card, mce. I need to use DBus to > > communicate with other components in my work. So the refs on DBus methods > > and signals will be helpful. Some of such information (for example, the > > battery) can be queried from HAL which has a defined specification. But > some > > are not. For example, under /com/nokia path, there are many objects like > > icd, wlancond and in Faheem's example, csd (don't even know what it is. I > > assumed circuit switch data?), which I couldn't find the docs for them. > If > > anyone knows a general reference to all those objects, like what HAL > > specification does, it would be great. > > > > BTW, in dbus-send command, the --desti argument specifies the "service", > > meaning the interface? I always get lost with bus name (connection name) > and > > interface. > > > > Thanks for all the help! > > > > Cheers, > > Wei > > > > On Mon, Jun 7, 2010 at 11:35 AM, Faheem Pervez > wrote: > >> > >> Hi, > >> > >> On Mon, Jun 7, 2010 at 12:15 AM, Wei Li wrote: > >> > I am doing a project of middleware on Maemo/N900. I need to find the > >> > methods > >> > and signals related to the hardware, for example, HAL (especially the > >> > objects under /com/nokia since it is somehow proprietary). However, I > >> > couldn't find a detailed documentation on that. And I also used tools > >> > such > >> > as mdbus2, but since it lacks documentation and so does DBus itself, I > >> > couldn't figure out how to do the introspection to find the > information > >> > I > >> > want. Anyone knows how to find that? Thanks! > >> > > >> > >> You'll get more information if you specify *what* interface you're > >> trying to figure out. The best way I found for me was looking, using > >> strings, in a library that calls a D-Bus method, finding the name of > >> that method call and working out its arguments by trial and error. > >> > >> Graham Cobb's > >> https://garage.maemo.org/plugins/wiki/index.php?Tools&id=1106&type=g > >> may also be of help. > >> > >> Best regards, > >> Faheem > > > > > > ___ > > maemo-developers mailing list > > maemo-developers@maemo.org > > https://lists.maemo.org/mailman/listinfo/maemo-developers > > > > > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Hi Wei! CSD stands for cellular services daemon and name explains why API is closed. Thanks, Daniil. On Mon, Jun 7, 2010 at 12:15 PM, Wei Li wrote: > Thanks for all your help! As I mentioned, I am doing a middleware (for > energy efficiency) project on N900, hence I need to get the device status > information such as battery, WLan card, mce. I need to use DBus to > communicate with other components in my work. So the refs on DBus methods > and signals will be helpful. Some of such information (for example, the > battery) can be queried from HAL which has a defined specification. But some > are not. For example, under /com/nokia path, there are many objects like > icd, wlancond and in Faheem's example, csd (don't even know what it is. I > assumed circuit switch data?), which I couldn't find the docs for them. If > anyone knows a general reference to all those objects, like what HAL > specification does, it would be great. > > BTW, in dbus-send command, the --desti argument specifies the "service", > meaning the interface? I always get lost with bus name (connection name) and > interface. > > Thanks for all the help! > > Cheers, > Wei > > On Mon, Jun 7, 2010 at 11:35 AM, Faheem Pervez wrote: >> >> Hi, >> >> On Mon, Jun 7, 2010 at 12:15 AM, Wei Li wrote: >> > I am doing a project of middleware on Maemo/N900. I need to find the >> > methods >> > and signals related to the hardware, for example, HAL (especially the >> > objects under /com/nokia since it is somehow proprietary). However, I >> > couldn't find a detailed documentation on that. And I also used tools >> > such >> > as mdbus2, but since it lacks documentation and so does DBus itself, I >> > couldn't figure out how to do the introspection to find the information >> > I >> > want. Anyone knows how to find that? Thanks! >> > >> >> You'll get more information if you specify *what* interface you're >> trying to figure out. The best way I found for me was looking, using >> strings, in a library that calls a D-Bus method, finding the name of >> that method call and working out its arguments by trial and error. >> >> Graham Cobb's >> https://garage.maemo.org/plugins/wiki/index.php?Tools&id=1106&type=g >> may also be of help. >> >> Best regards, >> Faheem > > > ___ > maemo-developers mailing list > maemo-developers@maemo.org > https://lists.maemo.org/mailman/listinfo/maemo-developers > > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Thanks for all your help! As I mentioned, I am doing a middleware (for energy efficiency) project on N900, hence I need to get the device status information such as battery, WLan card, mce. I need to use DBus to communicate with other components in my work. So the refs on DBus methods and signals will be helpful. Some of such information (for example, the battery) can be queried from HAL which has a defined specification. But some are not. For example, under /com/nokia path, there are many objects like icd, wlancond and in Faheem's example, csd (don't even know what it is. I assumed circuit switch data?), which I couldn't find the docs for them. If anyone knows a general reference to all those objects, like what HAL specification does, it would be great. BTW, in dbus-send command, the --desti argument specifies the "service", meaning the interface? I always get lost with bus name (connection name) and interface. Thanks for all the help! Cheers, Wei On Mon, Jun 7, 2010 at 11:35 AM, Faheem Pervez wrote: > Hi, > > On Mon, Jun 7, 2010 at 12:15 AM, Wei Li wrote: > > I am doing a project of middleware on Maemo/N900. I need to find the > methods > > and signals related to the hardware, for example, HAL (especially the > > objects under /com/nokia since it is somehow proprietary). However, I > > couldn't find a detailed documentation on that. And I also used tools > such > > as mdbus2, but since it lacks documentation and so does DBus itself, I > > couldn't figure out how to do the introspection to find the information I > > want. Anyone knows how to find that? Thanks! > > > > You'll get more information if you specify *what* interface you're > trying to figure out. The best way I found for me was looking, using > strings, in a library that calls a D-Bus method, finding the name of > that method call and working out its arguments by trial and error. > > Graham Cobb's > https://garage.maemo.org/plugins/wiki/index.php?Tools&id=1106&type=g > may also be of help. > > Best regards, > Faheem > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Hi, On Mon, Jun 7, 2010 at 12:15 AM, Wei Li wrote: > I am doing a project of middleware on Maemo/N900. I need to find the methods > and signals related to the hardware, for example, HAL (especially the > objects under /com/nokia since it is somehow proprietary). However, I > couldn't find a detailed documentation on that. And I also used tools such > as mdbus2, but since it lacks documentation and so does DBus itself, I > couldn't figure out how to do the introspection to find the information I > want. Anyone knows how to find that? Thanks! > You'll get more information if you specify *what* interface you're trying to figure out. The best way I found for me was looking, using strings, in a library that calls a D-Bus method, finding the name of that method call and working out its arguments by trial and error. Graham Cobb's https://garage.maemo.org/plugins/wiki/index.php?Tools&id=1106&type=g may also be of help. Best regards, Faheem ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Hi Sivan! Well, HAL is Hardware Abstraction Layer. Thanks, Daniil. On Mon, Jun 7, 2010 at 11:27 AM, Sivan Greenberg wrote: > Daniil, maybe he was referring to something more platform (e.g. mobile > device) specific ? Or are those docs already containing this? (I > haven't looked into it in detail). > > > > Sivan > > On Mon, Jun 7, 2010 at 11:25 AM, Daniil Ivanov > wrote: >> Hi Wei! >> >> Can you use libhal and libhal-storage? >> http://maemo.org/api_refs/5.0/5.0-final/libhal/ >> http://maemo.org/api_refs/5.0/5.0-final/libhal-storage/ >> >> Thanks, Daniil. >> >> On Mon, Jun 7, 2010 at 10:01 AM, Wei Li wrote: >>> But is there any doc for at least the object methods and signals under >>> /com/nokia? Because HAL has its own DBus instances as well as docs. But I >>> couldn't find the /com/nokia ones. >>> >>> On Mon, Jun 7, 2010 at 3:03 AM, Ian Stirling >>> wrote: Wei Li wrote: > > Hi all, > > I am doing a project of middleware on Maemo/N900. I need to find the > methods and signals related to the hardware, for example, HAL (especially > the objects under /com/nokia since it is somehow proprietary). However, I > couldn't find a detailed documentation on that. And I also used tools such > as mdbus2, but since it lacks documentation and so does DBus itself, I > couldn't figure out how to do the introspection to find the information I > want. Anyone knows how to find that? Thanks! As I understand it, many of these mrhods do not support introspection, and there is no documentation. For example - the dbus 'backend' of liblocation. It's possible I'm confused, and have simply missed the docs. >>> >>> >>> ___ >>> maemo-developers mailing list >>> maemo-developers@maemo.org >>> https://lists.maemo.org/mailman/listinfo/maemo-developers >>> >>> >> ___ >> maemo-developers mailing list >> maemo-developers@maemo.org >> https://lists.maemo.org/mailman/listinfo/maemo-developers >> > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Wei, If you need to access storage stuff, this might be of help, although mind you, it is in Python (you could use Python as well to do the initial prototyping) - however, the storage keys are the same ofcourse. http://bazaar.launchpad.net/~sivan/hubackup/hubackup--main/annotate/head:/HUBackup/backend/DeviceInfo.py Sivan On Mon, Jun 7, 2010 at 2:15 AM, Wei Li wrote: > Hi all, > > I am doing a project of middleware on Maemo/N900. I need to find the methods > and signals related to the hardware, for example, HAL (especially the > objects under /com/nokia since it is somehow proprietary). However, I > couldn't find a detailed documentation on that. And I also used tools such > as mdbus2, but since it lacks documentation and so does DBus itself, I > couldn't figure out how to do the introspection to find the information I > want. Anyone knows how to find that? Thanks! > > Cheers > > ___ > maemo-developers mailing list > maemo-developers@maemo.org > https://lists.maemo.org/mailman/listinfo/maemo-developers > > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Daniil, maybe he was referring to something more platform (e.g. mobile device) specific ? Or are those docs already containing this? (I haven't looked into it in detail). Sivan On Mon, Jun 7, 2010 at 11:25 AM, Daniil Ivanov wrote: > Hi Wei! > > Can you use libhal and libhal-storage? > http://maemo.org/api_refs/5.0/5.0-final/libhal/ > http://maemo.org/api_refs/5.0/5.0-final/libhal-storage/ > > Thanks, Daniil. > > On Mon, Jun 7, 2010 at 10:01 AM, Wei Li wrote: >> But is there any doc for at least the object methods and signals under >> /com/nokia? Because HAL has its own DBus instances as well as docs. But I >> couldn't find the /com/nokia ones. >> >> On Mon, Jun 7, 2010 at 3:03 AM, Ian Stirling >> wrote: >>> >>> Wei Li wrote: Hi all, I am doing a project of middleware on Maemo/N900. I need to find the methods and signals related to the hardware, for example, HAL (especially the objects under /com/nokia since it is somehow proprietary). However, I couldn't find a detailed documentation on that. And I also used tools such as mdbus2, but since it lacks documentation and so does DBus itself, I couldn't figure out how to do the introspection to find the information I want. Anyone knows how to find that? Thanks! >>> >>> As I understand it, many of these mrhods do not support introspection, and >>> there is no documentation. >>> >>> For example - the dbus 'backend' of liblocation. >>> It's possible I'm confused, and have simply missed the docs. >> >> >> ___ >> maemo-developers mailing list >> maemo-developers@maemo.org >> https://lists.maemo.org/mailman/listinfo/maemo-developers >> >> > ___ > maemo-developers mailing list > maemo-developers@maemo.org > https://lists.maemo.org/mailman/listinfo/maemo-developers > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Hi Wei! Can you use libhal and libhal-storage? http://maemo.org/api_refs/5.0/5.0-final/libhal/ http://maemo.org/api_refs/5.0/5.0-final/libhal-storage/ Thanks, Daniil. On Mon, Jun 7, 2010 at 10:01 AM, Wei Li wrote: > But is there any doc for at least the object methods and signals under > /com/nokia? Because HAL has its own DBus instances as well as docs. But I > couldn't find the /com/nokia ones. > > On Mon, Jun 7, 2010 at 3:03 AM, Ian Stirling > wrote: >> >> Wei Li wrote: >>> >>> Hi all, >>> >>> I am doing a project of middleware on Maemo/N900. I need to find the >>> methods and signals related to the hardware, for example, HAL (especially >>> the objects under /com/nokia since it is somehow proprietary). However, I >>> couldn't find a detailed documentation on that. And I also used tools such >>> as mdbus2, but since it lacks documentation and so does DBus itself, I >>> couldn't figure out how to do the introspection to find the information I >>> want. Anyone knows how to find that? Thanks! >> >> As I understand it, many of these mrhods do not support introspection, and >> there is no documentation. >> >> For example - the dbus 'backend' of liblocation. >> It's possible I'm confused, and have simply missed the docs. > > > ___ > maemo-developers mailing list > maemo-developers@maemo.org > https://lists.maemo.org/mailman/listinfo/maemo-developers > > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
If there is not such docs yet, we need to develop some or ask for some API docs. Who might know about this? Sivan On Mon, Jun 7, 2010 at 10:01 AM, Wei Li wrote: > But is there any doc for at least the object methods and signals under > /com/nokia? Because HAL has its own DBus instances as well as docs. But I > couldn't find the /com/nokia ones. > > On Mon, Jun 7, 2010 at 3:03 AM, Ian Stirling > wrote: >> >> Wei Li wrote: >>> >>> Hi all, >>> >>> I am doing a project of middleware on Maemo/N900. I need to find the >>> methods and signals related to the hardware, for example, HAL (especially >>> the objects under /com/nokia since it is somehow proprietary). However, I >>> couldn't find a detailed documentation on that. And I also used tools such >>> as mdbus2, but since it lacks documentation and so does DBus itself, I >>> couldn't figure out how to do the introspection to find the information I >>> want. Anyone knows how to find that? Thanks! >> >> As I understand it, many of these mrhods do not support introspection, and >> there is no documentation. >> >> For example - the dbus 'backend' of liblocation. >> It's possible I'm confused, and have simply missed the docs. > > > ___ > maemo-developers mailing list > maemo-developers@maemo.org > https://lists.maemo.org/mailman/listinfo/maemo-developers > > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
But is there any doc for at least the object methods and signals under /com/nokia? Because HAL has its own DBus instances as well as docs. But I couldn't find the /com/nokia ones. On Mon, Jun 7, 2010 at 3:03 AM, Ian Stirling wrote: > Wei Li wrote: > >> Hi all, >> >> I am doing a project of middleware on Maemo/N900. I need to find the >> methods and signals related to the hardware, for example, HAL (especially >> the objects under /com/nokia since it is somehow proprietary). However, I >> couldn't find a detailed documentation on that. And I also used tools such >> as mdbus2, but since it lacks documentation and so does DBus itself, I >> couldn't figure out how to do the introspection to find the information I >> want. Anyone knows how to find that? Thanks! >> > > As I understand it, many of these mrhods do not support introspection, and > there is no documentation. > > For example - the dbus 'backend' of liblocation. > It's possible I'm confused, and have simply missed the docs. > ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: DBus Methods and Signals Introspection or Documentation
Wei Li wrote: Hi all, I am doing a project of middleware on Maemo/N900. I need to find the methods and signals related to the hardware, for example, HAL (especially the objects under /com/nokia since it is somehow proprietary). However, I couldn't find a detailed documentation on that. And I also used tools such as mdbus2, but since it lacks documentation and so does DBus itself, I couldn't figure out how to do the introspection to find the information I want. Anyone knows how to find that? Thanks! As I understand it, many of these mrhods do not support introspection, and there is no documentation. For example - the dbus 'backend' of liblocation. It's possible I'm confused, and have simply missed the docs. ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers
DBus Methods and Signals Introspection or Documentation
Hi all, I am doing a project of middleware on Maemo/N900. I need to find the methods and signals related to the hardware, for example, HAL (especially the objects under /com/nokia since it is somehow proprietary). However, I couldn't find a detailed documentation on that. And I also used tools such as mdbus2, but since it lacks documentation and so does DBus itself, I couldn't figure out how to do the introspection to find the information I want. Anyone knows how to find that? Thanks! Cheers ___ maemo-developers mailing list maemo-developers@maemo.org https://lists.maemo.org/mailman/listinfo/maemo-developers