target/linux/mvebu/patches-5.15/905-Documentation-ABI-Add-iei-wt61p803-puzzle-driver-sys.patch

   1 From 2fab3b4956c5b2f83c1e1abffc1df39de2933d83 Mon Sep 17 00:00:00 2001
   2 From: Luka Kovacic <luka.kovacic () sartura ! hr>
   3 Date: Tue, 24 Aug 2021 12:44:36 +0000
   4 Subject: [PATCH 5/7] Documentation/ABI: Add iei-wt61p803-puzzle driver sysfs
   5  interface documentation
   6
   7 Add the iei-wt61p803-puzzle driver sysfs interface documentation to allow
   8 monitoring and control of the microcontroller from user space.
   9
  10 Signed-off-by: Luka Kovacic <luka.kovacic@sartura.hr>
  11 Signed-off-by: Pavo Banicevic <pavo.banicevic@sartura.hr>
  12 Cc: Luka Perkov <luka.perkov@sartura.hr>
  13 Cc: Robert Marko <robert.marko@sartura.hr>
  14 ---
  15  .../testing/sysfs-driver-iei-wt61p803-puzzle  | 61 +++++++++++++++++++
  16  1 file changed, 61 insertions(+)
  17  create mode 100644 Documentation/ABI/testing/sysfs-driver-iei-wt61p803-puzzle
  18
  19 --- /dev/null
  20 +++ b/Documentation/ABI/testing/sysfs-driver-iei-wt61p803-puzzle
  21 @@ -0,0 +1,61 @@
  22 +What:          /sys/bus/serial/devices/.../mac_address_*
  23 +Date:          September 2020
  24 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  25 +Description:   (RW) Internal factory assigned MAC address values
  26 +
  27 +What:          /sys/bus/serial/devices/.../serial_number
  28 +Date:          September 2020
  29 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  30 +Description:   (RW) Internal factory assigned serial number
  31 +
  32 +What:          /sys/bus/serial/devices/.../version
  33 +Date:          September 2020
  34 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  35 +Description:   (RO) Internal MCU firmware version
  36 +
  37 +What:          /sys/bus/serial/devices/.../protocol_version
  38 +Date:          September 2020
  39 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  40 +Description:   (RO) Internal MCU communication protocol version
  41 +
  42 +What:          /sys/bus/serial/devices/.../power_loss_recovery
  43 +Date:          September 2020
  44 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  45 +Description:   (RW) Host platform power loss recovery settings
  46 +               Value mapping: 0 - Always-On, 1 - Always-Off, 2 - Always-AC, 3 - Always-WA
  47 +
  48 +What:          /sys/bus/serial/devices/.../bootloader_mode
  49 +Date:          September 2020
  50 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  51 +Description:   (RO) Internal MCU bootloader mode status
  52 +               Value mapping:
  53 +               0 - normal mode
  54 +               1 - bootloader mode
  55 +
  56 +What:          /sys/bus/serial/devices/.../power_status
  57 +Date:          September 2020
  58 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  59 +Description:   (RO) Power status indicates the host platform power on method.
  60 +               Value mapping (bitwise list):
  61 +               0x80 - Null
  62 +               0x40 - Firmware flag
  63 +               0x20 - Power loss detection flag (powered off)
  64 +               0x10 - Power loss detection flag (AC mode)
  65 +               0x08 - Button power on
  66 +               0x04 - Wake-on-LAN power on
  67 +               0x02 - RTC alarm power on
  68 +               0x01 - AC recover power on
  69 +
  70 +What:          /sys/bus/serial/devices/.../build_info
  71 +Date:          September 2020
  72 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  73 +Description:   (RO) Internal MCU firmware build date
  74 +               Format: yyyy/mm/dd hh:mm
  75 +
  76 +What:          /sys/bus/serial/devices/.../ac_recovery_status
  77 +Date:          September 2020
  78 +Contact:       Luka Kovacic <luka.kovacic@sartura.hr>
  79 +Description:   (RO) Host platform AC recovery status value
  80 +               Value mapping:
  81 +               0 - board has not been recovered from power down
  82 +               1 - board has been recovered from power down