📄 net.h
字号:
/*
*********************************************************************************************************
* uC/TCP-IP
* The Embedded TCP/IP Suite
*
* (c) Copyright 2003-2006; Micrium, Inc.; Weston, FL
*
* All rights reserved. Protected by international copyright laws.
*
* uC/TCP-IP is provided in source form for FREE evaluation, for educational
* use or peaceful research. If you plan on using uC/TCP-IP in a commercial
* product you need to contact Micrium to properly license its use in your
* product. We provide ALL the source code for your convenience and to help
* you experience uC/TCP-IP. The fact that the source code is provided does
* NOT mean that you can use it without paying a licensing fee.
*
* Knowledge of the source code may NOT be used to develop a similar product.
*
* Please help us continue to provide the Embedded community with the finest
* software available. Your honesty is greatly appreciated.
*********************************************************************************************************
*/
/*
*********************************************************************************************************
*
* NETWORK HEADER FILE
*
* Filename : net.h
* Version : V1.87
* Programmer(s) : ITJ
*********************************************************************************************************
* Note(s) : (1) (a) The following network protocols are supported/implemented :
*
* ---- LINK LAYER PROTOCOLS -----
* (1) (A) ARP Address Resolution Protocol
* --- NETWORK LAYER PROTOCOLS ---
* (2) (A) IP Internet Protocol
* (B) ICMP Internet Control Message Protocol
* -- TRANSPORT LAYER PROTOCOLS --
* (3) (A) UDP User Datagram Protocol
* (B) TCP Transmission Control Protocol
*
* (b) The following network protocols are intentionally NOT supported/implemented :
*
* ---- LINK LAYER PROTOCOLS -----
* (1) (A) RARP Reverse Address Resolution Protocol
* --- NETWORK LAYER PROTOCOLS ---
* (2) (A) IGMP Internet Group Management Protocol
*
*
* (2) To protect the validity & prevent the corruption of shared network protocol resources,
* the primary tasks of the network protocol suite are prevented from running concurrently
* through the use of a global network lock implementing protection by mutual exclusion.
*
* (a) The mechanism of protected mutual exclusion is irrelevant but MUST be implemented
* in the following two functions :
*
* NetOS_Lock() acquire access to network protocol suite
* NetOS_Unlock() release access to network protocol suite
*
* implemented in
*
* \<Network Protocol Suite>\OS\<os>\net_os.*
*
* where
* <Network Protocol Suite> directory path for network protocol suite
* <os> directory name for specific OS
*
* (b) Since this global lock implements mutual exclusion at the network protocol suite
* task level, critical sections are NOT required to prevent task-level concurrency
* in the network protocol suite.
*********************************************************************************************************
*/
/*$PAGE*/
/*
*********************************************************************************************************
* MODULE
*
* Note(s) : (1) This main network protocol suite header file is protected from multiple pre-processor
* inclusion through use of the network module present pre-processor macro definition.
*
* See also 'NETWORK INCLUDE FILES Note #5'.
*
* (2) (a) The network protocol suite software version is denoted as follows :
*
* Vx.yy
*
* where
* V denotes 'Version' label
* x denotes major software version revision number
* yy denotes minor software version revision number
*
* (b) The software version label #define is formatted as follows :
*
* ver = x.yy * 100
*
* where
* ver denotes software version number scaled as an integer value
* x.yy denotes software version number
*********************************************************************************************************
*/
#ifndef NET_MODULE_PRESENT /* See Note #1. */
#define NET_MODULE_PRESENT
#define NET_VERSION 187u /* See Note #2b. */
/*
*********************************************************************************************************
* EXTERNS
*********************************************************************************************************
*/
#ifdef NET_MODULE
#define NET_EXT
#else
#define NET_EXT extern
#endif
/*$PAGE*/
/*
*********************************************************************************************************
* NETWORK INCLUDE FILES
*
* Note(s) : (1) The network protocol suite files are located in the following directories :
*
* (a) \<Your Product Application>\net_cfg.h
* \net_bsp.*
* \net_isr*.*
* \app_cfg.h
*
* (b) \<Network Protocol Suite>\Source\net.h
* \net_*.*
*
* (c) \<Network Protocol Suite>\Ports\<cpu>\<compiler>\net_*_a.*
*
* (d) \<Network Protocol Suite>\OS\<os>\net_os.*
*
* (e) (1) \<Network Protocol Suite>\IF\net_if_*.*
*
* (2) \<Network Protocol Suite>\IF\<if>\net_if.*
*
* (f) \<Network Protocol Suite>\NIC\<if>\<nic>\net_nic.*
*
* where
* <Your Product Application> directory path for Your Product's Application
* <Network Protocol Suite> directory path for network protocol suite
* <cpu> directory name for specific processor (CPU)
* <compiler> directory name for specific compiler
* <os> directory name for specific operating system (OS)
* <if> directory name for specific netwokr interface (IF)
* <nic> directory name for specific network interface card (NIC)
*
* (2) CPU-configuration software files are located in the following directories :
*
* (a) \<CPU-Compiler Directory>\cpu_def.h
*
* (b) \<CPU-Compiler Directory>\<cpu>\<compiler>\cpu*.*
*
* where
* <CPU-Compiler Directory> directory path for common CPU-compiler software
* <cpu> directory name for specific processor (CPU)
* <compiler> directory name for specific compiler
*
* (3) NO compiler-supplied standard library functions are used by the network protocol suite.
*
* (a) Standard library functions are implemented in the custom library module(s) :
*
* \<Custom Library Directory>\lib*.*
*
* where
* <Custom Library Directory> directory path for custom library software
*
* (b) Network-specific library functions are implemented in the Network Utility module,
* 'net_util.*' (see 'net_util.h Note #1').
*
* (4) Compiler MUST be configured to include as additional include path directories :
*
* (a) Your Product Application directory See Note #1a
*
* (b) Network Protocol Suite directory See Note #1b
*
* (c) '\<Custom Library Directory>\' directory See Note #3a
*
* (d) Specific port directories :
*
* (1) (A) '\<CPU-Compiler Directory>\' directory See note #2
* (B) Specific CPU-compiler directory
*
* (2) '\<Network Protocol Suite>\Ports\<cpu>\<compiler>\' directory See Note #1c
*
* (3) OS directory See Note #1d
*
* (4) (A) '\<Network Protocol Suite>\IF\' directory See note #1e
* (B) Specific IF directory
*
* (5) NIC directory See Note #1f
*
* (5) An application MUST pre-processor include ONLY this main network protocol suite
* header file, 'net.h'. All other network protocol suite files are included via
* this main network header file.
*
* See also 'MODULE Note #1'.
*********************************************************************************************************
*/
/*$PAGE*/
#include <cpu.h> /* CPU Configuration (see Note #2) */
#include <lib_def.h> /* Standard Defines (see Note #3a) */
#include <lib_mem.h> /* Standard Memory Library (see Note #3a) */
#include <net_def.h> /* Network Defines */
#include <net_nic_def.h> /* Network Card Defines */
#include <app_cfg.h> /* Application Configuration File (see Note #1a) */
#include <net_cfg.h> /* Network Configuration File (see Note #1a) */
#include <net_cfg_net.h> /* Network Configuration (based on 'net_cfg.h' settings) */
#include <net_type.h> /* Network Data Types */
#include <net_err.h> /* Network Error Code Management */
#include <net_ctr.h> /* Network Counter Management */
#include <net_stat.h> /* Network Statistics Management */
#include <net_tmr.h> /* Network Timer Management */
#include <net_buf.h> /* Network Buffer Management */
#include <net_dbg.h> /* Network Debug Management */
#include <net_util.h> /* Network Utility Library (see Note #3b) */
#include <net_bsp.h> /* Network BSP Interface (see Note #1a) */
#include <net_os.h> /* Network-OS Interface (see Note #1d) */
#include <net_if.h> /* Network-Link Interface (see Note #1e) */
#include <net_nic.h> /* Network Card Interface (see Note #1f) */
#include <net_ip.h> /* Network IP Layer */
#include <net_icmp.h> /* Network ICMP Layer */
#include <net_udp.h> /* Network UDP Layer */
#include <net_tcp.h> /* Network TCP Layer */
#include <net_ascii.h> /* Network ASCII Library */
#include <net_bsd.h> /* Network-BSD Layer */
#include <net_sock.h> /* Network Socket Layer */
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -