docs(i18n): add eight more languages to the HALMET documentation

docs/da/errata/index.md

@@ -0,0 +1,15 @@
+---
+title: Kendte fejl
+translated_from: 5ef927a8a1dd611d3215899a52dd6b3bfca86859
+---
+
+# Kendte fejl
+
+Denne side viser alle kendte hardwarefejl i de forskellige HALMET-versioner.
+
+## Version 1.0.0
+
+De digitale indgange 3 og 4 er byttet om i silketrykket på bagsiden. De korrekte benforbindelser er:
+
+  - DI3: GPIO 27
+  - DI4: GPIO 26

docs/da/getting-started/index.md

@@ -0,0 +1,73 @@
+---
+title: Kom godt i gang
+translated_from: 75bcdba18bc044c04ce3e220067bf537e069ec82
+---
+
+# Kom godt i gang
+
+## Samling af hardwaren
+
+For at stikkene kan placeres mere frit i små kabinetter, leveres HALMET-kortene uden 1-Wire- og GPIO-stiklisterne monteret. Hvis du regner med at bruge en af disse grænseflader, skal du selv lodde stiklisten fast på kortet.
+
+Har du brug for en vejledning i at lodde stikben fast på kortet, kan du se SH-ESP32'ens [vejledning til samling af hardwaren](https://docs.hatlabs.fi/sh-esp32/pages/getting-started/#revision-1-boards).
+
+## Strømforsyning af kortet
+
+HALMET forsynes gennem NMEA 2000-stikket. Hvis du skal slutte HALMET til et NMEA 2000-netværk, kan du forsyne kortet direkte fra netværket. Tilslut i så fald NMEA 2000-ledningerne til den 4-benede aftagelige klemrække som vist på figuren nedenfor.
+
+<figure markdown="span">
+![](halmet_n2k_input.jpg){ width="50%" }
+<figcaption>Tilslut NMEA 2000-ledningerne til stikket som vist.</figcaption>
+</figure>
+
+Hvis du ikke skal slutte HALMET til et NMEA 2000-netværk, skal du bruge det samme stik, men kun tilslutte ledninger til `-` og `+`. Enhver strømforsyning på 5–32 V kan bruges. Kortets typiske strømforbrug med WiFi aktiveret er 0,07 A ved 12 V.
+
+<figure markdown="span">
+![](power_connector.jpg){ width="50%" }
+<figcaption>Tilslut forsyningsledningerne til stikket som vist.</figcaption>
+</figure>
+
+## Kabinetter
+
+Om bord på en båd bør HALMET altid placeres i et vandtæt kabinet.
+Kortet er konstrueret, så det passer i [SH-ESP32-kabinettet](https://shop.hatlabs.fi/products/sh-esp32-enclosure). Nedenfor ses et eksempel på et HALMET-kort monteret i kabinettet.
+
+<figure markdown="span">
+![](halmet_small_enclosure.jpg){ width="50%" }
+<figcaption>HALMET monteret i SH-ESP32-kabinettet.</figcaption>
+</figure>
+
+SH-ESP32-kabinettet har begrænset plads til stik.
+Hver af langsiderne kan i praksis kun rumme 2–3 panelstik.
+Hvis du regner med at tilslutte mere end nogle få indgange, anbefales et større kabinet.
+For eksempel har Hat Labs' [kompakte SH-RPi-kabinet](https://shop.hatlabs.fi/products/compact-weatherproof-enclosure-for-raspberry-pi-and-sh-rpi-158x90x60-mm), som ses nedenfor, rigelig plads til stik.
+
+<figure markdown="span">
+![](medium_enclosure.jpg){ width="50%" }
+<figcaption>Det kompakte SH-RPi-kabinet giver mere plads til placering af panelstik.</figcaption>
+</figure>
+
+
+Andre egnede vandtætte kabinetter er nemme at finde i enhver netbutik. Større samledåser til udendørs brug kan også bruges til formålet.
+
+### Boring af huller til panelstik
+
+Kabinetterne har normalt ingen forborede huller. Brug altid et konisk bor eller et trinbor (det, der ligner et lille juletræ af metal), når du borer huller. Almindelige metalbor bider let for hårdt og kan revne kabinetvæggen.
+
+Når du planlægger placeringen af huller og stik, skal du sørge for plads nok til at spænde stikkenes møtrikker og til selve stikhuset. Hvis du planlægger at vægmontere kabinettet, anbefales det at vende stikkene nedad, så risikoen for indtrængende vand bliver mindst mulig.
+
+Passende hulstørrelser til forskellige stik:
+
+- PG7-kabelforskruning og M12-panelstik (NMEA 2000): 12,5 mm eller 1/2"
+- SP13-panelstik (de blåsorte plaststik): 13 mm
+- PG9-kabelforskruning: 16 mm eller 5/8"
+
+Gennemføringstyller af gummi eller silikone giver plads til væsentligt flere kabler end panelstik eller kabelforskruninger. De er dog ikke lige så vandtætte som panelstik eller kabelforskruninger. Desuden kræver de, at kablet monteres permanent, hvilket kan gøre det vanskeligere at servicere systemet.
+
+TODO: Tilføj et billede af en gennemføringstyl.
+
+### Lodning af panelstikkene
+
+Brug altid krympeflex på de enkelte ledere, når du lodder de indvendige ledninger til panelstikkene.
+Husk altid at trække krympeflexen ind på ledningen, _inden_ du lodder...
+Som regel kan du først fylde loddetin i stikbenets hulrum og derefter smelte tinnet igen og føre lederen ind.

docs/da/hardware/index.md

@@ -0,0 +1,230 @@
+---
+title: Hardwarebeskrivelse
+translated_from: 96f96c3aff8d2a33ab2f1b59c0dbb8747c8ed3e2
+---
+
+# Hardware
+
+## Introduktion til ESP32
+
+HALMET er baseret på det kraftfulde mikrocontrollermodul ESP32-WROOM-32E. ESP32 er en dobbeltkernet mikrocontroller med indbygget WiFi og Bluetooth. ESP32 er et populært valg til IoT-applikationer på grund af den lave pris, det gode udvalg af perifere enheder og den enkle anvendelse.
+
+## Kortets funktionsblokke
+
+Kortets forskellige funktionsblokke er beskrevet nedenfor.
+
+<figure markdown="span">
+![](HALMET-func.jpg){ width="60%" }
+<figcaption>HALMETs funktionsblokke.</figcaption>
+</figure>
+
+1.  NMEA 2000 samt strømindgang og beskyttelse. NMEA 2000-stikket har følgende
+    beskyttelseselementer:
+    - 500 mA selvgendannende sikring
+    - Diode til beskyttelse mod omvendt polaritet
+    - TVS-dioder til overspændings- og ESD-beskyttelse
+    - Totrins støjfiltrering
+
+2.  Strømforsyning. En switchmode-strømforsyning med en maksimal udgangsstrøm på 2 A.
+
+3.  CAN-transceiver til NMEA 2000. RX- og TX-LED'er giver en visuel indikation af
+    aktiviteten på CAN-bussen.
+
+4.  I2C- og 1-Wire-grænseflader til tilslutning af yderligere sensorer.
+
+5.  Brugergrænseflade. En reset-knap, en knap til boot-tilstand og generelle formål,
+    en rød strøm-LED og en blå brugerprogrammerbar LED.
+
+6.  USB 2.0-grænseflade til programmering og fejlfinding.
+
+7.  ESP32-WROOM-32E-modul med indbygget WiFi og Bluetooth. Modulet på HALMET-kortet
+    indeholder 16 MB flashhukommelse.
+
+8.  Kredsløb til galvanisk adskillelse af de digitale og analoge indgange.
+
+9.  Analoge indgange. Kortet har fire analoge indgange med 16-bits opløsning og en
+    maksimal indgangsspænding på 33 V. Hver indgang har beskyttelse mod under- og
+    overspænding samt lavpasfiltrering med en knækfrekvens på 160 Hz, som reducerer
+    målestøjen.
+
+    De analoge indgange har en valgfri konstantstrømkilde på 10 mA til aktiv
+    modstandsmåling. Konstantstrømkilden kan aktiveres med CCS-jumperstiklisterne.
+
+    I modstandsmåletilstand er den største modstand, der kan måles, 300 ohm.
+
+10. Digitale indgange. HALMET har fire digitale indgange med en maksimal
+    indgangsspænding på ±32 V. Indgangene har en Schmitt trigger, der forbedrer
+    støjimmuniteten.
+
+
+## Galvanisk adskillelse
+
+Kortet har galvanisk adskillelse mellem de digitale og analoge indgange og
+ESP32-mikrocontrolleren. Adskillelsen er opnået med digitale isolatorer til
+henholdsvis I2C og de fire digitale indgange samt med en adskilt DC/DC-omformer,
+der forsyner den adskilte del.
+
+Takket være adskillelsen kan kortet forsynes fra NMEA 2000-netværket uden risiko
+for jordsløjfer. Adskillelsen beskytter også mod spændingsspidser og støj på
+indgangene.
+
+<figure markdown="span">
+![](HALMET-isolation.jpg){ width="60%" }
+<figcaption>HALMETs isolationsbarriere. Indgangsstikkene er adskilt fra resten af kortet,
+hvilket betyder, at de ikke har fælles jordforbindelse med resten af kortet.</figcaption>
+</figure>
+
+## Stik
+
+<div class="row" markdown>
+  <div class="col-sm-6" markdown>
+
+<figure markdown="span">
+![](HALMET-conx-top.jpg){ width="100%" }
+<figcaption>HALMETs stik, oversiden.</figcaption>
+</figure>
+
+   </div>
+   <div class="col-sm-6" markdown>
+
+<figure markdown="span">
+![](HALMET-conx-bottom.jpg){ width="100%" }
+<figcaption>HALMETs stik, undersiden.</figcaption>
+</figure>
+
+   </div>
+</div>
+
+### Stik på oversiden
+
+1.  NMEA 2000-stik. Stikket er en 4-benet aftagelig klemrække, der er kompatibel
+    med Phoenix MC 3.81. Stikket bruges til at forbinde kortet til et
+    NMEA 2000-netværk og til at forsyne kortet.
+
+2.  1-Wire-stikliste. 1-Wire-stiklisten kan bruges til at forbinde 1-Wire-sensorer
+    til kortet. Den er en 3-benet stikliste med 2,54 mm benafstand. Stiklisten er
+    ikke monteret på kortet fra fabrikken, fordi den kan komme i vejen for
+    placeringen af kabinettets panelstik.
+
+3.  I2C-stikliste. I2C-stiklisten kan bruges til at forbinde I2C-sensorer til
+    kortet. Den er en 4-benet stikliste med 2,54 mm benafstand.
+
+4.  Micro USB-stik. Stikket bruges til programmering og fejlfinding af kortet.
+
+5.  Ubestykkede loddeflader til reset- (EN) og boot-signalerne (IO0).
+
+6.  GPIO-stikliste. GPIO-stiklisten er en 2×10-benet stikliste med 2,54 mm
+    benafstand. Stiklisten fører ESP32'ens ledige GPIO-ben ud og kan også bruges
+    som JTAG-stikliste.
+
+7.  Stikliste til forsyning af det adskilte område. Stiklisten kan bruges til at
+    forsyne eksterne enheder fra 3V3 og GND i den adskilte del.
+
+8.  Jumperkontakter til konstantstrømkilden (CCS) til de analoge indgange.
+    Konstantstrømkilden kan aktiveres ved at kortslutte jumperkontakterne.
+
+9.  Stik til analoge indgange. Stikkene er 2-benede aftagelige klemrækker, der er
+    kompatible med Phoenix MC 3.81. Stikkene bruges til at forbinde analoge
+    sensorer til kortet.
+
+10. Stik til digitale indgange. Stikkene er 2-benede aftagelige klemrækker, der er
+    kompatible med Phoenix MC 3.81. Stikkene bruges til at forbinde digitale
+    sensorer til kortet.
+
+### Stik på undersiden
+
+11.  Loddejumper til CAN-terminering. Loddejumperen kan kortsluttes for at aktivere
+     termineringsmodstanden på 120 ohm til CAN-bussen. Brug ikke
+     termineringsmodstanden i NMEA 2000-netværk.
+
+12.  Loddejumper til lavpasfilter. Loddejumperen kan kortsluttes for at aktivere et
+     lavpasfilter på den pågældende analoge indgang. Filteret har en knækfrekvens
+     på 2,3 kHz. Filteret kan for eksempel bruges til at reducere støj i signalet
+     fra en omdrejningstæller.
+
+13.  Loddejumper til pull-down-modstand. Loddejumperen kan kortsluttes for at
+     aktivere en pull-down-modstand på 100 kohm på den pågældende digitale indgang.
+     Pull-down-modstanden kan bruges til at aflæse en normalt åben (NO) kontakt,
+     som trækkes høj, når den er sluttet.
+
+14.  Loddejumper til pull-up-modstand. Loddejumperen kan kortsluttes for at aktivere
+     en pull-up-modstand på 100 kohm på den pågældende digitale indgang.
+     Pull-up-modstanden kan bruges til at aflæse en normalt sluttet (NC) kontakt,
+     som trækkes lav, når den er sluttet.
+
+15.  Loddejumpere til valg af ADS1115'ens I2C-adresse. Loddejumperne kan kortsluttes
+     for at vælge I2C-adressen på analog-digital-omsætteren (ADC) ADS1115.
+     Loddejumperne bruges til at undgå adressekonflikter, når der er forbundet flere
+     ADS1115-AD-omsættere til den samme I2C-bus. Loddefladerne kan også bruges til
+     at forbinde yderligere I2C-enheder til kortets adskilte område.
+
+### GPIO-oversigt
+
+HALMET reserverer et antal GPIO-ben til de perifere indgangsenheder. Ledige GPIO-ben
+er ført ud til den 2×10-benede GPIO-stikliste. Følgende tabel viser GPIO-benene og
+deres funktioner.
+
+|    GPIO | Funktion    | Bemærkninger                                       |
+| ------: | :---------- | :------------------------------------------------- |
+|       0 | Boot-knap   | Går i bootloader, når benet trækkes lavt           |
+|       1 | TXD0        | Sender data til USB                                |
+|       2 | LED         | Rød LED på kortet                                  |
+|       3 | RXD0        | Modtager data fra USB                              |
+|       4 | 1-Wire DQ   | 1-Wire-datalinje                                   |
+|       5 | -           | Ledig på GPIO-stiklisten                           |
+|      12 | - / TDI     | Ledig på GPIO-stiklisten. Alternativt: JTAG TDI    |
+|      13 | - / TCK     | Ledig på GPIO-stiklisten. Alternativt: JTAG TCK    |
+|      14 | - / TMS     | Ledig på GPIO-stiklisten. Alternativt: JTAG TMS    |
+|      15 | - / TDO     | Ledig på GPIO-stiklisten. Alternativt: JTAG TDO    |
+|      16 | -           | Ledig på GPIO-stiklisten                           |
+|      17 | -           | Ledig på GPIO-stiklisten                           |
+|      18 | CAN RX      | Modtager fra NMEA 2000                             |
+|      19 | CAN TX      | Sender til NMEA 2000                               |
+|      21 | I2C SDA     | I2C-datalinje. Bruges til analog indgang           |
+|      22 | I2C SCL     | I2C-klokkelinje. Bruges til analoge indgange       |
+|      23 | DI1         | Digital indgang 1                                  |
+|      25 | DI2         | Digital indgang 2                                  |
+|      27 | DI3         | Digital indgang 3                                  |
+|      26 | DI4         | Digital indgang 4                                  |
+|      32 | -           | Ledig på GPIO-stiklisten                           |
+|      33 | -           | Ledig på GPIO-stiklisten                           |
+|      34 | -           | Ledig på GPIO-stiklisten                           |
+|      35 | -           | Ledig på GPIO-stiklisten                           |
+| 36 (VP) | Kun indgang | Ledig på GPIO-stiklisten                           |
+| 39 (VN) | Kun indgang | Ledig på GPIO-stiklisten                           |
+
+
+## Strømforsyning
+
+Det tilladte indgangsspændingsområde på kortet er 5–32 V. Det typiske strømforbrug er
+90 mA ved 12 V med WiFi-modulet aktivt (svarer til 1,1 W).
+
+## NMEA 2000
+
+NMEA 2000 er en udbredt kommunikationsstandard, der bruges til at forbinde sensorer, styreenheder og displayenheder på både og skibe. Den bygger på Controller Area Network (CAN-bussen), som er en køretøjsbusstandard, der er udviklet, så enheder kan kommunikere indbyrdes uden en værtscomputer.
+
+Kortet overholder NMEA 2000-standarden, så længe ingen af de ikke-adskilte stik er forbundet til andre enheder med fælles jordreference. En 1-Wire-temperatursensor med et langt kabel kan for eksempel bruges, fordi den ikke har fælles jordforbindelse med andre enheder. Derimod ville det bryde overensstemmelsen med NMEA 2000 at forbinde en I2C-AD-omsætter til det ikke-adskilte I2C-stik.
+
+TODO: NMEA 2000-benforbindelser til GPIO
+
+## Status-LED'er
+
+Der er to knapper og to LED'er på HALMET-kortet. De to knapper er mærket Reset og Boot. Reset-knappen genstarter kortet ved at trække ESP32'ens Enable-ben lavt. Boot-knappen er forbundet til GPIO0 og kan bruges under opstart af enheden til at tvinge modulet i download-tilstand. Ellers kan den bruges som en almindelig knapindgang.
+
+De to LED'er er ikke udtrykkeligt mærket. Den røde LED lyser, når der er 3,3 V forsyning på kortet. Den blå LED er forbundet til GPIO2 (det ben, der almindeligvis bruges til LED på ESP32-udviklingskort). Den kan styres af brugerprogrammer og vise enhedens tilstand.
+
+## 1-Wire
+
+1-Wire er et bussystem til kommunikation mellem enheder, udviklet af Dallas Semiconductor, som siden er blevet opkøbt af Maxim Integrated Products. Selvom 1-Wire er en langsom protokol, der kun understøtter hastigheder op til 16,3 kbit/s, er den meget enkel at implementere og kan bruges over lange afstande. Den bruges almindeligvis til temperatursensorer og lignende enkle måleenheder.
+
+HALMETs 1-Wire-implementering har ESD- og RF-støjfiltrering samt lavpasfiltrering, der forbedrer netværkets pålidelighed.
+
+Bemærk, at 1-Wire-databenet (mærket »DQ«) fysisk er forbundet til GPIO4, så brug GPIO4 til alle 1-Wire-data i dit program.
+
+## I2C
+
+I2C (Inter-Integrated Circuit) er en meget udbredt synkron seriel kommunikationsbus, der almindeligvis bruges til at forbinde en række forskellige IC'er. Den bruger to dataledninger ud over spænding og jordforbindelse.
+
+HALMET bruger I2C internt til AD-omsætteren ADS1115. I2C-bussen er også ført ud til en 4-benet stikliste, så der kan forbindes yderligere I2C-enheder.
+
+I2C-bussen er forbundet til GPIO21 (SDA) og GPIO22 (SCL) på ESP32'en. Disse ben er standardbenene til I2C i Arduinos ESP32-miljø, men de er forskellige fra standardbenene på SH-ESP32.

docs/da/index.md

@@ -0,0 +1,35 @@
+---
+title: Introduktion
+translated_from: 864a9f606fb309bc3e706c3231d0ec7208b25eed
+---
+
+# Introduktion
+
+HALMET, Hat Labs Marine Engine & Tank interface, er et udviklingskort til tilslutning af motor- og tanksensorer på både og andre køretøjer. Det kan bruges til at aflæse digitale og analoge sensorer og til at kommunikere med andre enheder via NMEA 2000, WiFi, Bluetooth, I2C, 1-Wire eller GPIO.
+
+<figure markdown="span">
+![](halmet_v1_top_photo.jpg){ width="60%" }
+<figcaption>Billede af HALMET</figcaption>
+</figure>
+
+## Vigtigste funktioner
+
+- **Fire digitale indgange**: HALMET har fire digitale indgange til aflæsning af digitale alarmsignaler eller til brug som tællere. Indgangene tåler spændinger mellem −32 V og +32 V. De digitale indgange kan bruges både til at registrere signalniveauer og til tidsvarierende signaler som motorens omdrejningstal, brændstofflow eller pulser fra en kædetæller.
+
+- **Fire analoge indgange**: HALMET har fire analoge indgange til aflæsning af analoge sensorer. Indgangene tåler spændinger mellem −32 V og +32 V og har et måleområde fra 0 til 33 V. Indgangene er forbundet til en 16-bits analog-digital-omsætter (ADC) af typen ADS1115. De analoge indgange kan bruges både til passiv spændingsmåling og til aktiv modstandsmåling.
+
+- **NMEA 2000-kompatibel**: HALMET er fuldt kompatibel med NMEA 2000-standarden. Kortet kan sluttes til et NMEA 2000-netværk gennem den indbyggede NMEA 2000-grænseflade.
+
+- **I2C-, 1-Wire- og GPIO-grænseflader**: HALMET har en 4-benet I2C-grænseflade, en 3-benet 1-Wire-grænseflade og 13 tilgængelige almene ind- og udgange (GPIO).
+
+- **WiFi og Bluetooth**: HALMET har et indbygget ESP32-WROOM-32E-modul med WiFi og Bluetooth. De understøtter både tilslutning til eksisterende WiFi-netværk og oprettelse af et WiFi-adgangspunkt, så du kan forbinde dig direkte til kortet.
+
+- **ESP32-WROOM-32E med 16 MB flashhukommelse**: ESP32-WROOM-32E-modulet giver rigelig regnekraft og hukommelse til selv de mest krævende anvendelser. De 16 MB flashhukommelse gør det muligt at gemme store datamængder lokalt.
+
+- **Bredt indgangsspændingsområde**: HALMET kan uden videre forsynes fra de 12 V- eller 24 V-anlæg, der normalt findes i køretøjer og både. HALMET tåler indgangsspændinger mellem 5 V og 32 V.
+
+HALMET er åben hardware og udgives under licensen Creative Commons Attribution-ShareAlike 4.0 International.
+
+## Anskaffelse af hardwaren
+
+Du kan købe HALMET-kort hos [Hat Labs Oy](https://shop.hatlabs.fi). Alle designfiler er desuden tilgængelige i [GitHub-repositoriet med HALMET-hardwaren](https://github.com/hatlabs/halmet-hardware/).

docs/da/revisions/index.md

@@ -0,0 +1,23 @@
+---
+title: Hardwareversioner
+translated_from: b998495eda7b60a66b73cfc622807d9d9c4e8043
+---
+
+# Hardwareversioner
+
+## Introduktion
+
+Denne side beskriver kortets forskellige versioner og indeholder links til kredsløbsdiagrammerne. Hele historikken for designfilerne findes i [GitHub-repositoriet HALMET-hardware](https://github.com/hatlabs/HALMET-hardware).
+
+
+## Version 1.0.0
+
+Første offentliggjorte version.
+
+Kredsløbsdiagram: [HALMET-v1.0.0-schema.pdf](HALMET-v1.0.0-schema.pdf)
+
+## Version 1.0.1
+
+Rettelser og forbedringer af silketrykket. 3V3- og GND-loddeflader er tilføjet på det adskilte område.
+
+Kredsløbsdiagram: [HALMET-v1.0.1-schema.pdf](HALMET-v1.0.1-schema.pdf)