Luna Send - Revision history

RodWhitby at 10:26, 13 June 2013

2013-06-13T10:26:23Z

0xdeadbabe: webOS 2 doesn't use D-Bus. sigh.

2011-10-11T22:58:16Z

webOS 2 doesn't use D-Bus. sigh.

0xdeadbabe at 13:38, 1 October 2011

2011-10-01T13:38:59Z

0xdeadbabe: /* Searching for services */

2011-10-01T13:37:33Z

Searching for services

0xdeadbabe: revamp

2011-10-01T13:36:02Z

revamp

Maxpayne at 23:03, 12 August 2011

2011-08-12T23:03:13Z

Halihassan: Added media volume.

2011-08-08T16:14:49Z

Added media volume.

Xanadu73: remove underline tag since it doesn't work here.

2011-02-23T12:48:26Z

remove underline tag since it doesn't work here.

Jack87 at 01:53, 23 December 2010

2010-12-23T01:53:20Z

Destinal at 01:35, 23 December 2010

2010-12-23T01:35:29Z

@@ Line 30: / Line 30: @@
 == Examples ==
 Kick off a manual Palm Backup entirely from the command line:
 <pre><nowiki>

@@ Line 1: / Line 1: @@
-webOS applications may have backend components (that may not be implementable in JavaScript, or require extra hardware processing of native language) that are accessed through the <tt>Mojo.Service</tt> API. The browser engine delegates these calls from JavaScript to the backend components through the D-Bus architecture.
+webOS applications may have backend components (that may not be implementable in JavaScript, or require extra hardware processing of native language) that are accessed through the <tt>Mojo.Service</tt> API. The browser engine delegates these calls from JavaScript to the backend components through a message bus infrastructure, like D-Bus.
 With root permissions, the end user may be able to interact with the backends directly with the <tt>luna-send</tt> utility.
 == Implementation ==
 For example, the following JavaScript fragment:
 <pre>
@@ Line 15: / Line 16: @@
 </pre>
-Given that these are all effectively D-Bus calls happening, a <tt>luna-send</tt> call can be made equivalently with <tt>dbus-send</tt>, for example, the two commands below yield the same result:
+Since these are all effectively D-Bus calls, a <tt>luna-send</tt> call can be made equivalently with <tt>dbus-send</tt>, for example, the two commands below yield the same result:
 <pre>
@@ Line 21: / Line 22: @@
 dbus-send --system --type=method_call --print-reply --dest=com.palm.systemservice /time org.json.getSystemTime string:"{}"
 </pre>
 == Examples ==

@@ Line 5: / Line 5: @@
 == Implementation ==
 For example, the following JavaScript fragment:
-<tt>
+<pre>
 Mojo.Service.Request("palm://com.palm.systemservice/time", { method: "getSystemTime", onSuccess: callback });
-</tt>
+</pre>
 corresponds to
-<tt>
+<pre>
 luna-send -n 1 palm://com.palm.systemservice/time/getSystemTime {}
-</tt>
+</pre>
 Given that these are all effectively D-Bus calls happening, a <tt>luna-send</tt> call can be made equivalently with <tt>dbus-send</tt>, for example, the two commands below yield the same result:
-<tt>
+<pre>
 luna-send -n 1 palm://com.palm.systemservice/time/getSystemTime {}
 dbus-send --system --type=method_call --print-reply --dest=com.palm.systemservice /time org.json.getSystemTime string:"{}"
-</tt>
+</pre>
 == Examples ==

@@ Line 254: / Line 254: @@
 == Searching for services ==
