mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-23 17:30:02 +00:00
![Lee Jones](/assets/img/avatar_default.png)
No attempt has been made to document any of the functions here. Fixes the following W=1 kernel build warning(s): drivers/usb/c67x00/c67x00-ll-hpi.c:269: warning: Function parameter or member 'sie' not described in 'c67x00_ll_usb_clear_status' drivers/usb/c67x00/c67x00-ll-hpi.c:269: warning: Function parameter or member 'bits' not described in 'c67x00_ll_usb_clear_status' drivers/usb/c67x00/c67x00-ll-hpi.c:404: warning: Function parameter or member 'dev' not described in 'c67x00_ll_write_mem_le16' drivers/usb/c67x00/c67x00-ll-hpi.c:404: warning: Function parameter or member 'addr' not described in 'c67x00_ll_write_mem_le16' drivers/usb/c67x00/c67x00-ll-hpi.c:404: warning: Function parameter or member 'data' not described in 'c67x00_ll_write_mem_le16' drivers/usb/c67x00/c67x00-ll-hpi.c:404: warning: Function parameter or member 'len' not described in 'c67x00_ll_write_mem_le16' drivers/usb/c67x00/c67x00-ll-hpi.c:443: warning: Function parameter or member 'dev' not described in 'c67x00_ll_read_mem_le16' drivers/usb/c67x00/c67x00-ll-hpi.c:443: warning: Function parameter or member 'addr' not described in 'c67x00_ll_read_mem_le16' drivers/usb/c67x00/c67x00-ll-hpi.c:443: warning: Function parameter or member 'data' not described in 'c67x00_ll_read_mem_le16' drivers/usb/c67x00/c67x00-ll-hpi.c:443: warning: Function parameter or member 'len' not described in 'c67x00_ll_read_mem_le16' Cc: Peter Korsgaard <jacmet@sunsite.dk> Signed-off-by: Lee Jones <lee.jones@linaro.org> Link: https://lore.kernel.org/r/20200702144625.2533530-27-lee.jones@linaro.org Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
477 lines
12 KiB
C
477 lines
12 KiB
C
// SPDX-License-Identifier: GPL-2.0+
|
|
/*
|
|
* c67x00-ll-hpi.c: Cypress C67X00 USB Low level interface using HPI
|
|
*
|
|
* Copyright (C) 2006-2008 Barco N.V.
|
|
* Derived from the Cypress cy7c67200/300 ezusb linux driver and
|
|
* based on multiple host controller drivers inside the linux kernel.
|
|
*/
|
|
|
|
#include <asm/byteorder.h>
|
|
#include <linux/delay.h>
|
|
#include <linux/io.h>
|
|
#include <linux/jiffies.h>
|
|
#include <linux/usb/c67x00.h>
|
|
#include "c67x00.h"
|
|
|
|
#define COMM_REGS 14
|
|
|
|
struct c67x00_lcp_int_data {
|
|
u16 regs[COMM_REGS];
|
|
};
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
/* Interface definitions */
|
|
|
|
#define COMM_ACK 0x0FED
|
|
#define COMM_NAK 0xDEAD
|
|
|
|
#define COMM_RESET 0xFA50
|
|
#define COMM_EXEC_INT 0xCE01
|
|
#define COMM_INT_NUM 0x01C2
|
|
|
|
/* Registers 0 to COMM_REGS-1 */
|
|
#define COMM_R(x) (0x01C4 + 2 * (x))
|
|
|
|
#define HUSB_SIE_pCurrentTDPtr(x) ((x) ? 0x01B2 : 0x01B0)
|
|
#define HUSB_SIE_pTDListDone_Sem(x) ((x) ? 0x01B8 : 0x01B6)
|
|
#define HUSB_pEOT 0x01B4
|
|
|
|
/* Software interrupts */
|
|
/* 114, 115: */
|
|
#define HUSB_SIE_INIT_INT(x) ((x) ? 0x0073 : 0x0072)
|
|
#define HUSB_RESET_INT 0x0074
|
|
|
|
#define SUSB_INIT_INT 0x0071
|
|
#define SUSB_INIT_INT_LOC (SUSB_INIT_INT * 2)
|
|
|
|
/* -----------------------------------------------------------------------
|
|
* HPI implementation
|
|
*
|
|
* The c67x00 chip also support control via SPI or HSS serial
|
|
* interfaces. However, this driver assumes that register access can
|
|
* be performed from IRQ context. While this is a safe assumption with
|
|
* the HPI interface, it is not true for the serial interfaces.
|
|
*/
|
|
|
|
/* HPI registers */
|
|
#define HPI_DATA 0
|
|
#define HPI_MAILBOX 1
|
|
#define HPI_ADDR 2
|
|
#define HPI_STATUS 3
|
|
|
|
/*
|
|
* According to CY7C67300 specification (tables 140 and 141) HPI read and
|
|
* write cycle duration Tcyc must be at least 6T long, where T is 1/48MHz,
|
|
* which is 125ns.
|
|
*/
|
|
#define HPI_T_CYC_NS 125
|
|
|
|
static inline u16 hpi_read_reg(struct c67x00_device *dev, int reg)
|
|
{
|
|
ndelay(HPI_T_CYC_NS);
|
|
return __raw_readw(dev->hpi.base + reg * dev->hpi.regstep);
|
|
}
|
|
|
|
static inline void hpi_write_reg(struct c67x00_device *dev, int reg, u16 value)
|
|
{
|
|
ndelay(HPI_T_CYC_NS);
|
|
__raw_writew(value, dev->hpi.base + reg * dev->hpi.regstep);
|
|
}
|
|
|
|
static inline u16 hpi_read_word_nolock(struct c67x00_device *dev, u16 reg)
|
|
{
|
|
hpi_write_reg(dev, HPI_ADDR, reg);
|
|
return hpi_read_reg(dev, HPI_DATA);
|
|
}
|
|
|
|
static u16 hpi_read_word(struct c67x00_device *dev, u16 reg)
|
|
{
|
|
u16 value;
|
|
unsigned long flags;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
value = hpi_read_word_nolock(dev, reg);
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
|
|
return value;
|
|
}
|
|
|
|
static void hpi_write_word_nolock(struct c67x00_device *dev, u16 reg, u16 value)
|
|
{
|
|
hpi_write_reg(dev, HPI_ADDR, reg);
|
|
hpi_write_reg(dev, HPI_DATA, value);
|
|
}
|
|
|
|
static void hpi_write_word(struct c67x00_device *dev, u16 reg, u16 value)
|
|
{
|
|
unsigned long flags;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
hpi_write_word_nolock(dev, reg, value);
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
}
|
|
|
|
/*
|
|
* Only data is little endian, addr has cpu endianess
|
|
*/
|
|
static void hpi_write_words_le16(struct c67x00_device *dev, u16 addr,
|
|
__le16 *data, u16 count)
|
|
{
|
|
unsigned long flags;
|
|
int i;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
|
|
hpi_write_reg(dev, HPI_ADDR, addr);
|
|
for (i = 0; i < count; i++)
|
|
hpi_write_reg(dev, HPI_DATA, le16_to_cpu(*data++));
|
|
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
}
|
|
|
|
/*
|
|
* Only data is little endian, addr has cpu endianess
|
|
*/
|
|
static void hpi_read_words_le16(struct c67x00_device *dev, u16 addr,
|
|
__le16 *data, u16 count)
|
|
{
|
|
unsigned long flags;
|
|
int i;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
hpi_write_reg(dev, HPI_ADDR, addr);
|
|
for (i = 0; i < count; i++)
|
|
*data++ = cpu_to_le16(hpi_read_reg(dev, HPI_DATA));
|
|
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
}
|
|
|
|
static void hpi_set_bits(struct c67x00_device *dev, u16 reg, u16 mask)
|
|
{
|
|
u16 value;
|
|
unsigned long flags;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
value = hpi_read_word_nolock(dev, reg);
|
|
hpi_write_word_nolock(dev, reg, value | mask);
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
}
|
|
|
|
static void hpi_clear_bits(struct c67x00_device *dev, u16 reg, u16 mask)
|
|
{
|
|
u16 value;
|
|
unsigned long flags;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
value = hpi_read_word_nolock(dev, reg);
|
|
hpi_write_word_nolock(dev, reg, value & ~mask);
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
}
|
|
|
|
static u16 hpi_recv_mbox(struct c67x00_device *dev)
|
|
{
|
|
u16 value;
|
|
unsigned long flags;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
value = hpi_read_reg(dev, HPI_MAILBOX);
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
|
|
return value;
|
|
}
|
|
|
|
static u16 hpi_send_mbox(struct c67x00_device *dev, u16 value)
|
|
{
|
|
unsigned long flags;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
hpi_write_reg(dev, HPI_MAILBOX, value);
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
|
|
return value;
|
|
}
|
|
|
|
u16 c67x00_ll_hpi_status(struct c67x00_device *dev)
|
|
{
|
|
u16 value;
|
|
unsigned long flags;
|
|
|
|
spin_lock_irqsave(&dev->hpi.lock, flags);
|
|
value = hpi_read_reg(dev, HPI_STATUS);
|
|
spin_unlock_irqrestore(&dev->hpi.lock, flags);
|
|
|
|
return value;
|
|
}
|
|
|
|
void c67x00_ll_hpi_reg_init(struct c67x00_device *dev)
|
|
{
|
|
int i;
|
|
|
|
hpi_recv_mbox(dev);
|
|
c67x00_ll_hpi_status(dev);
|
|
hpi_write_word(dev, HPI_IRQ_ROUTING_REG, 0);
|
|
|
|
for (i = 0; i < C67X00_SIES; i++) {
|
|
hpi_write_word(dev, SIEMSG_REG(i), 0);
|
|
hpi_read_word(dev, SIEMSG_REG(i));
|
|
}
|
|
}
|
|
|
|
void c67x00_ll_hpi_enable_sofeop(struct c67x00_sie *sie)
|
|
{
|
|
hpi_set_bits(sie->dev, HPI_IRQ_ROUTING_REG,
|
|
SOFEOP_TO_HPI_EN(sie->sie_num));
|
|
}
|
|
|
|
void c67x00_ll_hpi_disable_sofeop(struct c67x00_sie *sie)
|
|
{
|
|
hpi_clear_bits(sie->dev, HPI_IRQ_ROUTING_REG,
|
|
SOFEOP_TO_HPI_EN(sie->sie_num));
|
|
}
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
/* Transactions */
|
|
|
|
static inline int ll_recv_msg(struct c67x00_device *dev)
|
|
{
|
|
u16 res;
|
|
|
|
res = wait_for_completion_timeout(&dev->hpi.lcp.msg_received, 5 * HZ);
|
|
WARN_ON(!res);
|
|
|
|
return (res == 0) ? -EIO : 0;
|
|
}
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
/* General functions */
|
|
|
|
u16 c67x00_ll_fetch_siemsg(struct c67x00_device *dev, int sie_num)
|
|
{
|
|
u16 val;
|
|
|
|
val = hpi_read_word(dev, SIEMSG_REG(sie_num));
|
|
/* clear register to allow next message */
|
|
hpi_write_word(dev, SIEMSG_REG(sie_num), 0);
|
|
|
|
return val;
|
|
}
|
|
|
|
u16 c67x00_ll_get_usb_ctl(struct c67x00_sie *sie)
|
|
{
|
|
return hpi_read_word(sie->dev, USB_CTL_REG(sie->sie_num));
|
|
}
|
|
|
|
/*
|
|
* c67x00_ll_usb_clear_status - clear the USB status bits
|
|
*/
|
|
void c67x00_ll_usb_clear_status(struct c67x00_sie *sie, u16 bits)
|
|
{
|
|
hpi_write_word(sie->dev, USB_STAT_REG(sie->sie_num), bits);
|
|
}
|
|
|
|
u16 c67x00_ll_usb_get_status(struct c67x00_sie *sie)
|
|
{
|
|
return hpi_read_word(sie->dev, USB_STAT_REG(sie->sie_num));
|
|
}
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
|
|
static int c67x00_comm_exec_int(struct c67x00_device *dev, u16 nr,
|
|
struct c67x00_lcp_int_data *data)
|
|
{
|
|
int i, rc;
|
|
|
|
mutex_lock(&dev->hpi.lcp.mutex);
|
|
hpi_write_word(dev, COMM_INT_NUM, nr);
|
|
for (i = 0; i < COMM_REGS; i++)
|
|
hpi_write_word(dev, COMM_R(i), data->regs[i]);
|
|
hpi_send_mbox(dev, COMM_EXEC_INT);
|
|
rc = ll_recv_msg(dev);
|
|
mutex_unlock(&dev->hpi.lcp.mutex);
|
|
|
|
return rc;
|
|
}
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
/* Host specific functions */
|
|
|
|
void c67x00_ll_set_husb_eot(struct c67x00_device *dev, u16 value)
|
|
{
|
|
mutex_lock(&dev->hpi.lcp.mutex);
|
|
hpi_write_word(dev, HUSB_pEOT, value);
|
|
mutex_unlock(&dev->hpi.lcp.mutex);
|
|
}
|
|
|
|
static inline void c67x00_ll_husb_sie_init(struct c67x00_sie *sie)
|
|
{
|
|
struct c67x00_device *dev = sie->dev;
|
|
struct c67x00_lcp_int_data data;
|
|
int rc;
|
|
|
|
rc = c67x00_comm_exec_int(dev, HUSB_SIE_INIT_INT(sie->sie_num), &data);
|
|
BUG_ON(rc); /* No return path for error code; crash spectacularly */
|
|
}
|
|
|
|
void c67x00_ll_husb_reset(struct c67x00_sie *sie, int port)
|
|
{
|
|
struct c67x00_device *dev = sie->dev;
|
|
struct c67x00_lcp_int_data data;
|
|
int rc;
|
|
|
|
data.regs[0] = 50; /* Reset USB port for 50ms */
|
|
data.regs[1] = port | (sie->sie_num << 1);
|
|
rc = c67x00_comm_exec_int(dev, HUSB_RESET_INT, &data);
|
|
BUG_ON(rc); /* No return path for error code; crash spectacularly */
|
|
}
|
|
|
|
void c67x00_ll_husb_set_current_td(struct c67x00_sie *sie, u16 addr)
|
|
{
|
|
hpi_write_word(sie->dev, HUSB_SIE_pCurrentTDPtr(sie->sie_num), addr);
|
|
}
|
|
|
|
u16 c67x00_ll_husb_get_current_td(struct c67x00_sie *sie)
|
|
{
|
|
return hpi_read_word(sie->dev, HUSB_SIE_pCurrentTDPtr(sie->sie_num));
|
|
}
|
|
|
|
u16 c67x00_ll_husb_get_frame(struct c67x00_sie *sie)
|
|
{
|
|
return hpi_read_word(sie->dev, HOST_FRAME_REG(sie->sie_num));
|
|
}
|
|
|
|
void c67x00_ll_husb_init_host_port(struct c67x00_sie *sie)
|
|
{
|
|
/* Set port into host mode */
|
|
hpi_set_bits(sie->dev, USB_CTL_REG(sie->sie_num), HOST_MODE);
|
|
c67x00_ll_husb_sie_init(sie);
|
|
/* Clear interrupts */
|
|
c67x00_ll_usb_clear_status(sie, HOST_STAT_MASK);
|
|
/* Check */
|
|
if (!(hpi_read_word(sie->dev, USB_CTL_REG(sie->sie_num)) & HOST_MODE))
|
|
dev_warn(sie_dev(sie),
|
|
"SIE %d not set to host mode\n", sie->sie_num);
|
|
}
|
|
|
|
void c67x00_ll_husb_reset_port(struct c67x00_sie *sie, int port)
|
|
{
|
|
/* Clear connect change */
|
|
c67x00_ll_usb_clear_status(sie, PORT_CONNECT_CHANGE(port));
|
|
|
|
/* Enable interrupts */
|
|
hpi_set_bits(sie->dev, HPI_IRQ_ROUTING_REG,
|
|
SOFEOP_TO_CPU_EN(sie->sie_num));
|
|
hpi_set_bits(sie->dev, HOST_IRQ_EN_REG(sie->sie_num),
|
|
SOF_EOP_IRQ_EN | DONE_IRQ_EN);
|
|
|
|
/* Enable pull down transistors */
|
|
hpi_set_bits(sie->dev, USB_CTL_REG(sie->sie_num), PORT_RES_EN(port));
|
|
}
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
|
|
void c67x00_ll_irq(struct c67x00_device *dev, u16 int_status)
|
|
{
|
|
if ((int_status & MBX_OUT_FLG) == 0)
|
|
return;
|
|
|
|
dev->hpi.lcp.last_msg = hpi_recv_mbox(dev);
|
|
complete(&dev->hpi.lcp.msg_received);
|
|
}
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
|
|
int c67x00_ll_reset(struct c67x00_device *dev)
|
|
{
|
|
int rc;
|
|
|
|
mutex_lock(&dev->hpi.lcp.mutex);
|
|
hpi_send_mbox(dev, COMM_RESET);
|
|
rc = ll_recv_msg(dev);
|
|
mutex_unlock(&dev->hpi.lcp.mutex);
|
|
|
|
return rc;
|
|
}
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
|
|
/*
|
|
* c67x00_ll_write_mem_le16 - write into c67x00 memory
|
|
* Only data is little endian, addr has cpu endianess.
|
|
*/
|
|
void c67x00_ll_write_mem_le16(struct c67x00_device *dev, u16 addr,
|
|
void *data, int len)
|
|
{
|
|
u8 *buf = data;
|
|
|
|
/* Sanity check */
|
|
if (addr + len > 0xffff) {
|
|
dev_err(&dev->pdev->dev,
|
|
"Trying to write beyond writable region!\n");
|
|
return;
|
|
}
|
|
|
|
if (addr & 0x01) {
|
|
/* unaligned access */
|
|
u16 tmp;
|
|
tmp = hpi_read_word(dev, addr - 1);
|
|
tmp = (tmp & 0x00ff) | (*buf++ << 8);
|
|
hpi_write_word(dev, addr - 1, tmp);
|
|
addr++;
|
|
len--;
|
|
}
|
|
|
|
hpi_write_words_le16(dev, addr, (__le16 *)buf, len / 2);
|
|
buf += len & ~0x01;
|
|
addr += len & ~0x01;
|
|
len &= 0x01;
|
|
|
|
if (len) {
|
|
u16 tmp;
|
|
tmp = hpi_read_word(dev, addr);
|
|
tmp = (tmp & 0xff00) | *buf;
|
|
hpi_write_word(dev, addr, tmp);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* c67x00_ll_read_mem_le16 - read from c67x00 memory
|
|
* Only data is little endian, addr has cpu endianess.
|
|
*/
|
|
void c67x00_ll_read_mem_le16(struct c67x00_device *dev, u16 addr,
|
|
void *data, int len)
|
|
{
|
|
u8 *buf = data;
|
|
|
|
if (addr & 0x01) {
|
|
/* unaligned access */
|
|
u16 tmp;
|
|
tmp = hpi_read_word(dev, addr - 1);
|
|
*buf++ = (tmp >> 8) & 0x00ff;
|
|
addr++;
|
|
len--;
|
|
}
|
|
|
|
hpi_read_words_le16(dev, addr, (__le16 *)buf, len / 2);
|
|
buf += len & ~0x01;
|
|
addr += len & ~0x01;
|
|
len &= 0x01;
|
|
|
|
if (len) {
|
|
u16 tmp;
|
|
tmp = hpi_read_word(dev, addr);
|
|
*buf = tmp & 0x00ff;
|
|
}
|
|
}
|
|
|
|
/* -------------------------------------------------------------------------- */
|
|
|
|
void c67x00_ll_init(struct c67x00_device *dev)
|
|
{
|
|
mutex_init(&dev->hpi.lcp.mutex);
|
|
init_completion(&dev->hpi.lcp.msg_received);
|
|
}
|
|
|
|
void c67x00_ll_release(struct c67x00_device *dev)
|
|
{
|
|
}
|