Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym temacie omówiono kolekcję najwyższego poziomu Windows Precision Touchpad i wyjaśniono, w jaki sposób kolekcja zapewnia raportowanie zgodne z protokołem HID dla touchpada na hoście systemu Windows.
Urządzenie Windows Precision Touchpad może używać protokołu HID, aby udostępnić kolekcję najwyższego poziomu, która jest przedstawiana jako cyfryzator/touchpad (strona 0x0D, użycie 0x05).
Kolekcja Windows Precision Touchpad służy do udostępniania rozbudowanego raportowania wielu kontaktów i przycisków do hosta, a także informacji o urządzeniach związanych z tymi raportami. Kolekcja powinna obsługiwać dwa raporty funkcji: jeden, który umożliwia hostowi uzyskanie możliwości urządzenia, a drugi raport w celu uzyskania stanu certyfikacji urządzenia. Aby zapoznać się z przykładem obowiązkowego raportu wejściowego, zobacz Przykładowe deskryptory raportów.
Opcjonalny (ale zdecydowanie zalecany) raport funkcji może zostać zaimplementowany w celu uzyskania wskazówek dotyczących trybu opóźnienia od urządzenia hosta, w celu osiągnięcia wymaganego zużycia energii na urządzeniach USB w trybie uśpienia. Poniższe sekcje zawierają więcej informacji na temat raportów w kolekcji na najwyższym poziomie dotyczącym precyzyjnego touchpada systemu Windows.
Hapticzne gładziki (Haptic Touchpads)
Haptic touchpad to Windows Precision Touchpad, który używa siłownika dotykowego (takiego jak liniowy rezonansowy siłownik lub silnik piezoelektryczny) do symulacji uczucia mechanicznego kliknięcia, zamiast polegać na fizycznym mechanizmie zawiasu. Ponieważ nie ma mechanicznej płytki dotykowej ani zestawu przycisków na zawiasach, powierzchnia touchpadu pozostaje nieruchoma; informacja zwrotna z kliknięcia jest dostarczana całkowicie poprzez dokładnie kontrolowane drgania.
Kluczowe różnice między mechanicznymi touchpadami:
- Brak ruchomych części: Mechaniczne touchpady wykorzystują powierzchnię na zawiasach lub kopułowy przełącznik, który fizycznie opuszcza się, gdy użytkownik klika. Płytki dotykowe mają sztywną, nieruchomą powierzchnię i wytwarzają informację zwrotną o kliknięciu poprzez drgania.
- Jednolity wygląd kliknięcia: Na mechanicznym touchpadie siła kliknięcia i uczucie różni się w zależności od tego, gdzie użytkownik naciska (zazwyczaj sztywniejsze w pobliżu zawiasu u góry). Haptyczne płytki dotykowe zapewniają spójną informację zwrotną niezależnie od lokalizacji nacisku.
- Sprzężenie zwrotne konfigurowalne programowo: intensywność i charakter odpowiedzi zwrotnej kliknięcia haptycznego można dostosować przez hosta, umożliwiając użytkownikowi konfigurowanie siły kliknięcia i obsługi różnych wzorców fal.
- Cieńszy kształt: Wyeliminowanie mechanicznego zestawu zawiasów pozwala na cieńsze konstrukcje urządzeń.
Dotykowe płytki dotykowe obsługują dwa tryby przesyłania opinii haptycznych:
- Sprzężenie zwrotne haptyczne inicjowane przez urządzenie: touchpad autonomicznie wyzwala sprzężenie zwrotne haptyczne, gdy ustali, że użytkownik nacisnął lub zwolnił przycisk na powierzchni. Zastępuje to fizyczne uczucie kliknięcia mechanicznego touchpadu. Urządzenie może opcjonalnie zaakceptować raporty SET_FEATURE z hosta, aby umożliwić użytkownikowi dostosowanie intensywności sprzężenia zwrotnego i siły wymaganej do wciśnięcia przycisku.
- Haptyczna informacja zwrotna inicjowana przez hosta: Host Windows wysyła raporty wyjściowe do touchpadu w celu wywołania haptycznej informacji zwrotnej na żądanie, niezależnie od aktywacji przycisków. Dzięki temu można korzystać z bogatszych doświadczeń opartych na aplikacjach, takich jak impulsy podczas najechania kursorem, informacje zwrotne dotyczące przyciągania do wyrównania oraz potwierdzenia kroków z wykorzystaniem zdefiniowanego zestawu przebiegów falowych.
Aby uzyskać szczegółowe informacje na temat protokołu, definicji przebiegów, przykładowych deskryptorów i wskazówek dotyczących implementacji sprzętu, zobacz Przewodnik implementacji Haptics urządzeń wejściowych.
Raport możliwości urządzenia
Raport o możliwościach urządzenia jest wymagany przez gospodarza Windows Precision Touchpad, aby uzyskać informacje o zdolności raportowania kontaktów przez urządzenie oraz typie przycisku urządzenia.
Możliwość raportowania kontaktów urządzenia jest definiowana przez maksymalną liczbę współbieżnych kontaktów powierzchni, które może zgłaszać. Windows Precision Touchpad powinien obsługiwać co najmniej 3 równoczesne kontakty i maksymalnie 5 współbieżnych kontaktów. Touchpad powinien zgłosić tę wartość poprzez maksymalną liczbę kontaktów (strona 0x0D, użycie 0x55) w raporcie możliwości urządzenia. Podczas raportowania danych urządzenie nie może zgłaszać większej liczby kontaktów niż maksymalna liczba kontaktów. Jeśli ramka wejściowa zawiera więcej kontaktów niż maksymalna, host odrzuci całą ramkę, w tym dane dla wszystkich wcześniej zgłoszonych kontaktów. W celu uzyskania najlepszego środowiska użytkownika urządzenie powinno pominąć raportowanie wszelkich nowych kontaktów wykrytych po osiągnięciu maksymalnej liczby w okresie istnienia nowego kontaktu, nawet jeśli jakiekolwiek istniejące kontakty odejdą. Istniejące kontakty mogą być nadal zgłaszane, a jeśli któryś z nich odchodzi, nowo przybywające kontakty mogą zająć ich miejsce.
Typ przycisku urządzenia jest definiowany jako implementacja wciśnięcia (nazywana również typem klikalnym) lub implementacja niewciśnięcia (nazywana również padem naciskowym). Dopuszczalne jest również, aby Windows Precision Touchpad miał powierzchnię digitalizatora bez przycisków do raportowania i zamiast tego używał przycisków zewnętrznych.
Typ implementacji przycisku należy określić za pomocą wartości dla typu przycisku (Page 0x0D, Usage 0x59) w raporcie funkcji urządzenia. Jeśli urządzenie ma powierzchnię digitalizatora bez przycisków do raportowania i zamiast tego opiera się tylko na przyciskach zewnętrznych do kliknięć myszy, to to użycie może być zgłaszane opcjonalnie.
W poniższej tabeli przedstawiono wartości użycia typu przycisku.
| Wartość typu przycisku | Implementation |
|---|---|
| 0 | Naciskany (klikalny touchpad) |
| 1 | Nieściskalny (ciśnieniowa podkładka) |
| 2 | Niezaklikalne (pad dyskretny) |
Host może zażądać raportu funkcji urządzenia z systemem Windows Precision Touchpad w dowolnym momencie po przeczytaniu deskryptora raportu.
Raport dotyczący stanu certyfikacji urządzenia
Raport dotyczący funkcji stanu certyfikacji urządzenia jest wymagany przez hosta Precision Touchpad systemu Windows w celu pobrania informacji o 256-bajtowym bloku danych urządzenia.
Raportowanie prawidłowego, certyfikowanego obiektu blob do hosta jest opcjonalne w systemie Windows 10, ale jest niezbędne dla zapewnienia zgodności wstecznej z systemem Windows 8.1. Urządzenie, które nie komunikuje podpisanego bloku PTPHQA, musi nadal przesyłać dowolny blok danych o rozmiarze 256 bajtów, taki jak przykładowy blok danych poniżej. Urządzenia, które nie zgłaszają prawidłowych danych certyfikacji, nie będą działać w systemie Windows 8.1. System Windows nie będzie wchodzić w interakcje z urządzeniami używającymi funkcji touchpada HID, które nie ujawniają stanu certyfikacji w raporcie dotyczącym możliwości urządzenia.
Te 256 bajtów należy określić przez użycie zdefiniowane przez dostawcę na odpowiedniej stronie użycia (strona 0xFF, użycie 0xC5) w raporcie funkcji statusu certyfikacji urządzenia.
Przed otrzymaniem przez urządzenie 256-bajtowego blobu wskazującego jego stan certyfikacji, powinno zaimplementować domyślny blob w następujący sposób:
0xfc, 0x28, 0xfe, 0x84, 0x40, 0xcb, 0x9a, 0x87, 0x0d, 0xbe, 0x57, 0x3c, 0xb6, 0x70, 0x09, 0x88, 0x07,
0x97, 0x2d, 0x2b, 0xe3, 0x38, 0x34, 0xb6, 0x6c, 0xed, 0xb0, 0xf7, 0xe5, 0x9c, 0xf6, 0xc2, 0x2e, 0x84,
0x1b, 0xe8, 0xb4, 0x51, 0x78, 0x43, 0x1f, 0x28, 0x4b, 0x7c, 0x2d, 0x53, 0xaf, 0xfc, 0x47, 0x70, 0x1b,
0x59, 0x6f, 0x74, 0x43, 0xc4, 0xf3, 0x47, 0x18, 0x53, 0x1a, 0xa2, 0xa1, 0x71, 0xc7, 0x95, 0x0e, 0x31,
0x55, 0x21, 0xd3, 0xb5, 0x1e, 0xe9, 0x0c, 0xba, 0xec, 0xb8, 0x89, 0x19, 0x3e, 0xb3, 0xaf, 0x75, 0x81,
0x9d, 0x53, 0xb9, 0x41, 0x57, 0xf4, 0x6d, 0x39, 0x25, 0x29, 0x7c, 0x87, 0xd9, 0xb4, 0x98, 0x45, 0x7d,
0xa7, 0x26, 0x9c, 0x65, 0x3b, 0x85, 0x68, 0x89, 0xd7, 0x3b, 0xbd, 0xff, 0x14, 0x67, 0xf2, 0x2b, 0xf0,
0x2a, 0x41, 0x54, 0xf0, 0xfd, 0x2c, 0x66, 0x7c, 0xf8, 0xc0, 0x8f, 0x33, 0x13, 0x03, 0xf1, 0xd3, 0xc1, 0x0b,
0x89, 0xd9, 0x1b, 0x62, 0xcd, 0x51, 0xb7, 0x80, 0xb8, 0xaf, 0x3a, 0x10, 0xc1, 0x8a, 0x5b, 0xe8, 0x8a,
0x56, 0xf0, 0x8c, 0xaa, 0xfa, 0x35, 0xe9, 0x42, 0xc4, 0xd8, 0x55, 0xc3, 0x38, 0xcc, 0x2b, 0x53, 0x5c,
0x69, 0x52, 0xd5, 0xc8, 0x73, 0x02, 0x38, 0x7c, 0x73, 0xb6, 0x41, 0xe7, 0xff, 0x05, 0xd8, 0x2b, 0x79,
0x9a, 0xe2, 0x34, 0x60, 0x8f, 0xa3, 0x32, 0x1f, 0x09, 0x78, 0x62, 0xbc, 0x80, 0xe3, 0x0f, 0xbd, 0x65,
0x20, 0x08, 0x13, 0xc1, 0xe2, 0xee, 0x53, 0x2d, 0x86, 0x7e, 0xa7, 0x5a, 0xc5, 0xd3, 0x7d, 0x98, 0xbe,
0x31, 0x48, 0x1f, 0xfb, 0xda, 0xaf, 0xa2, 0xa8, 0x6a, 0x89, 0xd6, 0xbf, 0xf2, 0xd3, 0x32, 0x2a, 0x9a,
0xe4, 0xcf, 0x17, 0xb7, 0xb8, 0xf4, 0xe1, 0x33, 0x08, 0x24, 0x8b, 0xc4, 0x43, 0xa5, 0xe5, 0x24, 0xc2
Host może zażądać raportu funkcji stanu certyfikacji urządzenia w systemie Windows Precision Touchpad w dowolnym momencie po przeczytaniu deskryptora raportu.
Raport funkcjonalności trybu opóźnienia
Raport funkcji Tryb opóźnienia jest wysyłany przez hosta do Touchpada Precyzyjnego Windows, aby wskazać, kiedy duże opóźnienie jest pożądane w celu oszczędzania energii, oraz odwrotnie, gdy pożądane jest standardowe opóźnienie do działania. W przypadku urządzeń z systemem Windows Precision Touchpad podłączonych przez USB umożliwia to urządzeniu rozróżnienie między wstrzymaniem z powodu braku aktywności (IDLE) a wstrzymaniem, ponieważ system przechodzi w tryb S3 lub Połączony Tryb Gotowości.
Tryb opóźnienia powinien być wskazywany przy użyciu wartości użycia trybu opóźnienia (strona 0x0D, użycie 0x60) w raporcie funkcji trybu opóźnienia. W poniższej tabeli przedstawiono wartości użycia trybu opóźnienia.
| Wartość trybu opóźnienia | Tryb opóźnienia |
|---|---|
| 0 | Normalne opóźnienie |
| 1 | Duże opóźnienie |
Raporty wejściowe precyzyjnego touchpada Windows
Host korzysta z danych w poniższej tabeli podczas wydobywania danych kontaktowych z raportu wejściowego z kolekcji Precision Touchpad Windows. Tabela zawiera wszystkie obowiązkowe użycia oraz obsługiwane opcjonalne użycia związane z każdym unikalnym kontaktem cyfrowego panelu dotykowego, który jest zgłoszony.
| Członek | Description | Strona | identyfikator | Obowiązkowe/opcjonalne |
|---|---|---|---|---|
| Identyfikator kontaktu | Jednoznacznie identyfikuje kontakt w obrębie danej ramki. | 0x0D | 0x51 | Mandatory |
| X | Współrzędna X położenia kontaktu. | 0x01 | 0x30 | Mandatory |
| Y | Współrzędna Y pozycji kontaktu. | 0x01 | 0x31 | Mandatory |
| Wskazówka | Ustaw, czy kontakt jest na powierzchni digitalizatora. | 0x0D | 0x42 | Mandatory |
| Pewność siebie | Ustaw, gdy kontakt jest zbyt duży, aby być palcem. | 0x0D | 0x47 | Mandatory |
| Szerokość | Szerokość pola ograniczenia wokół kontaktu. | 0x0D | 0x48 | Opcjonalnie |
| Wysokość | Wysokość pola ograniczenia wokół kontaktu. | 0x0D | 0x49 | Opcjonalnie |
| Ciśnienie | Ilość ciśnienia, jaką użytkownik stosuje do punktu kontaktowego. | 0x0D | 0x30 | Opcjonalnie |
| Azymut | Obracanie się kontaktu przeciwnie do ruchu wskazówek zegara wokół osi Z. | 0x0D | 0x3F | Opcjonalnie |
Poniższa tabela zawiera wszystkie zastosowania najwyższego poziomu, które powinny być obecne we wszystkich raportach wejściowych windows Precision Touchpad.
| Członek | Description | Strona | identyfikator | Obowiązkowe/opcjonalne |
|---|---|---|---|---|
| Czas skanowania | Względny czas skanowania. | 0x0D | 0x56 | Mandatory |
| Liczba kontaktów | Łączna liczba kontaktów do zgłoszenia w danym raporcie. | 0x0D | 0x54 | Mandatory |
| Siła mechaniczna | Całkowita siła przykładana do czujnika touchpada. | 0x20 | 0x494 | Opcjonalnie |
| Przycisk 1 | Wskazuje stan przycisku dla panelu dotykowego zintegrowanego z digitizerem. | 0x09 | 0x01 | Opcjonalnie |
| Przycisk 2 | Wskazuje stan zewnętrznego przycisku dla podstawowego kliknięcia (domyślnie lewym przyciskiem). | 0x09 | 0x02 | Opcjonalnie |
| Przycisk 3 | Wskazuje stan zewnętrznego przycisku dla pomocniczego kliknięcia (domyślnie prawego). | 0x09 | 0x03 | Opcjonalnie |
Każde urządzenie, które nie zgłasza wszystkich obowiązkowych użyć na poziomie kontaktu lub raportu, nie będzie działać poprawnie jako Windows Precision Touchpad. Obowiązkowe użycie jest wymuszane przez hosta systemu Windows. Jeśli wartość logiczna maksymalna nie została ograniczona, można zoptymalizować wartość w celu zmniejszenia rozmiaru deskryptora.
Poniższe sekcje zawierają informacje o członkach w raportach. Aby uzyskać informacje o elementach przycisku, zobacz Przyciski, Zastosowania na poziomie raportu.
Identyfikator kontaktu
Jednoznacznie identyfikuje kontakt w raporcie w całym jego cyklu życia. Identyfikator kontaktu musi pozostać stały, gdy kontakt zostanie wykryty i zgłoszony przez urządzenie. Każdy oddzielny kontakt współbieżny musi mieć unikatowy identyfikator. Identyfikatory można ponownie użyć, gdy wcześniej skojarzony kontakt nie zostanie już wykryty ani zgłoszony. Nie ma oczekiwanego zakresu liczbowego, a używane wartości są ograniczone tylko przez określone maksimum logiczne w deskryptorze.
X/Y
Wartości X i Y raportują współrzędne danego kontaktu. Precyzyjny touchpad Windows powinien zgłaszać jeden punkt dla każdego dotyku. Dla użycia X i Y należy określić następujące elementy globalne:
Wartość logiczna minimalna i maksymalna (zapewniając rozdzielczość wejściową co najmniej 300DPI).
Nuta Cały zakres współrzędnych logicznych powinien być raportowalny zarówno na osi X, jak i Y.
Minimalna fizyczna oraz maksymalna fizyczna (zobacz Integracja urządzenia — rozmiar).
Jednostka i wykładnik jednostki.
Współrzędna 0,0 (x, y) wskazuje lewy górny róg panelu dotykowego.
Wskazówka
Służy do wskazywania, kiedy dotyk jest na powierzchni lub opuścił powierzchnię ekranu dotykowego. Jest to wskazywane przez element główny o rozmiarze raportu wynoszącym 1 bit. Podczas dostarczania raportu o kontakcie, bit powinien być ustawiony, gdy kontakt znajduje się na powierzchni cyfrowego wyświetlacza, i wyczyszczony, gdy kontakt opuści powierzchnię.
Gdy kontakt jest zgłaszany z przełącznikiem końcówki w stanie nieaktywnym, zgłaszana lokalizacja (X, Y) powinna być taka sama jak ostatnia pozycja zgłoszona z przełącznikiem końcówki w stanie aktywnym.
W odniesieniu do przykładu przedstawionego na poprzednim diagramie, dwa kontakty są umieszczane na Windows Precision Touchpad, a następnie w pewnym momencie pierwszy kontakt jest podnoszony, podczas gdy drugi pozostaje na powierzchni przez dodatkowy czas. Zostanie to zgłoszone zgodnie z opisem w poniższej tabeli.
| Raport | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Liczba kontaktów | 2 | 2 | 2 | 2 | 2 | 2 | 1 | 1 | 1 | 1 | 1 |
| Kontakt 1: przełącznik końcówki | 1 | 1 | 1 | 1 | 1 | 0 | NR | NR | NR | NR | NR |
| Kontakt 1: X, Y | X₁, Y₁ | X₂, Y₂ | X₃, Y₃ | X₄, Y₄ | X₅, Y₅ | X₆, Y₆ | NR | NR | NR | NR | NR |
| Kontakt 2: przełącznik dotykowy | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 0 |
| Kontakt 2: X, Y | X₁, Y₁ | X₂, Y₂ | X₃, Y₃ | X₄, Y₄ | X₅, Y₅ | X₆, Y₆ | X₇, Y₇ | X₈, Y₈ | X₉, Y₉ | X₁₀, Y₁₀ | X₁₁, Y₁₁ |
Pewność siebie
Służy do wskazywania, że kontakt jest zamierzony. Test wymagań zgodności w celu upewnienia się, że ten bit jest ustawiony na wartość "Wyłączone", gdy kontakt ma jakiekolwiek wymiary (wysokość lub szerokość) większe niż 25 mm, co oznacza, że nie jest to niezamierzony kontakt. Urządzenia z systemem Windows Precision Touchpad nie powinny ukrywać żadnych kontaktów w przetwarzaniu przez oprogramowanie układowe, ale powinny przekazywać wszystkie kontakty do hosta i wskazywać poziom zaufania. Następnie host będzie używać mechanizmu zaufania do śledzenia kontaktu jako zdarzenia przypadkowego.
Począwszy od Windows 11, wersja 24H2, kontakt na panelu dotykowym może swobodnie przechodzić między stanem pewnym i niepewnym, przy czym system Windows traktuje każdy ciągły segment raportowania pewności jako niezależny cykl życia kontaktu. Windows śledzi pierwszy raport kontaktu, więc opóźnione przejście do stanu pewnego nie może na przykład wygenerować naciśnięcia dla kontaktu, który spędził już wystarczający czas jako niepewny.
Szerokość i wysokość
Użycie opcji Szerokość i Wysokość reprezentują szerokość i wysokość pola ograniczenia wokół kontaktu touchpad. Zgłoszone wartości nigdy nie powinny być zerowe (0), z wyjątkiem sytuacji, gdy zgłaszane jest zdarzenie "UP", w tym przypadku powinny mieć zero (0).
Ciśnienie
Ciśnienie to pomiar siły wywieranej przez palec na powierzchnię cyfrową przetwornika. Nie ma żadnych ograniczeń dotyczących zakresu dozwolonego pod kątem ciśnienia.
Azymut
Azimuth określa obrót przeciwnie do ruchu wskazówek zegara kursora wokół osi Z przez pełen zakres okręgu. Należy określić zakres fizyczny i zakres logiczny. Zakres fizyczny musi wynosić od 0 do 360 lub równoważne w radianach, jednak urządzenie może zgłaszać pełny zakres lub połowę zakresu, przy założeniu, że elipsa kontaktowa jest symetryczna w zależności od możliwości sprzętowych. Zakres logiczny musi być wystarczająco duży, aby dostarczać dane, które są dokładne dla co najmniej dwóch miejsc dziesiętnych.
Czas skanowania
Czas skanowania zgłasza względny czas działania przetwornika cyfrowego w jednostkach 100 µs. Czas skanowania reprezentuje różnicę z pierwszej ramki, która została zgłoszona po rozpoczęciu raportowania danych przez urządzenie po upływie okresu braku aktywności. Pierwszy odebrany czas skanowania jest traktowany jako czas bazowy dla kolejnych zgłoszonych czasów. Różnice między zgłoszonymi czasami skanowania powinny odzwierciedlać częstotliwość skanowania cyfrowego przetwornika. Należy pamiętać, że w przeciwieństwie do innych zastosowań host nie zezwala na elastyczność jednostki na potrzeby użycia czasu skanowania. Musi być wyrażone w jednostkach 100μs. Oczekuje się, że wartość przekroczy wartość graniczną, ponieważ tylko 2 bajty są przydzielane do licznika.
Wartość czasu skanowania powinna być taka sama dla wszystkich kontaktów w ramce.
Liczba kontaktów
Służy do wskazywania liczby kontaktów zgłaszanych w danej ramce niezależnie od skojarzonego przełącznika końcówki.
Siła mechaniczna
Służy do zgłaszania całkowitej siły stosowanej do czujnika touchpad, niezależnie od opcjonalnego ciśnienia, które można zgłaszać dla poszczególnych palców. Jeśli ciśnienie jest również zgłaszane dla poszczególnych kontaktów, to jednostki, wykładnik jednostki, zakres fizyczny i zakres logiczny muszą być identyczne dla ciśnienia i siły mechanicznej, a wartość siły mechanicznej musi = SUM(Ciśnienie dla kontaktu 1 + Ciśnienie dla kontaktu 2 + .... itp.) niezależnie od bitu ufności dla każdego z tych kontaktów.