| Line No. | Rev | Author | Line |
|---|---|---|---|
| 1 | 32 | kaklik | /********************************************************************* |
| 2 | * |
||
| 3 | * IP Defs for Microchip TCP/IP Stack |
||
| 4 | * |
||
| 5 | ********************************************************************* |
||
| 6 | * FileName: IP.h |
||
| 7 | * Dependencies: StackTsk.h |
||
| 8 | * MAC.h |
||
| 9 | * Processor: PIC18, PIC24F, PIC24H, dsPIC30F, dsPIC33F, PIC32 |
||
| 10 | * Compiler: Microchip C32 v1.05 or higher |
||
| 11 | * Microchip C30 v3.12 or higher |
||
| 12 | * Microchip C18 v3.30 or higher |
||
| 13 | * HI-TECH PICC-18 PRO 9.63PL2 or higher |
||
| 14 | * Company: Microchip Technology, Inc. |
||
| 15 | * |
||
| 16 | * Software License Agreement |
||
| 17 | * |
||
| 18 | * Copyright (C) 2002-2009 Microchip Technology Inc. All rights |
||
| 19 | * reserved. |
||
| 20 | * |
||
| 21 | * Microchip licenses to you the right to use, modify, copy, and |
||
| 22 | * distribute: |
||
| 23 | * (i) the Software when embedded on a Microchip microcontroller or |
||
| 24 | * digital signal controller product ("Device") which is |
||
| 25 | * integrated into Licensee's product; or |
||
| 26 | * (ii) ONLY the Software driver source files ENC28J60.c, ENC28J60.h, |
||
| 27 | * ENCX24J600.c and ENCX24J600.h ported to a non-Microchip device |
||
| 28 | * used in conjunction with a Microchip ethernet controller for |
||
| 29 | * the sole purpose of interfacing with the ethernet controller. |
||
| 30 | * |
||
| 31 | * You should refer to the license agreement accompanying this |
||
| 32 | * Software for additional information regarding your rights and |
||
| 33 | * obligations. |
||
| 34 | * |
||
| 35 | * THE SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT |
||
| 36 | * WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT |
||
| 37 | * LIMITATION, ANY WARRANTY OF MERCHANTABILITY, FITNESS FOR A |
||
| 38 | * PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL |
||
| 39 | * MICROCHIP BE LIABLE FOR ANY INCIDENTAL, SPECIAL, INDIRECT OR |
||
| 40 | * CONSEQUENTIAL DAMAGES, LOST PROFITS OR LOST DATA, COST OF |
||
| 41 | * PROCUREMENT OF SUBSTITUTE GOODS, TECHNOLOGY OR SERVICES, ANY CLAIMS |
||
| 42 | * BY THIRD PARTIES (INCLUDING BUT NOT LIMITED TO ANY DEFENSE |
||
| 43 | * THEREOF), ANY CLAIMS FOR INDEMNITY OR CONTRIBUTION, OR OTHER |
||
| 44 | * SIMILAR COSTS, WHETHER ASSERTED ON THE BASIS OF CONTRACT, TORT |
||
| 45 | * (INCLUDING NEGLIGENCE), BREACH OF WARRANTY, OR OTHERWISE. |
||
| 46 | * |
||
| 47 | * |
||
| 48 | * Author Date Comment |
||
| 49 | *~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
||
| 50 | * Nilesh Rajbharti 4/27/01 Original (Rev 1.0) |
||
| 51 | * Nilesh Rajbharti 2/9/02 Cleanup |
||
| 52 | * Nilesh Rajbharti 5/22/02 Rev 2.0 (See version.log for detail) |
||
| 53 | ********************************************************************/ |
||
| 54 | #ifndef __IP_H |
||
| 55 | #define __IP_H |
||
| 56 | |||
| 57 | |||
| 58 | #define IP_PROT_ICMP (1u) |
||
| 59 | #define IP_PROT_TCP (6u) |
||
| 60 | #define IP_PROT_UDP (17u) |
||
| 61 | |||
| 62 | |||
| 63 | // IP packet header definition |
||
| 64 | typedef struct _IP_HEADER |
||
| 65 | { |
||
| 66 | BYTE VersionIHL; |
||
| 67 | BYTE TypeOfService; |
||
| 68 | WORD TotalLength; |
||
| 69 | WORD Identification; |
||
| 70 | WORD FragmentInfo; |
||
| 71 | BYTE TimeToLive; |
||
| 72 | BYTE Protocol; |
||
| 73 | WORD HeaderChecksum; |
||
| 74 | IP_ADDR SourceAddress; |
||
| 75 | IP_ADDR DestAddress; |
||
| 76 | } IP_HEADER; |
||
| 77 | |||
| 78 | // IP Pseudo header as defined by RFC 793 (needed for TCP and UDP |
||
| 79 | // checksum calculations/verification) |
||
| 80 | typedef struct _PSEUDO_HEADER |
||
| 81 | { |
||
| 82 | IP_ADDR SourceAddress; |
||
| 83 | IP_ADDR DestAddress; |
||
| 84 | BYTE Zero; |
||
| 85 | BYTE Protocol; |
||
| 86 | WORD Length; |
||
| 87 | } PSEUDO_HEADER; |
||
| 88 | |||
| 89 | #define SwapPseudoHeader(h) (h.Length = swaps(h.Length)) |
||
| 90 | |||
| 91 | |||
| 92 | /********************************************************************* |
||
| 93 | * Function: BOOL IPIsTxReady(BOOL HighPriority) |
||
| 94 | * |
||
| 95 | * PreCondition: None |
||
| 96 | * |
||
| 97 | * Input: None |
||
| 98 | * |
||
| 99 | * Output: TRUE if transmit buffer is empty |
||
| 100 | * FALSE if transmit buffer is not empty |
||
| 101 | * |
||
| 102 | * Side Effects: None |
||
| 103 | * |
||
| 104 | * Note: None |
||
| 105 | * |
||
| 106 | ********************************************************************/ |
||
| 107 | #define IPIsTxReady() MACIsTxReady() |
||
| 108 | |||
| 109 | |||
| 110 | /********************************************************************* |
||
| 111 | * Macro: IPSetTxBuffer(a, b) |
||
| 112 | * |
||
| 113 | * PreCondition: None |
||
| 114 | * |
||
| 115 | * Input: a - Buffer identifier |
||
| 116 | * b - Offset |
||
| 117 | * |
||
| 118 | * Output: Next Read/Write access to transmit buffer 'a' |
||
| 119 | * set to offset 'b' |
||
| 120 | * |
||
| 121 | * Side Effects: None |
||
| 122 | * |
||
| 123 | * Note: None |
||
| 124 | * |
||
| 125 | ********************************************************************/ |
||
| 126 | #define IPSetTxBuffer(b) MACSetWritePtr(b + BASE_TX_ADDR + sizeof(ETHER_HEADER) + sizeof(IP_HEADER)) |
||
| 127 | |||
| 128 | |||
| 129 | |||
| 130 | /********************************************************************* |
||
| 131 | * Function: WORD IPPutHeader( IP_ADDR *Dest, |
||
| 132 | * BYTE Protocol, |
||
| 133 | * WORD Identifier, |
||
| 134 | * WORD DataLen) |
||
| 135 | * |
||
| 136 | * PreCondition: IPIsTxReady() == TRUE |
||
| 137 | * |
||
| 138 | * Input: Src - Destination node address |
||
| 139 | * Protocol - Current packet protocol |
||
| 140 | * Identifier - Current packet identifier |
||
| 141 | * DataLen - Current packet data length |
||
| 142 | * |
||
| 143 | * Output: Handle to current packet - For use by |
||
| 144 | * IPSendByte() function. |
||
| 145 | * |
||
| 146 | * Side Effects: None |
||
| 147 | * |
||
| 148 | * Note: Only one IP message can be transmitted at any |
||
| 149 | * time. |
||
| 150 | * Caller may not transmit and receive a message |
||
| 151 | * at the same time. |
||
| 152 | * |
||
| 153 | ********************************************************************/ |
||
| 154 | WORD IPPutHeader(NODE_INFO *remote, |
||
| 155 | BYTE protocol, |
||
| 156 | WORD len); |
||
| 157 | |||
| 158 | |||
| 159 | /********************************************************************* |
||
| 160 | * Function: BOOL IPGetHeader( IP_ADDR *localIP, |
||
| 161 | * NODE_INFO *remote, |
||
| 162 | * BYTE *Protocol, |
||
| 163 | * WORD *len) |
||
| 164 | * |
||
| 165 | * PreCondition: MACGetHeader() == TRUE |
||
| 166 | * |
||
| 167 | * Input: localIP - Local node IP Address as received |
||
| 168 | * in current IP header. |
||
| 169 | * If this information is not required |
||
| 170 | * caller may pass NULL value. |
||
| 171 | * remote - Remote node info |
||
| 172 | * Protocol - Current packet protocol |
||
| 173 | * len - Current packet data length |
||
| 174 | * |
||
| 175 | * Output: TRUE, if valid packet was received |
||
| 176 | * FALSE otherwise |
||
| 177 | * |
||
| 178 | * Side Effects: None |
||
| 179 | * |
||
| 180 | * Note: Only one IP message can be received. |
||
| 181 | * Caller may not transmit and receive a message |
||
| 182 | * at the same time. |
||
| 183 | * |
||
| 184 | ********************************************************************/ |
||
| 185 | BOOL IPGetHeader(IP_ADDR *localIP, |
||
| 186 | NODE_INFO *remote, |
||
| 187 | BYTE *protocol, |
||
| 188 | WORD *len); |
||
| 189 | |||
| 190 | |||
| 191 | /********************************************************************* |
||
| 192 | * Macro: IPDiscard() |
||
| 193 | * |
||
| 194 | * PreCondition: MACGetHeader() == TRUE |
||
| 195 | * |
||
| 196 | * Input: None |
||
| 197 | * |
||
| 198 | * Output: Current packet is discarded and buffer is |
||
| 199 | * freed-up |
||
| 200 | * |
||
| 201 | * Side Effects: None |
||
| 202 | * |
||
| 203 | * Note: None |
||
| 204 | * |
||
| 205 | ********************************************************************/ |
||
| 206 | #define IPDiscard() MACDiscard() |
||
| 207 | |||
| 208 | |||
| 209 | |||
| 210 | /********************************************************************* |
||
| 211 | * Macro: IPGetArray(a, b) |
||
| 212 | * |
||
| 213 | * PreCondition: MACGetHeader() == TRUE |
||
| 214 | * |
||
| 215 | * Input: a - Data buffer |
||
| 216 | * b - Buffer length |
||
| 217 | * |
||
| 218 | * Output: None |
||
| 219 | * |
||
| 220 | * Side Effects: None |
||
| 221 | * |
||
| 222 | * Note: Data is copied from IP data to given buffer |
||
| 223 | * |
||
| 224 | ********************************************************************/ |
||
| 225 | #define IPGetArray(a, b) MACGetArray(a, b) |
||
| 226 | |||
| 227 | |||
| 228 | |||
| 229 | |||
| 230 | /********************************************************************* |
||
| 231 | * Function: IPSetRxBuffer(WORD Offset) |
||
| 232 | * |
||
| 233 | * PreCondition: IPHeaderLen must have been intialized by |
||
| 234 | * IPGetHeader() or IPPutHeader() |
||
| 235 | * |
||
| 236 | * Input: Offset from beginning of IP data field |
||
| 237 | * |
||
| 238 | * Output: Next Read/Write access to receive buffer is |
||
| 239 | * set to Offset |
||
| 240 | * |
||
| 241 | * Side Effects: None |
||
| 242 | * |
||
| 243 | * Note: None |
||
| 244 | * |
||
| 245 | ********************************************************************/ |
||
| 246 | void IPSetRxBuffer(WORD Offset); |
||
| 247 | |||
| 248 | |||
| 249 | |||
| 250 | |||
| 251 | |||
| 252 | #endif |
||
| 253 | |||
| 254 | |||
| 255 |
Powered by WebSVN v2.8.3