/***************************************************************************/ /* Copyright (c) 2024 Microsoft Corporation */ /* Copyright (c) 2026 Eclipse ThreadX contributors */ /* */ /* This program and the accompanying materials are made available under */ /* the terms of the MIT License which is available at */ /* https://opensource.org/licenses/MIT. */ /* */ /* SPDX-License-Identifier: MIT */ /***************************************************************************/ /* This NetX test concentrates on basic IP fragmentation. */ #include "tx_api.h" #include "nx_api.h" #include "nx_tcp.h" #include "nx_ram_network_driver_test_1500.h" extern void test_control_return(UINT status); #if !defined(NX_DISABLE_FRAGMENTATION) && !defined(NX_DISABLE_IPV4) #define DEMO_STACK_SIZE 2048 /* Define the ThreadX and NetX object control blocks... */ static TX_THREAD thread_0; static TX_THREAD thread_1; static NX_PACKET_POOL pool_0; static NX_IP ip_0; static NX_IP ip_1; static NX_UDP_SOCKET socket_0; static NX_UDP_SOCKET socket_1; /* Define the counters used in the demo application... */ static ULONG thread_0_counter; static ULONG thread_1_counter; static ULONG packet_counter; static ULONG error_counter; static ULONG notify_calls; static CHAR msg[1500]={'A','B','C','D','E','F','G','H','I','J','K','L','M','N','O','P','Q','R','S','T','U','V','W','X','Y','Z'}; /* Define thread prototypes. */ static void thread_0_entry(ULONG thread_input); static void thread_1_entry(ULONG thread_input); extern void _nx_ram_network_driver_1500(struct NX_IP_DRIVER_STRUCT *driver_req); extern void _nx_ram_network_driver(struct NX_IP_DRIVER_STRUCT *driver_req); static void receive_packet_function(NX_UDP_SOCKET *socket_ptr); extern UINT (*advanced_packet_process_callback)(NX_IP *ip_ptr, NX_PACKET *packet_ptr, UINT *operation_ptr, UINT *delay_ptr); static UINT my_packet_process(NX_IP *ip_ptr, NX_PACKET *packet_ptr, UINT *operation_ptr, UINT *delay_ptr); /* Define what the initial system looks like. */ #ifdef CTEST VOID test_application_define(void *first_unused_memory) #else void netx_ip_fragmentation_order_test_application_define(void *first_unused_memory) #endif { CHAR *pointer; UINT status; /* Setup the working pointer. */ pointer = (CHAR *) first_unused_memory; thread_0_counter = 0; thread_1_counter = 0; error_counter = 0; notify_calls = 0; packet_counter=0; /* Create the main thread. */ tx_thread_create(&thread_0, "thread 0", thread_0_entry, 0, pointer, DEMO_STACK_SIZE, 4, 4, TX_NO_TIME_SLICE, TX_AUTO_START); pointer = pointer + DEMO_STACK_SIZE; /* . */ tx_thread_create(&thread_1, "thread 1", thread_1_entry, 0, pointer, DEMO_STACK_SIZE, 3, 3, TX_NO_TIME_SLICE, TX_AUTO_START); pointer = pointer + DEMO_STACK_SIZE; /* Initialize the NetX system. */ nx_system_initialize(); /* Create a packet pool. */ status = nx_packet_pool_create(&pool_0, "NetX Main Packet Pool", 512, pointer, 1536*16); pointer = pointer + 1500*16; /* Check for pool creation error. */ if (status) error_counter++; /* Create an IP instance. */ status = nx_ip_create(&ip_0, "NetX IP Instance 0", IP_ADDRESS(1, 2, 3, 4), 0xFFFFF000UL, &pool_0, _nx_ram_network_driver_1500, pointer, 2048, 1); pointer = pointer + 2048; /* Create another IP instance. */ status += nx_ip_create(&ip_1, "NetX IP Instance 1", IP_ADDRESS(1, 2, 3, 5), 0xFFFFF000UL, &pool_0, _nx_ram_network_driver_1500, pointer, 2048, 1); pointer = pointer + 2048; /* Check for IP create errors. */ if (status) error_counter++; /* Enable ARP and supply ARP cache memory for IP Instance 0. */ status = nx_arp_enable(&ip_0, (void *) pointer, 1024); pointer = pointer + 1024; /* Enable ARP and supply ARP cache memory for IP Instance 1. */ status += nx_arp_enable(&ip_1, (void *) pointer, 1024); pointer = pointer + 1024; /* Check for ARP enable errors. */ if (status) error_counter++; /* Enable UDP traffic. */ status = nx_udp_enable(&ip_0); status += nx_udp_enable(&ip_1); /* Check for UDP enable errors. */ if (status) error_counter++; /* Enable IP fragmentation logic on both IP instances. */ status = nx_ip_fragment_enable(&ip_0); status += nx_ip_fragment_enable(&ip_1); /* Check for IP fragment enable errors. */ if (status) error_counter++; } /* Define the test threads. */ static void thread_0_entry(ULONG thread_input) { UINT status; NX_PACKET *my_packet; UINT free_port; ULONG udp_packets_sent, udp_bytes_sent, udp_packets_received, udp_bytes_received, udp_invalid_packets, udp_receive_packets_dropped, udp_checksum_errors; ULONG packets_sent, bytes_sent, packets_received, bytes_received, packets_queued, receive_packets_dropped, checksum_errors; /* Create a UDP socket. */ status = nx_udp_socket_create(&ip_0, &socket_0, "Socket 0", NX_IP_NORMAL, NX_FRAGMENT_OKAY, 0x80, 5); /* Check status. */ if (status) { printf("ERROR!\n"); test_control_return(1); } /* Pickup the first free port for 0x88. */ status = nx_udp_free_port_find(&ip_0, 0x88, &free_port); /* Check status. */ if ((status) || (free_port != 0x88)) { printf("ERROR!\n"); test_control_return(1); } /* Bind the UDP socket to the IP port. */ status = nx_udp_socket_bind(&socket_0, 0x88, TX_WAIT_FOREVER); /* Check status. */ if (status) error_counter++; /* Get the port that is actually bound to this socket. */ status = nx_udp_socket_port_get(&socket_0, &free_port); /* Check status. */ if ((status) || (free_port != 0x88)) { printf("ERROR!\n"); test_control_return(31); } /* Disable checksum logic for this socket. */ status = nx_udp_socket_checksum_disable(&socket_0); /* Check status. */ if (status) { printf("ERROR!\n"); test_control_return(1); } /* Setup the ARP entry for the UDP send. */ nx_arp_dynamic_entry_set(&ip_0, IP_ADDRESS(1, 2, 3, 5), 0, 0); advanced_packet_process_callback = my_packet_process; /* Allocate a packet. */ status = nx_packet_allocate(&pool_0, &my_packet, NX_UDP_PACKET, TX_WAIT_FOREVER); /* Check status. */ if (status != NX_SUCCESS) error_counter++; /* Write ABCs into the packet payload! */ status = nx_packet_data_append(my_packet, msg, 1500, &pool_0, NX_IP_PERIODIC_RATE); /* Check for error. */ if(status) error_counter++; /* Send the UDP packet. */ status = nx_udp_socket_send(&socket_0, my_packet, IP_ADDRESS(1, 2, 3, 5), 0x89); /* Check status. */ if (status) { printf("ERROR!\n"); test_control_return(1); } tx_thread_sleep(NX_IP_PERIODIC_RATE/2); /* Now, enable the checksum. */ status = nx_udp_socket_checksum_enable(&socket_0); /* Check status. */ if (status) { printf("ERROR!\n"); test_control_return(1); } /* Send another packet with checksum enabled. */ /* Allocate a packet. */ status = nx_packet_allocate(&pool_0, &my_packet, NX_UDP_PACKET, TX_WAIT_FOREVER); /* Check status. */ if (status != NX_SUCCESS) error_counter++; /* Write ABCs into the packet payload! */ status = nx_packet_data_append(my_packet, msg, 1500, &pool_0, NX_IP_PERIODIC_RATE); /* Check for error. */ if(status) error_counter++; /* Send the UDP packet. */ status = nx_udp_socket_send(&socket_0, my_packet, IP_ADDRESS(1, 2, 3, 5), 0x89); /* Check status. */ if (status) { printf("ERROR!\n"); test_control_return(1); } tx_thread_sleep(NX_IP_PERIODIC_RATE/2); /* Get UDP socket information. */ status = nx_udp_socket_info_get(&socket_0, &packets_sent, &bytes_sent, &packets_received, &bytes_received, &packets_queued, &receive_packets_dropped, &checksum_errors); #ifndef NX_DISABLE_IP_INFO if((packets_sent != 2) || (bytes_sent != 2*1500)) error_counter++; #endif /* Check status. */ if ((error_counter) || (status) || (packets_received) || (bytes_received) || (packets_queued) || (receive_packets_dropped) || (checksum_errors)) { printf("ERROR!\n"); test_control_return(1); } /* Unbind the UDP socket. */ status = nx_udp_socket_unbind(&socket_0); /* Check status. */ if (status) { printf("ERROR!\n"); test_control_return(1); } /* Delete the UDP socket. */ status = nx_udp_socket_delete(&socket_0); /* Check status. */ if (status) { printf("ERROR!\n"); test_control_return(1); } /* Get UDP information. */ status = nx_udp_info_get(&ip_0, &udp_packets_sent, &udp_bytes_sent, &udp_packets_received, &udp_bytes_received, &udp_invalid_packets, &udp_receive_packets_dropped, &udp_checksum_errors); #ifndef NX_DISABLE_IP_INFO if((udp_packets_sent != 2) || (udp_bytes_sent != 2*1500)) error_counter++; #endif /* Check status. */ if ((error_counter) || (status) || (udp_packets_received) || (udp_bytes_received) || (udp_invalid_packets) || (udp_receive_packets_dropped) || (udp_checksum_errors) || (notify_calls != 2)) { printf("ERROR!\n"); test_control_return(1); } else { printf("SUCCESS!\n"); test_control_return(0); } } static void thread_1_entry(ULONG thread_input) { UINT status; NX_PACKET *my_packet; /* Print out some test information banners. */ printf("NetX Test: IP Fragmentation Out Of Order Processing Test............."); /* Create a UDP socket. */ status = nx_udp_socket_create(&ip_1, &socket_1, "Socket 1", NX_IP_NORMAL, NX_FRAGMENT_OKAY, 0x80, 5); /* Check status. */ if (status) error_counter++; /* Register the receive notify function. */ status = nx_udp_socket_receive_notify(&socket_1, receive_packet_function); /* Check status. */ if (status) error_counter++; /* Bind the UDP socket to the IP port. */ status = nx_udp_socket_bind(&socket_1, 0x89, 2 * NX_IP_PERIODIC_RATE); /* Check status. */ if (status) error_counter++; /* Receive a UDP packet. */ status = nx_udp_socket_receive(&socket_1, &my_packet, 5 * NX_IP_PERIODIC_RATE); if(status == NX_SUCCESS) { /* Check data length */ if(my_packet -> nx_packet_length != 1500) error_counter++; /* Check received data. */ if(memcmp(my_packet -> nx_packet_prepend_ptr, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", 26)) error_counter++; /* Release the packet. */ nx_packet_release(my_packet); } /* Get another packet. */ /* Receive a UDP packet. */ status = nx_udp_socket_receive(&socket_1, &my_packet, 5 * NX_IP_PERIODIC_RATE); if(status == NX_SUCCESS) { /* Check data length */ if(my_packet -> nx_packet_length != 1500) error_counter++; /* Check received data. */ if(memcmp(my_packet -> nx_packet_prepend_ptr, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", 26)) error_counter++; /* Release the packet. */ nx_packet_release(my_packet); } /* Unbind the UDP socket. */ status = nx_udp_socket_unbind(&socket_1); /* Check status. */ if (status) error_counter++; /* Delete the UDP socket. */ status = nx_udp_socket_delete(&socket_1); /* Check status. */ if (status) error_counter++; } static void receive_packet_function(NX_UDP_SOCKET *socket_ptr) { if (socket_ptr == &socket_1) notify_calls++; } static UINT my_packet_process(NX_IP *ip_ptr, NX_PACKET *packet_ptr, UINT *operation_ptr, UINT *delay_ptr) { /* Check data length and payload */ if (!memcmp(packet_ptr -> nx_packet_prepend_ptr + 28, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", 26)) { /* Delay some seconds. */ *operation_ptr = NX_RAMDRIVER_OP_DELAY; *delay_ptr = NX_IP_PERIODIC_RATE / 5; packet_counter++; } if(packet_counter == 2) advanced_packet_process_callback = NX_NULL; return NX_TRUE; } #else #ifdef CTEST VOID test_application_define(void *first_unused_memory) #else void netx_ip_fragmentation_order_test_application_define(void *first_unused_memory) #endif { printf("NetX Test: IP Fragmentation Out Of Order Processing Test.............N/A\n"); test_control_return(3); } #endif /* NX_DISABLE_FRAGMENTATION */