dasharo/linux
0
0
Fork 0
mirror of https://github.com/Dasharo/linux.git synced 2026-03-06 15:25:10 -08:00
Code Issues Packages Projects Releases Wiki Activity

usb: Add support for Intel LJCA device

Browse Source 
Implements the USB part of Intel USB-I2C/GPIO/SPI adapter device
named "La Jolla Cove Adapter" (LJCA).

The communication between the various LJCA module drivers and the
hardware will be muxed/demuxed by this driver. Three modules (
I2C, GPIO, and SPI) are supported currently.

Each sub-module of LJCA device is identified by type field within
the LJCA message header.

The sub-modules of LJCA can use ljca_transfer() to issue a transfer
between host and hardware. And ljca_register_event_cb is exported
to LJCA sub-module drivers for hardware event subscription.

The minimum code in ASL that covers this board is
Scope (\_SB.PCI0.DWC3.RHUB.HS01)
    {
        Device (GPIO)
        {
            Name (_ADR, Zero)
            Name (_STA, 0x0F)
        }

        Device (I2C)
        {
            Name (_ADR, One)
            Name (_STA, 0x0F)
        }

        Device (SPI)
        {
            Name (_ADR, 0x02)
            Name (_STA, 0x0F)
        }
    }

Signed-off-by: Wentong Wu <wentong.wu@intel.com>
Reviewed-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: Andi Shyti <andi.shyti@linux.intel.com>
Tested-by: Hans de Goede <hdegoede@redhat.com>
Reviewed-by: Oliver Neukum <oneukum@suse.com>
Link: https://lore.kernel.org/r/1696833205-16716-2-git-send-email-wentong.wu@intel.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Wentong Wu
2023-10-09 14:33:22 +08:00
committed by Greg Kroah-Hartman
parent efa33cd89c
commit acd6199f19
4 changed files with 1061 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
drivers/usb/misc/Kconfig
View File

@@ -165,6 +165,19 @@ config APPLE_MFI_FASTCHARGE
It is safe to say M here.
config USB_LJCA
tristate "Intel La Jolla Cove Adapter support"
select AUXILIARY_BUS
depends on USB && ACPI
help
This adds support for Intel La Jolla Cove USB-I2C/SPI/GPIO
Master Adapter (LJCA). Additional drivers such as I2C_LJCA,
GPIO_LJCA and SPI_LJCA must be enabled in order to use the
functionality of the device.
This driver can also be built as a module. If so, the module
will be called usb-ljca.
source "drivers/usb/misc/sisusbvga/Kconfig"
config USB_LD

1
drivers/usb/misc/Makefile
View File

@@ -11,6 +11,7 @@ obj-$(CONFIG_USB_EMI26) += emi26.o
obj-$(CONFIG_USB_EMI62) += emi62.o
obj-$(CONFIG_USB_EZUSB_FX2) += ezusb.o
obj-$(CONFIG_APPLE_MFI_FASTCHARGE) += apple-mfi-fastcharge.o
obj-$(CONFIG_USB_LJCA) += usb-ljca.o
obj-$(CONFIG_USB_IDMOUSE) += idmouse.o
obj-$(CONFIG_USB_IOWARRIOR) += iowarrior.o
obj-$(CONFIG_USB_ISIGHTFW) += isight_firmware.o

902
drivers/usb/misc/usb-ljca.c Normal file
View File

File diff suppressed because it is too large Load Diff

145
include/linux/usb/ljca.h Normal file
View File

@@ -0,0 +1,145 @@
/* SPDX-License-Identifier: GPL-2.0-only */
/*
* Copyright (c) 2023, Intel Corporation. All rights reserved.
*/
#ifndef _LINUX_USB_LJCA_H_
#define _LINUX_USB_LJCA_H_
#include <linux/auxiliary_bus.h>
#include <linux/list.h>
#include <linux/spinlock.h>
#include <linux/types.h>
#define LJCA_MAX_GPIO_NUM 64
#define auxiliary_dev_to_ljca_client(auxiliary_dev) \
container_of(auxiliary_dev, struct ljca_client, auxdev)
struct ljca_adapter;
/**
* typedef ljca_event_cb_t - event callback function signature
*
* @context: the execution context of who registered this callback
* @cmd: the command from device for this event
* @evt_data: the event data payload
* @len: the event data payload length
*
* The callback function is called in interrupt context and the data payload is
* only valid during the call. If the user needs later access of the data, it
* must copy it.
*/
typedef void (*ljca_event_cb_t)(void *context, u8 cmd, const void *evt_data, int len);
/**
* struct ljca_client - represent a ljca client device
*
* @type: ljca client type
* @id: ljca client id within same client type
* @link: ljca client on the same ljca adapter
* @auxdev: auxiliary device object
* @adapter: ljca adapter the ljca client sit on
* @context: the execution context of the event callback
* @event_cb: ljca client driver register this callback to get
* firmware asynchronous rx buffer pending notifications
* @event_cb_lock: spinlock to protect event callback
*/
struct ljca_client {
u8 type;
u8 id;
struct list_head link;
struct auxiliary_device auxdev;
struct ljca_adapter *adapter;
void *context;
ljca_event_cb_t event_cb;
/* lock to protect event_cb */
spinlock_t event_cb_lock;
};
/**
* struct ljca_gpio_info - ljca gpio client device info
*
* @num: ljca gpio client device pin number
* @valid_pin_map: ljca gpio client device valid pin mapping
*/
struct ljca_gpio_info {
unsigned int num;
DECLARE_BITMAP(valid_pin_map, LJCA_MAX_GPIO_NUM);
};
/**
* struct ljca_i2c_info - ljca i2c client device info
*
* @id: ljca i2c client device identification number
* @capacity: ljca i2c client device capacity
* @intr_pin: ljca i2c client device interrupt pin number if exists
*/
struct ljca_i2c_info {
u8 id;
u8 capacity;
u8 intr_pin;
};
/**
* struct ljca_spi_info - ljca spi client device info
*
* @id: ljca spi client device identification number
* @capacity: ljca spi client device capacity
*/
struct ljca_spi_info {
u8 id;
u8 capacity;
};
/**
* ljca_register_event_cb - register a callback function to receive events
*
* @client: ljca client device
* @event_cb: callback function
* @context: execution context of event callback
*
* Return: 0 in case of success, negative value in case of error
*/
int ljca_register_event_cb(struct ljca_client *client, ljca_event_cb_t event_cb, void *context);
/**
* ljca_unregister_event_cb - unregister the callback function for an event
*
* @client: ljca client device
*/
void ljca_unregister_event_cb(struct ljca_client *client);
/**
* ljca_transfer - issue a LJCA command and wait for a response
*
* @client: ljca client device
* @cmd: the command to be sent to the device
* @obuf: the buffer to be sent to the device; it can be NULL if the user
* doesn't need to transmit data with this command
* @obuf_len: the size of the buffer to be sent to the device; it should
* be 0 when obuf is NULL
* @ibuf: any data associated with the response will be copied here; it can be
* NULL if the user doesn't need the response data
* @ibuf_len: must be initialized to the input buffer size
*
* Return: the actual length of response data for success, negative value for errors
*/
int ljca_transfer(struct ljca_client *client, u8 cmd, const u8 *obuf,
u8 obuf_len, u8 *ibuf, u8 ibuf_len);
/**
* ljca_transfer_noack - issue a LJCA command without a response
*
* @client: ljca client device
* @cmd: the command to be sent to the device
* @obuf: the buffer to be sent to the device; it can be NULL if the user
* doesn't need to transmit data with this command
* @obuf_len: the size of the buffer to be sent to the device
*
* Return: 0 for success, negative value for errors
*/
int ljca_transfer_noack(struct ljca_client *client, u8 cmd, const u8 *obuf,
u8 obuf_len);
#endif