Skip to content
Browse files

Updated the api doc to match rm14

  • Loading branch information...
1 parent 456ec6c commit d20e8779260cba59312566c25a623d644cdd9f16 @benjymous committed Apr 21, 2012
Showing with 61 additions and 22 deletions.
  1. +61 −22 MW_v0.2.4b_APK_API.txt
View
83 MW_v0.2.4b_APK_API.txt
@@ -1,21 +1,31 @@
-Handled:
+Intents listened for:
org.metawatch.manager.NOTIFICATION
- "array" - int[96*96]
- or
- "buffer" - byte[96*96/8] // encoded buffer
- --
+ - Display a notification on the watch
+
"vibrate_on" - int // ms
"vibrate_off" - int // ms
"vibrate_cycles" - int
- --
- - text: Displays text on the digital watch. (digital only, untested)
- - oled1: Displays large text on the top OLED. (analog only)
- - oled1a: Displays small text on the upper half of the top OLED (analog only)
- - oled1b: Displays small text on the lower half of the top OLED (analog only)
- - oled2: Displays large text on the bottom OLED. (analog only)
- - oled2a: Displays small text on the upper half of the bottom OLED (analog only)
- - oled2b: Displays small text on the lower half of the bottom OLED (analog only)
+ (optional - notification will display without vibration if omitted)
+
+DIGITAL:
+ "array" - int[96*96]
+ or
+ "buffer" - byte[96*96/8] // encoded buffer
+
+OLED:
+ "oled1" - Displays large text on the top OLED.
+ "oled1a" - Displays small text on the upper half of the top OLED
+ "oled1b" - Displays small text on the lower half of the top OLED
+ "oled2" - Displays large text on the bottom OLED.
+ "oled2a" - Displays small text on the upper half of the bottom OLED
+ "oled2b" - Displays small text on the lower half of the bottom OLED
+
+DIGITAL and OLED (from rm14 onwards)
+ "text" - Displays text on the digital watch.
+ "title" (optional) - Title for the notification when using "text"
+
+-------------------------------------------------------------------------------
org.metawatch.manager.APPLICATION_UPDATE
"array" - int[96*96]
@@ -26,20 +36,49 @@ org.metawatch.manager.APPLICATION_START
org.metawatch.manager.APPLICATION_STOP
+-------------------------------------------------------------------------------
-org.metawatch.manager.IDLE_BUTTONS_OVERRIDE
- "buttons" - byte[] // buttons to override
-
-
-
-
-
+org.metawatch.manager.VIBRATE
+ - Vibrate the watch, but don't display anything
+
+ "vibrate_on" - int // ms
+ "vibrate_off" - int // ms
+ "vibrate_cycles" - int
+
+-------------------------------------------------------------------------------
+
+org.metawatch.manager.WIDGET_UPDATE
+ - Update a widget's image from an external app
+ - Note that a widget won't automatically be displayed - the user has to
+ manually add it with the widget setup screen in MWM
+
+ "id" - Unique id for this widget - usually APPNAME_WIDTH_HEIGHT - e.g myApp_32_32
+ "desc" - Textual description of the widget - e.g. "My App (32x32)"
+ "width" - Width of the widget in pixels
+ "height" - height of the widget in pixels
+ "priority" - priority of the widget (0 if no data, >0 otherwise) - bigger means less likely to be culled for space
+ "array" - pixel array : int[width*height]
+
+===============================================================================
Broadcasted:
org.metawatch.manager.BUTTON_PRESS
+ - When in application mode:
"button" - byte
"mode" - String // ("application", "idle")
-
-
+-------------------------------------------------------------------------------
+
+org.metawatch.manager.REFRESH_WIDGET_REQUEST
+ - MWM requesting for external apps to refresh/announce any widgets
+
+ "org.metawatch.manager.get_previews"
+ - Previews are being requested, so reply with a WIDGET_UPDATE for all possible
+ widgets displaying a dummy image if necessary
+or
+ "org.metawatch.manager.widgets_desired"
+ - ArrayList<String> of the widget ids requested by the user - reply with a
+ WIDGET_UPDATE if your widget_id is in the list
+
+-------------------------------------------------------------------------------

0 comments on commit d20e877

Please sign in to comment.
Something went wrong with that request. Please try again.