User`s guide

KwikNet Low Level Services

DAK

155

kn_ifadd kn_ifadd

Purpose Add a Network Interface

Used by

n Task o ISP o Timer Procedure o Restart Procedure o Exit Procedure

Setup Prototype is in file KN_API.H.

#include "KN_LIB.H"

KN_NETDP kn_ifadd(KN_FNP_NETPREP netprepp,

const struct knx_dvcdef *ddefp);

Description netprepp is a pointer to a network preparation function which will be

used by

KwikNet to prepare a network interface for use. Set parameter

netprepp to one of the following values to identify the type of network

interface that you wish to add.

KN_ND_ETHERNET Ethernet network interface (Ethernet-II framing)

KN_ND_ET8023 Ethernet network interface (802.3 framing and

possibly Ethernet-II framing)

KN_ND_SLIP SLIP network interface

KN_ND_PPPC PPP Client network interface

KN_ND_PPPS PPP Server network interface

ddefp is a pointer to a device definition structure which identifies the

device driver to be attached to the network interface. This structure is

described in Chapter 2.2 of the KwikNet Device Driver Technical

Reference Manual. This structure defines the network tag and the

device driver initialization parameters.

Returns If the network interface is successfully added, a network descriptor pointer

is returned.

If the network interface cannot be added for any reason, a

NULL network

descriptor pointer is returned.

Note Your network event function (see kn_netevent()) will be called with an

indication that this new network interface has been added.