Release 2.1.0

* Add the released 2.0.0 version to the package index JSON

Also add the new and upcoming 2.1.0 version for local installs

* Bump the core version to 2.1.0

* Initialize the ADC input pin correctly

Without setting the ADC pin explicitly as an input we got
strange behavior on some of the pins.
Fixes #96

* remove debug print

* Add AES CCM support to the BLE variants

* Add NVM3 support to the 'no radio' variants

* Generate SDK files for the BLE and 'no radio' variants

* Implement NumberOfPrimaries support for Matter Color Control

* Implement direct copying to the 'variants' folder in the GSDK generator script

Also add wildcard configurations for the different protocol stacks

* Adjust Matter attribute permissions, add new write handlers

The following attributes received a write permission
and a write handler:
 - IdentifyTime (Identify)
 - Options (LevelControl)
 - OnLevel (LevelControl)
 - StartUpCurrentLevel (LevelControl)
 - Options (ColorControl)

* Add FeatureMap and ClusterRevision to the Matter Descriptor cluster

These attributes were previously missing.
Handling of these attributes is taken care of by the
Descriptor cluster implementation in the Matter SDK.

* Add write handler for Matter OnOff cluster GlobalSceneControl

Also change the default value for GlobalSceneControl to 'true'

* Refactor Matter Lightbulb cluster write handling

Also add helping comments to the read handling in the same style

* Use the correct device type for the Matter Color Lightbulb

DEVICE_TYPE_DIMMABLE_LIGHT was used instead of DEVICE_TYPE_EXTENDED_COLOR_LIGHT

* Add option to disable the Matter Bridge endpoint

It's enabled by default - disabling it only works on Google,
Apple and Amazon won't talk to the device if it's disabled

* Implement Groups cluster support for Matter Lightbulb devices

* Make StartUpOnOff a writable Matter Lightbulb attribute

* Add extra constraint protection to Matter LevelControl CurrentLevel

* Make Matter LevelControl CurrentLevel nullable

* Remove the explicit ClusterRevision attribute from all Matter clusters

The ClusterRevision attribute is auto added by
DECLARE_DYNAMIC_ATTRIBUTE_LIST_END, so adding it explicitly
creates a duplicate.

* Remove Matter Groups cluster command responses from the command list

These were added by mistake, their ID collides with the
non-response counterpart.

* Add outgoing commands for the Matter Groups cluster

These commands will populate the GeneratedCommandList

* Make the Matter LevelControl OnLevel attribute nullable

* Allow 255 as a valid Matter LevelControl CurrentLevel value

255 represents NULL, so it should be allowed to be written

* Make Matter LevelControl StartUpCurrentLevel nullable

* Introduce WRITABLE_NULLABLE attribute mask for Matter clusters

This simplifies cluster attribute definitions

* Add lower bound check to Matter LevelControl SetLevel

* Add function to get the Matter onboarding QR code payload

* Correct the default CPU frequency to 39 MHz

* Implement Matter device change callback

 - Add callback handling to the lightbulb classes
 - Add an example showing callback usage

* Integrate the Matter device change callback to all compatible devices

These are: Fan, OnOffPluginUnit, Switch, Thermostat, WindowCovering

* Update the Matter library readme with the callback function description

* Implement Matter decommissioning API

Also add an example showing how to decommission a device

* Add setter/getter for Matter On/Off cluster StartupOnOff

* Change the type of Matter Groups NameSupport attribute to INT8U

* Implement 'Toggle' and 'null' value handling for Matter OnOff StartUpOnOff

Also make the StartupOnOff attribute nullable

* Implement support for Matter Door Lock

* Add device change callback to the Matter Door Lock

* split BLE variants in two: BLE (only bluetooth controller) and BLE Silabs (with bluetooth silabs host stack)

* Update the build tests to work with the new BLE variants

* Update the readme and examples to reflect the BLE variant changes

* Rename the Arduino BLE variants to 'BLE (Arduino)'

* Rework Matter device change callback behavior

Now the callback fires on every change not just changes from the
Matter network. Now all devices will call the callback upon changing
if registered. This change was implemented to ensure a consistent
behavior from the callback.

* Add support for the 'Ezurio Lyra 24P 20' board

* Adjust the section labels in boards.txt

* add EEPROM library (using NVM3 APIs)

* Refactor the EEPROM driver to use 254 byte NVM3 objects

* Add EEPROM calls to the test sketch

* Update the user NVM size to 10k

* Use the global define for NVM3 object sizes in EEPROM lib

* platform.txt: properly escape openocd rules

Fixes upload errors on Nano Matter for Windows users with spaces in their username

* Add docs and pinout diagram for the Ezurio Lyra 24P

* Update the readme with debugging info for the Lyra 24P 20

* Implement 'suspend' and 'resume' for Serial

These functions help us to enter low power saving states

* Add the 'em_rmu' component to all variants

The Reset Management Unit is needed for low power functions

* Fix the Serial mapping on the xG24 Explorer Kit

The VCOM Serial is not exposed on the header - only Serial1

* Decrease NVM3 cache on the BGM220 Explorer Kit variants

The BGM220 has only 32k of RAM - this gives some additional memory
back to the users.

* Add a new Serial to the BGM220 Explorer Kit

Also update the pinout diagram to show Serial mappings correctly

* Remove the 'BLE (Arduino)' variant from the BGM220 Explorer Kit

Unfortunately the BGM220 doesn't have enough RAM to
reliably run the ArduinoBLE stack.

* Regenerate GSDK for the BGM220 Explorer Kit

NVM cache size change and new Serial added

* Fix the upload target in boards.txt for the Lyra24P

* Mark all the EM4 wakeup pins in the variant descriptions

* Mark all the EM4 wakeup pins on the pinout diagrams

* Add the ArduinoLowPower library

* Implement an 'escape_hatch' method to prevent EM4 bricking

This function will keep the devices awake when the on-board
button is pressed to prevent EM4 bricking.
The Silicon Labs boards board controller can handle this
situation however the Nano Matter's can't.
This 'escape_hatch' function will only be present when using the
ArduinoLowPower library.

* Make 'wokeUpFromDeepSleep()' work on all variants

* Fix keywords.txt alignment in ArduinoLowPower

* Mark BLE example compatibility for the 'Lyra 24P 20'

* Mark variables used in ISRs as volatile in BLE examples

* Fix the zero brightness edge case in ezWS2812

We were writing the input variables instead of the output

* Update the Matter readme with the Nano Matter OT RCP description

* Add the 'Arduino Matter Provision' tool

* Update the readme with the bundled libraries

* Make 'system_init_finished' read only with a getter

* Make the versioning of the included libraries consistent

All included libraries inherit the version of the core,
so we know which core release they're included in. Also, this
eliminates the need for separate versioning for each.

* Implement missing fan speed related attributes in MatterFan

This increases compatibility with Home Assistant

* Fix typo in the Matter flow sensor example

---------

Co-authored-by: Leonardo Cavagnis <45899760+leonardocavagnis@users.noreply.github.com>
Co-authored-by: Leonardo Cavagnis <l.cavagnis@arduino.cc>
Co-authored-by: Martino Facchin <m.facchin@arduino.cc>

Author: 3 people

boards.txt

