Questo blocco funzione da eseguire in task Back, implementai un server HTTP, è un blocco funzione protetto per utilizzarlo occorre richiedere il codice di protezione. E’ comunque possibile utilizzarlo liberamente in modo test per 30 Min, terminato il tempo il FB continuerà a funzionare ma non gestirà più le variabili pHeader e pRxData.
Attivando Enable è messo in ascolto sulla porta indicata in Port un server HTTP e sono accettate il numero di connessioni definito in AConnections. In HTTPBSize occorre definire la dimensione del buffer allocato con SysRMalloc per contenere i dati ricevuti in richiesta (Header e dati) ed il contenuto della pagina di risposta da inviare al client. In HPath occorre definire il percorso della cartella dove si trovano i files gestiti dal server. In PDefault occorre definire la pagina di default da visualizzare su richiesta del solo indirizzo IP del server.
Alla ricezione di una richiesta dal client si attiva RRcvd e sono valorizzati pPage con indirizzo stringa di definizione pagina richiesta, pHeader con indirizzo buffer memorizzazione header ricevuto, pRxData con indirizzo buffer dati di pagina ricevuti e RxDSize con la dimensione dei dati ricevuti. Se la pagina richiesta è presente nel percorso indicato in HPath, si attiverà anche RFFound.
Sulla attivazione di RRcvd il programma utente può controllare i dati ricevuti in richiesta e preparare i dati in risposta l’indirizzo và indicato in pTxData e la dimensione in TxDSize. Il programma utente deve definire l’header da inviare in risposta definendone l’indirizzo in Header (Vedi definizione). Attivando RAck verranno inviati sia l’header che i dati al client. Attivando RNAck verrà inviato al client solo il campo header.
In caso di errore si attiva per un loop l’uscita Fault, con la funzione SysGetLastError è possibile rilevare il codice di errore. Fare riferimento alla tabella elenco errori per la descrizione.
Approfondimenti
- In questo topic un programma per gestire allarmi su richieste GET da telecamera.
Descrizione
Enable (BOOL) Comando abilitazione server.
SpyOn (BOOL) Se attivo permette di spiare il funzionamento del FB (Vedi articolo).
RAck (BOOL) Settato da programma forza invio dell’header e dai dati di pagina.
RNack (BOOL) Settato da programma forza invio del solo header, non viene inviato nessun dato.
Port (UINT) Porta TCP su cui viene posto in ascolto il server, verificare che la porta non sia già utilizzata da un’altro servizio.
AConnections (USINT) Numero di connessioni HTTP contemporanee accettate.
HTTPBSize (UDINT) Dimensione buffer HTTP. Determina la dimensione massima dei dati HTTP, deve avere dimensione sufficente a contenere l’header ed i dati ricevuti.
HPath (@STRING) Percorso della cartella dove si trovano i files gestiti dal server. Su richiesta pagina viene ricercato il file in questa cartella, se presente viene ritornato al client, se non presente si attiva RRcvd per poter gestire la richiesta da programma.
PDefault (@STRING) Definizione pagina di default ritornata su richiesta del solo indirizzo IP.
Header (@STRING) Indirizzo stringa header, se NULL viene inviato l’header standard. E’ possibile definire parametri da inviare con l’header della risposta.
CORSHeader (@STRING) Definizione header richieste Cross-Origin.
StatusCode (@STRING) Definizione codice stato ritornato al client.
pTxData (@BYTE) Puntatore al buffer dati da trasmettere al client, non può essere allocato con SysRMAlloc. Alla attivazione di RAck viene inviato l’header seguito dai dati indicati.
TxDSize (UDINT) Dimensione dati da inviare al dient e caricati in buffer pTxData.
Timeout (REAL) Timeout esecuzione (S).
RRcvd (BOOL) Si attiva su ricezione richiesta HTTP, alla attivazione sono validi i dati in pPage, pHeader, pRxData e RxDSize. Si resetta alla attivazione di RAck o RNAck da programma utente.
Fault (BOOL) Attivo per un loop di programma se errore gestione.
RFFound (BOOL) Attvo se pagina richiesta è stata trovata in HPath ed è stata inviata al client.
pPage (@STRING) Puntatore al buffer che contiene pagina richiesta ricevuta dal client. Il dato è valido alla attivazione di RRcvd, rimane valido fino alla attivazione di RAck o RNAck.
pRMethod (@STRING) Indirizzo buffer che riporta metodo richiesta ricevuta dal client.
pHeader (@STRING) Puntatore al buffer che contiene header richiesta ricevuto dal client. Il dato è valido alla attivazione di RRcvd, rimane valido fino alla attivazione di RAck o RNAck.
pRxData (@BYTE) Puntatore al buffer dati ricevuti dal client su richieste GET, PUT, POST. Il dato è valido alla attivazione di RRcvd, rimane valido fino alla attivazione di RAck o RNAck.
RxDSize (UDINT) Dimensione dati ricevuti dal client.
CCounter (ARRAY[0..3]OF UDINT) Numero connessioni gestite su ogni connessione HTTP (Utilizzato per debug).
ECounter (UDINT) Numero di errori.
Spionaggio funzionamento
Se SpyOn attivo è possibile utilizzare la console di spionaggio per verificare il funzionamento della FB. Sono previsti vari livelli di triggers.
Trigger di spionaggio
| 16#00000001 | Rx: Ricezione dati da client HTTP. |
| 16#00000002 | Tx: Trasmissione dati al client HTTP. |
| 16#10000000 | Lg: Messaggi di log funzionamento. |
| 16#40000000 | Er: Errori di esecuzione. |
Esempi
Gestione server con autenticazione (Ptp194)
Il programma dimostrativo Ptp194 (Download) realizza la gestione di un server HTTP con autenticazione per l’accesso. Digitando da un browser l’IP del dispositivo seguito dal numero di porta su cui il server è attivo (Esempio http://xxx.xxx.xxx.xxx:2000) verrà visualizzata la pagina di richiesta credenziali di accesso (Default Admin:Admin). Eseguito l’accesso sarà possibile navigare tra le pagine del sito.
Un pulsante di Logout dalla pagina Home.html permetterà di eseguire il logout, nel caso in cui non si eseguano accessi per un tempo superiore a 120 secondi l’utente verrà automaticamente sloggato dal sistema.
L’esempio può essere eseguito su qualunque sistema SlimLine occorre trasferire le pagine presenti nella cartella WebPages che và trasferita sul disco D: del sistema (Se non si dispone della SDCard è possibile trasferire la cartella sul disco C:, in tal caso occorre modificare la directory root nel progetto).
Viene istanziato un server HTTP sulla porta 2000, eseguendo una richiesta in GET della pagina Division.cgi sono acquisiti i valori di dividendo e divisore e viene ritornato il risultato della divisione. Per testare il programma da un browser usare il link xxx.xxx.xxx.xxx:2000/Division.cgi?Dividend=500&Divisor=10, sostituendo alle x l’indirizzo IP del sistema. Nell’esempio è riportata anche la pagina AjaxPage.html che gestisce l’aggiornamento dei valori in Ajax. Nel Tab HTML Files sono riportati i files da copiare nella cartella definita in HPath.
HTML
| <head> | |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> | |
| <title>SlimLine - AJAX Page</title> | |
| <script language="javascript"> | |
| <!-- | |
| // ----------------------------------------------------------------------------- | |
| // FUNZIONE "GetPage(Page, RFlag)" | |
| // ----------------------------------------------------------------------------- | |
| // Questa funzione esegue lettura in "Fetch API" della pagina "Page" ed esegue | |
| // la chiamata alla funzione "SetupValues" che aggiorna i valori dei campi nella | |
| // pagina. Viene propagato lo stato di "RFlag" per non aggiornare i campi in | |
| // inputazione sull'aggiornamento automatico a tempo. | |
| // ----------------------------------------------------------------------------- | |
| async function GetPage(Page, RFlag) | |
| { | |
| try{ | |
| var Obj=await fetch(Page); | |
| SetupValues(await Obj.text(), RFlag); | |
| }catch(error) {console.log("GetPage error", error);} | |
| } | |
| // ----------------------------------------------------------------------------- | |
| // FUNZIONE "SubmitData(Page)" | |
| // ----------------------------------------------------------------------------- | |
| // Questa funzione deve essere eseguita all'invio dei dati (Tasto Send). | |
| // Esegue l'invio dei dati in POST. | |
| // ----------------------------------------------------------------------------- | |
| async function SubmitData(Page) | |
| { | |
| var SData='{"Dividend":'+document.getElementById("Dividend").value+',"Divisor":'+document.getElementById("Divisor").value+'}' | |
| console.log("Sent:"+SData); //Console log | |
| try{ | |
| var Obj=await fetch(Page, | |
| { | |
| method: "POST", | |
| headers: {"Content-type": "application/json; charset=UTF-8"}, | |
| body: SData | |
| }); | |
| SetupValues(await Obj.text(), true); | |
| }catch(error) {console.log("SubmitData error", error);} | |
| } | |
| // ----------------------------------------------------------------------------- | |
| // FUNZIONE "LoadPage(Page)" | |
| // ----------------------------------------------------------------------------- | |
| // Questa funzione deve essere eseguita al caricamento pagina. | |
| // Esegue l'aggiornamento dei valori ed imposta il tempo di refresh automatico. | |
| // ----------------------------------------------------------------------------- | |
| function LoadPage(Page) | |
| { | |
| GetPage(Page, true); //Lettura valori ed aggiornamento campi anche quelli in inputazione | |
| setInterval(function(){GetPage(Page, false)}, 1000); //Lettura valori a tempo ed aggiornamento campi | |
| } | |
| // ----------------------------------------------------------------------------- | |
| // FUNZIONE "SetupValues(RData, RFlag)" | |
| // ----------------------------------------------------------------------------- | |
| // Questa funzione esegue l'aggiornamento dei valori di tutti i campi della | |
| // pagina. "RFlag" se settata aggiorna anche i campi in inputazione, non deve | |
| // essere settata sul rinfresco automatico della pagina. | |
| // ----------------------------------------------------------------------------- | |
| function SetupValues(RData, RFlag) | |
| { | |
| console.log("Received:"+RData); //Console log | |
| var Obj=JSON.parse(RData); //Parse JSON data | |
| if (RFlag) document.getElementById("Dividend").value=Obj.Dividend; | |
| if (RFlag) document.getElementById("Divisor").value=Obj.Divisor; | |
| document.getElementById("Result").innerHTML=Obj.Result; | |
| document.getElementById("Counter").innerHTML=Obj.Counter; | |
| } | |
| //--> | |
| </script> | |
| </head> | |
| <body onLoad="LoadPage('AjaxPage.cgi')"> | |
| Counter: <span id="Counter"></span></br> | |
| Dividend: <input id="Dividend" type="text" size="10"/> Divisor: <input id="Divisor" type="text" size="10"/> <input type="button" value="Calculate" onclick="SubmitData('AjaxPage.cgi')"/></br> | |
| Result: <span id="Result"></span> | |
| </body> | |
| </html> |
by | <html> | |
| <head> | |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> | |
| <title>SlimLine - Simple page</title> | |
| <style type="text/css">.Bolded {font-family: Arial, Helvetica, sans-serif; font-size: 20px; font-style: normal;font-weight: bold;}</style> | |
| </head> | |
| <body> | |
| This page is served by <span class="Bolded">SlimLine</span> | |
| </body> | |
| </html> |
| <html> | |
| <head> | |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> | |
| <title>SlimLine - Redirect page</title> | |
| <style type="text/css">.Bolded {font-family: Arial, Helvetica, sans-serif; font-size: 20px; font-style: normal;font-weight: bold;}</style> | |
| </head> | |
| <body> | |
| You are been redirect by <span class="Bolded">SlimLine</span> | |
| </body> | |
| </html> |