Google Git
Sign in
android / platform / system / tools / hidl / refs/tags/android-s-preview-1
tag2dd75088fca8df489ae61e464cc432d3cc04b9c1
taggerThe Android Open Source Project <initial-contribution@android.com>Thu Feb 18 09:59:28 2021 -0800
objectd84d7d07bd801c98522bed1c7aabc7b89b8d664f 
Android S Preview 1
commitd84d7d07bd801c98522bed1c7aabc7b89b8d664f[log] [tgz]
authorSteven Moreland <smoreland@google.com>Thu Feb 18 00:55:52 2021 +0000
committerSteven Moreland <smoreland@google.com>Thu Feb 18 01:04:47 2021 +0000
treef066799f5e469116cb2c036fb2d3ce2643df85e1
parent6022c509a2fb66a0c0ac1744037ee8f802fe01df [diff]
Better error for empty -Ljava-constants

If someone accidentally includes gen_java_constants (-Ljava-constants)
in their Android.bp file, this used to emit a cryptic error about
depfiles since hidl-gen didn't make the expected dir hierarchy). Even
if that were fixed, we would have to emit an empty/bare Constants.java
file, which isn't so nice (and anyway, -Ljava-constants is not needed at
all - it was to work around a frameworks.jar dependency loop which is
now fixed via hwbinder.stubs). So now instead of doing nothing,
explicitly returning an error.

Bug: 180023307
Test: manual
Change-Id: I7ddc9e520ccd107d03a6073b94dbc2a44f206e7d
1 file changed
tree: f066799f5e469116cb2c036fb2d3ce2643df85e1
  1. build/
  2. c2hal/
  3. hashing/
  4. hidl2aidl/
  5. host_utils/
  6. lint/
  7. metadata/
  8. scripts/
  9. test/
  10. utils/
  11. .clang-format ⇨ ../../../build/soong/scripts/system-clang-format
  12. Android.bp
  13. Annotation.cpp
  14. Annotation.h
  15. ArrayType.cpp
  16. ArrayType.h
  17. AST.cpp
  18. AST.h
  19. CleanSpec.mk
  20. CompoundType.cpp
  21. CompoundType.h
  22. ConstantExpression.cpp
  23. ConstantExpression.h
  24. Coordinator.cpp
  25. Coordinator.h
  26. DeathRecipientType.cpp
  27. DeathRecipientType.h
  28. DocComment.cpp
  29. DocComment.h
  30. EnumType.cpp
  31. EnumType.h
  32. FmqType.cpp
  33. FmqType.h
  34. FormattingConstants.h
  35. generateCpp.cpp
  36. generateCppAdapter.cpp
  37. generateCppImpl.cpp
  38. generateDependencies.cpp
  39. generateFormattedHidl.cpp
  40. generateInheritanceHierarchy.cpp
  41. generateJava.cpp
  42. generateJavaImpl.cpp
  43. generateVts.cpp
  44. HandleType.cpp
  45. HandleType.h
  46. hidl-gen_l.h
  47. hidl-gen_l.ll
  48. hidl-gen_y-helpers.h
  49. hidl-gen_y.yy
  50. HidlTypeAssertion.cpp
  51. HidlTypeAssertion.h
  52. Interface.cpp
  53. Interface.h
  54. Location.cpp
  55. Location.h
  56. main.cpp
  57. MemoryType.cpp
  58. MemoryType.h
  59. Method.cpp
  60. Method.h
  61. NamedType.cpp
  62. NamedType.h
  63. NOTICE
  64. OWNERS
  65. PointerType.cpp
  66. PointerType.h
  67. PREUPLOAD.cfg
  68. README.md
  69. Reference.h
  70. ScalarType.cpp
  71. ScalarType.h
  72. Scope.cpp
  73. Scope.h
  74. StringType.cpp
  75. StringType.h
  76. TEST_MAPPING
  77. Type.cpp
  78. Type.h
  79. TypeDef.cpp
  80. TypeDef.h
  81. update-all-google-makefiles.sh
  82. update-makefiles-helper.sh
  83. VectorType.cpp
  84. 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).

NOTE: When using the -Landroidbp option, you can force generated modules to be installed in /system_ext rather than other partition by putting a marker file .hidl_for_system_ext alongside *.hal files.

NOTE: You can also install the vendor variant of the generated modules to be installed in /odm rather than /vendor by putting a marker file .hidl_for_odm alongside *.hal files.

c2hal

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

m c2hal && c2hal -h