33694a1fcc
* Migrate RP2040-specific bits to separate dirs * Add chip to boards.txt, isolate RP2040-specifics * Add RP2350 boot2, bearssl, and libraries * Platform.IO adjust to new paths * Add RPIPICO2 JSON for P.IO * Add RP2350 to Platform.io * Update Picotool and OpenOCD for all hosts * Use picotool to generate UF2s * Build separate libpico blobs serially Thanks for the review, @aarturo182 ! * Add RP2350 to CI * Allow Ethernet/WiFi building for RP2350 * Update Adafruit TinyUSB to latest * Test skip fix * Make RP2350 Picotool work. update USB ID * Fix EEPROM/FS flash locations RP2350 adds a 4K header sector to the UF2, meaning we have 4K less total flash to work with. Adjust all constants appropriately on the RP2350. * Adds ilabs board and PSRAM support. (#2342) * Adds iLabs boards and basic PSRAM support. * Make PSRAM come up as part of chip init Uses SparkFun psram.cpp to set timings on clocks which are defined in the variant file. Prefix things with RP2350_PSRAM_xxx for sanity. Users don't need to call anything, PSRAM "just appears". Still need to add in malloc-type allocation. * Add board SparkFun ProMicro RP2350 Same pinout as the SparkFun ProMicro RP2040 with 8MB PSRAM and RP2350 * Add TLSF library for use w/PSRAM Fork of upstream to include add'l C++ warning fixes. * Add pmalloc/pcalloc to use PSRAM memory free() and realloc() all look at the pointer passed in and jump to the appropriate handler. Also takes care of stopping IRQs and taking the malloc mutex to support multicore and FreeRTOS (when that workd) * Fix BOOTSEL for RP2350 * Add simple rp2040.idleOtherCore test * Add Generic RP2350 and clean up PSRAM menus Commercial boards now only have 1 size PSRAM, no need to have menu for them. * Add Solder Party RP2350 Stamp boards (#2352) * Add PSRAM heap info helpers, mutex lock mallinfo * Add RP2350 docs * FreeRTOS and OTA unsupported warnings for RP2350
51 lines
1.9 KiB
ReStructuredText
51 lines
1.9 KiB
ReStructuredText
FreeRTOS SMP
|
|
============
|
|
|
|
**NOTE:** FreeRTOS is not yet supported on the RP2350. PRs gladly accepted!
|
|
|
|
The SMP (multicore) port of FreeRTOS is included with the core. This allows complex
|
|
task operations and real preemptive multithreading in your sketches. While the
|
|
``setup1`` and ``loop1`` way of multitasking is simplest for most folks, FreeRTOS
|
|
is much more powerful.
|
|
|
|
Enabling FreeRTOS
|
|
-----------------
|
|
|
|
To enable FreeRTOS, simply add
|
|
|
|
.. code:: c++
|
|
|
|
#include <FreeRTOS.h>
|
|
|
|
to your sketch and it will be included and enabled automatically.
|
|
|
|
Configuration and Predefined Tasks
|
|
----------------------------------
|
|
|
|
FreeRTOS is configured with 8 priority levels (0 through 7) and a process for
|
|
``setup()/loop()``, ``setup1()/loop1()``, and the USB port will be created. The task
|
|
quantum is 1 millisecond (i.e. 1,000 switches per second).
|
|
|
|
``setup()`` and ``loop()`` are assigned to only run on core 0, while ``setup1()`` and ``loop1()``
|
|
only run in core 1 in this mode, the same as the default multithreading mode.
|
|
|
|
You can launch and manage additional processes using the standard FreeRTOS routines.
|
|
|
|
``delay()`` and ``yield()`` free the CPU for other tasks, while ``delayMicroseconds()`` does not.
|
|
|
|
Caveats
|
|
-------
|
|
|
|
While the core now supports FreeRTOS, most (probably all) Arduino libraries were not written
|
|
to support preemptive multithreading. This means that all calls to a particular library should
|
|
be made from a single task.
|
|
|
|
In particular, the ``LittleFS`` and ``SDFS`` libraries can not be called from different
|
|
threads. Do all ``File`` operations from a single thread or else undefined behavior
|
|
(aka strange crashes or data corruption) can occur.
|
|
|
|
More Information
|
|
----------------
|
|
|
|
For full FreeRTOS documentation look at `FreeRTOS.org <https://freertos.org/index.html>`__
|
|
and `FreeRTOS SMP support <https://freertos.org/symmetric-multiprocessing-introduction.html>`__.
|