commit | 12c597aa5ab493b47d4558fac1f63b16827895dc | [log] [tgz] |
---|---|---|
author | Nirav Atre <natre@google.com> | Thu Jun 28 09:35:24 2018 -0700 |
committer | Nirav Atre <natre@google.com> | Thu Jun 28 10:16:43 2018 -0700 |
tree | 09083a732f330ce1cc1c3030ca263348c151f0de | |
parent | c161b91a94877a2a37175e2c4334a45bb5b7d0ed [diff] |
Interchange union/discriminator positions in HIDL safe unions This change swaps the positions of the union and discriminator in HIDL safe_unions (new layout: discriminator, followed by the actual union). This is necessary for unmarshalling certain types of parcels in Java (ones containing interfaces), where the parcel contents are parsed sequentially. In such cases, the discriminator value must be known before the payload-specific functionality can be invoked. Bug: 79878527 Test: Ran make and the hidl-test suite Change-Id: Id65384681aef6bd72d4213073bf786674ed8cb22
Full documentation can be found here: https://source.android.com/devices/architecture/hidl/
hidl-gen is a compiler for the HIDL (HAL Interface Design Language) which generates C++ and Java endpoints for RPC mechanisms. The main userspace libraries which this compiler uses can be found at system/libhidl.
m hidl-gen
Note that options for hidl-gen expected to be invoked by the build system are marked with 'internal' in the help menu.
hidl-gen -h hidl-gen -o output -L c++-impl -r android.hardware:hardware/interfaces -r android.hidl:system/libhidl/transport android.hardware.nfc@1.0
Some defaults for package roots are also provided
hidl-gen -o output -L c++-impl android.hardware.nfc@1.0 hidl-gen -o output -L vts android.hardware.nfc@1.0 hidl-gen -L hash android.hardware.nfc@1.0
Example command for vendor project
hidl-gen -L c++-impl -r vendor.foo:vendor/foo/interfaces vendor.foo.nfc@1.0
See update-makefiles-helper.sh and update-all-google-makefiles.sh for examples of how to generate HIDL makefiles (using the -Landroidbp option).
This is a helper tool to convert C headers to valid .hal files.
m c2hal && c2hal -h
This tool generates html documentation for hal interfaces.
m hidl-doc && hidl-doc -h