DbusScripts

Contents

dbus-scripts

dbus-scripts is a daemon that can execute a command when various action occurs on DBus. Some dbus signal you can watch for are :

  • keyboard slide
  • battery full, low or empty
  • connection or disconnection from a network
  • sms or phone call arriving
  • desktop started (ie after boot is completed)
  • bnep or usb network started or stopped (use to configure or run firewalls etc)

You can find dbus-scripts in extras-devel (so be careful, your n900 could crash).

There's some documentation in the dbus-scripts config file

There's also a configurator program dbus-scripts-settings written by Matan Ziv-Av You can use dbus-scripts-settings settings to configure dbus-scripts or just to browse

Thanks to Graham and Matan.

Configuration

configuration files for dbus-scripts are in /etc/dbus-scripts.d and you can find some documentation in /etc/dbus-scripts.d/dbus-scripts-example :

 # Example of dbus-scripts control file
 #
 # Each line of these files represents a filter to call a script.
 # Tokens are separated by white space.
 # First token on line is the script to execute.
 # Subsequent tokens are filters to match arguments from dbus message.
 # Filters are matched like shell wildcards (using fnmatch(3)).
 # If a filter is specified (even if it is *), the corresponding argument
 # must be present in order to get a match.
 #
 # First argument is sender
 # Second argument is destination
 # For SIGNAL and METHOD_CALL, third argument is interface
 # For SIGNAL and METHOD_CALL, fourth argument is member
 # Other arguments depend on the message
 #
 # Example: to act on WLAN interface state changes use:
 #/some/script * * com.nokia.icd status_changed * WLAN_INFRA
 # In /some/script, $5 will be the interface name and $7 the new state (IDLE, CONNECTED, etc.)
  • this rule will match all wlan network events
 /some/script * * com.nokia.icd status_changed * WLAN_INFRA
  • this one will match all events for wlan network id of

91f493fb-7c89-4fc6-ac2c-b822923dde45, it's mine

(you can find the wlan id with the command gconftool-2 -R /system/osso/connectivity/IAP)

 /some/script * * com.nokia.icd status_changed 91f493fb-7c89-4fc6-ac2c-b822923dde45 WLAN_INFRA
  • this one will match only the CONNECTED (wifi works) dbus event for my wlan network :
 /some/script * * com.nokia.icd status_changed 91f493fb-7c89-4fc6-ac2c-b822923dde45 WLAN_INFRA CONNECTED

Limitations

For the moment dbus-scripts will only pass simple dbus type arguments like string, boolean and int32 et uint32 to your scripts. You will miss variant, array and all other complex type arguments. So if you want to play, for example, with text of received sms, you can't yet use dbus-scripts as the text is an array of bytes.

Some scripts

Here are some things you can do, if you have others, add them. Those examples aren't rocket science and I've stolen some ideas from here and there on web.

when connect on my wifi home network register only SIP ad turn on noisy ring

When I come back home I want my SIP call redirected to my mobile phone and the phone ring turn on and when I leave I want my ring turn off so I wait for dbus event on my home wifi network and register/unreregister SIP and turn on/off the ring.

I use this dbus-scripts config file :

 cat /etc/dbus-scripts.d/athome 
 /home/user/bin/athome * * com.nokia.icd status_changed * WLAN_INFRA

and this script to register/unregister SIP and turn on/off the ring.

 cat /home/user/bin/athome
 #!/usr/bin/python
 
 import dbus
 import sys
 import re
 import telepathy
 
 wifi = '91f493fb-7c89-4fc6-ac2c-b822923dde45'
 
 # /home/user/bin/w32g * * com.nokia.icd status_changed * WLAN_INFRA *
 
 wifi_id,state = sys.argv[5],sys.argv[7]
 
 # if we are not on the good wifi network we do nothing and exit
 if wifi and not re.search(wifi_id, wifi, re.IGNORECASE):
    sys.exit(0)
 
 bus = dbus.SessionBus()
 account = bus.get_object('org.freedesktop.Telepathy.AccountManager',
                          '/org/freedesktop/Telepathy/Account/sofiasip/sip/_309517129090')
 profile = bus.get_object('com.nokia.profiled', '/com/nokia/profiled')
 
 def change_state(prof, presence_const, presence_text):
    profile.set_profile(prof, dbus_interface='com.nokia.profiled')
    account.Set('org.freedesktop.Telepathy.Account', 'RequestedPresence', \
                dbus.Struct(( dbus.UInt32( presence_const) ,  presence_text, ""), signature='uss'),
                dbus_interface='org.freedesktop.DBus.Properties')
    
 
 if state == "CONNECTED":
    print "available"
    change_state('general', telepathy.constants.CONNECTION_PRESENCE_TYPE_AVAILABLE, 'available')
 elif state == "IDLE":
    print "offline"
    change_state('silent', telepathy.constants.CONNECTION_PRESENCE_TYPE_OFFLINE, 'offline')
 else:
    sys.exit("Usage: %s (start|stop)" %  sys.argv[0])

