Network Component  Version 7.10.0
MDK Middleware for IPv4 and IPv6 Networking
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages

Functions of the SLIP interface. More...

Functions

netStatus netSLIP_Listen (void)
 Start SLIP interface to accept incoming SLIP connections. [thread-safe]. More...
 
netStatus netSLIP_Connect (const char *dial_num)
 Start a dial-up connection to remote SLIP server. [thread-safe]. More...
 
netStatus netSLIP_Close (void)
 Disconnect SLIP link between two modems. [thread-safe]. More...
 
bool netSLIP_LinkUp (void)
 Determine the state of SLIP link. [thread-safe]. More...
 

Description

Functions of the SLIP interface.

To start a dial-up connection to a remote SLIP server, use netSLIP_Connect (client mode). If you want to wait for an incoming connection, use netSLIP_Listen instead (server mode). To check the link status, use netSLIP_LinkUp. This can be done in client and server mode and can be used to continuously monitor the SLIP link. To disconnect the SLIP link, use netSLIP_Close (for client and server mode). Usually, this is done by the client. Note that the netSLIP_Close function does not change the running mode of the SLIP daemon. If the SLIP daemon was in server mode, SLIP daemon re-initializes the modem driver to accept further incoming calls.

Function Documentation

netStatus netSLIP_Close ( void  )

Disconnect SLIP link between two modems. [thread-safe].

Returns
status code that indicates the execution status of the function.

The function netSLIP_Close disconnects the SLIP link between the two modems.

Possible netStatus return values:

  • netOK: Disconnection started.
Note
  • You can call the netSLIP_Close function when the SLIP network daemon is either in client mode or in server mode.
  • Since the SLIP client starts a dial-up connection, it is also the SLIP client that usually disconnects the SLIP link.
  • The netSLIP_Close function does not change the running mode of the SLIP daemon. If the SLIP daemon was in server mode, SLIP daemon re-initializes the modem driver to accept further incoming calls.

Code Example

void disconnect_link (void) {
// Disconnect a dial-up link.
}
netStatus netSLIP_Connect ( const char *  dial_num)

Start a dial-up connection to remote SLIP server. [thread-safe].

Parameters
[in]dial_numphone number of remote SLIP server.
Returns
status code that indicates the execution status of the function.

The function netSLIP_Connect starts a dial-up connection to the remote SLIP server by starting the SLIP daemon in client mode.

The argument dial_num points to a null-terminated string containing the phone number of the remote SLIP server.

Possible netStatus return values:

  • netOK: Dial-up connection started.
  • netInvalidParameter: Invalid dial_num parameter provided.
  • netWrongState: Dial-up connection already established.
Note
  • You must call the netSLIP_Connect function when you want to establish a dial-up connection using SLIP.
  • When using a direct cable connection, you can set dial_num to NULL because the Null_Modem device driver ignores dial_num.

Code Example

void dial_remote (void) {
// Dial remote SLIP Server.
netSLIP_Connect ("04213372");
}
bool netSLIP_LinkUp ( void  )

Determine the state of SLIP link. [thread-safe].

Returns
link state:
  • true = Link is up, IP frames can be exchanged.
  • false = Link is down.

The function netSLIP_LinkUp determines the state of SLIP link between the two modems. It returns true if IP frames can be exchanged over the SLIP link.

Note
  • You can call the netSLIP_LinkUp function when the SLIP network daemon is either in client mode or in server mode.
  • You can also use the netSLIP_LinkUp function to continuously monitor the state of the SLIP link.

Code Example

void connect_soc (void) {
// Connect TCP socket when SLIP is up.
netTCP_Connect (socket_tcp, remip, 1000, 0);
}
}
netStatus netSLIP_Listen ( void  )

Start SLIP interface to accept incoming SLIP connections. [thread-safe].

Returns
status code that indicates the execution status of the function.

The function netSLIP_Listen configures the SLIP interface to accept incoming SLIP connections by starting the SLIP daemon in server mode.

Note
It is common to call netSLIP_Listen at system start-up.

Possible netStatus return values:

  • netOK: Listening to inbound dial-up connections started.
  • netWrongState: Dial-up connection already established.

Code Example

int main (void) {
// Activate the SLIP interface.
..
}