.. vim: set expandtab fileencoding=utf-8 nomodified wrap textwidth=200 shiftwidth=2 ts=2 foldmethod=marker foldcolumn=4 ruler showcmd lcs=tab\:|- list:
.. title: Arduino jako klávesnice 1
.. slug: Arduino-ArduinoJakoKlavesnice-1
.. date: 2019-06-14 18:29:09 CEST
.. tags: Arduino,AVR,USB
.. category: blog
.. link: 
.. description: Arduino jako klávesnice
.. type: text
.. author: Gilhad


.. |logo| image:: /images/logo/gilhad.png

|logo| 2019-06-14 USB klávesnice 1

Letmý pohled pod povrch Arduino Keyboard a USB komunikace

* Odpověď v Arduino-forum.cz: Arduino jako klávesnice 2 https://www.arduino-forum.cz/viewtopic.php?f=40&t=1765&start=10 

.. TEASER_END

**Odpověď, která asi moc nepotěší, ale uvede věci na pravou míru**

Arduino jako klávesnice používá USB protokol pro klávesnici, ten sám je docela omezený  (odesílá maximálně 6 kláves naráz + modifikátory (jako levý shift, pravý alt atd celkem 8 bitů=1byte) a docela složitý (

* https://www.usb.org/documents?search=&items_per_page=All 
* https://www.usb.org/sites/default/files/documents/hid1_11.pdf  Device Class Definition for HID 1.11 `<files/hid1_11.pdf>`_
* https://usb.org/sites/default/files/documents/hut1_12v2.pdf  HID Usage Tables 1.12 `<files/hut1_12v2.pdf>`_

)

  
V podstatě (kromě spousty režie) klávesnice posílá počítači toto ( viz Arduino/build/linux/work/libraries/Keyboard/src ) :

Keyboard.h :75

.. code-block:: C

   typedef struct
   {
     uint8_t modifiers;
     uint8_t reserved;
     uint8_t keys[6];
   } KeyReport;



Aby to nebylo složité a lidi to nevyděsilo (=Arduino way), tak to je celé zabalené v něčem, co to umožní používat jednoduše, za cenu ztráty funkcionality a nepřesností - ta knihovna Keyboard - najděte si ji na svém počítači)

**modifiers** jsou různé "shifty" viz Keyboard.h :37 (akorát ta čísla (-0x80) odpovídají jednotlivým bitům)
    
.. code-block:: C

    #define KEY_LEFT_CTRL   0x80
    #define KEY_LEFT_SHIFT    0x81
    #define KEY_LEFT_ALT    0x82
    #define KEY_LEFT_GUI    0x83
    #define KEY_RIGHT_CTRL    0x84
    #define KEY_RIGHT_SHIFT   0x85
    #define KEY_RIGHT_ALT   0x86
    #define KEY_RIGHT_GUI   0x87
    

**keys[6]** je pole aktuálně stisknutých tlačítek podle specifikace HID Usage Tables 1.12 strana 53 a další, v knihovně je "nějak" převádějí ze zadaných písmen (a předpokládají anglickou klávesnici)  a dál s tím dělají všeliké vylomeniny, aby to "nějak" fungovalo

Keyboard.cpp :86

.. code-block:: C

  const uint8_t _asciimap[128] =

číslice se berou z řady kláves nad QWERTY, bez shiftu

Takže když zkoušíte psát ALT+0397 přez alt a číslice, tak vám to pochotitelně na té číslicové řadě nejde, (protože to počítač "vidí" jako ALT+éšíý a nedává mu to smysl).

Navíc knihovna Keyboard předpokládá vypnutý NumLock a šipky píše na něm (s tím, že aby poznala, že jde o "speciální znaky" tak jsou ty kódu posunuté o 136 nahoru a při použití od nich zase 136 odečte

.. code-block:: C

    #define KEY_UP_ARROW    0xDA
    #define KEY_DOWN_ARROW    0xD9
    #define KEY_LEFT_ARROW    0xD8
    #define KEY_RIGHT_ARROW   0xD7


Takže buď si pro tyhle speciální kódy nadefinovat vlastní funkci, která přepíše Keyboard\_::press, nebo si ty kódy pro numerickou klávesnici dopočítat a dodefinovat jako konstanty, tak aby to té funkci vyšlo správně (a možná bude potřeba to posílat jako sekvenci NumLock,Alt+0397,Numlock, nebo Shift+Alt+0397 - to už musíte vyzkoušet, co Windows pochopí správně)

----

**Shrnutí:** USB klávesnice (ať už Arduino, nebo klasická) vůbec **neví nic o rozložení znaků, nebo jaký jazyk se právě používá** a jen odesílá, jaké klávesy byly namačkané. OS z toho nějak usoudí, jaké písmena (nebo jiné věci, jako multimediální, spuštění programů a podobně) by to asi tak mohlo znamenat (aniž by tušil, co je na klávesnici napsáno)

Arduino knihovna Keyboard dělá spoustu triků, aby to před uživatelem schovala a složitě a nepřesně předstírá, že umi psát písmena. Pro složitější věci doporučuju si projít její kód a buď ji ošidit, nebo si napsat vlastní, která to bude dělat požadovaným způsobem (není to až zas tak těžké)

----

See also: `<./usb-klavesnice-a-usb-obecneji-nkro.html>`_