New config: betty.json

Betty is the VM image used for internal tests.
The Tast test "firmware.Config" has been failing on betty boards because
there is no betty.json config file.
According to go/goldeneye-devices, betty's reference board is auron, so
this CL creates a betty config that inherits from auron.


Change-Id: Ic3e6d8f671b46e7a307130413123b10b74f30d5f
Tested-by: Greg Edelston <>
Reviewed-by: Kevin Shelton <>
Commit-Queue: Greg Edelston <>
1 file changed
tree: 5b8193f61c4e5736c1815e6f20bcd40e4db7abbc
  1. DEFAULTS.json
  4. arkham.json
  5. asuka.json
  6. atlas.json
  7. auron.json
  8. banjo.json
  9. banon.json
  10. betty.json
  11. bob.json
  12. brain.json
  13. buddy.json
  14. candy.json
  15. caroline.json
  16. cave.json
  17. celes.json
  18. chell.json
  19. cheza.json
  20. cid.json
  21. coral.json
  22. cyan.json
  23. dragonegg.json
  24. drallion.json
  25. edgar.json
  26. elm.json
  27. enguarde.json
  28. eve.json
  29. expresso.json
  30. fievel.json
  31. fizz.json
  32. gale.json
  33. gandof.json
  34. glados.json
  35. gnawty.json
  36. gru.json
  37. grunt.json
  38. guado.json
  39. gus.json
  40. hana.json
  41. hatch.json
  42. heli.json
  43. jacuzzi.json
  44. jaq.json
  45. jecht.json
  46. jerry.json
  47. jetstream.json
  48. kalista.json
  49. kefka.json
  50. kevin-tpm2.json
  51. kevin.json
  52. kevin64.json
  53. kip.json
  54. kitty.json
  55. kukui.json
  56. kunimitsu.json
  57. lars.json
  58. lulu.json
  59. mickey.json
  60. mighty.json
  61. minnie.json
  62. mistral.json
  63. monroe.json
  64. nami.json
  65. nasher.json
  66. nautilus.json
  67. ninja.json
  68. nocturne.json
  69. nyan.json
  70. oak.json
  71. octopus.json
  72. orco.json
  73. paine.json
  74. pinky.json
  75. poppy.json
  76. puff.json
  77. pyro.json
  78. rambi.json
  79. rammus.json
  80. reef.json
  81. reef_uni.json
  82. reks.json
  83. relm.json
  84. rikku.json
  85. samus.json
  86. sand.json
  87. sarien.json
  88. scarlet.json
  89. sentry.json
  90. setzer.json
  91. slippy.json
  92. snappy.json
  93. soraka.json
  94. speedy.json
  95. storm.json
  96. strago.json
  97. sumo.json
  98. swanky.json
  99. terra.json
  100. tidus.json
  101. tiger.json
  102. trogdor.json
  103. ultima.json
  104. umaro.json
  105. veyron.json
  106. volteer.json
  107. whirlwind.json
  108. winky.json
  109. wizpig.json
  110. yuna.json
  111. zork.json

CrOS fw-testing-configs: User’s Guide



End-to-end firmware testing in ChromeOS relies on board-specific configuration files. Previously, those files were stored in Autotest. Now, they have been moved into a separate repository, fw-testing-configs, so that other testing frameworks (e.g. Tast, SerialTest) can access them too.

The design document for the new repository is at go/cros-fw-testing-configs.

Working With Configs

File Locations & Names

All the config files are located at the top directory of the fw-testing-configs repository.

The fw-testing-configs repository currently has two checkouts in the ChromeOS manifest: one inside of Autotest, and one inside of tast-tests.

There is one config file for each platform, named as ${PLATFORM}.json: for example, octopus.json. There is also one special config file, DEFAULTS.json, which contains default values and documentation for each attribute. (For now, platform names are defined according to mosys platform name.)

File Contents

Each config file should contain a single object whose fields override the values specified in DEFAULTS.json. Any fields which do not have a corresponding value in DEFAULTS.json will be ignored.

There are a few special fields to be aware of:

  • platform (required): A string which should exactly match the config file’s basename (minus the .json extension).
  • parent (optional): A string which can contain the name of a parent platform, whose fields will be inherited with lower precedence. See “Inheritance” below. Example: asuka.json
  • models (optional): An object which can contain the names of any models, whose fields will be inherited with higher precedence. See “Inheritance” below. Example: octopus.json


There is an inheritance model in these config files. In all cases, the most specific configuration is used:

[Model > ] Platform [ > Parent [...] ] > DEFAULTS

For each attribute that exists in DEFAULTS.json (besides the documentation attributes):

  • If that attribute is given a value in the platform’s models[${MODEL}], then that is the value that is used.
  • Otherwise, if that attribute is given a value in the ${PLATFORM}.json, then that is the value that is used.
  • Otherwise, if ${PLATFORM}.json specifies a parent configuration via the parent attribute, then that is the value that is used.
  • Parent configurations can specify parents as well, and the inheritance recurses until a config file does not have a parent attribute.
  • Finally, for any attribute which was not otherwise given a value, the value from DEFAULTS.json is used.

Accessing Configs

In Autotest, configs are loaded during FirmwareTest.initialize. Config values can be accessed via self.faft_config.${ATTRIBUTE}, such as self.faft_config.chrome_ec.

In Tast, configs can be created via firmware.NewConfig. In order to conform with Go’s style, attribute names are modified to MixedCaps. Config values can be accessed via cfg[${ATTRIBUTE}], such as cfg[ChromeEC].

Modifying Tests and Configs

Configs are now in a separate repository from Autotest or tast-tests. Thus, config edits now require a separate CL from Autotest/tast-tests edits. If you are accustomed to working with config files directly in Autotest, this is a slightly different workflow.

When you are editing config files, please be sure to run git commands from within the fw-testing-configs checkout. If you run git add . or repo upload --cbr . from within autotest/server/cros/faft/, then your changes to the config files will not be captured.

If you are modifying both test files and config files, then you will need at least two CL’s: one for the test change, and one for the fw-testing-configs change. Consider also whether your change will impact the other testing repositories (Autotest, Tast, SerialTest): you might need to run tests or make changes there, too.

When submitting multiple CL’s like that, please use the Cq-Depend syntax as appropriate. If you don‘t use Cq-Depend, you risk the name of a config attribute changing while tests are still looking for the old name, and then tests will break. The reverse is a risk, too. You might need both CL’s to depend on each other. Note that this while this precaution mitigates risk, it does not fully eliminate risk: only one of the CL’s might get uploaded to the lab machines running Autotest/Tast, or one CL may be reverted without the other.