STRUCT IOSM_IMEM(9)

🌈 struct iosm_imem(9) — Kernel API Manual 🌈

okay bestie, welcome to the manual page for struct iosm_imem(9) — literally the current state of the IPC shared memory. no cap, this struct is the main character of the IPC shared-memory situation 💅✨

🌸 NAME 🌸

struct iosm_imem — current state of the IPC shared memory. 🫶

✨ SYNOPSIS ✨

       struct iosm_imem {
           struct iosm_mmio *mmio;
           struct iosm_protocol *ipc_protocol;
           struct ipc_task *ipc_task;
           struct iosm_wwan *wwan;
           struct iosm_mux *mux;
           struct iosm_cdev *ipc_port[IPC_MEM_MAX_CHANNELS];
           struct iosm_pcie *pcie;
         #ifdef CONFIG_WWAN_DEBUGFS;
           struct iosm_trace *trace;
         #endif;
           struct device *dev;
           enum ipc_mem_device_ipc_state ipc_requested_state;
           struct ipc_mem_channel channels[IPC_MEM_MAX_CHANNELS];
           struct iosm_devlink *ipc_devlink;
           u32 ipc_status;
           u32 nr_of_channels;
           struct hrtimer startup_timer;
           ktime_t hrtimer_period;
           struct hrtimer tdupdate_timer;
           struct hrtimer fast_update_timer;
           struct hrtimer td_alloc_timer;
           struct hrtimer adb_timer;
           enum rom_exit_code rom_exit_code;
           u32 enter_runtime;
           struct completion ul_pend_sem;
           u32 app_notify_ul_pend;
           struct completion dl_pend_sem;
           u32 app_notify_dl_pend;
           enum ipc_phase phase;
           u16 pci_device_id;
           int cp_version;
           int device_sleep;
           struct work_struct run_state_worker;
           u8 ev_irq_pending[IPC_IRQ_VECTORS];
           unsigned long flag;
           u8 td_update_timer_suspended:1, ev_mux_net_transmit_pending:1,
       reset_det_n:1, pcie_wake_n:1;
         #ifdef CONFIG_WWAN_DEBUGFS;
           struct dentry *debugfs_wwan_dir;
           struct dentry *debugfs_dir;
         #endif;
        };

quick vibe check: trace, debugfs_wwan_dir, and debugfs_dir are tucked behind #ifdef CONFIG_WWAN_DEBUGFS; in there — iykyk 🧚‍♀️

🧩 Members 🧩

• mmio — the mmio instance used to access the CP MMIO area / doorbell scratchpad. 🎛️
• ipc_protocol — the IPC Protocol instance. 🧠
• ipc_task — the task for entry into the ipc task queue. 🎟️
• wwan — the WWAN device pointer. 📡
• mux — the IP Data multiplexing state. 🧬
• ipc_port — a pointer to the IPC PORT data structure. 🚪
• pcie — the IPC PCIe. 🚀
• trace — a pointer to the IPC trace data structure. 🔍
• dev — a pointer to the device structure. 🏠
• ipc_requested_state — the expected IPC state on CP. 📌
• channels — the channel list with UL/DL pipe pairs. 🧵
• ipc_devlink — a pointer to the IPC Devlink data structure. 🧷
• ipc_status — the local ipc_status. 📊
• nr_of_channels — the number of configured channels. 🔢
• startup_timer — the startup timer for NAND support. ⏰
• hrtimer_period — the Hr timer period. 🕰️
• tdupdate_timer — delays the TD update doorbell. 🔔
• fast_update_timer — the forced head pointer update delay timer. ⚡
• td_alloc_timer — the timer for DL pipe TD allocation retry. 🔁
• adb_timer — the timer for finishing the ADB. ⏳
• rom_exit_code — the mapped boot rom exit code. 🧾
• enter_runtime — 1 means the transition to runtime phase was executed. 🏃‍♀️
• ul_pend_sem — the semaphore to wait/complete of UL TDs before closing pipe. 🚦
• app_notify_ul_pend — signals the app if a UL TD is pending. 📣
• dl_pend_sem — the semaphore to wait/complete of DL TDs before closing pipe. 🚧
• app_notify_dl_pend — signals the app if a DL TD is pending. 📢
• phase — the operating phase, like runtime. 🌙
• pci_device_id — the device ID. 🆔
• cp_version — the CP version. 🏷️
• device_sleep — the device sleep state. 😴
• run_state_worker — a pointer to the worker component for device setup operations to be called when the modem reaches RUN state. 🛠️
• ev_irq_pending — 0 means inform the IPC tasklet to process the irq actions. 📨
• flag — a flag to monitor the state of the driver. 🚩
• td_update_timer_suspended — if true, then the td update timer is suspended. ⏸️
• ev_mux_net_transmit_pending — 0 means inform the IPC tasklet to pass. 📬
• reset_det_n — the reset detect flag. 🔄
• pcie_wake_n — the PCIe wake flag. ☀️
• debugfs_wwan_dir — the WWAN Debug FS directory entry. 📁
• debugfs_dir — the Debug FS directory for driver-specific entries. 📂

👀 SEE ALSO 👀

Kernel file ./drivers/net/wwan/iosm/iosm_ipc_imem.h, plus enum ipc_ctype(9), struct ipc_pipe(9), struct ipc_mem_channel(9), enum ipc_phase(9), ipc_imem_init(9), ipc_imem_pm_s2idle_sleep(9), ipc_imem_pm_suspend(9), ipc_imem_pm_resume(9), ipc_imem_cleanup(9), ipc_imem_irq_process(9), imem_get_device_sleep_state(9), ipc_imem_td_update_timer_suspend(9), ipc_imem_channel_close(9), ipc_imem_channel_alloc(9), ipc_imem_channel_open(9), ipc_imem_td_update_timer_start(9), ipc_imem_ul_write_td(9), ipc_imem_ul_send(9), ipc_imem_channel_update(9), ipc_imem_channel_free(9), ipc_imem_hrtimer_stop(9), ipc_imem_pipe_cleanup(9), ipc_imem_pipe_close(9), ipc_imem_phase_update(9), ipc_imem_phase_get_string(9), ipc_imem_msg_send_feature_set(9), ipc_imem_ipc_init_check(9), ipc_imem_channel_init(9), and ipc_imem_devlink_trigger_chip_info(9) 🦋

mwah 💋 this cutie came from ./drivers/net/wwan/iosm, dated October 2026, and it's the struct iosm_imem(9) manual page. byeee 🫶🎀