turn to 2g when connected to wifi network

There's already an alternative method with fcron. Here is a dbus method :

 cat /etc/dbus-scripts.d/w32g
 /home/user/bin/w32g.py * * com.nokia.icd status_changed * WLAN_INFRA

Installation documentation is at the beginning of the script and configuration documentation is at the beginning of the configuration file :


 cat /home/user/bin/w32g.py
 #!/usr/bin/python
 
 import sys
 import os
 import ConfigParser
 import re
 
 # You need to install dbus-scripts (BE CAREFUL, it's a devel package)
 # 
 # as root you need to create a file /etc/sudoers.d/w32g
 # with this line :
 #   user ALL = NOPASSWD: /bin/ping
 # and run the command update-sudoers because only root can use ping
 # 
 # always as root and you need to create another file
 # /etc/dbus-scripts/w32g with the following line : 
 #
 #   /home/user/bin/w32g * * com.nokia.icd status_changed * WLAN_INFRA *
 #
 # and copy this script in /home/user/bin/w32g
 
 conf_file = '/home/user/.w32g.conf'
 
 config = { 'message_on_idle': '3G cellular mode set',
   'message_on_connected': '2G (GSM) cellular mode set',
   'connection_test': 'sudo /bin/ping -c 1 www.google.com',
   'change_on_idle': 'true',
   'change_to_dual': 'true',
   'wifi': 
 }
 
 config_parser = ConfigParser.SafeConfigParser()
 
 try:
     config_parser.read(conf_file)
     for item in config_parser.items('w32g'):
         config[ item[0] ] = item[1]
 except ConfigParser.NoSectionError:
     pass
 
 def to_bool(string):
     if re.search('true', string, re.IGNORECASE):
         return True
 
 config['change_on_idle'] = to_bool(config['change_on_idle'])
 config['change_to_dual'] = to_bool(config['change_to_dual'])
 
 wifi_id,state = sys.argv[5],sys.argv[7]
 
 # if we are not on the good wifi network we do nothing and exit
 if config['wifi'] and not re.search(wifi_id, config['wifi'], re.IGNORECASE):
     sys.exit(0)
 
 dbus_wifi = "dbus-send --system --type=method_call --print-reply --dest=com.nokia.phone.net /com/nokia/phone/net Phone.Net.set_selected_radio_access_technology";
 
 dbus_notif = "dbus-send --system --type=method_call --print-reply --dest=org.freedesktop.Notifications /org/freedesktop/Notifications org.freedesktop.Notifications.SystemNoteInfoprint";
 
 if state == 'CONNECTED':
     # we verified that the connection works
     if config['connection_test']:
         ret = os.system(config['connection_test']);
     else:
         ret = 0
     if ret == 0:
         os.system(dbus_wifi + " byte:1");
         os.system(dbus_notif + " string:'" + config['message_on_connected'] + "'")
 
 elif state == 'IDLE' and config['change_on_idle']:
     dual = "2"
     if config['change_to_dual']: dual = "0"
     print dual
     os.system(dbus_wifi + " byte:" + dual);
     os.system(dbus_notif + " string:'" + config['message_on_idle'] + "'")


 cat /home/user/.w32g.conf
 [w32g]
 
 ### the comment reflect the default configuration
 ### true is true (case insensitive), everything else is false
 
 ### the command used to test the wifi connection before downgrading to 2g
 ### if you don't want to do test just delete after =
 # connection_test = sudo /bin/ping -c 1 www.google.com
 
 ### notification message when going to 3g
 # message_on_idle = 3G cellular mode set
 ### notification message when going to 2g
 # message_on_connected = 2G (GSM) cellular mode set
 
 ### shall we go back to 3g when wlan disconnect ?
 #### if you want to have false just delete after =
 # change_on_idle = true
 ### shall we go back to dual or 3g ?
 # change_to_dual = true
 
 ### if you want go to 2g only when connected to some wlan you can add their wlan id here
 ### you can find the wlan id using the command 
 ### gconftool-2 -R /system/osso/connectivity/IAP
 ### For example :
 ### wifi = 91f493fb-7c89-4fc6-ac2c-b822923dde45 9ee5dd55-9a32-4ee9-9131-c464ad31d907
 # wifi =

Links to other scripts

automatically register on public wifi network when connected

You can find a script in this post on tmo

Thanks

Thanks to Graham Cobb for dbus-scripts and Matan for dbus-scripts-settings