drivers/tty/serial/sh-sci.c

File Facts

System

Linux kernel

Corpus path

drivers/tty/serial/sh-sci.c

Extension

.c

Size

108193 bytes

Lines

4137

Domain

Driver Families

Bucket

drivers/tty

Inferred role

Driver Families: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

• Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Touches IRQ or DMA behavior; this matters for the representative real-device path.
• Allocates kernel memory; connect allocation flags and lifetime to context constraints.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/bitops.h
• linux/clk.h
• linux/console.h
• linux/cpufreq.h
• linux/ctype.h
• linux/delay.h
• linux/dma-mapping.h
• linux/dmaengine.h
• linux/err.h
• linux/errno.h
• linux/init.h
• linux/interrupt.h
• linux/io.h
• linux/ioport.h
• linux/ktime.h
• linux/major.h
• linux/minmax.h
• linux/mm.h
• linux/module.h
• linux/of.h
• linux/platform_device.h
• linux/pm_runtime.h
• linux/reset.h
• linux/scatterlist.h
• linux/serial.h
• linux/serial_core.h
• linux/serial_sci.h
• linux/sh_dma.h
• linux/slab.h
• linux/string.h
• linux/sysrq.h
• linux/timer.h

Detected Declarations

• struct sci_suspend_regs
• function sci_suspend_regs_size
• function sci_serial_in
• function sci_serial_out
• function sci_port_enable
• function sci_port_disable
• function port_rx_irq_mask
• function sci_start_tx
• function sci_stop_tx
• function sci_start_rx
• function sci_stop_rx
• function sci_clear_SCxSR
• function defined
• function sci_poll_put_char
• function sci_init_pins
• function sci_txfill
• function sci_txroom
• function sci_rxfill
• function sci_transmit_chars
• function sci_receive_chars
• function sci_handle_errors
• function sci_is_rsci_type
• function sci_handle_fifo_overrun
• function sci_handle_breaks
• function scif_set_rtrg
• function scif_rtrg_enabled
• function rx_fifo_timer_fn
• function rx_fifo_trigger_show
• function rx_fifo_trigger_store
• function rx_fifo_timeout_show
• function rx_fifo_timeout_store
• function sci_dma_tx_complete
• function sci_dma_rx_push
• function sci_dma_rx_find_active
• function sci_dma_rx_chan_invalidate
• function sci_dma_rx_release
• function start_hrtimer_us
• function sci_dma_rx_reenable_irq
• function sci_dma_rx_complete
• function sci_dma_tx_release
• function sci_dma_rx_submit
• function sci_dma_tx_work_fn
• function sci_dma_rx_timer_fn
• function sci_request_dma
• function sci_free_dma
• function sci_flush_buffer
• function sci_dma_check_tx_occurred
• function sci_request_dma

Annotated Snippet

module_init(sci_init);
module_exit(sci_exit);

MODULE_LICENSE("GPL");
MODULE_ALIAS("platform:sh-sci");
MODULE_AUTHOR("Paul Mundt");
MODULE_DESCRIPTION("SuperH (H)SCI(F) serial driver");

Annotation

• Immediate include surface: `linux/bitops.h`, `linux/clk.h`, `linux/console.h`, `linux/cpufreq.h`, `linux/ctype.h`, `linux/delay.h`, `linux/dma-mapping.h`, `linux/dmaengine.h`.
• Detected declarations: `struct sci_suspend_regs`, `function sci_suspend_regs_size`, `function sci_serial_in`, `function sci_serial_out`, `function sci_port_enable`, `function sci_port_disable`, `function port_rx_irq_mask`, `function sci_start_tx`, `function sci_stop_tx`, `function sci_start_rx`.
• Atlas domain: Driver Families / drivers/tty.
• Implementation status: integration implementation candidate.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
• IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.