aspeed-video.rst 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. .. SPDX-License-Identifier: GPL-2.0
  2. .. include:: <isonum.txt>
  3. ASPEED video driver
  4. ===================
  5. ASPEED Video Engine found on AST2400/2500/2600 SoC supports high performance
  6. video compressions with a wide range of video quality and compression ratio
  7. options. The adopted compressing algorithm is a modified JPEG algorithm.
  8. There are 2 types of compressions in this IP.
  9. * JPEG JFIF standard mode: for single frame and management compression
  10. * ASPEED proprietary mode: for multi-frame and differential compression.
  11. Support 2-pass (high quality) video compression scheme (Patent pending by
  12. ASPEED). Provide visually lossless video compression quality or to reduce
  13. the network average loading under intranet KVM applications.
  14. VIDIOC_S_FMT can be used to choose which format you want. V4L2_PIX_FMT_JPEG
  15. stands for JPEG JFIF standard mode; V4L2_PIX_FMT_AJPG stands for ASPEED
  16. proprietary mode.
  17. More details on the ASPEED video hardware operations can be found in
  18. *chapter 6.2.16 KVM Video Driver* of SDK_User_Guide which available on
  19. `github <https://github.com/AspeedTech-BMC/openbmc/releases/>`__.
  20. The ASPEED video driver implements the following driver-specific control:
  21. ``V4L2_CID_ASPEED_HQ_MODE``
  22. ---------------------------
  23. Enable/Disable ASPEED's High quality mode. This is a private control
  24. that can be used to enable high quality for aspeed proprietary mode.
  25. .. flat-table::
  26. :header-rows: 0
  27. :stub-columns: 0
  28. :widths: 1 4
  29. * - ``(0)``
  30. - ASPEED HQ mode is disabled.
  31. * - ``(1)``
  32. - ASPEED HQ mode is enabled.
  33. ``V4L2_CID_ASPEED_HQ_JPEG_QUALITY``
  34. -----------------------------------
  35. Define the quality of ASPEED's High quality mode. This is a private control
  36. that can be used to decide compression quality if High quality mode enabled
  37. . Higher the value, better the quality and bigger the size.
  38. .. flat-table::
  39. :header-rows: 0
  40. :stub-columns: 0
  41. :widths: 1 4
  42. * - ``(1)``
  43. - minimum
  44. * - ``(12)``
  45. - maximum
  46. * - ``(1)``
  47. - step
  48. * - ``(1)``
  49. - default
  50. **Copyright** |copy| 2022 ASPEED Technology Inc.