drivers/net/wireless/st/cw1200/wsm.c
Source file repositories/reference/linux-study-clean/drivers/net/wireless/st/cw1200/wsm.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/net/wireless/st/cw1200/wsm.c- Extension
.c- Size
- 44127 bytes
- Lines
- 1818
- Domain
- Driver Families
- Bucket
- drivers/net
- Inferred role
- Driver Families: implementation source
- Status
- source 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.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- 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/skbuff.hlinux/wait.hlinux/delay.hlinux/sched.hlinux/random.hcw1200.hwsm.hbh.hsta.hdebug.h
Detected Declarations
struct wsm_mibfunction wsm_generic_confirmfunction wsm_configurationfunction wsm_configuration_confirmfunction wsm_resetfunction wsm_read_mibfunction wsm_read_mib_confirmfunction wsm_write_mibfunction wsm_write_mib_confirmfunction wsm_scanfunction wsm_stop_scanfunction wsm_tx_confirmfunction wsm_multi_tx_confirmfunction wsm_join_confirmfunction wsm_joinfunction wsm_set_bss_paramsfunction wsm_add_keyfunction wsm_remove_keyfunction wsm_set_tx_queue_paramsfunction wsm_set_edca_paramsfunction wsm_switch_channelfunction wsm_set_pmfunction wsm_startfunction wsm_beacon_transmitfunction wsm_start_findfunction wsm_stop_findfunction wsm_map_linkfunction wsm_update_iefunction wsm_set_probe_responderfunction wsm_startup_indicationfunction wsm_receive_indicationfunction wsm_event_indicationfunction wsm_channel_switch_indicationfunction wsm_set_pm_indicationfunction wsm_scan_startedfunction wsm_scan_complete_indicationfunction wsm_join_complete_indicationfunction wsm_find_complete_indicationfunction wsm_ba_timeout_indicationfunction wsm_suspend_resume_indicationfunction wsm_cmd_sendfunction wsm_lock_txfunction wsm_lock_tx_asyncfunction wsm_flush_txfunction wsm_unlock_txfunction wsm_handle_exceptionfunction wsm_handle_rxfunction wsm_cmd_send
Annotated Snippet
struct wsm_mib {
u16 mib_id;
void *buf;
size_t buf_size;
};
int wsm_read_mib(struct cw1200_common *priv, u16 mib_id, void *_buf,
size_t buf_size)
{
int ret;
struct wsm_buf *buf = &priv->wsm_cmd_buf;
struct wsm_mib mib_buf = {
.mib_id = mib_id,
.buf = _buf,
.buf_size = buf_size,
};
wsm_cmd_lock(priv);
WSM_PUT16(buf, mib_id);
WSM_PUT16(buf, 0);
ret = wsm_cmd_send(priv, buf, &mib_buf,
WSM_READ_MIB_REQ_ID, WSM_CMD_TIMEOUT);
wsm_cmd_unlock(priv);
return ret;
nomem:
wsm_cmd_unlock(priv);
return -ENOMEM;
}
static int wsm_read_mib_confirm(struct cw1200_common *priv,
struct wsm_mib *arg,
struct wsm_buf *buf)
{
u16 size;
if (WARN_ON(WSM_GET32(buf) != WSM_STATUS_SUCCESS))
return -EINVAL;
if (WARN_ON(WSM_GET16(buf) != arg->mib_id))
return -EINVAL;
size = WSM_GET16(buf);
if (size > arg->buf_size)
size = arg->buf_size;
WSM_GET(buf, arg->buf, size);
arg->buf_size = size;
return 0;
underflow:
WARN_ON(1);
return -EINVAL;
}
/* ******************************************************************** */
int wsm_write_mib(struct cw1200_common *priv, u16 mib_id, void *_buf,
size_t buf_size)
{
int ret;
struct wsm_buf *buf = &priv->wsm_cmd_buf;
struct wsm_mib mib_buf = {
.mib_id = mib_id,
.buf = _buf,
.buf_size = buf_size,
};
wsm_cmd_lock(priv);
WSM_PUT16(buf, mib_id);
WSM_PUT16(buf, buf_size);
WSM_PUT(buf, _buf, buf_size);
ret = wsm_cmd_send(priv, buf, &mib_buf,
WSM_WRITE_MIB_REQ_ID, WSM_CMD_TIMEOUT);
wsm_cmd_unlock(priv);
return ret;
nomem:
wsm_cmd_unlock(priv);
return -ENOMEM;
}
static int wsm_write_mib_confirm(struct cw1200_common *priv,
struct wsm_mib *arg,
struct wsm_buf *buf)
{
int ret;
Annotation
- Immediate include surface: `linux/skbuff.h`, `linux/wait.h`, `linux/delay.h`, `linux/sched.h`, `linux/random.h`, `cw1200.h`, `wsm.h`, `bh.h`.
- Detected declarations: `struct wsm_mib`, `function wsm_generic_confirm`, `function wsm_configuration`, `function wsm_configuration_confirm`, `function wsm_reset`, `function wsm_read_mib`, `function wsm_read_mib_confirm`, `function wsm_write_mib`, `function wsm_write_mib_confirm`, `function wsm_scan`.
- Atlas domain: Driver Families / drivers/net.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
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.