Merge pull request 'docs: Doxy-API-et-diagramme-API' (#25) from docs/Doxy-API-et-diagramme-API into master

Reviewed-on: https://gitea.cb85.software/Epitech-T-DEV-811/T-DEV-811/pulls/25
Reviewed-by: nico <nicolas.sansd@gmail.com>
Reviewed-by: Guska <gildas.gonzalez@epitech.eu>
This commit is contained in:
Clement 2023-04-11 13:53:42 +02:00
commit 9a77d3163f
5 changed files with 2775 additions and 10 deletions

1
.gitignore vendored Normal file
View File

@ -0,0 +1 @@
IOT/docs/doxygen output/*

2740
IOT/docs/Doxyfile Normal file

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,24 @@
@startuml Class Diagram
Class API {
- user: String
- password: String
- serveurHost: String
- https: bool
- client: WiFiEspClient*
- connect(): bool
+ API(user: String, password: String, host: String, https: bool = true)
+ wifiBegin(wifiId: String, wifiPass: String, espSerial: Stream*): bool
+ sendValue(val: String, pouvelleID: String, unit: String, full: bool): bool
}
Class Program {
+ Program()
+ setup()
}
@enduml

View File

@ -21,25 +21,25 @@ public:
/** /**
* @brief Initialise la connection Wifi de l'esp * @brief Initialise la connection Wifi de l'esp
* *
* @param wifiId nom du wifi * @param[in] wifiId nom du wifi
* @param wifiPass mot de passe du wifi * @param[in] wifiPass mot de passe du wifi
* @param espSerial port serie de l'esp (hard ou soft) * @param[in] espSerial port serie de l'esp (hard ou soft)
* @return true la connexion a bien fonctionner * @return true la connexion a bien fonctionner
* @return false erreur a la connexion * @return false erreur a la connexion
*/ */
bool wifiBegin(String wifiId, String wifiPass, Stream* espSerial); bool wifiBegin(String wifiID, String wifiPass, Stream* espSerial);
/** /**
* @brief envoie la valeur d'un capteur de poubelle à l'api * @brief envoie la valeur d'un capteur de poubelle à l'api
* *
* @param val valeur du capteur * @param[in] val valeur du capteur
* @param poubelleID ID de la poubelle * @param[in] poubelleID ID de la poubelle
* @param unit uniter de mesure du capteur *(ex: g, cm, degree,...) * @param[in] unit uniter de mesure du capteur *(ex: g, cm, degree,...)
* @param full poubelle est considéré comme pleine * @param[in] full poubelle est considéré comme pleine
* @return true la valeur s'est bien envoyer * @return true la valeur s'est bien envoyer
* @return false il y a une erreur durran l'envoie * @return false il y a une erreur durran l'envoie
*/ */
bool sendValute(String val, String poubelleID, String unit, bool full); bool sendValue(String val, String poubelleID, String unit, bool full);
private: private:

View File

@ -81,7 +81,7 @@ bool API::connect(){
return sortie; return sortie;
} }
bool API::sendValute(String val, String poubelleID, String valUnit, bool full){ bool API::sendValue(String val, String poubelleID, String valUnit, bool full){
JSONVar data; JSONVar data;
data["value"] = val; data["value"] = val;
data["trash_id"] = poubelleID; data["trash_id"] = poubelleID;