Bar: 1 version importeret

2022-10-21T12:36:37Z

1 version importeret

← Ældre version	Versionen fra 21. okt. 2022, 14:36
(Ingen forskel)

htx_>Bar: /* Eksempel på hele koden */

2020-12-03T21:45:32Z

Eksempel på hele koden

Ny side

{{template:WeMOS-software}}
Den grundlæggende ide i denne kode er at sende en kommando fra den serielle monitor, og via WeMOS WiFi sende en henvendelse til en webserver<ref>[https://techtutorialsx.com/2016/07/17/esp8266-http-get-requests/ Get HTTP request]</ref> med et lille PHP-script, der kan sende en mail, med et indhold bestem af det der er indtastet i Serial Monitor
==Forbindelse til WiFi==
Selve forbindelsen til WiFi er lavet som beskrevet ved [[WeMOS Server Connection]], og skal blot etablere forbindelsen til WiFi netværket.

For at den samlede kode kan fungere, så skal det netværk der forbindes til have forbindelse til internettet, så man kan komme i kontakt med webserveren med PHP-scriptet.

==Opsætning til HTTP-request==
For at man kan sende en besked til webserveren, så skal man have adgange til HTTP-request biblioteket, og der skal oprettes at HTTP-objekt.

Dette sker i følgende kode:
<source lang="C">
#include <ESP8266HTTPClient.h>

HTTPClient http;

int httpCode;
</source>
==Webserver henvendelse==
For at henvende sig til webserveren på simpel vis anvendes GET-metoden. Hvis man skulle gøre det med større sikkerhed, så skulle man anvende POST-metoden<ref>[https://techtutorialsx.com/2016/07/21/esp8266-post-requests/ Webserver POST requests]</ref>, og man burde også sikre webserveren med et login - det er ikke gjort i dette eksempel.

Selve webserveren har en http-adresse, der angives i en variabel som vist her:
<source lang="C">
const String serverAddress = "http://htx-elev.ucholstebro.dk/HX-class/user/"; // Webserverens URL

String stringToSend = serverAddress; // Serveradressen der skal henvendes til
</source>
På Holstebro HTX har vi webserver på adressen htx-elev.ucholstebro.dk, hvor man kan uploade sine scipts, når holdet er oprettet med de brugere der er på holdet. Serveren har installeret en mailserver, så man kan sende mails fra scriptet. Webserveren er nærmere beskrevet på [http://htx-elev.ucholstebro.dk/docs/htx-srv.pdf Beskrivelse af htx-elev Webserver].

Man kan naturligvis også anvende andre webservere, hvis de understøtter PHP og har en mailserver tilknyttet.

Inde på webserveren ligger PHP-filen, som skal tilføjes henvendelsen som vist her:
<source lang="C">
stringToSend += "sendMail.php?send="; // Filnavnet og parameter-navn
</source>
Der tilføjes også navnet på parameteren (send).

Endelig tages et input fra den serielle monitor, og der sikres at det kun er selve det indtastede man tager med. Dette tilføjes henvendelsen:
<source lang="C">
String param = Serial.readStringUntil('\n'); // Læs en hel streng
param.trim(); // Fjern mellemrum og linjeskift fra start og slut
stringToSend += param; // Indholdet der skal sendes
</source>

Herefter foretages selve henvendelsen til webserveren med en HTTP-henvendelse:
<source lang="C">
http.setTimeout(2000); // Use 2 seconds timeout for HTTP connection
http.begin(stringToSend); // Start HTTP connection and send HTTP header
</source>

==Connection response==
Henvendelsen til webserveren giver en respons, som man skal tjekke for at se om henvendelsen gik godt.

Dette returnerer en kode:
<source lang="C">
httpCode = http.GET(); // Get response from HTTP request
</source>

Henvendelsen giver også en respons, der her udskrives til seriel monitor
<source lang="C">
if(httpCode > 0) // httpCode will be negative on error
{
Serial.printf("[HTTP] GET... code: %d\n", httpCode); // Response from server is not an error
if(httpCode == HTTP_CODE_OK) { // Response from server is HTTP CODE 200
String payload = http.getString();
Serial.println(payload);
}
} else {
Serial.printf("[HTTP] GET... failed, error: %s\n", http.errorToString(httpCode).c_str());
}
http.end();
</source>

Efter endt henvendelse lukkes forbindelsen igen.

==Eksempel på hele koden==
<source lang="C">
#include <ESP8266WiFi.h>
#include <ESP8266HTTPClient.h>

HTTPClient http;

int httpCode;

const String serverAddress = "http://htx-elev.ucholstebro.dk/HX-hold/user/"; // Webserverens URL

const char* ssid = "ssid-name";
const char* password = "ssid-password";

WiFiServer server(80);

void setup() {
Serial.begin(115200);
delay(10);

// Connect to WiFi network
Serial.println();
Serial.println();
Serial.print("Connecting to ");
Serial.println(ssid);

WiFi.begin(ssid, password);

while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println("");
Serial.println("WiFi connected");

// Start the server
server.begin();
Serial.println("Server started");

// Print the IP address
Serial.print("Use this URL : ");
Serial.print("http://");
Serial.print(WiFi.localIP());
Serial.println("/");

}

void loop() {
String stringToSend = serverAddress; // Serveradressen der skal henvendes til
if (Serial.available()) {
stringToSend += "sendMail.php?send="; // Filnavnet og parameter-navn

String param = Serial.readStringUntil('\n'); // Læs en hel streng
param.trim(); // Fjern mellemrum og linjeskift fra start og slut
stringToSend += param; // Indholdet der skal sendes

http.setTimeout(2000); // Use 2 seconds timeout for HTTP connection
http.begin(stringToSend); // Start HTTP connection and send HTTP header

httpCode = http.GET(); // Get response from HTTP request

if (httpCode > 0) // httpCode will be negative on error
{
Serial.printf("[HTTP] GET... code: %d\n", httpCode); // Response from server is not an error
if (httpCode == HTTP_CODE_OK) { // Response from server is HTTP CODE 200
String payload = http.getString();
Serial.println(payload);
}
} else {
Serial.printf("[HTTP] GET... failed, error: %s\n", http.errorToString(httpCode).c_str());
}
http.end();
}
}
</source>

==PHP-kode==
Inde på webserveren placeres et lille PHP-script, der ser ud som følger. Scriptet udnytter PHP's mail-funktion<ref>[http://php.net/manual/en/function.mail.php mail-funktionen i PHP]</ref>.
<source lang="PHP">
<?php
/*
* Mail example
* Bent Arnoldsen, Holstebro HTX 2018
*
* Aktiveres med domæne/path/sendMail.php?send=Alarm
*/
if (isset($_GET['send'])) {
if ($_GET['send'] == "Alarm") {
mail("mail@domain.dk", "Mail fra Alarmsystem", "Der er Alarm");
} else if ($_GET['send'] == "Open") {
mail("mail@domain.dk", "Mail fra Alarmsystem", "Der er Open");
} else {
mail("mail@domain.dk", "Mail fra Alarmsystem", "Ikke specificeret");
}
}
?>
<html>
<h2>Mail-System</h2>
</html>
</source>

==Referencer==
<references />
[[Kategori:WeMOS]]

WeMOS Mail - Versionshistorie

Bar: 1 version importeret

htx_>Bar: /* Eksempel på hele koden */