Yleisimmät Modbus RTU -virheet laitedokumentaatiossa

Monet Modbus-ongelmat eivät johdu itse protokollasta. Ne johtuvat epäselvistä manuaaleista.

Jos laitteen dokumentaatiosta puuttuu tärkeitä tietoja, integraattorin täytyy arvata. Se tarkoittaa yleensä viivästyksiä, tukipyyntöjä ja vääriä arvoja.

1. Osoitemuoto on epäselvä

Yksi yleisimmistä virheistä on sekoittaa raa’at offsetit ja numerot kuten 40001 ilman selitystä.

Lukijan täytyy tietää täsmälleen, mitä asiakasohjelmaan pitää syöttää.

2. Rekisterityyppiä ei kerrota selvästi

Jos dokumentaatio ei kerro, onko arvo holding registerissä vai input registerissä, käyttäjä voi lähettää väärän pyynnön.

3. Datatyyppi puuttuu

Arvosta ei ole hyötyä, jos käyttäjä ei tiedä onko se:

• signed vai unsigned
• 16-bittinen vai 32-bittinen
• integer vai float

4. Skaalaus puuttuu

Jos manuaali näyttää arvon mutta ei kerro skaalausta, käyttäjä ei tiedä tarkoittaako 215 arvoa 215, 21.5 vai 2.15.

5. Tavujärjestystä ja sanajärjestystä ei kerrota

Tämä on yleinen ongelma 32-bittisissä arvoissa ja liukuluvuissa. Jos dokumentaatio ei kerro järjestystä, käyttäjä voi lukea oikeat rekisterit mutta silti saada väärän arvon.

6. Luku/kirjoitus-oikeus on epäselvä

Jos manuaali ei kerro selvästi onko rekisteri vain luku vai kirjoitettava, käyttäjä voi yrittää kirjoitusta joka epäonnistuu.

7. Sarja-asetusten oletusarvot puuttuvat

Manuaalissa pitäisi kertoa oletus baud rate, parity, stop bits ja slave ID:n asetus. Ilman näitä käyttäjä ei välttämättä saa edes perusyhteyttä toimimaan.

8. Tuettuja function codeja ei listata

Älä oleta, että kaikki yleiset function codet ovat tuettuja. Kerro mitkä niistä laite tukee.

9. Esimerkkejä ei ole mukana

Lyhyt pyyntö- ja vastausesimerkki auttaa käyttäjää varmistamaan, että yhteys toimii ja osoitemuoto on oikein.

10. Vika- ja poikkeuskäytöstä ei kerrota

Jos laite palauttaa poikkeuskoodeja tai erityisiä arvoja vikatilanteissa, dokumentoi se selvästi.

Lopuksi

Modbus-manuaalin pitäisi vastata peruskysymyksiin ennen kuin käyttäjän tarvitsee ottaa tukeen yhteyttä. Jos dokumentaatio jättää arvailun varaa, moni käyttäjä jää jumiin.

Konsultointi

Minut voi palkata auttamaan Modbus-laitteiden dokumentoinnissa, testauksessa ja vianetsinnässä.