1. 02 Jul, 2022 2 commits
    • Maximilian Luz's avatar
      platform/surface: Add KIP/POS tablet-mode switch driver · 9f794056
      Maximilian Luz authored
      Add a driver providing a tablet-mode switch input device for Microsoft
      Surface devices using the Surface Aggregator KIP subsystem (to manage
      detachable peripherals) or POS subsystem (to obtain device posture
      information).
      
      The KIP (full name unknown, abbreviation found through reverse
      engineering) subsystem is used on the Surface Pro 8 and Surface Pro X to
      manage the keyboard cover. Among other things, it provides information
      on the positioning (posture) of the cover (closed, laptop-style,
      detached, folded-back, ...), which can be used to implement an input
      device providing the SW_TABLET_MODE event. Similarly, the POS (posture
      information) subsystem provides such information on the Surface Laptop
      Studio, with the difference being that the keyboard is not detachable.
      
      As implementing the tablet-mode switch for both subsystems is largely
      similar, the driver proposed in this commit, in large, acts as a generic
      tablet mode switch driver framework for the Surface Aggregator Module.
      Specific implementations using this framework are provided for the KIP
      and POS subsystems, adding tablet-mode switch support to the
      aforementioned devices.
      
      A few more notes on the Surface Laptop Studio:
      
      A peculiarity of the Surface Laptop Studio is its "slate/tent" mode
      (symbolized: user> _/\). In this mode, the screen covers the keyboard
      but leaves the touchpad exposed. This is essentially a mode in-between
      tablet and laptop, and it is debatable whether tablet-mode should be
      enabled in this mode. We therefore let the user decide this via a module
      parameter.
      
      In particular, tablet-mode may bring up the on-screen touch keyboard
      more easily, which would be desirable in this mode. However, some
      user-space software currently also decides to disable keyboard and, more
      importantly, touchpad input, while the touchpad is still accessible in
      the "slate/tent" mode. Furthermore, this mode shares its identifier with
      "slate/flipped" mode where the screen is flipped 180° and the keyboard
      points away from the user (symbolized: user> /_). In this mode we would
      like to enable auto-rotation, something that user-space software may
      only do when tablet-mode is enabled. We therefore default to the
      slate-mode enabling the tablet-mode switch.
      Signed-off-by: default avatarMaximilian Luz <luzmaximilian@gmail.com>
      Link: https://lore.kernel.org/r/20220624183642.910893-3-luzmaximilian@gmail.comReviewed-by: default avatarHans de Goede <hdegoede@redhat.com>
      Signed-off-by: default avatarHans de Goede <hdegoede@redhat.com>
      9f794056
    • Maximilian Luz's avatar
      platform/surface: aggregator: Add helper macros for requests with argument and return value · eb003bf3
      Maximilian Luz authored
      Add helper macros for synchronous stack-allocated Surface Aggregator
      request with both argument and return value, similar to the current
      argument-only and return-value-only ones.
      Signed-off-by: default avatarMaximilian Luz <luzmaximilian@gmail.com>
      Link: https://lore.kernel.org/r/20220624183642.910893-2-luzmaximilian@gmail.comReviewed-by: default avatarHans de Goede <hdegoede@redhat.com>
      Signed-off-by: default avatarHans de Goede <hdegoede@redhat.com>
      eb003bf3
  2. 28 Jun, 2022 9 commits
  3. 27 Jun, 2022 10 commits
  4. 22 Jun, 2022 11 commits
  5. 13 Jun, 2022 8 commits