Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Språkfixar #38

Open
wants to merge 13 commits into
base: main
Choose a base branch
from
2 changes: 1 addition & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Energiföretagen Sverige har tagit fram en [branschrekommendation](https://www.e
för hur HAN-porten på svenska elmätare bör utformas. Men vissa nätbolag rullade ut nya
mätare med HAN-port innan dessa rekommendationer var fullt på plats. Därför finns det
även elmätare med den [norska](norska/porten.md) varianten av HAN-port. Skillnaden är att den norska är
en RJ45 kontakt (vanlig internetsladd) och den [svenska](svenska/porten.md) är en RJ12 kontakt.
en RJ45-kontakt (vanlig internetsladd) och den [svenska](svenska/porten.md) är en RJ12-kontakt.

## Om HANporten.se

Expand Down
4 changes: 2 additions & 2 deletions docs/matare.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ hide:

# Mätare

En samling av de mätare som används i Sverige och vart HAN-porten sitter på dem.
En samling av de mätare som används i Sverige och var HAN-porten sitter på dem.

## Aidon 6534

Expand Down Expand Up @@ -50,4 +50,4 @@ HAN-porten sitter under luckan i nedre vänstra hörnet.

![SanXing S34U18](images/sanxing_s34u18.jpg)

HAN-porten sitter under den grå luckan nere till höger.
HAN-porten sitter under den grå luckan nere till höger.
12 changes: 6 additions & 6 deletions docs/natbolag.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Information om hur man aktiverar HAN-porten hos olika elnätsbolag.
## E.ON

Det är möjligt att aktivera porten via `Minas Sidor` eller via E.ONs app. Hittas under `Mina Avtal`.
I E.ONs nät finns mätarna:
I E.ON:s nät finns mätarna:

* [Landis & Gyr E360](matare.md#landis--gyr-e360)
* [Iskra AM550](matare.md#iskra-am550) (E.ON aktiverar inte HAN-porten på denna mätartyp)
Expand All @@ -31,14 +31,14 @@ I Ellevios nät finns mätarna:

Man aktiverar porten genom att fylla i ett webbformulär här: [https://www.eem.se/privat/elnat/elmatare/han-porten/](http://www.eem.se/privat/elnat/elmatare/han-porten/)

I Eskilstuna Energi och Miljö elnät finns mätarna:
I Eskilstuna Energi och Miljös elnät finns mätarna:

* [Aidon 6534](matare.md#aidon-6534)

## Mälarenergi

I dagsläget har Mälarenergi ingen självbetjäning för aktivering av HAN-porten.
För att aktivera HAN-porten måste du ta kontakt med deras [kundtjänst](https://www.malarenergi.se/kundcenter-privat/)
För att aktivera HAN-porten måste du ta kontakt med deras [kundtjänst](https://www.malarenergi.se/kundcenter-privat/).

I Mälarenergis nät finns mätarna:

Expand All @@ -50,14 +50,14 @@ HAN-porten kan aktiveras genom att kontakta kundtjänst.

I Nacka Energis nät finns mätarna:

* [Kaifa MA304](matare.md#kaifa-ma304) (Med svensk HAN-port)
* [Kaifa MA304](matare.md#kaifa-ma304) (med svensk HAN-port)


## SEVAB Strängnäs Energi

Man aktiverar porten genom att fylla i ett webbformulär här: [https://www.sevab.com/privat/elnat/elmatare/han-porten/](https://www.sevab.com/privat/elnat/elmatare/han-porten/)

I SEVABs elnät finns mätarna:
I SEVAB:s elnät finns mätarna:

* [Aidon 6534](matare.md#aidon-6534)

Expand Down Expand Up @@ -90,4 +90,4 @@ HAN-porten aktiveras genom `Mina Sidor`.

I Vattenfalls när finns mätarna:

* [SanXing S34U18](matare.md#sanxing-s34u18)
* [SanXing S34U18](matare.md#sanxing-s34u18)
3 changes: 1 addition & 2 deletions docs/norska/kretsschema.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,10 @@
Här samlar vi information om kretsar för att få ut signalen korrekt från den norska HAN-porten.

Mätaren agerar Mbus master som pushar data. För att läsa av informatinen behövs en
krets för Mbus slav.
krets för Mbus-slav.

!!! warning "Ej testat av Utilitarian"
Vi har inte testat av någon av dessa möjliga lösningar.

* [USB adapter](https://www.amazon.de/FangWWW-Master-Slave-Kommunikation-Debugging-%C3%9Cberwachung/dp/B07X6NBD9M/)
* [Mbus transceiver](https://www.ti.com/product/TSS721A)

6 changes: 3 additions & 3 deletions docs/norska/lösningar.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Lösningar

Här samlar vi länkar till olika lösningar som finns att köpa eller bygga själv
för utläsning av den norska HAN-porten.
för utläsning från den norska HAN-porten.

Om du har en länk du vill få med på denna sidan, forka repot på Github, gör en ny
branch på din fork där du lägger till länken och öppna sedan ett pull-requeset för att
Om du har en länk du vill få med på denna sida, forka repot på Github, gör en ny
branch på din fork där du lägger till länken och öppna sedan en pull-requeset för att
merga in dina ändringar till sidan.

!!! note "OBS!"
Expand Down
15 changes: 4 additions & 11 deletions docs/norska/porten.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@

HAN-porten, eller P1-porten, sitter oftast under ett litet lock på din elmätare.

Den norska varianten består av ett RJ45 uttag, samma som på vanliga internetsladdar.
Den norska varianten består av ett RJ45-uttag, samma som på vanliga internetsladdar.

## Spänningsmatning av utrustning

Eftersom det elektriska interfacet är MBus är det möjligt att spänningsmata din
utrustning genom porten. Men det krävs en ordentligt Mbus slave implementation på
hårdvarusidan.
utrustning genom porten, men det krävs en ordentlig Mbus slave-implementation på
hårdvarusidan.

## PIN-layout

Expand All @@ -23,11 +23,4 @@ Pin | Namn | Beskrivning | Kommentar
## Koppla in extra utrustning

MBus i mätaren agerar master och det är möjligt att ha flera slavar på slingan som
lyssnar pushad data.







lyssnar på pushad data.
12 changes: 6 additions & 6 deletions docs/norska/protokollet.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Protokollet

Protokollet som skickas på den norska HAN-porten är en DLMS/COSEM DataNotification APDU i en
HDLC unnumbered information frame
Datan som skickas på den norska HAN-porten är en DLMS/COSEM DataNotification APDU i en
HDLC unnumbered information frame.

!!! note "Ej verifierat"
Vi har ingen mätare med denna typ av port och har inte verifierat om allt är helt korrekt.
Men om någon har en mätare med denna port får de gärna verifiera och meddela oss.
Om någon har en mätare med denna port får de gärna verifiera och meddela oss.

## Datainnehåll

Expand All @@ -15,7 +15,7 @@ och flera rader som innehåller OBIS, värde, skalär och enhet.

## Seriellt gränssnitt

Data skickas med 2400 baud och i byteformat `8E1`
Data skickas med 2400 baud och i byteformat `8E1`.

## Exempeldata

Expand All @@ -40,10 +40,10 @@ Data skickas med 2400 baud och i byteformat `8E1`
```
## Läs ut datan

HDLC frames är inramade av ascii tilde `~`/`0x7e`.
HDLC frames är inramade av ASCII-tilde (`~`/`0x7e`).

Ett enkelt program som läser av ett seriellt gränssnitt kan läsa tills det hittar en
frame-end och testa att parsa inläst data som en hdlc-frame. Om det inte går att parsa
frame-end och testa att parsa inläst data som en HDLC-frame. Om det inte går att parsa
fortsätter man läsa tills nästa frame-end.

## Parsa data
Expand Down
2 changes: 1 addition & 1 deletion docs/svenska/avvikelser.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Avvikande implementationer

En lista på de olika, från branschrekommendationer, avvikande implementationer som har
återfunnits i Sverige på en RJ12 port.
återfunnits i Sverige på en RJ12-port.

## HDLC + DLMS Push.

Expand Down
12 changes: 6 additions & 6 deletions docs/svenska/kretsschema.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,12 @@

Här samlar vi information om kretsar för att få ut signalen korrekt från HAN-porten.

För att koppla in datasignalen enkelt i, till exempel, en Arduino eller Raspberry Pi
behöves signalen inverteras.
För att koppla in datasignalen enkelt i till exempel en Arduino eller Raspberry Pi
behövs signalen inverteras.

Nedan är en enkel inverter-krets baserat på en PNP-transistor
Nedan är en enkel inverter-krets baserat på en PNP-transistor.

![PNP inverter krets](../images/p1_pnp_inverter_schematic.png)
![PNP inverterkrets](../images/p1_pnp_inverter_schematic.png)

!!! note "OBS!"
Denna krets är inget vi rekommenderar i en produkt, men duger bra om man vill
Expand All @@ -17,5 +17,5 @@ Nedan är en enkel inverter-krets baserat på en PNP-transistor
protokollimplementationen om det behövs.

Om det finns någon med bättre hårdvarukunskaper än oss som vill dela med sig av en
bättre design lägger vi gärna upp det på denna sidan. Helst under en Open Hardware
licens.
bättre design lägger vi gärna upp det på denna sida. Helst under en Open
Hardware-licens.
6 changes: 4 additions & 2 deletions docs/svenska/lösningar.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,22 @@
# Lösningar

Här samlar vi länkar till olika lösningar som finns att köpa eller bygga själv
för utläsning av den svenska HAN-porten.
för utläsning av den svenska HAN-porten.

Om du har en länk du vill få med på denna sidan, forka repot på Github, gör en ny
branch på din fork där du lägger till länken och öppna sedan ett pull-requeset för att
branch på din fork där du lägger till länken och öppna sedan en pull-request för att
merga in dina ändringar till sidan.

!!! note "OBS!"
Vi validerar inte att några av dessa lösningarna faktiskt fungerar utan
har listan som en hjälp till de som letar efter en lösning.

## Köp

* [PiiGAB HAN-P1 Converter, omvandlar HAN-P1 till M-Bus](https://www.piigab.com/product/piigab-han-p1-to-m-bus-converter/)
* [https://amsleser.no/ - Färdiga moduler eller byggkit för HAN-porten](https://amsleser.no/)
* [https://www.homewizard.com/p1-meter/ - Dongel för P1 porten](https://www.homewizard.com/p1-meter/)

## Bygg själv

* [https://amsleser.no/ - Färdiga moduler eller byggkit för HAN-porten](https://amsleser.no/)
Expand Down
17 changes: 5 additions & 12 deletions docs/svenska/porten.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Svenska porten

HAN-porten, eller P1-porten, sitter oftast under ett litet lock på din elmätare. Den
består av ett RJ12 uttag. Den svenska porten är baserad på
[DSMR P1 Companion Standard](https://www.netbeheernederland.nl/_upload/Files/Slimme_meter_15_a727fce1f1.pdf)
består av ett RJ12-uttag. Den svenska porten är baserad på
[DSMR P1 Companion Standard](https://www.netbeheernederland.nl/_upload/Files/Slimme_meter_15_a727fce1f1.pdf).

## Spänningsmatning av utrustning

Expand All @@ -12,7 +12,7 @@ Det är möjligt att spänningsmata din utrustning direkt från HAN-porten. Den

!!! note "Hör med ditt nätbolag"
Enligt rekommendationerna är det inte ett krav att leverera en HAN-port med
spänningsmatning från mätarna. Så det är möjligt att den mätare ditt elbolag köpt
spänningsmatning från mätarna, så det är möjligt att den mätare ditt elbolag köpt
in inte kan spänningsmata utrustningen. Men de största bolagen levererar port med
spänningsmatning.

Expand All @@ -31,13 +31,6 @@ Pin | Namn | Beskrivning | Kommentar

## Koppla in extra utrustning

Om du behöver mer än en enhet kan du använda en hub som delar datasignalen till flera
HAN-portar. Men detta kan kräva att man måste spänningsmata utrustningen separat då det
Om du behöver mer än en enhet kan du använda en hubb som delar datasignalen till flera
HAN-portar. Detta kan kräva att man måste spänningsmata utrustningen separat då det
inte är säkert att HAN-porten kan driva flera enheter.







42 changes: 21 additions & 21 deletions docs/svenska/protokollet.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
# Protokollet

Protokollet baseras på IEC62056-21 Mode D. Men några skillnader som anges nedan.
Protokollet baseras på IEC62056-21 Mode D, men med några skillnader som anges nedan.
Om du vill fördjupa dig i IEC62056-21 så kan du kolla in vårt
[open source bibliotek](https://github.com/pwitab/iec62056-21) för
[open source-bibliotek](https://github.com/pwitab/iec62056-21) för
protokollet.

## Seriellt gränssnitt

Man läser av data via ett seriellt gränssnitt. Till skillnad på IEC62056-21 så skall
teckenformatet vara `8N1` (8 databits, ingen paritet, en stop bit). Standard IEC62056-21 är 7E1
teckenformatet vara `8N1` (8 databitar, ingen paritet, en stoppbit). Standard IEC62056-21 är `7E1`.

Överföringshastigheten är satt fast till `115200 baud`
Överföringshastigheten är satt fast till `115200 baud`.

!!! example "Kodexempel för seriell port"

Expand Down Expand Up @@ -60,33 +60,33 @@ När HAN-porten får +5V på `DATA REQUEST` börjar den skicka data på `DATA OU
Data skickas var 10:e sekund.

Porten är enkelriktad så det är inte möjligt att skicka någon data till mätaren,
vilket gör det enkelt endast lyssna efter data.
vilket gör det enkelt genom att bara lyssna efter data.

## Meddelandestruktur

Den generella meddelandestrukturen för ett meddelande på HAN-porten är:

`/ XXXZ Ident CR LF CR LF Data ! CRC CR LF`

Varje del av meddelandet är separerat med `CR LF` dvs line-breaks. Så när man gör ett
program är det smidigt att använda en `readline` funktion som finns i de flesta
Varje del av meddelandet är separerat med `CR LF`, det vill säga radbrytningar. När man gör ett
program är det smidigt att använda en `readline`-funktion som finns i de flesta
programspråk.

1. Första raden: `/ XXXZ Ident CR LF` innehåller information som identifierar mätaren.
De första 3 bokstäverna är ett [FLAG ID](https://www.dlms.com/eng/flag-id-list-44143.shtml)
som visar vilken tillverkar det är. Z visar på vilken baudrate, men den behöver inte
som visar vilken tillverkare det är. Z visar på vilken baudrate, men den behöver inte
stämma eftersom HAN-porten kör på en fast baudrate. Ident är det unika ID:t på mätaren.

2. Sedan kommer en tom rad som visar att datan börjar.

3. Ett flertal datarader. Se mer under [Datarader](protokollet.md#datarader)
3. Ett flertal datarader. Se mer under [Datarader](protokollet.md#datarader).

4. Sista raden som börjar med `!` som visar att data delen är slut och sedan 2 bytes CRC för meddelandet.
4. Sista raden som börjar med `!` visar att datadelen är slut och sedan 2 bytes CRC för meddelandet.
CRC:n (Cyclic Redundancy Check) används för att verifiera att man mottagit meddelandet på ett korrekt sätt.
Alla bytes från `/` till `!` skall användas i beräkningen för CRC.
Alla bytes från `/` till `!` skall användas i beräkningen av CRC.


!!! example "CRC beräkning"
!!! example "CRC-beräkning"

````python
import libscrc
Expand Down Expand Up @@ -135,10 +135,10 @@ En datarad har formatet:

OBIS (OBject Identifier System) är en del av DLMS/COSEM och visar vilket värde dataraden gäller.

Formatet är `A-B:C.D.E.F` (ex: 1-0:1.8.0.255)
Formatet är `A-B:C.D.E.F` (ex: 1-0:1.8.0.255).

Varje del kan vara mellan 0-255. Del `F` är nästan alltid 255 (används ej) och i den
svenska branchstandarden skickas det inte med.
svenska branchstandarden skickas den inte med.

Värdegrupp | Beskrivning
--- | ---
Expand All @@ -151,14 +151,14 @@ F | Faktureringsperiod eller historisk data.

!!! example "Exempel OBIS"

1-0:1.8.0.255 -> El, Aktiv effekt förbrukning på alla faser, tidsintegral 1 (energi)
1-0:1.8.0.255 -> El, Aktiv effektförbrukning på alla faser, tidsintegral 1 (energi)

Så det anger hur mycket energi som konsumerats genom mätaren. (Mätarställning)
Det anger hur mycket energi som konsumerats genom mätaren (mätarställning).

### Värde och enhet

Värde och enhet är avdelat med `*`. Vissa värden har ingen enhet (till exempel tid och datum)
och då finns där inget * inom parenteserna.
Värde och enhet är separerade med `*`. Vissa värden har ingen enhet (till exempel tid och datum)
och då finns där ingen `*` inom parenteserna.


## Svenska branschrekommendationer
Expand All @@ -167,10 +167,10 @@ Energiföretagen har tagit fram en
[branschrekommendation](https://www.energiforetagen.se/forlag/elnat/branschrekommendation-for-lokalt-kundgranssnitt-for-elmatare/)
om hur HAN-porten borde fungera och vilken data som bör publiceras på HAN-porten.

!!! note "Lite förtydlingar"
!!! note "Några förtydliganden"

Med uttag menas uttag från elnätet. Det vill säga det du förbrukar. Med inmating
menas det du matar in i elnätet (till exampel om du har solceller)
Med uttag menas uttag från elnätet, det vill säga det du förbrukar. Med inmating
menas det du matar in i elnätet (till exampel om du har solceller).

Den sista delen i OBIS har tagits bort då den inte tillför någon information.

Expand Down
4 changes: 2 additions & 2 deletions docs/svenska/övriga-resurser.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Övriga Resurser
# Övriga resurser

Har du en källa du skulle vilja se här ber vi er öppna ett Pull-Request på Github. Om
Har du en källa du skulle vilja se här ber vi er öppna en Pull-Request på Github. Om
du inte kan, så öppna ett issue istället så försöker vi hjälpa dig.

## Kod för utläsning
Expand Down