[ ]
 Real time embedded FreeRTOS RSS feed 
Real time embedded FreeRTOS mailing list 
Homepage FreeRTOS Labs FreeRTOS+TCP FreeRTOS+FAT Contact / Enquiries


FreeRTOS+TCP is still in the lab
FreeRTOS+TCP is already used in commercial products and we encourage you to try it yourself. Be aware however that we are still refining its design, and the source code and documentation do not yet meet Real Time Engineers Ltd's strict quality standards.
Please use the forum for support, feedback and ideas, or contact us directly if you have a specific business interest.

pxGetNetworkBufferWithDescriptor()
[Ethernet Driver Porting API]

FreeRTOS_IP_Private.h
NetworkBufferManagement.h
NetworkBufferDescriptor_t *pxGetNetworkBufferWithDescriptor( size_t xRequestedSizeBytes,
                                                TickType_t xBlockTimeTicks );

		

Data that is sent out to the network or received from the network is stored in a network buffer. A network buffer is basically just a block of RAM (actually an array of uint8_t in the source code).

The embedded TCP/IP stack needs to first locate the network buffers, and once located know how big the network buffers are. Network buffer descriptors are used for that purpose.

Embedded network buffers

pucPayloadBuffer points to the start of the network buffer.
xDataLength holds the size of the buffer in bytes, excluding the Ethernet CRC bytes.


More information is provided on the page that network buffer descriptordescribes how to port FreeRTOS+TCP to new devices.

pxGetNetworkBufferWithDescriptor() Obtains a network buffer and associated network buffer descriptor. If xRequestedSizeBytes is 0 then a network buffer descriptor is obtained by itself - without a network buffer.

pxGetNetworkBufferWithDescriptor() must not be called from an interrupt service routine (ISR).

The total number of network buffer descriptors is set by ipconfigNUM_NETWORK_BUFFER_DESCRIPTORS.


Parameters:

xRequestedSizeBytes   The size of the Ethernet buffer to obtain and reference from the returned network buffer descriptor. The size is specified in bytes.

If xRequestedSizeBytes is zero then the returned network buffer descriptor will not reference an Ethernet buffer (the reference is set to NULL).

xBlockTimeTicks   If a network buffer is not available then the calling RTOS task will be held in the Blocked state (so other tasks can execute) until either a network buffer becomes available or the specified block time expires.

The block time is specified in RTOS ticks. To convert a time specified in milliseconds to a time specified in RTOS ticks divide the time specified in milliseconds by portTICK_PERIOD_MS.


Returns:

Successful calls return a pointer to the obtained network buffer descriptor. Unsuccessful calls return NULL.

Example usage:

Examples are provided on the Porting FreeRTOS to a Different Microcontroller page.


[ Back to the top ]    [ About FreeRTOS ]    [ FreeRTOS Labs Sitemap ]    [ Main FreeRTOS Sitemap ]    [ ]




Copyright (C) 2004-2010 Richard Barry. Copyright (C) 2010-2016 Real Time Engineers Ltd.
Any and all data, files, source code, html content and documentation included in the FreeRTOSTM distribution or available on this site are the exclusive property of Real Time Engineers Ltd.. See the files license.txt (included in the distribution) and this copyright notice for more information. FreeRTOSTM and FreeRTOS.orgTM are trade marks of Real Time Engineers Ltd.