Académique Documents
Professionnel Documents
Culture Documents
EDIABAS
Elektronik Diagnose Basissystem
BEST/2 FUNKTIONSREFERENZ
Version 6f
BEST2RTL.DOC
EDIABAS — BEST/2 FUNKTIONSREFERENZ
INHALT
INHALT
INHALT .........................................................................................................................2
1. Änderungshistorie...................................................................................................8
2. Einführung ...........................................................................................................9
2.1. Über die Laufzeitbibliothek .............................................................................9
2.2. Konventionen .................................................................................................9
2.3. Besonderheiten, Begriffe, Akronyme..............................................................10
3. Überblick ..................................................................................................................11
3.1. Benutzung der Laufzeitbibliothek ...................................................................11
3.1.1. Aufrufen von Bibliotheksfunktionen.....................................................11
3.1.2. Pfade und Dateinamen .......................................................................11
3.2. Funktionen der Laufzeitbibliothek nach Kategorien........................................12
3.2.1. Kommunikationsfunktionen.................................................................13
3.2.2. Interfacefunktionen .............................................................................14
3.2.3. Ergebnis- und Parameterverwaltung ..................................................15
3.2.4. Stringfunktionen..................................................................................16
3.2.5. Wandlungsfunktionen .........................................................................17
3.2.6. Realfunktionen....................................................................................18
3.2.7. Datafunktionen....................................................................................19
3.2.8. Dateifunktionen...................................................................................20
3.2.9. Ablaufsteuerung..................................................................................21
3.2.10. Fehlerbehandlung .............................................................................21
3.2.11. Zeitbehandlung .................................................................................22
3.2.12. Tabellenbehandlung .........................................................................23
3.2.13. Konfiguration.....................................................................................24
3.2.14. Steuergerätespezifische Funktionen.................................................25
5. Bibliotheksfunktionen ........................................................................................29
2
EDIABAS — BEST/2 FUNKTIONSREFERENZ
INHALT
3
EDIABAS — BEST/2 FUNKTIONSREFERENZ
INHALT
fseek .....................................................................................................................63
fseekln...................................................................................................................64
ftell ........................................................................................................................65
ftellln......................................................................................................................66
get_battery_voltage...............................................................................................67
get_error ...............................................................................................................68
get_error2 .............................................................................................................70
get_ignition_voltage ..............................................................................................71
get_token ..............................................................................................................72
get_trap_mask ......................................................................................................73
generateRunError .................................................................................................74
getasciidate ...........................................................................................................75
getasciitime ...........................................................................................................76
getCfgInt ...............................................................................................................77
getCfgString ..........................................................................................................78
getdate ..................................................................................................................79
getETXblock..........................................................................................................80
GetKWP2000Block ...............................................................................................81
gettickcount ...........................................................................................................83
gettime ..................................................................................................................84
hex2ascii ...............................................................................................................85
ifboot .....................................................................................................................86
ifgetport .................................................................................................................87
ifinfo ......................................................................................................................88
ifinfoExt .................................................................................................................89
ifloopt ....................................................................................................................90
ifrawmode .............................................................................................................91
ifrecv .....................................................................................................................92
ifrequeststate.........................................................................................................93
ifreset ....................................................................................................................94
ifsend ....................................................................................................................95
4
EDIABAS — BEST/2 FUNKTIONSREFERENZ
INHALT
ifsetport .................................................................................................................96
ifsireset..................................................................................................................97
iftype .....................................................................................................................98
ifvers .....................................................................................................................99
incProgressPos .....................................................................................................100
isDebugLevel ........................................................................................................101
isSimulation...........................................................................................................102
itoad ......................................................................................................................103
itoax ......................................................................................................................104
itor .........................................................................................................................105
make_error............................................................................................................106
new_set_of_results ...............................................................................................107
open_communication ............................................................................................108
parcount ................................................................................................................109
real_to_data ..........................................................................................................110
realadd ..................................................................................................................111
realcomp ...............................................................................................................112
realdiv ...................................................................................................................113
realmul ..................................................................................................................114
realresult ...............................................................................................................115
realsub ..................................................................................................................116
recv_frequent ........................................................................................................117
recv_keybytes .......................................................................................................118
rtoa........................................................................................................................119
rtoi .........................................................................................................................120
send_and_receive.................................................................................................121
send_frequent .......................................................................................................122
set_answer_length ................................................................................................123
set_communication_pars ......................................................................................126
set_program_voltage ............................................................................................153
set_repeat_counter ...............................................................................................154
5
EDIABAS — BEST/2 FUNKTIONSREFERENZ
INHALT
set_trap_mask.......................................................................................................155
set_variable_result ................................................................................................158
setProgressRange ................................................................................................159
shdataget ..............................................................................................................160
shdataset ..............................................................................................................161
stop_frequent ........................................................................................................162
strcat .....................................................................................................................163
strcmp ...................................................................................................................164
strcpy ....................................................................................................................165
strcut .....................................................................................................................166
strerase .................................................................................................................167
strinsert .................................................................................................................168
strlen .....................................................................................................................169
strncpy ..................................................................................................................170
strrevers ................................................................................................................171
tab2fix ...................................................................................................................172
tab_suche_index ...................................................................................................173
tab_suche_unsigned .............................................................................................174
tabget ....................................................................................................................176
tabline ...................................................................................................................177
tabseek .................................................................................................................178
tabset ....................................................................................................................179
tabsetext ...............................................................................................................180
uitoad ....................................................................................................................181
updateInfo .............................................................................................................182
userbreak ..............................................................................................................183
var_result_data .....................................................................................................184
var_result_long......................................................................................................185
var_result_real ......................................................................................................186
var_result_string....................................................................................................187
wait........................................................................................................................188
6
EDIABAS — BEST/2 FUNKTIONSREFERENZ
INHALT
waitex....................................................................................................................189
LITERATURVERZEICHNIS ..........................................................................................190
INDEX............................................................................................................................191
7
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Änderungshistorie
1.Änderungshistorie
Version 5b Einführung der Änderungshistorie
Neu Kapitel 3 (Kapitel 3 ist jetzt Kapitel 4 usw.)
Version 5e Neue Funktionen rtoi, updateInfo, setProgressRange,
incProgressRange
Version 5f Neue Funktionen ascii2ascii
Version 6 Neue Funktionen data_to_real, real_to_data, tab_suche_unsigned,
ifinfoExt, realcomp, AdjustKWP2000TesterPr-StartComm,
GetKWP2000Block, GetKWP2000BlockIndex, linkPlugIn, callPlugIn,
callPlugInExt, set_communication_pars
Version 6a Beschreibung zu GetKWP2000Block überarbeitet, Funktion
GetKWP2000BlockIndex entfällt.
Version 6b In set_communication_pars Konzept KWP 2000* neu.
Version 6c Neue Funktion tabsetext.
Version 6d Überarbeitung für EDIABAS V6.4.0
Version 6e Korrektur von get_error2
Version 6f Neue Funktion enableClampHandling, Korrektur von waitex
8
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Einführung
2. Einführung
Diese Laufzeitbibliothek ist sehr wichtig, da sie Funktionalität zur Verfügung stellt, die
der rudimentären BEST/2 Sprache fehlen.
Alle Funktionen sind in BEST/1 erstellt worden, um Performanceeinbußen zu
vermeiden!
2.2. Konventionen
Beispiel Beschreibung
SAMPLE.B2V Großschrift kennzeichnet Dateinamen, Register und
Betriebssystemkommandos.
job, string, Fettschrift kennzeichnet Schlüsselwörter und
while Operatoren der Sprache BEST/2 .
In Beschreibungen der Syntax müssen diese Wörter
wie angegeben geschrieben werden.
ausdruck Kursivschrift kennzeichnet Platzhalter für vom
Programmierer einzutragende Werte, wie z.B.
Dateinamen.
[option] Wörter in eckigen Klammern bedeuten optionale
Angaben.
9
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Einführung
10
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3. Überblick
Dieser Job ermittelt das aktuelle Datum mittels der getasciidate Funktion und
schreibt es in die Variable buffer.
Diese Kommandozeile ruft den BEST/2 Compiler auf, der die Beschreibungsdatei
test.b2v im aktuellen Verzeichnis übersetzten soll. Er verwendet hierzu die Bibliothek
NEULIB.LIB im Verzeichnis \TEST\DEV.
11
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
Kommunikationsfunktionen
Interfacefunktionen
Ergebnis- / Parameterverwaltung
Stringfunktionen
Wandlungsfunktionen
Datafunktionen
Dateifunktionen
Fehlerbehandlung
Zeitbehandlung
Tabellenbehandlung
Konfiguration
Steuergerätespezifische Funktionen
Plugin Funktionen
12
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.1. Kommunikationsfunktionen
Kommunikationsfunktionen dienen dem Zweck, mit dem Steuergerät zu
kommunizieren. Sie stellen die Funktionalität des im EDIABAS enthaltenen
Interfacehandlers zur Verfügung.
Funktion Zweck
13
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.2. Interfacefunktionen
Interfacefunktionen dienen als Schnittstelle zu den Funktionen des Diagnosebus-
Interface. Sie stellen die Funktionalität des im EDIABAS enthaltenen
Interfacehandlers zur Verfügung.
Funktion Zweck
14
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
Funktion Zweck
15
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.4. Stringfunktionen
Die Stringfunktionen dienen der Verwaltung und Bearbeitung von C-kompatiblen
Strings. Diese Strings müssen mit einem Nullcharacter ('\0') abgeschlossen sein.
Funktion Zweck
16
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.5. Wandlungsfunktionen
Die Wandlungsfunktionen dienen zum Wandeln von Daten aus einer Zahl- in eine
String-Form bzw. umgekehrt.
Funktion Zweck
17
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.6. Realfunktionen
Die Realfunktionen dienen zum Bearbeiten von Realzahlen.
Funktion Zweck
18
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.7. Datafunktionen
Datafunktionen bewegen, bzw. setzen Daten. Diese Daten sind im Gegensatz zu
Strings nicht nullterminiert.
Funktion Zweck
19
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.8. Dateifunktionen
Die Dateifunktionen ermöglichen den lesenden Zugriff auf Dateien des Hostsystems.
Funktion Zweck
20
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.9. Ablaufsteuerung
Diese Funktionen ermöglichen den Eingriff in die Jobablaufsteuerung, d.h. wann und
in in welcher Reihenfolge Standardjobs aufgerufen werden.
Funktion Zweck
3.2.10. Fehlerbehandlung
Diese Funktionen ermöglichen die Behandlung von Fehlermeldungen durch die
Beschreibungsdatei.
Funktion Zweck
21
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.11. Zeitbehandlung
Die Funktionen zur Zeitbehandlung ermöglichen u. a. einen Zugriff auf die aktuelle
Uhrzeit und das aktuelle Datum
Funktion Zweck
22
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.12. Tabellenbehandlung
Diese Funktionen dienen der Auswertung der in BEST/2 definierten konstanten
Tabellen.
Funktion Zweck
23
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
3.2.13. Konfiguration
Diese Funktionen dienen dem Setzen und Lesen der EDIABAS-Konfiguration.
Funktion Zweck
24
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Überblick
Funktion Zweck
25
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Auswertung der Klemmenstati des EDICs
Im Anschluß sind alle Funktionen des Interfacehandlers aufgelistet, die mit dem
Interface kommunizieren. Für jede Funktion ist angegeben, welche Fehlermeldungen
aufgrund der Klemmenstati des EDICs generiert werden und welche Reaktion auf die
Fehlermeldung erfolgt. Ist das UBattHandling bzw. IgnitionHandling in der
Konfigurationsdatei EDIABAS.INI ausgeschaltet, werden weder die Fehlermeldungen
UBATT ON/OFF ERROR bzw. IGNITION ON/OFF ERROR aufgrund gesetzter
History-Bits generiert, noch wird als Reaktion darauf die Kommunikation
abgebrochen und die Klemmenstati zurückgesetzt.
Die Systemergebnisse IGNITIONCURRENT; UBATTCURRENT;
IGNITIONHISTORY; UBATTHISTORY werden im Job nur dann mit den Werten (0,1)
für den aktuellen Zustand der Klemmenstati belegt, wenn mindestens eine der
folgenden Funktionen im Job durchlaufen wird (mit Ausnahme der Funktion
ifrawmode). Wird keine der folgenden Funktionen im Job durchlaufen, werden obige
Systemergebnisse immer als undefiniert (-1) gekennzeichnet.
26
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Auswertung der Klemmenstati des EDICs
stop_frequent keine
keine
get_battery_voltage keine
keine
get_ignition_voltage keine
WRONG UBATT
set_program_voltage keine
keine
ifboot Immer:
keine
Die laufende
Kommunikation mit dem
SG wird immer
abgebrochen und die
Klemmenstati werden
immer zurückgesetzt
ifreset Immer:
keine
Die laufende
Kommunikation mit dem
SG wird immer
abgebrochen und die
Klemmenstati werden
immer zurückgesetzt
ifgetport keine
keine
ifsetport keine
keine
ifloopt keine
keine
27
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Auswertung der Klemmenstati des EDICs
ifsireset keine
keine
ifrequeststate keine
keine
ifvers keine
keine
ifrawmode keine
keine
28
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
5. Bibliotheksfunktionen
Bei der Beschreibung der Argumente, bedeutet (V) , daß eine Variable übergeben
werden muß; (C) , daß eine Konstante übergeben werden muß.
29
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
AdjustKWP2000TesterPrStartComm
Kurzbeschreibung
Rückgabewert -
Siehe auch -
Beispiel {
char parameter[];
parameter = kwp_2000_parameter;
parameter[5] = ecuAddress;
AdjustKWP2000TesterPrStartComm(parameter);
}
Ergebnis -
30
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ascii2ascii
Kurzbeschreibung Wandelt alle Zeichen eines Textes in Zeichen eines
anderen Zeichensatzes
codepage Zeichensatz
text Stringpuffer(V)
Rückgabewert -
Siehe auch -
Beispiel
unsigned char codepage[] =
{
// 0 1 2 3 4 5 6 7 8
9 A B C D E F
/*0*/
0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09,0x
0A,0x0B,0x0C,0x0D,0x0E,0x0F,
/*1*/
0x10,0x11,0x12,0x13,0x14,0x15,0x16,0x17,0x18,0x19,0x
1A,0x1B,0x1C,0x1D,0x1E,0x1F,
/*2*/
0x20,0x21,0x22,0x23,0x24,0x25,0x26,0x27,0x28,0x29,0x
2A,0x2B,0x2C,0x2D,0x2E,0x2F,
/*3*/
0x30,0x31,0x32,0x33,0x34,0x35,0x36,0x37,0x38,0x39,0x
3A,0x3B,0x3C,0x3D,0x3E,0x3F,
/*4*/
0x40,0x41,0x42,0x43,0x44,0x45,0x46,0x47,0x48,0x49,0x
4A,0x4B,0x4C,0x4D,0x4E,0x4F,
/*5*/
0x50,0x51,0x52,0x53,0x54,0x55,0x56,0x57,0x58,0x59,0x
5A,0x5B,0x5C,0x5D,0x5E,0x5F,
/*6*/
0x60,0x61,0x62,0x63,0x64,0x65,0x66,0x67,0x68,0x69,0x
6A,0x6B,0x6C,0x6D,0x6E,0x6F,
31
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
/*7*/
0x70,0x71,0x72,0x73,0x74,0x75,0x76,0x77,0x78,0x79,0x
7A,0xE4,0xF6,0xFC,0xDF,0x7F,
/*8*/
0x80,0x81,0x82,0x83,0x84,0x85,0x86,0x87,0x88,0x89,0x
8A,0x8B,0x8C,0x8D,0x8E,0x8F,
/*9*/
0x90,0x91,0x92,0x93,0x94,0x95,0x96,0x97,0x98,0x99,0x
9A,0x9B,0x9C,0x9D,0x9E,0x9F,
/*A*/
0xA0,0xA1,0xA2,0xA3,0xA4,0xA5,0xA6,0xA7,0xA8,0xA9,0x
AA,0xAB,0xAC,0xAD,0xAE,0xAF,
/*B*/
0xB0,0xB1,0xB2,0xB3,0xB4,0xB5,0xB6,0xB7,0xB8,0xB9,0x
BA,0xBB,0xBC,0xBD,0xBE,0xBF,
/*C*/
0xC0,0xC1,0xC2,0xC3,0xC4,0xC5,0xC6,0xC7,0xC8,0xC9,0x
CA,0xCB,0xCC,0xCD,0xCE,0xCF,
/*D*/
0xD0,0xD1,0xD2,0xD3,0xD4,0xD5,0xD6,0xD7,0xD8,0xD9,0x
DA,0xDB,0xDC,0xDD,0xDE,0xDF,
/*E*/
0xE0,0xE4,0xDF,0xE3,0xE4,0xE5,0xE6,0xE7,0xE8,0xE9,0x
EA,0xEB,0xEC,0xED,0xEE,0xF6,
/*F*/
0xF0,0xF1,0xF2,0xF3,0xF4,0xFC,0xF6,0xF7,0xF8,0xF9,0x
FA,0xFB,0xFC,0xFD,0xFE,0xFF
};
{
...
ascii2ascii(codepage,text);
...
}
32
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ascii2hex
Kurzbeschreibung Wandelt einen Hex-String in eine Folge von Bytes
destin Zielpuffer(V)
source Stringpuffer
pos Position im Zielpuffer
Beispiel {
char source[] = "00FF";
char destin[] = { 0x12, 0x34, 0x56, 0x78 };
ascii2hex(destin,source,1};
...
}
33
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
atoi
Bemerkung Die atoi Funktion wandelt einen String in eine Zahl. Wenn
der String mit den Zeichen "0x" oder "0X" beginnt, so wird
der String als hexadezimale Zahl interpretiert. Wenn der
String mit den Zeichen "0y" bzw. "0Y" beginnt, wird der
String als binäre Zahl interpretiert. In allen anderen Fällen
wird der String als dezimale Zahl interpretiert. Beim ersten
Zeichen, das nicht in das Zahlenformat paßt, wird die
Konvertierung abgebrochen.
Beispiel {
long hexzahl;
long binzahl;
long dezzahl;
hexzahl=atoi("0x77");
binzahl=atoi("0y01110110");
dezzahl=atoi("014");
...
}
Ergebnis hexzahl = 0x77 = 119
binzahl = 0x76 = 118
dezzahl= 0x0e = 14
34
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ator
Bemerkung Die ator Funktion wandelt einen String in eine Zahl. Der
String wird als Realzahl interpretiert. Der String darf
folgendes Format haben:
[{sign}][digits][{.|,}digits][{d|D|e|E}[sign]digits]
Rückgabewert -
Beispiel {
real realzahl;
ator(realzahl,"1.22e01");
...
}
35
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
atoy
Beispiel {
char ascii[];
char binary[];
ascii="aa,bb,cc, ,01"
atoy(binary,ascii);
}
Ergebnis binary = { 0xAA, 0xBB, 0xCC, 0x00, 0x01 }
36
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
bcd2ascii
destin Stringpuffer(V)
source Quellpuffer
index Position im Quellpuffer
count Anzahl der zu wandelnden Bytes
Bemerkung Wandelt eine Kette von Bytes (jeweils zwei Nibbles) aus
dem Quellpuffer source, ab der Bytepostion index in einen
nullterminierten BCD-String destin um. Dabei werden
count Bytes aus dem Quellpuffer gewandelt. Für Nibbles
die einen Wert größer Hexadezimal 9 haben ( A..F) steht
im Zielstring ein '*'.
Rückgabewert -
Beispiel {
char source[]={ 0x12, 0x34, 0xFF, 0x78,
0x90 };
char destin[];
bcd2ascii(destin,source,1,3};
...
}
37
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
bittest
name Ergebnisname
source Puffer, der analysiert werden soll
value Testergebnis
{
int xeinvalue; int xausvalue;
char buffer[];
buffer[0]=0x06;
tabset("bits");
bittest("XEIN",buffer,xeinvalue);
bittest("XAUS",buffer,xausvalue);
}
38
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Ergebnis xeinvalue = 1
xausvalue = 0
39
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
bytetest
name Ergebnisname
source Puffer, der analysiert werden soll
value Testergebnis
divs Teiler
Bemerkung Es muß eine Tabelle mit den Spalten NAME, BYTE, MIN,
MAX, MINDEF, MAXDEF, A, B, DIV vorhanden sein. Die
Tabellenbearbeitung muß vorher mit der Funktion tabset
auf diese Tabelle gesetzt worden sein. In der Spalte BYTE
ist angegeben, welches Byte in source betrachtet werden
soll. In den Spalten MIN und MAX die Unter- und
Obergrenzen des Bytes in source. Werden sie über-, bzw
unterschritten, so wird in value der Wert in den Spalten
MINDEF bzw. MAXDEF zurückgegeben. Liegt der Wert
des Bytes innnerhalb der festgelegten Grenzen, so wird
der zurückgegebene Wert nach der Formel A*x + B
berechnet. Der in der Spalte DIV angegebene Teiler wird
in divs zurückgegeben. Er gibt an, mit welchem Wert das
Ergebnis noch geteilt werden muß, um ein korrektes
Ergebnis zu erhalten.
40
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tabset("bytes");
bytetest("TEMP",buffer,tempvalue,tempdivs);
Ergebnis tempvalue = -40
tempdivs = 1
41
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
clear_error
void clear_error()
Rückgabewert -
Siehe auch -
Beispiel set_trap_mask(0x60000);
ifreset();
set_trap_mask(0x00);
clear_error();
Ergebnis -
42
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
close_communication
void close_communication()
Rückgabewert -
Beispiel -
Ergebnis -
43
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
data_to_real
Rückgabewert -
Beispiel {
44
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
datacat
Rückgabewert -
45
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
dataclear
Rückgabewert -
46
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
datacmp
Kurzbeschreibung Vergleicht zwei Datenpuffer
d1 Datenpuffer 1 (V)
d2 Datenpuffer 2
Beispiel {
int x; int y; int z;
unsigned char d1[];
d1 = {1,2,3}
x=datacmp(d1,{1,2,3});
y=datacmp(d1,{1,2,3,4});
z=datacmp(d1,{1,2,4});
}
47
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
datacopy
Rückgabewert -
Beispiel {
char source[]= { 0x12, 0x34, 0x56, 0x78,
0x90 };
char destin[];
datacopy(destin,source,2,3);
...
}
Ergebnis destin={0x56,0x78,0x90}
48
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
dataerase
Rückgabewert -
Beispiel {
char buffer[] = { 0x12,0x34,0xFF,0x56,0x78
};
dataerase(buffer,1,2);
...
}
49
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
datainsert
Rückgabewert -
Beispiel {
char source[] = { 0xF0,0xF1 };
char destin[] = { 0x12,0x34,0x56,0x78 };
datainsert(destin,source,3);
...
}
50
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
datalen
Ergebnis length = 4
51
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
datarevers
Rückgabewert -
52
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
dataset
Kurzbeschreibung Setzt die Bytes in einem Puffer auf einen definierten Wert
Rückgabewert -
Beispiel {
char buffer[]={ 0x12, 0x34, 0x56, 0x78,
0x90 };
dataset(buffer,0x41,2};
...
}
53
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
doNewInit
void doNewInit()
Rückgabewert -
Siehe auch -
Beispiel {
doNewInit();
}
Ergebnis -
54
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
enableIfhTrace
Rückgabewert -
enableIfhTrace(1);
iftype(buffer);
enableIfhTrace(0);
Ergebnis -
55
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
enableClampHandling
Rückgabewert -
enableClampHandling(0);
iftype(buffer);
enableClampHandling(1);
Ergebnis -
56
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
enableIgnitionHandling
Rückgabewert -
enableIgnitionHandling(0);
iftype(buffer);
enableIgnitionHandling(1);
Ergebnis -
57
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
enableUBattHandling
Rückgabewert -
enableUBattHandling(0);
iftype(buffer);
enableUBattHandling(1);
Ergebnis -
58
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
fclose
Rückgabewert -
Beispiel {
int handle;
handle=fopen("/test/div/test.dat");
...
/* Dateioperationen */
...
fclose(handle);
}
59
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
fopen
Kurzbeschreibung Öffnen einer Text-Datei zum Lesen
Rückgabewert Filehandle
Beispiel {
int handle;
handle=fopen("/usr2/test/test.dat");
...
/* Dateioperationen mit handle*/
...
fclose(handle);
}
60
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
fread
Kurzbeschreibung Lesen eines einzelnen Zeichens aus einer Datei
Bemerkung Die Funktion fread liest ein Zeichen aus einer Datei.
Gelesen wird ab der aktuellen Position des Lesezeigers.
Der Lesezeiger wird nach dem Lesen des Zeichens um 1
inkrementiert. Wurde versucht am Ende einer Datei zu
lesen, so wird -1 als Wert des Zeichens zurückgegeben
und der Lesezeiger wird nicht mehr inkrementiert.
Beispiel {
int handle;
long c; long i=0;
handle=fopen("test.dat");
while((c=fread(handle)) != -1 )
i++;
}
61
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
freadln
Kurzbeschreibung Lesen einer Zeile aus einer Datei
Bemerkung Die Funktion freadln liest ein Zeile aus einer Datei. Eine
Zeile sind alle Zeichen bis zu einem LF Zeichen. Gelesen
wird ab der aktuellen Position des Lesezeigers. Der
Lesezeiger wird nach dem Lesen der Zeile soweit
inkrementiert, bis er auf den Anfang der nächsten Zeile
zeigt. Die Funktion gibt die Länge der Zeile zurück. Wurde
versucht am Ende der Datei zu lesen, so wird -1 als Länge
der Zeile zurückgegeben und der Lesezeiger wird nicht
mehr inkrementiert. Im Fehlerfall (des Hostdateisystems)
wird der Fehler BIP_0006 ausgelöst [4].
Es sind maximal 1023 Zeichen pro Zeile zulässig !
Beispiel {
int handle;
char line[]; long i=0;
handle=fopen("beispiel.txt");
while(freadln(line,handle) != -1 )
i++;
}
62
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
fseek
Kurzbeschreibung Byteweises Setzen der Position des Lesezeigers
Beispiel {
int handle;
int c;
handle=fopen("Filename");
c=fread(handle);
fseek(0,handle);
c=fread(handle);
...
}
63
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
fseekln
Kurzbeschreibung Zeilenweises Setzen der Position des Lesezeigers
Beispiel {
int handle;
char line[];
handle=fopen("test.txt");
fseekln(10,handle);
freadln(line,handle);
...
}
64
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ftell
Kurzbeschreibung Ermitteln der Position des Lesezeigers
Beispiel {
int handle;
long c;
handle=fopen("Filename");
c=fread(handle);
c=fread(handle);
.
c=ftell(handle);
}
65
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ftellln
Kurzbeschreibung Ermitteln der Position des Lesezeigers in Zeilen
Beispiel {
int handle; int c;
char line[];
handle=fopen("xxx.tst");
freadln(line,handle);
freadln(line,handle);
.
c=ftellln(handle);
}
66
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
get_battery_voltage
Kurzbeschreibung Auslesen der Batteriespannung
long get_battery_voltage()
Ergebnis -
67
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
get_error
(get_trap_mask, set_trap_mask)
Kurzbeschreibung Prüfen ob ein Fehler aufgetreten ist
68
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
69
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
get_error2
Kurzbeschreibung Prüfen ob ein Fehler aufgetreten ist
long get_error2()
70
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
get_ignition_voltage
Kurzbeschreibung Auslesen der Spannung an der Zündung
long get_ignition_voltage()
Ergebnis -
71
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
get_token
Kurzbeschreibung Ermitteln eines Tokens in einem String
Rückgabewert -
Beispiel {
char source[]; char destin[];
source="DIES IST EIN TEST FUER TOKENS";
gettoken(destin,source," ",4);
}
72
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
get_trap_mask
Kurzbeschreibung Einlesen des aktuellen Werts des Trapmaskregisters
long get_trap_mask()
Beispiel {
long x;
set_trap_mask(0x00180000);
x=get_trap_mask();
}
Ergebnis x=0x00180000
73
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
generateRunError
Kurzbeschreibung Löst einen anwendungsspezifischen „RUN-00XX“-Fehler
aus
Rückgabewert -
Beispiel {
...
generateRunError(250); // „RUN-0000“
// auslösen
}
Ergebnis -
74
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
getasciidate
Kurzbeschreibung Ermitteln des aktuellen Datums als ASCII-String
Bemerkung Ermittelt aus der Systemzeit das aktuelle Datum als String
der Form:
"wt tt.mm.jj KW kw"
wt = Wochentag = MO, DI, MI, DO, FR, SA, SO
Die Kalenderwoche (KW) wird nach den allgemein
gültigen Regeln ermittelt.
Rückgabewert -
Beispiel {
char date[];
getasciidate(date);
...
}
75
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
getasciitime
Kurzbeschreibung Ermitteln der aktuellen Uhzeit als ASCII-String
Bemerkung Ermittelt aus der Systemzeit die aktuelle Uhrzeit als String
der Form:
"hh:mm:ss"
Rückgabewert -
Beispiel {
char time[];
getasciitime(time);
...
}
76
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
getCfgInt
cfg Konfigurationselement
cfgvalue=getCfgInt("RetryComm");
77
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
getCfgString
getCfgString(cfgvalue,"SimulationPath");
78
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
getdate
Kurzbeschreibung Ermitteln des aktuellen Datums als Arraystruktur
Rückgabewert -
Beispiel {
char date[];
79
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
getETXblock
Kurzbeschreibung Liefert die Datenbytes eines angegebenen Blocks eines
KWP 1281 Steuergerätes.
Rückgabewert 0 = Fehler
1 = alles in Ordnung
Siehe auch -
send_and_receive(antwort,tel_fslesen);
if
(getETXblock(antwort,status,1,buffer,blockL
en))
{
Ergebnis -
80
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
GetKWP2000Block
Kurzbeschreibung Extrahiert den Datenteil aus einem KWP 2000 Telegramm
in der Steuergeräteantwort.
Rückgabewert 0: Fehler
1: Kein Fehler
Siehe auch -
Beispiel {
unsigned char resonse[];
int position;
int format;
int source;
int target;
int length;
unsigned char data[];
unsigned char dataglobal[];
send_and_receive(resonse,request);
81
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
position = 0;
while(GetKWP2000Block(position,resonse,
format,source,target,length,data))
datacat(dataglobal,data);
}
Ergebnis -
82
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
gettickcount
Kurzbeschreibung Ermitteln eines systeminternen Zählerwerts in
Millisekunden.
Beispiel {
unsigned long ticks;
ticks=gettickcount();
...
}
Ergebnis -
83
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
gettime
Kurzbeschreibung Ermitteln der aktuellen Uhrzeit als Arraystruktur
Rückgabewert -
Beispiel {
char time[];
gettime(time);
...
}
84
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
hex2ascii
Kurzbeschreibung Wandelt eine Folge von Bytes in einen Hex-String.
destin Stringpuffer(V)
source Quellpuffer
pos Position im Quellpuffer
count Anzahl der zu wandelnden Bytes
Bemerkung Wandelt eine Kette von Bytes aus dem Quellpuffer source,
ab Byteposition pos, in einen nullterminierten String destin
um. Dabei werden count Bytes aus dem Quellstring
gewandelt.
Rückgabewert -
Beispiel {
char source[]={ 0x12, 0x34, 0xFF, 0x78,
0x90 };
char destin[];
hex2ascii(destin,source,1,2};
...
}
85
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifboot
Kurzbeschreibung Rücksetzen des Interface
void ifboot()
Rückgabewert -
Siehe auch -
Beispiel ifboot();
Ergebnis -
86
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifgetport
Kurzbeschreibung Auslesen eines Ports
Bemerkung Diese Funktion ließt Ports aus. Beim EDIC können neun
Ports ausgelesen werden. Die Ports 0 - 7 sind
Analogeingänge (Ergebnisse in Millivolt), das Port 8 gibt
den Wert des Jumperfields zurück (jedes Bit entspricht
einem Jumper).
EDIC:
Port 0 - 5 : Analogeingänge 0 - 5 (Spannung in Millivolt)
Port 6: Analogeingang Klemme 15 (Spannung in
Millivolt)
Port 7 : Analogeingang Klemme 30 (Spannung in
Millivolt)
Port 8 : Jumperfeld (Digitalwert)
Ergebnis -
87
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifinfo
Kurzbeschreibung Debugfunktion
Rückgabewert -
Beispiel -
Ergebnis -
88
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifinfoExt
Kurzbeschreibung Debugfunktion
Rückgabewert Status
Beispiel -
Ergebnis -
89
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifloopt
Kurzbeschreibung Testen der Diagnoseleitung
long ifloopt()
Siehe auch -
Beispiel if (ifloopt())
/* fuehre Diagnose durch */
Ergebnis -
90
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifrawmode
Kurzbeschreibung Daten an das Interface durchreichen
Rückgabewert -
Siehe auch -
91
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifrecv
Kurzbeschreibung Funktion für Debugzwecke
Rückgabewert -
Beispiel -
Ergebnis -
92
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifrequeststate
Kurzbeschreibung Abfrage des Status vom Interface
Bemerkung Mit dieser Version wird der aktuelle Status des Interfaces
abgefragt.
Rückgabewert -
Siehe auch -
Beispiel
Ergebnis -
93
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifreset
Kurzbeschreibung Rücksetzen der Kommunikationsparameter
void ifreset()
Rückgabewert -
Beispiel ifreset();
Ergebnis -
94
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifsend
Kurzbeschreibung Funktion für Debugzwecke
Rückgabewert -
Beispiel -
Ergebnis -
95
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifsetport
Kurzbeschreibung Setzen eines Ports
port Portnummer
wert Portwert
Rückgabewert -
Ergebnis -
96
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifsireset
Kurzbeschreibung Schalten des SI-Relais
Rückgabewert -
Siehe auch -
Ergebnis -
97
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
iftype
Kurzbeschreibung Liefert den Interfacetyp als String
Rückgabewert -
Ergebnis -
98
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
ifvers
Kurzbeschreibung Liefert die Interfaceversionsnummer
long ifvers()
Rückgabewert Versionsnummer
Siehe auch -
99
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
incProgressPos
Kurzbeschreibung Erhöht die aktuelle Position des Fortschrittszählers
void incProgressPos(long n)
Rückgabewert -
Beispiel
setProgressRange(500);
incProgressPos(0); // Start mit 0 Prozent
:
incProgressPos(100); // 20 Prozent
: // bearbeitet
incProgressPos(300); // 80 Prozent
: // bearbeitet
incProgressPos(200); // 100 Prozent
// bearbeitet
///////////////////////////////////////////
////////
// Im ENDE-Job
setProgressRange(0); // Bearbeitungsstand
// zuruecksetzen
Ergebnis -
100
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
isDebugLevel
long isDebugLevel()
send_and_reveive(antwort,tel);
Ergebnis
101
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
isSimulation
long isSimulation()
if(isSimulation())
send_and_reveive(antwort,tel_sim);
else
send_and_reveive(antwort,tel);
Ergebnis
102
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
itoad
Kurzbeschreibung Wandelt eine Zahl in einen String in dezimaler Darstellung
Bemerkung Die Funktion itoad wandelt die Zahl value in einen String
in dezimaler Darstellung mit Vorzeichen. Es werden keine
führenden Nullen ausgegeben.
Rückgabewert -
Beispiel {
char destin[];
itoad(destin,1143);
...
}
Ergebnis destin="1143"
103
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
itoax
Kurzbeschreibung Wandelt eine Zahl in einen String in hexadezimaler
Darstellung
Bemerkung Die Funktion itoax wandelt die Zahl value in einen String
in hexadezimaler Darstellung ohne Vorzeichen. Der
ausgegebene String hat immer das Format 0x########.
Es werden immer alle Stellen ausgegeben.
Rückgabewert -
Beispiel {
char destin[];
itoax(destin,1143);
...
}
Ergebnis destin="0x00000477"
104
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
itor
Kurzbeschreibung Wandelt einen Integerwert in eine Realzahl
Rückgabewert -
Beispiel {
real realzahl;
itor(realzahl,122);
...
}
105
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
make_error
Kurzbeschreibung Löst einen Fehler aus
Rückgabewert -
Beispiel {
...
make_error(19); // IFH_0009
auslösen
}
Ergebnis -
106
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
new_set_of_results
Kurzbeschreibung Öffnen eines neuen Ergebnissatzes
void new_set_of_results()
Rückgabewert -
Beispiel ...
result: x ; type int ...
{
x = 1;
x = 2;
new_set_of_results();
x = 1;
...
}
Ergebnis Ergebnissatz 1: x = 2;
Ergebnissatz 2: x = 1;
107
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
open_communication
Kurzbeschreibung Öffnen des Kommunikationskanals zum Interface
void open_communication()
Bemerkung Diese Funktion öffnet den Treiber und stellt fest, ob ein
IDBSS oder ein EDIC angeschlossen ist. Ist ein IDBSS
angeschlossen, so werden EDIC-spezifische Funktionen
gesperrt. Diese Funktion muß vor allen anderen
Funktionen, die auf das Interface zugreifen, aufgerufen
werden. Es empfiehlt sich, diese Funktion als erste
Funktion im Job INITIALISIERUNG zu schreiben. Wurde
open_communication noch nicht aufgerufen, so werden
alle Kommunikations- und Interfacebefehle mit der
Fehlermeldung IFH_0019 beantwortet.
Rückgabewert -
Beispiel open_communication();
Ergebnis -
108
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
parcount
Kurzbeschreibung Ermitteln der Parameteranzahl
long parcount()
Bemerkung Ermittelt die Anzahl der bei apiJob bzw. apiJobData als
Parameter 3 übergebenen Parameter. Dabei werden
immer alle Parameter gezählt, auch jene die nicht gültig,
also leer sind. d.h. parcount liefert bei apiJob(
"...","...",";;;;","..." ) den Wert 5 zurück. Es wird auch dann 1
zurückgegeben, wenn ein Paramter vorhanden ist, der
nicht auswertbar ist.
Beispiel {
long x;
x=parcount();
}
109
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
real_to_data
Rückgabewert -
Beispiel {
realzahl = atof("123.45");
real_to_data(buffer,realzahl,0,0,0);
...
}
110
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
realadd
Kurzbeschreibung Addiert zwei Realzahlen
Rückgabewert -
Beispiel ){
real real1;
real real2;
ator(real1,"1234e15");
ator(real2,"5678e13");
realadd(real1,real2);
}
111
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
realcomp
Kurzbeschreibung Vergleicht zwei Realzahlen
Siehe auch -
Beispiel ){
int cmp;
real real1;
real real2;
ator(real1,"1.00");
ator(real2,"2.00");
if (realcomp(real1,"<",real2))
cmp=1;
else
cmp=0;
}
Ergebnis cmp = 1
112
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
realdiv
Kurzbeschreibung Dividiert zwei Realzahlen
Rückgabewert -
Beispiel ){
real real1;
real real2;
ator(real1,"1234e15");
ator(real2,"5678e13");
realdiv(real1,real2);
}
113
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
realmul
Kurzbeschreibung Multipliziert zwei Realzahlen
Rückgabewert -
Beispiel ){
real real1;
real real2;
ator(real1,"1234e15");
ator(real2,"5678e13");
realmul(real1,real2);
}
114
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
realresult
Kurzbeschreibung Erzeugt ein Realergebnis
Rückgabewert -
Ergebnis x = 12345,678
115
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
realsub
Kurzbeschreibung Subtrahiert zwei Realzahlen
Rückgabewert -
Beispiel ){
real real1;
real real2;
ator(real1,"1234e15");
ator(real2,"5678e13");
realsub(real1,real2);
}
116
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
recv_frequent
Kurzbeschreibung Empfangen eines Telegramms im Frequentmodus
Rückgabewert -
Ergebnis -
117
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
recv_keybytes
Kurzbeschreibung Auslesen der Steuergeräte Keybytes
Rückgabewert -
Siehe auch -
Ergebnis -
118
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
rtoa
Beispiel {
char destin[];
real realzahl;
int len;
ator(realzahl,"1.234";
...
len=rtoa(destin,realzahl,3);
...
}
Ergebnis destin="1.23";
len=5
119
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
rtoi
Beispiel {
long destin[];
real realzahl;
ator(realzahl,"5.234";
...
destin=rtoi(realzahl);
...
}
Ergebnis destin=5;
120
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
send_and_receive
Kurzbeschreibung Senden und Empfangen eines Telegramms
Rückgabewert -
Ergebnis -
121
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
send_frequent
Kurzbeschreibung Senden und Empfangen von Telegrammen im
Frequentmodus
request Steuergeräte-Anforderungstelegramm
Rückgabewert -
Ergebnis -
122
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
set_answer_length
Kurzbeschreibung Setzen der Telegrammparameter/Antwortlänge
telparam Telegrammparameter
123
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Rückgabewert -
124
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Ergebnis
125
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
set_communication_pars
Kurzbeschreibung Setzen der Kommunikationsparameter
param Kommunikationsparameter
Bemerkung Mit dieser Funktion werden die für die Kommunikation mit
einem Steuergerät erforderlichen Kommunikations-
parameter gesetzt. Die Parameter haben ein
interfaceunabhängiges Format. Wurden die Parameter mit
dieser Funktion gesetzt, muß die Anwendersoftware auf
Grund eines Interfacewechsels nicht geändert werden.
Eine Ausnahme bildet das Konzept 0x0000FF00. Dieses
Konzept ist eine Kennung für den IFH-EDIC, daß die
folgenden Parameter eins zu eins an das EDIC
durchgereicht werden.
0x01xx: long-Werte
0x00xx integer Werte
126
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Konzept 2 DDE
Konzept DS1
Konzept DS2
param[0] Konzept
Konzept 1 =1
Konzept 2 ISO 9141 =2
Konzept 3 =3
Konzept 2 DDE =4
Konzept DS1 =5
Konzept DS2 =6
param[1] Baudrate
Wird nur bei Konzept-1, DS1, DS2 ausgewertet
param[2] Reizadresse
Wird vom Interface nur bei Konzept-2, -3 und -4
ausgewertet, wird aber für EDIABAS benötigt
param[3] Wakeup
Zeit in ms. 0 ms bedeutet kein WakeUp
(Nur bei Konzept 1)
param[4] IdleTime
Zeit in ms zwischen dem WakeUp und dem Start des
ersten Telegramms (Nur bei Konzept 1 mit WakeUp)
param[5] Auszeit
Zeit in ms, innerhalb der das SG auf ein Telegramm vom
Interface geantwortet haben muß
param[6] Regenerationszeit
Zeit in ms, die nach der Antwort des SG vergehen muß,
bis wieder gesendet werden darf
param[7] Telegr.Endezeit
Zeit in ms nach der auf Telegrammende entschieden wird
param[8] Bytezwischenzeit (optional)
Bytezwischenzeit für DS2 im ms.
param[9] Checksumme (optional)
Angabe, wie die Telegrammchecksumme gebildet und
überprüft werden soll. Wird nichts angegeben, wird die
Checksumme des zu sendenden Telegramms
automatisch vom Interface gebildet und die Checksumme
des empfangenen Telegramms überprüft. Die
Checksummenbehandlung ist bitkodiert.
127
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
param[0] Konzept
BMW-FAST = 0x10F
param[1] Baudrate
0 bis 115200 Baud (= 115200Baud)
param[2] Auszeit
Zeit in ms, innerhalb der das SG auf ein Telegramm vom
Interface geantwortet haben muß (= 200 ms).
param[3] Regenerationszeit
Zeit in ms, die nach der Antwort des SG vergehen muß,
bis wieder gesendet werden darf (= 3 ms).
param[4] Telegramm Endezeit
Zeit in ms nach der auf Telegrammende entschieden wird
(= 3 ms).
param[5] Anzahl Negative response code 0x78
Anzahl der maximalen Negative response code 0x78
Antworten des SG (= 2).
param[6] Auszeit Negative response code 0x78
Zeit in ms, innerhalb der das SG nach Negative response
code 0x78 geantwortet haben muß (= 5000 ms).
param[7] Checksumme (optional)
= 1 (default)
Angabe, wie die Telegrammchecksumme gebildet und
überprüft werden soll. Wird nichts angegeben, wird die
Checksumme des zu sendenden Telegramms
automatisch vom Interface gebildet und die Checksumme
des empfangenen Telegramms überprüft. Die
Checksummenbehandlung ist bitkodiert.
128
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
param[0] Konzept
KWP2000 BMW = 0x10C
param[1] Baudrate
0 bis 115200 Baud (= 10400 Baud)
param[2] Auszeit
Zeit in ms, innerhalb der das SG auf ein Telegramm vom
Interface geantwortet haben muß (= 200 ms).
param[3] Regenerationszeit
Zeit in ms, die nach der Antwort des SG vergehen muß,
bis wieder gesendet werden darf (= 3 ms).
param[4] Telegramm Endezeit
Zeit in ms nach der auf Telegrammende entschieden wird
(= 3 ms),
param[5] Bytezwischenzeit
Bytezwischenzeit in ms.(= 0 ms)
param[6] Anzahl Negative response code 0x78
Anzahl der maximalen Negative response code 0x78
Antworten des SG (= 2)
param[7] Auszeit Negative response code 0x78
Zeit in ms, innerhalb der das SG nach Negative response
code 0x78 geantwortet haben muß (= 5000 ms).
param[8] TesterPresent Time
Zeit nach der letzten SG-Antwort bis zum nächsten Tester
Present Telegramm in ms (= 3000 ms).
param[9] TesterPresent Telegramm Länge
Länge des TesterPresent Telegrams maximal 11 (= 5)
129
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
param[10]. bis.
param[20] TesterPresent Telegramm
TesterPresent Telegramm. Ist das Telegramm kürzer als
11 Zeichen sind die restlichen Zeichen mit 0 anzugeben.
param[21] StartCommunication Telegramm Länge
Länge des StartCommunication Telegrams maximal 11 (=
5)
param[22] bis
param[32] StartCommunication Telegramm
StartCommunication Telegramm. Ist das Telegramm
kürzer als 11 Zeichen sind die restlichen Zeichen mit 0
anzugeben.
param[33] Checksumme (optional)
= 1 (default)
Angabe, wie die Telegrammchecksumme gebildet und
überprüft werden soll. Wird nichts angegeben, wird die
Checksumme des zu sendenden Telegramms
automatisch vom Interface gebildet und die Checksumme
des empfangenen Telegramms überprüft. Die
Checksummenbehandlung ist bitkodiert.
Bit 0 = 0: Die Checksumme des zu sendenden
Telegramms muß vom Benutzer gebildet
werden.
Bit 0 = 1: Die Checksumme des zu sendenden
Telegramms wird vom Interface gebildet.
Bit 1 = 0: Die Checksumme des empfangenen
Telegramms wird überprüft.
Bit 1 = 1: Die Checksumme des empfangenen
Telegramms wird nicht überprüft.
param[0] Konzept
KWP2000 * = 0x10D
param[1] Baudrate
0 bis 115200 Baud (= 10400 Baud)
param[2] Auszeit
Zeit in ms, innerhalb der das SG auf ein Telegramm vom
Interface geantwortet haben muß (= 200 ms).
param[3] Regenerationszeit
130
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
131
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
132
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Bit 0:
133
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
134
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
135
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Bit 1:
136
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
137
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
138
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Bit 5:
139
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
140
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
0: Physikalische Adressierung
1: Funktionale Adressierung
TesterPresent Behandlung:
141
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Bit 6:
142
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
143
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
144
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
145
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
146
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
147
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
148
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
149
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
150
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
151
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
param[52] Reserviert
param[53] Reserviert
param[54] Reserviert
param[55] Reserviert
param[56] Tester Adresse
Testeradresse, wird verwendet wenn der Header vom
Interface erzeugt wird.
param[57] Reserviert
param[58] Reserviert
param[59] Reserviert
Rückgabewert -
Ergebnis -
152
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
set_program_voltage
Kurzbeschreibung Setzen der Programmierspannung
Rückgabewert -
Siehe auch -
Ergebnis -
153
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
set_repeat_counter
Kurzbeschreibung Setzt die Anzahl der Wiederholungen bei
Steuergerätekommunikation
Rückgabewert -
Beispiel {
/* Schnelle Entscheidung ob SG da */
set_repeat_counter(0); // keine
Wiederholung
send_and_recv(...
/* Warte bis SG da */
set_repeat_counter(10000); // 10000
Wiederholungen
send_and_recv(...
}
Ergebnis -
154
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
set_trap_mask
Kurzbeschreibung Setzen des Trapmaskregisters
mask Trapmaske
155
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
Beispiel {
set_trap_mask(0x00180000);
send_and_recv(.....);
if(get_error(19))
job_status="DIAGNOSE-FEHLER";
else
job_status="OKAY";
}
156
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
157
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
set_variable_result
Kurzbeschreibung Ausgabe von variablen Ergebnissen
Rückgabewert -
Beispiel {
char wert[]="mein Ergebniswert";
unsigned char y[];
real x;
set_variable_result("ERGEBNIS",3,0,x,wert,y
);
}
158
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
setProgressRange
Kurzbeschreibung Gibt eine Fortschrittsbereich von 0 bis Range an.
Rückgabewert -
Beispiel
setProgressRange(500);
incProgressPos(0); // Start mit 0 Prozent
:
incProgressPos(100); // 20 Prozent
: // bearbeitet
incProgressPos(300); // 80 Prozent
: // bearbeitet
incProgressPos(200); // 100 Prozent
// bearbeitet
///////////////////////////////////////////
////////
// Im ENDE-Job
setProgressRange(0); // Bearbeitungsstand
// zuruecksetzen
Ergebnis -
159
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
shdataget
Kurzbeschreibung Kopiert den Inhalt des globalen Datenspeichers in einen
Zielpuffer.
Bemerkung Mit dieser Funktion wird der gesamte Inhalt des globalen
Datenspeichers in den Zielpuffer kopiert. Vor dem
Kopiervorgang wird der Zielpuffer gelöscht. Die ID (Name)
des Datenspeichers ist ein maximal 32 Zeichen langer
Asciiz-String (C-String). Auch ein Leerstring ist eine
gültige ID. Wird als ID ein Leerstring verwendet, dann wird
der Inhalt des Datenspeichers immer in den Zielpuffer
kopiert. Sonst wird der Datenspeicher nur kopiert, wenn
für die Befüllung die selbe ID verwendet wurde.
shdataget("myID",local);
Ergebnis -
160
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
shdataset
Kurzbeschreibung Befuellt den globalen Datenspeicher mit dem Inhalt des
Quellpuffers.
Rückgabewert -
shdataset("myID",source);
Ergebnis -
161
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
stop_frequent
Kurzbeschreibung Beenden des Frequentmodus
void stop_frequent()
Rückgabewert -
Beispiel -
Ergebnis -
162
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strcat
Kurzbeschreibung Hängt einen String an einen anderen an
Rückgabewert -
Beispiel {
char destin[]="01234";
char source[]="56789";
strcat(destin,source);
}
163
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strcmp
Kurzbeschreibung Vergleicht zwei Strings
s1 String1 (V)
s2 String2
Bemerkung Die Funktion vergleicht die beiden Strings s1 und s2. Sind
die beiden Strings gleich lang und in allen Zeichen
identisch, so wird auf gleich entschieden, sonst auf
ungleich.
Beispiel {
int x; int y; int z;
char s1[]="ABC";
x=strcmp(s1,"ABC");
y=strcmp(s1,"ABCD");
z=strcmp(s1,"abc");
}
164
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strcpy
Kurzbeschreibung Kopiert einen String
Bemerkung Mit strcpy wird der String source nach destin kopiert. Es
werden alle Zeichen von source bis zum Nullcharacter
kopiert. Der Zielstring destin wird vorher gelöscht.
Rückgabewert -
Beispiel {
char destin[]="ABC";
strcpy(destin,"XD");
}
165
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strcut
Kurzbeschreibung Kürzen eines Strings
Rückgabewert -
Beispiel {
char buffer[]="ABCDF";
strcut(buffer,3);
}
166
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strerase
Kurzbeschreibung Löschen von Zeichen in einem String
Rückgabewert -
Beispiel {
char buffer[]="ABCDEFGHIJKLM";
strerase(buffer,3,3);
}
Ergebnis buffer="ABCGHIJKLM"
167
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strinsert
Kurzbeschreibung Fügt Zeichen in einen String ein
Bemerkung Die Funktion strinsert fügt den String source in den String
destin ein. Es wird ab der Position pos eingefügt. Wird der
String destin länger als ein Stringregister, d.h. 1023
Zeichen, so wird der Rest abgeschnitten.
Rückgabewert -
Beispiel {
char buffer[]="ABCGHIJKLM";
strinsert(buffer,"DEF",3);
}
168
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strlen
Kurzbeschreibung Ermittelt die Länge eines Strings
Bemerkung Die Funktion strlen ermittelt die Länge eines Strings. Die
Länge eines Strings ist die Anzahl der in ihm enthaltenen
Zeichen, ohne den abschließenden Nullcharacter.
Beispiel {
char string[]="ABCDEF"
long x;
x=strlen(string);
}
Ergebnis x=6
169
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strncpy
Kurzbeschreibung Kopiert eine Anzahl Zeichen aus einem String
Bemerkung Mit strcpy wird der String source nach destin kopiert. Ist
der String destin länger als count, so werden nur die
ersten count Zeichen kopiert. Der Zielstring wird nicht
gelöscht.
Rückgabewert -
Beispiel {
char destin[]="ABCDEFGH";
strncpy(destin,"XYZABCDEF",3);
}
170
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
strrevers
Kurzbeschreibung Umdrehen eines Strings
Bemerkung Die Funktion strrevers dreht den String string um, d.h.
das letzte Zeichen wird zum ersten u.s.w.
Rückgabewert -
Beispiel {
char destin[]="ABCDEFGH";
strrevers(destin);
}
171
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tab2fix
Kurzbeschreibung Auslesen der Werte aus der aktuellen Tabellenzeile und
Wandlung in eine Zahl.
Bemerkung Die Funktion tab2fix liest einen Wert aus der aktuellen,
mit tabseek oder tab_suche_index bestimmten
Tabellenzeile und wandelt ihn in eine Zahl. Der Text von
spalte gibt an, aus welcher Spalte der Wert zu holen ist.
Ist die Spalte nicht vorhanden, so wird der Fehler
BIP_0010 (Constant Data Access Error) [4] ausgelöst.
Rückgabewert -
tabset("FUmweltMatrix");
tab_suche_index("ORT", fehlerNr)
tab2fix(uw1, "UW1_NR");
Ergebnis -
172
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tab_suche_index
Kurzbeschreibung Sucht in einer Tabellenspalte nach einem Wert der Form
0x##
{
char buffer[];
tabset("TST");
tab_suche_index("NUMMER",3);
tabget(buffer,"NAME");
}
173
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tab_suche_unsigned
Kurzbeschreibung Sucht in einer Tabellenspalte nach einen vorgegebenen
vorzeichenlosen Wert
174
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
{
char buffer[];
unsigned long index;
tabset("TST");
index=0x300;
tab_suche_unsigned("NUMMER",index);
tabget(buffer,"NAME");
}
175
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tabget
Kurzbeschreibung Auslesen der Werte aus der aktuellen Tabellenzeile
Bemerkung Die Funktion tabget liest einen Wert aus der aktuellen, mit
tabseek oder tab_suche_index bestimmten
Tabellenzeile. Der Wert von column gibt an, aus welcher
Spalte value zu holen ist. Ist die Spalte nicht vorhanden,
so wird der Fehler BIP_0010 (Constant Data Access
Error) [4] ausgelöst.
Rückgabewert -
176
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tabline
Kurzbeschreibung Positioniert den Lesezeiger auf die angegebene Zeile
177
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tabseek
Kurzbeschreibung Sucht in einer Tabellenspalte nach einem Wert
178
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tabset
Kurzbeschreibung Auf- und Rücksetzen der Tabellenbearbeitung
void tabset(char tabname[])
tabname Name der Tabelle mit der gearbeitet werden soll
Ergebnis -
179
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
tabsetext
Kurzbeschreibung Auf- und Rücksetzen der Tabellenbearbeitung
void tabsetext(char tabfile[],char tabname[])
tabfile Steuergeräte-Beschreibungsdatei, in der sich die Tabelle
tabname befindet
tabname Name der Tabelle mit der gearbeitet werden soll
180
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
uitoad
Kurzbeschreibung Wandelt eine unsigned Zahl in einen String in dezimaler
Darstellung
Bemerkung Die Funktion uitoad wandelt die Zahl value in einen String
in dezimaler Darstellung ohne Vorzeichen. Es werden
keine führenden Nullen ausgegeben.
Rückgabewert -
Beispiel {
char destin[];
uitoad(destin,4294967295);
...
}
Ergebnis destin="4294967295"
181
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
updateInfo
Kurzbeschreibung Erzeugt ein Stringergebnis während der Jobbearbeitung
void updateInfo()
Rückgabewert -
Siehe auch -
Ergebnis -
182
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
userbreak
Kurzbeschreibung Erzeugt die Fehlermeldung "BIP-0008: BEST BREAK"
void userbreak()
Rückgabewert -
Beispiel userbreak();
Ergebnis -
183
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
var_result_data
Kurzbeschreibung Erzeugt ein nicht im Job-Header definiertes Dataergebnis
Rückgabewert -
var_result_data(resultname,resultvalue);
Ergebnis -
184
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
var_result_long
Kurzbeschreibung Erzeugt ein nicht im Job-Header definiertes Longergebnis
Rückgabewert -
var_result_long(resultname,resultvalue);
Ergebnis -
185
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
var_result_real
Kurzbeschreibung Erzeugt ein nicht im Job-Header definiertes Realergebnis
Rückgabewert -
ator(resultvalue,"1.23");
var_result_real(resultname,resultvalue);
Ergebnis -
186
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
var_result_string
Kurzbeschreibung Erzeugt ein nicht im Job-Header definiertes Stringergebnis
Rückgabewert -
var_result_string(resultname,resultvalue);
Ergebnis -
187
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
wait
Kurzbeschreibung n Sekunden warten
Rückgabewert -
Beispiel {
wait(1);
}
188
EDIABAS — BEST/2 FUNKTIONSREFERENZ
Bibliotheksfunktionen
waitex
Kurzbeschreibung n Millisekunden warten
Beispiel {
waitex(1000);
}
189
EDIABAS — BEST/2 FUNKTIONSREFERENZ
LITERATURVERZEICHNIS
LITERATURVERZEICHNIS
[1] EDIABAS: BEST/1 Sprache & Interpreter
[2] EDIABAS: BEST/2 Sprachbeschreibung
[3] EDIABAS: API-Schnittstellenbeschreibung
[4] EDIABAS: Fehlerreferenz
190
EDIABAS — BEST/2 FUNKTIONSREFERENZ
INDEX
INDEX
—A— —G—
AdjustKWP2000TesterPrStartComm 25, 30 generateRunError 21
ascii2ascii 17, 31 generateRunError 74
ascii2hex 17, 33 get_battery_voltage 14, 27, 67
atoi 17, 34 get_error 21, 68
ator 18, 35 get_error2 21, 70
atoy 17, 36 get_ignition_voltage 14, 27, 71
get_token 16, 72
get_trap_mask 21, 68, 73
—B— getasciidate 22, 75
bcd2ascii 17, 37 getasciitime 22, 76
bittest 23, 38 getCfgInt 24, 77
bytetest 23, 40 getCfgString 24, 78
getdate 22, 79
getETXblock 25, 80
—C— GetKWP2000Block 25, 81
clear_error 21 gettickcount 22
close_communication 13, 43 gettickcount 83
gettime 22, 84
—D—
—H—
data_to_real 18, 44
datacat 19, 45 hex2ascii 17, 85
dataclear 19, 46
datacmp 19, 47 —I—
datacopy 19, 48
dataerase 19, 49 ifboot 14, 27, 86
datainsert 19, 50 ifgetport 14, 27, 87
datalen 19, 51 ifinfo 14, 88
datarevers 19, 52 ifinfoExt 14, 89
dataset 19, 53 ifloopt 14, 27, 90
doNewInit 21, 54 ifrawmode 14, 28, 91
ifrecv 14, 92
ifrequeststate 14, 28, 93
—E— ifreset 14, 27, 94
enableClampHandling 24, 56 ifsend 14, 95
enableIfhTrace 24, 55 ifsetport 14, 27, 96
enableIgnitionHandling 24, 57 ifsireset 14, 28, 97
enableUbattHandling 24 iftype 14, 98
enableUBattHandling 58 ifvers 14, 28, 99
incProgressPos 15, 100
INITIALISIERUNG 10
—F— isDebugLevel 24, 101
fclose 20, 59 isSimulation 24, 102
fopen 20, 60 itoad 17, 103
fread 20, 61 itoax 17, 104
freadln 20, 62 itor 18, 105
fseek 20, 63
fseekln 20, 64 —M—
ftell 20, 65
ftellln 66 make_error 21
ftelln 20
191
EDIABAS — BEST/2 FUNKTIONSREFERENZ
INDEX
—R— —V—
real_to_data 18, 110 var_result_data 15, 184
realadd 18, 111 var_result_long 15, 185
realcomp 18, 112 var_result_real 15, 186
realdiv 18, 113 var_result_string 15, 187
realmul 18, 114
realresult 18, 115 —W—
realsub 18, 116
recv_frequent 13, 27, 117 wait 22, 188
recv_keybytes 13, 26, 118 waitex 22, 189
rtoa 18, 119
rtoi 18, 120
—S—
send_and_receive 13, 26, 121
send_frequent 13, 27, 122
set_answer_length 123
set_communication_pars 13, 26, 126
set_program_voltage 14, 27, 153
set_repeat_counter 13, 154
set_trap_mask 21, 68, 155
set_variable_result 15
setProgressRange 15, 159
shdataget 19, 160
shdataset 19, 161
stop_frequent 13, 27, 162
strcat 16, 163
strcmp 16, 164
strcpy 16, 165
strcut 16, 166
strerase 16, 167
strinsert 16, 168
strlen 16, 169
strncpy 16, 170
strrevers 16, 171
—T—
tab_suche_index 23, 173
tab_suche_unsigned 23, 174
tab2fix 23, 172
Tabellen 179, 180
192