1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
/*
* hsi_driver_if.h
*
* Header for the HSI driver low level interface.
*
* Copyright (C) 2007-2008 Nokia Corporation. All rights reserved.
* Copyright (C) 2009 Texas Instruments, Inc.
*
* Author: Carlos Chinea <carlos.chinea@nokia.com>
* Author: Sebastien JAN <s-jan@ti.com>
*
* This package is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as
* published by the Free Software Foundation.
*
* THIS PACKAGE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
* WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*/
#ifndef __HSI_DRIVER_IF_H__
#define __HSI_DRIVER_IF_H__
#include <linux/platform_device.h>
#include <linux/device.h>
#include <linux/clk.h>
#include <linux/notifier.h>
/* The number of ports handled by the driver (MAX:2). Reducing this value
* optimizes the driver memory footprint.
*/
#define HSI_MAX_PORTS 1
/* bit-field definition for allowed controller IDs and channels */
#define ANY_HSI_CONTROLLER -1
/* HSR special divisor values set to control the auto-divisor Rx mode */
#define HSI_HSR_DIVISOR_AUTO 0x1000 /* Activate auto Rx */
#define HSI_SSR_DIVISOR_USE_TIMEOUT 0x1001 /* De-activate auto-Rx (SSI) */
enum {
HSI_EVENT_BREAK_DETECTED = 0,
HSI_EVENT_ERROR,
HSI_EVENT_PRE_SPEED_CHANGE,
HSI_EVENT_POST_SPEED_CHANGE,
HSI_EVENT_CAWAKE_UP,
HSI_EVENT_CAWAKE_DOWN,
HSI_EVENT_HSR_DATAAVAILABLE,
};
enum {
HSI_IOCTL_ACWAKE_DOWN = 0, /* Unset HST ACWAKE line for channel */
HSI_IOCTL_ACWAKE_UP, /* Set HSI wakeup line (acwake) for channel */
HSI_IOCTL_SEND_BREAK, /* Send a HW BREAK frame in FRAME mode */
HSI_IOCTL_GET_ACWAKE, /* Get HST CAWAKE line status */
HSI_IOCTL_FLUSH_RX, /* Force the HSR to idle state */
HSI_IOCTL_FLUSH_TX, /* Force the HST to idle state */
HSI_IOCTL_GET_CAWAKE, /* Get CAWAKE (HSR) line status */
HSI_IOCTL_SET_RX, /* Set HSR configuration */
HSI_IOCTL_GET_RX, /* Get HSR configuration */
HSI_IOCTL_SET_TX, /* Set HST configuration */
HSI_IOCTL_GET_TX, /* Get HST configuration */
HSI_IOCTL_SW_RESET, /* Force a HSI SW RESET */
HSI_IOCTL_GET_FIFO_OCCUPANCY, /* Get amount of words in RX FIFO */
HSI_IOCTL_SET_ACREADY_SAFEMODE,
HSI_IOCTL_SET_ACREADY_NORMAL,
HSI_IOCTL_SET_3WIRE_MODE,
HSI_IOCTL_SET_4WIRE_MODE,
};
/* Forward references */
struct hsi_device;
struct hsi_channel;
/* DPS */
struct hst_ctx {
u32 mode;
u32 flow;
u32 frame_size;
u32 divisor;
u32 arb_mode;
u32 channels;
};
struct hsr_ctx {
u32 mode;
u32 flow;
u32 frame_size;
u32 divisor;
u32 counters;
u32 channels;
};
struct port_ctx {
u32 sys_mpu_enable[2];
struct hst_ctx hst;
struct hsr_ctx hsr;
};
/**
* struct ctrl_ctx - hsi controller regs context
* @sysconfig: keeps HSI_SYSCONFIG reg state
* @gdd_gcr: keeps DMA_GCR reg state
* @dll: keeps HSR_DLL state
* @pctx: array of port context
*/
struct ctrl_ctx {
u32 sysconfig;
u32 gdd_gcr;
u32 dll;
struct port_ctx *pctx;
};
/* END DPS */
/**
* struct hsi_device - HSI device object (Virtual)
* @n_ctrl: associated HSI controller platform id number
* @n_p: port number
* @n_ch: channel number
* @ch: channel descriptor
* @device: associated device
*/
struct hsi_device {
int n_ctrl;
unsigned int n_p;
unsigned int n_ch;
struct hsi_channel *ch;
struct device device;
};
#define to_hsi_device(dev) container_of(dev, struct hsi_device, device)
/**
* struct hsi_device_driver - HSI driver instance container
* @ctrl_mask: bit-field indicating the supported HSI device ids
* @ch_mask: bit-field indicating enabled channels for this port
* @probe: probe callback (driver registering)
* @remove: remove callback (driver un-registering)
* @suspend: suspend callback
* @resume: resume callback
* @driver: associated device_driver object
*/
struct hsi_device_driver {
unsigned long ctrl_mask;
unsigned long ch_mask[HSI_MAX_PORTS];
int (*probe) (struct hsi_device *dev);
int (*remove) (struct hsi_device *dev);
int (*suspend) (struct hsi_device *dev, pm_message_t mesg);
int (*resume) (struct hsi_device *dev);
struct device_driver driver;
void *priv_data;
};
#define to_hsi_device_driver(drv) container_of(drv, \
struct hsi_device_driver, \
driver)
int hsi_register_driver(struct hsi_device_driver *driver);
void hsi_unregister_driver(struct hsi_device_driver *driver);
int hsi_open(struct hsi_device *dev);
int hsi_write(struct hsi_device *dev, u32 * addr, unsigned int size);
int hsi_write_cancel(struct hsi_device *dev);
int hsi_read(struct hsi_device *dev, u32 * addr, unsigned int size);
int hsi_read_cancel(struct hsi_device *dev);
int hsi_poll(struct hsi_device *dev);
int hsi_unpoll(struct hsi_device *dev);
int hsi_ioctl(struct hsi_device *dev, unsigned int command, void *arg);
void hsi_close(struct hsi_device *dev);
void hsi_set_read_cb(struct hsi_device *dev,
void (*read_cb) (struct hsi_device *dev,
unsigned int size));
void hsi_set_write_cb(struct hsi_device *dev,
void (*write_cb) (struct hsi_device *dev,
unsigned int size));
void hsi_set_port_event_cb(struct hsi_device *dev,
void (*port_event_cb) (struct hsi_device *dev,
unsigned int event,
void *arg));
#endif /* __HSI_DRIVER_IF_H__ */
|
