Rekisterikartan tarkistuslista valmistajille
Rekisterikartan pitäisi olla helppo lukea ja vaikea ymmärtää väärin. Jos dokumentaatio on epäselvä, integraattori joutuu arvaamaan. Se johtaa tukipyyntöihin, epäonnistuneisiin projekteihin ja tyytymättömiin asiakkaisiin.
Käytä tätä tarkistuslistaa ennen laitteen julkaisua.
Rekisterikartan tarkistuslista
Varmista jokaisen rekisterin tai datapisteen kohdalla, että dokumentaatio kertoo selvästi:
- rekisteriosoitteen
- rekisterityypin
- arvon nimen
- datatyypin
- yksikön
- skaalauksen
- onko arvo signed vai unsigned
- luku/kirjoitus-oikeuden
- sallitun alueen
- oletusarvon tarvittaessa
- tavujärjestyksen jos arvo on usean tavun mittainen
- sanajärjestyksen jos arvo vie useamman rekisterin
- mahdolliset erikoistilat tai vikaarvot
Tarkista osoitemuoto
Kerro selvästi, ovatko osoitteet raakoja offsetteja vai numeroita kuten 40001. Älä oleta, että käyttäjä tietää tämän. Tämä on yksi yleisimmistä virhelähteistä.
Tarkista rekisterityyppi
Tee selväksi, onko arvo:
- coil
- discrete input
- input register
- holding register
Älä jätä tätä lukijan arvattavaksi.
Tarkista datatyyppi
Kerro selvästi, onko arvo:
- 16-bittinen unsigned integer
- 16-bittinen signed integer
- 32-bittinen integer
- float
- bittikenttä
Tämä pitää kirjoittaa selvästi.
Tarkista skaalaus ja yksiköt
Jos raakaarvo tarvitsee skaalauksen, kerro täsmälleen miten se toimii.
Esimerkki:
- raakaarvo 253 = 25.3 °C
- jaa 10:llä
Kerro myös yksikkö jokaiselle mitatulle arvolle. Lämpötila voi olla Fahrenheit, kelvin tai celsius ja se vaikuttaa paljon lopputulokseen.
Tarkista usean rekisterin arvot
Jos arvo käyttää useampaa kuin yhtä rekisteriä, kerro miten rekisterit yhdistetään. Ilmoita tavujärjestys ja sanajärjestys selvästi.
Tarkista kirjoituskäytös
Jos arvoon voi kirjoittaa, dokumentoi:
- sallittu alue
- sallitut arvot
- mitä tapahtuu jos arvo on alueen ulkopuolella
- tuleeko muutos voimaan heti vai vasta uudelleenkäynnistyksen jälkeen
Tarkista poikkeuskäytös
Jos pyyntöä ei tueta, kerro mitä tapahtuu. Jos laite palauttaa Modbus-poikkeuskoodeja, dokumentoi ne.
Tarkista esimerkit
Lisää vähintään yksi oikea esimerkki. Yksinkertainen pyyntö- ja vastausesimerkki säästää käyttäjältä paljon aikaa.
Lopuksi
Hyvä rekisterikartta vähentää tukityötä. Huono rekisterikartta aiheuttaa sekaannusta, vaikka laite itse toimisi oikein.
Konsultointi
Minut voi palkata auttamaan Modbus-laitteiden dokumentoinnissa, testauksessa ja vianetsinnässä.