diff --git a/docs/apichanges.md b/docs/apichanges.md index d3106cd4..f43327b2 100644 --- a/docs/apichanges.md +++ b/docs/apichanges.md @@ -4,27 +4,34 @@ API Changes {#apichanges} Here's a list of other API changes made to the library that break source/binary compatibility between releases: + * **grove** Starting with UPM 1.0 the Grove libraries have been renamed + from *upm-grove* to simply *upm-*. Class names also match this new + format, with old classes marked as deprecated throughout the documentation. + List of affected libraries: grovecollision, groveehr, groveeldriver, + groveelectromagnet, groveemg, grovegprs, grovegsr, grovelinefinder, grovemd, + grovemoisture, groveo2, grovescam, grovespeaker, groveultrasonic, grovevdiv, + grovewater, grovewfs. * **grove** As of UPM 1.0 the Grove classes for sensors in the starter kit are being separated into individual libraries. The old classes will be deprecated over time and eventually removed. Corresponding libraries have the grove prefix removed. Affected classes are GroveButton, GroveLed, GroveLight, GroveRelay, GroveRotary, GroveSlide and GroveTemp. + * The **ublox6** driver has been replaced with a generic implementation called + nmea_gps as of UPM 1.0. This driver should handle all generic serial GPS + devices that output NMEA data going forward. This new driver has been tested + with ublox6, DFRobot VK2828U7 (ublox7) and ublox LEA-6H GPS devices. * **grove** Binary compatibility was broken for the GroveTemp class as of UPM - v0.7.3. C++ samples and code using this class has to be recompiled. - * The Ublox6 driver has been removed and replaced with a generic - implementation called nmea_gps. This driver should handle all - generic serial GPS devices that output NMEA data going forward. This - new driver has been tested with ublox6, DFRobot VK2828U7 (ublox7) and - ublox LEA-6H GPS devices. + v0.7.3. C++ code using this class has to be recompiled. * There were frequent misspellings of the word *Celsius* in the UPM code. In some cases, these were in method names, which will cause some API compatibility issues. These have all been corrected for UPM versions after v.0.7.2. * Our **C++ header files** changed their extension from *.h* to *.hpp* in version 0.7.0, Intel provided examples and code samples also reflect this - change but you will need to modify your `#include` directives in existing code + change but you will need to modify your `#include` directives in existing + code. * **my9221**, **groveledbar** and **grovecircularled** are now all part of the - same library (my9221) and new functionality was added going to v.0.5.1 - * **stepmotor** driver API was changed significantly from v.0.4.1 to v.0.5.0 + same library (my9221) and new functionality was added going to v.0.5.1. + * **stepmotor** driver API was changed significantly from v.0.4.1 to v.0.5.0. * **eboled** library was greatly improved in version 0.4.0 and the `draw()` - function was removed in favor of a more complete GFX library implementation + function was removed in favor of a more complete GFX library implementation. diff --git a/src/grovecollision/grovecollision.hpp b/src/grovecollision/grovecollision.hpp index 57b93f61..a3c84f99 100644 --- a/src/grovecollision/grovecollision.hpp +++ b/src/grovecollision/grovecollision.hpp @@ -27,6 +27,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-collision * @brief Grove Collision Sensor library * @defgroup grovecollision libupm-grovecollision * @ingroup seeed gpio accelerometer @@ -39,6 +40,7 @@ namespace upm { * @type accelerometer * @man seeed * @con gpio + * @deprecated This class is being replaced by Collision * * @brief API for the Grove Collision Sensor * diff --git a/src/groveehr/groveehr.hpp b/src/groveehr/groveehr.hpp index 371fe83f..a5188797 100644 --- a/src/groveehr/groveehr.hpp +++ b/src/groveehr/groveehr.hpp @@ -30,6 +30,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-ehr * @brief Grove Ear-clip Heart Rate Sensor library * @defgroup groveehr libupm-groveehr * @ingroup seeed gpio medical @@ -42,6 +43,7 @@ namespace upm { * @type medical * @man seeed * @con gpio + * @deprecated This class is being replaced by EHR * * @brief API for the Grove Ear-clip Heart Rate Sensor * diff --git a/src/groveeldriver/groveeldriver.hpp b/src/groveeldriver/groveeldriver.hpp index 7ed7963b..119f40a8 100644 --- a/src/groveeldriver/groveeldriver.hpp +++ b/src/groveeldriver/groveeldriver.hpp @@ -30,6 +30,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-eldriver * @brief Grove EL Driver Module library * @defgroup groveeldriver libupm-groveeldriver * @ingroup seeed gpio electric @@ -42,6 +43,7 @@ namespace upm { * @type electric * @man seeed * @con gpio + * @deprecated This class is being replaced by ElDriver * * @brief API for the Grove EL Driver Module * diff --git a/src/groveelectromagnet/groveelectromagnet.hpp b/src/groveelectromagnet/groveelectromagnet.hpp index c39ae4ca..12460c05 100644 --- a/src/groveelectromagnet/groveelectromagnet.hpp +++ b/src/groveelectromagnet/groveelectromagnet.hpp @@ -30,6 +30,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-electromagnet * @brief Grove Electromagnet library * @defgroup groveelectromagnet libupm-groveelectromagnet * @ingroup seeed gpio electric @@ -42,6 +43,7 @@ namespace upm { * @type electric * @man seeed * @con gpio + * @deprecated This class is being replaced by Electromagnet * * @brief API for the Grove Electromagnet * diff --git a/src/groveemg/groveemg.hpp b/src/groveemg/groveemg.hpp index eef5fa34..640fd3da 100644 --- a/src/groveemg/groveemg.hpp +++ b/src/groveemg/groveemg.hpp @@ -28,6 +28,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-emg * @brief Grove EMG Muscle Signal Reader library * @defgroup groveemg libupm-groveemg * @ingroup seeed analog electric @@ -40,6 +41,7 @@ namespace upm { * @type electric * @man seeed * @con analog + * @deprecated This class is being replaced by EMG * * @brief API for the Grove EMG Muscle Signal Reader * diff --git a/src/grovegprs/grovegprs.hpp b/src/grovegprs/grovegprs.hpp index 1aa774f6..a91cb0f0 100644 --- a/src/grovegprs/grovegprs.hpp +++ b/src/grovegprs/grovegprs.hpp @@ -40,6 +40,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-gprs * @brief Grove GPRS Module library * @defgroup grovegprs libupm-grovegprs * @ingroup seeed uart wifi @@ -53,6 +54,7 @@ namespace upm { * @man seeed * @con uart * @web http://www.seeedstudio.com/wiki/GPRS_Shield_V2.0 + * @deprecated This class is being replaced by GPRS * * @brief API for the Grove GPRS Module * diff --git a/src/grovegsr/grovegsr.hpp b/src/grovegsr/grovegsr.hpp index 32666abf..a3737dca 100644 --- a/src/grovegsr/grovegsr.hpp +++ b/src/grovegsr/grovegsr.hpp @@ -28,6 +28,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-gsr * @brief Grove GSR Galvanic Skin Response Sensor library * @defgroup grovegsr libupm-grovegsr * @ingroup seeed analog electric @@ -40,6 +41,7 @@ namespace upm { * @type electric * @man seeed * @con analog + * @deprecated This class is being replaced by GSR * * @brief API for the Grove GSR Galvanic Skin Response Sensor * diff --git a/src/grovelinefinder/grovelinefinder.hpp b/src/grovelinefinder/grovelinefinder.hpp index 5e662a2e..d617c2e4 100644 --- a/src/grovelinefinder/grovelinefinder.hpp +++ b/src/grovelinefinder/grovelinefinder.hpp @@ -28,6 +28,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-linefinder * @brief Grove Line Finder Sensor library * @defgroup grovelinefinder libupm-grovelinefinder * @ingroup seeed gpio color robok @@ -41,6 +42,7 @@ namespace upm { * @man seeed * @con gpio * @kit robok + * @deprecated This class is being replaced by LineFinder * * @brief API for the Grove Line Finder Sensor * diff --git a/src/grovemd/grovemd.hpp b/src/grovemd/grovemd.hpp index 94834752..b8269e50 100644 --- a/src/grovemd/grovemd.hpp +++ b/src/grovemd/grovemd.hpp @@ -34,6 +34,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-md * @brief Grove I2C Motor Driver library * @defgroup grovemd libupm-grovemd * @ingroup seeed i2c motor robok @@ -47,6 +48,7 @@ namespace upm { * @man seeed * @con i2c * @kit robok + * @deprecated This class is being replaced by MD * * @brief API for the Grove I2C Motor Driver * diff --git a/src/grovemoisture/grovemoisture.hpp b/src/grovemoisture/grovemoisture.hpp index 2b08170e..6910c1aa 100644 --- a/src/grovemoisture/grovemoisture.hpp +++ b/src/grovemoisture/grovemoisture.hpp @@ -28,6 +28,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-moisture * @brief Grove Moisture Sensor library * @defgroup grovemoisture libupm-grovemoisture * @ingroup seeed analog liquid eak hak @@ -41,6 +42,7 @@ namespace upm { * @man seeed * @con analog * @kit eak hak + * @deprecated This class is being replaced by Moisture * * @brief API for the Grove Moisture Sensor * diff --git a/src/groveo2/groveo2.hpp b/src/groveo2/groveo2.hpp index 6ba48d23..b69fbd1b 100644 --- a/src/groveo2/groveo2.hpp +++ b/src/groveo2/groveo2.hpp @@ -28,6 +28,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-o2 * @brief Grove O2 Oxygen Gas Sensor library * @defgroup groveo2 libupm-groveo2 * @ingroup seeed analog gaseous @@ -40,6 +41,7 @@ namespace upm { * @type gaseous * @man seeed * @con analog + * @deprecated This class is being replaced by O2 * * @brief API for the Grove O2 Oxygen Gas Sensor * diff --git a/src/grovescam/grovescam.hpp b/src/grovescam/grovescam.hpp index a26cbeba..b23705b8 100644 --- a/src/grovescam/grovescam.hpp +++ b/src/grovescam/grovescam.hpp @@ -48,6 +48,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-scam * @brief Grove Serial Camera library * @defgroup grovescam libupm-grovescam * @ingroup seeed uart other @@ -61,6 +62,7 @@ namespace upm { * @man seeed * @con uart * @web http://www.seeedstudio.com/wiki/Grove_-_Serial_Camera_Kit + * @deprecated This class is being replaced by SCAM * * @brief API for the Grove Serial Camera * diff --git a/src/grovespeaker/grovespeaker.hpp b/src/grovespeaker/grovespeaker.hpp index 535dc484..06171664 100644 --- a/src/grovespeaker/grovespeaker.hpp +++ b/src/grovespeaker/grovespeaker.hpp @@ -33,6 +33,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-speaker * @brief Grove Speaker library * @defgroup grovespeaker libupm-grovespeaker * @ingroup seeed gpio sound hak @@ -54,6 +55,7 @@ typedef struct * @man seeed * @con gpio * @kit hak + * @deprecated This class is being replaced by Speaker * * @brief API for the Grove Speaker * diff --git a/src/groveultrasonic/groveultrasonic.hpp b/src/groveultrasonic/groveultrasonic.hpp index f571984e..89c13f92 100644 --- a/src/groveultrasonic/groveultrasonic.hpp +++ b/src/groveultrasonic/groveultrasonic.hpp @@ -36,6 +36,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-ultrasonic * @brief Grove ultrasonic sensor library * @defgroup groveultrasonic libupm-groveultrasonic * @ingroup seeed gpio sound @@ -48,6 +49,7 @@ namespace upm { * @type sound * @man seeed * @con gpio + * @deprecated This class is being replaced by UltraSonic * * @brief API for Grove Ultrasonic Ranger * diff --git a/src/grovevdiv/grovevdiv.hpp b/src/grovevdiv/grovevdiv.hpp index 9e93879d..0ff4695e 100644 --- a/src/grovevdiv/grovevdiv.hpp +++ b/src/grovevdiv/grovevdiv.hpp @@ -36,6 +36,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-vdiv * @brief Grove Voltage Divider Sensor library * @defgroup grovevdiv libupm-grovevdiv * @ingroup seeed analog electric robok @@ -49,6 +50,7 @@ namespace upm { * @man seeed * @con analog * @kit robok + * @deprecated This class is being replaced by VDiv * * @brief API for the Grove Voltage Divider Sensor * diff --git a/src/grovewater/grovewater.hpp b/src/grovewater/grovewater.hpp index 50e74b4e..0a6bfba6 100644 --- a/src/grovewater/grovewater.hpp +++ b/src/grovewater/grovewater.hpp @@ -28,6 +28,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-water * @brief Grove Water Sensor library * @defgroup grovewater libupm-grovewater * @ingroup seeed gpio liquid eak @@ -41,6 +42,7 @@ namespace upm { * @man seeed * @con gpio * @kit eak + * @deprecated This class is being replaced by Water * * @brief API for the Grove Water Sensor * diff --git a/src/grovewfs/grovewfs.hpp b/src/grovewfs/grovewfs.hpp index bec30dcb..7803b140 100644 --- a/src/grovewfs/grovewfs.hpp +++ b/src/grovewfs/grovewfs.hpp @@ -31,6 +31,7 @@ namespace upm { /** + * @deprecated This library is being replaced by libupm-wfs * @brief Grove Water Flow Sensor library * @defgroup grovewfs libupm-grovewfs * @ingroup seeed gpio liquid eak @@ -45,7 +46,8 @@ namespace upm { * @web http://www.seeedstudio.com/wiki/index.php?title=G1/2_Water_Flow_sensor * @con gpio * @kit eak - + * @deprecated This class is being replaced by WFS + * * @brief API for the Grove Water Flow Sensor * * This sensor is used to measure water flow in liters per