forked from FreeRTOS/FreeRTOS-Plus-TCP
-
Notifications
You must be signed in to change notification settings - Fork 0
/
History.txt
281 lines (252 loc) · 14.7 KB
/
History.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
Changes between V3.0.0 and V3.1.0 releases:
+ Fixed a bug in the Connect function where multiple SYN and RST packet combinations can
lead to orphaned sockets.
+ Added network interface support for NetifSlirp.
Changes between V3.0.0 and V2.4.0 releases:
+ Split the source files according to the function the code performs.
This makes the code modular making test coverage easier.
+ Achieved 100% unit-test coverage.
+ Improved RFC compliance.
+ Improved MISRA c-2012 compliance.
Helpful links to help you upgrade to V3
+ https://github.com/FreeRTOS/FreeRTOS-plus-tcp#generating-pre-v300-folder-structure-for-backward-compatibility
+ https://www.freertos.org/2022/08/the-freertos-plus-tcp-library-is-now-more-robust-and-secure.html
Changes between V2.3.3 and V2.3.4 releases:
+ Added a check in BufferAllocation_2.c to ensure adding (2 +
ipBUFFER_PADDING) bytes to the requested allocation size does
not cause an integer overflow. Thanks to Bernard Lebel
(RMDS Innovation) reporting this potential issue.
+ Updated FreeRTOS_inet_pton4() so it rejects IP addresses that
have leading zeros. Previously, if the IP address had leading
zeros, perhaps because it was entered in octal format, the
address was interpreted as decimal (the leading zeros were
stripped). That could result in the function returning an
unexpected IP address.
+ Added logic to clear flags of a stored TCP packet to avoid
sending incorrect flags when receiving incorrect packets from
the peer.
+ Fixed the IP header checksum calculation of ICMP response.
Changes between V2.3.2 and V2.3.3 releases:
+ When a listening socket is closed, all child sockets not yet owned by the
application will be closed too. (Thanks Bernd Edlinger).
+ Updated buffer allocation to return a zero length buffer when
requested. (Thanks Thomas Pedersen).
+ When there is insufficient space in the network event queue, closing of a
socket will be deferred for a later time. (Thanks Bernd Edlinger).
+ Allow IP-task to clean up while deleting socket-sets to avoid race
conditions. (Thanks Bernd Edlinger).
+ Added FreeRTOS+TCP version number macros.
+ Repaired buffer leak in NBNS reply logic.
+ Added a hook function which can be used to process unsupported ethernet
frames.
+ Added a check for ICMP packets with incorrect checksum.
Changes between V2.3.1 and V2.3.2 releases:
+ When a protocol error occurs during the SYN-phase of a TCP connection, a
child socket will now be closed ( calling FreeRTOS_closesocket() ),
instead of being given the eCLOSE_WAIT status. A client socket, which calls
connect() to establish a connection, will receive the eCLOSE_WAIT status,
just like before.
+ Fixed a race condition in DHCP state machine which occured when the macro
dhcpINITIAL_TIMER_PERIOD was set to a very low value.
Changes between V2.3.0 and V2.3.1 releases:
+ Fixed UDP only compilation.
+ Added description for functions and variables in Doxygen compatible format.
+ Fixed asynchronous DNS lookup which was broken due to changed function
signature of prvParseDNSReply.
Changes between V2.2.2 and V2.3.0 releases:
+ Moved FreeRTOS+TCP source code to an independent repository
FreeRTOS/FreeRTOS-Plus-TCP.
Changes between V2.2.1 and V2.2.2 releases:
+ Updated the source code to adhere to stricter MISRA compliance.
Changes between V2.0.0 and V2.2.1 releases:
+ Improved security by giving users the option to reject UDP packets with a
checksum of zero even though the UDP spec allows it.
+ Improved robustness by checking packet lengths in software even if the check
has already been performed in the hardware.
+ Added ipconfigIP_PASS_PACKETS_WITH_IP_OPTIONS macro to enable users to
drop/accept IP Packets containing IP options (IP options are not supported).
+ Modified xDataLength to always mean "total number of bytes" to impart more
clarity.
+ Replaced the ipconfigRAND32 macro with a function
xApplicationGetRandomNumber(). The return value indicates if the randomiser
is broken or working properly. Before this, a random value of 0 was treated
as invalid, whereas 0 can be a proper random value.
+ Made changes in DNS to make asynchronous lookup work.
+ Made FreeRTOS_OutputARPRequest() available for application code. Now the
application can start an ARP request directly by sending a UDP packet.
+ Made Socket_t and SocketSet_t point to a struct in stead of void.
+ Corrected the DNSs protocol-checksum calculation length.
+ Corrected length-check in usGenerateProtocolChecksum().
+ Modified pxGetNetworkBufferWithDescriptor() function to check if a counting
semaphore has been created. Earlier when a user tried to get a Network
Buffer before the IP-task started, the function could crash.
+ Made TCP low-water/high-water limits configurable with a socket option.
+ The 'ucFirstOptionByte' was counted twice in earlier releases, subtract 1
byte to send the correct amount of bytes.
+ Corrected the WIN size reporting to the TCP peer. The WIN size as reported
to the TCP peer was sometimes running slightly behind.
+ Added a function FreeRTOS_dnsclear() which invalidates the entire DNS cache.
+ Added DNS response transaction ID check. The DNS cache shall only be updated
when the ID in the reply comes from the device.
Changes between 180821 and V2.0.0 releases:
+ Move the TCP source code from FreeRTOS/FreeRTOS-Labs to FreeRTOS/FreeRTOS
repository.
Changes between 160919 and 180821 releases:
+ Multiple security improvements and fixes in packet parsing routines, DNS
caching, and TCP sequence number and ID generation.
+ Disable NBNS and LLMNR by default.
+ Add TCP hang protection by default.
We thank Ori Karliner of Zimperium zLabs Team for reporting these issues.
Changes between 160908 and 160919 releases:
+ Add a NULL check before attempting to close the DHCP socket. [Prior to
160823 the IP task closed the DHCP socket by calling a public API function
- which checked for the socket being NULL. This was changed to call a
local private function, which did not have a NULL check, in place of the
public API function.]
+ Various [internal only] naming changes to better comply with the FreeRTOS
naming conventions.
+ Improvements to the Zynq network driver. DMA transmission buffers now use
a counting semaphore. When all TX-buffers are in-use, the IP-task will
block momentarily until a TX-buffer becomes available.
+ Experimental implementation of the TCP window scaling protocol. The
scaling option will always be offered, at least with a factor 1. If the
TCP sliding window size becomes more than 64KB, the factor will increase
automatically.
+ ipconfigETHERNET_MINIMUM_PACKET_BYTES is now applied for every protocol:
TCP, UDP, and ARP.
+ Updated the Zynq project to use BufferAllocation_1.c rather than
BufferAllocation_2.c - which is a requirement with its current
configuration (due to the alignment requirements on the combined cache and
DMA configuration).
Changes between 160823 and 160908 releases:
+ Use ipconfigZERO_COPY_TX_DRIVER as the xReleaseAfterSend() parameter where
prvTCPReturnPacket() is called in prvSendData() to prevent unnecessary
copying of data.
+ Remove the use of the uxGetRxEventCount variable, which was used to give
priority to incoming messages, but could result in the IP task starving
application tasks of processing time.
Changes between 160112 and 160823 releases
NOTE: The 160908 release is a maintenance release for the 160112 single
interface labs release - not a release of the current development branch.
+ Various minor stability enhancements, including the ability to work with
configTICK_RATE_HZ set to less than 1KHz, closing DHCP sockets directly
rather than via FreeRTOS_closesocket(), and better handling of unknown
TCP packets before an IP address has been assigned.
+ ipBUFFER_PADDING is now configurable through the ipconfigBUFFER_PADDING
constant to improve network buffer alignment handling capabilities (expert
users/driver writers only).
+ Multiple improvements to the FTP server, including to how read only and
zero length files are handled.
+ ipconfigFTP_HAS_USER_PROPERTIES_HOOK (to allow each user to have a
different root directory and access rights) and
ipconfigHTTP_HAS_HANDLE_REQUEST_HOOK (to handle AJAX style data)
introduced, although these are not yet fully tested and the constant names
are likely to change.
+ Introduce ipconfigHAS_TX_CRC_OFFLOADING.
+ ipconfigUSE_DHCP_HOOK is now called ipconfigUSE_DHCP_HOOK, and the name
of the callback function has also changed. See the web documentation for
details.
+ ipconfigTCP_RX_BUF_LEN is now ipconfigTCP_RX_BUFFER_LENGTH, and
ipconfigTCP_TX_BUF_LEN is now ipconfigTCP_TX_BUFFER_LENGTH, which is
actually how they have always been documented.
+ Added example TFTP server capable of receiving (not sending) files.
Intended for bootloader type functionality.
+ Various variable name changes for consistency (mainly ensuring UDP, TCP,
DNS, etc. always use the same case letters, and type prefixes are correct).
+ Various minor edits to improve types used by internal variables.
+ Simplified mapping of standard library functions to their Visual Studio
equivalents.
+ Improve robustness of network drivers.
+ Introduce pxResizeNetworkBufferWithDescriptor().
+ Removed obsolete FreeRTOSIPConfig.h constants from
FreeRTOSIPConfigDefaults.h.
+ Added additional asserts() - predominantly to catch incorrect structure
packing.
Changes between 160112 and 160111 releases
+ Updated the STM32 network driver so checksums are calculated by the
hardware.
+ Implemented a simple "quit" command in the TCP command console.
Changes between 150825 and 160111 releases
+ New device support: Demo applications and example drivers are provided
for Atmel SAM4E and ST STM32F4 microcontrollers.
+ Various updates to improve compliance with the FreeRTOS coding standard.
+ Added a command console example that uses TCP/IP for input and output (the
pre-existing command console example uses UDP/IP).
+ Updated the UDP logging example so it will send log messages to the local
UDP broadcast address if a specific IP address is not provided. This
simplifies configuration, but note not all switches and routers will pass
broadcast messages.
+ Add TCP echo client and TCP echo server examples to the Zynq demo.
+ Minor updates to the Zynq network driver.
+ Update the Zynq project to use version 2015.4 of the Xilinx SDK.
+ Introduce FreeRTOS_SignalSocket(), which can be used to interrupt a task
that is blocked while reading from a socket ( FreeRTOS_recv[from] ).
+ Make use of FreeRTOS_SignalSocket() in the FTP and HTTP servers.
+ Major updates to the NTP client, although this is not included in any of
the pre-configured demo applications yet.
+ Added support for DHCP zero pad option.
+ Added uxGetMinimumIPQueueSpace(), a function to monitor the minimum amount
of space on the message queue.
+ Better handling of zero length files in the FTP server.
+ Fixed a bug reported by Andrey Ivanov from swissEmbedded that affects
users of 'ipconfigZERO_COPY_TX_DRIVER'.
Changes between 150825 150825 (?)
+ Added xApplicationDHCPUserHook() so a user defined hook will be
called at certain points in the DHCP process if
ipconfigDHCP_USES_USER_HOOK is set to 1.
+ Added FreeRTOS_get_tx_head() to improve TCP zero copy behaviour - for
expert use only.
+ RST is no longer sent if only the ACK flag is set.
+ Previously, an immediate ACK was only sent when buffer space was
exhausted. Now, to improve performance, it is possible to send an
immediate ACK earlier - dependent on the ipconfigTCP_ACK_EARLIER_PACKET
setting.
+ LLMNR and NBNS requests can now be sent to locate other devices -
previously these protocols would only be replied to, not generated.
+ Added Auto-IP functionality (still in test) in case DHCP fails. Dependent
on the ipconfigDHCP_FALL_BACK_LINK_LAYER_ADDRESS and
ipconfigARP_USE_CLASH_DETECTION settings.
+ Added NTP code and demo.
+ FTP can now STOR and RETR zero-length files.
+ Added LLMNR demo to Win32 demo - so now the Win32 responds to
"ping RTOSDemo".
Changes between 141019 and 150825
+ Added FTP server, which uses the new FreeRTOS+FAT component.
+ Added basic HTTP server, which uses the new FreeRTOS+FAT component.
+ Multiple definitions that are now common with FreeRTOS+FAT have been moved
into FreeRTOS's ProjDefs.h header file, and so prefixed with 'pd'.
+ Introduced ipconfigZERO_COPY_TX_DRIVER, which defines who is responsible
for freeing a buffer sent to to the MAC driver for transmission, and
facilitates the development of zero copy drivers.
+ Introduced the FREERTOS_MSG_DONTWAIT flag. The flag can be used as a
simpler and faster alternative to using FreeRTOS_setsockopt() to set the
send or receive timeout to 0.
+ A few functions that were previously all lower case are now mixed case, as
lower case function names are only used when they are equivalent to a
a Berkeley sockets API function of the same name.
+ Introduced uxGetMinimumFreeNetworkBuffers() to return the minimum number
of network buffers that have ever existed since the application started
executing.
+ Introduce ipconfigETHERNET_MINIMUM_PACKET_BYTES to allow the application
writer to set their own minimum buffer size should the hardware not be
capable of padding under-sized Ethernet frames.
+ vNetworkBufferRelease() renamed vReleaseNetworkBuffer() - just for
consistency with the names of other functions in the same file.
+ Grouped DHCP status data into a structure.
+ DHCP is now tried both with and without the broadcast flag.
+ Replaced occurrences of configASSERT_VOID() with configASSERT().
+ ipconfigDNS_USE_CALLBACKS introduced to allow FreeRTOS_gethostbyname() to
be used without blocking.
+ Fix: LLMNR and NBNS behaviour when the reply is in a larger buffer than the
request, and BufferAllocation_2 was used.
+ Introduced ipMAX_IP_TASK_SLEEP_TIME to allow the application writer to
override the default value of 10 seconds.
+ Fix: Correct error in *pxUDPPayloadBuffer_to_NetworkBuffer().
+ FreeRTOS_recv() now recognises the FREERTOS_ZERO_COPY flag, which, when
set, the void *pvBuffer parameter is interpreted as void **pvBuffer.
+ FreeRTOS_listen() now returns an error code. Previously it always
returned 0.
+ Fix: Previously if a listening socket was reused, and a connection
failed, the TCP/IP stack closed the socket, now the socket is correctly
left unclosed as it is owned by the application.
+ Various other formatting and minor fix alterations.