CrOS EC Tester

Copyright (c) 2020-2024 Antmicro

EC Tester presents the testing workflow for ChromiumOS Embedded Controller software. It uses GitHub Actions for handling the execution and Renode for testing.

Based on precompiled EC binaries and tests, Renode runs each available binary, waits for the system image to load, and issues the ztest run-all command.

After that, we await the PROJECT EXECUTION SUCCESSFUL string to be printed out.

These tests verify the sanok target.

Renode documentation

Please go to docs.renode.io for documentation on Renode usage.

How to use this repository?

Preparing the repository

Before using the repository you first have to prepare it by downloading precompiled EC test binaries. This repository provides nightly builds of all tests for the sanok target using GitHub Actions.

To download them first navigate to the Actions tab then click on the top-most run. There will be a Artifacts box on the bottom of the page, there click on test-binaries this will start a download of a zip file with all prebuilt binaries required to run the tests.

The contents of the archive need to be unpacked into a directory called artifacts that should be created in the root of the repository.

After those files are in place you need to run a Python script - generate_tests.py to generate *.robot files with tests for the platform and a tests.yml, that can be used to run all tests for the platform. After running the script, test binaries will be copied to appropriate locations and the artifacts directory can be removed.

Renode-run

The simplest but least flexible way of running these tests requires you to work on Linux and have Python3 and pip installed:

$ pip3 install --user git+https://github.com/antmicro/renode-run
$ renode-run test -- -t tests.yml

You can run Renode interactively simply using:

$ renode-run

Portable package

Go to https://builds.renode.io/ and look for the renode-latest.* package that matches your operating system.

For Linux, the Linux Portable package is preferred.

After you unpack or install the package, ensure that it's available in your $PATH and run tests using:

$ renode-test -t tests.yml

or run Renode interactively using:

$ renode

Interactive usage

When starting Renode interactively, you can load a script you want with the include command:

(monitor) include @sanok.resc
(monitor) start

Both include and start commands can be abbreviated to i and s, respectively.

To provide your own binaries, you have to overwrite the binary directory variable, a directory that should contain the binary itself and two ELF files with symbols:

(monitor) $bin=@path/to/your/bins/dir/
(monitor) i @sanok.resc

Repository structure

The repository consists of the following elements:

• stm32f412.repl, stm32h743.repl - platform files for, respectively, bloonchipper and dartmonkey.
• sanok.resc, bloonchipper.resc, dartmonkey.resc - script files to load in Renode, defining the simulation environment.
• generate_tests.py - script creating *.robot test suites based on available test binaries. It also generates tests.yml listing all test suites to run in a single Renode call.
• template.robot - template used by generate_tests.py.
• bloonchipper/ - directory containing the main ec.bin build, along with ec.RO.elf and ec.RW.elf. The ELF files are used to provide symbol names. After running generate_tests.py test binaries will also be placed in this directory.

Similar structure is created for dartmonkey/.