Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / tools / hidl / 7fa8426acd2069ab8cb780c7b04c2f19ababfca4
commit7fa8426acd2069ab8cb780c7b04c2f19ababfca4[log] [tgz]
authorSteven Moreland <smoreland@google.com>Wed Sep 26 17:12:14 2018 -0700
committerSteven Moreland <smoreland@google.com>Wed Sep 26 17:12:14 2018 -0700
tree4c437f5dee9955e83c1ad138ad9196b9b0bbb9f2
parent0432ce874c61425ec84292e28dfd66cdd74933ed [diff]
c++-impl/androidbp-impl: add license reminder

A very common problem for HIDL interfaces is a forgotten license or
other file header that is appropriate for the interface in question,
so adding a friendly reminder here.

Test: hidl_impl_test
Test: These commands and manually inspect output:
  hidl-gen -o tmp -Lc++-impl android.hardware.nfc@1.0
  hidl-gen -o tmp -Landroidbp-impl android.hardware.nfc@1.0

Change-Id: If2253a59701e24b23570c2633b20188fdd29715f
Fixes: 116680263
2 files changed
tree: 4c437f5dee9955e83c1ad138ad9196b9b0bbb9f2
  1. build/
  2. c2hal/
  3. docs/
  4. hashing/
  5. host_utils/
  6. scripts/
  7. test/
  8. utils/
  9. .clang-format
  10. Android.bp
  11. Annotation.cpp
  12. Annotation.h
  13. ArrayType.cpp
  14. ArrayType.h
  15. AST.cpp
  16. AST.h
  17. CleanSpec.mk
  18. CompoundType.cpp
  19. CompoundType.h
  20. ConstantExpression.cpp
  21. ConstantExpression.h
  22. Coordinator.cpp
  23. Coordinator.h
  24. DeathRecipientType.cpp
  25. DeathRecipientType.h
  26. DocComment.cpp
  27. DocComment.h
  28. EnumType.cpp
  29. EnumType.h
  30. FmqType.cpp
  31. FmqType.h
  32. generateCpp.cpp
  33. generateCppAdapter.cpp
  34. generateCppImpl.cpp
  35. generateJava.cpp
  36. generateVts.cpp
  37. HandleType.cpp
  38. HandleType.h
  39. hidl-gen_l.h
  40. hidl-gen_l.ll
  41. hidl-gen_y.yy
  42. HidlTypeAssertion.cpp
  43. HidlTypeAssertion.h
  44. Interface.cpp
  45. Interface.h
  46. Location.cpp
  47. Location.h
  48. main.cpp
  49. MemoryType.cpp
  50. MemoryType.h
  51. Method.cpp
  52. Method.h
  53. MODULE_LICENSE_APACHE2
  54. NamedType.cpp
  55. NamedType.h
  56. NOTICE
  57. OWNERS
  58. PointerType.cpp
  59. PointerType.h
  60. PREUPLOAD.cfg
  61. README.md
  62. Reference.h
  63. RefType.cpp
  64. RefType.h
  65. ScalarType.cpp
  66. ScalarType.h
  67. Scope.cpp
  68. Scope.h
  69. StringType.cpp
  70. StringType.h
  71. Type.cpp
  72. Type.h
  73. TypeDef.cpp
  74. TypeDef.h
  75. update-all-google-makefiles.sh
  76. update-makefiles-helper.sh
  77. VectorType.cpp
  78. VectorType.h
README.md

hidl-gen

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.

1. Build

m hidl-gen

2. Run

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).

c2hal

This is a helper tool to convert C headers to valid .hal files.

m c2hal && c2hal -h

docs

This tool generates html documentation for hal interfaces.

m hidl-doc && hidl-doc -h