tequilaOS/platform_hardware_interfaces
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Merge "Linguistic fixes for broadcastradio 1.1 HAL." into oc-mr1-dev

Browse source 
am: e16fb74b05

Change-Id: I27c62f2822c3f3087556f612c1661178aecf2e71
This commit is contained in:
Tomasz Wasilczyk 2017-08-03 17:08:39 +00:00 committed by android-build-merger
commit cf0305b5bf
2 changed files with 11 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
broadcastradio/1.1/IBroadcastRadio.hal
View file

@ -31,14 +31,16 @@ interface IBroadcastRadio extends @1.0::IBroadcastRadio {
* Fetch image from radio module.
*
* This call is meant to make V1_0::MetaData lightweight - instead of
* passing image data blob in MetadataType.RAW field, only identifier is
* passed, so the client may cache images or even not fetch them.
* passing an image data blob in the MetadataType.RAW field, the HAL
* implementation only passes the identifier, so the client may cache images
* or even not fetch them.
*
* Identifier may be any arbitrary number - sequential, sha256 prefix,
* The identifier may be any arbitrary number - sequential, sha256 prefix,
* or any other unique value selected by the vendor.
*
* The data should be a valid PNG, JPEG, GIF or BMP file.
* Invalid format must be handled gracefully as if the image was missing.
* Image data with an invalid format must be handled gracefully in the same
* way as a missing image.
*
* The image identifier may become invalid after some time from passing it
* with metadata struct (due to resource cleanup at the HAL implementation).
@ -56,7 +58,7 @@ interface IBroadcastRadio extends @1.0::IBroadcastRadio {
* @param id Identifier of an image;
* value of 0 is reserved and should be treated as invalid image.
* @return image A binary blob with image data
* or zero-length vector if identifier doesn't exists.
* or a zero-length vector if identifier doesn't exist.
*/
getImage(int32_t id) generates (vec<uint8_t> image);
};

6
broadcastradio/1.1/IBroadcastRadioFactory.hal
View file

@ -19,8 +19,10 @@ package android.hardware.broadcastradio@1.1;
import @1.0::IBroadcastRadioFactory;
/**
* To use 1.1 features you must cast specific interfaces after being returned from 1.0 HAL,
* for example V1_1::ITuner::castFrom() after retrieving it from IBroadcastRadio::openTuner().
* To use 1.1 features you must cast specific interfaces returned from the
* 1.0 HAL. For example V1_0::IBroadcastRadio::openTuner() returns V1_0::ITuner,
* which can be cast with V1_1::ITuner::castFrom() call.
*
* The 1.1 server must always return the 1.1 version of specific interface.
*/
interface IBroadcastRadioFactory extends @1.0::IBroadcastRadioFactory {