# Konfiguratio av fil för radiolokaliserare

För att lagra en punkt på den uppmätta höjden för en underjordisk tillgång måste jobbet använda en FXL-fil med ett funktionsbibliotek som innehåller en kod med minst ett nummer- eller textattribut som överensstämmer med namnet på ett av de attribut som har definierats i ULD-filen. Om du ansluter FXL-filen till ULD-filen på detta sätt visas värdet för Djup på skärmen Mätning när mätinformation tas emot från den underjordiska lokaliseraren.

Lägg till ytterligare attribut till koden i FXL-filen för att lagra annan attributinformation som tas emot från radiolokaliseraren som du vill lagra med punkten, till exempel frekvens, förstärkning, fas, ström och signal.

Dessutom innehåller ULD-filen exempel och tips för att sammankoppla och använda den lokaliseraren.

ULD-filer för mallar

Använd lämplig ULD-fil som finns i mappen Trimble Data\System Files på kontrollenheten.

Eller, ladda ner ULD-filen från sidan Mallfiler i Hjälpportal för Trimble Access.

ULD-filens uppbyggnad

Formatet för varje ULD-fil som medföljer Trimble Access visas nedan och i följande tabell beskrivs respektive parameter.

Strukturen för filen RD8100.uld är:

<?xml version="1.0" encoding="UTF-8"?>
<ExternalDeviceProtocol version="1.0" >
<Device name="Radiodetection RD8100 & RD8200" >
<Protocol type="Delimited" delimiter="2C" startsWith="$RD8" >
<Field name="Depth" fieldNumber="8" type="Number" multiplier="1.0" attribute="Depth" />
<Field name="Frequency" fieldNumber="5" type="Number" multiplier="1.0" attribute="Frequency" />
<Field name="Gain" fieldNumber="13" type="Number" multiplier="1.0" attribute="Gain" />
<Field name="Phase" fieldNumber="11" type="Number" multiplier="1.0" attribute="Phase" />
<Field name=Current" fieldNumber="10" type="Number" multiplier="1.0" attribute="Current" />
<Field name="Signal" fieldNumber="12" type="Number" multiplier="1.0" attribute="Signal" />
</Protocol>
</Device>
</ExternalDeviceProtocol>

Strukturen för filen vLoc3.uld är:

<?xml version="1.0" encoding="UTF-8"?>
<ExternalDeviceProtocol version="1.0" >
<Device name="Vivax vLoc3" >
<Protocol type="Delimited" delimiter="2C" startsWith="LOG" >
<Field name="Depth" fieldNumber="5" type="Number" multiplier="0.001" attribute="Depth"/>
<Field name="Frequency" fieldNumber="4" type="Number" multiplier="1.0" attribute="Frequency"/>
<Field name="Gain" fieldNumber="9" type="Number" multiplier="1.0" attribute="Gain"/>
<Field name="Current" fieldNumber="6" type="Number" multiplier="1.0" attribute="Current"/>
</Protocol>
</Device>
</ExternalDeviceProtocol>

Parameter | Noteringar
--- | ---
Protokoll |
type="Delimited" or "FixedWidth" | Anger om ULD-informationen matas ut som en datasträng avgränsad med ASCII-tecken, t.ex. blanksteg eller komma (avgränsad), eller om respektive fält har ett fast antal tecken (fast bredd).
delimiter="2C" | Anger avgränsningen med två hexadecimala siffror vilket specificerar det avgränsade ASCII‑tecknet (fältseparator). Till exempel, blanksteg="20", komma="2C", tab="09".
startsWith="" | En valfri sträng kan användas för att ange den text som identifierar inledningen av en rad. Strängarna kan lämnas blanka. Strängarna trimmas med XML på inledande, avslutande eller dubbla blanksteg. Använd ("_") som ersättning för blankstegstecken. Till exempel startsWith="_A".
Fält |
name="" | Anger namnet på informationen i fältet. Redigera inte det här namnet. Redigera attributets namn i slutet av raden, för att ändra det attributnamn som lagras med punkten.
fieldNumber="" | Anger antalet fält i den datasträng som innehåller fältets information. Ange fieldNumber som ett decimaltal som börjar på 0. Till exempel fieldNumber="1".
type="Number" eller "Text" | Anger datatypen i fältet. Om typen i ULD-filen inte överensstämmer med typen i FXL-filen, konverterar Trimble Access automatiskt attributets typ som tas emot från ULD-filen så att den överensstämmer med den attributtyp som anges i FXL-filen.
multiplier="" | Vanligtvis kan du lämna multiplikatorn inställd på "1.0" eftersom du har ställt in radiolokaliseraren så att den använder samma måttenheter som anges i Trimble Access-jobbet. Om radiolokaliseraren av någon anledning använder olika enheter, anger du lämpligt multiplikatorvärde för att konvertera mätvärdet från lokaliseringsenheterna till de enheter som används i jobbet.
attribute ="" | Namnet på attributet som lagras med punkten i Trimble Access. Du kan ändra namnet om du vill, till exempel för att översätta namnet till önskat språk. Kontrollera att attributets namn för attributet i FXL-filen överensstämmer med attributets namn.

