Overslaan en naar hoofdcontent gaan

Zoeken

Diagnose & Inbedrijfname

Apps die de diagnostiek en het uitvoeren van projecten vergemakkelijken

Device Reader

Vassilios Lourdas
  • Bijgewerkt

Dit artikel behandelt de volgende onderwerpen:

Achtergrondinformatie

Deze app maakt meer diepgaande diagnostiek op apparaatniveau mogelijk. De uitgelezen gegevens kunnen ook worden opgeslagen, maar om deze gegevens te kunnen interpreteren, moet men over diepgaande kennis van het KNX-systeem beschikken.

Volgende basisfuncties worden aangeboden in deze ETS App:

  • Open apparaatgegevens (vanuit een bestand of het apparaat).
  • Apparaatgegevens opslaan in een bestand.

Activering

Volg deze instructies om de App te activeren:

Gebruik van de Device Reader app in ETS

  1. De app oproepen binnen een project  (Hoe een ETS-app starten)
  2. In het ETS App-venster is het mogelijk om op een tabblad te wisselen tussen de weergave 'Eigenschappen' en 'Geheugen'.

Eigenschappen weergave

Het tabblad 'Eigenschappen' heeft betrekking op apparaat-eigenschappen en geeft de mogelijkheid om apparaateigenschappen te lezen.

Het app-venster is verdeeld in twee delen. De objecten (inclusief het objectnummer) worden weergegeven in het linkerdeel (1) en de bijbehorende eigenschappen worden weergegeven in het rechterdeel (2).

DeviceReader_withIndexes.png

Kolom Eigenschap ID Type Waarde
Omschrijving Bevat de naam van de eigenschap in tekstvorm. Bevat de numerieke eigenschaps-ID. Geeft het type eigenschap aan. Eigenschapswaarde
Er is een titelregel die informatie bevat over de oorsprong van de gegevens (bv. 'Toont de eigenschappen van apparaat: 1.1.4' of 'Eigenschappen van C:/User/Admin/Desktop/taster.knxprop').
Zijbalk weergave

Extra eigenschappen worden ook opgeslagen in het eigenschapsvenster.Sidebar.png

Item Omschrijving
Index De opeenvolgende index van de eigenschappen ten opzichte van het geselecteerde object (0...n).
Type ID De ID van het eigenschapstype volgens KNX specificaties of een aangepaste definitie met behulp van een typebestand (zie hieronder) voor de Device Editor
Naam... De actuele (begrijpelijkere) naam van het type ID (in de zijbalk) of type (in het venster)
Type Tekst De naam in tekstvorm (standaard PID--xyz/xyz). Een aangepaste naam kan worden toegewezen in de Device Editor met behulp van Definitie en een typebestand (zie hieronder)
Identificatiecode Naam; identiek aan de eigenschap in het venster
Toegang Definieert de minimale lees- en schrijfrechten ("toegangsniveau") die nodig zijn voor een eigenschap. Afhankelijk van het apparaattype (maskerversie) kunnen er maximaal 16 (0 = hoogste ...15 = laagste) verschillende niveaus zijn die met een toegangssleutel kunnen worden geactiveerd. Voorwaarde hiervoor is dat de fabrikant op deze manier zelfs niveaus voor het apparaat heeft gedefinieerd met een sleutel voor een overeenkomstig niveau. Dit betekent dat een weergave van 3/2 niveau 3 vereist voor lezen en niveau 2 voor schrijven. Met andere woorden, om gegevens te schrijven, moet minimaal niveau 2 worden ingesteld met de standaardsleutel of met een fabrikantspecifieke sleutel. De functie Lezen/Schrijven kan gebruikt worden om een sleutel in te voeren.

Bewerken

  • Eigenschappen kunnen direct in het bijbehorende veld worden bewerkt (in-place bewerking), ofwel door te dubbelklikken op de betreffende cel (of met F2) of in de zijbalk (eigenschapsvenster).
  • Als de eigenschappen niet beschrijfbaar zijn, is bewerken niet mogelijk en een dubbelklik op de cel zal geen effect hebben.
  • Hele arrays kunnen worden bewerkt in een apart dialoogvenster, dat kan worden geopend door dubbel te klikken op de eigenschap.
  • Als een ongeldige waarde is ingevoerd, wordt de invoer genegeerd en de oorspronkelijke waarde opnieuw weergegeven.

Functies

DeviceReaderFunctions.png

Open vanaf een apparaat

Open vanuit bestand

 

Schrijf naar bestand

Geheugen weergave

Het tabblad 'Eigenschappen' heeft betrekking op het apparaatgeheugen.

 

 

 

Index: De opeenvolgende index van de eigenschappen ten opzichte van het geselecteerde object (0...n).
Type ID: De ID van het eigenschap type volgens KNX specificaties of een aangepaste definitie met behulp van een typebestand (zie hieronder) voor Device Editor
Naam...: De werkelijke (beter verstaanbare) naam van hetType-ID (in de zijbalk) of Type (in het venster)
Type tekst: De naam in tekstvorm (standaard PID--xyz/ xyz). Een aangepaste naam kan worden toegewezen in de Device Editor met behulp van Definitie en een typebestand (zie hieronder)
Identifier: Naam; identiek aan Eigenschap in het venster
Toegang: Definieert het minimum lees en schrijfrechten ("toegangsniveau"), nodig voor een eigenschap. Afhankelijk van het apparaattype (maskerversie) kunnen er maximaal 16 (0 = hoogste ...15 = laagste) verschillende niveaus zijn die met een toegangssleutel kunnen worden geactiveerd. Voorwaarde hiervoor is dat de fabrikant op deze manier zelfs niveaus voor het apparaat heeft gedefinieerd met een sleutel voor een overeenkomstig niveau. Dit betekent dat een weergave van 3/2 niveau 3 vereist voor lezen en niveau 2 voor schrijven. Met andere woorden, om gegevens te schrijven, moet minimaal niveau 2 worden ingesteld met de standaardsleutel of met een fabrikantspecifieke sleutel. De functie Lezen/Schrijven kan gebruikt worden om een sleutel in te voeren.

 

Functies

Eigenschap - Lees van een apparaat

Het dialoogvenster voor het uitlezen van apparaateigenschappen maakt de volgende invoer mogelijk:

•Apparaat/ Fysiek Adres; vooraf gedefinieerd met het adres van het apparaat dat laatst is geselecteerd in ETS (of het adres van het apparaat waartoe het laatste geselecteerde element behoort).

•Apparaat/Toegangssleutel (ook wel toegangssleutel in KNX genoemd); voor de procedure, zie Opmerking

•Leesmodus; volledig/gedeeltelijk geeft aan of de eigenschappen volledig (tijdsfactor) of slechts beetje bij beetje moeten worden gelezen wanneer het object in het linkervenster wordt geselecteerd.

Terwijl de eigenschappen van het apparaat worden gelezen, verschijnt een modulair dialoogvenster "Even geduld aub". De bewerking die wordt uitgevoerd kan worden geannuleerd via dit dialoogvenster. In dit geval worden alle tot nu toe geladen gegevens verwijderd. Geen van de tot nu toe geladen gegevens wordt weergegeven.

Opmerking

Array-eigenschappen met een grootte van meer dan 64 bytes worden alleen "op vraag" geladen tijdens bewerken (zie boven) van de eigenschap (verhoogt de snelheid van weergave).
Eigenschappen - Lezen van bestand

Als eigenschappen uit een bestand moeten worden gelezen, verschijnt eerst een dialoogvenster "Bestand openen", waarin alleen *.knxprop-bestanden kunnen worden geselecteerd. Wanneer een bestand wordt geopend, worden alle eerder weergegeven gegevens verwijderd.
Eigenschappen – Schrijf naar bestand

Zoals het geval is voor het lezen van een bestand, staat het dialoogvenster "Open bestand" alleen toe om *.knxprop bestanden te selecteren. Als het gekozen bestand al bestaat, wordt er een bevestiging gevraagd voor het overschrijven van het bestand.

Opmerking

Als je te maken hebt met een array-eigenschap die groter is dan 64 bytes en nog niet "op aanvraag" is geladen, wordt de eigenschap als een leeg veld opgeslagen. Er worden geen nog ongelezen velden achteraf geladen.
Gedrag bij tegenstrijdigheden tussen de apparaatinformatie en de KNX administratieve gegevens (stamgegevens)

Wanneer de eigenschappen van een apparaat worden uitgelezen, wordt informatie over het type of het aantal elementen van de eigenschap voor elke eigenschap online voor het apparaat bepaald. Het kan gebeuren dat deze informatie niet overeenkomt met de beschrijving van de eigenschap in de KNX stamgegevens .

