iosm_ipc_imem_ops.h (4292B)
1/* SPDX-License-Identifier: GPL-2.0-only 2 * 3 * Copyright (C) 2020-21 Intel Corporation. 4 */ 5 6#ifndef IOSM_IPC_IMEM_OPS_H 7#define IOSM_IPC_IMEM_OPS_H 8 9#include "iosm_ipc_mux_codec.h" 10 11/* Maximum wait time for blocking read */ 12#define IPC_READ_TIMEOUT 3000 13 14/* The delay in ms for defering the unregister */ 15#define SIO_UNREGISTER_DEFER_DELAY_MS 1 16 17/* Default delay till CP PSI image is running and modem updates the 18 * execution stage. 19 * unit : milliseconds 20 */ 21#define PSI_START_DEFAULT_TIMEOUT 3000 22 23/* Default time out when closing SIO, till the modem is in 24 * running state. 25 * unit : milliseconds 26 */ 27#define BOOT_CHECK_DEFAULT_TIMEOUT 400 28 29/* IP MUX channel range */ 30#define IP_MUX_SESSION_START 0 31#define IP_MUX_SESSION_END 7 32 33/* Default IP MUX channel */ 34#define IP_MUX_SESSION_DEFAULT 0 35 36/** 37 * ipc_imem_sys_port_open - Open a port link to CP. 38 * @ipc_imem: Imem instance. 39 * @chl_id: Channel Indentifier. 40 * @hp_id: HP Indentifier. 41 * 42 * Return: channel instance on success, NULL for failure 43 */ 44struct ipc_mem_channel *ipc_imem_sys_port_open(struct iosm_imem *ipc_imem, 45 int chl_id, int hp_id); 46void ipc_imem_sys_port_close(struct iosm_imem *ipc_imem, 47 struct ipc_mem_channel *channel); 48 49/** 50 * ipc_imem_sys_cdev_write - Route the uplink buffer to CP. 51 * @ipc_cdev: iosm_cdev instance. 52 * @skb: Pointer to skb. 53 * 54 * Return: 0 on success and failure value on error 55 */ 56int ipc_imem_sys_cdev_write(struct iosm_cdev *ipc_cdev, struct sk_buff *skb); 57 58/** 59 * ipc_imem_sys_wwan_open - Open packet data online channel between network 60 * layer and CP. 61 * @ipc_imem: Imem instance. 62 * @if_id: ip link tag of the net device. 63 * 64 * Return: Channel ID on success and failure value on error 65 */ 66int ipc_imem_sys_wwan_open(struct iosm_imem *ipc_imem, int if_id); 67 68/** 69 * ipc_imem_sys_wwan_close - Close packet data online channel between network 70 * layer and CP. 71 * @ipc_imem: Imem instance. 72 * @if_id: IP link id net device. 73 * @channel_id: Channel ID to be closed. 74 */ 75void ipc_imem_sys_wwan_close(struct iosm_imem *ipc_imem, int if_id, 76 int channel_id); 77 78/** 79 * ipc_imem_sys_wwan_transmit - Function for transfer UL data 80 * @ipc_imem: Imem instance. 81 * @if_id: link ID of the device. 82 * @channel_id: Channel ID used 83 * @skb: Pointer to sk buffer 84 * 85 * Return: 0 on success and failure value on error 86 */ 87int ipc_imem_sys_wwan_transmit(struct iosm_imem *ipc_imem, int if_id, 88 int channel_id, struct sk_buff *skb); 89/** 90 * ipc_imem_wwan_channel_init - Initializes WWAN channels and the channel for 91 * MUX. 92 * @ipc_imem: Pointer to iosm_imem struct. 93 * @mux_type: Type of mux protocol. 94 */ 95void ipc_imem_wwan_channel_init(struct iosm_imem *ipc_imem, 96 enum ipc_mux_protocol mux_type); 97 98/** 99 * ipc_imem_sys_devlink_open - Open a Flash/CD Channel link to CP 100 * @ipc_imem: iosm_imem instance 101 * 102 * Return: channel instance on success, NULL for failure 103 */ 104struct ipc_mem_channel *ipc_imem_sys_devlink_open(struct iosm_imem *ipc_imem); 105 106/** 107 * ipc_imem_sys_devlink_close - Release a Flash/CD channel link to CP 108 * @ipc_devlink: Pointer to ipc_devlink data-struct 109 * 110 */ 111void ipc_imem_sys_devlink_close(struct iosm_devlink *ipc_devlink); 112 113/** 114 * ipc_imem_sys_devlink_notify_rx - Receive downlink characters from CP, 115 * the downlink skbuf is added at the end of the 116 * downlink or rx list 117 * @ipc_devlink: Pointer to ipc_devlink data-struct 118 * @skb: Pointer to sk buffer 119 */ 120void ipc_imem_sys_devlink_notify_rx(struct iosm_devlink *ipc_devlink, 121 struct sk_buff *skb); 122 123/** 124 * ipc_imem_sys_devlink_read - Copy the rx data and free the skbuf 125 * @ipc_devlink: Devlink instance 126 * @data: Buffer to read the data from modem 127 * @bytes_to_read: Size of destination buffer 128 * @bytes_read: Number of bytes read 129 * 130 * Return: 0 on success and failure value on error 131 */ 132int ipc_imem_sys_devlink_read(struct iosm_devlink *ipc_devlink, u8 *data, 133 u32 bytes_to_read, u32 *bytes_read); 134 135/** 136 * ipc_imem_sys_devlink_write - Route the uplink buffer to CP 137 * @ipc_devlink: Devlink_sio instance 138 * @buf: Pointer to buffer 139 * @count: Number of data bytes to write 140 * Return: 0 on success and failure value on error 141 */ 142int ipc_imem_sys_devlink_write(struct iosm_devlink *ipc_devlink, 143 unsigned char *buf, int count); 144 145#endif