µC/TCP-IP maintains counters and statistics for a variety of expected or unexpected error conditions. Some of these statistics are optional since they require additional code and memory when enabled, see Network Counters Configuration for further information about how to enable and disabled it.
Statistics
µC/TCP-IP maintains run-time statistics on interfaces and most µC/TCP-IP object pools. If desired, an application can thus query µC/TCP-IP to find out how many frames have been processed on a particular interface, transmit and receive performance metrics, buffer utilization and more. An application can also reset the statistic pools back to their initialization values via appropriate API .
Applications may choose to monitor statistics for various reasons. For example, examining buffer statistics allows you to better manage the memory usage. Typically, more buffers can be allocated than necessary and, by examining buffer usage statistics, adjustments can be made to reduce their number.
...
The data structure is shown below:
NET_STAT_POOL_QTY
is a data type currently set to CPU_INT16U
and thus contains a maximum count of 65535.
Access to buffer statistics is obtained via interface functions that the application can call (described in the next sections). Most likely, only the following variables in NET_STAT_POOL
need to be examined, because the .Type
member is configured at initialization time as NET_STAT_TYPE_POOL
:
...
Module | Description | Function API or Variables |
---|---|---|
ARP | ARP Cache usage | NetARP_CachePoolStatGet |
IGMP | IPv4 Multicast group statistics | NetIGMP_HostGrpPoolStat |
NDP | NDP Caches usage |
|
Buffer | Interface's buffer usage |
|
IP connections | IP connections pool usage | NetConn_PoolStatGet |
Socket | Sockets usage | NetSock_PoolStatGet |
TCP | TCP connections usage | NetTCP_ConnPoolStatGet |
Timer | Timer usage | NetTmr_PoolStatGet() |
Error Counters
µC/TCP-IP maintains run-time counters for tracking error conditions within the Network Protocol Stack. If desired, the application may view the error counters in order to debug run-time problems such as low memory conditions, slow performance, packet loss, etc.
Network protocol error counters are kept in an instance of a data structure named Net_ErrCtrs
. This variable may be viewed within a debugger or referenced externally by the application for run-time analysis (see net_ctr.h
).
...