User Tools

Site Tools


program

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

program [2014/05/05 11:29]
creamers
program [2015/11/27 21:09]
Line 1: Line 1:
-**Program** 
  
-^Feature^Support^ 
-|Sending|{{http://​wiki.pilight.org/​lib/​images/​supported.gif}}| 
-|Receiving|{{http://​wiki.pilight.org/​lib/​images/​supported.gif}}| 
-|Config|{{http://​wiki.pilight.org/​lib/​images/​supported.gif}}| 
- 
-Supported Brands 
- 
-//None// 
- 
-Sender Arguments 
-<​code>​ 
--t --running ​            start the program 
--f --stopped ​            stop the program 
--n --name=name ​          name of the program 
-</​code> ​ 
- 
-Config 
-<​code>​ 
- "​programs":​ { 
- "​name":​ "​Programs",​ 
- "​XBMC":​ { 
- "​name":​ "​XBMC",​ 
- "​protocol":​ [ "​program"​ ], 
- "​id":​ [{ 
- "​name":​ "​xbmc"​ 
- }], 
- "​program":​ "/​usr/​local/​lib/​xbmc/​xbmc.bin",​ 
- "​arguments":​ "​--standalone -fs --lircdev /​run/​lirc/​lircd",​ 
- "​stop-command":​ "​service xbmc stop", 
- "​start-command":​ "​service xbmc start",​ 
- "​state":​ "​running",​ 
- "​pid":​ 11642 
- } 
- } 
-</​code>​ 
- 
-Optional Settings 
- 
-^Setting^Default^Format^Description^ 
-|gui-readonly|0|1 or 0|Make the GUI element readonly| 
-|poll-interval|1| >= 1|How ofter do we want to check the program state| 
- 
-Comments 
- 
-The program protocol takes two important arguments 
-  * The program 
-  * The arguments 
- 
-You can run ''​ps aux''​ to find out what these are. An example: 
-<​code>​ 
-USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND 
-root     ​11622 ​ 0.0  2.3  20216  8860 tty4     Ssl+ 20:04   0:01 /​usr/​local/​sbin/​splash-daemon 
-root     ​11636 ​ 0.0  0.4   ​4096 ​ 1540 ?        Ss   ​20:​04 ​  0:00 sudo -u xbian /​usr/​local/​lib/​xbmc/​xbmc.bin --standalone -fs --lircdev /​run/​lirc/​lircd 
-xbian    11642 22.5 12.6 390836 48280 ?        RNl  20:04  15:09 /​usr/​local/​lib/​xbmc/​xbmc.bin --standalone -fs --lircdev /​run/​lirc/​lircd 
-xbian    11734  0.0  0.2   ​2692 ​ 1092 ?        S    20:04   0:00 /bin/bash 
-root     ​11868 ​ 0.0  1.4   ​9732 ​ 5432 ?        Ss   ​20:​04 ​  0:00 python /​usr/​local/​sbin/​upstart-xbmc-bridge.py 
-root     ​11908 ​ 0.0  0.0      0     0 ?        S    20:06   0:00 [btrfs-delalloc-] 
-root     ​13078 ​ 0.0  0.0      0     0 ?        S    21:05   0:00 [kworker/​u2:​0] 
-root     ​13085 ​ 0.0  0.0      0     0 ?        S    21:08   0:00 [btrfs-worker-2] 
-root     ​13166 ​ 0.0  0.0      0     0 ?        S    21:10   0:00 [kworker/​u2:​1] 
-root     ​13186 ​ 0.0  0.2   ​4424 ​ 1116 pts/2    R+   ​21:​11 ​  0:00 ps aux 
-</​code>​ 
-In thise case, i want to control XBMC. The xbian entry with the PID 11642 is what i want to use. 
-The first word is the program name. In this case ''/​usr/​local/​lib/​xbmc/​xbmc.bin''​. Everything that comes after are the arguments ''​--standalone -fs --lircdev /​run/​lirc/​lircd''​. pilight will now check for a program that matches these exact parameters. So the protocol looks for processes matching those lines and when a process is found, it updates the pid value accordingly. (The pid is just informative.) 
- 
-If you omit the arguments value, all matching programs will be processes with or without matching arguments. If there are more than once matches, pilight will use the first. 
program.txt ยท Last modified: 2015/11/27 21:09 (external edit)