Skip to content
Snippets Groups Projects
Commit 77bb9aa4 authored by Ricardo Cañuelo's avatar Ricardo Cañuelo
Browse files

boards: Fixes and updates to chromebook docs


  - Fix some typos.

  - Update the docs about flashing and the debugging interfaces to
    reflect the latest changes in the internal collabora-lava-setup
    docs.

  - Add device-specific info about the actual devices present in the
    Collabora LAVA lab.

Signed-off-by: default avatarRicardo Cañuelo <ricardo.canuelo@collabora.com>
parent f7ab2ff6
No related branches found
No related tags found
No related merge requests found
Pipeline #18224 passed
...@@ -123,7 +123,7 @@ ACTION=="add", SUBSYSTEMS=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="50 ...@@ -123,7 +123,7 @@ ACTION=="add", SUBSYSTEMS=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="50
# Servo Micro # Servo Micro
ACTION=="add", SUBSYSTEMS=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="501a", ENV{MAJOR}=="189", TAG+="systemd", ENV{SYSTEMD_WANTS}+="google-servo@$name.service", ENV{ID_MODEL}="Google Servo Micro control board %n" ACTION=="add", SUBSYSTEMS=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="501a", ENV{MAJOR}=="189", TAG+="systemd", ENV{SYSTEMD_WANTS}+="google-servo@$name.service", ENV{ID_MODEL}="Google Servo Micro control board %n"
# Cr50 (Case Close Debugging) # Cr50 (Closed Case Debugging)
ACTION=="add", SUBSYSTEMS=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="5014", ENV{MAJOR}=="189", TAG+="systemd", ENV{SYSTEMD_WANTS}+="google-servo@$name.service", ENV{ID_MODEL}="Google Cr50 %n" ACTION=="add", SUBSYSTEMS=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="5014", ENV{MAJOR}=="189", TAG+="systemd", ENV{SYSTEMD_WANTS}+="google-servo@$name.service", ENV{ID_MODEL}="Google Cr50 %n"
``` ```
......
...@@ -3,7 +3,7 @@ title: Closed Case Debugging (CCD) ...@@ -3,7 +3,7 @@ title: Closed Case Debugging (CCD)
weight: 2 weight: 2
--- ---
Early Chromebooks models have a special debug connector on their Early Chromebook models have a special debug connector on their
motherboard to interface with Servo Micro boards. This connector is not motherboard to interface with Servo Micro boards. This connector is not
fitted on production devices, so a rework is necessary to add it. Newer fitted on production devices, so a rework is necessary to add it. Newer
models support the Closed Case Debugging (CCD) feature, using USB models support the Closed Case Debugging (CCD) feature, using USB
...@@ -27,7 +27,7 @@ purposefully wants to enable it. ...@@ -27,7 +27,7 @@ purposefully wants to enable it.
## Connecting a CCD interface ## Connecting a CCD interface
The first step is to connect the host computer (laptop, NUC dispatcher...) to The first step is to connect the host computer (laptop, NUC dispatcher...) to
the Chromebook using a CCD-pcapable USB Type-C interface. Each type of the Chromebook using a CCD-capable USB Type-C interface. Each type of
interface has its own particularities as described below. interface has its own particularities as described below.
### Connecting with SuzyQ ### Connecting with SuzyQ
...@@ -43,7 +43,7 @@ Run the following command in terminal to watch for new devices: ...@@ -43,7 +43,7 @@ Run the following command in terminal to watch for new devices:
sudo dmesg -w sudo dmesg -w
``` ```
Connect the Type-A USB end of the Suzy-Q to the host (laptop, NUC Connect the Type-A USB end of the SuzyQ to the host (laptop, NUC
dispatcher...). A `SuzyQable` device should be detected as shown below: dispatcher...). A `SuzyQable` device should be detected as shown below:
``` ```
[386753.698883] usb 1-2: new high-speed USB device number 49 using xhci_hcd [386753.698883] usb 1-2: new high-speed USB device number 49 using xhci_hcd
...@@ -54,7 +54,7 @@ dispatcher...). A `SuzyQable` device should be detected as shown below: ...@@ -54,7 +54,7 @@ dispatcher...). A `SuzyQable` device should be detected as shown below:
[386753.867518] usb 1-2: SerialNumber: 0004002101BC [386753.867518] usb 1-2: SerialNumber: 0004002101BC
``` ```
Then connect the Type-C end of the Suzy-Q cable to the Chromebook. A `Cr50` Then connect the Type-C end of the SuzyQ cable to the Chromebook. A `Cr50`
device should be detected by the host in the format of the list below: device should be detected by the host in the format of the list below:
``` ```
[387078.927146] usb 1-2.2: new full-speed USB device number 51 using xhci_hcd [387078.927146] usb 1-2.2: new full-speed USB device number 51 using xhci_hcd
......
...@@ -22,27 +22,13 @@ documentation. Typically, all the LAVA rack dispatchers in the lab will ...@@ -22,27 +22,13 @@ documentation. Typically, all the LAVA rack dispatchers in the lab will
have these packages automatically installed by Chef. have these packages automatically installed by Chef.
### Install flash tools ### Install the firmware tools
To install the tools needed to flash the Chromebook firmware images: To install the tools needed to flash the Chromebook firmware images
follow [these
- Install the required dependency packages: instructions](https://gitlab.collabora.com/chromium/firmware-tools/-/blob/master/README.md#installing)
``` from the firmware tools README. This can be run on a dispatcher itself
apt install git-lfs in the lab, to be able to then flash Chromebook devices directly.
```
- Clone the flash-tools repository and fetch binaries:
```
git clone https://gitlab.collabora.com/chromium/flash-tools.git
cd flash-tools
git lfs fetch
git lfs checkout
```
This includes the `flashrom` binary with its library dependencies and
the
[`servoflash.py`](https://gitlab.collabora.com/chromium/firmware-tools/-/blob/master/servoflash.py)
script to actually flash Chromebook firmware images via Servo boards.
## Flashing a firmware image ## Flashing a firmware image
...@@ -52,14 +38,19 @@ They are all currently all stored in ...@@ -52,14 +38,19 @@ They are all currently all stored in
[images.collabora.co.uk](https://images.collabora.co.uk/lava/boot) and [images.collabora.co.uk](https://images.collabora.co.uk/lava/boot) and
need to be downloaded manually. need to be downloaded manually.
See the general [flashing
instructions](https://gitlab.collabora.com/chromium/firmware-tools/-/blob/master/README.md#flashing)
from the firmware tools README, and the specific ones for the Collabora
test lab below.
For example, to flash the firmware for a `rk3399-gru-kevin` device: For example, to flash the firmware for a `rk3399-gru-kevin` device:
* SSH to the dispatcher where the device is attached and enter * SSH to the dispatcher where the device is attached and enter
flash-tools firmware-tools
``` ```
ssh lava-rack-cbg-2 ssh lava-rack-cbg-2
cd flash-tools cd firmware-tools
``` ```
* Download the firmware file * Download the firmware file
...@@ -72,7 +63,9 @@ For example, to flash the firmware for a `rk3399-gru-kevin` device: ...@@ -72,7 +63,9 @@ For example, to flash the firmware for a `rk3399-gru-kevin` device:
and the matching firmware file: and the matching firmware file:
``` ```
./servoflash.py --device=rk3399-gru-kevin-cbg-0 --firmware=depthcharge-rk3399-gru-kevin-20180806.dev.bin ./servoflash.py \
--device=rk3399-gru-kevin-cbg-0 \
--firmware=depthcharge-rk3399-gru-kevin-20180806.dev.bin
``` ```
It can take a few minutes. There should be these messages around the It can take a few minutes. There should be these messages around the
......
...@@ -25,7 +25,7 @@ from the branch above. More info ...@@ -25,7 +25,7 @@ from the branch above. More info
[here](https://gitlab.collabora.com/chromium/firmware-tools). [here](https://gitlab.collabora.com/chromium/firmware-tools).
# Chromebook bootup in a LAVA setup ## Chromebook bootup in a LAVA setup
Chromebooks used in a LAVA environment will boot a Linux kernel through Chromebooks used in a LAVA environment will boot a Linux kernel through
TFTP. In order to do this, LAVA will access the Depthcharge CLI through TFTP. In order to do this, LAVA will access the Depthcharge CLI through
......
...@@ -15,6 +15,11 @@ The specs for these chromebooks vary in terms of display, connectivity ...@@ -15,6 +15,11 @@ The specs for these chromebooks vary in terms of display, connectivity
and devices, but they are based on Intel Apollo Lake 64 bit CPUs and devices, but they are based on Intel Apollo Lake 64 bit CPUs
(Celeron Dual-Core N3350 , N3450 or Quad-Core N4200). (Celeron Dual-Core N3350 , N3450 or Quad-Core N4200).
The Collabora LAVA lab contains the following `coral` devices:
- ASUS Chromebook C523NA
- `asus-C523NA-A20057-coral`
### Debugging interfaces ### Debugging interfaces
`coral` boards have been flashed and tested with both [SuzyQ and Servo `coral` boards have been flashed and tested with both [SuzyQ and Servo
......
...@@ -15,6 +15,17 @@ devices and CPU, some of them using Intel 64 bit processors such as the ...@@ -15,6 +15,17 @@ devices and CPU, some of them using Intel 64 bit processors such as the
Celeron N2940 (Bay Trail) and the Celeron N3350 (Apollo Lake) and some Celeron N2940 (Bay Trail) and the Celeron N3350 (Apollo Lake) and some
others using AMD 64 bit Stoney Ridge processors like the AMD A4-9120. others using AMD 64 bit Stoney Ridge processors like the AMD A4-9120.
The Collabora LAVA lab contains the following `grunt` devices:
- HP Chromebook 11 G6 EE:
- [`hp-11A-G6-EE-grunt-cbg-0`](https://lava.collabora.co.uk/scheduler/device/hp-11A-G6-EE-grunt-cbg-0)
- [`hp-11A-G6-EE-grunt-cbg-1`](https://lava.collabora.co.uk/scheduler/device/hp-11A-G6-EE-grunt-cbg-1)
- [`hp-11A-G6-EE-grunt-cbg-2`](https://lava.collabora.co.uk/scheduler/device/hp-11A-G6-EE-grunt-cbg-2)
- [`hp-11A-G6-EE-grunt-cbg-3`](https://lava.collabora.co.uk/scheduler/device/hp-11A-G6-EE-grunt-cbg-3)
- [`hp-11A-G6-EE-grunt-cbg-4`](https://lava.collabora.co.uk/scheduler/device/hp-11A-G6-EE-grunt-cbg-4)
- [`hp-11A-G6-EE-grunt-cbg-5`](https://lava.collabora.co.uk/scheduler/device/hp-11A-G6-EE-grunt-cbg-5)
- [`hp-11A-G6-EE-grunt-cbg-6`](https://lava.collabora.co.uk/scheduler/device/hp-11A-G6-EE-grunt-cbg-6)
### Debugging interfaces ### Debugging interfaces
`grunt` boards have been flashed and tested with both [SuzyQ and Servo `grunt` boards have been flashed and tested with both [SuzyQ and Servo
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment