From a8b539af81d567c10b46114584fe12e1bee68293 Mon Sep 17 00:00:00 2001 From: Brennan Ashton Date: Sun, 15 Nov 2020 13:17:12 -0800 Subject: [PATCH] Add release notes for NuttX-10.0.0 Signed-off-by: Brennan Ashton --- ReleaseNotes | 1264 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1264 insertions(+) diff --git a/ReleaseNotes b/ReleaseNotes index 574aa8783e..4bec6e80b3 100644 --- a/ReleaseNotes +++ b/ReleaseNotes @@ -27122,3 +27122,1267 @@ NuttX-9.1.0 Release Notes ------------------------- - PR-176 cu: Handle NULL character correctly - PR-287 PR-290 examples: Update nxflat and thttpd Makefile's to fix a build breakage. + +NuttX-10.0.0 Release Notes +------------------------ + +## Major Changes to Core OS + +### New Features + +Major changes to the internal, OS timer (wdog) interfaces. The change includes: + + * The wdog timer call backs used to support a variable number of arguments. +Now they support only a single argument ([PR +#1565](https://github.com/apache/incubator-nuttx/pull/1565)). This eliminates +(1) the configuration option `CONFIG_MAX_WDOGPARMS` and the OS interfaces +`wd_create()` and `wd_delete()` *   wdog timer data structures are no longer +pre-allocated. Now they are allocated by the caller of `wd_start()`. This (1) +eliminates the configuration options `CONFIG_PREALLOC_WDOGS` and +`CONFIG_WDOG_INTRESERVE`, (2) eliminates the type `WDOG_ID` which was a pointer +type to `struct wdog_s`, and (3) change the type of the first argument of all +remaining wdog interfaces functions from `WDOG_ID` to `FAR struct wdog_s *`. + +Because of these changes, all proprietary drivers maintained by all NuttX users +will require modification. The following summaries the required modifications: + + * Most drivers have a field in structure like `WDOG_ID wdog`; That must be +changed to `struct wdog_s wdog`; That changes the field from a pointer to a +`struct wdog_s` to the `struct wdog_s` storage itself. *   Eliminate all calls +to `wd_create()`. The `WDOG_ID` is not longer managed by the timing subsystem +and the `wd_create()` interface has been removed. *   The `wd_delete()` +interface has also been removed, but more care will need to be exercised: +`wd_delete()` also cancels any running timer so, in many case, calls to +`wd_delete()` should be replaced with calls to `wd_cancel()`. If you are certain +that the timer has never been started, then you must remove the call to +`wd_delete()` altogether. Calling `wd_cancel()` with an un-initialized s`truct +wdog_s` instance may well cause a fatal crash. *   Replace the first parameter +of all remaining wdog function calls from. For example, replace a call like `ret += wd_cancel(priv->wdog)` where `priv->wdog` was type `WDOG_ID` with the call +`ret = wd_cancel(&priv->wdog)`where `priv->wdog` is now type `struct wdog_s`. + + * [PR-1877](https://github.com/apache/incubator-nuttx/pull/1877) libc: + Implement "j" modifier for scanf + + * [PR-1864](https://github.com/apache/incubator-nuttx/pull/1864) libc: fs: Add + relative path support + + * [PR-1863](https://github.com/apache/incubator-nuttx/pull/1863) libc: + Implement `access()` + + * [PR-1866](https://github.com/apache/incubator-nuttx/pull/1866) libc: uio: + enable `writev()` for sockets + + * [PR-1853](https://github.com/apache/incubator-nuttx/pull/1853) libc: + Implement `popcount/popcountl/popcountll` + + * [PR-1850](https://github.com/apache/incubator-nuttx/pull/1850) Add tool for + parsing the callstack for Trace32 + + * [PR-1840](https://github.com/apache/incubator-nuttx/pull/1840) Add POLLPRI + for exception condition on the file descriptor + + * [PR-1828](https://github.com/apache/incubator-nuttx/pull/1828) Implement + mkdtemp syscall + + * [PR-1826](https://github.com/apache/incubator-nuttx/pull/1826) libc: Add + "tm\_zone" member to tm + + * [PR-1824](https://github.com/apache/incubator-nuttx/pull/1824) Implement + etpriority syscall + + * [PR-1821](https://github.com/apache/incubator-nuttx/pull/1821) Implement + gettid syscall + + * [PR-1818](https://github.com/apache/incubator-nuttx/pull/1818) Implement + pipe2 syscall + + * [PR-1779](https://github.com/apache/incubator-nuttx/pull/1779) libc: Minimal + umask implementation + + * [PR-1758](https://github.com/apache/incubator-nuttx/pull/1758) mm: Add lock + to protect call to mm\_addregion + + * [PR-1756](https://github.com/apache/incubator-nuttx/pull/1756) libc: + Implement gethrtime, getrlimit, setrlimit + + * [PR-1658](https://github.com/apache/incubator-nuttx/pull/1658) libc: Add + stubs for utimes + + * [PR-1615](https://github.com/apache/incubator-nuttx/pull/1615) libc: + Implement tm::tm\_gmtoff field + + * [PR-1611](https://github.com/apache/incubator-nuttx/pull/1611) libc: Allocate + file\_struct dynamically + + * [PR-1684](https://github.com/apache/incubator-nuttx/pull/1684) Add gdb script + for NuttX thread debugging + + * [PR-1607](https://github.com/apache/incubator-nuttx/pull/1607) mm: Implement + malloc\_usable\_size + + * [PR-1606](https://github.com/apache/incubator-nuttx/pull/1606) sched/pthread: + Implement pthread\_attr\_detachstate + + * [PR-1600](https://github.com/apache/incubator-nuttx/pull/1600) Implement + epol\_pwait and EPOLLONESHOT flag + + * [PR-1597](https://github.com/apache/incubator-nuttx/pull/1597) sched: Support + passing non empty argument to init task + + * [PR-1596](https://github.com/apache/incubator-nuttx/pull/1596) libc: Replace + all sem\_xxx with \_SEM\_XXX. This insures the correct semaphore interface is + used by userspace and the kernel. + + * [PR-1517](https://github.com/apache/incubator-nuttx/pull/1517) sched/wdog: + Change the default value of MAX\_WDOGPARMS from 4 to 2 as wd\_start is two every + where in the code base. Also bump CONFIG\_MAX\_WDOGPARAMS from 1 to 2 in + defconfigs to support pthread\_condclockwait() + + * [PR-1486](https://github.com/apache/incubator-nuttx/pull/1486) libc: + Implement ftw and nftw functions + + * [PR-1567](https://github.com/apache/incubator-nuttx/pull/1567) libc: + Implement proposed POSIX \_clockwait variants of \_timedwait functions + + * [PR-1411](https://github.com/apache/incubator-nuttx/pull/1411) libxx: + Integrate latest uclibcxx 0.2.5 + + * [PR-1586](https://github.com/apache/incubator-nuttx/pull/1586) libc: Add open + for text (translated) access support + + * [PR-1584](https://github.com/apache/incubator-nuttx/pull/1584) libc: + Implement strlcpy function + + * [PR-1580](https://github.com/apache/incubator-nuttx/pull/1580) libc: + Implement pthread\_conattr\_etclock + + * [PR-1545](https://github.com/apache/incubator-nuttx/pull/1545) sched/wdog: Do + not dynamically allocate wdog\_s. Reduces overhead and brings it inline with + work\_s + + * [PR-1534](https://github.com/apache/incubator-nuttx/pull/1534) sched/wdog: + Replace all callback arguments from uint32\_t to wdparm\_t + + * [PR-1420](https://github.com/apache/incubator-nuttx/pull/1420) libc: Do not + define localtime\[\_r\] to macro with CONFIG\_LIBC\_LOCALTIME is not defined. + + * [PR-1375](https://github.com/apache/incubator-nuttx/pull/1375) libc: Always + declare getenv, link/symlink and atexist/on\_exit. Many C++ libraries reference + these but dont use them + + * [PR-1371](https://github.com/apache/incubator-nuttx/pull/1371) libc: Improve + stat/readdir to be more POSIX compliant with S\_xxx macro definition as with + Linux + + * [PR-1369](https://github.com/apache/incubator-nuttx/pull/1369) Initialize the + idle stack at the arch layer to better support stack coloring and also make it + compatible with new TLS implementation + + * [PR-1292](https://github.com/apache/incubator-nuttx/pull/1292) pthread/mutex: + Add PTHREAD\_RECURSIVE\_MUTEX\_INITIALIZER\_NP support + + * [PR-1280](https://github.com/apache/incubator-nuttx/pull/1280) libc: + Implement fseeko and ftello + + * [PR-1279](https://github.com/apache/incubator-nuttx/pull/1279) libc: + Implement lstat and realpath + + * [PR-1278](https://github.com/apache/incubator-nuttx/pull/1278) libc: + Implement pathconf and fpathconf + + * [PR-1269](https://github.com/apache/incubator-nuttx/pull/1269) cstdlib: Add + missing atox to std namespace + + * [PR-1264](https://github.com/apache/incubator-nuttx/pull/1264) sched/pthread: + Prohibit the use of pthread\_cleanup API's by kernel threads + + * [PR-1440](https://github.com/apache/incubator-nuttx/pull/1440) libc: Add the + UUID libc functions + + * [PR-1308](https://github.com/apache/incubator-nuttx/pull/1308) libc: Add + support for \_SC\_NPROCESSORS\_CONF/\_SC\_NPROCESSORS\_ONLN to sysconf + + * [PR-1305](https://github.com/apache/incubator-nuttx/pull/1305) libc: + Implement WNOHANG for waitpid and waitid + + * [PR-1237](https://github.com/apache/incubator-nuttx/pull/1237) libc: Add + minimal support for locale\_t operation: suplocale, freelocale, newlocale, + userlocale + + * [PR-1317](https://github.com/apache/incubator-nuttx/pull/1317) sched/task: + Unify task initialization + + * [PR-1187](https://github.com/apache/incubator-nuttx/pull/1187) sched: Unify + main thread and pthread behavior + + * [PR-2263](https://github.com/apache/incubator-nuttx/pull/2263) libc/stdio: + Preallocate stdin, stdout, stderr + + * [PR-2053](https://github.com/apache/incubator-nuttx/pull/2053) * + [PR-2040](https://github.com/apache/incubator-nuttx/pull/2040) serial/termios: + Support custom baudrate setting + +### Bug Fixes + + * [PR-1911](https://github.com/apache/incubator-nuttx/pull/1911) init\_section + was not being emitted resulting in C++ static constructors not being called. + + * [PR-1889](https://github.com/apache/incubator-nuttx/pull/1889) Fix build + error for ::setbuf if CONFIG\_STDIO\_DISABLE\_BUFFERING is set + + * [PR-1619](https://github.com/apache/incubator-nuttx/pull/1619) Fix inverted + errno in mq\_open + + * [PR-1595](https://github.com/apache/incubator-nuttx/pull/1595) epoll\_wait() + must loop until "maxevents" to fille output evs array + + * [PR-1519](https://github.com/apache/incubator-nuttx/pull/1519) libc: Replace + index/rindex from macro to function to protect against side effects with + conflicting local variables + + * [PR-1514](https://github.com/apache/incubator-nuttx/pull/1514) Remove usage + for user-space memalign() from kernel/driver code. Instead use the proper + kernel memory interface. + + * [PR-1512](https://github.com/apache/incubator-nuttx/pull/1512) / * + [PR-1510](https://github.com/apache/incubator-nuttx/pull/1510) / * + [PR-1507](https://github.com/apache/incubator-nuttx/pull/1507) Remove usage for + user-space malloc()/zalloc()/free() from kernel/driver code. Instead use the + proper kernel memory interface. + + * [PR-1496](https://github.com/apache/incubator-nuttx/pull/1496) libc: Change + ctype macro to normal function to resolve macro evaluation side effects + + * [PR-1463](https://github.com/apache/incubator-nuttx/pull/146) libc: Replace + all malloc/free with lib\_malloc/lib\_free inside libc + + * [PR-1365](https://github.com/apache/incubator-nuttx/pull/1365) up\_assert + should not call exit() directly because it is only callable from userspace + + * [PR-1336](https://github.com/apache/incubator-nuttx/pull/1336) syscall: Fix + prctl PR\_SET\_NAME failure if called without pid argument + + * [PR-1289](https://github.com/apache/incubator-nuttx/pull/1289) Clear the + error indicator with rewind() + + * [PR-1254](https://github.com/apache/incubator-nuttx/pull/1254) libc: mkstemp + only look at the trailing X's instead of the first X + + * [PR-1311](https://github.com/apache/incubator-nuttx/pull/1311) libc: Move + double\_t typedef from sys/types.h to math.h + + * [PR-1328](https://github.com/apache/incubator-nuttx/pull/1328) Make sure that + pthread\_cleanup functions are only called from userspace + + * [PR-1318](https://github.com/apache/incubator-nuttx/pull/1318) + nxsched\_release\_tcb should release stack in kernel build, fixes memory leak + + * [PR-2951](https://github.com/apache/incubator-nuttx/pull/2951) sched: Fix + deadlock in nxtask\_exit() for SMP + + * [PR-2229](https://github.com/apache/incubator-nuttx/pulls/2229) * + [PR-2298](https://github.com/apache/incubator-nuttx/pulls/2298) * + [PR-2279](https://github.com/apache/incubator-nuttx/pulls/2279) * + [PR-2272](https://github.com/apache/incubator-nuttx/pulls/2272) * + [PR-2264](https://github.com/apache/incubator-nuttx/pulls/2264) * + [PR-1992](https://github.com/apache/incubator-nuttx/pulls/1992) * + [PR-2022](https://github.com/apache/incubator-nuttx/pulls/2022) sched: SMP + fixups that caused locking and removal of some no longer required workarounds + + * [PR-1993](https://github.com/apache/incubator-nuttx/pull/1993) libc: Skip + close stdin/stdout/stderr in fclose + + * [PR-1997](https://github.com/apache/incubator-nuttx/pull/1997) libc: Remove + all calls to fclose with stdin/stdout/stderr with fclose + + + +## Major Changes to Documentation + + * [PR-1763](https://github.com/apache/incubator-nuttx/pulls/1763) Add + quickstart documentation + + * [PR-1677](https://github.com/apache/incubator-nuttx/pull/1677) Add simulator, + drivers, and contributing instructions for new users + + * [PR-1675](https://github.com/apache/incubator-nuttx/pull/1675) Add quickstart + documentation from NuttX Companion + + * [PR-1673](https://github.com/apache/incubator-nuttx/pull/1673) Update all the + links in the documentation to point to nuttx.apache.org or the Apache NuttX + wiki instead of old nuttx.org resources + + * [PR-1501](https://github.com/apache/incubator-nuttx/pull/1501) Port all the + existing documentation from HTML files to Sphinx based documentation along with + a bunch of updates and improvments + + * [PR-1433](https://github.com/apache/incubator-nuttx/pull/1433) Convert README + documentation to Markdown + +## Major Changes to the Build System + +### New Features + + * [PR-1786](https://github.com/apache/incubator-nuttx/pull/1786) Support + building external code into the OS + + * [PR-1396](https://github.com/apache/incubator-nuttx/pull/1396) Make C/C++ + search path common so all boards support uClibc++/libc++ automatically + + * [PR-1682](https://github.com/apache/incubator-nuttx/pull/1682) configure.sh + can now list configurations with "-L" option + + * [PR-2023](https://github.com/apache/incubator-nuttx/pull/2023) tools: Remove + WSL configuration. This is just Linux now. + +### Bug Fixes + + * [PR-1713](https://github.com/apache/incubator-nuttx/pull/1713) Fix export + target: libboard was missing KERNEL flag. + + * [PR-1470](https://github.com/apache/incubator-nuttx/pull/1470) Fix Make.dep + not updated by .config changes + + * [PR-1345](https://github.com/apache/incubator-nuttx/pull/1786) Enhance export + target: make BIN directory configurable, export post build script, use LDNAME + instead of LDSCRIPT + + * [PR-1332](https://github.com/apache/incubator-nuttx/pull/1332) Include + incdir.c in the export target + + * [PR-1995](https://github.com/apache/incubator-nuttx/pull/1995) Fix issue + where wrong extension was generated for mkconfig in WSL builds + + * [PR-1949](https://github.com/apache/incubator-nuttx/pull/1949) Fix issue in + make export where nuttx-names.dat was not being generated + + * [PR-1682](https://github.com/apache/incubator-nuttx/pull/1682): Fix issue + where windows style paths might not be handled correctly breaking Cygwin builds + +## Architectural Support + +### New Architecture Support + + * [PR-1847](https://github.com/apache/incubator-nuttx/pull/1847) ARM: Initial + support for ARMV6M to support CortexM0+ + + * [PR-1397](https://github.com/apache/incubator-nuttx/pull/1379): EOSS3: + Initial support for the QuickLogic EOS S3 SoC + +### Architectures With Significant Improvements + +#### cxd56xx + + * [PR-1753](https://github.com/apache/incubator-nuttx/pull/1753) cxd56xx: Use + spinlock in gpioint to improve SMP performance + + * [PR-1650](https://github.com/apache/incubator-nuttx/pull/1650) cxd56xx: Use + spinlock in rtc to improve SMP performance + + * [PR-1621](https://github.com/apache/incubator-nuttx/pull/1621) cxd56xx: Use + spinlock in serial to improve SMP performance + + * [PR-1569](https://github.com/apache/incubator-nuttx/pull/1569) cxd56xx: Add + SMP support to cxd56\_farapi.c + + * [PR-1689](https://github.com/apache/incubator-nuttx/pull/1689) cxd56xx: Use + spinlock in uart to improve SMP performance + +#### ESP32 + + * [PR-1422](https://github.com/apache/incubator-nuttx/pull/1422) ESP32: Add SPI + driver (Master & Slave) + + * [PR-1435](https://github.com/apache/incubator-nuttx/pull/1435) ESP32: Add I2C + driver + + * [PR-1491](https://github.com/apache/incubator-nuttx/pull/1491) ESP32: Add SPI + Flash driver + + * [PR-1525](https://github.com/apache/incubator-nuttx/pull/1525) ESP32: Add + Ethernet driver + + * [PR-1610](https://github.com/apache/incubator-nuttx/pull/1610) ESP32: Improve + SPI transmision (DMA, IOMUX, software CS) + + * [PR-1630](https://github.com/apache/incubator-nuttx/pull/1630) ESP32: Add + support for HW RNG + + * [PR-1830](https://github.com/apache/incubator-nuttx/pull/1830) ESP32: Add + Power Management of Force-Sleep + + * [PR-1754](https://github.com/apache/incubator-nuttx/pull/1754) ESP32: Add + support for external SPIFLASH + + * [PR-1613](https://github.com/apache/incubator-nuttx/pull/1613) ESP32: Add + function for switching CPU from 80MHz to 240MHz + +PR-1712 ESP32: Add support for external MMCSD card over SPI + +#### IMXRT + + * [PR-1868](https://github.com/apache/incubator-nuttx/pull/1868) IMXRT: Add ADC + driver + +#### Kinetis + + * [PR-1624](https://github.com/apache/incubator-nuttx/pull/1624) Kinetis: + USBHOST improvements to avoid race condition durring freeing for queue head + structure by using Async Advance Doorbell. + +PR-1516 Kinetis K28: Add support for USB High Speed Host + +PR-1531 Kinetis K28: Add USB state change notifiers in notifier work queue + +PR-1456 Kinetis K28: Reworked USB driver for setup out data phase + + + +#### NRF52 + + * [PR-1418](https://github.com/apache/incubator-nuttx/pull/1418) NRF52: Add + Timer and RTC drivers + + * [PR-1432](https://github.com/apache/incubator-nuttx/pull/1422) NRF52: Add + timer lowerhalf + + * [PR-1635](https://github.com/apache/incubator-nuttx/pull/1635) NRF52: Add + support for RTC event handling + + * [PR-1636](https://github.com/apache/incubator-nuttx/pull/1636) NRF52: Add + support for PPI peripheral + + * [PR-1681](https://github.com/apache/incubator-nuttx/pull/1681) NRF52: Add + support for GPIOTE task mode + + * [PR-1726](https://github.com/apache/incubator-nuttx/pull/1726) NRF52: Extend + systimer support + + * [PR-1773](https://github.com/apache/incubator-nuttx/pull/1773) NRF52: Add ADC + and PWM support + + * [PR-1915](https://github.com/apache/incubator-nuttx/pull/1915) NRF52: Add + serial termios support (no flow control) + + * [PR-1907](https://github.com/apache/incubator-nuttx/pull/1907) NRF52: Add + basic error handing for i2c in polling mode to support i2ctool. Still not + handled in DMA mode. + + * [PR-1839](https://github.com/apache/incubator-nuttx/pull/1839) NRF52: Add + missing SPI callback register hooks to support drivers like mmcsd + + * [PR-1646](https://github.com/apache/incubator-nuttx/pull/1646) NRF52: Better + differentiation between NRF52840 and NRF52832 + +PR-1685 NRF52: Add ARM system reset support. Add UID support. + +PR-1674 NRF52: Add LFCLK/HFCLK support for selecting oscillator sources. + +#### RISCV + + * [PR-1858](https://github.com/apache/incubator-nuttx/pull/1858) RISCV: Add + missing CSR macros listed in RISC-V spec V1.10. + +PR-1314 rv32im: Add schedulesigaction.c, SYS\_save\_context handling, skip ECALL +instruction when calling up\_swint() + +#### RX65N + + * [PR-1622](https://github.com/apache/incubator-nuttx/pull/1622) RX65N: Add + I2C(RIIC) support + + * [PR-1894](https://github.com/apache/incubator-nuttx/pull/1894) RX65N: Add USB + device support + + * [PR-1899](https://github.com/apache/incubator-nuttx/pull/1899) RX65N: Add DTC + driver + +PR-1910 RX65N: Add SPI driver support + +#### SAMD5E5 + + * [PR-1515](https://github.com/apache/incubator-nuttx/pull/1515) SAMD5E5: Add + Watchdog timer support + + * [PR-1574](https://github.com/apache/incubator-nuttx/pull/1574) SAMD5E5: Add + USB host support + + * [PR-1594](https://github.com/apache/incubator-nuttx/pull/1594) SAMD5E5: + Freerun timer, oneshot timer and tickless support + + * [PR-1816](https://github.com/apache/incubator-nuttx/pull/1816) SAMD5E5: Add + MTD progmem support and NVM USER PAGE IOTCLs + +#### SAMA5D2 + +PR-1412 SAMA5D27: Implement system reset to support nsh reboot command + +PR-1393 SAMA5D2x: Implement SDMMC peripheral support + +#### S32K + +PR-1339 S32K: Extend FlexTimer support and add support for PWM + +PR-1337 S32K: Allow FlexCAN to use to NETDEV\_LATEINIT to handle the case where +both FlexCAN and ENET are used + +#### SIM + * [PR-1914](https://github.com/apache/incubator-nuttx/pull/1914) SIM: SIGUSR1 + handling now uses NuttX interrupt logic + + * [PR-1859](https://github.com/apache/incubator-nuttx/pull/1859) ESIM: Add + host timer and improve the oneshot timer logic + + * [PR-1767](https://github.com/apache/incubator-nuttx/pull/1767) SIM: Allow + access to tty interfaces for better termios support + + * [PR-1655](https://github.com/apache/incubator-nuttx/pull/1655) SIM: Add + support for Linux HCI Socket as a NuttX BLE adapter. Full NuttX BLE stack can + be run against any Linux Bluetooth adapter in sim. + + * [PR-1558](https://github.com/apache/incubator-nuttx/pull/1558) SIM: Add + support for Stack Smashing Protector. + + * [PR-1392](https://github.com/apache/incubator-nuttx/pull/1392) SIM: Make + uClibc++ and libcxx work on sim platform + + * [PR-1460](https://github.com/apache/incubator-nuttx/pull/1460) SIM: Call + sched\_note\_cpu\_\* when scheduler instrumentation is enabled + +#### STM32 + + * [PR-1865](https://github.com/apache/incubator-nuttx/pull/1865) STM32F4: Add + support for STM32F412CE fixing I2C2/I2C3 and USART1 alt + + * [PR-1506](https://github.com/apache/incubator-nuttx/pull/1506) STM32: Add + support for single wire UART push/pull mode + + * [PR-1572](https://github.com/apache/incubator-nuttx/pull/1572) STM32F2/F4: + Add options for I-Cache and D-Cache to be enabled/disable. Previously they were + always enabled. + + * [PR-1287](https://github.com/apache/incubator-nuttx/pull/1286) STM32F7: + Refactor the FMC driver to support STM32F7 family and add support to the + STM32F46G-DISCO board + + * [PR-1275](https://github.com/apache/incubator-nuttx/pull/1275) STM32: Allow + SysTick to be a tickless clock source option + + * [PR-1268](https://github.com/apache/incubator-nuttx/pull/1268) STM32: Add + support for STM32F412 with UART / SPI / CAN / I2C / DMA + + * [PR-1250](https://github.com/apache/incubator-nuttx/pull/1250) STM32L4: Add + support for booting into DFU mode + +### Bug Fixes + +#### ARM + + * [PR-1562](https://github.com/apache/incubator-nuttx/pull/1562) ARM: Save + tcb-adj\_stack\_size should be saved without tls overhead + + * [PR-1900](https://github.com/apache/incubator-nuttx/pull/1900) ARM: Fix false + reporting for stack usage for unaligned stacks + +#### AVR + + * [PR-1410](https://github.com/apache/incubator-nuttx/pull/1410) avr: Implement + missing double\_t type, CONFIG\_STACK\_ALIGNMENT, linker emulation flags + +#### CXD56xx + + * [PR-1930](https://github.com/apache/incubator-nuttx/pull/1930) cxd56xx: Fix + handle\_irqreq() in cxd56\_cpupause.c + + * [PR-1789](https://github.com/apache/incubator-nuttx/pull/1789) cxd56xx: Fix + deadlock issue in up\_txinit() in SMP mode. + + * [PR-1620](https://github.com/apache/incubator-nuttx/pull/1620) cxd56xx: Fix + IRQ control in cxd56\_dmac.c + + * [PR-1253](https://github.com/apache/incubator-nuttx/pull/1253) cxd56xx: Fix + audio cxd56\_stop where a deadlock could be hit if the worker thread took too + long to turn on AMP + + * [PR-1950](https://github.com/apache/incubator-nuttx/pull/1950) cxd56xx: Fix + deadlock and tcb corruption in SMP mode + +#### ESP32 + + * [PR-1908](https://github.com/apache/incubator-nuttx/pull/1908) ESP32: Fix + task signal process preemption + + * [PR-1941](https://github.com/apache/incubator-nuttx/pull/1941) ESP32: Fix + interrupt clearing of edge interrupt due to issuing in masking interrupt state + +#### IMXRT + + * [PR-1527](https://github.com/apache/incubator-nuttx/pull/1527) IMXRT: Fix + kconfig so that IMXRT\_ENET\_NRXBUFFERS can be set + + * [PR-1455](https://github.com/apache/incubator-nuttx/pull/1455) IMXRT: Fix + auto-negotiation for KSZ8081 PHY + +#### Kinetis + + * [PR-1273](https://github.com/apache/incubator-nuttx/pull/1273) Kinetis: Fix + issue in ethernet driver where buffers were blindly initialized and could cause + the TX of the MAC to be in a bad state. Also resolves an issue with interrupts + being throttled in the NVIC. + +#### NRF52 + + * [PR-1928](https://github.com/apache/incubator-nuttx/pull/1928) NRF52: Fix PPI + group disable and add group clear + + * [PR-1885](https://github.com/apache/incubator-nuttx/pull/1885) NRF52: Fix SPI + driver structures when SPI\_EXCHANGE is not set + + * [PR-1799](https://github.com/apache/incubator-nuttx/pull/1799) NRF52: Fix + SPI\_MASTER entry in kconfig + + * [PR-1787](https://github.com/apache/incubator-nuttx/pull/1787) NRF52: Fix + base address for SPIM{1,2,3} + + * [PR-1777](https://github.com/apache/incubator-nuttx/pull/1777) NRF52: Handle + case where rx or tx buffer could be 0 but data would still be transferred. Also + error if more than max data is requested. + + * [PR-1770](https://github.com/apache/incubator-nuttx/pull/1770) NRF52: Fix bug + where SPI cmddata was not properly mapped for SPIM 0,2,3 + +#### RISC-V + + * [PR-1909](https://github.com/apache/incubator-nuttx/pull/1909) RISC-V: MIE + instead of MPIE register was being used in up\_schedule\_sigaction for storing + interrupt state + +#### SIM + + * [PR-1903](https://github.com/apache/incubator-nuttx/pull/1903) SIM: Fix + complication issue for WPCAP in Cygwin build + + * [PR-1888](https://github.com/apache/incubator-nuttx/pull/1888) SIM: Fix + EOVERFLOW returned when CONFIG\_SIM\_M32 is set + + * [PR-1709](https://github.com/apache/incubator-nuttx/pull/1709) SIM: Fix + up\_cpu\_start initialization for macOS with SMP enabled + +#### STM32 + + * [PR-1898](https://github.com/apache/incubator-nuttx/pull/1898) STM32F7: Fixes + data loss bug in UART5 with TX DMA + + * [PR-1841](https://github.com/apache/incubator-nuttx/pull/1841) STM32: Remove + broken overdriver support + + * [PR-1719](https://github.com/apache/incubator-nuttx/pull/1719) STM32: + Lowputc: Ensure USART is disabled before attempting to configuring it + + * [PR-1714](https://github.com/apache/incubator-nuttx/pull/1714) STM32H7: Fix + I2C driver interrupt storm + + * [PR-1556](https://github.com/apache/incubator-nuttx/pull/1556) STM32: Fix IO + compentation support in STM32F7 and remove incorrect reference in STM32F0/L0/G0 + + * [PR-1529](https://github.com/apache/incubator-nuttx/pull/1529) STM32: Fix + initialization bug in ADC that prevented adc\_reset() from working correctly + + * [PR-1561](https://github.com/apache/incubator-nuttx/pull/1561) STM32: Make + sure that core over-drive is enabled for all chips that support it and operating + at 180MHz. Some were enabled at 180MHz but may have not been stable without + over-drive not configured. + + * [PR-1553](https://github.com/apache/incubator-nuttx/pull/1553) STM32F7: Fix + possible interrupt blocking in serial TXDMA ISR + + * [PR-1544](https://github.com/apache/incubator-nuttx/pull/1544) STM32: Make + sure IO compensation cell is configured prior to call to + rcc\_enableperipherals() causing syscfg is accessed before it is enabled + + * [PR-1380](https://github.com/apache/incubator-nuttx/pull/1380) STM32F7: Fix + tickless driver where th compare register could be set to a value that has + just passed preventing expiration + + * [PR-1252](https://github.com/apache/incubator-nuttx/pull/1252) STM32L4: Fix + 48MHz MSI clock selection that could cause boot to hang + + * [PR-1310](https://github.com/apache/incubator-nuttx/pull/1310) STM32L4: + Configure flash wait states earlier to prevent corruption of execution state + + * [PR-1248](https://github.com/apache/incubator-nuttx/pull/1248) STM32L4: Fix + oneshot timer so that a minimum period is set otherwise it will never be + triggered. + + * [PR-1247](https://github.com/apache/incubator-nuttx/pull/1247) STM32L47x/8x: + Set additional registers required to place a pin in analog mode + + * [PR-1246](https://github.com/apache/incubator-nuttx/pull/1246) STM32L4: Fix + issue where clock divider for serial baud rate was not set correctly + +#### Miscellaneous + + * [PR-1912](https://github.com/apache/incubator-nuttx/pull/1912) Fix + up\_interrupt\_contex() in case of SMP - Make sure the operation is atomic in + case of SMP + +## Driver Support + +### Bug Fixes + + * [PR-1896](https://github.com/apache/incubator-nuttx/pull/1896) spi\_xx25xx + EEPROM: return the number of bytes written instead of 0 or error + + * [PR-1891](https://github.com/apache/incubator-nuttx/pull/1891) serial: Don't + mangle PID when ISIG is changed + + * [PR-1856](https://github.com/apache/incubator-nuttx/pull/1856) pipe: In case + of empty pipe with no writers, return EOF instead of EAGAIN + + * [PR-1836](https://github.com/apache/incubator-nuttx/pull/1836) stmpe811: Fix + incorrect GPIO interrupt register logic + + * [PR-1741](https://github.com/apache/incubator-nuttx/pull/1741) mmcsd\_sdio: + Properly arm the write completion detection + + * [PR-1370](https://github.com/apache/incubator-nuttx/pull/1370) can: Fix + incorrect usage of nxsem\_getvalue which caused fifo->rx\_sem to increase with + teach received msg + + * [PR-1452](https://github.com/apache/incubator-nuttx/pull/1452) lcd: Fix + memory leak when board\_graphics\_setup fail + + + +### New Driver Support + + * [PR-1797](https://github.com/apache/incubator-nuttx/pull/1797) leds: WS2812 + LED controller (aka Adafruit NeoPixel) + + * [PR-1851](https://github.com/apache/incubator-nuttx/pull/1851) kbd: Add + support for SolderParty BlackBerry Q10 Keyboard + + * [PR-1618](https://github.com/apache/incubator-nuttx/pull/1618) BQ27426 fuel + gauge + + * [PR-1276](https://github.com/apache/incubator-nuttx/pull/1276) Add support + for the ST7735 TFT Controller + + * [PR-1233](https://github.com/apache/incubator-nuttx/pull/1233) usbhost: Add + support for CDC-MBIM USB host driver + +### Drivers With Significant Improvements + + * [PR-1816](https://github.com/apache/incubator-nuttx/pull/1816) stmpe811: Add + SPI support for touch screen controller + + * [PR-1800](https://github.com/apache/incubator-nuttx/pull/1800) vfs: Add + `FIOCLEX/FIONCLEX` ioctl support + + * [PR-1798](https://github.com/apache/incubator-nuttx/pull/1798) mmcsd: Allow + setting `IDMODE_CLOCK` via kconfig + + * [PR-1587](https://github.com/apache/incubator-nuttx/pull/1587) BCH: Delay the + sector flush to avoid multiple erase/write operations in sequence write + + * [PR-1577](https://github.com/apache/incubator-nuttx/pull/1577) rwbuffer: + Avoid allocating memory for the temporary erase buffer by the FTL driver + + * [PR-1466](https://github.com/apache/incubator-nuttx/pull/1466) Altair Modem: + Add board specific logic, Fix issue that SPI4 RX frequency violated AC Spec, + Fix priority of SPI transfer task is too low, Modify timeout value for RX ready + + * [PR-1471](https://github.com/apache/incubator-nuttx/pull/1471) ramlog: Add + option to overwrite buffer + + * [PR-1547](https://github.com/apache/incubator-nuttx/pull/1547) usbhub: Make + sure to enumerate hubs that report protocol = 1 (High Speed Hub) + + * [PR-1374](https://github.com/apache/incubator-nuttx/pull/1374) gpio: Extend + gpio\_pintype\_e for pulldown/up and opendrain + + * [PR-1249](https://github.com/apache/incubator-nuttx/pull/1249) bmp280: Add + support for reading temperature + + * [PR-1299](https://github.com/apache/incubator-nuttx/pull/1299) mpu60x0: Add + I2C support for the MPU60x0 sensor driver + + * [PR-1325](https://github.com/apache/incubator-nuttx/pull/1325) can: expose + NART/ABOM and RTR settings via ioctls + + * [PR-1520](https://github.com/apache/incubator-nuttx/pull/1520) note: Move + note driver from syslog to drivers/note + + * [PR-1288](https://github.com/apache/incubator-nuttx/pull/1288) / PR-1449 + note: Add sched\_note\_syscall\_enter/leave hooks for syscall instrumentation + + * [PR-1259](https://github.com/apache/incubator-nuttx/pull/1259) note: Add + buffering support for syscall instrumentation + + * [PR-1256](https://github.com/apache/incubator-nuttx/pull/1256) note: Add + hooks for note driver for interrupt instrumentation + +Board Support ------------- + +### **Significant Improvements** + + * [PR-1618](https://github.com/apache/incubator-nuttx/pull/1618) metro-m4: Add + support for: SmartFS initialization, AT24 EEPROM, GPIO dev, BQ27426 gauge + initialization + + * [PR-1727](https://github.com/apache/incubator-nuttx/pull/1729) b-g474e-dpow1: + Add support for FLASH bootloader + + * [PR-1683](https://github.com/apache/incubator-nuttx/pull/1683) cxd56xx: Add + wifi\_smp configuration + + * [PR-1668](https://github.com/apache/incubator-nuttx/pull/1668) sim: Add new + configuration for SMP + + * [PR-1644](https://github.com/apache/incubator-nuttx/pull/1644) + stm32f746g-disco: Move serial console from USART6 to USART1 which is attached + to the USB virtual COM port. + + * [PR-1464](https://github.com/apache/incubator-nuttx/pull/1464) cxd56xx: Add + new GNSS functions, support for lower PWM frequency, + CONFIG\_CPUFREQ\_RELEASE\_LOCK, high speed ADC, HPADC input gain configuration, + eMMC device, frame buffer support + + * [PR-1405](https://github.com/apache/incubator-nuttx/pull/1405) + stm32f4discovery: Add ELF support to wifi configuration + + * [PR-1402](https://github.com/apache/incubator-nuttx/pull/1402) imxrt1060: Add + buttons support to iMXRT1060 + + * [PR-1590](https://github.com/apache/incubator-nuttx/pull/1590) sim: Add + duktape configuration + + * [PR-1532](https://github.com/apache/incubator-nuttx/pull/1532) sim: Add + cromfs configuration + + * [PR-1335](https://github.com/apache/incubator-nuttx/pull/1335) cxd56xx: + Enable basic snapshop camera example + +### New Board Support + + * [PR-1664](https://github.com/apache/incubator-nuttx/pull/1664) NRF52: Add + support for NRF52832 MakerDiary MDK board + + * [PR-1633](https://github.com/apache/incubator-nuttx/pull/1633) NRF52: Add + support for Sparkfun NRF52832 Breakout Board + + * [PR-1728](https://github.com/apache/incubator-nuttx/pull/1728) SAMA5D27: Add + support for Giant Board + + * [PR-1397](https://github.com/apache/incubator-nuttx/pull/1397) EOSS3: Initial + support for the QuickLogic EOS S3 SoC QuickFeather board + + * [PR-1268](https://github.com/apache/incubator-nuttx/pull/1268) STM32: Add + support for nucleo-f412zg board + +File System ----------- + +### **Bug Fixes** + + * [PR-1796](https://github.com/apache/incubator-nuttx/pull/1796) vfs: Fix + memory leak calling `pseudorename` + + * [PR-1794](https://github.com/apache/incubator-nuttx/pull/1794) vfs: Fix issue + where opendir would remove the trailing whitespace or / + + * [PR-1793](https://github.com/apache/incubator-nuttx/pull/1793) vfs: Make sure + that rename of mount point uses pseudorename. Previously mv on a mountpoint + would return err 88. + + * [PR-1737](https://github.com/apache/incubator-nuttx/pull/1737) vfs: reuse + file\_dup2 direction in file\_dup to prevent segfault issue + + * [PR-1490](https://github.com/apache/incubator-nuttx/pull/1490) Ensure that + filesystems can all support paths that end with '/' + + * [PR-1546](https://github.com/apache/incubator-nuttx/pull/1546) ROMFS: Fix + issue with how hard links are followed for ROMFS + + * [PR-1442](https://github.com/apache/incubator-nuttx/pull/1442) SmartFS: Fix + file size corruption when opening with overwriting mode + + * [PR-1431](https://github.com/apache/incubator-nuttx/pull/1431) nxffs: Fix + scan good block slowly and scan an invalid block + +PR-1295 fs: for setfd correct the return value + +### **Significant Improvements** + + * [PR-1554](https://github.com/apache/incubator-nuttx/pull/1554) CROMFS: Add + support for hard links + + * [PR-1499](https://github.com/apache/incubator-nuttx/pull/1499) FAT: Add + support for UTF8 long filename + + * [PR-1479](https://github.com/apache/incubator-nuttx/pull/1479) vfs: Add file + descriptor based events support eventfd() + + * [PR-1582](https://github.com/apache/incubator-nuttx/pull/1482) vfs: Add + epoll\_create1() support + + * [PR-1579](https://github.com/apache/incubator-nuttx/pull/1579) vfs: Do not + check CONFIG\_NFILE\_STREAMS for mkdir/rename/rmdir/fs\_unlink + + * [PR-1355](https://github.com/apache/incubator-nuttx/pull/1355) vfs: Implement + statvfs and fstatvfs + + * [PR-1323](https://github.com/apache/incubator-nuttx/pull/1323) vfs: Add + chmod/fchmod/utimes function prototypes + +Networking ---------- + +### **Bug Fixes** + + * [PR-1267](https://github.com/apache/incubator-nuttx/pull/1267) SocketCAN: + When timestamped frame was received while in CAN2.0B mode the frame got dropped. + + * [PR-1446](https://github.com/apache/incubator-nuttx/pull/1446) usrsock: Fix + recv() cannot peek data + +### **Significant Improvements** + + * [PR-1666](https://github.com/apache/incubator-nuttx/pull/1666) Bluetooth: + Bluetooth sockets now use Linux sockaddr types of sockaddr\_l2 sockaddr\_hci + sockaddr\_rc. There are slight breaking changes here that may require + applications to be updated, but this brings the interface inline with Linux. + + * [PR-1581](https://github.com/apache/incubator-nuttx/pull/1581) Socket: Add + SOCK\_CLOEXEC/SOCK\_NONBLOCK support + + * [PR-1443](https://github.com/apache/incubator-nuttx/pull/1443) usrsock: Add + flag argument to sendto/recvfrom interface in usrsock + + * [PR-1238](https://github.com/apache/incubator-nuttx/pull/1238) SocketCAN: Add + support for SocketCAN interface API + +Applications ------------ + +### **Significant Improvements** + + * [PR-409](https://github.com/apache/incubator-nuttx-apps/pull/409) wamr: + Update version to 09-29-2020 that supports NuttX directly and remove patches + + * [PR-407](https://github.com/apache/incubator-nuttx-apps/pull/407) ipcfg: Add + IPv4 configuration file access helper + + * [PR-406](https://github.com/apache/incubator-nuttx-apps/pull/406) wamr: Add + configs for heap pool and custom name sections + + * [PR-404](https://github.com/apache/incubator-nuttx-apps/pull/404) timer: Add + supplying timer dev path to example + + * [PR-403](https://github.com/apache/incubator-nuttx-apps/pull/402) + nxplayer/nxrecorder: Add channel map support + + * [PR-396](https://github.com/apache/incubator-nuttx-apps/pull/396) wamr: Add + missing options to kconfig + + * [PR-395](https://github.com/apache/incubator-nuttx-apps/pull/395) dhcpc: Try + to get hostname via syscall first + + * [PR-391](https://github.com/apache/incubator-nuttx-apps/pull/391) wapi: Add + option to assocated directly via bssid + + * [PR-390](https://github.com/apache/incubator-nuttx-apps/pull/390) wapi: App + option to scan partial channel + + * [PR-387](https://github.com/apache/incubator-nuttx-apps/pull/387) wamr: Add + support for WAMR web assembly interpreter + + * [PR-337](https://github.com/apache/incubator-nuttx-apps/pull/337) docs: + Convert all README files to markdown + + * [PR-333](https://github.com/apache/incubator-nuttx-apps/pull/333) webclient: + Add hooks for TLS, extra request headers, PUT method, report status code, + improved error handling + + * [PR-329](https://github.com/apache/incubator-nuttx-apps/pull/329) gpio: Add + support for new GPIO pin types + + * [PR-317](https://github.com/apache/incubator-nuttx-apps/pull/317) nshlib: + Call symlink if user pass -s for ln command + + * [PR-315](https://github.com/apache/incubator-nuttx-apps/pull/315) c++: + Support uClibc++ and libcxx in examples/testing + + * [PR-314](https://github.com/apache/incubator-nuttx-apps/pull/314) camera: Add + a simple camera snapshot example + + * [PR-378](https://github.com/apache/incubator-nuttx-apps/pull/378) wasm3: + Initial WebAssembly runtime support + + * [PR-374](https://github.com/apache/incubator-nuttx-apps/pull/374) bluetooth: + Use the new l2cap socket address type + + * [PR-373](https://github.com/apache/incubator-nuttx-apps/pull/373) duktape: + Add duktape to global search path so it can be used as a library + + * [PR-372](https://github.com/apache/incubator-nuttx-apps/pull/372) quickjs: + Add support for QuickJS interpreter + + * [PR-367](https://github.com/apache/incubator-nuttx-apps/pull/367) nsh: Accept + the command line arguments like sh + + * [PR-365](https://github.com/apache/incubator-nuttx-apps/pull/365) duktape: + Add console, print, alert support + + * [PR-364](https://github.com/apache/incubator-nuttx-apps/pull/364) cu: + Refactor cu and add support for "-c" to disable \\n to \\r\\n conversion + + * [PR-362](https://github.com/apache/incubator-nuttx-apps/pull/362) libuv: Add + support for libuv library + + * [PR-352](https://github.com/apache/incubator-nuttx-apps/pull/352) duktape: + Add initial support for duktape + + * [PR-346](https://github.com/apache/incubator-nuttx-apps/pull/364) wget: + Enable URL from command line, can be used with ifup, hooks for HTTPS + + * [PR-302](https://github.com/apache/incubator-nuttx-apps/pull/302) lvgl: Use + the latest version 7.0.2 + + * [PR-300](https://github.com/apache/incubator-nuttx-apps/pull/300) note: Add + support for decoding interrupt and syscall instrumentation + + * [PR-299](https://github.com/apache/incubator-nuttx-apps/pull/299) nxrecorder: + Add O\_TRUNC when creating a file + + * [PR-296](https://github.com/apache/incubator-nuttx-apps/pull/296) bmp280: Add + support for BMP180 to BMP280 application + + * [PR-294](https://github.com/apache/incubator-nuttx-apps/pull/294) can: Add + cansend and candump utilities for interacting with SocketCAN + +### Bug Fixes + + * [PR-411](https://github.com/apache/incubator-nuttx-apps/pull/411) wgetjson: + Fix build breakage + + * [PR-405](https://github.com/apache/incubator-nuttx-apps/pull/405) nxplayer: + Fix missing "%d" in a sscanf call + + * [PR-400](https://github.com/apache/incubator-nuttx-apps/pull/400) dhcpc: + Handle case where gethostname() might be empty + + * [PR-399](https://github.com/apache/incubator-nuttx-apps/pull/399) build: Fix + build system issue where compiler would only compile first assembly file + + * [PR-393](https://github.com/apache/incubator-nuttx-apps/pull/393) build: Fix + build system issue where ARCHCPUFLAGS in cxx command was lost + + * [PR-392](https://github.com/apache/incubator-nuttx-apps/pull/392) wapi: Make + wapi more robust in failure cases + + * [PR-383](https://github.com/apache/incubator-nuttx-apps/pull/383) ntpclient: + Fix NTP daemon state in case of DNS failure + + * [PR-344](https://github.com/apache/incubator-nuttx-apps/pull/344) gs2200m: + Fix freeing of uninitialized memory + + * [PR-335](https://github.com/apache/incubator-nuttx-apps/pull/335) ntp: Fix + malformated authentication headers in NTP packet + + * [PR-331](https://github.com/apache/incubator-nuttx-apps/pull/331) telnetd: + Fix buffer overflow issue clearing socket address + + * [PR-312](https://github.com/apache/incubator-nuttx-apps/pull/312) build: Make + sure to include incdir when running make export + + * [PR-377](https://github.com/apache/incubator-nuttx-apps/pull/377) readline: + Fix stack overflow when application name is too long + + * [PR-359](https://github.com/apache/incubator-nuttx-apps/pull/259) nshlib: Fix + memory corrupt in nsh\_parse if pthread\_create() failed + + * [PR-354](https://github.com/apache/incubator-nuttx-apps/pull/354) dhcpd: Fix + member name for "ds\_pid" + +## Security Issues Fixed In This Release + +## Compatibility Concerns + +## Changes to Build System + +### In Apps, Change `$(TOPDIR)` to `$(APPDIR)` + +In the 'apps' repo, Makefiles are now using `$(APPDIR)` instead of `$(TOPDIR)`. + +In your custom app's Makefile, it is recommended to change `$(TOPDIR)` to +`$(APPDIR)`. + +Replace this line: + +include $(TOPDIR)/Make.defs + +With this: + +include $(APPDIR)/Make.defs + +See * [PR-326](https://github.com/apache/incubator-nuttx-apps/pull/326), git +commit # +`[deaa6c5b7bf8445b4a300691525f60aa506be0d7](https://github.com/apache/incubator-nuttx-apps/commit/deaa6c5b7bf8445b4a300691525f60aa506be0d7)` +in the NuttX 'apps' repository. + +### Custom Boards Don't Need `ARCHINCLUDES` and `ARCHXXINCLUDES` Definitions + +As part of an effort to unify support for uClibc++ and libc++, the C/C++ include +search path definitions `ARCHINCLUDES` and `ARCHXXINCLUDES` are now defined in +one central place in `tools/Config.mk`. It is no longer necessary to define +these in every board's `scripts/Make.defs`. Boards included in the NuttX +repository have been updated, but if you are building NuttX for a custom board +and are using C++, you may want to make the following changes: + +In your board's configuration, ensure that you have enabled either +`CONFIG_UCLIBCXX` or `CONFIG_LIBCXX` as appropriate. + +In your custom board's `scripts/Make.defs` file, remove lines like these: + +CINCPATH := ${shell $(INCDIR) -s "$(CC)" $(TOPDIR)$(DELIM)include} CXXINCPATH := +${shell $(INCDIR) -s "$(CC)" $(TOPDIR)$(DELIM)include$(DELIM)cxx} ARCHINCLUDES ++= $(CINCPATH) ARCHXXINCLUDES += $(CINCPATH) $(CXXINCPATH) + +In case your `scripts/Make.defs` uses different names, such as `ARCHINCLUDESXX` +instead of `ARCHXXINCLUDES`, you'll need to find all uses of that variable and +update them to use `ARCHXXINCLUDES`. + +See * [PR-1396](https://github.com/apache/incubator-nuttx/pull/1396), git +commit +#[d32e9c38dfb0659a7f3c0cf586ba1584cd7eb3d6](https://github.com/apache/incubator-nuttx/commit/d32e9c38dfb0659a7f3c0cf586ba1584cd7eb3d6) +in the main NuttX repository. + +See also * [PR-1399](https://github.com/apache/incubator-nuttx/pull/1399), git +commit +#[6abd03d53ff9164fb17ea4aca701a49fbbf751c0](https://github.com/apache/incubator-nuttx/commit/6abd03d53ff9164fb17ea4aca701a49fbbf751c0). + +### Custom Boards Don't Need `HOSTCC` and `HOSTCFLAGS` Definitions + +The NuttX build system uses several binary utilities that it compiles and runs +on the host computer. To build these binaries, it needs to know the host C +compiler and C flags. Previously, every board's `scripts/Make.defs` file had to +provide this information via `HOSTCC` and `HOSTCFLAGS` Definitions. As part of +an effort to simplify the build system, these definitions are now automatically +provided by logic in `tools/Config.mk`. Boards included in the NuttX repository +have been updated, but if you are building NuttX for a custom board, you may +want to make the following changes: + +In your custom board's `scripts/Make.defs` file, remove lines like these: + +HOSTCC = gcc HOSTCFLAGS = -Wall -Wstrict-prototypes -Wshadow -Wundef -g -pipe + +Sometimes they may look like this: + +ifeq ($(CONFIG\_WINDOWS\_NATIVE),y) +  HOSTCC = mingw32-gcc.exe +else +  HOSTCC = gcc +endif + +Note: These changes are OPTIONAL. + +You may still set these definitions in your board's scripts/Make.defs, and your +definitions will override the ones in tools/Config.mk. + +Also, you may override these definitions for a single run by providing them on +the make command line. This is useful if, for example, you wish to build debug +versions of these host binaries: define HOSTCFLAGS with -g on the command line. + +See * [PR-1398](https://github.com/apache/incubator-nuttx/pull/1398), git +commit +#[ee875b2a260cb4cc532b8ca303c2515e24c39b4e](https://github.com/apache/incubator-nuttx/commit/ee875b2a260cb4cc532b8ca303c2515e24c39b4e) +in the main NuttX repository. + +### Removal of Unused `ARCHCCVERSION` and `ARCHCCMAJOR` + +The ARCHCCVERSION and ARCHCCMAJOR variables are unused. Historically they were +defined in many boards' scripts/Make.defs. These were removed from all boards in +the NuttX repository, but if you are building NuttX for a custom board, you may +want to remove this unnecessary boilerplate. + +In your custom board's `scripts/Make.defs` file, remove lines like these: + + + +ARCHCCVERSION = ${shell $(CC) -v 2>&1 | sed -n '/^gcc version/p' | sed -e +'s/^gcc version \\(\[0-9\\.\]\\)/\\1/g' -e 's/\[-\\ \].\*//g' -e '1q'} +ARCHCCMAJOR = ${shell echo $(ARCHCCVERSION) | cut -d'.' -f1} + +See * [PR-1344](https://github.com/apache/incubator-nuttx/pull/1344), git +commit +#[f5311de6b42466ab5c6ef299dab0ecc417131bbe](https://github.com/apache/incubator-nuttx/commit/f5311de6b42466ab5c6ef299dab0ecc417131bbe) +in the main NuttX repository. + +### Custom Boards May Not Need `EXTRA_LIBS` and `EXTRA_LIBPATHS` Definitions + +The `EXTRA_LIBS` and `EXTRA_LIBPATHS` make variables were previously defined in +many boards' `scripts/Make.defs` files. These are now defined in a more central +location: `arch/*/src/*/Toolchain.defs`. Your board's `scripts/Make.defs` +usually includes this file. Boards included in NuttX have been updated, but if +you are building NuttX for a custom board, you may need to update your board's +`scripts/Make.defs` file to ensure you build with the correct definitions. + +If you have lines like these: + +EXTRA\_LIBPATHS = -L "${shell dirname "$(LIBSUPXX)"}" EXTRA\_LIBS = -lsupc++ + +You may want to do one of the following: + +*   If they are redundant to the definitions provided in the included +`arch/*/src/*/Toolchain.defs`, remove these lines, or *   If they contain +additional needed libraries and paths not present in +`arch/*/src/*/Toolchain.defs`, remove any redundant definitions and change the +assignment '`=`' to '`+=`'. + +See * [PR-1404](https://github.com/apache/incubator-nuttx/pull/1404), git +commit +#[4910d43ab0fc360dbddb1f8a31db2a3ee383b46d](https://github.com/apache/incubator-nuttx/commit/4910d43ab0fc360dbddb1f8a31db2a3ee383b46d) +in the main NuttX repository. + +### Custom Boards May Not Need CC, CXX, CPP, LD, STRIP, AR, NM, OBJCOPY, and +OBJDUMP Definitions + +These `make` variables were previously defined in many boards' scripts/Make.defs +files with copy-paste duplication spanning many hundreds of files. These are now +defined in a more central location: `arch/*/src/*/Toolchain.defs`. Your board's +`scripts/Make.defs` usually includes this file. Boards included in NuttX have +been updated, but if you are building NuttX for a custom board, you may need to +update your board's `scripts/Make.defs` file to ensure you build with the +correct definitions. + +If you have lines that define `CC`, `CXX`, `CPP`, `LD`, `STRIP`, `AR`, `NM`, +`OBJCOPY`, and `OBJDUMP`, such as these: + +CC = $(CROSSDEV)gcc CXX = $(CROSSDEV)g++ CPP = $(CROSSDEV)gcc -E -P -x c LD = +$(CROSSDEV)ld STRIP = $(CROSSDEV)strip --strip-unneeded AR = $(ARCROSSDEV)ar rcs +NM = $(ARCROSSDEV)nm OBJCOPY = $(CROSSDEV)objcopy OBJDUMP = $(CROSSDEV)objdump + + + +You may want to do one of the following: + +*   If they are redundant to the definitions provided in the included +`arch/*/src/*/Toolchain.defs`, remove these lines, or *   If they are different +from the definitions in `arch/*/src/*/Toolchain.defs`, leave them as-is and they +will take precedence. + +See * [PR-1426](https://github.com/apache/incubator-nuttx/pull/1426), git +commit +#[b329e2377dd8816f37ad0408279926829efdf85d](https://github.com/apache/incubator-nuttx/commit/b329e2377dd8816f37ad0408279926829efdf85d) +in the main NuttX repository. + +### Consolidated ARCROSSDEV and CROSSDEV + +The `ARCROSSDEV` and `CROSSDEV` variables always had identical values. Therefore +`ARCROSSDEV` has been removed and `CROSSDEV` is used instead. Boards included in +NuttX have been updated, but if you are building NuttX for a custom board, you +may need to update your board's build scripts to use the `CROSSDEV` variable. + +See * [PR-1439](https://github.com/apache/incubator-nuttx/pull/1439), git +commit +#[5efa93ec26fd8a3fd85b24a2008bb743f96027fb](https://github.com/apache/incubator-nuttx/commit/5efa93ec26fd8a3fd85b24a2008bb743f96027fb) +in the main NuttX repository.