@@ -55,6 +55,7 @@ extern "C" {
   #endif // SL_CATALOG_BLUETOOTH_PRESENT
 
   #include "em_common.h"
+  #include "em_rmu.h"
   #include "app_assert.h"
   #include "em_gpio.h"
   #include "app_log.h"
@@ -103,4 +104,8 @@ typedef enum _dac_channel_t dac_channel_t;
 void analogWrite(dac_channel_t dac_channel, int value);
 void analogWriteResolution(int resolution);
 
+bool get_system_init_finished();
+uint32_t get_system_reset_cause();
+void escape_hatch();
+
 #endif // ARDUINO_H

bootloaders/lyra24p20-bootloader-storage-internal-single-512k.hex

@@ -96,7 +96,7 @@ void attachInterruptParam(PinName interruptNumber, voidFuncPtrParam callback, Pi
 
 void attachInterrupt(PinName interruptNumber, voidFuncPtr callback, PinStatus mode)
 {
-  if (interruptNumber >= PIN_NAME_MAX || callback == nullptr || mode < LOW || mode > RISING || !system_init_finished) {
+  if (interruptNumber >= PIN_NAME_MAX || callback == nullptr || mode < LOW || mode > RISING || !get_system_init_finished()) {
     return;
   }
 

cores/silabs/Arduino.h

@@ -40,7 +40,9 @@ UARTClass::UARTClass(sl_iostream_t* stream,
                      void(*deinit_fn)(void),
                      void(*serial_event_fn)(void)) :
   serial_mutex(nullptr),
-  initialized(true)
+  initialized(true),
+  baudrate(115200),
+  suspended(false)
 {
   this->serial_mutex = xSemaphoreCreateMutexStatic(&this->serial_mutex_buf);
   configASSERT(this->serial_mutex);
@@ -57,11 +59,10 @@ void UARTClass::begin(unsigned long baudrate)
   if (this->initialized) {
     return;
   }
-  //#ifndef ARDUINO_MATTER
   this->init_fn();
   this->baud_rate_set_fn(baudrate);
   this->initialized = true;
-  //#endif // ARDUINO_MATTER
+  this->baudrate = baudrate;
 }
 
 void UARTClass::begin(unsigned long baudrate, uint16_t config)
@@ -72,6 +73,9 @@ void UARTClass::begin(unsigned long baudrate, uint16_t config)
 
 void UARTClass::end()
 {
+  if (!this->initialized) {
+    return;
+  }
   this->deinit_fn();
   this->initialized = false;
 }
@@ -122,6 +126,26 @@ void UARTClass::printf(const char *fmt, ...)
   this->write((uint8_t*)message, strlen(message));
 }
 
+void UARTClass::suspend()
+{
+  if (!this->initialized) {
+    return;
+  }
+  // The small delay is here to allow the last bytes to be transmitted
+  delay(1);
+  this->end();
+  this->suspended = true;
+}
+
+void UARTClass::resume()
+{
+  if (!this->suspended) {
+    return;
+  }
+  this->begin(this->baudrate);
+  this->suspended = false;
+}
+
 UARTClass::operator bool()
 {
   return true;

cores/silabs/Interrupt.cpp

@@ -63,6 +63,8 @@ class UARTClass : public HardwareSerial
   void task();
   void handleSerialEvent();
   void printf(const char* fmt, ...);
+  void suspend();
+  void resume();
 private:
   static const uint8_t printf_buffer_size = 128u;
 
@@ -80,6 +82,8 @@ class UARTClass : public HardwareSerial
   sl_iostream_uart_t* instance_handle;
 
   bool initialized;
+  unsigned long baudrate;
+  bool suspended;
 };
 } // namespace arduino
 

cores/silabs/Serial.cpp

@@ -33,7 +33,6 @@ void tone(uint8_t _pin, unsigned int frequency, unsigned long duration)
   if (pin_name == PIN_NAME_NC) {
     return;
   }
-  Serial.println("qui tutto ok");
   tone(pin_name, frequency, duration);
 }
 

cores/silabs/Serial.h

@@ -40,6 +40,9 @@ AdcClass::AdcClass() :
 
 void AdcClass::init(PinName pin, uint8_t reference)
 {
+  // Set up the ADC pin as an input
+  pinMode(pin, INPUT);
+
   // Create ADC init structs with default values
   IADC_Init_t init = IADC_INIT_DEFAULT;
   IADC_AllConfigs_t all_configs = IADC_ALLCONFIGS_DEFAULT;

cores/silabs/Tone.cpp

@@ -33,15 +33,25 @@ static const uint32_t arduino_task_priority = 1u;
 static StackType_t arduino_task_stack[arduino_task_stack_size] = { 0 };
 static StaticTask_t arduino_task_buffer;
 static TaskHandle_t arduino_task_handle;
-bool system_init_finished = false;
+static bool system_init_finished = false;
+static uint32_t system_reset_cause = 0u;
 
 int main()
 {
+  // Save the reset cause
+  system_reset_cause = RMU_ResetCauseGet();
+  // The Matter SDK also gets the reset cause and clears it after, so we need to avoid clearing it here on Matter
+  #ifndef ARDUINO_MATTER
+  RMU_ResetCauseClear();
+  #endif
+
   // Board specific init - in most cases it's just a call to sl_system_init(),
   // but when using the Matter stack it needs a more complex init process
   init_arduino_variant();
   system_init_finished = true;
 
+  escape_hatch();
+
   arduino_task_handle = xTaskCreateStatic(arduino_task,
                                           "arduino_task",
                                           arduino_task_stack_size,
@@ -76,3 +86,18 @@ inline static void handle_serial_events()
   Serial1.handleSerialEvent();
   #endif // #if (NUM_HW_SERIAL > 1)
 }
+
+bool get_system_init_finished()
+{
+  return system_init_finished;
+}
+
+uint32_t get_system_reset_cause()
+{
+  return system_reset_cause;
+}
+
+SL_WEAK void escape_hatch()
+{
+  ;
+}

cores/silabs/adc.cpp

@@ -70,7 +70,7 @@ void setCPUClock(cpu_clock_t clock)
 {
   CMU_DPLLInit_TypeDef pll_init;
   switch (clock) {
-    case CPU_40MHZ:
+    case CPU_39MHZ:
       CMU_CLOCK_SELECT_SET(SYSCLK, HFXO);
       return;
     case CPU_76MHZ: