mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-12-29 01:05:29 +00:00
7852fe3a09
Correct spelling problems for Documentation/driver-api/ as reported by codespell. Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Cc: Mauro Carvalho Chehab <mchehab@kernel.org> Cc: linux-media@vger.kernel.org Cc: Vishal Verma <vishal.l.verma@intel.com> Cc: Dave Jiang <dave.jiang@intel.com> Cc: nvdimm@lists.linux.dev Cc: Vinod Koul <vkoul@kernel.org> Cc: dmaengine@vger.kernel.org Cc: linux-raid@vger.kernel.org Cc: linux-usb@vger.kernel.org Acked-by: Dan Williams <dan.j.williams@intel.com> Acked-by: Song Liu <song@kernel.org> Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Link: https://lore.kernel.org/r/20230129231053.20863-3-rdunlap@infradead.org Signed-off-by: Jonathan Corbet <corbet@lwn.net>
89 lines
3.1 KiB
ReStructuredText
89 lines
3.1 KiB
ReStructuredText
High Speed Synchronous Serial Interface (HSI)
|
|
=============================================
|
|
|
|
Introduction
|
|
---------------
|
|
|
|
High Speed Synchronous Interface (HSI) is a full duplex, low latency protocol,
|
|
that is optimized for die-level interconnect between an Application Processor
|
|
and a Baseband chipset. It has been specified by the MIPI alliance in 2003 and
|
|
implemented by multiple vendors since then.
|
|
|
|
The HSI interface supports full duplex communication over multiple channels
|
|
(typically 8) and is capable of reaching speeds up to 200 Mbit/s.
|
|
|
|
The serial protocol uses two signals, DATA and FLAG as combined data and clock
|
|
signals and an additional READY signal for flow control. An additional WAKE
|
|
signal can be used to wakeup the chips from standby modes. The signals are
|
|
commonly prefixed by AC for signals going from the application die to the
|
|
cellular die and CA for signals going the other way around.
|
|
|
|
::
|
|
|
|
+------------+ +---------------+
|
|
| Cellular | | Application |
|
|
| Die | | Die |
|
|
| | - - - - - - CAWAKE - - - - - - >| |
|
|
| T|------------ CADATA ------------>|R |
|
|
| X|------------ CAFLAG ------------>|X |
|
|
| |<----------- ACREADY ------------| |
|
|
| | | |
|
|
| | | |
|
|
| |< - - - - - ACWAKE - - - - - - -| |
|
|
| R|<----------- ACDATA -------------|T |
|
|
| X|<----------- ACFLAG -------------|X |
|
|
| |------------ CAREADY ----------->| |
|
|
| | | |
|
|
| | | |
|
|
+------------+ +---------------+
|
|
|
|
HSI Subsystem in Linux
|
|
-------------------------
|
|
|
|
In the Linux kernel the hsi subsystem is supposed to be used for HSI devices.
|
|
The hsi subsystem contains drivers for hsi controllers including support for
|
|
multi-port controllers and provides a generic API for using the HSI ports.
|
|
|
|
It also contains HSI client drivers, which make use of the generic API to
|
|
implement a protocol used on the HSI interface. These client drivers can
|
|
use an arbitrary number of channels.
|
|
|
|
hsi-char Device
|
|
------------------
|
|
|
|
Each port automatically registers a generic client driver called hsi_char,
|
|
which provides a character device for userspace representing the HSI port.
|
|
It can be used to communicate via HSI from userspace. Userspace may
|
|
configure the hsi_char device using the following ioctl commands:
|
|
|
|
HSC_RESET
|
|
flush the HSI port
|
|
|
|
HSC_SET_PM
|
|
enable or disable the client.
|
|
|
|
HSC_SEND_BREAK
|
|
send break
|
|
|
|
HSC_SET_RX
|
|
set RX configuration
|
|
|
|
HSC_GET_RX
|
|
get RX configuration
|
|
|
|
HSC_SET_TX
|
|
set TX configuration
|
|
|
|
HSC_GET_TX
|
|
get TX configuration
|
|
|
|
The kernel HSI API
|
|
------------------
|
|
|
|
.. kernel-doc:: include/linux/hsi/hsi.h
|
|
:internal:
|
|
|
|
.. kernel-doc:: drivers/hsi/hsi_core.c
|
|
:export:
|
|
|