Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / tools / hidl / 71ce008bf97864c3ed6f86715bc1e7ca44ef8435
commit71ce008bf97864c3ed6f86715bc1e7ca44ef8435[log] [tgz]
authorNirav Atre <natre@google.com>Wed Aug 01 15:39:49 2018 -0700
committerNirav Atre <natre@google.com>Thu Aug 02 13:45:55 2018 -0700
tree23fdb2d2391fa511db5dcc5fe9203074d34d83c4
parent7c537a7cf0511c67783d6547b4b61eb4e682757d [diff]
Move hidl_no_init (for HIDL Safe Unions) to index 0

This change moves hidl_no_init (which was previously the last element in
the hidl_discriminator enum) to index 0. Also generates some comments to
facilitate readability.

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