X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=doc%2Fafb-plugins-overview.html;h=8c7b50fa1a1085af55fe8e1ec41bf504b8ca847f;hb=917b85d762e00662460da5e74b89d43d3355f2ef;hp=b3236886a95c8e9974d53bca0af4345157ec9dd1;hpb=0156b1645a201e44d5285c96d32cbfa5a9eb6814;p=src%2Fapp-framework-binder.git diff --git a/doc/afb-plugins-overview.html b/doc/afb-plugins-overview.html index b3236886..8c7b50fa 100644 --- a/doc/afb-plugins-overview.html +++ b/doc/afb-plugins-overview.html @@ -15,13 +15,17 @@ Author: Manuel Bachmann

List of plugins

-

Here are the plugins shipped in the source tree: - * Hello World - * Authentication - * Tic Tac Toe - * Audio (2 backends: ALSA/PulseAudio) - * Radio (1 backend: RTLSDR RTL2832U) - * Media (1 backend: Rygel UPnP)

+

Here are the plugins shipped in the source tree:

+ + +

All plugins may not be built, depending on the development libraries present on the system at build time.

@@ -35,13 +39,17 @@ Author: Manuel Bachmann

This plugin provides a few unauthenticated requests, all beginning with “ping”, to demonstrate basic binder capabilities.

-

Verbs: -* ping: returns a success response -* pingfail: returns a failure response -* pingnull: returns a success response, with an empty JSON response field -* pingbug: does a memory violation (intercepted by the binder) -* pingJson: returns a success response, with a complex JSON response field -* pingevent: broadcasts a global event

+

Verbs:

+ + +


@@ -54,12 +62,16 @@ Author: Manuel Bachmann

Calling “connect” with a security token will initiate a session, calling “refresh” will issue a new token and invalidate the previous one, calling “logout” will invalidate all tokens and close the session.

-

Verbs: -* ping: returns a success response -* connect: creates a session and returns a new token -* refresh: returns a new token -* check: verifies the passed token is valid -* logout: closes the session

+

Verbs:

+ + +


@@ -70,34 +82,46 @@ Author: Manuel Bachmann

This plugin provides an interactive Tic Tac Toe game where the binder returns the grid as a JSON response.

-

Verbs: -* new: starts a new game -* play: asks the server to play -* move: gives a client move -* board: gets the current board state, as a JSON structure -* level: sets the server level -* join: joins an existing board -* undo: undo the last move -* wait: wait for a move

+

Verbs:

+ + +


Audio

-

A sample Audio plugin with 2 backends: - * ALSA (mandatory) - * PulseAudio (optional)

+

A sample Audio plugin with 2 backends:

+ + +

This plugin is able to initialize a specific soundcard, define volume levels, channels (mono/stereo…), mute sound, and play a 22,050 Hz PCM stream.

-

Verbs: -* ping: returns a success response -* init: initializes backend, on the “default” sound card -* volume: gets or sets volume, in % (0-100) -* channels: gets or sets channels count (1-8) -* mute: gets or sets the mute status (on-off) -* play: gets or sets the playing status (on-off)

+

Verbs:

+ + +

(if PulseAudio development libraries are not found at build time, only ALSA will be available)

@@ -110,19 +134,27 @@ Author: Manuel Bachmann

Radio

-

A sample AM/FM Radio plugin with 1 backend: - * RTLSDR - Realtek RTL2832U dongles (mandatory)

+

A sample AM/FM Radio plugin with 1 backend:

+ + +

This plugin is able to initialize specific RTL2832U dongles, switch between AM/FM modes, define frequency, mute sound, and play sound (if combining with the audio plugin).

-

Verbs: -* ping: returns a success response -* init: initializes backend, looking for plugged-in devices -* power: sets device power status (on-off) -* mode: sets device reception mode (AM-FM) -* freq: sets device frequency (in Hz) -* mute: sets device mute status (on-off) -* play: sets device playing status (on-off)

+

Verbs:

+ + +

(if rtlsdr development libraries are not found at build time, this plugin will not be built)

@@ -131,21 +163,29 @@ Author: Manuel Bachmann

Media

-

A sample Media Server plugin with 1 backend: - * Rygel

+

A sample Media Server plugin with 1 backend:

+ + +

This plugin is able to detect a local Rygel UPnP media server, list audio files, select an audio file for playback, play/pause/seek in this file, upload an audio file to the server.

-

Verbs: -* ping: returns a success response -* init: initializes backend, looking for an active local UPnP server -* list: returns list of audio files, as a JSON structure -* select: select an audio files, by index number (001-…) -* play: plays the currently selected audio file -* stop: stops the currently selected audio file -* pause: pauses the currently selected audio file -* seek: seeks in the currently selected audio file, in seconds -* upload: uploads an audio file, with a POST request

+

Verbs:

+ + +

(if GUPnP/GSSDP development libraries are not fund at build time, this plugin will not be built)