On Time RTOS-32 Documentation

RTIP-32 Programming Manual

RTIP-32 Reference Manual

RTIP-32 Configuration

Simplified Networking API

Extended RTIP-32 API

Function vf_init

Function xn_add_dns_server

Function xn_add_host_table_entry

Function xn_clear_host_cache

Function xn_delete_host_table_entry

Function xn_get_domain_name

Function xn_has_dns

Function xn_set_domain_name

Function xn_set_server_list

Function xn_name2ip_addr

Function xn_abort

Function xn_arp_send

Function xn_attach

Function xn_bootp_res

Function xn_bootp

Function xn_debug_error

Function xn_getlasterror

Function xn_geterror_string

Function xn_interface_close

Function xn_interface_info

Function xn_interface_mcast

Function xn_interface_open

Function xn_interface_open_config

Function xn_interface_opt

Function xn_interface_ethernet_statistics

Function xn_interface_statistics

Function xn_ip_set_option

Function xn_ping

Function xn_pkt_data_max

Function xn_rarp

Function xn_rt_add

Function xn_rt_cycle_gw

Function xn_rt_del

Function xn_rt_replace

Function xn_rtip_exit

Function xn_rtip_init

Function xn_rtip_restart

Function xn_set_ip

Function xn_tcp_is_connect

Function xn_tcp_is_read

Function xn_tcp_is_write

Function xn_wait_tcp_output

Function xn_autoanswer

Function xn_autologin

Function xn_hangup

Function xn_scriptlogin

Function xn_autoip

Function xn_ioacc_init

Function xn_nat_init

Function xn_arp_add

Function xn_arp_del

Function xn_arp_remote

Function xn_arp_cache_lookup

Function xn_send_ethernet_frame

Function xn_callbacks

Function cb_wr_screen_string_fnc

Function cb_rs232_connection_lost_fnc

Function cb_error_report_fnc

Function cb_raw_mode_in_char_fnc

Function cb_autoip_new_ip_fnc

Function cb_autoip_no_ip_fnc

Function cb_packetin_isr

Function cb_packetin_task

Function cb_packetout

Previous

Next

Function xn_interface_open

Open an Ethernet or loopback interface.

int xn_interface_open(int device_id, int minor_number);

Parameters

device_id

Device type (NE2000_DEVICE, SMC91C9X_DEVICE, LOOP_DEVICE, etc.).

minor_number

Minor device number to distinguish multiple devices handled by the same driver.

return value

Returns interface number if interface was opened successfully, 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:

Value	Meaning
EBADDEVICE	Invalid device type (RTIP-32 specific).
EIFACEFULL	Interface table full (RTIP-32 specific).
EIFACEOPENFAIL	Interface open failed (RTIP-32 specific).
EINVAL	The parameter iface_no is not valid.
ENOTINITIALIZED	RTIP-32 has not been initialized (xn_rtip_init has not been called).
ENUMDEVICE	Not enough devices (RTIP-32 specific).
EPROBEFAIL	Ethernet board type could not be determined (RTIP-32 specific).

This routine must be called at start-up to open an Ethernet or loopback interface. The 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. Refer to section Device Drivers for information about setting up default devices for Ethernet drivers. See xn_interface_open_config to open an interface with a different configuration than what is specified in the device table.

xn_interface_open allocates and sets up an interface structure and calls the open routine for the specified interface.

Left Extended RTIP-32 API

Function xn_interface_mcast

Down Function xn_interface_open_config