De stamgegevens kunnen bijvoorbeeld aangeven dat een eigenschap een enkele waarde is van het type INTEGER, terwijl de online informatie aangeeft dat het een INTEGER is met negen (9) waarden, d.w.z. een array. Of dat een eigenschap beschrijfbaar is volgens de KNX stamgegevens, terwijl de "online" informatie het tegendeel beweert.

•In deze gevallen heeft de informatie uit de KNX-stamgegevens altijd prioriteit.

•Dit soort tegenstrijdigheid wordt aangegeven door het type dat wordt weergegeven in oranje kleur.

Met deze weergave kunt u een geheugengebied van een apparaat bewerken; de structuur is vergelijkbaar met die van gewone hex-editors.

Beeldscherm

De breedte van het display is vastgesteld op 16 bytes en is niet variabel. De basisadressen (hexadecimale vorm) staan in de linkerkolom; rechts in de kop staan de 16 verschillende geheugenlocaties (hexadecimale vorm).

Bewerken

Gewijzigde bytes worden in het rood weergegeven, terwijl alleen-lezen bytes grijs worden weergegeven. De invoer gebeurt in hexadecimale vorm.

Functies

Geheugen – Lezen vanaf een apparaat

Het dialoogvenster voor het uitlezen van apparaateigenschappen maakt de volgende invoer mogelijk:

•Apparaat/ Fysiek Adres; vooraf gedefinieerd met het adres van het apparaat dat laatst is geselecteerd in ETS (of het adres van het apparaat waartoe het laatste geselecteerde element behoort).

•Apparaat/Toegangssleutel (ook wel toegangssleutel in KNX genoemd); voor de procedure, zie Opmerking

•Bereik; van ... tot ; standaard = 0x0100.. 0x010F

•Adresruimte; default = Standaardgeheugen, andere zijn Gebruikersgeheugen, Lijnkoppelaar-slave, Lijnkoppelaar-routingtabel)
Geheugen – Lezen van bestand

In het dialoogvenster voor het openen van *.sxx bestanden kunnen formaten *.s19; *.s28 en *.s37 worden geselecteerd.

Na het selecteren van een bestand wordt de volledige inhoud van het bestand weergegeven in de editor. Als het formaat van het bestand onjuist is of het bestand niet volledig kan worden gelezen, verschijnt er een overeenkomstig bericht en wordt het proces beëindigd.
Geheugen – Schrijven naar bestand

Schrijven naar *.sxx bestanden kan alleen worden gedaan in de hierboven genoemde bestandsindelingen. Als het doelbestand al bestaat, wordt u gevraagd of het bestand moet worden overschreven. Als geheugeninformatie uit een bestand wordt gelezen, bewerkt en teruggeschreven naar het bestand, gaan eventuele laadprocedures in dit bestand daarbij niet verloren.

Naast de Device Reader is er ook de Device Editor, die naast verdere functies ook schrijftoegang/gegevensoverdracht naar apparaten biedt. De volgende tabel vermeldt de verschillen (R = leestoegang, W = schrijftoegang).

ETS App

Apparaateigenschappen

Apparaatgeheugen

*.sxx bestanden

*.knxprop bestanden

Device Reader

R

R

R / W

R / W

Device Editor

R / W

R / W

R / W

R / W

Welke geheugengebieden zelfs lees-/schrijftoegang toestaan, hangt af van het betreffende apparaatmodel (maskerversie). Schrijfrechten (W) zijn onderhevig aan een toegangscodering; een (geheugen) bron kan niet worden geschreven als de (Write) toegangsrechten het volgende bevatten:

•<AccessRights Read="xyz" Write="None"/>

•<AccessRights Read="xyz" Write="Manufacturer"/>

De gegevens worden allemaal opgeslagen in de ETS administratieve gegevens (stamgegevens).

Extra functies

Geheugen – Overzetten naar apparaat

Bij het overzetten van een geheugengebied naar een apparaat, verschijnt er een dialoogvenster met de volgende opties:

•Apparaat/ Fysiek Adres; vooraf gedefinieerd met het adres van het apparaat dat laatst is geselecteerd in ETS (of het adres van het apparaat waartoe het laatste geselecteerde element behoort).

•Apparaat/Toegangssleutel (ook wel toegangssleutel in KNX genoemd); voor de procedure, zie Opmerking

•Write Mode; volledig/gedeeltelijk geeft aan of het geheugen volledig overschreven moet worden, of alleen de aangepaste bytes gemarkeerd in rood.

Als het opgegeven geheugengebied groter is dan het aantal ingelezen bytes, verschijnt er een foutmelding.
Eigenschappen – Overzetten naar apparaat

De volgende dialoogopties zijn beschikbaar:

•Apparaat/ Fysiek Adres; vooraf gedefinieerd met het adres van het apparaat dat laatst is geselecteerd in ETS (of het adres van het apparaat waartoe het laatste geselecteerde element behoort).

•Apparaat/Toegangssleutel (ook toegangssleutel genoemd in KNX); vooraf gedefinieerd met behulp van een ETS-projectsleutel die mogelijk kan bestaan

In tegenstelling tot de geheugenmodus (zie boven) worden in dit geval alleen de wijzigingen die momenteel zijn aangebracht naar het apparaat overgedragen. De mogelijkheid om alles (opnieuw) over te zetten is zeer tijdrovend en niet geheel veilig (voor zogenaamde Stateless Function Properties).
Gebruiker gedefinieerd Laden Type Data

Met de functie Load Type Data kunnen gebruikers hun eigen typegegevens laden om de aanduidingen van eigenschapstypen weer te geven die bijvoorbeeld nog niet in de KNX-stamgegevens voorkomen. Als hier een poging wordt gedaan om een reeds bestaande ID te overschrijven, zal er een foutmelding verschijnen.

•Wanneer door de gebruiker gedefinieerde gegevens worden geladen, worden eerst de bekende gegevenstypen teruggezet naar de status van de KNX-stamgegevens en vervolgens worden de geselecteerde gegevens ingelezen. Alle eerder geladen gebruikersgegevens worden in dit proces verwijderd. Dit betekent dat het niet mogelijk is om meerdere door de gebruiker gedefinieerde gegevensbestanden na elkaar te laden.

•Om de KNX-stamgegevens in de oorspronkelijke staat terug te zetten, moet een typegegevensbestand worden ingelezen dat alleen een leeg element bevat (<PropertyIdentifiers />).

•Het formaat van het type bestand wordt hieronder beschreven.

KNX ETS Apps hebben drie (3) bestandsformaten waarmee ze kunnen werken en opslaan. Deze worden hieronder beschreven:

•Property Files (*.knxprop);     Opslaan (lezen) data in bestanden

• Save Files (*.sxx);                 Opslaan (lezen) geheugeninhoud in bestanden

•Type Files (*.xml); Definieert de interpretatie van (mogelijk onbekende) eigenschapstypes

Eigenschap File format

Het formaat is XML gebaseerd en beschrijft de objecten en bijbehorende eigenschappen evenals hun waarden. Elk object is hier geïdentificeerd door twee beschrijvende items:

TypeId Een ID van de KNX stamgegevens
Index Index van het object in het apparaat

De volgende informatie van eigenschappen is opgeslagen:

Id PropertyTypeId van de KNX stamgegevens; indien niet beschikbaar, alleen een numerieke waarde
Toegang Byte
Beschrijfbaar Boolean
TypeId Naam van de PropertyIdentifier
ElementCount Voor arrays > 1, anders 1
Index Index van de eigenschap op het object
Waarde Formateerbare waarde

Opmaak van waarden

Behalve arrays wordt elk eigenschapstype opgesplitst in individuele bytes en wordt op deze manier opgeslagen. waarbij de bytes gescheiden worden door een "-".

Bij wijze van voorbeeld is hier de waarde van een eigenschap van het type PDT_GENERIC_10:

Waarde="16-75-C1-04-41-81-45-20-02-00"

Opmaak van arrays

De afzonderlijke elementen van de array worden opgesplitst in bytes op dezelfde manier als niet-array waarden. De individuele waarden worden gescheiden door een komma in de array. Opgeslagen arrays worden tussen accolades geplaatst. Als voorbeeld is hier een eigenschap van het type PDT_GENERIC_01 met 12 elementen:

Waarde="{ 31,34,3A, 3A, 30,3A, 30,3A, 30,34,00,00,00,00 }"

voorbeeld

Hier is een compleetVoorbeeld om de opmaak verder te verduidelijken. Zoals te zien is, worden ook objecten opgeslagen waarvoor nog geen eigenschappen zijn ingelezen.

