Previous

Next

Function xn_attach

Open an interface for a serial interface.

int xn_attach(int    device_id, 
              int    minor_number, 
              BYTE * his_ip_addr, 
              int    com_port, 
              int    baud_rate, 
              char   handshake_type, 
              BYTE * input_buffer, 
              int    input_buffer_len, 
              BYTE * output_buffer, 
              int    output_buffer_len);

Parameters

device_id

Device type (PPP_DEVICE, SLIP_DEVICE or CSLIP_DEVICE).

minor number

See xn_interface_open.

his_ip_address

Pointer to remote IP address (4 bytes in network byte order) to connect to.

com_port

COM port (1-4 or -1 = use value from device table).

baud_rate

Baud rate. Supported values:

handshake_type

Type of hardware handshake performed. Supported values are:

input_buffer

Buffer used to queue input characters which will be processed at task level. If none is specified, a DCU will be allocated by the UART driver. The size of the buffer required is 2*x+2 where x is the largest packet received. Without a buffer, the largest input packet would be 758 bytes.

input_buffer_len

Size of input buffer.

output_buffer

Buffer used to queue output chars which will be sent from the interrupt level. If none specified, a DCU will be allocated by the UART driver.

output_buffer_len

Size of output buffer.

return value

Returns interface number if successful, otherwise SOCKET_ERROR. If an error occurred, call xn_getlasterror and xn_geterror_string to return the error value. Error Codes further describes each error.

Possible values for this function are:

This routine must be called at start-up to open a dedicated interface, i.e. SLIP, CSLIP (SLIP with VanJacobson compression) or PPP. Parameter device_id specifies the type of device which is being opened and the minor_number specifies which device of this type is being opened. The device number and minor number specified must match an entry in the device table. It sets up the interface structure and calls the open routine for the specified interface.

If the remote IP address is unknown, set his_ip_addr to 0.0.0.0. For PPP, if the remote IP address is negotiated, then the negotiated remote address will be used. When xn_set_ip is called, if the remote address has not been set, a host entry will be added to the routing table using the mask and local IP address set by xn_set_ip; otherwise, a network entry will be added using the remote IP address and the mask 255.255.255.255 (see xn_rt_add).

Extended RTIP-32 API

Function xn_arp_send

Function xn_bootp_res