summaryrefslogtreecommitdiff
path: root/docs/fingerprint
diff options
context:
space:
mode:
Diffstat (limited to 'docs/fingerprint')
-rw-r--r--docs/fingerprint/fingerprint-debugging.md2
-rw-r--r--docs/fingerprint/fingerprint-dev-for-partners.md13
-rw-r--r--docs/fingerprint/fingerprint-factory-requirements.md2
-rw-r--r--docs/fingerprint/fingerprint.md55
4 files changed, 42 insertions, 30 deletions
diff --git a/docs/fingerprint/fingerprint-debugging.md b/docs/fingerprint/fingerprint-debugging.md
index d098ca4427..84e5c13c9c 100644
--- a/docs/fingerprint/fingerprint-debugging.md
+++ b/docs/fingerprint/fingerprint-debugging.md
@@ -197,7 +197,7 @@ In your editor, specify the IP address and port for `gdbserver`:
You will also want to provide the symbol files:
* RW image: `build/<board>/RW/ec.RW.elf`
-* RO image: `build/<board>/RO.ec.RO.elf`
+* RO image: `build/<board>/RO/ec.RO.elf`
Also, since we're compiling the firmware in the chroot, but your editor is
running outside of the chroot, you'll want to remap the source code path to
diff --git a/docs/fingerprint/fingerprint-dev-for-partners.md b/docs/fingerprint/fingerprint-dev-for-partners.md
index e78fde5caa..20b89845aa 100644
--- a/docs/fingerprint/fingerprint-dev-for-partners.md
+++ b/docs/fingerprint/fingerprint-dev-for-partners.md
@@ -315,6 +315,11 @@ You can get a summary of the power over `N` seconds with:
(chroot) $ dut-control -t N pp3300_dx_mcu_mv pp3300_dx_fp_mv pp1800_dx_fp_mv pp3300_dx_mcu_mw pp3300_dx_fp_mw pp1800_dx_fp_mw
```
+When measuring the power, make sure that any debuggers are disconnected. The
+most reliable way to make sure it is disconnected is to physically disconnect
+the debugger and servo_micro from the board. Then re-attach servo_micro and
+restart `servod`.
+
<!-- mdformat off(b/139308852) -->
*** note
The `_mv` suffix denotes millivolt and `_mw` suffix denotes milliwatt.
@@ -485,6 +490,8 @@ From the DUT, flash the firmware you copied:
![CQ Prototype Environment]
+![FPMCU devboard environment v2 with satlab]
+
## Troubleshooting
### Dragonclaw Rev 0.2 Rework {#dragonclaw-rev-0.2-rework}
@@ -526,7 +533,7 @@ supply.
(chroot) $ lsusb
Bus 002 Device 003: ID 0897:0004 Lauterbach # ← This is my Lauterbach (debugger)
-Bus 001 Device 013: ID 18d1:5002 Google Inc. # ← This is servo
+Bus 001 Device 013: ID 18d1:5002 Google LLC # ← This is servo
```
### "No servos found" when running servod
@@ -601,3 +608,7 @@ Make sure that this interface is disabled:
<!-- https://docs.google.com/drawings/d/1w2qbb4AsSxY-KTK2vXZ6TKeWHveWvS3Dkgh61ocu0wc -->
[CQ Prototype Environment]: ../images/CQ_Prototype_Environment.jpg
+
+<!-- https://docs.google.com/drawings/d/13hsnPBa1aeMVU7CjrK1nz-aeYSQcdLxrylOEJNOiEA0 -->
+
+[FPMCU devboard environment v2 with satlab]: ../images/FPMCU_devboard_environment_v2_with_Satlab.jpg
diff --git a/docs/fingerprint/fingerprint-factory-requirements.md b/docs/fingerprint/fingerprint-factory-requirements.md
index 76b3ada517..5116b2c77a 100644
--- a/docs/fingerprint/fingerprint-factory-requirements.md
+++ b/docs/fingerprint/fingerprint-factory-requirements.md
@@ -474,7 +474,7 @@ sensor (in nocturne), not the FPC 1025 sensor (hatch).
Convert the buffer in proprietary format into png:
```bash
-(dut) $ /opt/fpc/fputils.py /tmp/fp.raw --png
+(dut) $ /usr/local/opt/fpc/fputils.py /tmp/fp.raw --png
Extraction found 2 images
Wrote /tmp/fp.0.png (14085 bytes)
Wrote /tmp/fp.1.png (14025 bytes)
diff --git a/docs/fingerprint/fingerprint.md b/docs/fingerprint/fingerprint.md
index 04f5a6bab9..8d4995a0fa 100644
--- a/docs/fingerprint/fingerprint.md
+++ b/docs/fingerprint/fingerprint.md
@@ -322,7 +322,8 @@ a lot easier during both development and testing.
## Power
See [Measuring Power] for instructions on how to measure power with the
-fingerprint development boards.
+fingerprint development boards. *Make sure that any debuggers are completely
+disconnected.*
### Dragonclaw v0.2
@@ -331,7 +332,7 @@ fingerprint development boards.
```
**Firmware Version**:
-`bloonchipper_v2.0.4277-9f652bb3-RO_v2.0.7314-3dfc5ff6-RW.bin`
+`bloonchipper_v2.0.4277-9f652bb3-RO_v2.0.14348-e5fb0b9-RW.bin`
#### MCU is idle
@@ -341,13 +342,13 @@ fingerprint development boards.
```
@@ NAME COUNT AVERAGE STDDEV MAX MIN
-@@ sample_msecs 113 533.56 40.91 658.52 447.06
-@@ pp1800_dx_fp_mv 113 1800.00 0.00 1800.00 1800.00
-@@ pp1800_dx_fp_mw 113 0.00 0.00 0.00 0.00
-@@ pp3300_dx_fp_mv 113 3280.00 0.00 3280.00 3280.00
-@@ pp3300_dx_fp_mw 113 0.01 0.05 0.26 0.00
-@@ pp3300_dx_mcu_mv 113 3280.00 0.00 3280.00 3280.00
-@@ pp3300_dx_mcu_mw 113 24.67 0.00 24.67 24.67
+@@ sample_msecs 478 125.49 26.02 431.96 92.23
+@@ pp1800_dx_fp_mv 478 1800.00 0.00 1800.00 1800.00
+@@ pp1800_dx_fp_mw 478 0.00 0.00 0.00 0.00
+@@ pp3300_dx_fp_mv 478 3280.00 0.00 3280.00 3280.00
+@@ pp3300_dx_fp_mw 478 0.00 0.03 0.26 0.00
+@@ pp3300_dx_mcu_mv 478 3280.00 0.00 3280.00 3280.00
+@@ pp3300_dx_mcu_mw 478 21.78 0.06 23.09 21.78
```
#### MCU in low power mode (suspend)
@@ -358,13 +359,13 @@ fingerprint development boards.
```
@@ NAME COUNT AVERAGE STDDEV MAX MIN
-@@ sample_msecs 115 526.56 36.79 607.60 426.58
-@@ pp1800_dx_fp_mv 115 1800.00 0.00 1800.00 1800.00
-@@ pp1800_dx_fp_mw 115 0.00 0.00 0.00 0.00
-@@ pp3300_dx_fp_mv 115 3287.30 2.25 3288.00 3280.00
-@@ pp3300_dx_fp_mw 115 0.00 0.02 0.26 0.00
-@@ pp3300_dx_mcu_mv 115 3280.97 2.62 3288.00 3280.00
-@@ pp3300_dx_mcu_mw 115 4.02 0.64 10.76 3.94
+@@ sample_msecs 488 122.99 26.37 458.47 92.69
+@@ pp1800_dx_fp_mv 488 1800.00 0.00 1800.00 1800.00
+@@ pp1800_dx_fp_mw 488 0.00 0.00 0.00 0.00
+@@ pp3300_dx_fp_mv 488 3287.79 1.29 3288.00 3280.00
+@@ pp3300_dx_fp_mw 488 0.01 0.04 0.26 0.00
+@@ pp3300_dx_mcu_mv 488 3283.38 3.95 3288.00 3280.00
+@@ pp3300_dx_mcu_mw 488 1.57 0.59 9.73 1.31
```
### Icetower v0.1
@@ -385,7 +386,7 @@ measure releases before that point.
```
**Firmware Version**:
-`dartmonkey_v2.0.2887-311310808-RO_v2.0.7304-441100b93-RW.bin`
+`dartmonkey_v2.0.2887-311310808-RO_v2.0.14340-6c1587ca7-RW.bin`
#### MCU is idle
@@ -395,11 +396,11 @@ measure releases before that point.
```
@@ NAME COUNT AVERAGE STDDEV MAX MIN
-@@ sample_msecs 178 337.13 20.91 404.32 289.82
-@@ pp3300_dx_fp_mv 178 3256.00 0.00 3256.00 3256.00
-@@ pp3300_dx_fp_mw 178 0.00 0.00 0.00 0.00
-@@ pp3300_dx_mcu_mv 178 3248.00 0.00 3248.00 3248.00
-@@ pp3300_dx_mcu_mw 178 45.17 0.09 45.21 44.95
+@@ sample_msecs 523 114.85 18.33 386.55 88.95
+@@ pp3300_dx_fp_mv 523 3256.00 0.00 3256.00 3256.00
+@@ pp3300_dx_fp_mw 523 0.00 0.00 0.00 0.00
+@@ pp3300_dx_mcu_mv 523 3248.00 0.00 3248.00 3248.00
+@@ pp3300_dx_mcu_mw 523 43.86 0.10 43.91 43.65
```
#### MCU in low power mode (suspend)
@@ -410,11 +411,11 @@ measure releases before that point.
```
@@ NAME COUNT AVERAGE STDDEV MAX MIN
-@@ sample_msecs 174 345.60 31.93 457.62 283.00
-@@ pp3300_dx_fp_mv 174 3264.00 0.00 3264.00 3264.00
-@@ pp3300_dx_fp_mw 174 0.00 0.00 0.00 0.00
-@@ pp3300_dx_mcu_mv 174 3260.69 3.94 3264.00 3256.00
-@@ pp3300_dx_mcu_mw 174 5.47 0.10 5.48 4.17
+@@ sample_msecs 501 119.79 14.72 381.92 89.22
+@@ pp3300_dx_fp_mv 501 3256.00 0.00 3256.00 3256.00
+@@ pp3300_dx_fp_mw 501 0.00 0.00 0.00 0.00
+@@ pp3300_dx_mcu_mv 501 3256.00 0.00 3256.00 3256.00
+@@ pp3300_dx_mcu_mw 501 5.74 0.28 11.98 5.73
```
## ChromeOS Build (portage / ebuild)