things.cat - Contribucions de l’usuari [ca]

Pàgina principal

2025-11-27T12:38:16Z

Jordi Binefa : /* VPS */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]
==== Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb ''docker'' ====
[[Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker]]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[https://broker.binefa.cat/wordpressTraefik.html Guia completa: Instal·lació de Traefik + WordPress + PHP + MariaDB des de zero]

[https://broker.binefa.cat/guia.html Guia completa: Instal·lació de Mosquitto MQTT amb Traefik en VPS]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]
=== Intel·ligència Artificial ===
* [https://snap.berkeley.edu/snap/snap.html#open:https://xavierpi.com/ia/ia.xml Connexió amb Gemini] Cal una [https://aistudio.google.com/app/apikey clau d'API (API key)] ([https://ai.google.dev/gemini-api/docs/quickstart?lang=python Guia ràpida d'ús a l'API de Gemini])

* [https://ecraft2learn.github.io/ai/AI-Teacher-Guide/chapter-2.html Reconeixement de veu amb Snap!] ([https://ecraft2learn.github.io/ai/snap/snap.html?project=listening&editMode Accés directe al projecte amb Snap!])

= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

Pàgina principal

2025-11-27T12:36:19Z

Jordi Binefa : /* VPS */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]
==== Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb ''docker'' ====
[[Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker]]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[https://broker.binefa.cat/wordpressTraefik.html Guia completa: Instal·lació de Traefik + WordPress + PHP + MariaDB des de zero]

[https://broker.binefa.cat/guia.html Guia completa: Instal·lació de Mosquitto MQTT amb Traefik en VPS]

[[Instal·lació de Mosquitto MQTT amb Traefik en VPS]]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]
=== Intel·ligència Artificial ===
* [https://snap.berkeley.edu/snap/snap.html#open:https://xavierpi.com/ia/ia.xml Connexió amb Gemini] Cal una [https://aistudio.google.com/app/apikey clau d'API (API key)] ([https://ai.google.dev/gemini-api/docs/quickstart?lang=python Guia ràpida d'ús a l'API de Gemini])

* [https://ecraft2learn.github.io/ai/AI-Teacher-Guide/chapter-2.html Reconeixement de veu amb Snap!] ([https://ecraft2learn.github.io/ai/snap/snap.html?project=listening&editMode Accés directe al projecte amb Snap!])

= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

Pàgina principal

2025-11-27T12:16:18Z

Jordi Binefa : /* VPS */

Pàgina principal

2025-02-10T13:00:18Z

Jordi Binefa : /* Intel·ligència Artificial */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]
==== Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb ''docker'' ====
[[Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker]]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]
=== Intel·ligència Artificial ===
* [https://snap.berkeley.edu/snap/snap.html#open:https://xavierpi.com/ia/ia.xml Connexió amb Gemini] Cal una [https://aistudio.google.com/app/apikey clau d'API (API key)] ([https://ai.google.dev/gemini-api/docs/quickstart?lang=python Guia ràpida d'ús a l'API de Gemini])

* [https://ecraft2learn.github.io/ai/AI-Teacher-Guide/chapter-2.html Reconeixement de veu amb Snap!] ([https://ecraft2learn.github.io/ai/snap/snap.html?project=listening&editMode Accés directe al projecte amb Snap!])

= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

Pàgina principal

2025-02-10T12:59:09Z

Jordi Binefa : /* Intel·ligència Artificial */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]
==== Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb ''docker'' ====
[[Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker]]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]
=== Intel·ligència Artificial ===
* [https://snap.berkeley.edu/snap/snap.html#open:https://xavierpi.com/ia/ia.xml Connexió amb Gemini] Cal una [https://aistudio.google.com/app/apikey clau d'API (API key)] ([https://ai.google.dev/gemini-api/docs/quickstart?lang=python Guia ràpida d'ús a l'API de Gemini])

* [https://ecraft2learn.github.io/ai/AI-Teacher-Guide/chapter-2.html Reconeixement de veu amb Snap!]

= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

Pàgina principal

2025-02-10T12:57:16Z

Jordi Binefa : /* Intel·ligència Artificial */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]
==== Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb ''docker'' ====
[[Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker]]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]
=== Intel·ligència Artificial ===
[https://snap.berkeley.edu/snap/snap.html#open:https://xavierpi.com/ia/ia.xml Connexió amb Gemini] Cal una [https://aistudio.google.com/app/apikey clau d'API (API key)] ([https://ai.google.dev/gemini-api/docs/quickstart?lang=python Guia ràpida d'ús a l'API de Gemini])


= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

Pàgina principal

2025-02-10T12:56:04Z

Jordi Binefa : /* Intel·ligència Artificial */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]
==== Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb ''docker'' ====
[[Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker]]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]
=== Intel·ligència Artificial ===
[https://snap.berkeley.edu/snap/snap.html#open:https://xavierpi.com/ia/ia.xml Connexió amb Gemini] Cal una [https://aistudio.google.com/app/apikey clau d'API (API key)]


= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

Pàgina principal

2025-02-10T12:55:37Z

Jordi Binefa : /* Snap! */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]
==== Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb ''docker'' ====
[[Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker]]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]
=== Intel·ligència Artificial ===
[https://snap.berkeley.edu/snap/snap.html#open:https://xavierpi.com/ia/ia.xml Connexió amb Gemini] Cal una [https://aistudio.google.com/app/apikey clau d'API (API key)]

= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

6a sessió. Curset introductori d'Internet de les Coses. (23 / desembre / 2020)

2025-01-23T12:16:54Z

Jordi Binefa :

= LoRa =
== Introducció ==
Informació sobre [https://wiki.binefa.cat/index.php?title=LoRa LoRa]

[https://binefa.cat/IoT/lora/ttncat/TTN%20-%20Presentaci%c3%b3%20-%20Llibertat%20Maquinari.pdf Presentació de The Things Network Catalunya] el [http://caliu.cat/blog/2019/03/16/dia-de-la-llibertat-del-maquinari-2019/ dia de la llibertat del maquinari - 2019]

[https://binefa.cat/IoT/03_introLoRaWAN.pdf Introducció a LoRaWAN]

[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf LoRa, TTN i NodeRED]

== Exemples de funcionament ==
[https://twitter.com/JordiBinefa/status/1110147206735122432 LoRaWAN connected Solar Streetlight - Sant Boi Police Station]

[http://things.siarq.net:3000/d/OcxHLA3iz/policia-de-sant-boi?orgId=1&from=now-2d&to=now&refresh=1m Monitoring LoRaWAN connected Solar Streetlight - Sant Boi Police Station]

[https://twitter.com/JordiBinefa/status/1080531165432418304 LoRaWAN connected Solar Streetlight - Metal·lúrgica de Camallera]

[http://iot.siarq.net:3000/d/wJNT6ZUiz/camallera-influxdb?refresh=1m&orgId=1&from=now-2d&to=now Monitoring LoRaWAN connected Solar Streetlight - Metal·lúrgica de Camallera]

[https://www.binefa.cat/IoT/fires/iots2018/ Sistema Lora bidireccional] presentat a la [https://www.iotsworldcongress.com/ Fira IoTWC - 2018] a l'estand d'[https://www.industrialshields.com/ Industrial Shields]. Documentat a [https://wiki.binefa.cat/index.php?title=Demostraci%C3%B3_d%27us_de_LoRaWAN_amb_un_PLC_d%27IndustrialShields_a_la_Fira_IOTS-2018 Demostració d'us de LoRaWAN amb un PLC d'IndustrialShields a la Fira IOTS-2018]

== Exercici pràctic ==
Feu-vos les credencial d'accés a [https://www.thethingsnetwork.org/ The Things Network].

Un cop les tingueu, us afegiré com a col·laboradors a una aplicació anomenada '''ad-telecom''' i de la passarel·la local. Les aplicacions tenen dispositius i ara n'afegirem un per placa.

=== Donar d'alta un dispositiu a TTN ===
[https://binefa.cat/IoT/05_lorawan_usPractic.pdf Tutorial per a la connectivitat d'un node TTGO (fent servir ''lmic'') a The Things Network]

=== Amb la placa IoT-02 ===
A un NodeRED funcionant des del terminal (no com a servei. Precisament com ho fem a aquest curset) dóna errors d'execució els nodes instal·lats com a '''node-red-contrib-ttn''' (nodes oficials de TheThingsNetwork o TTN). També es veu que des de fa dos anys no s'ha fet manteniment d'aquests nodes. Degut a això es tractaran les trames emeses pels dispositius LoRaWAN com a missatges MQTT.

A una aplicació anomenada '''ad-telecom''' hi ha un dispositiu anomenat '''adtelecom-0001'''. Al NodeRED caldrà introduir aquestes dades:

Broker: '''eu.thethings.network'''

Port: '''1883'''

Security / Username: '''ad-telecom''' (el nom de l'aplicació a TTN)

Security / Password: '''ttn-account-v2.LVh3FzICF-3yhHe__no__es__la__que__toca__yPaQ3kEJ9uiCNkyPkGM''' (default key d'ACCESS KEYS)

Topic: '''ad-telecom'''/devices/'''adtelecom-0001'''/up (tema de pujada o ''uplink'')

El [https://www.binefa.cat/training/adtelecom/20201223/exrebut.txt missatge arriba com a text], es converteix a json i hi ha els temes: ''app_id'', ''dev_id'', ''hardware_serial'', ''port'', ''counter'', ''payload_raw'' (codificat en base 64) i ''metadata''. Dins de ''metadata'': ''time'', ''frequency'', ''modulation'', ''data_rate'', ''airtime'', ''coding_rate'' i ''gateways''. Dins de ''gateways'': les passarel·les que han captat el missatge LoRa començant per ''0''. I dins de cada passarel·la: ''gtw_id'', ''timestamp''. ''time'', ''channel'', ''rssi'', ''snr'', ''rf_chain'', ''latitude'', ''longitude'' i ''altitude''.

==== OTAA ====
[https://www.binefa.cat/training/adtelecom/20201223/IoT-02-22_ttn-otaa_adtelecom_01.zip Exemple de microprogramari per a la placa IoT-02 de comunicació LoRaWAN amb OTAA]

[https://binefa.cat/training/adtelecom/20201223/uplinkOTAA.nodered.txt Codi de NodeRED per a rebre missatges LoRaWAN amb OTAA]

==== ABP ====
Quan canvieu d'OTAA a ABP '''desactiveu la casella Frame Counter Check'''.

[https://www.binefa.cat/training/adtelecom/20201223/IoT-02_ttn-abp_adtelecom_02.zip Exemple bàsic de microprogramari per a la placa IoT-02 de comunicació LoRaWAN amb ABP]

[https://www.binefa.cat/training/adtelecom/20201223/uplinkABP.nodered.txt Codi de NodeRED per a rebre missatges LoRaWAN amb ABP]

[https://www.binefa.cat/training/adtelecom/20201223/IoT-02_12_loraABP_modbus_bme280_adtelecom_03.zip Exemple de microprogramari per a la placa IoT-02 de comunicació LoRaWAN amb ABP trametent un nombre real]

[https://www.binefa.cat/training/adtelecom/20201223/IoT-02_12_loraABP_modbus_bme280_adtelecom_04.zip Exemple de microprogramari per a la placa IoT-02 de comunicació LoRaWAN amb ABP trametent tres nombres reals]

[https://www.binefa.cat/training/adtelecom/20201223/uplinkABP_bme280.nodered.txt Codi de NodeRED per a rebre tres nombres reals LoRaWAN amb ABP]

===== Exercici amb ABP =====
Desxifreu els 3 floats des de NodeRED.

=== Amb plaques de metacrilat ===
[https://www.binefa.cat/IoT/04_conjunt02.pdf Conjunt IoT. Prova de connectivitat a The Things Network]

[https://www.binefa.cat/training/upcSchool/20190504/arrayFloat.js.txt Codi en JS per a convertir un array d'hexadecimales a float]

Al NodeRED, a '''App''' va el nom de '''Application''' a TTN ([https://www.thethingsnetwork.org/ The Things Network])

A l''''Access Key''' del NodeRED va el '''default key''' d''''ACCESS KEYS''' en TTN

A la funció '''Cap a TTN''' del NodeRED al campo '''dev_id''' es posa el nom del dispositiu corresponent de la lista '''Devices''' a TTN

[https://www.binefa.cat/training/20180927_icm_csic/ Més informació per a posar-ho en funcionament]

= Altres informacions =
[https://www.thethingsnetwork.org/forum/t/limitations-data-rate-packet-size-30-seconds-uplink-and-10-messages-downlink-per-day-fair-access-policy/1300 Fair Access Policy]

[https://www.binefa.cat/IoT/04b_reflexionsTTN.pdf Algunes reflexions sobre l'ús real de The Things Network]

[https://www.binefa.cat/IoT/lora/lorawan/telegramBot_01.pdf Exemple de monitorizació d'una passarel·la (''gateway'') LoRaWAN mitjançant un ''bot'' de Telegram]

6a sessió. Curset introductori d'Internet de les Coses. (23 / desembre / 2020)

2025-01-23T12:15:35Z

Jordi Binefa : /* Exemples de funcionament */

= LoRa =
== Introducció ==
Informació sobre [https://wiki.binefa.cat/index.php?title=LoRa LoRa]

[https://binefa.cat/IoT/lora/ttncat/TTN%20-%20Presentaci%c3%b3%20-%20Llibertat%20Maquinari.pdf Presentació de The Things Network Catalunya] el [http://caliu.cat/blog/2019/03/16/dia-de-la-llibertat-del-maquinari-2019/ dia de la llibertat del maquinari - 2019]

[https://binefa.cat/IoT/03_introLoRaWAN.pdf Introducció a LoRaWAN]

[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf LoRa, TTN i NodeRED]

== Exemples de funcionament ==
[https://twitter.com/JordiBinefa/status/1110147206735122432 LoRaWAN connected Solar Streetlight - Sant Boi Police Station]

[http://things.siarq.net:3000/d/OcxHLA3iz/policia-de-sant-boi?orgId=1&from=now-2d&to=now&refresh=1m Monitoring LoRaWAN connected Solar Streetlight - Sant Boi Police Station]

[https://twitter.com/JordiBinefa/status/1080531165432418304 LoRaWAN connected Solar Streetlight - Metal·lúrgica de Camallera]

[http://iot.siarq.net:3000/d/wJNT6ZUiz/camallera-influxdb?refresh=1m&orgId=1&from=now-2d&to=now Monitoring LoRaWAN connected Solar Streetlight - Metal·lúrgica de Camallera]

[https://www.binefa.cat/IoT/fires/iots2018/ Sistema Lora bidireccional] presentat a la [https://www.iotsworldcongress.com/ Fira IoTWC - 2018] a l'estand d'[https://www.industrialshields.com/ Industrial Shields]. Documentat a [https://wiki.binefa.cat/index.php?title=Demostraci%C3%B3_d%27us_de_LoRaWAN_amb_un_PLC_d%27IndustrialShields_a_la_Fira_IOTS-2018 Demostració d'us de LoRaWAN amb un PLC d'IndustrialShields a la Fira IOTS-2018]

== Exercici pràctic ==
Feu-vos les credencial d'accés a [https://www.thethingsnetwork.org/ The Things Network].

Un cop les tingueu, us afegiré com a col·laboradors a una aplicació anomenada '''ad-telecom''' i de la passarel·la local. Les aplicacions tenen dispositius i ara n'afegirem un per placa.

=== Donar d'alta un dispositiu a TTN ===
[https://binefa.cat/IoT/05_lorawan_usPractic.pdf Tutorial per a la connectivitat d'un node TTGO (fent servir ''lmic'') a The Things Network]

=== Amb la placa IoT-02 ===
A un NodeRED funcionant des del terminal (no com a servei. Precisament com ho fem a aquest curset) dóna errors d'execució els nodes instal·lats com a '''node-red-contrib-ttn''' (nodes oficials de TheThingsNetwork o TTN). També es veu que des de fa dos anys no s'ha fet manteniment d'aquests nodes. Degut a això es tractaran les trames emeses pels dispositius LoRaWAN com a missatges MQTT.

A una aplicació anomenada '''ad-telecom''' hi ha un dispositiu anomenat '''adtelecom-0001'''. Al NodeRED caldrà introduir aquestes dades:

Broker: '''eu.thethings.network'''

Port: '''1883'''

Security / Username: '''ad-telecom''' (el nom de l'aplicació a TTN)

Security / Password: '''ttn-account-v2.LVh3FzICF-3yhHe__no__es__la__que__toca__yPaQ3kEJ9uiCNkyPkGM''' (default key d'ACCESS KEYS)

Topic: '''ad-telecom'''/devices/'''adtelecom-0001'''/up (tema de pujada o ''uplink'')

El [https://binefa.cat/training/adtelecom/20201223/exrebut.txt missatge arriba com a text], es converteix a json i hi ha els temes: ''app_id'', ''dev_id'', ''hardware_serial'', ''port'', ''counter'', ''payload_raw'' (codificat en base 64) i ''metadata''. Dins de ''metadata'': ''time'', ''frequency'', ''modulation'', ''data_rate'', ''airtime'', ''coding_rate'' i ''gateways''. Dins de ''gateways'': les passarel·les que han captat el missatge LoRa començant per ''0''. I dins de cada passarel·la: ''gtw_id'', ''timestamp''. ''time'', ''channel'', ''rssi'', ''snr'', ''rf_chain'', ''latitude'', ''longitude'' i ''altitude''.

==== OTAA ====
[https://binefa.cat/training/adtelecom/20201223/IoT-02-22_ttn-otaa_adtelecom_01.zip Exemple de microprogramari per a la placa IoT-02 de comunicació LoRaWAN amb OTAA]

[https://binefa.cat/training/adtelecom/20201223/uplinkOTAA.nodered.txt Codi de NodeRED per a rebre missatges LoRaWAN amb OTAA]

==== ABP ====
Quan canvieu d'OTAA a ABP '''desactiveu la casella Frame Counter Check'''.

[https://binefa.cat/training/adtelecom/20201223/IoT-02_ttn-abp_adtelecom_02.zip Exemple bàsic de microprogramari per a la placa IoT-02 de comunicació LoRaWAN amb ABP]

[https://binefa.cat/training/adtelecom/20201223/uplinkABP.nodered.txt Codi de NodeRED per a rebre missatges LoRaWAN amb ABP]

[https://binefa.cat/training/adtelecom/20201223/IoT-02_12_loraABP_modbus_bme280_adtelecom_03.zip Exemple de microprogramari per a la placa IoT-02 de comunicació LoRaWAN amb ABP trametent un nombre real]

[https://binefa.cat/training/adtelecom/20201223/IoT-02_12_loraABP_modbus_bme280_adtelecom_04.zip Exemple de microprogramari per a la placa IoT-02 de comunicació LoRaWAN amb ABP trametent tres nombres reals]

[https://binefa.cat/training/adtelecom/20201223/uplinkABP_bme280.nodered.txt Codi de NodeRED per a rebre tres nombres reals LoRaWAN amb ABP]

===== Exercici amb ABP =====
Desxifreu els 3 floats des de NodeRED.

=== Amb plaques de metacrilat ===
[https://binefa.cat/IoT/04_conjunt02.pdf Conjunt IoT. Prova de connectivitat a The Things Network]

[https://binefa.cat/training/upcSchool/20190504/arrayFloat.js.txt Codi en JS per a convertir un array d'hexadecimales a float]

Al NodeRED, a '''App''' va el nom de '''Application''' a TTN ([https://www.thethingsnetwork.org/ The Things Network])

A l''''Access Key''' del NodeRED va el '''default key''' d''''ACCESS KEYS''' en TTN

A la funció '''Cap a TTN''' del NodeRED al campo '''dev_id''' es posa el nom del dispositiu corresponent de la lista '''Devices''' a TTN

[https://binefa.cat/training/20180927_icm_csic/ Més informació per a posar-ho en funcionament]

= Altres informacions =
[https://www.thethingsnetwork.org/forum/t/limitations-data-rate-packet-size-30-seconds-uplink-and-10-messages-downlink-per-day-fair-access-policy/1300 Fair Access Policy]

[https://binefa.cat/IoT/04b_reflexionsTTN.pdf Algunes reflexions sobre l'ús real de The Things Network]

[https://binefa.cat/IoT/lora/lorawan/telegramBot_01.pdf Exemple de monitorizació d'una passarel·la (''gateway'') LoRaWAN mitjançant un ''bot'' de Telegram]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T13:07:46Z

Jordi Binefa : /* Idea */

= Idea =
N'[https://www.linkedin.com/in/ulasdikme/ Ulas Dikme] ha desenvolupat un [https://github.com/PhysicsX/QTonRaspberryPi sistema amb docker per a fer la compilació creuada de Qt6 per a Raspberry Pi].

Primer es crea un entorn de Raspbian per a emular la Raspberry Pi. Creació de la imatge:
docker buildx build --platform linux/arm64 --load -f DockerFileRasp -t raspimage .
Es fa un contenidor amb aquesta imatge i s'extreu l'arxiu rasp.tar.gz que es farà servir per a la nova imatge per a fer la compilació creuada:
docker create --name temp-arm raspimage
docker cp temp-arm:/build/rasp.tar.gz ./rasp.tar.gz

Es tracta de fer una imatge docker que contingui:
* Un Debian 12 sense interacció per a evitar preguntes al fer la instal·lació
* Les eines de compilació de la Raspberry Pi emulada fent servir rasp.tar.gz
* Es crea des de zero CMake
* Es compilen les Qt i les seves biblioteques
* Es compila creuadament el codi del nostre projecte
* Es generen els binaris de l'executable i les biblioteques

Un cop feta aquesta imatge es crea un contenidor per a tenir-hi accés. S'extreuen les biblioteques i el binari executable per passar-ho a la Raspberry Pi.

= Dockerfile =
Al [https://github.com/PhysicsX/QTonRaspberryPi/blob/main/Dockerfile Dockerfile] original s'inclouen les biblioteques:
* QtBase
* QtShaderTools
* QtDeclarative
I al [https://www.binefa.cat/qt/cross-compile/Dockerfile Dockerfile modificat] per a permetre la comunicaió mitjançant MQTT hi afegeixo:
* [https://doc.qt.io/qt-6/qtnetworkauth-index.html QtNetworkAuth]
* [https://doc.qt.io/qt-6/qtwebsockets-index.html QtWebSockets]
* [https://doc.qt.io/qt-6/qtmqtt-index.html QtMqtt]

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
És un procés prou ràpid (al voltant d'un minut) excepte quan hi ha actualitzacions del kernel als repositoris de Debian (que triga al voltant de quatre hores fer una nova imatge).

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode] desenvolupat per [https://www.linkedin.com/in/ulasdikme/ Ulas Dikme]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T13:01:42Z

Jordi Binefa : /* Idea */

= Idea =
N'[https://www.linkedin.com/in/ulasdikme/ Ulas Dikme] ha desenvolupat un [https://github.com/PhysicsX/QTonRaspberryPi sistema amb docker per a fer la compilació creuada de Qt6 per a Raspberry Pi].

Primer es crea un entorn de Raspbian per a emular la Raspberry Pi. Creació de la imatge:
docker buildx build --platform linux/arm64 --load -f DockerFileRasp -t raspimage .
Es fa un contenidor amb aquesta imatge i s'extreu l'arxiu rasp.tar.gz que es farà servir per a la nova imatge per a fer la compilació creuada:
docker create --name temp-arm raspimage
docker cp temp-arm:/build/rasp.tar.gz ./rasp.tar.gz

Es tracta de fer una imatge docker que contingui:
* Un Debian 12 sense interacció per a evitar preguntes al fer la instal·lació

= Dockerfile =
Al [https://github.com/PhysicsX/QTonRaspberryPi/blob/main/Dockerfile Dockerfile] original s'inclouen les biblioteques:
* QtBase
* QtShaderTools
* QtDeclarative
I al [https://www.binefa.cat/qt/cross-compile/Dockerfile Dockerfile modificat] per a permetre la comunicaió mitjançant MQTT hi afegeixo:
* [https://doc.qt.io/qt-6/qtnetworkauth-index.html QtNetworkAuth]
* [https://doc.qt.io/qt-6/qtwebsockets-index.html QtWebSockets]
* [https://doc.qt.io/qt-6/qtmqtt-index.html QtMqtt]

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
És un procés prou ràpid (al voltant d'un minut) excepte quan hi ha actualitzacions del kernel als repositoris de Debian (que triga al voltant de quatre hores fer una nova imatge).

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode] desenvolupat per [https://www.linkedin.com/in/ulasdikme/ Ulas Dikme]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:47:12Z

Jordi Binefa : /* Idea */

= Idea =
N'[https://www.linkedin.com/in/ulasdikme/ Ulas Dikme] ha desenvolupat un [https://github.com/PhysicsX/QTonRaspberryPi sistema amb docker per a fer la compilació creuada de Qt6 per a Raspberry Pi].

= Dockerfile =
Al [https://github.com/PhysicsX/QTonRaspberryPi/blob/main/Dockerfile Dockerfile] original s'inclouen les biblioteques:
* QtBase
* QtShaderTools
* QtDeclarative
I al [https://www.binefa.cat/qt/cross-compile/Dockerfile Dockerfile modificat] per a permetre la comunicaió mitjançant MQTT hi afegeixo:
* [https://doc.qt.io/qt-6/qtnetworkauth-index.html QtNetworkAuth]
* [https://doc.qt.io/qt-6/qtwebsockets-index.html QtWebSockets]
* [https://doc.qt.io/qt-6/qtmqtt-index.html QtMqtt]

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
És un procés prou ràpid (al voltant d'un minut) excepte quan hi ha actualitzacions del kernel als repositoris de Debian (que triga al voltant de quatre hores fer una nova imatge).

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode] desenvolupat per [https://www.linkedin.com/in/ulasdikme/ Ulas Dikme]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:46:22Z

Jordi Binefa : /* Idea */

= Idea =
N'[https://www.linkedin.com/in/ulasdikme/ Ulas Dikme] ha desenvolupat un sistema per a fer la compilació creuada de Qt6 per a Raspberry Pi

= Dockerfile =
Al [https://github.com/PhysicsX/QTonRaspberryPi/blob/main/Dockerfile Dockerfile] original s'inclouen les biblioteques:
* QtBase
* QtShaderTools
* QtDeclarative
I al [https://www.binefa.cat/qt/cross-compile/Dockerfile Dockerfile modificat] per a permetre la comunicaió mitjançant MQTT hi afegeixo:
* [https://doc.qt.io/qt-6/qtnetworkauth-index.html QtNetworkAuth]
* [https://doc.qt.io/qt-6/qtwebsockets-index.html QtWebSockets]
* [https://doc.qt.io/qt-6/qtmqtt-index.html QtMqtt]

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
És un procés prou ràpid (al voltant d'un minut) excepte quan hi ha actualitzacions del kernel als repositoris de Debian (que triga al voltant de quatre hores fer una nova imatge).

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode] desenvolupat per [https://www.linkedin.com/in/ulasdikme/ Ulas Dikme]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:44:26Z

Jordi Binefa : /* Dockerfile */

= Idea =
= Dockerfile =
Al [https://github.com/PhysicsX/QTonRaspberryPi/blob/main/Dockerfile Dockerfile] original s'inclouen les biblioteques:
* QtBase
* QtShaderTools
* QtDeclarative
I al [https://www.binefa.cat/qt/cross-compile/Dockerfile Dockerfile modificat] per a permetre la comunicaió mitjançant MQTT hi afegeixo:
* [https://doc.qt.io/qt-6/qtnetworkauth-index.html QtNetworkAuth]
* [https://doc.qt.io/qt-6/qtwebsockets-index.html QtWebSockets]
* [https://doc.qt.io/qt-6/qtmqtt-index.html QtMqtt]

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
És un procés prou ràpid (al voltant d'un minut) excepte quan hi ha actualitzacions del kernel als repositoris de Debian (que triga al voltant de quatre hores fer una nova imatge).

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode] desenvolupat per [https://www.linkedin.com/in/ulasdikme/ Ulas Dikme]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:42:10Z

Jordi Binefa : /* Dockerfile */

= Idea =
= Dockerfile =
Al [https://github.com/PhysicsX/QTonRaspberryPi/blob/main/Dockerfile Dockerfile] original s'inclouen les biblioteques:
* QtBase
* QtShaderTools
* QtDeclarative
I al [https://www.binefa.cat/qt/cross-compile/Dockerfile Dockerfile modificat] per a permetre la comunicaió mitjançant MQTT hi afegeixo:
* QtNetworkauth
* QtWebSockets
* QtMqtt

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
És un procés prou ràpid (al voltant d'un minut) excepte quan hi ha actualitzacions del kernel als repositoris de Debian (que triga al voltant de quatre hores fer una nova imatge).

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode] desenvolupat per [https://www.linkedin.com/in/ulasdikme/ Ulas Dikme]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:37:14Z

Jordi Binefa :

= Idea =
= Dockerfile =
Al [https://github.com/PhysicsX/QTonRaspberryPi/blob/main/Dockerfile Dockerfile] original s'inclouen les biblioteques:
* QtBase
* QtShaderTools
* QtDeclarative
I a la modificació que n'he fet per a permetre la comunicaió mitjançant MQTT hi afegeixo:
* QtNetworkauth
* QtWebSockets
* QtMqtt
= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
És un procés prou ràpid (al voltant d'un minut) excepte quan hi ha actualitzacions del kernel als repositoris de Debian (que triga al voltant de quatre hores fer una nova imatge).

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode] desenvolupat per [https://www.linkedin.com/in/ulasdikme/ Ulas Dikme]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:29:07Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
És un procés prou ràpid (al voltant d'un minut) excepte quan hi ha actualitzacions del kernel als repositoris de Debian (que triga al voltant de quatre hores fer una nova imatge).

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:27:08Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
''pi''@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:26:20Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''raspberry''.local:/home/''pi''/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
''pi''@''raspberrypi'':~ sudo mkdir /usr/local/qt6
''pi''@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
''pi''@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
pi@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:25:18Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
pi@''raspberrypi'':~ sudo mkdir /usr/local/qt6
pi@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
pi@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
pi@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Un cop deseu el vostre codi dins de la carpeta ''project'' tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:24:19Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
pi@''raspberrypi'':~ sudo mkdir /usr/local/qt6
pi@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
pi@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
pi@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable no us caldrà tornar a instal·lar les biblioteques. Tan sols haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:23:29Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
pi@''raspberrypi'':~ sudo mkdir /usr/local/qt6
pi@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
pi@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
pi@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable, no us caldrà tornar a instal·lar les biblioteques i haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/
= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:22:32Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
pi@''raspberrypi'':~ sudo mkdir /usr/local/qt6
pi@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
pi@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
pi@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes anteriors i tan sols esteu modificant el codi font de l'executable, no us caldrà tornar a instal·lar les biblioteques i haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:22:12Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
pi@''raspberrypi'':~ sudo mkdir /usr/local/qt6
pi@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
pi@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
pi@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes i tan sols esteu modificant el codi font de l'executable, no us caldrà tornar a instal·lar les biblioteques i haureu de repetir aquest procés:
docker build -t '''qtcrossbuild''' .
docker create --name '''contenidor_temporal''' qtcrossbuild
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:18:29Z

Jordi Binefa :

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi (el darrer '''.''' és important. Indica que el ''Dockerfile'' i la carpeta ''project'' són al directori des d'on executa l'ordre ''docker build''):
docker build -t '''qtcrossbuild''' .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
pi@''raspberrypi'':~ sudo mkdir /usr/local/qt6
pi@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
pi@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
pi@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes i tan sols esteu modificant el codi font de l'executable, haureu de repetir aquest procés:

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:15:49Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi:
docker build -t qtcrossbuild .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
pi@''raspberrypi'':~ sudo mkdir /usr/local/qt6
pi@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
pi@''raspberrypi'':~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

* Poseu en marxa l'executable generat a la Raspberry:
pi@''raspberrypi'':~ ./'''nom_arxiu_executable'''

* Un cop heu fet totes les passes i tan sols esteu modificant el codi font de l'executable, haureu de repetir aquest procés:

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:12:52Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i '''deseu el codi a compilar dins de la carpeta ''project''''' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi:
docker build -t qtcrossbuild .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''pi'' pel vostre usuari i ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' ''pi''@''192.168.1.XX'':/home/''pi''/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp '''nom_arxiu_executable''' pi@''raspberry''.local:/home/pi/

* '''El primer cop''' que feu la compilació creuada també haureu de copiar a la Raspberry Pi les '''biblioteques''' necessàries per a que funcioni l'executable que heu compilat:
docker cp '''contenidor_temporal''':/build/qt-pi-binaries.tar.gz ./qt-pi-binaries.tar.gz
scp qt-pi-binaries.tar.gz ''pi''@''192.168.1.XX'':/home/''pi''/
ssh ''pi''@''192.168.1.XX''
pi@''raspberrypi'':~ sudo mkdir /usr/local/qt6
pi@''raspberrypi'':~ sudo tar -xvf qt-pi-binaries.tar.gz -C /usr/local/qt6
ulas@raspberrypi:~ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/qt6/lib/

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:04:08Z

Jordi Binefa : /* En marxa */

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:03:40Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i deseu el codi a compilar dins de la carpeta ''project'' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge de docker d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi:
docker build -t qtcrossbuild .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp pales04 pi@''192.168.1.XX'':/home/pi/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp pales04 pi@''raspberry''.local:/home/pi/

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T12:03:03Z

Jordi Binefa : /* En marxa */

= En marxa =
* Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i deseu el codi a compilar dins de la carpeta ''project'' (assegureu-vos de no copiar ''CMakeLists.txt.user'' ni la carpeta ''build'').

* Identifiqueu el nom de l'arxiu executable. Dins l'arxiu ''CMakeLists.txt'' hi ha [https://doc.qt.io/qt-6/qt-add-executable.html qt_add_executable] amb el nom de l'arxiu executable ('''nom_arxiu_executable'''):
qt_add_executable('''nom_arxiu_executable'''
main.cpp
)

* Feu una imatge d'un Debian 12, anomenada '''qtcrossbuild''', capaç de fer la compilació creuada per a Raspberry Pi:
docker build -t qtcrossbuild .
El '''primer cop''' a fer la imatge pot trigar '''al voltant de 4 hores'''. Un cop feta, '''el segon cop''' que es fa servir, habitualment canviant el contingut de la carpeta ''build'', trigarà '''al voltant d'un minut''', depenent de la complexitat del codi a compilar. '''Quan hi hagi actualitzacions del kernel''' al repositoris de Debian tornarà a trigar '''al voltant de 4 hores''' a fer-se la imatge.

* Feu un contenidor temporal de la imatge ''qtcrossbuild'' per a poder copiar l'executable generat per a Raspberry Pi:
docker create --name '''contenidor_temporal''' qtcrossbuild

* Copieu al vostre directori (si no ho heu canviat, seguiu al directori a on hi ha l'arxiu ''Dockerfile'') l'executable generat per a Raspberry Pi que és a dins del contenidor:
docker cp '''contenidor_temporal''':/build/project/'''nom_arxiu_executable''' ./'''nom_arxiu_executable'''

* Copieu l'arxiu executable generat a la Raspberry Pi (canvieu ''192.168.1.XX'' per la IP de la vostra Raspberry Pi):
scp pales04 pi@''192.168.1.XX'':/home/pi/
o (canvieu ''raspberry'' pel ''hostname'' de la vostra Raspberry Pi):
scp pales04 pi@''raspberry''.local:/home/pi/

= Font =
[https://github.com/PhysicsX/QTonRaspberryPi Cross compilation of Qt6.8.0 For Raspberry pi 3/4/5 with Docker(Base and QML packages) and Remote Debugging with Vscode]

Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker

2025-01-21T11:52:43Z

Jordi Binefa : Es crea la pàgina amb «= En marxa = * Aneu al directori a on hi ha l'arxiu ''Dockerfile'' i deseu el codi a compilar dins de la carpeta ''project'' (assegureu-vos de no copiar ''CMakeLists.t...».

Pàgina principal

2025-01-21T11:33:22Z

Jordi Binefa : /* Raspbian */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]
==== Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb ''docker'' ====
[[Compilació creuada de Qt6.8.0 per Raspberry Pi 3/4/5 amb docker]]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]

= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

Migració d'una wiki a una altra dockeritzada

2024-09-28T20:18:44Z

Jordi Binefa : /* Connexió amb la base de dades */

= Còpia de la wiki original =
La migració explicada a aquesta pàgina és per a poder integrar una wiki preexistent darrere un [[Servidor intermediari invers]].

* Feu una còpia de la base de dades de la wiki (en aquesta explicació serà ''wiki_binefa_cat.sql''). Si no us recordeu dels paràmetres, feu-li un cop d'ull a l'arxiu '''LocalSettings.php''' present al directori arrel de la wiki.

* Feu una còpia del directori arrel de la wiki

= Prova del contenidor docker a migrar =
Es cerca la versió actual del wiki en funcionament a l'enllaç "[https://wiki.binefa.cat/index.php?title=Especial:P%C3%A0gines_especials Pàgines especials]" / "[https://wiki.binefa.cat/index.php?title=Especial:Versi%C3%B3 Versió]". En el cas d'aquest exemple és la versió 1.29.0

Es prova el funcionament, sense volums associats ni base de dades, a un domini secundari de prova (Aquest domini ha d'estar configurat a la configuració DNS del nostre proveïdor de nom de domini):
docker run --name wiki_binefa_cat --network net -e VIRTUAL_HOST="wiki2.binefa.cat" -e LETSENCRYPT_HOST="wiki2.binefa.cat" -d mediawiki:1.29.0
Un cop provat que funciona el servei web de la mediawiki, es desactiva el servei:
docker stop wiki_binefa_cat
docker rm wiki_binefa_cat

= Connexió amb la base de dades =
Per tal de poder fer servir més d'una base de dades al nostre sistema dockeritzat, es canvia el port normal de funcionament a les bases de dades SQL, el 3306, per un altre exclusiu per al servei de cada wiki, en aquest cas és el 3309.

També es comenten els volums relacionats amb el contingut html de la wiki a migrar i de l'arxiu LocalSettings.php

Al mateix directori a on és [https://www.things.cat/index.php/Migraci%C3%B3_d%27una_wiki_a_una_altra_dockeritzada#Arxiu_docker-compose.yml_per_a_la_primera_connexi.C3.B3_amb_la_base_de_dades docker-compose.yml] executem el contenidor docker:
docker-compose run --name wiki_binefa_cat -e VIRTUAL_HOST="wiki2.binefa.cat" -e LETSENCRYPT_HOST="wiki2.binefa.cat" -d web

Es verifica la correcta execució del contenidor docker:
jordi@vps-wiki:~/bin/wikis/binefa_cat$ '''docker ps -a'''
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
03e0b6d10eda mediawiki:1.29.0 "docker-php-entrypoi…" 11 minutes ago Up 11 minutes 80/tcp wiki_binefa_cat
6944309dd20a mysql:5.6.48 "docker-entrypoint.s…" 14 minutes ago Up 14 minutes 0.0.0.0:3309->3306/tcp, :::3309->3306/tcp binefa_cat_db_docker

Es consulta l'adreça IP del contenidor de la base de dades dins de la xarxa local de contenidors (necessari per a la configuració de la mediawiki per la generació de l'arxiu LocalSettings.php):
<pre>jordi@vps-wiki:~/bin/wikis/binefa_cat$ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' binefa_cat_db_docker
172.18.0.11</pre>

Aneu al navegador d'Internet i aneu a la pàgina de la wiki (en aquest exemple seria https://wiki2.binefa.cat). Si tot va bé, hi surt:
MediaWiki 1.29.0
LocalSettings.php not found.
Please set up the wiki first.

Premeu a sobre de ''Please set up the wiki first''. La primera pàgina és ''Instal·lació del MediaWiki 1.29.0''. Seleccioneu la vostra llengua i la llengua de la wiki. A les dues he seleccionat ''ca - català''.

Després de prémer el botó per a continuar, i si tot ha anat bé, hi surt una pàgina amb aquest text de color verd: ''S'ha comprovat l'entorn. Podeu instal·lar el MediaWiki''.

La següent pàgina és la de connexió a la base de dades. Per a saber quines dades posar, feu-li una ullada al vostre arxiu LocalSettings.php original. En aquest exemple fem servir aquests valors:
$wgDBtype = "mysql";
$wgDBserver = "'''172.18.0.11'''";
$wgDBname = "nom_base_de_dades_sql";
$wgDBuser = "usuari_sql";
$wgDBpassword = "contrasenya_usuari_sql";
$wgDBprefix = "wiki_bc";

Per defecte hi surt que el tipus és ''MySQL (o compatible)'', i així ha de ser. Al ''Servidor de la base de dades'' hi surt ''localhost'' per defecte i '''ho heu de canviar per la IP del contenidor de la base de dades dins de la xarxa local de contenidors''' (en aquest exemple és 172.18.0.11). Poseu-hi el nom de la base de dades (''nom_base_de_dades_sql''), el prefix de la base de dades (''wiki_bc''). Per a aquest configuració inicial fem servir com a nom de l'usuari de la base de dades ''usuari_sql'' i com a contrasenya ''contrasenya_usuari_sql''.

La pàgina següent mostra aquestes seleccions per defecte (no les modifiqueu): Compte de la base de dades per a l'accés web ''Utilitza el mateix compte que a la instal·lació'', Motor d'emmagatzemament ''InnoDB'' i Joc de caràcters de la base de dades ''binari''.

La pàgina següent us pregunta pel nom de la wiki, el vostre nom d'usuari, contrasenya i correu electrònic. Seleccioneu Fes-me més preguntes, que ja hi és per defecte.

La pàgina següent es sobre permisos. He seleccionat a Perfil de permisos d'usuari: Només editors autoritzats, Copyright i llicència: Creative Commons Reconeixement-CompartirIgual. A Paràmetres del correu electrònic he desactivat els correus sortints. A Extensions he seleccionat ImageMap, Interwiki, Nuke i WikiEditor. A Imatges i càrregues de fitxers he habilitat Habilita la càrrega de fitxers. La resta d'opcions no les he canviat del seu estat per defecte.

Es convenient que securitzeu el vostre '''LocalSettings.php''' per a evitar intrusions:
# Disable anonymous editing
$wgGroupPermissions['*']['edit'] = false;
# Prevent new user registrations except by sysops
$wgGroupPermissions['*']['createaccount'] = false;
Després de continuar les dues següents pàgines informatives ens demana desar l'arxiu '''LocalSettings.php''' (és molt important desar-lo per poder continuar el següent pas).

== Arxiu docker-compose.yml per a la primera connexió amb la base de dades ==
### Based on https://kindalame.com/2020/11/25/self-hosting-mediawiki-with-docker/
### Docker Compose Example for Kinda Lame
### Created October 2020
### Modified August 2021 by Jordi Binefa
###
version: '3.3'
services:
web:
###
### We suggest using the LTS, long term support images
###
image: mediawiki:1.29.0
ports:
- 80:80
- 443:443
- '''3309''':3306
links:
- database
restart: unless-stopped
volumes:
- /home/jordi/bin/wikis/binefa_cat/wikibinefacat/images:/var/www/html/images
'''# - /home/jordi/bin/wikis/binefa_cat/wikibinefacat/LocalSettings.php:/var/www/html/LocalSettings.php'''
'''# - /home/jordi/bin/wikis/binefa_cat/wikibinefacat:/var/www/html'''
'''# - /home/jordi/bin/wikis/binefa_cat/php:/usr/local/etc/php'''
networks:
- "net"
database:
container_name: binefa_cat_db_docker
image: mysql:5.6.48
ports:
- '''3309''':3306
environment:
MYSQL_DATABASE: 'nom_base_de_dades_sql'
MYSQL_USER: 'usuari_sql'
#
# Generate a secure password and place it in the area below
#
MYSQL_PASSWORD: 'contrasenya_usuari_sql'
MYSQL_ROOT_PASSWORD: 'contrasenya_mestra_sql'
MYSQL_RANDOM_ROOT_PASSWORD: 'no'
volumes:
- /home/jordi/bin/wikis/binefa_cat/database:/var/lib/mysql
restart: unless-stopped
networks:
- "net"

volumes:
certs:
html:
vhost:
dhparam:

networks:
net:
external: true

= Recàrrega de la base de dades =
Atureu el contenidor docker de la wiki, però no el de la base de dades:
docker stop rm_binefa_cat
docker rm wiki_binefa_cat

jordi@vps-wikie:~/bin/wikis/binefa_cat$ docker exec -i binefa_cat_db_docker mysql -u jordi -pfuroner2017 wiki_binefa_cat < wiki_binefa_cat.sql
Warning: Using a password on the command line interface can be insecure.
'''ERROR 1050 (42S01) at line 30: Table 'wiki_bcarchive' already exists'''

Per a evitar aquest error:
jordi@vps-wiki:~/bin/wikis/binefa_cat$ docker exec -it binefa_cat_db_docker bash -l
root@6944309dd20a:/# mysql -u ''usuari_sql'' -p
Enter password: ''contrasenya_usuari_sql''
mysql> show databases;
+--------------------+
| Database |
+--------------------+
| information_schema |
| wiki_binefa_cat |
+--------------------+
2 rows in set (0.00 sec)

mysql> drop database wiki_binefa_cat;
Query OK, 48 rows affected (0.09 sec)
mysql> create database wiki_binefa_cat;
Query OK, 1 row affected (0.00 sec)

mysql> quit
Bye
root@6944309dd20a:/# exit
logout
jordi@vps-7d867fbd:~/bin/wikis/binefa_cat$ docker exec -i binefa_cat_db_docker mysql -u jordi -pfuroner2017 wiki_binefa_cat < wiki_binefa_cat.sql
Warning: Using a password on the command line interface can be insecure.

Copieu '''LocalSettings.php''' a la carpeta indicada als volums de l'arxiu docker-compose.yml (a l'exemple /home/jordi/bin/wikis/binefa_cat/wikibinefacat). Verifiqueu que hi consta l'adreça final real de la wiki:
$wgServer = "https://wiki2.binefa.cat";

Torneu a executar el contenidor:
docker-compose run --name wiki_binefa_cat -e VIRTUAL_HOST="wiki2.binefa.cat" -e LETSENCRYPT_HOST="wiki2.binefa.cat" -d web

== Arxiu docker-compose.yml per a la connexió amb la base de dades actualitzada ==
### Based on https://kindalame.com/2020/11/25/self-hosting-mediawiki-with-docker/
### Docker Compose Example for Kinda Lame
### Created October 2020
### Modified August 2021 by Jordi Binefa
###
version: '3.3'
services:
web:
###
### We suggest using the LTS, long term support images
###
image: mediawiki:1.29.0
ports:
- 80:80
- 443:443
- 3309:3306
links:
- database
restart: unless-stopped
volumes:
- /home/jordi/bin/wikis/binefa_cat/wikibinefacat/images:/var/www/html/images
'''- /home/jordi/bin/wikis/binefa_cat/wikibinefacat/LocalSettings.php:/var/www/html/LocalSettings.php'''
'''- /home/jordi/bin/wikis/binefa_cat/wikibinefacat:/var/www/html'''
# - /home/jordi/bin/wikis/binefa_cat/php:/usr/local/etc/php
networks:
- "net"
database:
container_name: binefa_cat_db_docker
image: mysql:5.6.48
ports:
- '''3309''':3306
environment:
MYSQL_DATABASE: 'nom_base_de_dades_sql'
MYSQL_USER: 'usuari_sql'
#
# Generate a secure password and place it in the area below
#
MYSQL_PASSWORD: 'contrasenya_usuari_sql'
MYSQL_ROOT_PASSWORD: 'contrasenya_mestra_sql'
MYSQL_RANDOM_ROOT_PASSWORD: 'no'
volumes:
- /home/jordi/bin/wikis/binefa_cat/database:/var/lib/mysql
restart: unless-stopped
networks:
- "net"

volumes:
certs:
html:
vhost:
dhparam:

networks:
net:
external: true

= En marxa =
Assegureu-vos de no haver copiat l'arxiu '''.htaccess'''. Si el teniu, esborreu-lo o canvieu-li el nom.

Des del directori a on hi ha l'arxiu docker-compose.yml (per exemple ~/bin/wikis/binefa_cat):
docker-compose run --name wiki_binefa_cat -e VIRTUAL_HOST="wiki2.things.cat" -e LETSENCRYPT_HOST="wiki2.things.cat" -d web

Un cop verificat el seu funcionament, per a migrar-lo a l'adreça definitiva:
docker stop wiki_binefa_cat
docker rm wiki_binefa_cat

Editeu '''LocalSettings.php''' i modifiqueu la variable $wgServer per a que apunti al domini definitiu:
$wgServer = "https://wiki.binefa.cat";

Torneu a executar el contenidor docker amb el nom de domini definitiu:
docker-compose run --name wiki_binefa_cat -e VIRTUAL_HOST="wiki.things.cat" -e LETSENCRYPT_HOST="wiki.things.cat" -d web

Així mateix ho podeu fer amb la resta de dominis que tingueu compartits al VPS:

Des del directori a on hi ha l'arxiu docker-compose.yml (per exemple ~/bin/wikis/things_cat):
docker-compose run --name wiki_things_cat -e VIRTUAL_HOST="wiki.things.cat" -e LETSENCRYPT_HOST="wiki.things.cat" -d web

Des del directori a on hi ha l'arxiu docker-compose.yml (per exemple ~/bin/wikis/binefa_com):
docker-compose run --name wiki_binefa_com -e VIRTUAL_HOST="wiki.binefa.com" -e LETSENCRYPT_HOST="wiki.binefa.com" -d web

= docker-compose.yml de things.cat =
### Based on https://kindalame.com/2020/11/25/self-hosting-mediawiki-with-docker/
### Docker Compose Example for Kinda Lame
### Created October 2020
### Modified August 2021 by Jordi Binefa
###
version: '3.3'
services:
web:
# image: mediawiki:lts # Es recomana la versió LTS per a wikis a partir de zero
image: mediawiki:1.31.3 # Aquesta versió era l'original. Recomanen fer servir la mateixa per a la migració
ports:
### We are running the server behind NGINX which we
### recommend all users doing. And due to the need to
### login to the site we recommend running Certbot
### on your domain and putting the proxy behind
### an SSL certificate to keep your passwords safe!
###
- 80:80
- 443:443
- '''3307''':3306 # Es connecta amb la base de dades de sota mitjançant el port 3307. Això ens permet posar diferents bases de dades
links:
- database
restart: unless-stopped
volumes:
- /home/jordi/bin/wikis/things_cat/www_things_cat_segur/images:/var/www/html/images
- /home/jordi/bin/wikis/things_cat/www_things_cat_segur/LocalSettings.php:/var/www/html/LocalSettings.php
- /home/jordi/bin/wikis/things_cat/www_things_cat_segur:/var/www/html
# - /home/jordi/bin/wikis/things_cat/php:/usr/local/etc/php
networks:
- "'''net'''"
database:
container_name: things_cat_db_docker
image: mysql:5.6.48
ports:
- '''3307''':3306 # Es connecta amb la wiki de dalt mitjançant el port 3307. Això ens permet posar diferents bases de dades
environment:
MYSQL_DATABASE: 'wiki_things_cat'
MYSQL_USER: 'usuari_BD_things'
#
# Generate a secure password and place it in the area below
#
MYSQL_PASSWORD: 'contrasenya_BD_things'
MYSQL_ROOT_PASSWORD: 'alguna'
MYSQL_RANDOM_ROOT_PASSWORD: 'no'
volumes:
- /home/jordi/bin/wikis/things_cat/database:/var/lib/mysql
restart: unless-stopped
networks:
- "'''net'''"

volumes:
certs:
html:
vhost:
dhparam:

networks:
'''net''':
external: true

= docker-compose.yml de binefa.com =
### Based on https://kindalame.com/2020/11/25/self-hosting-mediawiki-with-docker/
### Docker Compose Example for Kinda Lame
### Created October 2020
### Modified August 2021 by Jordi Binefa
###
version: '3.3'
services:
web:
###
### We suggest using the LTS, long term support images
###
# image: mediawiki:lts # Es recomana la versió LTS per a wikis a partir de zero
image: mediawiki:1.33.0 # Aquesta versió era l'original. Recomanen fer servir la mateixa per a la migració
ports:
- 80:80
- 443:443
- '''3308''':3306 # Es connecta amb la base de dades de sota mitjançant el port 3308. Això ens permet posar diferents bases de dades
links:
- database
restart: unless-stopped
volumes:
- /home/jordi/bin/wikis/binefa_com/www_binefa_com/images:/var/www/html/images
- /home/jordi/bin/wikis/binefa_com/www_binefa_com/LocalSettings.php:/var/www/html/LocalSettings.php
- /home/jordi/bin/wikis/binefa_com/www_binefa_com:/var/www/html
# - /home/jordi/bin/wikis/binefa_com/php:/usr/local/etc/php
networks:
- "'''net'''"
database:
container_name: binefa_com_db_docker
image: mysql:5.6.48
ports:
- '''3308''':3306 # Es connecta amb la wiki de dalt mitjançant el port 3308. Això ens permet posar diferents bases de dades
environment:
MYSQL_DATABASE: 'wiki_binefa_com'
MYSQL_USER: 'usuari_BD_binefa_com'
#
# Generate a secure password and place it in the area below
#
MYSQL_PASSWORD: 'contrasenya_BD_binefa_com'
MYSQL_ROOT_PASSWORD: 'algunaAltra'
MYSQL_RANDOM_ROOT_PASSWORD: 'no'
volumes:
- /home/jordi/bin/wikis/binefa_com/database:/var/lib/mysql
restart: unless-stopped
networks:
- "'''net'''"

volumes:
certs:
html:
vhost:
dhparam:

networks:
'''net''':
external: true

Migració d'una wiki a una altra dockeritzada

2024-09-28T20:16:18Z

Jordi Binefa : /* Connexió amb la base de dades */

= Còpia de la wiki original =
La migració explicada a aquesta pàgina és per a poder integrar una wiki preexistent darrere un [[Servidor intermediari invers]].

* Feu una còpia de la base de dades de la wiki (en aquesta explicació serà ''wiki_binefa_cat.sql''). Si no us recordeu dels paràmetres, feu-li un cop d'ull a l'arxiu '''LocalSettings.php''' present al directori arrel de la wiki.

* Feu una còpia del directori arrel de la wiki

= Prova del contenidor docker a migrar =
Es cerca la versió actual del wiki en funcionament a l'enllaç "[https://wiki.binefa.cat/index.php?title=Especial:P%C3%A0gines_especials Pàgines especials]" / "[https://wiki.binefa.cat/index.php?title=Especial:Versi%C3%B3 Versió]". En el cas d'aquest exemple és la versió 1.29.0

Es prova el funcionament, sense volums associats ni base de dades, a un domini secundari de prova (Aquest domini ha d'estar configurat a la configuració DNS del nostre proveïdor de nom de domini):
docker run --name wiki_binefa_cat --network net -e VIRTUAL_HOST="wiki2.binefa.cat" -e LETSENCRYPT_HOST="wiki2.binefa.cat" -d mediawiki:1.29.0
Un cop provat que funciona el servei web de la mediawiki, es desactiva el servei:
docker stop wiki_binefa_cat
docker rm wiki_binefa_cat

= Connexió amb la base de dades =
Per tal de poder fer servir més d'una base de dades al nostre sistema dockeritzat, es canvia el port normal de funcionament a les bases de dades SQL, el 3306, per un altre exclusiu per al servei de cada wiki, en aquest cas és el 3309.

També es comenten els volums relacionats amb el contingut html de la wiki a migrar i de l'arxiu LocalSettings.php

Al mateix directori a on és [https://www.things.cat/index.php/Migraci%C3%B3_d%27una_wiki_a_una_altra_dockeritzada#Arxiu_docker-compose.yml_per_a_la_primera_connexi.C3.B3_amb_la_base_de_dades docker-compose.yml] executem el contenidor docker:
docker-compose run --name wiki_binefa_cat -e VIRTUAL_HOST="wiki2.binefa.cat" -e LETSENCRYPT_HOST="wiki2.binefa.cat" -d web

Es verifica la correcta execució del contenidor docker:
jordi@vps-wiki:~/bin/wikis/binefa_cat$ '''docker ps -a'''
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
03e0b6d10eda mediawiki:1.29.0 "docker-php-entrypoi…" 11 minutes ago Up 11 minutes 80/tcp wiki_binefa_cat
6944309dd20a mysql:5.6.48 "docker-entrypoint.s…" 14 minutes ago Up 14 minutes 0.0.0.0:3309->3306/tcp, :::3309->3306/tcp binefa_cat_db_docker

Es consulta l'adreça IP del contenidor de la base de dades dins de la xarxa local de contenidors (necessari per a la configuració de la mediawiki per la generació de l'arxiu LocalSettings.php):
<pre>jordi@vps-wiki:~/bin/wikis/binefa_cat$ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' binefa_cat_db_docker
172.18.0.11</pre>

Aneu al navegador d'Internet i aneu a la pàgina de la wiki (en aquest exemple seria https://wiki2.binefa.cat). Si tot va bé, hi surt:
MediaWiki 1.29.0
LocalSettings.php not found.
Please set up the wiki first.

Premeu a sobre de ''Please set up the wiki first''. La primera pàgina és ''Instal·lació del MediaWiki 1.29.0''. Seleccioneu la vostra llengua i la llengua de la wiki. A les dues he seleccionat ''ca - català''.

Després de prémer el botó per a continuar, i si tot ha anat bé, hi surt una pàgina amb aquest text de color verd: ''S'ha comprovat l'entorn. Podeu instal·lar el MediaWiki''.

La següent pàgina és la de connexió a la base de dades. Per a saber quines dades posar, feu-li una ullada al vostre arxiu LocalSettings.php original. En aquest exemple fem servir aquests valors:
$wgDBtype = "mysql";
$wgDBserver = "'''172.18.0.11'''";
$wgDBname = "nom_base_de_dades_sql";
$wgDBuser = "usuari_sql";
$wgDBpassword = "contrasenya_usuari_sql";
$wgDBprefix = "wiki_bc";

Per defecte hi surt que el tipus és ''MySQL (o compatible)'', i així ha de ser. Al ''Servidor de la base de dades'' hi surt ''localhost'' per defecte i '''ho heu de canviar per la IP del contenidor de la base de dades dins de la xarxa local de contenidors''' (en aquest exemple és 172.18.0.11). Poseu-hi el nom de la base de dades (''nom_base_de_dades_sql''), el prefix de la base de dades (''wiki_bc''). Per a aquest configuració inicial fem servir com a nom de l'usuari de la base de dades ''usuari_sql'' i com a contrasenya ''contrasenya_usuari_sql''.

La pàgina següent mostra aquestes seleccions per defecte (no les modifiqueu): Compte de la base de dades per a l'accés web ''Utilitza el mateix compte que a la instal·lació'', Motor d'emmagatzemament ''InnoDB'' i Joc de caràcters de la base de dades ''binari''.

La pàgina següent us pregunta pel nom de la wiki, el vostre nom d'usuari, contrasenya i correu electrònic. Seleccioneu Fes-me més preguntes, que ja hi és per defecte.

La pàgina següent es sobre permisos. He seleccionat a Perfil de permisos d'usuari: Només editors autoritzats, Copyright i llicència: Creative Commons Reconeixement-CompartirIgual. A Paràmetres del correu electrònic he desactivat els correus sortints. A Extensions he seleccionat ImageMap, Interwiki, Nuke i WikiEditor. A Imatges i càrregues de fitxers he habilitat Habilita la càrrega de fitxers. La resta d'opcions no les he canviat del seu estat per defecte.

Després de continuar les dues següents pàgines informatives ens demana desar l'arxiu '''LocalSettings.php''' (és molt important desar-lo per poder continuar el següent pas).

== Arxiu docker-compose.yml per a la primera connexió amb la base de dades ==
### Based on https://kindalame.com/2020/11/25/self-hosting-mediawiki-with-docker/
### Docker Compose Example for Kinda Lame
### Created October 2020
### Modified August 2021 by Jordi Binefa
###
version: '3.3'
services:
web:
###
### We suggest using the LTS, long term support images
###
image: mediawiki:1.29.0
ports:
- 80:80
- 443:443
- '''3309''':3306
links:
- database
restart: unless-stopped
volumes:
- /home/jordi/bin/wikis/binefa_cat/wikibinefacat/images:/var/www/html/images
'''# - /home/jordi/bin/wikis/binefa_cat/wikibinefacat/LocalSettings.php:/var/www/html/LocalSettings.php'''
'''# - /home/jordi/bin/wikis/binefa_cat/wikibinefacat:/var/www/html'''
'''# - /home/jordi/bin/wikis/binefa_cat/php:/usr/local/etc/php'''
networks:
- "net"
database:
container_name: binefa_cat_db_docker
image: mysql:5.6.48
ports:
- '''3309''':3306
environment:
MYSQL_DATABASE: 'nom_base_de_dades_sql'
MYSQL_USER: 'usuari_sql'
#
# Generate a secure password and place it in the area below
#
MYSQL_PASSWORD: 'contrasenya_usuari_sql'
MYSQL_ROOT_PASSWORD: 'contrasenya_mestra_sql'
MYSQL_RANDOM_ROOT_PASSWORD: 'no'
volumes:
- /home/jordi/bin/wikis/binefa_cat/database:/var/lib/mysql
restart: unless-stopped
networks:
- "net"

volumes:
certs:
html:
vhost:
dhparam:

networks:
net:
external: true

= Recàrrega de la base de dades =
Atureu el contenidor docker de la wiki, però no el de la base de dades:
docker stop rm_binefa_cat
docker rm wiki_binefa_cat

jordi@vps-wikie:~/bin/wikis/binefa_cat$ docker exec -i binefa_cat_db_docker mysql -u jordi -pfuroner2017 wiki_binefa_cat < wiki_binefa_cat.sql
Warning: Using a password on the command line interface can be insecure.
'''ERROR 1050 (42S01) at line 30: Table 'wiki_bcarchive' already exists'''

Per a evitar aquest error:
jordi@vps-wiki:~/bin/wikis/binefa_cat$ docker exec -it binefa_cat_db_docker bash -l
root@6944309dd20a:/# mysql -u ''usuari_sql'' -p
Enter password: ''contrasenya_usuari_sql''
mysql> show databases;
+--------------------+
| Database |
+--------------------+
| information_schema |
| wiki_binefa_cat |
+--------------------+
2 rows in set (0.00 sec)

mysql> drop database wiki_binefa_cat;
Query OK, 48 rows affected (0.09 sec)
mysql> create database wiki_binefa_cat;
Query OK, 1 row affected (0.00 sec)

mysql> quit
Bye
root@6944309dd20a:/# exit
logout
jordi@vps-7d867fbd:~/bin/wikis/binefa_cat$ docker exec -i binefa_cat_db_docker mysql -u jordi -pfuroner2017 wiki_binefa_cat < wiki_binefa_cat.sql
Warning: Using a password on the command line interface can be insecure.

Copieu '''LocalSettings.php''' a la carpeta indicada als volums de l'arxiu docker-compose.yml (a l'exemple /home/jordi/bin/wikis/binefa_cat/wikibinefacat). Verifiqueu que hi consta l'adreça final real de la wiki:
$wgServer = "https://wiki2.binefa.cat";

Torneu a executar el contenidor:
docker-compose run --name wiki_binefa_cat -e VIRTUAL_HOST="wiki2.binefa.cat" -e LETSENCRYPT_HOST="wiki2.binefa.cat" -d web

== Arxiu docker-compose.yml per a la connexió amb la base de dades actualitzada ==
### Based on https://kindalame.com/2020/11/25/self-hosting-mediawiki-with-docker/
### Docker Compose Example for Kinda Lame
### Created October 2020
### Modified August 2021 by Jordi Binefa
###
version: '3.3'
services:
web:
###
### We suggest using the LTS, long term support images
###
image: mediawiki:1.29.0
ports:
- 80:80
- 443:443
- 3309:3306
links:
- database
restart: unless-stopped
volumes:
- /home/jordi/bin/wikis/binefa_cat/wikibinefacat/images:/var/www/html/images
'''- /home/jordi/bin/wikis/binefa_cat/wikibinefacat/LocalSettings.php:/var/www/html/LocalSettings.php'''
'''- /home/jordi/bin/wikis/binefa_cat/wikibinefacat:/var/www/html'''
# - /home/jordi/bin/wikis/binefa_cat/php:/usr/local/etc/php
networks:
- "net"
database:
container_name: binefa_cat_db_docker
image: mysql:5.6.48
ports:
- '''3309''':3306
environment:
MYSQL_DATABASE: 'nom_base_de_dades_sql'
MYSQL_USER: 'usuari_sql'
#
# Generate a secure password and place it in the area below
#
MYSQL_PASSWORD: 'contrasenya_usuari_sql'
MYSQL_ROOT_PASSWORD: 'contrasenya_mestra_sql'
MYSQL_RANDOM_ROOT_PASSWORD: 'no'
volumes:
- /home/jordi/bin/wikis/binefa_cat/database:/var/lib/mysql
restart: unless-stopped
networks:
- "net"

volumes:
certs:
html:
vhost:
dhparam:

networks:
net:
external: true

= En marxa =
Assegureu-vos de no haver copiat l'arxiu '''.htaccess'''. Si el teniu, esborreu-lo o canvieu-li el nom.

Des del directori a on hi ha l'arxiu docker-compose.yml (per exemple ~/bin/wikis/binefa_cat):
docker-compose run --name wiki_binefa_cat -e VIRTUAL_HOST="wiki2.things.cat" -e LETSENCRYPT_HOST="wiki2.things.cat" -d web

Un cop verificat el seu funcionament, per a migrar-lo a l'adreça definitiva:
docker stop wiki_binefa_cat
docker rm wiki_binefa_cat

Editeu '''LocalSettings.php''' i modifiqueu la variable $wgServer per a que apunti al domini definitiu:
$wgServer = "https://wiki.binefa.cat";

Torneu a executar el contenidor docker amb el nom de domini definitiu:
docker-compose run --name wiki_binefa_cat -e VIRTUAL_HOST="wiki.things.cat" -e LETSENCRYPT_HOST="wiki.things.cat" -d web

Així mateix ho podeu fer amb la resta de dominis que tingueu compartits al VPS:

Des del directori a on hi ha l'arxiu docker-compose.yml (per exemple ~/bin/wikis/things_cat):
docker-compose run --name wiki_things_cat -e VIRTUAL_HOST="wiki.things.cat" -e LETSENCRYPT_HOST="wiki.things.cat" -d web

Des del directori a on hi ha l'arxiu docker-compose.yml (per exemple ~/bin/wikis/binefa_com):
docker-compose run --name wiki_binefa_com -e VIRTUAL_HOST="wiki.binefa.com" -e LETSENCRYPT_HOST="wiki.binefa.com" -d web

= docker-compose.yml de things.cat =
### Based on https://kindalame.com/2020/11/25/self-hosting-mediawiki-with-docker/
### Docker Compose Example for Kinda Lame
### Created October 2020
### Modified August 2021 by Jordi Binefa
###
version: '3.3'
services:
web:
# image: mediawiki:lts # Es recomana la versió LTS per a wikis a partir de zero
image: mediawiki:1.31.3 # Aquesta versió era l'original. Recomanen fer servir la mateixa per a la migració
ports:
### We are running the server behind NGINX which we
### recommend all users doing. And due to the need to
### login to the site we recommend running Certbot
### on your domain and putting the proxy behind
### an SSL certificate to keep your passwords safe!
###
- 80:80
- 443:443
- '''3307''':3306 # Es connecta amb la base de dades de sota mitjançant el port 3307. Això ens permet posar diferents bases de dades
links:
- database
restart: unless-stopped
volumes:
- /home/jordi/bin/wikis/things_cat/www_things_cat_segur/images:/var/www/html/images
- /home/jordi/bin/wikis/things_cat/www_things_cat_segur/LocalSettings.php:/var/www/html/LocalSettings.php
- /home/jordi/bin/wikis/things_cat/www_things_cat_segur:/var/www/html
# - /home/jordi/bin/wikis/things_cat/php:/usr/local/etc/php
networks:
- "'''net'''"
database:
container_name: things_cat_db_docker
image: mysql:5.6.48
ports:
- '''3307''':3306 # Es connecta amb la wiki de dalt mitjançant el port 3307. Això ens permet posar diferents bases de dades
environment:
MYSQL_DATABASE: 'wiki_things_cat'
MYSQL_USER: 'usuari_BD_things'
#
# Generate a secure password and place it in the area below
#
MYSQL_PASSWORD: 'contrasenya_BD_things'
MYSQL_ROOT_PASSWORD: 'alguna'
MYSQL_RANDOM_ROOT_PASSWORD: 'no'
volumes:
- /home/jordi/bin/wikis/things_cat/database:/var/lib/mysql
restart: unless-stopped
networks:
- "'''net'''"

volumes:
certs:
html:
vhost:
dhparam:

networks:
'''net''':
external: true

= docker-compose.yml de binefa.com =
### Based on https://kindalame.com/2020/11/25/self-hosting-mediawiki-with-docker/
### Docker Compose Example for Kinda Lame
### Created October 2020
### Modified August 2021 by Jordi Binefa
###
version: '3.3'
services:
web:
###
### We suggest using the LTS, long term support images
###
# image: mediawiki:lts # Es recomana la versió LTS per a wikis a partir de zero
image: mediawiki:1.33.0 # Aquesta versió era l'original. Recomanen fer servir la mateixa per a la migració
ports:
- 80:80
- 443:443
- '''3308''':3306 # Es connecta amb la base de dades de sota mitjançant el port 3308. Això ens permet posar diferents bases de dades
links:
- database
restart: unless-stopped
volumes:
- /home/jordi/bin/wikis/binefa_com/www_binefa_com/images:/var/www/html/images
- /home/jordi/bin/wikis/binefa_com/www_binefa_com/LocalSettings.php:/var/www/html/LocalSettings.php
- /home/jordi/bin/wikis/binefa_com/www_binefa_com:/var/www/html
# - /home/jordi/bin/wikis/binefa_com/php:/usr/local/etc/php
networks:
- "'''net'''"
database:
container_name: binefa_com_db_docker
image: mysql:5.6.48
ports:
- '''3308''':3306 # Es connecta amb la wiki de dalt mitjançant el port 3308. Això ens permet posar diferents bases de dades
environment:
MYSQL_DATABASE: 'wiki_binefa_com'
MYSQL_USER: 'usuari_BD_binefa_com'
#
# Generate a secure password and place it in the area below
#
MYSQL_PASSWORD: 'contrasenya_BD_binefa_com'
MYSQL_ROOT_PASSWORD: 'algunaAltra'
MYSQL_RANDOM_ROOT_PASSWORD: 'no'
volumes:
- /home/jordi/bin/wikis/binefa_com/database:/var/lib/mysql
restart: unless-stopped
networks:
- "'''net'''"

volumes:
certs:
html:
vhost:
dhparam:

networks:
'''net''':
external: true

Pàgina principal

2024-08-07T17:02:16Z

Jordi Binefa : /* Raspbian */

<span style="font-size:500%">things.cat</span><BR>
<span style="font-size:300%">Una pàgina pràctica sobre la Internet de les Coses</span>

= Dispositius IoT. Maquinari i microprogramari =
Al '''maquinari''' li diem'' '''hardware''' ''en anglès.

Al '''microprogramari''' li diem'' '''firmware''' ''en anglès.

'''IoT''' és l'acrònim d'''Internet of Things''. En català abreujat li podríem dir '''IdC''' per a referir-nos a '''la Internet de les Coses'''. En el moment d'escriure aquest text, la comunitat catalanoparlant sembla haver optat per referir-se als '''dispositius de la Internet de les Coses''' com a '''dispositius IoT'''. Si el [https://www.termcat.cat/ca/neoloteca/ termcat] es pronuncia de manera diferent, provaré d'adaptar la terminologia.

== Placa IoT-02 ==
[https://www.binefa.com/index.php/Placa_IoT-02 Placa_IoT-02]

== Controladors ==
Als '''controladors''' els hi diem'' '''drivers''' ''en anglès.

El xip '''FT232''' ha estat durant molt de temps el xip més comú per convertir d''''USB a UART'''. Fins al punt que se'n van fer còpies pirates. Una actualització del sistema operatiu privatiu Windows va explotar una característica dels xips pirates: els xips pirates tenien el registre d'identificació USB de lectura i escriptura i l'original era tan sols de lectura. L'actualització que va fer Windows provocava l'escriptura d'aquest registre i hi escrivia un zero, que feia que el sistema operatiu ho identifiqués com a concentrador USB i no com a controlador d'UART, fent que el maquinari quedés inservible. A l'any 2014 em vaig veure atrapat amb uns quants Arduino Nano que duien aquest xip pirata i vaig escriure [https://binefa.cat/blog/?p=80 How to recover bricked fake FT232] per a poder-los reprogramar i poder-los fer servir amb sistemes operatius lliures GNU/Linux.

A partir d'aquell moment, bona part de les plaques de fabricació xinesa van començar a dur, massivament, el xip '''CH340''' per a convertir d'USB a UART.

[[Controlador CH340]]

[[Controlador FT232]]

== C / C++ ==
[https://github.com/jordibinefa/arduino-IDE-libraries Biblioteques per Arduino, ESP8266 i ESP32]

[https://github.com/jordibinefa/arduino-IDE-codes Codis per Arduino, ESP8266 i ESP32]

=== ESP8266 ===
[https://wiki.binefa.cat/index.php?title=Afegint_la_targeta_ESP8266_a_l%27IDE_d%27Arduino Afegint la targeta ESP8266 a l'IDE d'Arduino] (NodeMCU1.0)

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp8266_udpServer_01b esp8266_udpServer_01.ino] Codi UDP per a ESP8266

[https://wiki.binefa.cat/index.php?title=MQTT_a_l%27ESP8266 MQTT a l'ESP8266]

=== ESP32 ===
[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_udpServer_01b esp32_udpServer_01b] Codi UDP per a ESP32

[https://github.com/jordibinefa/arduino-IDE-codes/tree/master/esp32_i2cScanner_02 esp32_i2cScanner_02.ino Adreces de dispositius I2C connectats]

[https://binefa.cat/IoT/modbus/rtu/esp32/ Exemple de ModBus RTU fent servir NodeRED i ESP32 (amb la placa IoT PLB)]

[https://techtutorialsx.com/2017/05/06/esp32-arduino-creating-a-task/ ESP32 Arduino: Creating a FreeRTOS task]

[https://savjee.be/2020/01/multitasking-esp32-arduino-freertos/ Multitasking on ESP32 with Arduino and FreeRTOS]

==== Modbus ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/uart.html#overview-of-rs485-specific-communication-options Overview of RS485 specific communication options]

[https://pastebin.com/2PtWJvd6 Example setting RS485 at half duplex mode]

[https://github.com/jordibinefa/IoT-02/tree/master/codes/IoT-02_11_modbus_bme280_02 Code IoT-02_11_modbus_bme280_02] using RS485 at half duplex mode

==== ESP-IDF ====
[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/ Get Started]

[https://docs.platformio.org/en/latest/tutorials/espressif32/espidf_debugging_unit_testing_analysis.html Get started with ESP-IDF and ESP32-DevKitC: debugging, unit testing, project analysis]

== Python ==
=== Accés al maquinari de la Raspberry Pi emprant Python ===
[https://wiki.binefa.cat/index.php?title=Com_connectar-hi_pantalles_OLED_SSD1306_(128x64) Com connectar-hi pantalles OLED SSD1306 (128x64)]

[https://wiki.binefa.cat/index.php?title=%C3%9As_d%27entrades_anal%C3%B2giques_amb_l%27ADS115_controlant_sortides_PWM Ús d'entrades analògiques amb l'ADS115 controlant sortides PWM]

=== Micropython ===
[https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome Micropython and the Internet of Things]

[https://github.com/micropython/micropython/tree/master/ports/esp8266 MicroPython port to ESP8266]

[https://github.com/micropython/micropython/tree/master/ports/esp32 MicroPython port to the ESP32]

[https://icircuit.net/esp32-micropython-getting-started/1999 ESP32 – Getting started with MicroPython]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-on-the-esp32-decdd32c4720 Get on the Good Foot with MicroPython on the ESP32]

[https://hackernoon.com/get-on-the-good-foot-with-micropython-part-2-e1f2efaad50b Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor DS18B20 (One Wire Interface)]

[https://github.com/gloveboxes/ESP32-MicroPython-BME280-MQTT-Sample Exemple en micropython de comunicació MQTT amb un ESP32 i el sensor BME280 (I2C)]

=== CircuitPython ===
[https://learn.adafruit.com/circuitpython-with-esp32-quick-start CircuitPython on ESP32 Quick Start]

== Sistemes operatius encastats ==
=== Raspbian ===
[https://www.raspberrypi.org/documentation/computers/remote-access.html Remote Access]

[https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ How to Install Mosquitto Broker on Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Adaptaci%C3%B3_per_a_que_la_Raspberry_Pi_funcioni_com_a_punt_d%27acc%C3%A9s_donant_adreces_IP_de_classe_B Adaptació per a que la Raspberry Pi funcioni com a punt d'accés donant adreces IP de classe B]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_dels_nodes_node-red-contrib-ttn_i_node-red-contrib-modbustcp-no-pooling_a_la_Raspberry_Pi Instal·lació dels nodes node-red-contrib-ttn i node-red-contrib-modbustcp-no-pooling a la Raspberry Pi]

[https://wiki.binefa.cat/index.php?title=Instal%C2%B7laci%C3%B3_de_l%27OPC-UA_a_la_Raspberry_Pi,_fent_servir_Python,_i_control_des_d%27Indusoft Instal·lació de l'OPC-UA a la Raspberry Pi, fent servir Python, i control des d'Indusoft]

[https://wiki.binefa.cat/index.php?title=Pr%C3%A0ctica_de_connexi%C3%B3_remota_a_una_Raspberry_Pi Pràctica de connexió remota a una Raspberry Pi]

[https://core-electronics.com.au/guides/read-only-raspberry-pi/ Read-Only Raspberry Pi - Never Corrupt your Micro-SD Card]

=== Mongoose OS ===
[https://mongoose-os.com/docs/mongoose-os/quickstart/setup.md Guia ràpida d'introducció a Mongoose OS][en]

== Sensors ==
[[Sensors de so]]

= Control remot dels dispositius IoT. Programari =
Al '''programari''' li diuen'' '''software''' ''en anglès.

== Protocols ==
[https://binefa.cat/IoT/teoria/ethernetTcpUdp_00.pdf TCP/UDP Capa de transport d'Ethernet]

[[Instal·lació d'un servidor de sòcols web a un Debian amb Apache]]

=== MQTT(S) ===
[https://binefa.cat/IoT/teoria/mqtt_00.pdf Introducció a MQTT]

[http://www.steves-internet-guide.com/mqtt/ Beginners Guide To The MQTT Protocol] by Steve's Internet Guide

[https://www.rs-online.com/designspark/mqtt MQTT] explained by Andy Stanford-Clark (co-inventor of MQTT). Article written in 2017, and refering to v3.1.1

[https://www.hivemq.com/mqtt-5/ MQTT 5 Essentials] by HiveMQ

[http://www.steves-internet-guide.com/mqtt-hosting-brokers-and-servers/ MQTT Brokers/Servers and Cloud Hosting Guide] by Steve's Internet Guide

[http://mqtt-explorer.com/ MQTT Explorer] An all-round MQTT client that provides a structured topic overview

[https://github.com/pixavier/mqtt4snap MQTT a Snap!]

==== Public MQTT(S) brokers ====
[http://test.mosquitto.org/ mosquitto]

[https://www.hivemq.com/public-mqtt-broker/ HiveMQ MQTT broker]

[https://diyprojects.io/8-online-mqtt-brokers-iot-connected-objects-cloud/ MQTT brokers online with a free offer to test and connect IoT to the internet]

==== MQTT(S) implementations ====
[http://binefa.com/index.php?title=MQTTS_y_NodeRED MQTTS y NodeRED]

[https://en.wikipedia.org/wiki/Comparison_of_MQTT_implementations Comparison of MQTT implementations]

[http://test.mosquitto.org/ test.mosquitto.org]

[https://www.emqx.io/ emqx.io]

[https://vernemq.com/ VerneMQ]

=== Webhooks ===
[https://hookdeck.com/guides/webhooks/what-are-webhooks-how-they-work What Are Webhooks And How They Work]

[[Exemple bàsic de funcionament de Webhooks. Servidor i client en node.js]]

== Programació local (ordinadors d'escriptori i dispositius mòbils) ==
[https://binefa.cat/IoT/mqtt/MQTT_Dash/ Configuració de MQTT Dash (aplicació per Android)]

=== Mosquitto local a l'ordinador ===
[https://www.vultr.com/docs/how-to-install-mosquitto-mqtt-broker-server-on-ubuntu-16-04 How to Install Mosquitto MQTT Broker/Server on Ubuntu 16.04]

[http://www.steves-internet-guide.com/downloads/ Instal·lació de Mosquitto a Windows]

Per a actualitzar les claus dels dipòsits de Debian:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key

=== SCADA ===
[https://wiki.binefa.cat/index.php?title=SCADA_fent_servir_Python_QML_i_Arduino SCADA fent servir Python QML i Arduino]

== Núvol ==
=== Instal·lació de Node.js i npm ===
[https://github.com/nodesource/distributions/blob/master/README.md Instal·lació de node i npm]
ecat@iot-ecat:~$ '''sudo bash'''
root@iot-ecat:/home/ecat# '''curl -sL https://deb.nodesource.com/setup_14.x | bash -'''
root@iot-ecat:/home/ecat# '''apt install -y nodejs'''
root@iot-ecat:/home/ecat# '''exit'''
ecat@iot-ecat:~$ '''node --version'''
v14.15.4
ecat@iot-ecat:~$ '''npm -- version'''
6.14.10

=== Node-RED ===
[https://binefa.cat/IoT/nodeRed/nodeRed01.pdf Introducció al Node-RED]

[[Gestió de Node-RED]]

[https://www.aprendiendoarduino.com/cursos/node-red-developer-para-iot-nivel-i/ Node-RED Developer para IoT. Nivel I]

==== Instal·lació i funcionament del NodeRed autònom ====
ecat@iot-ecat:~$ '''mkdir bin'''
ecat@iot-ecat:~$ '''cd bin'''
ecat@iot-ecat:~/bin$ '''sudo apt install unzip'''
ecat@iot-ecat:~/bin$ '''mkdir nodered-ui'''
ecat@iot-ecat:~/bin$ '''cd nodered-ui'''
ecat@iot-ecat:~/bin/nodered-ui$ '''wget https://www.binefa.cat/IoT/nodeRed/node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''unzip node_red_ui.zip'''
ecat@iot-ecat:~/bin/nodered-ui$ '''node node_modules/node-red/red.js --userDir node_modules/node-red/data --settings node_modules/node-red/settings.js -v --port 2222 --title elmeuTitol --safe flows_meuTitol.json'''

==== UDP ====
[https://binefa.cat/IoT/nodeRed/prj/udpServer/udpServer_nodered_code.txt Codi NodeRED per a esp8266_udpServer_01.ino i esp32_udpServer_01b]

==== MQTT(S) ====
[https://wiki.binefa.cat/index.php?title=MQTT_i_MQTTS MQTT i MQTTS]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex00/ Exemple amb MQTT i NodeRED emprant ESP8266 i ESP32]

[https://binefa.cat/IoT/nodeRed/prj/mqtt_esp8266_esp32/ex01/ Exercici amb MQTT i NodeRED emprant ESP8266]

[[Elevador en Snap! controlat remotament amb MQTT mitjançant NodeRED fent crides HTTP]]

[http://mqtt-explorer.com/ MQTT Explorer]

==== Telegram ====
[https://wiki.binefa.cat/index.php?title=Un_exemple_d%27us_de_Telegram_amb_el_NodeRed Un exemple d'us de Telegram amb el NodeRed]

==== Modbus TCP ====
[https://binefa.cat/IoT/modbus/ Arxius per treballar amb Modbus TCP] [https://www.binefa.cat/php/doc/modbus/ El segon vídeo explica i compara Modbus RTU i Modbus TCP]

[https://binefa.cat/IoT/nodeRed/prj/modbusCtrl/ ModBus TCP al NodeRED]

==== Alguns nodes extra ====
[https://flows.nodered.org/node/node-red-contrib-google-sheets node-red-contrib-google-sheets]

[https://github.com/sammachin/node-red-contrib-google-sheets node-red-contrib-google-sheets al Github]

=== Sistemes d'emmagatzematge i visualització ===
[https://wiki.binefa.cat/index.php?title=InfluxDB Base de dades de sèries temporals InfluxDB]

[http://docs.grafana.org/installation/debian/ Instal·lació de Grafana a Debian][en]

[[Sentilo]]

=== Xarxes d'àrea estesa de baix consum (LPWAN) ===
==== Conceptes teòrics ====
[https://ca.wikipedia.org/wiki/Xarxa_de_llarg_abast Xarxa de llarg abast (WAN)]

[https://ca.wikipedia.org/wiki/Chirp_spread_spectrum Espectre eixamplat (Chirp Spread Spectrum)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_seq%C3%BC%C3%A8ncia_directa Espectre eixamplat per seqüència directa (DSSS)]

[https://ca.wikipedia.org/wiki/Espectre_eixamplat_per_salt_de_freq%C3%BC%C3%A8ncia Espectre eixamplat per salt de freqüència (FHSS)]

[https://en.wikipedia.org/wiki/LPWAN What is LPWAN?]

[https://cms.edn.com/ContentEETimes/Documents/EDN/LP%20WAN%20Comparison%20Table%20final.pdf Comparison table of Low Power WAN alternatives]

==== LoRa ====
[https://wiki.binefa.cat/index.php?title=LoRa LoRa]

==== SigFox ====
[https://docs.pycom.io/chapter/tutorials/sipy/register.html Registering SiPy with Sigfox]

[[Interacció amb SiPy1.0r de pycom]]

==== Antenes ====
[https://youtu.be/CJNq2I_PDHQ Andreas Spiess video: "#182 ESP32 Lora Boards: What you need to know before you buy (incl. Antenna knowledge)"]

=== Bots ===
==== Bot de Telegram ====
[https://wiki.binefa.cat/index.php?title=Bot_de_Telegram Bot de Telegram]

==== Bot de Mastodon ====
No totes les instàncies de [https://ca.wikipedia.org/wiki/Mastodon_(xarxa_social) Mastodon] faciliten la instal·lació de bots. Per a fer les primeres passes us recomano aquesta [https://botsin.space/ instància pensada per allotjar bots de Mastodon].

[https://botsin.space/@siarq_sensors Exemple de bot de Mastodon] per a fer lectures de sensors cada hora.

[https://gist.github.com/aparrish/661fca5ce7b4882a8c6823db12d42d26 Getting credentials for the Mastodon API with Mastodon.py, step by step]

=== VPS ===
[[Introducció als contenidors docker]]

[[Servidor intermediari invers]]

[[Mediawiki]]

[[File Browser]]

[[Apache i PHP]]

[[Redireccions a subdomini]]

[[Mastodon]]

[https://medium.com/himinds/mqtt-broker-with-secure-websocket-using-traefik-docker-compose-and-lets-encrypt-2b8e32207555 MQTT broker with Secure WebSocket using Traefik, Docker Compose and Let’s Encrypt]

[[Moodle a un servidor intermediari invers emprant Dockers]]

[[Node-RED a un servidor intermediari invers emprant Dockers]]

[[Snap! a un servidor intermediari invers emprant Dockers]]

[[VPN WireGuard]]

== Snap! ==
[https://github.com/jmoenig/Snap Snap! al GitHub]

[https://snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''amb''' SSL]. Amb el JavaScript desactivat per defecte.

[http://extensions.snap.berkeley.edu/snap/snap.html Versió pública d'Snap! '''sense''' SSL]. Amb el JavaScript desactivat per defecte.

=== JavaScript per defecte ===
Per raons de seguretat, s'ha desactivat el JavaScript per defecte. Si us munteu el vostre propi servei al núvol, per a poder cridar programes vostres amb funcions amb JavaScript, heu d'afegir aquesta línia, en negreta, a l'arxiu ''[https://github.com/jmoenig/Snap/blob/master/snap.html snap.html]'':
<script>
'''Process.prototype.enableJS = true;''' // <-- Per a tenir seleccionat el JS per defecte
var world;
window.onload = function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('sw.js');
}
world = new WorldMorph(document.getElementById('world'));
new IDE_Morph().openIn(world);
loop();
};
function loop() {
requestAnimationFrame(loop);
world.doOneCycle();
}
</script>

=== MQTT for Snap! ===
[https://github.com/pixavier/mqtt4snap MQTT4Snap !], desenvolupat per en Xavier Pi.

[https://snap.berkeley.edu/snap/snap.html#open:https://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld.xml Hello World emprant MQTT '''amb''' SSL]

[http://extensions.snap.berkeley.edu/snap/snap.html#open:http://raw.githubusercontent.com/pixavier/mqtt4snap/master/HelloWorld_NoSSL.xml Hello World emprant MQTT '''sense''' SSL]

= Una aproximació a OPC-UA =

[[OPC-UA]]

= Placa IoT-02 =
[[Placa IoT-02]]

== Programació remota (OTA) ==

[[Image:Esp32Ota.png|center|Programacio OTA de la placa IoT-02]]

=== Dos programes de prova de programació remota ===
[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_01.zip IoT-02_OTAWebUpdater_01] (Fa pampallugues el led blanc) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

[https://www.binefa.cat/training/iot02/ota/IoT-02_OTAWebUpdater_02.zip IoT-02_OTAWebUpdater_02] (Fa pampallugues el led verd) Per a que us funcioni, haureu d'actualitzar el codi amb el vostre nom de xarxa sense fils (SSID) i la vostra contrasenya d'accés.

=== Programació a la vora (''edge'') ===
L'ordinador a la vora (''edge'') pot ser un ordinador normal, habitualment de poca potència, del tipus Raspberry Pi.

Per a tenir visibilitat externa de la pàgina web servida per la placa IoT-02 (per exemple amb la IP 192.168.1.151:80), ho redireccionarem a un port ( 192.168.1.151:80 --> localhost:5001 )

Per a fer funcionar [https://www.binefa.cat/training/iot02/ota/edge/simple-port-forwarding.js simple-port-forwarding.js] caldrà haver afegit el paquet '''http-proxy''':

npm install http-proxy

El codi nodejs de redireccionament (suposant que la placa IoT-02 ha adquirit l'adreça IP 192.168.1.151):
var httpProxy = require('http-proxy');
var targetHost = '192.168.1.151';
var portOrigen = 80;
var portDesti = 5001;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

Per a fer aquest redireccionador sigui un servei, es copia [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service] a la carpeta '''/etc/systemd/system''' o el fem de nou amb un editor:

cd /etc/systemd/system
sudo nano [https://www.binefa.cat/training/iot02/ota/edge/myForwardingService.service myForwardingService.service]
sudo chmod 755 myForwardingService.service
sudo systemctl daemon-reload
sudo systemctl '''start''' myForwardingService

Per a veure l'estat del servei:
systemctl '''status''' myForwardingService

I per a fer que el servei es posi en marxa al reiniciar l'ordinador a la vora:
sudo systemctl '''enable''' myForwardingService

=== Programació al núvol ===
Mitjançant una xarxa virtual privada (VPN) de l'estil [https://www.zerotier.com/ ZeroTier] podem fer que l'ordinador a la vora i l'ordinador al núvol comparteixin la mateixa xarxa.

Suposant que l'ordinador a la vora té la IP 10.242.156.158, podem redireccionar-hi 10.242.156.158:5001 --> localhost:7007 :

var httpProxy = require('http-proxy');
var targetHost = '10.242.156.158';
var portOrigen = 5001;
var portDesti = 7007;
httpProxy.createProxyServer({target:'http://' + targetHost + ':' + portOrigen}).listen(portDesti);

I així tenim accés remot des del núvol, connectant mitjançant l'ordinador a la vora que es connecta a la placa IoT-02.

Per accedir-hi des del navegador, escriviu a la URL:
<nom_de_domini>:7007
Això visualitzarà el que presenta l'ordinador a la vora (la IP és la VPN a l'ordinador a la vora):
10.242.156.158:5001
Que al seu temps presenta el servei pel port 80 de la placa IOT-02 connectada a la mateixa xarxa local que l'ordinador a la vora:
192.168.1.151

=== Els tres mètodes de programació OTA de l'ESP32 ===
[https://www.programmersought.com/article/90864120754/ How to implement OTA online update of ESP32 firmware]

== MicroPython ==
[https://www.digikey.es/en/maker/projects/micropython-basics-load-files-run-code/fb1fcedaf11e4547943abfdd8ad825ce MicroPython Basics: Load Files & Run Code]

[https://warped3.substack.com/p/compiling-micropython-with-espressif Compiling microPython with espressif SDK 4.4 for ESP32]

[https://docs.micropython.org/en/latest/esp32/tutorial/intro.html Getting started with MicroPython on the ESP32]

[https://github.com/micropython/micropython The MicroPython project]

[https://cdn-learn.adafruit.com/downloads/pdf/micropython-basics-loading-modules.pdf MicroPython Basics: Loading Modules]

[https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

[https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD uftpd: small FTP server for ESP8266, ESP32 and Pyboard D]

[https://electronicsinnovation.com/connect-esp32-to-ubidots-using-micropython-over-mqtt-with-visual-studio-code/ Connect ESP32 to Ubidots using Micropython over MQTT with Visual Studio Code]

[https://github.com/peterhinch Peter Hinch's GitHub]

[https://wolles-elektronikkiste.de/en/programming-the-esp32-with-micropython Programming the ESP32 with MicroPython]

[https://awesome-micropython.com/ A curated list of awesome MicroPython libraries, frameworks, software and resources]
=== asyncio ===
[https://www.youtube.com/watch?v=5VLvmA__2v0 How to Use Asyncio in MicroPython (Raspberry Pi Pico) | Digi-Key Electronics]
=== Threads ===
[https://github.com/kevinmcaleer/threads Micropython thread tutorial]

[https://www.youtube.com/watch?v=QeDnjcdGrpY Video: Micropython Threads - Use Both Cores, on Raspberry Pi Pico and ESP32]
=== MQTT ===
[https://bhave.sh/micropython-mqtt/ Secrets of MicroPython: MQTT on ESP32]

[https://wokwi.com/projects/341892004923310676 Exemple MQTT sobre micropython funcionant al wokwi] ([https://wokwi.com/projects/341895401936257620 Un exemple més compacte])

=== Modbus ===
==== Modifying source code ====
[https://github.com/brainelectronics/micropython-modbus MicroPython Modbus library]

Modbus control signal able to send or receive messages can be controlled directly by UART. To do that, file [https://github.com/mrvelic/micropython/blob/master/ports/esp32/machine_uart.c machine_uart.c] should be changed.

Changes to be able to use Tx/Rx MAX3485 pin: [https://github.com/mrvelic/micropython/commit/e6a8481e31d64845b4774ecc2f5b973dacb90351 esp32/machine_uart: Add uart_mode/flow_ctrl args to UART construct/init]

Information about Modbus an MicroPython has been got from this forum: https://github.com/micropython/micropython/pull/5567
==== Based on pycom-modbus from pycom ====
[https://github.com/danjperron/micropython-modbus Modbus Master library for MicroPython ESP32 devices]
=== LoRa ===
[https://github.com/martynwheeler/u-lora This is a port of raspi-lora for micropython]

= IoT-Vertebrae =
== Raspberry ==
[[Configuració de la WiFi a la Raspberry Pi emprant nmtui]]

[[Reconnexió automàtica a la WiFi]]

[[WireGuard VPN]]

= Exemples pràctics =
== Sensor ModBus de temperatura i humitat CWT-TH03S ==
[https://www.aliexpress.com/item/1005001404952412.html CWT-TH03S a AliExpress]

[[Accés ModBus al sensor de temperatura i humitat CWT-TH03S]]

= SBC =
== PocketBeagle ==
=== Grove Kit ===
==== Visió general ====
[https://beagleboard.org/Kits/Grove Informació comercial del Grove Kit]

[https://beagleboard.org/pocket Informació comercial de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki Wiki de la PocketBeagle]

[https://github.com/beagleboard/pocketbeagle/wiki/System-Reference-Manual System Reference Manual] <----

[https://beagleboard.org/latest-images Darreres imatges per a les SD]

[https://github.com/beagleboard/capes/tree/master/pocketbeagle/Grove Disseny del Grove Cape]

==== Primera connexió a la xarxa sense fils ====
debian@beaglebone:/var/lib/cloud9$ '''sudo connmanctl'''⏎
[sudo] password for debian: temppwd⏎
connmanctl> '''scan wifi'''⏎
Scan completed for wifi
connmanctl> '''services'''⏎
MyWifi wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''agent on'''⏎
Agent registered
connmanctl> '''connect wifi_1234567890_1234567890123456_managed_psk'''⏎
Agent RequestInput wifi_1234567890_1234567890123456_managed_psk
Passphrase = [ Type=psk, Requirement=mandatory, Alternates=[ WPS ] ]
WPS = [ Type=wpspin, Requirement=alternate ]
Passphrase? '''MySecretPassphrase'''⏎
Connected wifi_1234567890_1234567890123456_managed_psk
connmanctl> '''quit'''⏎
debian@beaglebone:/var/lib/cloud9$

==== Tutorials ====
[https://github.com/beagleboard/cloud9-examples/blob/master/PocketBeagle/Grove/workshop-handouts.md Blink PocketBeagle on-board USRx LED]

[https://github.com/beagleboard/cloud9-examples/tree/master/PocketBeagle/Grove Exemples]

= Formació =
[https://www.binefa.com/index.php/IoT_amb_Arduino_i_Raspberry_Pi._Microcontroladors_d%27%C3%BAs_professional._Curs_Presencial._Edici%C3%B3_de_mar%C3%A7_de_2022 IoT amb Arduino i Raspberry Pi. Microcontroladors d'ús professional. Curs Presencial. Edició de març de 2022] - [https://formacio.eic.cat/cursos/1123577 Formació al Col·legi d'Enginyers Industrials de Catalunya] (30 / març / 2022)

[https://www.binefa.com/index.php/Sistemes_encastats_d%27escala_petita_i_mitjana._Edici%C3%B3_d%27octubre_2021 Sistemes encastats d'escala petita i mitjana. Edició d'octubre 2021] (20 / octubre / 2021)

[https://www.binefa.com/index.php/Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways)_IoT_(22_de_mar%C3%A7_de_2022) Nodes sensors (motes) i passarel·les (gateways) IoT (22 de març de 2022)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria]

[https://www.binefa.com/index.php/Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2022) Tecnologías IoT, Hands on y MVP (2022)]

[http://www.binefa.com/index.php?title=Diada_de_la_Llibertat_del_Maquinari_(Edici%C3%B3_2021) Diada de la Llibertat del Maquinari (Edició 2021)] (17 d'abril de 2021)

UPC-School - Màster Industria 4.0 [http://binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2021) Tecnologías IoT, Hands on y MVP (2021)]

[http://www.binefa.com/index.php?title=Nodes_sensors_(motes)_i_passarel%C2%B7les_(gateways) Nodes sensors (motes) i passarel·les (gateways)] pel [https://www.fundaciocim.org/ca/formacio/master-mtdi Màster en Transformació Digital en la Indústria] (23 de març de 2021)

[http://www.binefa.com/index.php?title=Monitoritzaci%C3%B3_de_la_qualitat_de_l%27aire_mesurant_CO2_i_VOC_amb_LoRa Monitorització de la qualitat de l'aire mesurant CO2 i VOC amb LoRa] (9 de gener de 2021)

[[Curset introductori d'Internet de les Coses per ADTelecom]] (Comença el 5 de novembre de 2020)

[http://www.binefa.com/index.php?title=%C3%9As_de_les_dades_generades_pels_sensors_LoRaWAN_i_arquitectura_del_sistema._Rub%C3%AD_2020 Ús de les dades generades pels sensors LoRaWAN i arquitectura del sistema. Rubí, 17 de juny de 2020]

[https://wiki.binefa.cat/index.php?title=Curset_a_TE_Connectivity_del_4_de_mar%C3%A7_de_2020 Curset a TE Connectivity del 4 de març de 2020] a [https://www.te.com/ TE Connectivity]

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] (Ajuntament de Viladecans, 19 de febrer de 2020)

UPC-School - Màster Industria 4.0 [http://www.binefa.com/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP_(2020) Tecnologías IoT, Hands on y MVP (2020)]

UPC-School - 21802500 - Màster Industria 4.0 [https://wiki.binefa.cat/index.php?title=Tecnolog%C3%ADas_IoT,_Hands_on_y_MVP Tecnologías IoT, Hands on y MVP] (2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_r%C3%A0pida_a_LoRaWAN_i_The_Things_Network Introducció ràpida a LoRaWAN i The Things Network] a l'[http://www.icm.csic.es/ Institut de Ciències del Mar] (27 / setembre / 2018 i 25 / setembre / 2019)

[https://wiki.binefa.cat/index.php?title=Introducci%C3%B3_a_Internet_de_les_Coses_-_juny_2018 Introducció a Internet de les Coses - juny 2018] (Curset de formació per a professors de CF realitzat a l'[https://agora.xtec.cat/iesramblaprim/ Institut Rambla Prim])


= Xifratge =
[[Eines de xifratge en línia]]

= Opinió =
[http://www.xavierpi.com/mi40/HaciaUnIoT_democraticoYEfectivo.pdf Hacia un Internet de las Cosas democrático y efectivo] per Xavier Pi (octubre 2018)

WireGuard VPN

2024-06-30T18:47:10Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive = 25'''

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
Feu un nou arxiu anomenat ''/etc/network/interfaces.d/wg0'':
sudo nano /etc/network/interfaces.d/wg0
I poseu aquest contingut (amb la IP de la VPN Wireguard per a aquesta Raspberry Pi):
# indicate that wg0 should be created when the system boots, and on ifup -a
auto wg0

# describe wg0 as an IPv4 interface with static address
iface wg0 inet static

# the IP address of this client on the WireGuard network
address '''10.0.2.11'''/24

# before ifup, create the device with this ip link command
pre-up ip link add $IFACE type wireguard

# before ifup, set the WireGuard config from earlier
pre-up wg setconf $IFACE /etc/wireguard/$IFACE.conf

# after ifdown, destroy the wg0 interface
post-down ip link del $IFACE

* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

I actualitzeu el servidor de la VPN WireGuard:
'''sudo wg syncconf wg0 /etc/wireguard/wg0.conf'''
* Torneu al terminal de la Raspberry Pi:
'''sudo ifup wg0'''
Verifiqueu que podeu veure la interfície de xarxa ''wg0'':
'''ip address show dev wg0'''
Verifiqueu que hi ha hagut tràfic entre el servidor de la VPN WireGuard i el client (a la Raspberry Pi):
'''sudo wg show wg0'''

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:42:45Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.1'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
Feu un nou arxiu anomenat ''/etc/network/interfaces.d/wg0'':
sudo nano /etc/network/interfaces.d/wg0
I poseu aquest contingut (amb la IP de la VPN Wireguard per a aquesta Raspberry Pi):
# indicate that wg0 should be created when the system boots, and on ifup -a
auto wg0

# describe wg0 as an IPv4 interface with static address
iface wg0 inet static

# the IP address of this client on the WireGuard network
address '''10.0.2.11'''/24

# before ifup, create the device with this ip link command
pre-up ip link add $IFACE type wireguard

# before ifup, set the WireGuard config from earlier
pre-up wg setconf $IFACE /etc/wireguard/$IFACE.conf

# after ifdown, destroy the wg0 interface
post-down ip link del $IFACE

* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

I actualitzeu el servidor de la VPN WireGuard:
'''sudo wg syncconf wg0 /etc/wireguard/wg0.conf'''
* Torneu al terminal de la Raspberry Pi:
'''sudo ifup wg0'''
Verifiqueu que podeu veure la interfície de xarxa ''wg0'':
'''ip address show dev wg0'''
Verifiqueu que hi ha hagut tràfic entre el servidor de la VPN WireGuard i el client (a la Raspberry Pi):
'''sudo wg show wg0'''

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:42:22Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.1'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
Feu un nou arxiu anomenat ''/etc/network/interfaces.d/wg0'':
sudo nano /etc/network/interfaces.d/wg0
I poseu aquest contingut (amb la IP de la VPN Wireguard per a aquesta Raspberry Pi):
# indicate that wg0 should be created when the system boots, and on ifup -a
auto wg0

# describe wg0 as an IPv4 interface with static address
iface wg0 inet static

# the IP address of this client on the WireGuard network
address '''10.0.2.11'''/24

# before ifup, create the device with this ip link command
pre-up ip link add $IFACE type wireguard

# before ifup, set the WireGuard config from earlier
pre-up wg setconf $IFACE /etc/wireguard/$IFACE.conf

# after ifdown, destroy the wg0 interface
post-down ip link del $IFACE

* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

I actualitzeu el servidor de la VPN WireGuard:
'''sudo wg syncconf wg0 /etc/wireguard/wg0.conf'''
* Torneu al terminal de la Raspberry Pi:
'''sudo ifup wg0'''
Verifiqueu que podeu veure la interfície de xarxa wg0:
'''ip address show dev wg0'''
Verifiqueu que hi ha hagut tràfic entre el servidor de la VPN WireGuard i el client (a la Raspberry Pi):
'''sudo wg show wg0'''

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:38:14Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.1'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
Feu un nou arxiu anomenat ''/etc/network/interfaces.d/wg0'':
sudo nano /etc/network/interfaces.d/wg0
I poseu aquest contingut (amb la IP de la VPN Wireguard per a aquesta Raspberry Pi):
# indicate that wg0 should be created when the system boots, and on ifup -a
auto wg0

# describe wg0 as an IPv4 interface with static address
iface wg0 inet static

# the IP address of this client on the WireGuard network
address '''10.0.2.11'''/24

# before ifup, create the device with this ip link command
pre-up ip link add $IFACE type wireguard

# before ifup, set the WireGuard config from earlier
pre-up wg setconf $IFACE /etc/wireguard/$IFACE.conf

# after ifdown, destroy the wg0 interface
post-down ip link del $IFACE

* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

I actualitzeu el servidor de la VPN WireGuard:
'''sudo wg syncconf wg0 /etc/wireguard/wg0.conf'''
* Torneu al terminal de la Raspberry Pi:
'''sudo ifup wg0'''

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:29:14Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
Feu un nou arxiu anomenat ''/etc/network/interfaces.d/wg0'':
sudo nano /etc/network/interfaces.d/wg0
I poseu aquest contingut (amb la IP de la VPN Wireguard per a aquesta Raspberry Pi):
# indicate that wg0 should be created when the system boots, and on ifup -a
auto wg0

# describe wg0 as an IPv4 interface with static address
iface wg0 inet static

# the IP address of this client on the WireGuard network
address '''10.0.2.11'''/24

# before ifup, create the device with this ip link command
pre-up ip link add $IFACE type wireguard

# before ifup, set the WireGuard config from earlier
pre-up wg setconf $IFACE /etc/wireguard/$IFACE.conf

# after ifdown, destroy the wg0 interface
post-down ip link del $IFACE

* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

I actualitzeu el servidor de la VPN WireGuard:
'''sudo wg syncconf wg0 /etc/wireguard/wg0.conf'''
* Torneu al terminal de la Raspberry Pi:
'''sudo ifup wg0'''

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:28:55Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
Feu un nou arxiu anomenat ''/etc/network/interfaces.d/wg0'':
sudo nano /etc/network/interfaces.d/wg0
I poseu aquest contingut (amb la IP de la VPN Wireguard per a aquesta Raspberry Pi):
# indicate that wg0 should be created when the system boots, and on ifup -a
auto wg0

# describe wg0 as an IPv4 interface with static address
iface wg0 inet static

# the IP address of this client on the WireGuard network
address '''10.0.2.11'''/24

# before ifup, create the device with this ip link command
pre-up ip link add $IFACE type wireguard

# before ifup, set the WireGuard config from earlier
pre-up wg setconf $IFACE /etc/wireguard/$IFACE.conf

# after ifdown, destroy the wg0 interface
post-down ip link del $IFACE

* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

I actualitzeu el servidor de la VPN WireGuard:
'''sudo wg syncconf wg0 /etc/wireguard/wg0.conf'''
* Torneu al terminal de la Raspberry Pi:
sudo ifup wg0

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:26:25Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
Feu un nou arxiu anomenat ''/etc/network/interfaces.d/wg0'':
sudo nano /etc/network/interfaces.d/wg0
I poseu aquest contingut (amb la IP de la VPN Wireguard per a aquesta Raspberry Pi):
# indicate that wg0 should be created when the system boots, and on ifup -a
auto wg0

# describe wg0 as an IPv4 interface with static address
iface wg0 inet static

# the IP address of this client on the WireGuard network
address '''10.0.2.11'''/24

# before ifup, create the device with this ip link command
pre-up ip link add $IFACE type wireguard

# before ifup, set the WireGuard config from earlier
pre-up wg setconf $IFACE /etc/wireguard/$IFACE.conf

# after ifdown, destroy the wg0 interface
post-down ip link del $IFACE

* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

I actualitzeu el servidor de la VPN WireGuard:
'''sudo wg syncconf wg0 /etc/wireguard/wg0.conf'''

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:08:50Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32
I actualitzeu el servidor de la VPN WireGuard:
'''sudo wg syncconf wg0 /etc/wireguard/wg0.conf'''

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:08:22Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' ('''sudo nano /etc/wireguard/wg0.conf''') afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32
I actualitzeu el servidor de la VPN WireGuard:
$ sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:06:03Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32
I actualitzeu el servidor de la VPN WireGuard:
$ sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T18:05:02Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

* Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

* Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

* Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''cat wg-public.key'''
Tu***************************************TE=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820
* Aneu al servidor WireGuard (no a la Raspberry Pi) i editeu l'arxiu ''/etc/wireguard/wg0.conf'' afegint-hi al final:
# define the remote WireGuard interface (client)
[Peer]

# contents of file wg-public.key on the WireGuard client
PublicKey = '''Tu***************************************TE='''

# the IP address of the client on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T17:56:35Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.**''':51820

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T17:55:51Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''51.1*.**.*8''':51820

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]

WireGuard VPN

2024-06-30T17:55:16Z

Jordi Binefa : /* Instal·lació de la VPN WireGuard a Raspberry Pi OS */

= WireGuard Server =
[https://wireguard.how/server/debian/ WireGuard Server: Debian]
= WireGuard Client =
[https://wireguard.how/server/debian/ WireGuard Client: Debian]

[https://www.wireguard.com/install/ Instal·ladors del client de WireGuard per altres sistemes operatius]
== Instal·lació de la VPN WireGuard a Raspberry Pi OS ==
[https://wireguard.how/client/raspberry-pi-os/ WireGuard Client: Raspberry Pi OS]

Des del terminal de la Raspberry Pi:
sudo apt update
sudo apt install '''wireguard'''

Aneu al servidor WireGuard (no a la Raspberry Pi) i copieu la clau pública:
$ '''sudo wg show wg0'''
interface: wg0
public key: '''kj***************************************0Q='''
private key: (hidden)
listening port: 51820

Torneu al terminal de la Raspberry Pi:
'''(umask 077 && wg genkey > wg-private.key)'''
'''wg pubkey < wg-private.key > wg-public.key'''
'''cat wg-private.key'''
4H***************************************E0=
'''sudo nano /etc/wireguard/wg0.conf'''

Aquest ha de ser el contingut de l'arxiu ''/etc/wireguard/wg0.conf'':
# define the local WireGuard interface (client)
[Interface]

# contents of file wg-private.key that was recently created
PrivateKey = '''4H***************************************E0='''

# define the remote WireGuard interface (server)
[Peer]

# contents of wg-public.key on the WireGuard server
PublicKey = '''kj***************************************0Q='''

# the IP address of the server on the WireGuard network
AllowedIPs = '''10.0.2.11'''/32

# public IP address and port of the WireGuard server
Endpoint = '''3*.**.**.*8''':51820

= WireGuard a Android =
[https://download.wireguard.com/android-client/ Client d'Android de l'aplicació WireGuard]

* Per a crear les claus privada i pública per a Android des del servidor:

[https://serversideup.net/generating-wireguard-qr-codes-for-fast-mobile-deployments/ Generating WireGuard QR codes for fast mobile deployments]

* Configuració de l'aplicació d'Android:

[https://serversideup.net/how-to-configure-a-wireguard-android-vpn-client/ How to configure a WireGuard Android VPN Client]

L'apartat ''Add your client to your server'' no m'ha funcionat. Per a que em funcioni he fet:

He afegit al final de l'arxiu '''/etc/wireguard/wg0.conf''' del servidor (l'adreça '''10.0.2.6''' és la IP que tindrà el mòbil a la VPN WireGuard):
[Peer]

PublicKey = Fn***************************************RU=

AllowedIPs = '''10.0.2.6'''/32
I al final li he dit a WireGuard que recarregui la nova configuració:
sudo wg syncconf wg0 /etc/wireguard/wg0.conf

= Exemple de configuració =
== Al servidor ==
sudo wg show wg0
[[Image:WgServer00.png|center|thumb|Server:~$ sudo wg show wg0]]

Arxiu ''/etc/wireguard/wg0.conf'' :
# define the WireGuard service
'''[Interface]'''

# contents of file wg-private.key that was recently created
PrivateKey = SD***************************************1Q=

# UDP service port; 51820 is a common choice for WireGuard
ListenPort = 51820

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = EG***************************************yI=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.2/32

# define the remote WireGuard interface (client)
'''[Peer]'''

# contents of file wg-public.key on the WireGuard client
PublicKey = Pw***************************************gQ=

# the IP address of the client on the WireGuard network
AllowedIPs = 10.0.2.5/32

== Al client ==
sudo cat /etc/wireguard/wg0.conf
[[Image:WgClient00.png|center|thumb|Client:~$ sudo cat /etc/wireguard/wg0.conf]]
Per a que hi hagi visibilitat entre diferents clients de la VPN cal comentar l'exclusivitat de connexió al servidor (''10.0.2.1/32'') i permetre que altres hi puguin accedir (''0.0.0.0/0''). I per a mantenir la persistència del túnel s'ha afegit ''PersistentKeepalive'':
# AllowedIPs = 10.0.2.1/32
AllowedIPs = '''0.0.0.0/0, ::/0'''

'''PersistentKeepalive''' = 25
== A un client Android ==
'''Interfície''' correspon al mòbil

'''Parell''' (''Peer'') correspon al servidor a on és allotjada la VPN WireGuard

Podeu editar els valors prement la icona del llapis

[[Image:WgAndroid00.png|center|thumb|Client Android]]