X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=docs%2F4_APIs_and_Services%2F4.5_Message_Signaling%2F4_AGL_Service_Signal_Composer%2F4_SignalComposerAPI.md;fp=docs%2F4_APIs_and_Services%2F4.5_Message_Signaling%2F4_AGL_Service_Signal_Composer%2F4_SignalComposerAPI.md;h=0000000000000000000000000000000000000000;hb=eefc3ab6cbb8a5901632f46d99e13c8d90b2415d;hp=cc1688ca9359da9c2a0c170ac0e21a05e6e65ab0;hpb=4aad369c9728061c97b3de792286e743ee884b09;p=AGL%2Fdocumentation.git diff --git a/docs/4_APIs_and_Services/4.5_Message_Signaling/4_AGL_Service_Signal_Composer/4_SignalComposerAPI.md b/docs/4_APIs_and_Services/4.5_Message_Signaling/4_AGL_Service_Signal_Composer/4_SignalComposerAPI.md deleted file mode 100644 index cc1688c..0000000 --- a/docs/4_APIs_and_Services/4.5_Message_Signaling/4_AGL_Service_Signal_Composer/4_SignalComposerAPI.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -edit_link: '' -title: Signal Composer API -origin_url: >- - https://git.automotivelinux.org/apps/agl-service-signal-composer/plain/docs/part-1/4-SignalComposerAPI.md?h=master ---- - - - -# Signal Composer API - -## subscribe/unsubscribe - -Using subscribe you can get update on change for signals you chose and you can -using wildcard to subscribe several signals in the same time. - -```json -signal-composer subscribe {"signal": "rear_left*"} -ON-REPLY 1:signal-composer/subscribe: {"jtype":"afb-reply","request":{"status":"success","uuid":"3d4b743b-7ac6-4d3c-8fce-721107f9dee5"}} -``` - -Then event comes up like the following: - -```json -ON-EVENT signal-composer/257b343e-8ea9-4cd7-8f9e-1904fa77f8f2({"event":"signal-composer\/257b343e-8ea9-4cd7-8f9e-1904fa77f8f2","data":{"uid":"rear_left_door","event":"low-can\/messages.doors.rear_left.open","timestamp":4833910845032292484,"value":false},"jtype":"afb-event"}) -``` - -Unsubscribe happens the same way. When no more signals are holded by the client -then it unsubscribe from the *AGL Application Framework* event handle. - -## addObjects - -Let you add sources or signals objects to the signal composer service after -its initialization phase. Use this verb and specify the file as argument, you -could use only the file name or the file name with its absolute path. - -```json -signal-composer addObjects {"file": "sig_doors.json"} -ON-REPLY 1:signal-composer/addObjects: {"jtype":"afb-reply","request":{"status":"success","uuid":"00d7a519-816e-486a-8163-3afb1face4fa"}} -signal-composer addObjects {"file": "/tmp/sig_doors.json"} -ON-REPLY 2:signal-composer/addObjects: {"jtype":"afb-reply","request":{"status":"success"}} -``` - -You can follow the activity using the service log journal and check that the -correct number of objects has been added. - -> **CAUTION**: You need to get the following permission to be able to load new -objects : `urn:AGL:permission::platform:composer:addObjects` - -## get - -You can get a signal value be requesting the API with the verb *get*: - -```json -signal-composer get {"signal": "vehicle_speed", "options": {"average": 10}} -signal-composer get {"signal": "vehicle_speed", "options": {"minimum": 10}} -signal-composer get {"signal": "vehicle_speed", "options": {"maximum": 10}} -signal-composer get {"signal": "vehicle_speed"} -``` - -You apply some simple mathematical functions by default present in the -binding, by default **last** is used: - -- **average**: make an average on X latest seconds. -- **minimum**: return the minimum value found in the X latest seconds. -- **maximum**: return the maximum value found in the X latest seconds. -- **last**: return the latest value. - -## list - -Verb **list** will output the list of defined signals.