Open
Description
The GSM library included as part of the core is accessible for all users of the Arduino IDE who have a board with a supported architecture
attached. There are several issues with this file from a User perspective:
ArduinoCore-mbed/libraries/GSM/library.properties
Lines 1 to 9 in dd5abb6
- The GSM library inside the mbed core (this repo) as well as the standalone GSM library have the same name field
- The version number has stayed static at
version=1.0
since this file was created. Since then potentially breaking changes have been made, such as bed5201. - The value for
sentence
isGSM wrapper
which does little to convey what this library does. As I understand from the commits, this library includes compiler directives specifically to provide functionality for the Portenta Edge Control.ArduinoCore-mbed/libraries/GSM/examples/GSMSSLClient/GSMSSLClient.ino
Lines 14 to 16 in dd5abb6
sentence
field must be a sentence explaining the purpose of the library - The
paragraph
field is empty - The
category
field is set toOther
, whileCommunication
seems more reasonable - The
url
field links to http://www.arduino.cc/en/Reference/GSM . This is the same url mentioned in arduino-libraries/GSM.
url=http://www.arduino.cc/en/Reference/GSM
Additional considerations
- Even though the library is part of the core and the
sentence
as well asparagraph
fields are not directly visible in the IDE, making sure the library is documented helps with contributors. - The standalone GSM library has exactly the same name (i.e. is also included in the sketch via
#include "GSM.h"
) - According to http://www.arduino.cc/en/Reference/GSM, the library is for the
Arduino GSM Shield
(red) andis archived and is no longer maintained
(green). However, upon deeper inspection this seems to be regarding the arduino-libraries/GSM. The statementThe GSM Library is included with [Arduino IDE 1.0.4 and later](https://www.arduino.cc/en/Main/Software).
(blue) is however correct for the GSM library included inside the core and NOT the standalone library