Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / tools / hidl / f1a4303ebf677f55e45ed83e6e613f4a0744e751
commitf1a4303ebf677f55e45ed83e6e613f4a0744e751[log] [tgz]
authorNeel Mehta <mneel@google.com>Thu Jun 06 10:57:26 2019 -0700
committerNeel Mehta <mneel@google.com>Mon Jun 17 20:28:49 2019 -0700
tree34f130aa86f73340c14c2cc3d6a678584e2c65ea
parent8b8bc9ac4d7083d1b0899f67d93120891e22eaff [diff]
Added lint for method versioning conventions

Methods should only be named method_X_Y when they are replacing the
functionality of some other method in their superTypeChain.
This lint ensures that the naming is accurate and only used to replace
the functionality of some other method.

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