De medföljande ULD-filerna är särskilt utformade för att fungera med lokaliseraren Radio Detection RD8100 eller mottagaren Vivax Metrotech vLoc3-Pro . Du kanske kan använda programmet Trimble Access med en annan modell av radiolokaliserare, förutsatt att kommunikationsprotokollen liknar de protokoll som stöds av RD8100 eller vLoc3-Pro. Du måste ta reda på formatet för din radiolokaliserare och ändra en av de medföljande ULD-filerna för att uppfylla dina krav. Radiolokaliseraren:

- måste tillhandahålla en enda NMEA-sträng för mätning i stället för en NMEA-ström som innehåller flera mätningar.

- måste anslutas via Bluetooth.

Redigering av ULD-filen

Öppna ULD-filen i ett textredigeringsprogram för ASCII, som t.ex. Notepad++, om du vill redigera ULD-filen.

Om du redigerar namnet på ett attribut (texten efter attribute=), för att exempelvis översätta det till önskat språk, kontrollerar du att attributets namn som tilldelats i FXL-filen överensstämmer med det nya namnet.

Attributnamn är skiftlägeskänsliga, så se till att skiftläget som används för respektive attributnamn i ULD-filen överensstämmer med det skiftläge som används i FXL-filen.

Vanligtvis kan du lämna multiplikatorn inställd på "1.0" eftersom du har ställt in radiolokaliseraren så att den använder samma måttenheter som anges i Trimble Access-jobbet. Om radiolokaliseraren använder andra enheter än de som används i Trimble Access-jobbet anger du lämpligt multiplikatorvärde för att konvertera mätvärdet från lokaliseringsenheterna till de enheter som används i jobbet.

Konfiguration av FXL-filen för ULD-attribut

Du kan ställa in FXL-filen med hjälp av Feature Definition Manager in Trimble Business Center. Skapa en funktionskod för varje tillgångstyp som du vill hitta och lägg till attribut för vart och ett av de attributvärden som tas emot från radiolokaliseraren som du vill lagra med funktionskoden för den tillgången.

Ta som exempel, funktionskoden UtilityLocator i exempelfunktionsbiblioteksfilen GlobalFeatures.fxl som du kan installera med programmet Trimble Access via Trimble Installation Manager. Se Exempel på funktionsbibliotek för installation. Du kan även hämta exempelfunktionsbiblioteksfilen GlobalFeatures.fxl från sidan Mallfiler i Hjälpportal för Trimble Access.

Du måste skapa din egen FXL-fil och ställa in funktionskoder och attribut efter behov. Du kan exempelvis skapa en funktionskod ELC med ett nummerattribut med namnet "Djup" för att matcha raden i ULD-filen där attribute="Depth":

> <Field name="Djup" fieldNumber="1" type="Number" multiplier="1.0" attribute="Depth"/>

Lägg till extra attribut i koden i FXL-filen, efter behov, för att registrera mer än bara djup. Du kan exempelvis lägga till Frekvens och Förstärkning genom att hänvisa till lämpliga rader i ULD-filen:

> <Field name="Djup" fieldNumber="1" type="Number" multiplier="1.0" attribute="Frequency"/>

> <Field name="Djup" fieldNumber="1" type="Number" multiplier="1.0" attribute="Gain"/>

Överför FXL-filen till mappen Trimble Access på kontrollenheten, för att använda FXL-filen i System Files.