1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
# Zephyr EC
[TOC]
## Introduction
Zephyr EC is an effort to create an industry-standard Embedded Controller
implementation for use primarily on laptops. It is born out of the Chromium OS
EC.
## native-posix development
Zephyr can be built to run on your host machine, making it easier to develop
and test features. This is called the native_posix build.
To build it::
```
cd ~/chromium/src/platform/ec
zmake build minimal-posix
```
and run it:
```
build/zephyr/minimal-posix/build-singleimage/zephyr/zephyr.elf
```
Check the display for the pseudotty and connect an xterm to it, e.g.:
```
xterm -e screen /dev/pts/28
```
You will then see the EC prompt and you can type commands, e.g. type 'help':
```
Please press the <Tab> button to see all available commands.
You can also use the <Tab> button to prompt or auto-complete all commands or its subcommands.
You can try to call commands with <-h> or <--help> parameter for more information.
Available commands:
cbi :Print or change Cros Board Info from flash
chan :Save, restore, get or set console channel mask
crash :Crash the system (for testing)
feat :Print feature flags
gettime :Print current time
gpioget :Read GPIO value(s)
gpioset :Set a GPIO
help :Prints the help message.
hibernate :Hibernate the EC
kernel :Kernel commands
log :Commands for controlling logger
md :dump memory values, optionally specifying the format
panicinfo :Print info from a previous panic
reboot :Reboot the EC
rw :Read or write a word in memory optionally specifying the size
shmem :Print shared memory stats
sysinfo :Print system info
syslock :Lock the system, even if WP is disabled
timerinfo :Print timer info
version :Print versions
waitms :Busy-wait for msec (large delays will reset)
```
Use Ctrl-C to quit (from the main terminal) as normal.
You can run zephyr under gdb just like any other program.
If you want to share the same terminal, add this line to
`zephyr/program/minimal/prj.conf` and rebuild:
```
CONFIG_NATIVE_UART_0_ON_STDINOUT=y
```
Running that will show an EC prompt on your terminal. Use Ctrl-\ to quit.
## Gitlab integration
As an experiment we have a basic gitlab integration. It watches the EC repo and
kicks of a build when new commits appear. So far it just builds for volteer and
does not run any tests. For firmware branches, it also builds, but fails.
The gitlab builder works without a chroot and uses the Zephyr toolchain. This
is intended to ensure that we have a path to upstreaming our code eventually and
do not rely on Chrome OS-specific tools. It does make use of 'zmake', however.
See the piplines [here](https://gitlab.com/zephyr-ec/ec/-/pipelines).
## CQ builder
To test the cq builder script run these commands:
### firmware-zephyr-cq
```
rm -rf /tmp/artifact_bundles /tmp/artifact_bundle_metadata \
~/chromiumos/src/platform/ec/build
( cd ~/chromiumos/src/platform/ec/zephyr ; \
./firmware_builder.py --metrics /tmp/metrics-build build && \
./firmware_builder.py --metrics /tmp/metrics-test test && \
./firmware_builder.py --metrics /tmp/metrics-bundle bundle && \
echo PASSED )
cat /tmp/artifact_bundle_metadata
cat /tmp/metrics-build
ls -l /tmp/artifact_bundles/
```
### firmware-zephyr-cov-cq
```
rm -rf /tmp/artifact_bundles-cov /tmp/artifact_bundle_metadata-cov \
~/chromiumos/src/platform/ec/build && \
cd ~/chromiumos/src/platform/ec/zephyr && \
./firmware_builder.py --metrics /tmp/metrics --code-coverage build && \
./firmware_builder.py --metrics /tmp/metrics --code-coverage test && \
./firmware_builder.py --metrics /tmp/metrics --code-coverage \
--output-dir=/tmp/artifact_bundles-cov \
--metadata=/tmp/artifact_bundle_metadata-cov bundle && \
echo PASSED
cat /tmp/artifact_bundle_metadata-cov
ls -l /tmp/artifact_bundles-cov
```
## Zmake unit tests
Run the tests with `zephyr/zmake/run_tests.sh`. You can generate a coverage
report, but not in the chroot, as some pip modules are missing there.
The [latest coverage report](https://gitlab.com/zephyr-ec/ec/-/jobs/artifacts/main/file/zephyr/zmake/htmlcov/index.html?job=zmake_coverage
) is on gitlab.
You can run the coverage report outside of the chroot easily:
```
# Install test dependencies
cd ~/chromiumos/src/platform/ec
python3 -m pip install 'zephyr/zmake[tests]' --user
# Run tests with coverage
cd ~/chromiumos/src/platform/ec/zephyr/zmake
coverage run --source=zmake -m pytest .
coverage report
coverage html
xdg-open htmlcov/index.html
```
|
