LXR linux/include/net/caif/caif

   1/* SPDX-License-Identifier: GPL-2.0-only */
   2/*
   3 * Copyright (C) ST-Ericsson AB 2010
   4 * Author:      Sjur Brendeland
   5 */
   6
   7#ifndef CAIF_DEV_H_
   8#define CAIF_DEV_H_
   9
  10#include <net/caif/caif_layer.h>
  11#include <net/caif/cfcnfg.h>
  12#include <net/caif/caif_device.h>
  13#include <linux/caif/caif_socket.h>
  14#include <linux/if.h>
  15#include <linux/net.h>
  16
  17/**
  18 * struct caif_param - CAIF parameters.
  19 * @size:       Length of data
  20 * @data:       Binary Data Blob
  21 */
  22struct caif_param {
  23        u16  size;
  24        u8   data[256];
  25};
  26
  27/**
  28 * struct caif_connect_request - Request data for CAIF channel setup.
  29 * @protocol:           Type of CAIF protocol to use (at, datagram etc)
  30 * @sockaddr:           Socket address to connect.
  31 * @priority:           Priority of the connection.
  32 * @link_selector:      Link selector (high bandwidth or low latency)
  33 * @ifindex:            kernel index of the interface.
  34 * @param:              Connect Request parameters (CAIF_SO_REQ_PARAM).
  35 *
  36 * This struct is used when connecting a CAIF channel.
  37 * It contains all CAIF channel configuration options.
  38 */
  39struct caif_connect_request {
  40        enum caif_protocol_type protocol;
  41        struct sockaddr_caif sockaddr;
  42        enum caif_channel_priority priority;
  43        enum caif_link_selector link_selector;
  44        int ifindex;
  45        struct caif_param param;
  46};
  47
  48/**
  49 * caif_connect_client - Connect a client to CAIF Core Stack.
  50 * @config:             Channel setup parameters, specifying what address
  51 *                      to connect on the Modem.
  52 * @client_layer:       User implementation of client layer. This layer
  53 *                      MUST have receive and control callback functions
  54 *                      implemented.
  55 * @ifindex:            Link layer interface index used for this connection.
  56 * @headroom:           Head room needed by CAIF protocol.
  57 * @tailroom:           Tail room needed by CAIF protocol.
  58 *
  59 * This function connects a CAIF channel. The Client must implement
  60 * the struct cflayer. This layer represents the Client layer and holds
  61 * receive functions and control callback functions. Control callback
  62 * function will receive information about connect/disconnect responses,
  63 * flow control etc (see enum caif_control).
  64 * E.g. CAIF Socket will call this function for each socket it connects
  65 * and have one client_layer instance for each socket.
  66 */
  67int caif_connect_client(struct net *net,
  68                        struct caif_connect_request *conn_req,
  69                        struct cflayer *client_layer, int *ifindex,
  70                        int *headroom, int *tailroom);
  71
  72/**
  73 * caif_disconnect_client - Disconnects a client from the CAIF stack.
  74 *
  75 * @client_layer: Client layer to be disconnected.
  76 */
  77int caif_disconnect_client(struct net *net, struct cflayer *client_layer);
  78
  79
  80/**
  81 * caif_client_register_refcnt - register ref-count functions provided by client.
  82 *
  83 * @adapt_layer: Client layer using CAIF Stack.
  84 * @hold:       Function provided by client layer increasing ref-count
  85 * @put:        Function provided by client layer decreasing ref-count
  86 *
  87 * Client of the CAIF Stack must register functions for reference counting.
  88 * These functions are called by the CAIF Stack for every upstream packet,
  89 * and must therefore be implemented efficiently.
  90 *
  91 * Client should call caif_free_client when reference count degrease to zero.
  92 */
  93
  94void caif_client_register_refcnt(struct cflayer *adapt_layer,
  95                                        void (*hold)(struct cflayer *lyr),
  96                                        void (*put)(struct cflayer *lyr));
  97/**
  98 * caif_free_client - Free memory used to manage the client in the CAIF Stack.
  99 *
 100 * @client_layer: Client layer to be removed.
 101 *
 102 * This function must be called from client layer in order to free memory.
 103 * Caller must guarantee that no packets are in flight upstream when calling
 104 * this function.
 105 */
 106void caif_free_client(struct cflayer *adap_layer);
 107
 108/**
 109 * struct caif_enroll_dev - Enroll a net-device as a CAIF Link layer
 110 * @dev:                Network device to enroll.
 111 * @caifdev:            Configuration information from CAIF Link Layer
 112 * @link_support:       Link layer support layer
 113 * @head_room:          Head room needed by link support layer
 114 * @layer:              Lowest layer in CAIF stack
 115 * @rcv_fun:            Receive function for CAIF stack.
 116 *
 117 * This function enroll a CAIF link layer into CAIF Stack and
 118 * expects the interface to be able to handle CAIF payload.
 119 * The link_support layer is used to add any Link Layer specific
 120 * framing.
 121 */
 122int caif_enroll_dev(struct net_device *dev, struct caif_dev_common *caifdev,
 123                        struct cflayer *link_support, int head_room,
 124                        struct cflayer **layer, int (**rcv_func)(
 125                                struct sk_buff *, struct net_device *,
 126                                struct packet_type *, struct net_device *));
 127
 128#endif /* CAIF_DEV_H_ */
 129