<?xml VERSION="1.0"?>
<Objects>
  <Object TypeID="OT-0" Index="0">
    <Properties>
      <Property Id="PID--1" Access="0" Writable="false" 
                TypeId="PDT_UNSIGNED_INT" ElementCount="1" Index="0" Value="00-00" />
      <Property Id="PID--9" Access="0" Writable="false" 
                TypeId="PDT_UNSIGNED_CHAR" ElementCount="1" Index="1" Value="01" />
      <Property Id="PID--11" Access="0" Writable="false" 
                TypeId="PDT_GENERIC_06" ElementCount="1" Index="2" 
                Value="00-01-00-1F-72-F4" />
      <Property Id="PID--12" Access="0" Writable="false" 
                TypeId="PDT_UNSIGNED_INT" ElementCount="1" Index="3" Value="00-01" />
      <Property Id="PID--14" Access="0" Writable="true" 
                TypeId="PDT_GENERIC_01" ElementCount="1" Index="4" Value="00" />
      <Property Id="PID--15" Access="0" Writable="false" 
                TypeId="PDT_GENERIC_10" ElementCount="1" Index="5" 
                Value="16-75-C1-04-41-81-45-20-02-00" />
      <Property Id="207" Access="0" Writable="false" 
                TypeId="PDT_GENERIC_04" ElementCount="1024" Index="20" Value="{  }" />
      <Property Id="208" Access="0" Writable="true"
                TypeId="PDT_FUNCTION" ElementCount="1" Index="21" />
      <Property Id="209" Access="0" Writable="true" 
                TypeId="PDT_FUNCTION" ElementCount="1" Index="22" />
      <Property Id="211" Access="0" Writable="false" 
                TypeId="PDT_GENERIC_01" ElementCount="12" Index="23" 
                Value="{ 31,34,3A,34,30,3A,30,34,00,00,00,00 }" />
      <Property Id="247" Access="0" Writable="false" 
                TypeId="PDT_VERSION" ElementCount="1" Index="24" Value="40-00" />
    </Properties>
  </Object>
  <Object TypeId="OT-6" Index="1">
    <Properties />
  </Object>
  <Object TypeId="OT-7" Index="2">
    <Properties />
  </Object>
</Objects>
Geheugen Bestandsformaat

Het gebruik van alle *.sxx-formaten in ETS is historisch gegroeid. Het zijn binaire gegevensformaten die door Motorola zijn gedefinieerd. Een precieze formaatdefinitie is te vinden op het internet. Het algemene principe is altijd RECORD-TYPE COUNT ADRES DATA CHECK-SUM.
Type bestandsformaat

Het bestandsformaat van de type databestand komt overeen met het formaat van de corresponderende elementen in de KNX administratieve gegevens (stamgegevens). Alle elementen van het type Property Identifier staan tussen hoekhaken <PropertyIdentifiers> en bevatten de volgende informatie als XML-attributen:

Id Property ID (platte tekst in Property properties)
Nummer Property ID (numeriek)
Naam Property Naam
Tekst Property Name (platte tekst in de Property kolom)
PDT Property Type ID (specifieert het type het bitformaat)
ObjectType ObjectType ID; geeft aan voor welke objecttypes deze Property Identifier geldig is. Als deze waarde niet is ingesteld, is de Property Identifier geldig voor alle Object Types.

voorbeeld

Hier is een compleet Voorbeeld om het formaat verder te verduidelijken.

<PropertyIdentifiers>
      <PropertyIdentifier Id="PID--208" Number="208" Name="PID_CUSTOM_STATE" 
                          Text="Custom State" PDT="PDT-4"  />
      <PropertyIdentifier Id="PID--212" Number="212" Name="PID_SUPPORT_FLAG" 
                          Text="Support Flag" PDT="PDT-3"  />
      <PropertyIdentifier Id="PID--215" Number="215" ObjectType="OT-11"
                          Name="PID_CHANNEL_MODE" Text="Channel Mode" PDT="PDT-3"  />
</PropertyIdentifiers>

Opmerkingen

•De toegangssleutel is vooraf gedefinieerd met behulp van een sleutel van het ETS-project die mogelijk al bestaat; anders wordt de standaardsleutel (0xFFFFFFFFFFFF) gebruikt. ETS probeert op basis van deze twee sleutels het niveau "hogere waarde" te gebruiken.

▪Projectsleutel bestaat; Niveau van de winnende projectsleutel <> standaard sleutel; Als de eerste query met de standaardsleutel direct het maximale niveau (= 0) bereikt, kan de tweede query worden weggelaten.

▪Er is geen projectsleutel; Het niveau van de standaardsleutel wordt gebruikt.

•Deze KNX ETS App kan meer dan één keer worden opgeroepen in ETS (zie Call Types voor ETS Apps).

Verwante artikelen

Niet gevonden wat u zocht?
Een aanvraag indienen Community