From fd6b63bf0db9abab9b06ef993e2ed71442639386 Mon Sep 17 00:00:00 2001 From: Tai Kuo Date: Sat, 20 Jun 2020 09:35:31 +0800 Subject: Merge google/walt Merge from https://github.com/google/walt.git Bug: 149721303 Bug: 149721109 Test: ./gradlew build -x :app:lint Change-Id: I56e2f506782fbbe01e3bf2489fa3091226a2b5ca Signed-off-by: Tai Kuo --- docs/DragLatency.md | 11 ++++++----- docs/ScreenLatency.md | 4 ++++ docs/TapLatency.md | 4 ++++ docs/usage/WALT_usage.md | 8 +++++++- 4 files changed, 21 insertions(+), 6 deletions(-) (limited to 'docs') diff --git a/docs/DragLatency.md b/docs/DragLatency.md index 3797e4e..739f477 100644 --- a/docs/DragLatency.md +++ b/docs/DragLatency.md @@ -1,6 +1,11 @@ ## Drag / scroll latency -For detailed instructions on how to perform the measurement refer to the [usage doc](usage/WALT_usage.md#dragscroll-latency). +See also: + * Instructions on how to perform the measurement in the [usage doc](usage/WALT_usage.md#dragscroll-latency) + * [Video demonstration](https://www.youtube.com/watch?v=pVy5AYVzf7Q&list=PLd6Fi7WgXfcB4Ma6A-5rPlr1jptNR3RxQ&index=4) + * A [video](https://plus.google.com/+FrancoisBeaufort/posts/XctAif2nv4U) showing the measurement +performed using a robotic stylus + For drag (or scroll) latency WALT uses a laser that shines across the touch device and hits a detector on the other side. The microcontroller monitors the state of the laser detector and reports (over usb) when @@ -8,10 +13,6 @@ the laser beam is broken. A finger dragged back and forth on a touchpad or touch and interrupts a laser beam. Touch events from the pad and laser events are then processed together to deduce the delay. -A [video](https://plus.google.com/+FrancoisBeaufort/posts/XctAif2nv4U) showing the measurement -performed using a robotic stylus. - - ![Drag/scroll latency measurement](usage/images/drag.png) Sample measurements diff --git a/docs/ScreenLatency.md b/docs/ScreenLatency.md index 8a7f1a5..ea8b301 100644 --- a/docs/ScreenLatency.md +++ b/docs/ScreenLatency.md @@ -1,5 +1,9 @@ ## Screen latency +See also: + * [Video demonstration](https://www.youtube.com/watch?v=FePSFTxBux4&list=PLd6Fi7WgXfcB4Ma6A-5rPlr1jptNR3RxQ&index=3) + * [Screen latency section in the usage doc](usage/WALT_usage.md#screen-response-latency) + WALT can detect when screen changes color between white and black using a photodiode. ![Photo of bottom side of WALT](WALT_bottom_view.png) diff --git a/docs/TapLatency.md b/docs/TapLatency.md index a3f84ae..fd3ddac 100644 --- a/docs/TapLatency.md +++ b/docs/TapLatency.md @@ -27,6 +27,10 @@ Sample measurements | Nexus 5X | NRD91P (7.0) | 25.0 | 22.5 | 2.4 | | Nexus 7 | LMY47Q (5.1) | 29.6 | 31.0 | 1.4 | | Nexus 9 | MMB29K (6.0.1) | 18.7 | 19.9 | 1.3 | +| Pixel C | NMF26H (7.1.1) | 23.8 | 24.3 | 1.1 | +| Pixel | NHG47K (7.1.2) | 9.6 | 28.1 | 2.0 | +| Pixel XL | NHG47K (7.1.2) | 14.2 | 14.4 | 1.8 | + ![Tap measurement](usage/images/tap.png) diff --git a/docs/usage/WALT_usage.md b/docs/usage/WALT_usage.md index 24fd990..a77e5d7 100644 --- a/docs/usage/WALT_usage.md +++ b/docs/usage/WALT_usage.md @@ -6,7 +6,7 @@ This document will show you how to set up and use your WALT. About WALT: * Source code: https://github.com/google/walt - * [Youtube playlist](https://www.youtube.com/playlist?list=PLd6Fi7WgXfcCEJg1FDqNCoQfpWo7W3J5a) + * YouTube [playlist 1](https://www.youtube.com/playlist?list=PLd6Fi7WgXfcCEJg1FDqNCoQfpWo7W3J5a) and [playlist 2](https://www.youtube.com/playlist?list=PLd6Fi7WgXfcB4Ma6A-5rPlr1jptNR3RxQ) * [Android Developers blog post](http://android-developers.blogspot.com/2016/04/a-new-method-to-measure-touch-and-audio.html) ## Prerequisites @@ -32,6 +32,8 @@ A test device and cables: ## Setup +[Video demonstration](https://www.youtube.com/watch?v=qR48GPepyxU&list=PLd6Fi7WgXfcB4Ma6A-5rPlr1jptNR3RxQ&index=2) + * Install and run the [WALT Android App](https://play.google.com/store/apps/details?id=org.kamrik.latency.walt&hl=en) * Connect WALT to the Android headset using the 3.5mm male to male TRRS cable * Connect WALT to the Android USB port using the cables above. (see photo at top of doc) @@ -136,6 +138,8 @@ until the first frames of that buffer were detected by WALT device via the headp ## Screen response latency +[Video demonstration](https://www.youtube.com/watch?v=FePSFTxBux4&list=PLd6Fi7WgXfcB4Ma6A-5rPlr1jptNR3RxQ&index=3) + * Tap screen response * Set screen brightness to maximum. On phones using PWM for screen backlight brightness control, yo man need to turn adaptive brightness off (settings -> Display -> Adaptive Brightness) * Position WALT with the screen sensor looking at the screen (the light sensor recessed into the large plastic surface). @@ -231,6 +235,8 @@ Medians, p2k & k2c [ms]: 19.5 1.7 ## Drag/scroll latency +[Video demonstration](https://www.youtube.com/watch?v=pVy5AYVzf7Q&list=PLd6Fi7WgXfcB4Ma6A-5rPlr1jptNR3RxQ&index=4) + Drag latency is measured by dragging a finger up and down along the screen. The finger interrupts a laser beam positioned across the screen. By comparing the timings of those beam interruptions with Android touch events the WALT app calculates the delay. -- cgit v1.2.3