Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 2d283bdd authored by Gavin Shan's avatar Gavin Shan Committed by David S. Miller
Browse files

net/ncsi: Resource management 

NCSI spec (DSP0222) defines several objects: package, channel, mode,
filter, version and statistics etc. This introduces the data structs
to represent those objects and implement functions to manage them.
Also, this introduces CONFIG_NET_NCSI for the newly implemented NCSI
stack.

   * The user (e.g. netdev driver) dereference NCSI device by
     "struct ncsi_dev", which is embedded to "struct ncsi_dev_priv".
     The later one is used by NCSI stack internally.
   * Every NCSI device can have multiple packages simultaneously, up
     to 8 packages. It's represented by "struct ncsi_package" and
     identified by 3-bits ID.
   * Every NCSI package can have multiple channels, up to 32. It's
     represented by "struct ncsi_channel" and identified by 5-bits ID.
   * Every NCSI channel has version, statistics, various modes and
     filters. They are represented by "struct ncsi_channel_version",
     "struct ncsi_channel_stats", "struct ncsi_channel_mode" and
     "struct ncsi_channel_filter" separately.
   * Apart from AEN (Asynchronous Event Notification), the NCSI stack
     works in terms of command and response. This introduces "struct
     ncsi_req" to represent a complete NCSI transaction made of NCSI
     request and response.

link: https://www.dmtf.org/sites/default/files/standards/documents/DSP0222_1.1.0.pdf


Signed-off-by: default avatarGavin Shan <gwshan@linux.vnet.ibm.com>
Acked-by: default avatarJoel Stanley <joel@jms.id.au>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent 5e31c701

include/net/ncsi.h

0 → 100644
+46 −0
Original line number Original line Diff line number Diff line 
#ifndef __NET_NCSI_H

#define __NET_NCSI_H



/*

 * The NCSI device states seen from external. More NCSI device states are

 * only visible internally (in net/ncsi/internal.h). When the NCSI device

 * is registered, it's in ncsi_dev_state_registered state. The state

 * ncsi_dev_state_start is used to drive to choose active package and

 * channel. After that, its state is changed to ncsi_dev_state_functional.

 *

 * The state ncsi_dev_state_stop helps to shut down the currently active

 * package and channel while ncsi_dev_state_config helps to reconfigure

 * them.

 */

enum {

	ncsi_dev_state_registered	= 0x0000,

	ncsi_dev_state_functional	= 0x0100,

	ncsi_dev_state_probe		= 0x0200,

	ncsi_dev_state_config		= 0x0300,

	ncsi_dev_state_suspend		= 0x0400,

};



struct ncsi_dev {

	int               state;

	int		  link_up;

	struct net_device *dev;

	void		  (*handler)(struct ncsi_dev *ndev);

};



#ifdef CONFIG_NET_NCSI

struct ncsi_dev *ncsi_register_dev(struct net_device *dev,

				   void (*notifier)(struct ncsi_dev *nd));

void ncsi_unregister_dev(struct ncsi_dev *nd);

#else /* !CONFIG_NET_NCSI */

static inline struct ncsi_dev *ncsi_register_dev(struct net_device *dev,

					void (*notifier)(struct ncsi_dev *nd))

{

	return NULL;

}



static inline void ncsi_unregister_dev(struct ncsi_dev *nd)

{

}

#endif /* CONFIG_NET_NCSI */



#endif /* __NET_NCSI_H */

net/Kconfig

+1 −0
Original line number Original line Diff line number Diff line
@@ -237,6 +237,7 @@ source "net/hsr/Kconfig" 
source "net/switchdev/Kconfig"

source "net/switchdev/Kconfig"

source "net/l3mdev/Kconfig"

source "net/l3mdev/Kconfig"

source "net/qrtr/Kconfig"

source "net/qrtr/Kconfig"

source "net/ncsi/Kconfig"





config RPS

config RPS

	bool

	bool

net/Makefile

+1 −0
Original line number Original line Diff line number Diff line
@@ -79,3 +79,4 @@ ifneq ($(CONFIG_NET_L3_MASTER_DEV),) 
obj-y				+= l3mdev/

obj-y				+= l3mdev/

endif

endif

obj-$(CONFIG_QRTR)		+= qrtr/

obj-$(CONFIG_QRTR)		+= qrtr/

obj-$(CONFIG_NET_NCSI)		+= ncsi/

net/ncsi/Kconfig

0 → 100644
+12 −0
Original line number Original line Diff line number Diff line 
#

# Configuration for NCSI support

#



config NET_NCSI

	bool "NCSI interface support"

	depends on INET

	---help---

	  This module provides NCSI (Network Controller Sideband Interface)

	  support. Enable this only if your system connects to a network

	  device via NCSI and the ethernet driver you're using supports

	  the protocol explicitly.

net/ncsi/Makefile

0 → 100644
+4 −0
Original line number Original line Diff line number Diff line 
#

# Makefile for NCSI API

#

obj-$(CONFIG_NET_NCSI) += ncsi-manage.o