diff --git a/README.md b/README.md index f07573f..a26e19c 100644 --- a/README.md +++ b/README.md @@ -6,9 +6,9 @@ boards. Repoet indeholder desuden en Docker Compose-baseret server til REST-payloads og et aktivitetsdashboard. Se [`server/`](server/README.md). -Repoet registrerer både Arduino-boards og de eksterne input/output-enheder, der -tilsluttes dem. Boardprofiler ligger i `boards/`, enhedsprofiler i `devices/`, -og hver enhedsprofil linker til de sketches, hvor enheden bruges. +Repoet registrerer både Arduino-boards og de elektroniske komponenter, der +tilsluttes dem. Boardprofiler ligger i `boards/`, komponentprofiler i +`components/`, og hver komponentprofil linker til de sketches, hvor den bruges. ## Boards @@ -87,8 +87,8 @@ i [`boards/uno-r3-compatible-ch340`](boards/uno-r3-compatible-ch340/README.md). ## Projektstruktur -Boards og sketches bruger samme stabile board-id. Eksterne enheder har deres -eget stabile device-id: +Boards og sketches bruger samme stabile board-id. Komponenter har deres eget +stabile component-id: ```text boards/ @@ -98,7 +98,7 @@ boards/ README.md arduino-uno-r4-wifi/ README.md -devices/ +components/ lcd1602-i2c-pcf8574/ README.md sketches/ @@ -116,7 +116,15 @@ Hver sketch ligger i sin egen mappe, og mappen og den primære `.ino`-fil har samme navn, så den kan åbnes direkte i Arduino IDE. Board-specifik dokumentation, forbindelser og biblioteker beskrives ved den enkelte sketch. -## Eksterne input/output-enheder +## Komponenter + +### Keyestudio/Keyes-moduler + +De 19 identificerede moduler fra referencebilledet er registreret enkeltvis i +[`components/`](components/README.md). Samlingen omfatter lys og lyd, temperatur- +og lyssensorer, mekaniske kontakter, IR-kommunikation samt optisk pulsmåling. +Hver profil angiver produkt-id, interface, forsyning, tilslutningshensyn og +producentkilde. ### LCD1602 med PCF8574T I²C-backpack @@ -128,8 +136,8 @@ dokumentation, forbindelser og biblioteker beskrives ved den enkelte sketch. - **Sketch:** [`lcd1602_i2c_demo`](sketches/arduino-uno-r4-wifi/lcd1602_i2c_demo) Pinout, adresseoplysninger, praktiske noter og den samlede sketch-liste findes i -[`devices/lcd1602-i2c-pcf8574`](devices/lcd1602-i2c-pcf8574/README.md). Det -samlede enhedsindeks findes i [`devices/`](devices/README.md). +[`components/lcd1602-i2c-pcf8574`](components/lcd1602-i2c-pcf8574/README.md). +Det samlede komponentindeks findes i [`components/`](components/README.md). ## Sketches @@ -161,14 +169,14 @@ samlede enhedsindeks findes i [`devices/`](devices/README.md). - [`sos_blink`](sketches/uno-r3-compatible-ch340/sos_blink) – SOS i morsekode på den standardmæssige D13-LED -## Tilføjelse af flere boards og enheder +## Tilføjelse af flere boards og komponenter Nye boards får en profil under `boards//` og deres sketches placeres under `sketches//`. Board-id skrives med små bogstaver og bindestreger, eksempelvis `arduino-uno-r4-wifi`. -Nye eksterne enheder får en profil under `devices//`. Profilen skal +Nye komponenter får en profil under `components//`. Profilen skal beskrive identifikation, pinout og elektriske hensyn samt linke til alle -sketches, der bruger enheden. Både dette README og `devices/README.md` holdes -opdateret, når nye enheder tilføjes. +sketches, der bruger komponenten. Både dette README og `components/README.md` +holdes opdateret, når nye komponenter tilføjes. diff --git a/components/README.md b/components/README.md new file mode 100644 index 0000000..1e73887 --- /dev/null +++ b/components/README.md @@ -0,0 +1,43 @@ +# Komponenter + +Dette katalog registrerer elektroniske input- og outputkomponenter, der bruges sammen +med boards i Arduino Playground: displays, sensorer, aktuatorer, kommunikations- +moduler og andre komponenter. + +Hver fysisk komponenttype får sit eget stabile id og en mappe med: + +- identifikation og relevante tekniske data; +- pinout, spændingsniveauer og tilslutning; +- eventuelle adresser, biblioteker og kendte faldgruber; +- links til alle sketches i repoet, som bruger komponenten. + +## Registrerede komponenter + +| Komponent | Type | Interface | Produkt-id | Sketches | +| --- | --- | --- | --- | --- | +| [LCD1602 med PCF8574T](lcd1602-i2c-pcf8574/README.md) | Output/display | I²C | – | [`lcd1602_i2c_demo`](../sketches/arduino-uno-r4-wifi/lcd1602_i2c_demo) | +| [RGB LED](keyestudio-ks0032-rgb-led/README.md) | Output/lys | Digital/PWM | KS0032 | – | +| [Mikrofon](keyestudio-ks0035-microphone/README.md) | Input/lyd | Analog | KS0035 | – | +| [IR-modtager](keyestudio-ks0026-ir-receiver/README.md) | Input/IR | Digital | KS0026 | – | +| [Analog temperatursensor](keyestudio-ks0033-thermistor/README.md) | Input/temperatur | Analog | KS0033 | – | +| [DS18B20-temperatursensor](keyestudio-ks0023-ds18b20/README.md) | Input/temperatur | 1-Wire | KS0023 | – | +| [Tiltsensor](keyestudio-ks0025-tilt/README.md) | Input/orientering | Digital | KS0025 | – | +| [Aktiv buzzer](keyestudio-ks0018-active-buzzer/README.md) | Output/lyd | Digital | KS0018 | – | +| [Laser-emitter](keyes-ke2054-laser-emitter/README.md) | Output/lys | Digital | KE2054 | – | +| [Analog rotationssensor](keyestudio-ks0014-analog-rotation/README.md) | Input/position | Analog | KS0014 | – | +| [Trykknap](keyestudio-ks0029-push-button/README.md) | Input/kontakt | Digital | KS0029 | – | +| [IR-sender](keyestudio-ks0027-ir-transmitter/README.md) | Output/IR | Digital/PWM | KS0027 | – | +| [Passiv buzzer](keyestudio-ks0019-passive-buzzer/README.md) | Output/lyd | Digital/tone | KS0019 | – | +| [Knock-sensor](keyestudio-ks0024-knock/README.md) | Input/slag | Digital | KS0024 | – | +| [Reed switch](keyestudio-ks0038-reed-switch/README.md) | Input/magnet | Digital | KS0038 | – | +| [Pulssensor](keyestudio-ks0015-pulse-rate/README.md) | Input/optisk | Analog | KS0015 | – | +| [Vibrationssensor](keyestudio-ks0037-vibration/README.md) | Input/vibration | Digital | KS0037 | – | +| [Fotomodstandssensor](keyestudio-ks0028-photocell/README.md) | Input/lys | Analog | KS0028 | – | +| [LM35-temperatursensor](keyestudio-ks0022-lm35/README.md) | Input/temperatur | Analog | KS0022 | – | +| [Collision-/endestopsensor](keyestudio-ks0021-collision/README.md) | Input/kontakt | Digital | KS0021 | – | + +## Navngivning + +Nye komponenter placeres i `components//`, hvor `component-id` skrives med små +bogstaver og bindestreger, eksempelvis `bme280-temperature-humidity-pressure`. +Profilen opdateres, hver gang komponenten bruges i en ny sketch. diff --git a/components/keyes-ke2054-laser-emitter/README.md b/components/keyes-ke2054-laser-emitter/README.md new file mode 100644 index 0000000..64a114a --- /dev/null +++ b/components/keyes-ke2054-laser-emitter/README.md @@ -0,0 +1,23 @@ +# Keyes KE2054 laser-emittermodul + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KE2054 | +| Type | Rød laserdiode-emitter | +| Interface | `OUT`, `VCC`, `GND` | +| Forsyning | 3,3–5 V | +| Output | Digital on/off | + +Boardets konstruktion og silketryk svarer til Keyes Brick KE2054. Komponenten +er en emitter, selv om den ofte sælges under navnet “laser sensor”. + +## Sikkerhed og tilslutning + +`OUT` forbindes til en digital udgang. Se aldrig direkte ind i strålen, ret den +ikke mod mennesker eller dyr, og undgå blanke reflekterende flader. Ingen sketches endnu. + +## Kilde + +- [Keyes KE2054 Laser Sensor Module](https://www.keyesrobot.cn/projects/brick/zh-cn/latest/KE2054%20Keyes%20Brick%20%E6%BF%80%E5%85%89%E5%A4%B4%E4%BC%A0%E6%84%9F%E5%99%A8%E6%A8%A1%E5%9D%97%E7%BB%BC%E5%90%88%E6%8C%87%E5%8D%97.html) diff --git a/components/keyestudio-ks0014-analog-rotation/README.md b/components/keyestudio-ks0014-analog-rotation/README.md new file mode 100644 index 0000000..c634323 --- /dev/null +++ b/components/keyestudio-ks0014-analog-rotation/README.md @@ -0,0 +1,22 @@ +# Keyestudio KS0014 analog rotationssensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0014 | +| Type | Drejepotentiometer | +| Interface | `OUT`, `VCC`, `GND` | +| Output | Analog spænding afhængig af akselposition | +| Forsyning | 5 V | + +Dette er et analogt drejepotentiometer, ikke KS0013 rotary encoder. + +## Tilslutning + +`OUT` forbindes til en analog indgang. ADC-værdien kan skaleres til procent, +vinkel eller et applikationsspecifikt interval. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0014 Analog Rotation Sensor](https://wiki.keyestudio.com/Ks0014_keyestudio_Analog_Rotation_Sensor) diff --git a/components/keyestudio-ks0015-pulse-rate/README.md b/components/keyestudio-ks0015-pulse-rate/README.md new file mode 100644 index 0000000..6bfce3d --- /dev/null +++ b/components/keyestudio-ks0015-pulse-rate/README.md @@ -0,0 +1,22 @@ +# Keyestudio KS0015 pulssensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0015 | +| Type | Optisk pulssensor med IR-LED og fototransistor | +| Interface | `IN`, `VCC`, `GND` | +| Output | Analogt målesignal | + +En finger placeres mellem lysgiveren og fototransistoren. Den røde indikator +følger variationerne i det registrerede pulssignal. + +## Tilslutning og begrænsning + +Signalet forbindes til en analog indgang og kræver filtrering og tærskelvalg. +Modulet er til eksperimenter og er ikke medicinsk udstyr. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0015 Pulse Rate Monitor](https://wiki.keyestudio.com/Ks0015_keyestudio_Pulse_Rate_Monitor) diff --git a/components/keyestudio-ks0018-active-buzzer/README.md b/components/keyestudio-ks0018-active-buzzer/README.md new file mode 100644 index 0000000..4a3a21e --- /dev/null +++ b/components/keyestudio-ks0018-active-buzzer/README.md @@ -0,0 +1,22 @@ +# Keyestudio KS0018 aktiv buzzer + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0018 | +| Type | Aktiv buzzer med intern oscillator | +| Interface | `IN`, `VCC`, `GND` | +| Styring | Digital on/off | + +Den aktive buzzer giver en fast tone ved aktivering. Den lukkede lydgiver med +mærkat adskiller den fra KS0019 passive buzzer. + +## Tilslutning + +Forbind `IN` til en digital udgang og forsyn efter modulets silketryk. Brug ikke +PWM-tonegenerering som til en passiv buzzer. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0018 Digital Buzzer Module](https://wiki.keyestudio.com/Ks0018_keyestudio_Digital_Buzzer_Module) diff --git a/components/keyestudio-ks0019-passive-buzzer/README.md b/components/keyestudio-ks0019-passive-buzzer/README.md new file mode 100644 index 0000000..67d7492 --- /dev/null +++ b/components/keyestudio-ks0019-passive-buzzer/README.md @@ -0,0 +1,22 @@ +# Keyestudio KS0019 passiv buzzer + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0019 | +| Type | Passiv piezo-buzzer uden intern oscillator | +| Interface | `IN`, `VCC`, `GND` | +| Forsyning | 3,3–5 V | + +Den åbne lydgiver kræver et firkantsignal og kan derfor afspille forskellige +frekvenser. Den skal ikke forveksles med KS0018 aktiv buzzer. + +## Tilslutning + +`IN` forbindes til en digital udgang og styres eksempelvis med `tone()`. +Kontinuerlig DC giver ikke en kontrolleret tone. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0019 Passive Buzzer](https://wiki.keyestudio.com/Ks0019_keyestudio_Passive_Buzzer_module) diff --git a/components/keyestudio-ks0021-collision/README.md b/components/keyestudio-ks0021-collision/README.md new file mode 100644 index 0000000..698f16e --- /dev/null +++ b/components/keyestudio-ks0021-collision/README.md @@ -0,0 +1,22 @@ +# Keyestudio KS0021 collision-/endestopsensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0021 | +| Type | Mekanisk snap-action mikrokontakt | +| Interface | `OUT`, `VCC`, `GND` | +| Output | Digitalt, aktivt LOW ved aktivering | + +Modulet er mærket “Crash Sensor” og kan bruges som kollisionsføler eller +endestop på en mekanisk konstruktion. + +## Tilslutning + +`OUT` forbindes til en digital indgang. Kontrollér aktivt niveau og anvend +debounce, hvis ét fysisk tryk kun må tælle én gang. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0021 Collision Sensor](https://wiki.keyestudio.com/Ks0021_keyestudio_Collision_Sensor) diff --git a/components/keyestudio-ks0022-lm35/README.md b/components/keyestudio-ks0022-lm35/README.md new file mode 100644 index 0000000..f888350 --- /dev/null +++ b/components/keyestudio-ks0022-lm35/README.md @@ -0,0 +1,21 @@ +# Keyestudio KS0022 LM35-temperatursensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0022 | +| Sensor | LM35 lineær analog temperatursensor | +| Interface | `OUT`, `VCC`, `GND` | +| Følsomhed | 10 mV/°C | +| Dokumenteret modulområde | Ca. 0–100 °C | + +## Tilslutning + +`OUT` forbindes til en analog indgang. Temperaturen beregnes ud fra målt +spænding og ADC-reference; brug den faktiske reference for bedre nøjagtighed. +Ingen sketches i repoet endnu. + +## Kilde + +- [Keyestudio KS0022 LM35 Linear Temperature Sensor](https://wiki.keyestudio.com/Ks0022_keyestudio_LM35_Linear_Temperature_Sensor) diff --git a/components/keyestudio-ks0023-ds18b20/README.md b/components/keyestudio-ks0023-ds18b20/README.md new file mode 100644 index 0000000..bd0ad2c --- /dev/null +++ b/components/keyestudio-ks0023-ds18b20/README.md @@ -0,0 +1,21 @@ +# Keyestudio KS0023 DS18B20-temperatursensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0023 | +| Sensor | Dallas/Maxim DS18B20 | +| Interface | 1-Wire via `DAT`, `VCC`, `GND` | +| Forsyning | 3,3–5 V | +| Måleområde | −55 til +125 °C | + +## Tilslutning og hensyn + +`DAT` forbindes til en digital pin. Modulet indeholder den nødvendige +pull-up-komponent; flere DS18B20-enheder kan dele samme 1-Wire-bus. Typiske +biblioteker er `OneWire` og `DallasTemperature`. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0023 18B20 Temperature Sensor](https://wiki.keyestudio.com/Ks0023_keyestudio_18B20_Temperature_Sensor) diff --git a/components/keyestudio-ks0024-knock/README.md b/components/keyestudio-ks0024-knock/README.md new file mode 100644 index 0000000..eabe14e --- /dev/null +++ b/components/keyestudio-ks0024-knock/README.md @@ -0,0 +1,23 @@ +# Keyestudio KS0024 knock-sensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0024 | +| Type | Fjederbaseret slag-/knocksensor | +| Interface | `OUT`, `VCC`, `GND` | +| Output | Kort digital impuls ved slag | +| Forsyning | 5 V | + +På referencefotoet er dette modulet med den synlige fjeder i en klar +plastkapsling. + +## Tilslutning + +`OUT` forbindes til en digital indgang, gerne en interrupt-egnet pin ved korte +impulser. Mekaniske efter-svingninger kan kræve debounce. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0024 Knock Sensor](https://wiki.keyestudio.com/Ks0024_keyestudio_Knock_Sensor_Module) diff --git a/components/keyestudio-ks0025-tilt/README.md b/components/keyestudio-ks0025-tilt/README.md new file mode 100644 index 0000000..07aff6d --- /dev/null +++ b/components/keyestudio-ks0025-tilt/README.md @@ -0,0 +1,23 @@ +# Keyestudio KS0025 digital tiltsensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0025 | +| Type | Mekanisk tilt-/kuglekontakt | +| Interface | `OUT`, `VCC`, `GND` | +| Output | Digitalt | +| Forsyning | 3,3–5 V | + +På referencefotoet er dette modulet med den klare glaskapsel og bevægelige +kontakt. Det registrerer retning, ikke en præcis hældningsvinkel. + +## Tilslutning + +`OUT` forbindes til en digital indgang. Software-debounce anbefales, fordi den +mekaniske kontakt kan skifte flere gange under bevægelse. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0025 Digital Tilt Sensor](https://wiki.keyestudio.com/Ks0025_keyestudio_Digital_Tilt_Sensor) diff --git a/components/keyestudio-ks0026-ir-receiver/README.md b/components/keyestudio-ks0026-ir-receiver/README.md new file mode 100644 index 0000000..6b92743 --- /dev/null +++ b/components/keyestudio-ks0026-ir-receiver/README.md @@ -0,0 +1,22 @@ +# Keyestudio KS0026 digital IR-modtager + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0026 | +| Type | Demodulerende infrarød modtager | +| Interface | `OUT`, `VCC`, `GND` | +| Signal | Digitalt, typisk 38 kHz fjernbetjeningsbærebølge | +| Forsyning | 5 V | + +Modulet modtager kodede IR-signaler fra fjernbetjeninger eller KS0027. + +## Tilslutning + +`OUT` forbindes til en digital indgang. Brug et IR-bibliotek med den valgte pins +interrupt/timer-begrænsninger. Modulet har ingen sketches i repoet endnu. + +## Kilde + +- [Keyestudio KS0026 Digital IR Receiver](https://wiki.keyestudio.com/Ks0026_keyestudio_Digital_IR_Receiver_Module) diff --git a/components/keyestudio-ks0027-ir-transmitter/README.md b/components/keyestudio-ks0027-ir-transmitter/README.md new file mode 100644 index 0000000..db2e8dc --- /dev/null +++ b/components/keyestudio-ks0027-ir-transmitter/README.md @@ -0,0 +1,22 @@ +# Keyestudio KS0027 digital IR-sender + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0027 | +| Type | Infrarød LED-sender | +| Interface | `OUT`, `VCC`, `GND` | +| Forsyning | 3–5 V | +| Typisk bærebølge | 38 kHz | + +Modulet sender fjernbetjeningsprotokoller til blandt andet KS0026 IR-modtageren. + +## Tilslutning + +`OUT` forbindes til en timer/PWM-egnet digital pin. Pinvalg afhænger af det +anvendte IR-bibliotek og board. IR kræver fri eller reflekteret sigtelinje. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0027 Digital IR Transmitter](https://wiki.keyestudio.com/Ks0027_keyestudio_Digital_IR_Transmitter_Module) diff --git a/components/keyestudio-ks0028-photocell/README.md b/components/keyestudio-ks0028-photocell/README.md new file mode 100644 index 0000000..c9acd82 --- /dev/null +++ b/components/keyestudio-ks0028-photocell/README.md @@ -0,0 +1,21 @@ +# Keyestudio KS0028 fotomodstandssensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0028 | +| Type | LDR/fotomodstand i spændingsdeler | +| Interface | `OUT`, `VCC`, `GND` | +| Output | Analogt, afhængigt af lysniveau | +| Forsyning | 5 V | + +## Tilslutning og hensyn + +`OUT` forbindes til en analog indgang. Modulet egner sig til relativ +lysmåling og tærskler, ikke præcis lux-måling. Kalibrér minimum og maksimum i +den aktuelle opstilling. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0028 Photocell Sensor](https://wiki.keyestudio.com/Ks0028_keyestudio_Photocell_Sensor) diff --git a/components/keyestudio-ks0029-push-button/README.md b/components/keyestudio-ks0029-push-button/README.md new file mode 100644 index 0000000..f7ed7d9 --- /dev/null +++ b/components/keyestudio-ks0029-push-button/README.md @@ -0,0 +1,20 @@ +# Keyestudio KS0029 trykknapmodul + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0029 | +| Type | Momentan trykknap | +| Interface | `OUT`, `VCC`, `GND` | +| Output | Digitalt | +| Forsyning | 3,3–5 V | + +## Tilslutning og hensyn + +`OUT` forbindes til en digital indgang. Kontrollér aktivt niveau i den konkrete +sketch og anvend software-debounce. Modulet har ingen sketches i repoet endnu. + +## Kilde + +- [Keyestudio KS0029 Digital Push Button](https://wiki.keyestudio.com/Ks0029_keyestudio_Digital_Push_Button) diff --git a/components/keyestudio-ks0032-rgb-led/README.md b/components/keyestudio-ks0032-rgb-led/README.md new file mode 100644 index 0000000..233117d --- /dev/null +++ b/components/keyestudio-ks0032-rgb-led/README.md @@ -0,0 +1,24 @@ +# Keyestudio KS0032 RGB LED-modul + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Producent | Keyestudio / Keyes | +| Produkt-id | KS0032 | +| Type | RGB-output med tre LED-kanaler | +| Interface | Tre digitale/PWM-signaler og fælles forsyning | +| Forsyning | 5 V | + +Modulet er det runde board øverst til venstre på referencefotoet. Den indbyggede +RGB-LED blander rød, grøn og blå ved at styre kanalerne separat. + +## Tilslutning og hensyn + +Forbind den fælles pin efter boardets silketryk og R, G og B til PWM-egnede pins. +Kontrollér polariteten før tilslutning; logikken kan være inverteret ved fælles +anode. Modulet har ingen sketches i repoet endnu. + +## Kilde + +- [Keyestudio KS0032 RGB LED Module](https://wiki.keyestudio.com/Ks0032_keyestudio_RGB_LED_Module) diff --git a/components/keyestudio-ks0033-thermistor/README.md b/components/keyestudio-ks0033-thermistor/README.md new file mode 100644 index 0000000..639f431 --- /dev/null +++ b/components/keyestudio-ks0033-thermistor/README.md @@ -0,0 +1,23 @@ +# Keyestudio KS0033 analog temperatursensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0033 | +| Type | NTC-termistorbaseret temperatursensor | +| Interface | `OUT`, `VCC`, `GND` | +| Output | Analog spænding fra spændingsdeler | +| Forsyning | 5 V | + +Modulet er kendetegnet ved den lille sorte termistorperle på to lange ben. Det +skal ikke forveksles med reed-, tilt- eller Hall-sensorer. + +## Tilslutning og hensyn + +`OUT` forbindes til en analog indgang. Temperaturen beregnes fra ADC-værdien og +termistorens modstandsmodel; nøjagtige målinger kræver kalibrering. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0033 Analog Temperature Sensor](https://wiki.keyestudio.com/Ks0033_keyestudio_Analog_Temperature_Sensor) diff --git a/components/keyestudio-ks0035-microphone/README.md b/components/keyestudio-ks0035-microphone/README.md new file mode 100644 index 0000000..1dc5497 --- /dev/null +++ b/components/keyestudio-ks0035-microphone/README.md @@ -0,0 +1,23 @@ +# Keyestudio KS0035 mikrofonmodul + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0035 | +| Type | Analog lydsensor med elektretmikrofon | +| Interface | `OUT`, `VCC`, `GND` | +| Forsyning | 3,3–5 V DC | +| Output | Analog spænding proportional med mikrofonsignalet | + +Det blå potentiometer justerer forstærkningen. Modulet måler variationer i lyd, +men er ikke en kalibreret lydtryksmåler. + +## Tilslutning + +`OUT` forbindes til en analog indgang, `VCC` til 3,3 eller 5 V og `GND` til +fælles stel. Modulet har ingen sketches i repoet endnu. + +## Kilde + +- [Keyestudio KS0035 Microphone Sound Sensor](https://wiki.keyestudio.com/KS0035_Microphone_Sound_Sensor_with_Potentiometer) diff --git a/components/keyestudio-ks0037-vibration/README.md b/components/keyestudio-ks0037-vibration/README.md new file mode 100644 index 0000000..55e0c81 --- /dev/null +++ b/components/keyestudio-ks0037-vibration/README.md @@ -0,0 +1,23 @@ +# Keyestudio KS0037 vibrationssensor + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0037 | +| Type | Mekanisk, omnidirektionel vibrationskontakt | +| Interface | `OUT`, `VCC`, `GND` | +| Output | Digital impuls ved vibration | +| Forsyning | 3,3–5 V | + +På referencefotoet er sensorelementet den sorte vandrette cylinder. Modulet +registrerer vibration, men måler ikke en kalibreret acceleration. + +## Tilslutning + +`OUT` forbindes til en digital eller interrupt-egnet indgang. Impulserne er +korte og kan indeholde kontaktstøj. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0037 Vibration Sensor](https://wiki.keyestudio.com/Ks0037_keyestudio_Vibration_Sensor) diff --git a/components/keyestudio-ks0038-reed-switch/README.md b/components/keyestudio-ks0038-reed-switch/README.md new file mode 100644 index 0000000..7954c2d --- /dev/null +++ b/components/keyestudio-ks0038-reed-switch/README.md @@ -0,0 +1,23 @@ +# Keyestudio KS0038 reed switch + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Produkt-id | KS0038 | +| Type | Magnetisk reed-kontakt i glasrør | +| Interface | `OUT`, `VCC`, `GND` | +| Forsyning | 3,3–5 V | +| Typisk detektionsafstand | Op til ca. 10 mm, afhængigt af magneten | + +Dette er modulet med det sorte glasrør mærket `MKA14103`/tilsvarende. Kontakten +skifter, når en magnet føres tæt på. + +## Tilslutning + +`OUT` forbindes til en digital indgang. Glaskapslen er skrøbelig, og kontakten +kan kræve debounce. Ingen sketches endnu. + +## Kilde + +- [Keyestudio KS0038 Reed Switch Module](https://wiki.keyestudio.com/Ks0038_keyestudio_Reed_Switch_Module) diff --git a/devices/lcd1602-i2c-pcf8574/README.md b/components/lcd1602-i2c-pcf8574/README.md similarity index 100% rename from devices/lcd1602-i2c-pcf8574/README.md rename to components/lcd1602-i2c-pcf8574/README.md diff --git a/devices/README.md b/devices/README.md deleted file mode 100644 index 3a4773f..0000000 --- a/devices/README.md +++ /dev/null @@ -1,24 +0,0 @@ -# Eksterne enheder - -Dette katalog registrerer eksterne input- og outputenheder, der bruges sammen -med boards i Arduino Playground: displays, sensorer, aktuatorer, kommunikations- -moduler og andre komponenter. - -Hver fysisk enhedstype får sit eget stabile id og en mappe med: - -- identifikation og relevante tekniske data; -- pinout, spændingsniveauer og tilslutning; -- eventuelle adresser, biblioteker og kendte faldgruber; -- links til alle sketches i repoet, som bruger enheden. - -## Registrerede enheder - -| Enhed | Type | Interface | Brugt med | Sketches | -| --- | --- | --- | --- | --- | -| [LCD1602 med PCF8574T](lcd1602-i2c-pcf8574/README.md) | Output/display | I²C | Arduino UNO R4 WiFi | [`lcd1602_i2c_demo`](../sketches/arduino-uno-r4-wifi/lcd1602_i2c_demo) | - -## Navngivning - -Nye enheder placeres i `devices//`, hvor `device-id` skrives med små -bogstaver og bindestreger, eksempelvis `bme280-temperature-humidity-pressure`. -Profilen opdateres, hver gang enheden bruges i en ny sketch. diff --git a/sketches/arduino-uno-r4-wifi/lcd1602_i2c_demo/README.md b/sketches/arduino-uno-r4-wifi/lcd1602_i2c_demo/README.md index 9de71dc..5ec71a8 100644 --- a/sketches/arduino-uno-r4-wifi/lcd1602_i2c_demo/README.md +++ b/sketches/arduino-uno-r4-wifi/lcd1602_i2c_demo/README.md @@ -4,7 +4,7 @@ En effekt-demo til et HD44780-kompatibelt 16×2-tegndisplay med den almindelige PCF8574/PCF8574A I²C-backpack. Enhedens samlede hardwareprofil findes under -[`devices/lcd1602-i2c-pcf8574`](../../../devices/lcd1602-i2c-pcf8574/README.md). +[`components/lcd1602-i2c-pcf8574`](../../../components/lcd1602-i2c-pcf8574/README.md). Demoen viser: