Difference between revisions of "ISpindel/dutchdocsfornoobs"

From Technologia Incognita
Jump to: navigation, search
m (Blynk)
m (Blynk)
Line 236: Line 236:
 
Blynk is een cloud platform. Het is gratis voor ontwikkelaars en het geeft de mogelijkheid om 5 gebruikers en 2 apparaten te gebruiken.
 
Blynk is een cloud platform. Het is gratis voor ontwikkelaars en het geeft de mogelijkheid om 5 gebruikers en 2 apparaten te gebruiken.
  
Registreer jezelf op https://blynk.io
+
* Registreer jezelf op https://blynk.io, voer een e-mailadres in en kies een sterk wachtwoord.
 +
* Je komt in het dashboard. Hier zie je "Start by creating your first template". Klik op [Create template]
 +
** bij "Name" voer je de naam van je iSpindel in bijvoorbeeld "iSpindel"
 +
** bij "Hardware" kies ESP8266
 +
** bij "Connection Type" kies "WiFi"
 +
** klik op "Done"
 +
* Je komt in het device scherm. Ga naar tabblad "Datastreams". Klik [New Datastream] en kies "Virtual Pin". Vul het volgende in:
 +
** Name: Temperatuur
 +
** Alias: Temperatuur
 +
** Pin: V2
 +
** Data type: integer
 +
** Units: none
 +
** Min: -20
 +
** Max: 50
 +
** Klik op [Create]
  
Ga naar het dashboard en login.
+
==== Phone app ====
 +
Let op: Alle bestaande documentatie gaat uit van Blynk 1.0. De oude app heet "Blynk 0.1". Tegenwoordig zit Blynk op 2.0, de nieuwe app heet "Blynk IOT" of "Blynk IOT New" ; deze moet je hebben.
  
 
== Kalibratie ==
 
== Kalibratie ==
  
 
to do..
 
to do..

Revision as of 22:05, 26 June 2022

Deze pagina biedt een eenvoudige instructie om snel te kunnen starten met de iSpindel, en is met name gericht op de leden van KWBG. Dit behandelt voornamelijk het instellen van een aantal eenvoudig en gratis te gebruiken gegevensdiensten ("data acquisition services") zoals bijvoorbeeld Ubidots.

Voorbeelden gaan uit van firmware versie 7.1.4

iSpindel configuratie

Om de iSpindel te kunnen gebruiken moeten een aantal zaken eenmalig worden ingesteld. Minimaal moeten de volgende onderdelen worden ingesteld.

  • instellen van een verbinding met Wifi
  • instellen van een gegevensdienst
  • calibratie

Eventueel kun je ook het volgende doen.

  • nieuwere firmware installeren
  • eigen naam kiezen

Het instellen van een iSpindel gebeurt in configuratiemenu. Dat doe je door de iSpindel 3 keer snel achter elkaar te resetten, totdat het blauwe LED éénmaal per seconde gaat knipperen. De iSpindel brengt dan een onbeveiligd draadloos netwerk in de lucht, waarmee je kunt verbinden zonder wachtwoord. Zodra de verbinding tot stand is gebracht, kun je met een webbrowser het configuratiemenu bereiken. Dit gaat het makkelijkst met een telefoon (de webpagina verschijnt dan vanzelf).

Wanneer je verbonden bent, kom je in het een hoofdmenu.

Ispindel configurationmode mainmenu.PNG

Vanuit het hoofdmenu ga je naar (Configuration)

Service types

In het configuratiemenu kun je "service type" instellen, waarmee je de methode kiest om de meetgegevens te verzamelen. Voor service type heb je de volgende keuzen (vanaf firmware versie 7.2.0):

Service type Vereiste parameters
Ubidots Token/API key
CraftBeerPi Server Address
HTTP Token/API key, Server Address, Server Port, Path/URI
TControl Server Address
FHEM Server Address, Server Port
TCP Token/API key, Server Address, Server Port
iSpindel.de Token/API key
influxDB Server Address, Server Port, InfludDB db, Username, Password, connect to server via HTTPS (aan/uit)
Prometheus Server Address, Server Port, Prometheus job, Prometheus instance
MQTT Server Address, Server Port, Username, Password, Home Assistant integration via MQTT
ThingSpeak Token/API key, Channelnumber
Blynk Token/API key
Brewblox Server Address, Server Port, Path/URI, Username, Password
AWSIOTMQTT Publish Topic, Server Address, Server Port(=8883), Path/URI
HTTPS Post Token/API key, Server Address, Path/URI
BierBot Bricks Token/API key

Gegevensdiensten instellen

Om de iSpindel optimaal te benutten, is het nodig om de iSpindel te koppelen aan een clouddienst voor het verzamelen en weergeven van de meetgegevens. Onderstaande tabel toont een aantal gegevensdiensten die kunnen worden ingesteld om te gebruiken om de meetgegevens van de iSpindel te verzamelen en netjes weer te geven. De clouddiensten zijn het snelst en makkelijkst in gebruik te nemen. Gegevensdiensten die gebruik maken van een eigen server kosten meer moeite en vereisen technische kennis voor instellen en onderhoud.

Verderop volgen enkele uitgebreide stappenplannen voor het instellen voor de iSpindel.

Vergelijking gegevensdiensten

