RTKernel-32

RTFiles-32

RTIP-32

RTIP-32 Programming Manual

RTIP-32 Reference Manual

RTIP-32 Configuration

Socket API

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

Function cb_packetin_isr

This callback is called by the Ethernet driver's hardware interrupt handler when a data packet has been received:

int cb_packetin_isr(int interface, byte * data, int length, int buffer_size);

Parameters

interface

Interface number (as returned by xn_interface_open or xn_interface_open_config) on which the new packet came in.

data

Pointer to the packet's data.

length

Number of bytes pointed to by parameter data.

buffer_size

Number of bytes the buffer pointed to by data can hold. buffer_size will always be >= length.

return value

Number of bytes RTIP-32 should process at *data. If 0 is returned, RTIP-32 will discard this packet.

This callback can be used to intercept incoming packets at a very early stage and in real time. The callback function may modify the data pointed to by parameter data, if desired. It must return the number of bytes RTIP-32 should process. If the packet data is not modified and RTIP-32 should continue normal processing, return parameter length. To discard the data, return 0.

Since this callback is called from a hardware interrupt handler, it should be short and consume very little stack space. It may not call any functions which may cause a blocking task switch (e.g., malloc, etc). To intercept less time critical packets, use cb_packetin_task instead.

Please see cb_packetin_task for a complete example.

Left Extended RTIP-32 API

Function cb_autoip_no_ip_fnc

Down Function cb_packetin_task