AcoSail/kernel_optimize_test
8
0
Fork 0
forked from luck/tmp_suning_uos_patched
Code Pull Requests Activity

[POWERPC] Uartlite: Comment block tidy

Browse Source 
Tidy the comments to split the driver into logical section; the main driver,
the console driver, the platform bus binding, and module initialization
and teardown.

Signed-off-by: Grant Likely <grant.likely@secretlab.ca>
Signed-off-by: Josh Boyer <jwboyer@linux.vnet.ibm.com>
This commit is contained in:
Grant Likely 2007-10-02 12:15:59 +10:00 committed by Josh Boyer
parent 8fa7b61006
commit 435706b385
1 changed files with 40 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
drivers/serial/uartlite.c
View File

@ -23,9 +23,13 @@
#define ULITE_MINOR 187 #define ULITE_MINOR 187
#define ULITE_NR_UARTS 4 #define ULITE_NR_UARTS 4
/* For register details see datasheet: /* ---------------------------------------------------------------------
http://www.xilinx.com/bvdocs/ipcenter/data_sheet/opb_uartlite.pdf * Register definitions
*/ *
* For register details see datasheet:
* http://www.xilinx.com/bvdocs/ipcenter/data_sheet/opb_uartlite.pdf
*/
#define ULITE_RX 0x00 #define ULITE_RX 0x00
#define ULITE_TX 0x04 #define ULITE_TX 0x04
#define ULITE_STATUS 0x08 #define ULITE_STATUS 0x08
@ -49,6 +53,10 @@
static struct uart_port ulite_ports[ULITE_NR_UARTS]; static struct uart_port ulite_ports[ULITE_NR_UARTS];
/* ---------------------------------------------------------------------
* Core UART driver operations
*/
static int ulite_receive(struct uart_port *port, int stat) static int ulite_receive(struct uart_port *port, int stat)
{ {
struct tty_struct *tty = port->info->tty; struct tty_struct *tty = port->info->tty;
@ -308,6 +316,10 @@ static struct uart_ops ulite_ops = {
.verify_port = ulite_verify_port .verify_port = ulite_verify_port
}; };
/* ---------------------------------------------------------------------
* Console driver operations
*/
#ifdef CONFIG_SERIAL_UARTLITE_CONSOLE #ifdef CONFIG_SERIAL_UARTLITE_CONSOLE
static void ulite_console_wait_tx(struct uart_port *port) static void ulite_console_wait_tx(struct uart_port *port)
{ {
@ -413,6 +425,19 @@ static struct uart_driver ulite_uart_driver = {
#endif #endif
}; };
/* ---------------------------------------------------------------------
* Port assignment functions (mapping devices to uart_port structures)
*/
/** ulite_assign: register a uartlite device with the driver
*
* @dev: pointer to device structure
* @id: requested id number. Pass -1 for automatic port assignment
* @base: base address of uartlite registers
* @irq: irq number for uartlite
*
* Returns: 0 on success, <0 otherwise
*/
static int __devinit ulite_assign(struct device *dev, int id, u32 base, int irq) static int __devinit ulite_assign(struct device *dev, int id, u32 base, int irq)
{ {
struct uart_port *port; struct uart_port *port;
@ -465,6 +490,10 @@ static int __devinit ulite_assign(struct device *dev, int id, u32 base, int irq)
return 0; return 0;
} }
/** ulite_release: register a uartlite device with the driver
*
* @dev: pointer to device structure
*/
static int __devinit ulite_release(struct device *dev) static int __devinit ulite_release(struct device *dev)
{ {
struct uart_port *port = dev_get_drvdata(dev); struct uart_port *port = dev_get_drvdata(dev);
@ -479,6 +508,10 @@ static int __devinit ulite_release(struct device *dev)
return rc; return rc;
} }
/* ---------------------------------------------------------------------
* Platform bus binding
*/
static int __devinit ulite_probe(struct platform_device *pdev) static int __devinit ulite_probe(struct platform_device *pdev)
{ {
struct resource *res, *res2; struct resource *res, *res2;
@ -508,6 +541,10 @@ static struct platform_driver ulite_platform_driver = {
}, },
}; };
/* ---------------------------------------------------------------------
* Module setup/teardown
*/
int __init ulite_init(void) int __init ulite_init(void)
{ {
int ret; int ret;