Gegevensdiensten
Naam iSpindel configuratie service type URL Type Kosten
Ubidots Ubidots https://ubidots.com/stem/ cloud gratis voor niet-commercieel gebruik
CraftBeerPi CraftBeerPi http://web.craftbeerpi.com/ server open-source software beschikbaar
FHEM FHEM https://fhem.de/ server
influxDB influxDB https://www.influxdata.com/ server/cloud gratis tot 30 dagen, daarna betaald
Prometheus Prometheus https://prometheus.io/ server open-source
MQTT MQTT https://en.wikipedia.org/wiki/MQTT server open-source software beschikbaar
ThingSpeak ThingSpeak https://thingspeak.com/ cloud gratis voor niet-commercieel gebruik
BierBot Bricks BierBot Bricks https://bierbot.com/#/site/ cloud gratis
Blynk Blynk https://blynk.io/ cloud FREE For exploration and early prototyping
Brewblox Brewblox https://www.brewblox.com server  ?
Amazon Web Services (AWS) IOT support for MQTT AWIOTMQTT https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html cloud commercieel

Ubidots

Ubidots is een makkelijk te gebruiken platform voor het verzamelen van metingen. Met een gratis account kun je maximaal 3 devices koppelen. Je kunt zelf een dashboard aanmaken waarin je sensors kunt plaatsen. De website is engelstalig.

  • Ga naar https://ubidots.com/stem/
  • Vul een gebruikersnaam in het veld Username in
  • Vul je e-mailadres in het veld Email in
  • Vink "My IOT project is for personal, non-commercial use" aan en klik op "Sign up for free"
  • Vink "Ik ben geen robot" aan
  • Je krijgt een korte rondleiding . Volg de rondleiding en klik tenslotte op "Go to my dashboard".
  • Op het dashboard zie je 1 demosensor van 1 demodevice. .

Om je iSpindel te koppelen, doe het volgende:

  • Ga naar je avatar rechtsboven, klik erop en kies "API Credentials"
  • Je ziet API key en Tokens. Klik op het veld onder Tokens om je token te zien.
  • Kopieer het token. Dit moet je in iSpindel invoeren om je iSpindel te koppelen met Ubidots.

(maak een nieuw device, nieuwe sensor)

Op de pagina Connect the iSpindel Low-Cost DIY Hydrometer with Ubidots vind je ook een uitgebreid engelstalig helpartikel die je helpt met het instellen van je iSpindel.

ispindel_configurationmode_mainmenu

CraftBeerPi

CraftBeerPi is vrije software gemaakt door Manuel Fritsch voor monitoren en besturen van bierbrouwapparatuur en draait op een Raspberry Pi. Met CraftBeerPi breng je een website in de lucht op een Raspberry Pi die de meetgegevens van de iSpindel verzamelt. Er is tamelijk veel technische kennis vereist (Raspberry Pi installeren, beheer van een Linux OS, solderen, elektronica aansluiten) en valt daarom voor de beoogde doelgroep buiten de beschouwing van deze documentatie ;-)

Lees meer op CraftBeerPi.

FHEM

FHEM is open-source server software voor home automation. Hiervoor is een eigen server nodig.

Lees meer op Home of FHEM (DE/EN)

iSpindel.de

Binnenkort

Influx DB

Influx DB is een commerciele tijdsreeksdatabase. Het bedrijf Influxdata biedt bedrijven een volledig beheerd cloudplatform, of een cloud of on-premise oplossing in eigen beheer. InfluxDB Cloud is de naam van hun clouddienst. Het gebruik is gratis tot 30 dagen en daarna moet betaald worden op basis van pay-what-you-use. Ook jaarlijkse abonnementen zijn mogelijk. Wil je een gratis produkt voor hobbydoeleinden, dan is dit niet voor jou.

Influxdata

Prometheus

Prometheus is een open-source monitorsysteem en tijdreeksdatabase. De software is beschikbaar in de vorm van sourcecode, voorgecompileerde binaries voor diverse OS'en en als docker images. Een eigen server hiervoor is vereist.... en valt daarom voor de beoogde doelgroep buiten de beschouwing van deze documentatie ;-)

Prometheus - Monitoring system & time series database

MQTT

MQTT is een lichtgewicht netwerkprotocol dat berichten tussen apparaten transporteert. MQTT wordt gebruikt voor home automation, in smarthomes en in IoT. MQTT is door OASIS vastgelegd in een standaard. Om iSpindel te gebruiken in combinatie met MQTT zul je zelf moeten zorgen voor een server en software in eigen beheer. Op zijn minst is er een zogenaamde "MQTT Broker" nodig.

Wikipedia MQTT

ThingSpeak

ThingSpeak is een cloud-dataverzamelingsysteem , die gratis kan worden gebruikt voor niet-commercieel gebruik met zekere beperkingen.

Uitwerken...

IoT Analytics - ThingSpeak Internet of Things

BierBot Bricks

Cloud .... gratis ... beginnersvriendelijk (verder uitwerken)

Home of BierBot - homebrewing automation

Blynk

Blynk is een cloud platform. Het is gratis voor ontwikkelaars en het geeft de mogelijkheid om 5 gebruikers en 2 apparaten te gebruiken.

  • Registreer jezelf op https://blynk.io, voer een e-mailadres in en kies een sterk wachtwoord.
  • Je komt in het dashboard. Hier zie je "Start by creating your first template". Klik op [Create template]
    • bij "Name" voer je de naam van je iSpindel in bijvoorbeeld "iSpindel"
    • bij "Hardware" kies ESP8266
    • bij "Connection Type" kies "WiFi"
    • klik op "Done"
  • Je komt in het device scherm. Ga naar tabblad "Datastreams". Klik [New Datastream] en kies "Virtual Pin". Vul het volgende in:
    • Name: Temperatuur
    • Alias: Temperatuur
    • Pin: V2
    • Data type: integer
    • Units: none
    • Min: -20
    • Max: 50
    • Klik op [Create]

Phone app

Let op: Alle bestaande documentatie gaat uit van Blynk 1.0. De oude app heet "Blynk 0.1". Tegenwoordig zit Blynk op 2.0, de nieuwe app heet "Blynk IOT" of "Blynk IOT New" ; deze moet je hebben.

Kalibratie

to do..