net: Add support for rmnet_data driver
Subsystems (3)
cover net: Add support for rmnet_data driver
This patch adds support for the rmnet_data driver which is required to support recent chipsets using Qualcomm Technologies, Inc. modems. The data from hardware follows the multiplexing and aggregation protocol (MAP).
This driver can be used to register onto any physical network device in IP mode. Physical transports include USB, HSIC, PCIe and IP accelerator.
rmnet_data driver helps to decode these packets and queue them to network stack (and encode and transmit it to the physical device).
Subash Abhinov Kasiviswanathan (1):
net: rmnet_data: Initial implementation
Documentation/networking/rmnet_data.txt | 82 +++ include/uapi/linux/Kbuild | 2 + include/uapi/linux/if_arp.h | 1 + include/uapi/linux/if_ether.h | 3 +- include/uapi/linux/rmnet_data.h | 416 +++++++++++ net/Kconfig | 1 + net/Makefile | 1 + net/rmnet_data/Kconfig | 21 + net/rmnet_data/Makefile | 14 + net/rmnet_data/rmnet_data_config.c | 1149 +++++++++++++++++++++++++++++++ net/rmnet_data/rmnet_data_config.h | 123 ++++ net/rmnet_data/rmnet_data_handlers.c | 560 +++++++++++++++ net/rmnet_data/rmnet_data_handlers.h | 24 + net/rmnet_data/rmnet_data_main.c | 60 ++ net/rmnet_data/rmnet_data_private.h | 76 ++ net/rmnet_data/rmnet_data_stats.c | 86 +++ net/rmnet_data/rmnet_data_stats.h | 61 ++ net/rmnet_data/rmnet_data_trace.h | 183 +++++ net/rmnet_data/rmnet_data_vnd.c | 602 ++++++++++++++++ net/rmnet_data/rmnet_data_vnd.h | 40 ++ net/rmnet_data/rmnet_map.h | 148 ++++ net/rmnet_data/rmnet_map_command.c | 180 +++++ net/rmnet_data/rmnet_map_data.c | 154 +++++ 23 files changed, 3986 insertions(+), 1 deletion(-) create mode 100644 Documentation/networking/rmnet_data.txt create mode 100644 include/uapi/linux/rmnet_data.h create mode 100644 net/rmnet_data/Kconfig create mode 100644 net/rmnet_data/Makefile create mode 100644 net/rmnet_data/rmnet_data_config.c create mode 100644 net/rmnet_data/rmnet_data_config.h create mode 100644 net/rmnet_data/rmnet_data_handlers.c create mode 100644 net/rmnet_data/rmnet_data_handlers.h create mode 100644 net/rmnet_data/rmnet_data_main.c create mode 100644 net/rmnet_data/rmnet_data_private.h create mode 100644 net/rmnet_data/rmnet_data_stats.c create mode 100644 net/rmnet_data/rmnet_data_stats.h create mode 100644 net/rmnet_data/rmnet_data_trace.h create mode 100644 net/rmnet_data/rmnet_data_vnd.c create mode 100644 net/rmnet_data/rmnet_data_vnd.h create mode 100644 net/rmnet_data/rmnet_map.h create mode 100644 net/rmnet_data/rmnet_map_command.c create mode 100644 net/rmnet_data/rmnet_map_data.c
Signature · 1 line
1.9.1
RFC PATCH 1/1 net: rmnet_data: Initial implementation
RmNet Data driver provides a transport agnostic MAP (multiplexing and aggregation protocol) support in embedded and bridge modes. Module provides virtual network devices which can be attached to any IP-mode physical device. This will be used to provide all MAP functionality on future hardware in a single consistent location.
--- Documentation/networking/rmnet_data.txt | 82 +++ include/uapi/linux/Kbuild | 2 + include/uapi/linux/if_arp.h | 1 + include/uapi/linux/if_ether.h | 3 +- include/uapi/linux/rmnet_data.h | 416 +++++++++++ net/Kconfig | 1 + net/Makefile | 1 + net/rmnet_data/Kconfig | 21 + net/rmnet_data/Makefile | 14 + net/rmnet_data/rmnet_data_config.c | 1149 +++++++++++++++++++++++++++++++ net/rmnet_data/rmnet_data_config.h | 123 ++++ net/rmnet_data/rmnet_data_handlers.c | 560 +++++++++++++++ net/rmnet_data/rmnet_data_handlers.h | 24 + net/rmnet_data/rmnet_data_main.c | 60 ++ net/rmnet_data/rmnet_data_private.h | 76 ++ net/rmnet_data/rmnet_data_stats.c | 86 +++ net/rmnet_data/rmnet_data_stats.h | 61 ++ net/rmnet_data/rmnet_data_trace.h | 183 +++++ net/rmnet_data/rmnet_data_vnd.c | 602 ++++++++++++++++ net/rmnet_data/rmnet_data_vnd.h | 40 ++ net/rmnet_data/rmnet_map.h | 148 ++++ net/rmnet_data/rmnet_map_command.c | 180 +++++ net/rmnet_data/rmnet_map_data.c | 154 +++++ 23 files changed, 3986 insertions(+), 1 deletion(-) create mode 100644 Documentation/networking/rmnet_data.txt create mode 100644 include/uapi/linux/rmnet_data.h create mode 100644 net/rmnet_data/Kconfig create mode 100644 net/rmnet_data/Makefile create mode 100644 net/rmnet_data/rmnet_data_config.c create mode 100644 net/rmnet_data/rmnet_data_config.h create mode 100644 net/rmnet_data/rmnet_data_handlers.c create mode 100644 net/rmnet_data/rmnet_data_handlers.h create mode 100644 net/rmnet_data/rmnet_data_main.c create mode 100644 net/rmnet_data/rmnet_data_private.h create mode 100644 net/rmnet_data/rmnet_data_stats.c create mode 100644 net/rmnet_data/rmnet_data_stats.h create mode 100644 net/rmnet_data/rmnet_data_trace.h create mode 100644 net/rmnet_data/rmnet_data_vnd.c create mode 100644 net/rmnet_data/rmnet_data_vnd.h create mode 100644 net/rmnet_data/rmnet_map.h create mode 100644 net/rmnet_data/rmnet_map_command.c create mode 100644 net/rmnet_data/rmnet_map_data.c
Documentation/networking/rmnet_data.txt new file +82 -0
@@ -0,0 +1,82 @@ +1. Introduction + +rmnet_data driver is used for supporting the Multiplexing and aggregation +Protocol (MAP). This protocol is used by all recent chipsets using Qualcomm +Technologies, Inc. modems. + +This driver can be used to register onto any physical network device in +IP mode. Physical transports include USB, HSIC, PCIe and IP accelerator. + +Multiplexing allows for creation of logical netdevices (rmnet_data devices) to +handle multiple private data networks (PDN) like a default internet, tethering, +multimedia messaging service (MMS) or IP media subsystem (IMS). Hardware sends +packets with MAP headers to rmnet_data. Based on the multiplexer id, rmnet_data +routes to the appropriate PDN after removing the MAP header. + +Aggregation is required to achieve high data rates. This involves hardware +sending aggregated bunch of MAP frames. rmnet_data driver will de-aggregate +these MAP frames and send them to appropriate PDN's. + +2. Packet format + +a. MAP packet (data / control) + +MAP header has the same endianness of the IP packet. + +Packet format - + +Bit 0 1 2-7 8 - 15 16 - 31 +Function Command / Data Reserved Pad Multiplexer ID Payload length +Bit 32 - x +Function Raw Bytes + +Command (1)/ Data (0) bit value is to indicate if the packet is a MAP command +or data packet. Control packet is used for transport level flow control. Data +packets are standard IP packets. + +Reserved bits are usually zeroed out and to be ignored by receiver. + +Padding is number of bytes to be added for 4 byte alignment if required by +hardware. + +Multiplexer ID is to indicate the PDN on which data has to be sent. + +Payload length includes the padding length but does not include MAP header +length. + +b. MAP packet (command specific) + +Bit 0 1 2-7 8 - 15 16 - 31 +Function Command Reserved Pad Multiplexer ID Payload length +Bit 32 - 39 40 - 45 46 - 47 48 - 63 +Function Command name Reserved Command Type Reserved +Bit 64 - 95 +Function Transaction ID +Bit 96 - 127 +Function Command data + +Command 1 indicates disabling flow while 2 is enabling flow + +Command types - +0 for MAP command request +1 is to acknowledge the receipt of a command +2 is for unsupported commands +3 is for error during processing of commands + +c. Aggregation + +Aggregation is multiple MAP packets (can be data or command) delivered to +rmnet_data in a single linear skb. rmnet_data will process the individual +packets and either ACK the MAP command or deliver the IP packet to the +network stack as needed + +MAP header|IP Packet|Optional padding|MAP header|IP Packet|Optional padding.... +MAP header|IP Packet|Optional padding|MAP header|Command Packet|Optional pad... + +3. Userspace configuration + +rmnet_data userspace configuration is done through netlink library librmnetctl +and command line utility rmnetcli. Utility is hosted in codeaurora forum git + +https://source.codeaurora.org/quic/la/platform/vendor/qcom-opensource/\ +dataservices/tree/rmnetctl
include/uapi/linux/Kbuild +2 -0
@@ -281,6 +281,7 @@ header-y += mroute6.h header-y += mroute.h header-y += msdos_fs.h header-y += msg.h +header-y += msm_rmnet.h header-y += mtio.h header-y += nbd.h header-y += ncp_fs.h
@@ -366,6 +367,7 @@ header-y += resource.h header-y += rfkill.h header-y += rio_cm_cdev.h header-y += rio_mport_cdev.h +header-y += rmnet_data.h header-y += romfs_fs.h header-y += rose.h header-y += route.h
include/uapi/linux/if_arp.h +1 -0
@@ -59,6 +59,7 @@#define ARPHRD_LAPB 516/* LAPB */ #define ARPHRD_DDCMP 517/* Digital's DDCMP protocol */ #define ARPHRD_RAWHDLC 518/* Raw HDLC */ +#define ARPHRD_RAWIP 530/* Raw IP */ #define ARPHRD_TUNNEL 768/* IPIP tunnel */ #define ARPHRD_TUNNEL6 769/* IP6IP6 tunnel */
include/uapi/linux/if_ether.h +2 -1
@@ -103,7 +103,8 @@#define ETH_P_QINQ3 0x9300/* deprecated QinQ VLAN [ NOT AN OFFICIALLY REGISTERED ID ] */ #define ETH_P_EDSA 0xDADA/* Ethertype DSA [ NOT AN OFFICIALLY REGISTERED ID ] */ #define ETH_P_AF_IUCV 0xFBFB/* IBM af_iucv [ NOT AN OFFICIALLY REGISTERED ID ] */ - +#define ETH_P_MAP 0xDA1A/* Multiplexing and Aggregation Protocol +* NOT AN OFFICIALLY REGISTERED ID ] */ #define ETH_P_802_3_MIN 0x0600/* If the value in the ethernet type is less than this value * then the frame is Ethernet II. Else it is 802.3 */
include/uapi/linux/rmnet_data.h new file +416 -0
416 lines not on this page · raw message
net/Kconfig +1 -0
@@ -238,6 +238,7 @@ source "net/switchdev/Kconfig" source "net/l3mdev/Kconfig" source "net/qrtr/Kconfig" source "net/ncsi/Kconfig" +source "net/rmnet_data/Kconfig" config RPS bool
net/Makefile +1 -0
@@ -81,3 +81,4 @@ obj-y += l3mdev/ endif obj-$(CONFIG_QRTR) += qrtr/ obj-$(CONFIG_NET_NCSI) += ncsi/ +obj-$(CONFIG_RMNET_DATA) += rmnet_data/
net/rmnet_data/Kconfig new file +21 -0
@@ -0,0 +1,21 @@ +# +# RMNET Data and MAP driver +# + +menuconfig RMNET_DATA + depends on NETDEVICES + bool "RmNet Data and MAP driver" + ---help--- + If you say Y here, then the rmnet_data module will be statically + compiled into the kernel. The rmnet data module provides MAP + functionality for embedded and bridged traffic. +if RMNET_DATA + +config RMNET_DATA_DEBUG + bool "RmNet Data Debug Logging" + ---help--- + Say Y here if you want RmNet data to be able to log packets in main + system log. This should not be enabled on production builds as it can + impact system performance. Note that simply enabling it here will not + enable the logging; it must be enabled at run-time as well. +endif # RMNET_DATA
net/rmnet_data/Makefile new file +14 -0
@@ -0,0 +1,14 @@ +# +# Makefile for the RMNET Data module +# + +rmnet_data-y := rmnet_data_main.o +rmnet_data-y += rmnet_data_config.o +rmnet_data-y += rmnet_data_vnd.o +rmnet_data-y += rmnet_data_handlers.o +rmnet_data-y += rmnet_map_data.o +rmnet_data-y += rmnet_map_command.o +rmnet_data-y += rmnet_data_stats.o +obj-$(CONFIG_RMNET_DATA) += rmnet_data.o + +CFLAGS_rmnet_data_main.o := -I$(src)
net/rmnet_data/rmnet_data_config.c new file +1149 -0
1,149 lines not on this page · raw message
net/rmnet_data/rmnet_data_config.h new file +123 -0
123 lines not on this page · raw message
net/rmnet_data/rmnet_data_handlers.c new file +560 -0
560 lines not on this page · raw message
net/rmnet_data/rmnet_data_handlers.h new file +24 -0
@@ -0,0 +1,24 @@ +/* Copyright (c) 2013, 2016-2017 The Linux Foundation. All rights reserved. +* +* This program is free software; you can redistribute it and/or modify +* it under the terms of the GNU General Public License version 2 and +* only version 2 as published by the Free Software Foundation. +* +* This program is distributed in the hope that it will be useful, +* but WITHOUT ANY WARRANTY; without even the implied warranty of +* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +* GNU General Public License for more details. +* +* RMNET Data ingress/egress handler +* +*/ + +#ifndef _RMNET_DATA_HANDLERS_H_ +#define _RMNET_DATA_HANDLERS_H_ + +void rmnet_egress_handler (struct sk_buff *skb, +struct rmnet_logical_ep_conf_s *ep); + +rx_handler_result_t rmnet_rx_handler (struct sk_buff **pskb); + +#endif /* _RMNET_DATA_HANDLERS_H_ */
net/rmnet_data/rmnet_data_main.c new file +60 -0
60 lines not on this page · raw message
net/rmnet_data/rmnet_data_private.h new file +76 -0
76 lines not on this page · raw message
net/rmnet_data/rmnet_data_stats.c new file +86 -0
86 lines not on this page · raw message
net/rmnet_data/rmnet_data_stats.h new file +61 -0
61 lines not on this page · raw message
net/rmnet_data/rmnet_data_trace.h new file +183 -0
183 lines not on this page · raw message
net/rmnet_data/rmnet_data_vnd.c new file +602 -0
104 lines not on this page · raw message
net/rmnet_data/rmnet_data_vnd.h new file +40 -0
Lines of this file are not shown. View the raw message.
net/rmnet_data/rmnet_map.h new file +148 -0
148 lines not on this page · raw message
net/rmnet_data/rmnet_map_command.c new file +180 -0
180 lines not on this page · raw message
net/rmnet_data/rmnet_map_data.c new file +154 -0
154 lines not on this page · raw message
The rest of this diff is not shown. View the raw message.
Signature · 1 line
1.9.1
Part of the diff is not shown here. View the raw message.