-As mentioned above, since <tt>Mojo.Service.Request</tt> (or, equivalently, through the scene controller's <tt>serviceRequest<tt> method) make use of D-Bus, we can use two methods to determine what external calls can be made to their backend components
+As mentioned above, since <tt>Mojo.Service.Request</tt> (or, equivalently, through the scene controller's <tt>serviceRequest</tt> method) make use of D-Bus, we can use two methods to determine what external calls can be made to their backend components
 === By examining JavaScript source ===

@@ Line 1: / Line 1: @@
-NOTE: You have to run with root perms..
+webOS applications may have backend components (that may not be implementable in JavaScript, or require extra hardware processing of native language) that are accessed through the <tt>Mojo.Service</tt> API. The browser engine delegates these calls from JavaScript to the backend components through the D-Bus architecture.
 Kick off a manual Palm Backup entirely from the command line:
 <pre><nowiki>
@@ Line 197: / Line 218: @@
-==Applications==
+===Applications===
 Notes (view notes):
@@ Line 217: / Line 238: @@
 luna-send -n 1 palm://com.palm.storage/diskmode/enterMSM {\"user-confirmed\":true,\"enterIMasq\":false}
 </nowiki></pre>
 ==Airplane Mode==
@@ Line 234: / Line 252: @@
 </nowiki></pre>
-==Finding luna-send Command==
+As mentioned above, since <tt>Mojo.Service.Request</tt> (or, equivalently, through the scene controller's <tt>serviceRequest<tt> method) make use of D-Bus, we can use two methods to determine what external calls can be made to their backend components
-These commands come from inside given applications. The best way to find luna-send commands is to do a search for the term "method:" in the Applications code.  Once you find method: you might see parameters: which is also used by luna-send here is an example.
+=== By examining JavaScript source ===
-searched for "method:" in the com.app.palm.AppYouAreTesting
+Simply grep through the application for <tt>Mojo.Service.Request</tt> or <tt>serviceRequest</tt> calls and note how they are invoked. They then can be adapted to use <tt>luna-send</tt>.
-found
+=== By examining dbus traffic directly ===
-"method: test"
+There are some tools available to trace D-Bus calls happening as the application is running, such as <tt>dbus-monitor</tt> or <tt>dbus-util</tt>.
-luna-send command based on example:
+==== Example ====
-<pre><nowiki>
+To determine what governs roaming mode capability, we may do the following.
 <pre>
 # dbus-util --capture 2>&1 |tee /tmp/dbus.dump
 # grep roam /tmp/dbus.dump
    com.palm.luna2  com.palm.telephony      //roamModeSet   Â«string=â{"mode": "homeonly"}
-com.palm.telophony is the service
+From this we see:
-//roamModeSet is the method
+* <tt>com.palm.telephony</tt> is the service
-"mode":"homeonly" is the parameter
+* <tt>roamModeSet<tt> is the method
+* <tt>{ mode: "homeonly" }</tt> is the parameter
 luna-send -n 1 palm://com.palm.telephony/roamModeSet '{"mode":"homeonly"}'
 </pre>

← Older revision		Revision as of 23:03, 12 August 2011
Line 23:		Line 23:
	</nowiki></pre>		</nowiki></pre>

		+	Turn Bluetooth ON:
		+	<pre><nowiki>
		+	luna-send -n 1 palm://com.palm.btmonitor/monitor/radioon '{"visible":true, "connectable":true}'
		+	</nowiki></pre>
		+
		+	Turn Bluetooth OFF:
		+	<pre><nowiki>
		+	luna-send -n 1 palm://com.palm.btmonitor/monitor/radiooff {}
		+	</nowiki></pre>

	Using luna-send to refresh the Launcher panel.		Using luna-send to refresh the Launcher panel.

@@ Line 2: / Line 2: @@
-Kick off a manual Palm Backup [u]entirely[/u] from the command line:
+Kick off a manual Palm Backup entirely from the command line:
 <pre><nowiki>
 luna-send -n 1 palm://com.palm.applicationManager/launch '{"id":"com.palm.app.backup"}'

← Older revision		Revision as of 01:35, 23 December 2010
Line 1:		Line 1:
−	NOTE: You have to run with root perms.	+	NOTE: You have to run with root perms..