EDIABAS (Электронная диагностическая базовая система). tefko, март 2008 2. Введение 2.1. Об этом руководстве Это руководство описывает, как работать с EDIABAS (Электронная диагностическая базовая система). 2.2. Символьные соглашения В руководстве используются следующие типографические соглашения: Пример SAMPL. C apiJob, APIREADY expression [option] {result | argument} [constant…] job… hallo = “Test” ; while () { . .} [1] Описание Заглавными знаками обозначаются названия файлов, регистры и команды операционных систем. Жирно выделенный тип обозначает ключевые слова и операторы языка BEST/2 и BEST/s так же, как и API функции. Эти слова должны быть написаны точно, как указано в синтаксических описаниях. Курсивом обозначается поле для значений, вводимых программистом, например, имена файлов. Слова, заключенные в квадратные скобки, могут иметь смысл специальных опций Фигурные скобки и вертикальный штрих характеризуют возможность выбора из нескольких данных. В условиях использования для обозначения квадратных скобок, возможности выбора нет. Эллипсис (три точки), который, в основном, следует за выражением, указывающим на то, что за ним может следовать перечисление подобных выражений. Это примеры синтаксических обозначений, данные пользователя, выполнение программы и сообщения об ошибках. Колонка или ряд, включающие три точки, указывают на то, что примерный ряд был преднамеренно упущен. Ссылка на документ в ссылках. 1 2.3. Специальные характеристики, условия, акронимы Объяснения сокращений, использующиеся в этом и всех других руководствах EDIABAS, могут быть найдены в главе «Глоссарий». 2.4 Торговые марки Microsoft, MS-DOS, WINDOWS, WIN32, Pocket PC – зарегистрированные торговые марки Корпорации Microsoft. SCO, SCO UNIX и OpenServer – зарегистрированные торговые марки Santa Cruz Operation, Inc. QNX – зарегистрированная торговая марка QNX Software System Ltd. 3. Основная часть 3.1. Диагностика и кодирование блоков управления В разработке блока управления принимали участие поставщики автомобильной промышленности, сами работники автомобильных производств и разного рода подрядчики. Блоки управления, разработанные и тестируемые поставщиками, особым образом кодируются, тестируются и устанавливаются на автомобиль на производстве. Кодирование специфично для каждого автомобильного блока управления и осуществляется через его диагностические интерфейсы. Функциональные свойства автомобиля проверяются в условиях производства. Всякий раз, когда случается ошибка, причина ошибки устанавливается и устраняется с помощью «Электронной диагностики» в условиях использования компьютерных тестирующих систем. После доставки машины в магазин, ошибки, возникающие в рамках программы «Проверка и Услуга», устраняются в самом магазине с помощью «Электронной диагностики». Когда блок управления обмениваются в магазине, дефектное устройство исправляется производителем. А функциональные свойства машины тестируются с помощью «Электронной диагностики». Блоки управления должны быть вновь перекодированы на стадии установки их в машины, согласно спецификации автомобиля. В согласии с таким жизненным циклом, кодирование и тестирование блоков управления часто повторяющаяся и предписанная обязательная работа для: ■ Разработки блоков управления ■ Тестирования блоков управления в испытательных лабораториях ■ Тестов на испытательных машинах ■ Производства блоков управления ■ Окончательной проверки блоков управления ■ Установки и проверки блоков управления на этапе предварительной сборки ■ Кодирования блоков управления в условиях использования машины ■ Тестирования функций автомобиля ■ Окончательной проверки автомобиля ■ Обслуживания и отладки в условиях сервисных центров ■ Замены и перепрограммирования в условиях магазина ■ Ремонта блоков управления 3.2. Постановка задачи 2 Если речь вести о большом количестве блоков управления, в частности, разработанных и поставленных разными производителями для нескольких модельных рядов автомобилей, то наблюдается чрезвычайно высокий процент разброса результатов работы блоков управления; такой разброс в т. ч. обусловлен сменой элементов машины (подсистем) в течение жизненного цикла серии автомобилей. Например, двигатели используются в нескольких разных конструкциях машин одной серии. Из-за постоянного обновления и технических изменений блоков управления, сильно увеличилась модификация в кодировании и тестировании систем (модификация, пуск, тест). При этом лавинообразно увеличилось количество технической документации, и повысился риск получить ошибку. Из-за интенсивного «расщепления» задач и последовательных операций в больших компаниях, вышеописанные шаги приведут к возникновению многокомпонентных процессов, происходящих в сервисных центрах, из-за расширения разработок блоков управления на производствах. Связь с блоками управления Разработка Лабораторные тесты Испытуемые машины Связь Заданные условия Производство диагностическое кодирование в условиях End-of-line Связь Заданные условия Сервисный центр Сервисное тестирование Анализ ошибок Связь Заданные условия Автомобиль Рис. 3.2 -1: Предварительное положение Кодирующие и тестирующие программы индивидуально создаются в различных областях: у разработчиков блоков управления; в лабораториях тестирования; на этапе предварительного производства; в сервисных центрах; в центрах ремонта блоков управления. Это значит, что, основываясь на документации, имеющей отношение к блокам управления, этапы развития (или продвижение вперед) и испытания программ неоднократно повторяются! Явные различия в определениях работы и целей отдельных этапов, нарушают некую общность (взаимность) в рассмотрении одного и того же компонента блока управления. 3.3 Подходы к решению проблем Идентичные части системы, о которых упоминалось выше, могут быть использованы неоднократно всеми прикладными программами, следующими за неповторяющейся фазой разработки. Это подводит нас к понятию типа «операционная система», 3 разработанной для связи с блоком управления, причем, для каждого блока управления предусмотрены соответствующие «драйверы связи». Разработка Лабораторные тесты Испытуемые машины Производство диагностическое кодирование в условиях End-of-line Сервисный центр Сервисное тестирование Ошибки анализа Общая базисная связь Автомобиль Рис. 3.3-1: Требуемое положение Однако, подобно тому, как обычные операционные системы скрывают информацию за специальными функциями (например, при определении доступа к жесткому диску/к экрану), эта «операционная система» также скрывает точную информацию о доступе к блоку управления. Такая «операционная система» не фиксируется на прикладных программах или даже на комбинированных диапазонах данных. Вместо них это обеспечивается «сервисами». Эти сервисы могут выходить из прикладных программ и последовательно работать (когда требуется) независимо от них. Результаты такого «сервиса», полученные в их конечном виде, уже могут применяться. Прикладная программа (Клиент) и операционная система (Сервер) только обмениваются сообщениями и данными друг с другом. Сервер переводит ряды данных, полученные из блока управления в символьную форму, в которой прикладная программа их запрашивает. Скорость 2000 UPM КЛИЕНТ 4 СЕРВЕР БЛОК УПРАВЛЕНИЯ 010110101 Рис.3.3-2: Компилятор функции В этом процессе сам сервер не оснащен собственным «интеллектом», но имеет определенный запас информации об индивидуальных блоках управления в легко изменяемых модулях данных (даже в условиях реального времени). Эти модули данных содержат полную (или только требуемую) информацию о переводе бинарных данных блока управления в символьные. Каждый Клиент (или прикладная программа) обеспечивается интерфейсом программного обеспечения, который скрывает зависимую от операционной системы часть для обмена сообщениями под единым (однородным) процедурным интерфейсом. Некоторые прикладные программы могут сообщать свои задания серверу в доли секунды, настолько быстро, насколько прикладная программа освобождает сервер, и следующее ожидающее задание может быть выполнено. 3.4. Осуществление решений с помощью EDIABAS Все подходы к решению проблемы, о которой говорилось выше, сводятся к применению EDIABAS. EDIABAS может рассматриваться как «операционная система для связи с блоками управления в архитектуре: Клиент/Сервер». Однако, употребление термина «операционная система» может несколько смущать, и в этом случае к общему базису для других прикладных программ можно использовать термин «Базисная система». Такая «Базисная система» в «Электронной диагностике» называется: EDIABAS – Электронная Диагностическая Базисная Система. 3.5. Структура EDIABAS системы. имеет фиксированную структуру, не зависимую от работы операционной Прикладная программа EDUABAS-API Описание файлов Блока управления 5 EDIABAS в системе реального времени Последовательный контроль Описание файла интерпретатора блока управления (SGBD интерпретатор) Отладчик интерфейса (IFH) Блок управления Рис. 3.5-1: Структура EDIABAS Рис. 3.5-1 иллюстрирует базисную структуру индивидуальных субкомпонентов так же, как и данных путей связи. Специфичные знания EDIABAS для блока управления хранятся в файлах описания блока управления (SGBDs). Файл описания блока управления (БУ) создается «различно ориентированным», т. е. для каждого варианта блока управления существует только один файл описания, специфичный именно для данного БУ. Главное, что файл описания группы блоков управления может существовать для всех типов БУ одной группы (в основном, это блоки с несколькими адресами), тот вариант группы, который связан с диагностическим , может быть определен с помощью методов, содержащихся в этом файле. Файлы описания блоков управления загружаются и интерпретируются EDIABAS под руководством прикладной программы. Имя файла описания БУ (не расширение) является именем, с которым прикладные программы ссылаются или на какой-то один вид блока управления или на группу блоков управления. DME DMEV1 DMEV2 DMEV3 Рис. 3.5-2: Файл описания блока управления и файл описания группы блоков управления 6 The main constituent of EDIABAS is the "runtime system". This runtime system can be subdivided into three essential parts: Основная составляющая EDIABAS – это система "runtime system" (система «времени исполнения»). Эта система времени исполнения может быть подразделена на три основные части: 1. Sequence control (kernel) 2. ECU description file interpreter (SGBD Interpreter) 3. Interface Handler (IFH) 1. Последовательный контроль (kernel) 2. Файл интерпретатор описания блока управления (SGBD интерпретатор) 3. Отладчик интерфейса (IFH) Sequence Control determines the behavior of the entire system and contains the communication interface to the application programs. It is responsible for the file and error management. Последовательный контроль определяет поведение всей системы и содержит интерфейс связи с прикладной программой. Он ответственен за файл и исправление ошибок. The ECU description file interpreter (SGBD Interpreter) converts the binary ECU data into symbolic data. It interprets the data, files, methods and sequences contained in the ECU description file, initializes the communication with the ECU and returns the self-determined results of the sequential control for forwarding to application program. Файл интерпретатор описания блока управления (SGBD интерпритатор) переводит бинарные данные блока управления в символьные. Он интерпретирует данные, файлы, методы и последовательности, содержащиеся в файле описания блока управления, инициализирует связь с блоком управления и возвращает полученные результаты последовательного контроля дальше для прикладной программы . Отладчик интерфейса (IFH) обменного модуля программного обеспечения, зависящий от работы интерфейса аппаратного устройства, может быть интегрирован в различные версии самим пользователем. Данные, запрашиваемые для блока управления, перемещаются Отладчиком интерфейса в задание для текущего прикладного аппаратного интерфейса. Данные возвращаются из интерфейса и соответственно фильтруются от интерфейс-зависимых частей, и таким образом, могут быть оценены, не зависимо от используемого аппаратного интерфейса. Даже ошибки, возвращаемые из интерфейса, стандартизируются по сообщениям внутренних ошибок. Отладчик интерфейса обеспечивает симуляцию БУ. Таким образом, прикладные программы, основанные на EDIABAS, могут быть также протестированы, The Interface Handler (IFH) is an exchangeable software module which, depending on the hardware interface employed, can be integrated in various versions by the user. A data request to the ECU is transposed by the Interface Handler into a job for the currently applied hardware interface. The data returned from this interface are appropriately filtered from interface-dependent parts and, in this way, can be evaluated independent of the interface hardware used. Even the errors returned from the interface are standardized to the internal error messages. In addition, the Interface Handler provides simulation of ECUs. Thus, EDIABAS-based application programs can also then be tested when the applied ECUs do not exist. 7 когда применяемые блоки управления не существуют. In order to simplify access to EDIABAS, a software interface is linked to each application program. This interface controls access to EDIABAS via a predefined procedural interface. This socalled »Application Programming Interface« (EDIABAS-API) handles the system-dependent communication of the runtime system. The data received from the runtime system are managed within the EDIABAS-API for the application program. In this way, the runtime system is freed from managing this data, therefore allowing it to be structured considerably compacter. 3.6. Чтобы упростить доступ к EDIABAS, программное обеспечение соединяется с каждой прикладной программой. Этот интерфейс контролирует доступ EDIABAS через предопределенный процедурный интерфейс. Это так называемый «Интерфейс прикладной программы» (EDIABAS API) обрабатывает системо-зависимые связи в условиях времени исполнения. Данные, полученные из системы времени исполнения, правятся в пределах EDIABAS - API для прикладных программ . В этом случае, система реального времени освобождается от управления этими данными, что позволит структурировать их значительным сжатием. Истолкование задания As already shown in the general approaches of problem-solving, EDIABAS, as Server, offers "services" to the Clients. These services are called Jobs. A job is a self-contained task to read and evaluate data from the ECU. It may be called at any time without consideration of the job sequence (principle of independence). After completing processing, the job returns results which can be used by the application program. The jobs are not permanently programmed in EDIABAS, but are a constituent of the "ECU description files" (SGBDs). They are labeled according to their function; e.g. READ_ERRORMEMORY or READ_ENGINESPEED. There are also jobs which are automatically called by the runtime system and therefore "must" or "may" exist in each description file. These include the job INITIALISIERUNG, (initializes the ECU description file), the optional job ENDE (de-initializes the ECU description file) and the job IDENTIFIK,CATION in a group description Как уже говорилось в разделе «Осуществление решений…», EDIABAS, как Сервер, часто «обслуживается» Клиентом. Эти сервисы называются Заданиями. В самом Задании задача читать и обрабатывать данные БУ. Это может вызываться в любое время без описания последовательности задания (принцип независимости). После завершения процесса, задание возвращает результаты, которые могут быть использованы прикладной программой. Задание не программируется перманентно EDIABAS, а является составной частью «файлов описания блоков управления» (SGBDs). Они получают ярлыки, в соответствии с их функциями; например, READ ERRORMEMORY или READ ENGINESPEED. Это тоже задания, которые вызываются автоматически в системе времени исполнения и, следовательно, «должны» или «могут» существовать в каждом файле описания. Они включают задание INITIALISIERUNG (инициализация 8 file (determines the currently installed ECU файлов описания БУ), дополнительное variant). задание ENDE (деинициализация файлов описания БУ) и задание IDENTIFIK,CATION в группе файлов описания (определение текущего варианта инсталлированного блока управления). 3.7. Описание языка BEST Jobs are formulated in an own description language for ECUs called BEST (BEschreibungssprache für STeuergeräte). This description language exists in two variations. The first variant is a low-level, assembler-similar language called BEST/1. The second variant is the high-language version BEST/2 with 'C'-like syntax. In general, all ECU description files are written in BEST/2. In BEST/2, jobs are defined similar to functions; i.e., a job header exists which lists all I/O parameters. Variables and fields can be defined and used within a job. All necessary arithmetic operators are variable. An extensive library contains functions for manipulating data and communicating with the ECU. The language, itself, contains almost all control structures known by 'C'. The ECU description files defined in this way must be converted into a format which can be read by the runtime system. This must be performed using a compiler (BEST2WIN) prior to use in EDIABAS. On one hand, this occurs because of performance reasons and, on the other hand, so that syntax errors can be excluded during the runtime. Задания формулируются на собственном языке описания для блоков управления, который называется BEST (BEschreibungssprache für STeuergeräte). . Этот язык описания существует в двух версиях. Первая – низкого уровня язык, сходный с ассемблером, названный BEST/1. Вторая – высокого уровня язык, похожий на синтаксис языка «С», названный BEST/2. В основном все описания блоков управления написаны на BEST/2. В BEST/2 задания определены подобно функциям; например, существует заголовок задания, в котором есть перечень всех I/O параметров. Вариации полей могут быть определены и использованы внутри задания. Все необходимые арифметические операторы вариабельны. Обширная библиотека содержит функции для манипулирования с данными и связи с блоком управления. Сам язык содержит почти все структуры контроля, известные в «С». Файлы описания блока управления, определенные таким способом, должны быть переведены в формат, который может быть прочитан в системе реального времени. Это должно быть выполнено с использованием компилятора (BEST/2WIN), имеющего определенные преимущества для использования в EDIABAS. С одной стороны, это встречается по представленным причинам, с другой – синтаксические ошибки могут быть исключены в течение реального времени. 9 The Source Text Debugger BestView is available to test the compiled BEST/2 description files. By means of BestView, the sequence of a job can be exactly tracked: variable contents can be monitored, displayed and modified. 3.8. Ключевой текстовый Отладчик BestVIEW, пригоден для файлов описания, компилированных BEST/2. Посредством BESTView, последовательность заданий может быть точно прослежена: различные составляющие могут быть выведены на монитор и модифицированы. Последовательности A job is issued in the application program by means of the API functions apiJob, apiJobData or apiJobExt. These functions require at least two specifications: First, the ECU to be addressed (or the ECU group) and, second, the job which is to be executed. These two specifications are sent to the EDIABAS runtime system. The runtime system first determines whether this data concerns an ECU "variant" or an ECU "group". If a group was addressed, the job IDENTIFIKATION in the group description file is automatically processed. If a valid ECU variant was determined from the job IDENTIFIKATION, the associated variant file is automatically loaded with the assistance of the result VARIANTE as if the name had already been transferred from the application program. The variant file processes the job requested by the application program. A job may either appear directly in the variant file or in the base file. Base files are ECU description files referenced from the variant file and which can be considered as a part of the variant file. Afterwards, the results of this job are made available to the application program. Whenever a description file is readdressed (i.e. after each change), first the job ENDE of the last loaded ECU decryption file is called. This call is made only when the job ENDE exists in the file. Задание исходит из прикладной программы посредством API функций apiJob, apiJobData или apiJobExt. Эти функции требуют, по крайней мере, две спецификации: первую, адресованную блоку управления (или группе БУ), и вторую задание, которое выполняется. Эти две спецификации отсылаются на EDIABAS в системе реального времени. Система реального времени первая определяет, относятся ли эти данные к «вариантному» блоку управления или к «группе» блоков. Если это адресовано к группе, то автоматически выполняется задание ИДЕНТИФИКАЦИИ в файле описания группы. Если имеет место быть «вариантный» блок управления из задания ИДЕНТИФИКАЦИИ, то ассоциированный вариантный файл автоматически загружается с помощью результата ВАРИАНТА, как если бы имя было уже перенесено из прикладной программы. Вариантный файл выполняет работу, запрашиваемую прикладной программой. Задание может появиться или прямо в вариантном файле или в основном файле. Основные (базовые) файлы это файлы описания БУ, переданных из вариантного файла, и те, которые могут быть рассмотрены как часть вариантного файла. В итоге, результаты такого задания становятся пригодны для прикладной программы. Всякий раз, как файл описания вновь адресуется (например, после каждого изменения), вызывается первое задание ENDE последнего загруженного файла описания БУ. Такой вызов 10 It enables the hardware to be deinitialized. Afterwards the job INITIALISIERUNG is called in the new description file. This job must exist in each description file (obligatory) and can be used to initialize the interface hardware. Only now is the specified job executed. When the same job is called again, no standard job is executed anymore. If an error occurs in one of the subcomponents when processing a job, processing is immediately aborted, and an error message is returned to the application program. In this case, any results are deleted. In this situation, the job INITIALISIERUNG is automatically called again before re-calling the same job. Запрос DME READ SPEED делается только тогда, когда в файле существует задание ENDE. Это дает возможность аппаратному обеспечению быть деинициализированным. После всего, задание INITIALISIERUNG вызывается в новом файле описания. Это задание должно существовать в каждом файле описания (обязательное) и может быть использовано для инициализации интерфейса аппаратного устройства. Только тогда задание выполняется. Когда то же задание вызывается снова, стандартное задание больше не выполняется. Если появляется ошибка субкомпонентов, когда выполняется задание, выполнение немедленно прекращается. И сообщение об ошибке возвращается в прикладную программу. В этом случае, любые результаты удаляются. В такой ситуации задание INITIALISIERUNG автоматически вызывается снова перед новым вызовом того же задания. Запрос DME V3: READ SPEED Определение варианта в файле описания группы блоков управления DME: IDENTIFICATION DME V3: READ SPEED 11 Рис. 3.8 -1: Файл описания блока управления и выбор задания Пока задание выполняется, последовательно интерпретируются его команды. Любой запрос связи с блоком управления продвигается вперед Отладчиком интерфейса и выполняется. Полученные результаты отправляются в прикладную программу. Применение EDIABAS Блок управления int data; apiJob (“DMEV3”, “READ_ SPEED”…) Job (name; READ SPEED; Result: SPEED; type: integer . . .) { char response []; send and receive (response ‘ tel readspeed); -> 59 04 02 03 <- 59 05 03 05 05 SPEED=response [3]*256+ Response [4]; } apiResultInt (&variable, . . . . . .”SPEED”, set); printf (“Speed: %d”,variable); Рис. 3.8-2: Последовательность задания The application results delivered of the function various formats process, data possible. Thus, program can read the from EDIABAS by means apiResultXXX, whereby are supported. In this is converted whenever for example, the result Прикладная программа может читать результаты, полученные EDIABAS посредством функции apiResultХХХ, как бы ни поддерживались различные форматы. В этом процессе данные переводятся всегда, когда это 12 speed (e.g. rpm) which was calculated as integer in the description file can be requested in real format by the application program. 3.9. возможно. Так, например, результат скорости, который был рассчитан как integer (целое число) в файле описания, может быть запрошен в реальном формате прикладной программой. Доступность EDIABAS в системе реального времени и EDIABAS в приложении к развитию окружающей обстановки созданы как легко доступные системы. В настоящее время они доступны для следующих платформ: ■ MS-WINDOWS 95/98/ME/NT4/2000/XP (WIN32) ■ MS-WINDOWS 3.11/95/98/ME (WIN 32) ■ Pocket PC 2002/2003 (WINCE) ■ SCO OpenServer 5 ■ QNX 4.23 Следуя этому руководству, MS-WINDOWS используется для WIN32 и WIN 32. Следуя этому руководству, MS-WINDOWS CE Pocket PC 2003 . Развитие оболочки для файлов описания WINDOWS. используется для Pocket PC 2002 и блоков управления доступно под MS- Следуя этому руководству SCO-UNIX используется для SCO OpenServer 5. 4. Установка и администрирование 4.1. Delivery packages. / Установочные пакеты. A total of three delivery packages are currently available. The scope of function is explained in detail in the following sections: 1. RUNTIME SYSTEM 2. APPLICATION DEVELOPMENT KIT 3. BEST DEVELOPMENT KIT Основные три установочных пакета доступны постоянно. Обзор функции детально расширяется в следующих разделах: 1. 2. 3. Система времени исполнения Пакеты разработки приложения Пакеты наилучшего приложения 4.1.1. Delivery package RUNTIME SYSTEM. / Установочные пакеты в системе времени исполнения. The delivery package RUNTIME SYSTEM available for all systems listed in section "Availability". This package is the basis for all other EDIABAS delivery packages. Установочные пакеты в системе времени исполнения доступны для всех систем, перечисленных в главе «Доступность». Этот пакет является 13 RUNTIME SYSTEM must always be базисным для всех других installed. установочных пакетов EDIABAS. Система времени исполнения должна всегда быть инсталлирована. The delivery package allows application Установочный пакет позволяет programs to run diagnostic sequences via прикладной программе просмотреть EDIABAS диагностические последовательности через EDIABAS. 4.1.1.1. Файлы для WIN 32 The RUNTIME SYSTEM contains the following files: Система реального времени содержит следующие файлы: README32 Замечания по установке (инсталляции) BIN\<Paßwortdatei> Имя пароля файла (8 знаков). Файл не имеет расширения. Example: 07DE3473 BIN\PE.EXE редактор пароля (PE) BIN\ANSI2OEM.TAB Codemapping table BIN\EDIABAS.INI.Example EDIABAS для примера файл конфигурации BIN\EBAS32.DLL EDIABAS система времени исполнения BIN\EBAS32.EXE EDIABAS визуализация BIN\API32.DLL Access to the EDIABAS BIN\API32.DLL Доступ к EDIABAS в runtime system системе времени исполнения BIN\APIVB32.DLL Access to the EDIABAS BIN\APIVB32.DLL Доступ к EDIABAS в runtime system for Visual Basic системе времени исполнения для Visual Basic BIN\TRACEX32.EXE Trace server BIN\TRACEX32.EXE Trace сервер BIN\BESTINFO.EXE Dispaly of BEST BIN\BESTINFO.EXE Отображение object file contents BIN\BESTVER.EXE объектного файла BEST, содержащего Version test of BEST object files BIN\BESTVER.EXE Версия тестовых объектных файлов BEST BIN\XTRACT.EXE Display of the help BIN\XTRACT.EXE Отображение texts of BEST object files текстовых файлов помощи BEST объектных файлов BIN\STRIP.EXE Remove the debug and BIN\STRIP.EXE Устранение отладки и help texts in BEST object files текстов помощи в BEST объектных файлах BIN\IFHSRV32.EXE IFH server for remote BIN\IFHSRV32.EXE IFH сервер diagnostics BIN\NMSIFH32.DLL IFH дистанционной диагностики (удаленной) service for remote diagnostics BIN\NMSIFH32.DLL IFH сервис для дистанционной диагностики README32 Installation notes BIN\<Paßwortdatei> Name of password file (8 characters). The file has no extension. Example: 07DE3473 BIN\PE.EXE Password Editor (PE) BIN\ANSI2OEM.TAB Codemapping table BIN\EDIABAS.INI.Example EDIABAS configuration file example BIN\EBAS32.DLL EDIABAS runtime system BIN\EBAS32.EXE EDIABAS visualization 14 BIN\VMC32.DLL Access to connecting management for remote diagnostics BIN\XEDIC32.DLL EDIC-IFH BIN\XREMOT32.DLL IFH for remote diagnostics BIN\NETTCP32.DLL Communication DLL for remote diagnostics BIN\NETPRO32.DLL Communication DLL for remote diagnostics ECU\TMODE.PRG ECU description file for transparent mode 4.1.1.2. BIN\VMC32.DLL Доступ к управлению связывания для дистанционной диагностики BIN\XEDIC32.DLL EDIC-IFH BIN\XREMOT32.DLL IFH для дистанционной диагностики BIN\NETTCP32.DLL Communication DLL для дистанционной диагностики BIN\NETPRO32.DLL Communication DLL для дистанционной диагностики ECU\TMODE.PRG файл описания БУ для прояснения способа Файлы WIN16 The RUNTIME SYSTEM contains the following files: Система реального времени содержит следующие файлы: README Installation notes BIN\PE.EXE Password Editor (PE) BIN\ANSI2OEM.TAB Codemapping table BIN\EDIABAS.INI EDIABAS configuration file BIN\EDIABASW.EXE EDIABAS runtime system BIN\API.DLL Access to the EDIABAS runtime system BIN\APIVB.DLL Access to the EDIABAS runtime system for Visual Basic README Замечания по установке BIN\PE.EXE Редактор пароля (PE) BIN\ANSI2OEM.TAB Codemapping table BIN\EDIABAS.INI EDIABAS файл конфигурации BIN\EDIABASW.EXE EDIABAS система времени исполнения BIN\API.DLL Доступ к EDIABAS в системе времени исполнения BIN\APIVB.DLL Доступ к EDIABAS в системе времени исполнения для Visual Basic BIN\BESTINFO.EXE Отображение объектного файла BEST, содержащего BIN\BESTVER.EXE Версия BEST тестовых объектных файлов BIN\XTRACT.EXE Отображение текстов помощи BEST объектных файлов BIN\STRIP.EXE Устранение отладок и текстов помощи BEST объектных файлов BIN\XEDIC.DLL EDIC-IFH ECU\TMODE.PRG файл описания БУ для прояснения способа BIN\BESTINFO.EXE Dispaly of BEST object file contents BIN\BESTVER.EXE Version test of BEST object files BIN\XTRACT.EXE Display of the help texts of BEST object files BIN\STRIP.EXE Remove the debug and help texts in BEST object files BIN\XEDIC.DLL EDIC-IFH ECU\TMODE.PRG ECU description file for transparent mode 4.1.1.3. Файлы для WINCE The RUNTIME SYSTEM contains the following files: Система реального времени содержит следующие файлы: 15 BIN\<passwordfile> Name of password file (8 characters). The file has no extension. Example: 07DE3473 BIN\EBASCE.DLL EDIABAS runtime system BIN\APICE.DLL Access to the EDIABAS runtime system BIN\TRCSRVCE.EXE Trace server BIN\VMCCE.DLL Access to connecting management for remote diagnostics BIN\XREMOTCE.DLL IFH for remote diagnostics BIN\NETTCPCE.DLL Communication DLL for remote diagnostics BIN\NETPROCE.DLL Communication DLL for remote diagnostics BIN\<passwordfile> Имя пароля файла (8 знаков). Файл не имеет расширения. Пример: 07DE3473 BIN\EBASCE.DLL EDIABAS система времени исполнения BIN\APICE.DLL Доступ к EDIABAS в системе времени исполнения BIN\TRCSRVCE.EXE Trace сервер BIN\VMCCE.DLL Доступ к управлению связывания для дистанционной диагностики BIN\XREMOTCE.DLL IFH для дистанционной диагностики BIN\NETTCPCE.DLL Связь DLL для дистанционной диагностики BIN\NETPROCE.DLL Связь DLL для дистанционной диагностики 4.1.1.4 Файлы для SCO-UNIX The RUNTIME SYSTEM contains the following files: Система времени исполнения содержит следующие файлы: readme Installation notes install Installation program uinstall Uninstall program profile Profile extension apiset Script to set environment variables readme Замечания к инсталляции install Программа инсталляции uinstall Программа деинсталляции profile Профильное расширение apiset Установка вариабельного окружения /bin/apiboot Запуска EDIABAS /bin/apiclose Завершение EDIABAS /bin/apitest EDIABAS тест-программы /bin/bestinfo Отображение содержимого BESTобъектного файла /bin/devclose Закрытие драйвера интерфейса /bin/pe Редактор паролей /bin/printver Выполнение версии EDIABAS /bin/ebasd EDIABAS симтема времени исполнения /bin/ediabas Программа контроля связи с программным обеспечением /bin/ipc.ini IPC конфигурация файла /bin/ipcctrl.que Файл ссылки /bin/setlog Контроль сообщений инсталляции /bin/tracer EDIABAS tracer /bin/tracer.que Файл ссылки /bin/apiboot Start script for EDIABAS /bin/apiclose End script for EDIABAS /bin/apitest EDIABAS test program /bin/bestinfo Display BEST object file contents /bin/devclose Script to close the interface driver /bin/pe Password editor (PE) /bin/printver Output of EDIABAS version /bin/ebasd EDIABAS runtime system /bin/ediabas Program controlling communication software /bin/ipc.ini IPC configuration file /bin/ipcctrl.que Reference file /bin/setlog Script for controlling the installation messages /bin/tracer EDIABAS tracer /bin/tracer.que Reference file 16 4.1.1.5. Файлы для QNX The RUNTIME SYSTEM contains the following files: Система реального времени содержит следующие файлы: readme Installation notes install Installation program uinstall Uninstall program sysinit.add Extension for system initialization file ediabas.ini EDIABAS configuration file readme Замечания к инсталляции install Программа инсталляции uinstall Программа деинсталляции sysinit.add Расширение для системы инициализации файла ediabas.ini EDIABAS файл конфигурации /bin/apiboot Запуска EDIABAS /bin/apiclose Завершение EDIABAS /bin/apikill Программа прерывания связи с программным обеспечением /bin/apisys Программа для возобновления связи с программным обеспечением /bin/apisys.cfg Файл конфигурации связи с программным обеспечением /bin/apitest EDIABAS тест-программа /bin/apitrace Trace связи с программным обеспечением /bin/bestinfo Отображение содержимого объектного файла BEST /bin/devclose Закрытие драйвера интерфейса /bin/ediabas EDIABASсистема времени исполнения /bin/pe Редактор паролей /bin/pinstall Программа инсталляции /bin/setlog Контроль за сообщениями инсталляции /bin/sigserv Сигнальный сервер /ecu/tmode.prg Файл описания БУ для прояснения метода /bin/apiboot Start script for EDIABAS /bin/apiclose End script for EDIABAS /bin/apikill Program to Stopp communication software /bin/apisys Program to start communication software /bin/apisys.cfg Configuration file of communication software /bin/apitest EDIABAS test program /bin/apitrace Trace of communication software /bin/bestinfo Display BEST object file contents /bin/devclose Script to close the interface driver /bin/ediabas EDIABAS runtime system /bin/pe Password editor (PE) /bin/pinstall Installation program /bin/setlog Script for controlling the installation messages /bin/sigserv Signal server /ecu/tmode.prg ECU description file for transparent mode 4.1.1.6. Документация The following documentation refers to the delivery package RUNTIME-SYSTEM (or to EDIABAS in general): COMMENTS Comments on this version Следующие ссылки в документации пакта поставки Системы реального времени (или, в основном, EDIABAS). COMMENTS Комментарии 17 (optional) к этой версии (опционные) USER MANUAL USER MANUAL INSTALLATION GUIDE This document INSTALLATION GUIDE Этот документ ERROR REFERENCE contains an содержит обзор EDIABAS overview on EDIABAS error messages ERROR REFERENCE сообщений об ошибках ECU SIMULATOR Description of the ECU ECU SIMULATOR Описание Simulator симулятора блока управления 4.1.2. Delivery package APPLICATION DEVELOPMENT Kit. / (Установочный пакет ПАКЕТА РАЗРАБОТКИ приложения) Установочный пакет APPLICATION DEVELOPMENT Kit доступен для всех систем, перечисленных в разделе «Доступность». Этот пакет позволяет разрабатываться прикладной программе, которая использует EDIABAS. The following development systems are Следующие системы разработки supported under MS-WINDOWS: поддерживаются MS-WINDOWS: The delivery package APPLICATION DEVELOPMENT Kit is available for all systems listed in section "Availability". This package allows application programs to be developed which use EDIABAS. ■ Microsoft Visual C/C++ 6.0 (WIN32) ■ Microsoft Visual C/C++ 6.0 (WIN32) ■ Microsoft Visual C/C++ 1.52 (WIN16) ■ Microsoft Visual C/C++ 1.52 (WIN16) ■ Microsoft Visual Basic 6.0 (WIN32) ■ Microsoft Visual Basic 6.0 (WIN32) ■ Microsoft Visual Basic 4.0 (WIN32 and ■ Microsoft Visual Basic 4.0 (WIN32 and WIN32) WIN32) ■ Microsoft Visual Basic 3.0 (WIN16) ■ Microsoft Visual Basic 3.0 (WIN16) The following development systems are Следующие системы разработки available for MS-WINDOWS CE: доступны для MS-WINDOWS CE: ■ Microsoft eMbedded Visual C++ 4.2 SP2 + Pocket PC 2003 SDK (WINCE) ■ Microsoft eMbedded Visual C++ 3.0 + Pocket PC 2002 SDK (WINCE) ■Microsoft eMbedded Visual C++ 4.2 SP2 + Pocket PC 2003 SDK (WINCE) ■Microsoft eMbedded Visual C++ 3.0 + Pocket PC 2002 SDK (WINCE) 18 4.1.2.1. Файлы для WIN32 The APPLICATION DEVELOPMENT KIT contains the following files: APPLICATION DEVELOPMENT Kit (Пакет разработки приложения) содержит следующие файлы: README32.ADK Installation notes README32.ADK Замечания к инсталляции API\WIN32API.H General C/C++ Главные файлы для всех библиотек API\WIN32\APICALLS.C C/C++ исходный код APIW32.LIB и APIW32MT.LIB API\WIN32\APIDLL.H C/C++ главный файл для API32.DLL (Windows-DLL-Interface) API\WIN32\VC60\APIW32.LIB APIБиблиотека для одиночного-Thread API\WIN32\VC60\APIW32MT.LIBAPIБиблиотека для мульти -Thread API\ WIN32\VB60\API.BAS Basic-Modul для Visual Basic 6.0 API\ WIN32\VB40\API.BAS Basic-Modul для Visual Basic 4.0 BIN\APITST32.EXE EDIABAS проверка приложения ECU\TESTG.PRG Пример для файлов описания группы БУ ECU\TESTV.PRG Пример для файла описания варианта БУ API\WIN32API.H General C/C++ header files for all libraries API\WIN32\APICALLS.C C/C++ source code of APIW32.LIB and APIW32MT.LIB API\WIN32\APIDLL.H C/C++ header file for API32.DLL (Windows-DLL-Interface) API\WIN32\VC60\APIW32.LIB API-Library for single-Thread API\WIN32\VC60\APIW32MT.LIBAPILibrary for multi-Thread API\ WIN32\VB60\API.BAS Basic-Modul for Visual Basic 6.0 API\ WIN32\VB40\API.BAS Basic-Modul for Visual Basic 4.0 BIN\APITST32.EXE EDIABAS test application ECU\TESTG.PRG Example for group description file ECU\TESTV.PRG Example for variant description file 4.1.2.2. Файлы для WIN16 The APPLICATION DEVELOPMENT KIT contains the following files: APPLICATION DEVELOPMENT Kit (Пакет разработки приложения) содержит следующие файлы: README.ADK Installation notes API\WIN16\API.H General C/C++ header files for all libraries README.ADK IЗамечания к инсталляции API\WIN16\API.H General C/C++ Главный файл для всех библиотек API\WIN16\APICALLS.C C/C++ исходный код APIW.LIB API\WIN16\APIDLL.H C/C++ Главный файл для API.DLL(WINDOWS-DLLInterface) API\WIN16\VC15\APIW.LIB APIБиблиотека для Microsoft Visual C++ 1.52 (Большая модель) API\ WIN16\VB30\API.BAS Basic-Modul для Visual Basic 3.0 API\WIN16\APICALLS.C C/C++ source code of APIW.LIB API\WIN16\APIDLL.H C/C++ header file for API.DLL (WINDOWS-DLL-Interface) API\WIN16\VC15\APIW.LIB API-Library for Microsoft Visual C++ 1.52 (Large Model) API\ WIN16\VB30\API.BAS Basic-Modul for Visual Basic 3.0 19 API\ WIN16\VB40\API.BAS Basic-Modul for Visual Basic 4.0 BIN\APITESTW.EXE EDIABAS test application ECU\TESTG.PRG Example for group description file ECU\TESTV.PRG Example for variant description file API\ WIN16\VB40\API.BAS Basic-Modul для Visual Basic 4.0 BIN\APITESTW.EXE EDIABAS проверка приложения ECU\TESTG.PRG Пример для файла описании группы БУ ECU\TESTV.PRG Пример для описания варианта БУ 4.1.2.3. Datein unter WINCE The APPLICATION DEVELOPMENT KIT contains the following files: API\WIN32API.H General C/C++ header files for all libraries API\\APICE.LIB APILibrary APPLICATION DEVELOPMENT Kit (Пакет разработки приложения) содержит следующие файлы: API\WIN32API.H General C/C++ Главные файлы для всех библиотек API\\APICE.LIB API-Библиотека 4.1.2.4. Файлы для SCO-UNIX The following files are contained on the delivery diskette APPLICATION DEVELOPMENT KIT and are copied to the target system. следующие файлы содержатся на дискете поставки APPLICATION DEVELOPMENT Kit (пакета разработки приложения) и копируются в целевую систему: readme Installation notes install Installation program /api/cc/api.c Source file for producing libapi.a /api/cc/apiipc.c Source file for producing libapi.a /api/cc/callback.c Source file for producing libapi.a /api/cc/errors.c Source file for producing libapi.a /api/cc/errortxt.c Source file for producing libapi.a /api/cc/help.c Source file for producing libapi.a /api/cc/job.c Source file for producing libapi.a /api/cc/jobdata.c Source file for producing libapi.a /api/cc/results.c Source file for producing libapi.a /api/cc/sco.c Source file for producing readme Замечания к инсталляции install Программа инсталляции /api/cc/api.c Исходный файл для создания libapi.a /api/cc/apiipc.c Исходный файл для создания libapi.a /api/cc/callback.c Исходный файл для создания libapi.a /api/cc/errors.c Исходный файл для создания libapi.a /api/cc/errortxt.c Исходный файл для создания libapi.a /api/cc/help.c Исходный файл для создания libapi.a /api/cc/job.c Исходный файл для создания libapi.a /api/cc/jobdata.c Исходный файл для создания libapi.a /api/cc/results.c Исходный файл для создания libapi.a /api/cc/sco.c Исходный файл для 20 libapi.a /api/cc/trace.c Source file for producing libapi.a /api/include/api.h INCLUDE file for producing libapi.a /api/include/apimsg.h INCLUDE file for producing libapi.a /api/include/aspekte.h INCLUDE file for producing libapi.a /api/include/ bip.h INCLUDE file for producing libapi.a /api/include/callback.h INCLUDE file for producing libapi.a /api/include/config.h INCLUDE file for producing libapi.a /api/include/ediabas.h INCLUDE file for producing libapi.a /api/include/error.h INCLUDE file for producing libapi.a /api/include/help.h INCLUDE file for producing libapi.a /api/include/job.h INCLUDE file for producing libapi.a /api/include/jobdata.h INCLUDE file for producing libapi.a /api/include/kernel.h INCLUDE file for producing libapi.a /api/include/msgipc.h INCLUDE file for producing libapi.a /api/include/results.h INCLUDE file for producing libapi.a /api/include/sco.h INCLUDE file for producing libapi.a /api/include/sigserv.h INCLUDE file for producing libapi.a /api/include/trace.h INCLUDE file for producing libapi.a /api/include/traceapi.h INCLUDE file for producing libapi.a /api/include/typedef.h INCLUDE file for producing libapi.a /api/include/unixdef.h INCLUDE file for producing libapi.a /api/include/version.h INCLUDE file for producing libapi.a /api/lib/libapi.a API library /api/make/makefile MAKE file for producing libapi.a /api/obj/aspwrap.o Object file for producing libapi.a /api/obj/cfg.o Object file for producing libapi.a /api/obj/dynamic.o Object file for producing libapi.a /api/obj/log.o Object file for producing создания libapi.a /api/cc/trace.c Исходный файл для создания libapi.a /api/include/api.h Включенный файл для создания libapi.a /api/include/apimsg.h Включенный файл для создания libapi.a /api/include/aspekte.h Включенный файл для создания libapi.a /api/include/ bip.h Включенный файл для создания libapi.a /api/include/callback.h Включенный файл для создания libapi.a /api/include/config.h Включенный файл для создания libapi.a /api/include/ediabas.h Включенный файл для создания libapi.a /api/include/error.h Включенный файл для создания libapi.a /api/include/help.h Включенный файл для создания libapi.a /api/include/job.h Включенный файл для создания libapi.a /api/include/jobdata.h Включенный файл для создания libapi.a /api/include/kernel.h Включенный файл для создания libapi.a /api/include/msgipc.h Включенный файл для создания libapi.a /api/include/results.h Включенный файл для создания libapi.a /api/include/sco.h Включенный файл для создания libapi.a /api/include/sigserv.h Включенный файл для создания libapi.a /api/include/trace.h Включенный файл для создания libapi.a /api/include/traceapi.h I Включенный файл для создания libapi.a /api/include/typedef.h Включенный файл для создания libapi.a /api/include/unixdef.h Включенный файл для создания libapi.a /api/include/version.h Включенный файл для создания libapi.a /api/lib/libapi.a API библиотека /api/make/makefile Сделанный файл для создания libapi.a /api/obj/aspwrap.o Объектный файл для создания libapi.a /api/obj/cfg.o Объектный файл для создания libapi.a /api/obj/dynamic.o Объектный файл для создания libapi.a /api/obj/log.o Объектный файл для 21 libapi.a /api/obj/process.o Object file for producing libapi.a /api/obj/profile.o Object file for producing libapi.a /api/obj/psig.o Object file for producing libapi.a /api/obj/scolib.o Object file for producing libapi.a /api/obj/svmsg.o Object file for producing libapi.a /api/obj/tracesco.o Object file for producing libapi.a /api/obj/watchdog.o Object file for producing libapi.a 4.1.2.5. создания libapi.a /api/obj/process.o Объектный файл для создания libapi.a /api/obj/profile.o Объектный файл для создания libapi.a /api/obj/psig.o Объектный файл для создания libapi.a /api/obj/scolib.o Объектный файл для создания libapi.a /api/obj/svmsg.o Объектный файл для создания libapi.a /api/obj/tracesco.o Объектный файл для создания libapi.a /api/obj/watchdog.o Объектный файл для создания libapi.a Файлы для QNX The following files are contained on the delivery diskette APPLICATIONDEVELOPMENT-KIT and are copied to the target system. readme Installation notes install Installation program /api/cc/api.c Source file for producing libapi.a /api/cc/apiipc.c Source file for producing libapi.a /api/cc/callback.c Source file for producing libapi.a /api/cc/errors.c Source file for producing libapi.a /api/cc/errortxt.c Source file for producing libapi.a /api/cc/help.c Source file for producing libapi.a /api/cc/job.c Source file for producing libapi.a /api/cc/jobdata.c Source file for producing libapi.a /api/cc/qnx.c Source file for producing libapi.a /api/cc/results.c Source file for producing libapi.a /api/cc/trace.c Source file for producing libapi.a /api/include/api.h INCLUDE file for producing libapi.a /api/include/apimsg.h INCLUDE file for producing libapi.a /api/include/aspekte.h INCLUDE file for Следующие файлы содержатся на дискете поставки APPLICATION DEVELOPMENT Kit (пакета разработки приложения) и копируются в целевую систему: readme Замечания к инсталляции install Программа инсталляции /api/cc/api.c Исходный файл для создания libapi.a /api/cc/apiipc.c Исходный файл для создания libapi.a /api/cc/callback.c Исходный файл для создания libapi.a /api/cc/errors.c Исходный файл для создания libapi.a /api/cc/errortxt.c Исходный файл для создания libapi.a /api/cc/help.c Исходный файл для создания libapi.a /api/cc/job.c Исходный файл для создания libapi.a /api/cc/jobdata.c Исходный файл для создания libapi.a /api/cc/qnx.c Исходный файл для создания libapi.a /api/cc/results.c Исходный файл для создания libapi.a /api/cc/trace.c Исходный файл для создания libapi.a /api/include/api.h Включенный файл для создания libapi.a /api/include/apimsg.h Включенный файл для создания libapi.a /api/include/aspekte.h Включенный файл 22 producing libapi.a /api/include/ bip.h INCLUDE file for producing libapi.a /api/include/callback.h INCLUDE file for producing libapi.a /api/include/config.h INCLUDE file for producing libapi.a /api/include/ediabas.h INCLUDE file for producing libapi.a /api/include/error.h INCLUDE file for producing libapi.a /api/include/help.h INCLUDE file for producing libapi.a /api/include/job.h INCLUDE file for producing libapi.a /api/include/jobdata.h INCLUDE file for producing libapi.a /api/include/kernel.h INCLUDE file for producing libapi.a /api/include/msgipc.h INCLUDE file for producing libapi.a /api/include/qnx.h INCLUDE file for producing libapi.a /api/include/results.h INCLUDE file for producing libapi.a /api/include/sigserv.h INCLUDE file for producing libapi.a /api/include/trace.h INCLUDE file for producing libapi.a /api/include/traceapi.h INCLUDE file for producing libapi.a /api/include/typedef.h INCLUDE file for producing libapi.a /api/include/unixdef.h INCLUDE file for producing libapi.a /api/include/version.h INCLUDE file for producing libapi.a /api/lib/libapi.a API library /api/make/makefile Make file for producing libapi.a /api/obj/aspekte.o Object file for producing libapi.a /api/ecu/testg.prg Test group description file /api/ecu/testv.prg Test variant description file 4.1.2.6. для создания libapi.a /api/include/ bip.h Включенный файл для создания libapi.a /api/include/callback.h Включенный файл для создания libapi.a /api/include/config.h Включенный файл для создания libapi.a /api/include/ediabas.h Включенный файл для создания libapi.a /api/include/error.h Включенный файл для создания libapi.a /api/include/help.h Включенный файл для создания libapi.a /api/include/job.h Включенный файл для создания libapi.a /api/include/jobdata.h Включенный файл для создания libapi.a /api/include/kernel.h Включенный файл для создания libapi.a /api/include/msgipc.h Включенный файл для создания libapi.a /api/include/qnx.h Включенный файл для создания libapi.a /api/include/results.h Включенный файл для создания libapi.a /api/include/sigserv.h Включенный файл для создания libapi.a /api/include/trace.h Включенный файл для создания libapi.a /api/include/traceapi.h Включенный файл для создания libapi.a /api/include/typedef.h Включенный файл для создания libapi.a /api/include/unixdef.h Включенный файл для создания libapi.a /api/include/version.h Включенный файл для создания libapi.a /api/lib/libapi.a API lбиблиотека /api/make/makefile Сделанный файл для созданя libapi.a /api/obj/aspekte.o Объектный файл для создания libapi.a /api/ecu/testg.prg Файл описания тест группы БУ /api/ecu/testv.prg Файл описания тест варианта БУ Документация The following documentation refers to the delivery package APPLICATION Следующие ссылки на документацию пакета поставки APPLICATION 23 DEVELOPMENT KIT: API USER MANUAL Description of how the API libraries are used. Sample programs. Operation of the APITEST program. API INTERFACE Description of the API interface and how to operate it. API FUNCTION REFERNCE Description of the API functions TRANSPARENT MODE Description of the interface for transparent mode INTERFACE DESCRIPTION Transparent mode 4.1.3. DEVELOPMENT Kit (пакета разработки приложения): API USER MANUAL Описание, как пользоваться библиотекой API Образец программ. Операции APITEST программы. API INTERFACE Описание API интерфейса, и как работать с ним. API FUNCTION REFERNCE Описание API функций TRANSPARENT MODE Описание интерфейса для прояснения метода INTERFACE DESCRIPTION Прояснение метода Установочный пакет BEST DEVELOPMENT KIT (Пакет разработки BEST) The delivery package BEST DEVELOPMENT KIT is only available for MS-WINDOWS. This package allows ECU description files to be developed. Установочный пакет BEST DEVELOPMENT KIT (Пакет разработки BEST) доступен только для MSWINDOWS. Этот пакет позволяет разработать файлы описания блоков управления. The delivery package comprises, among other toolsBEST/2 Compiler, BEST/2 Установочный пакет содержит среди Debugger and BEST development других инструментов компилятор environment. BEST/2, отладчик BEST/2 и BEST разработчик оболочки. The following files are contained on the delivery diskette BEST DEVELOPMENT Следующие файлы содержатся на KIT: дискете установки BEST DEVELOPMENT KIT (Пакета разработки BEST): 4.1.3.1. Файлы для WIN32 The delivery package BESTDEVELOPMENT-KIT contains the following files Пакет поставки BEST DEVELOPMENT KIT (Пакета разработки BEST) содержит следующие файлы: README32.BDK README32.BDK Замечания к инсталляции BIN\BEST2WIN.EXE Компилятор BEST/2 BIN\BEST2WIN.HLP Файл помощи для компилятора BEST/2 BIN\B2RUNTIM.LIB библиотека времени исполнения BEST/2 BIN\BESTVW32.EXE Отладчик BEST/2 : BestView BIN\BESTVW32.HLP Файл помощи для Installation notes BIN\BEST2WIN.EXE BEST/2 compiler BIN\BEST2WIN.HLP Help file for BEST/2 compiler BIN\B2RUNTIM.LIB BEST/2 runtime library BIN\BESTVW32.EXE BEST/2 debugger: BestView BIN\BESTVW32.HLP Help file for BEST/2 24 debugger BIN\BESTBD32.EXE BEST development environment: BestBoard BIN\RUN1632.EXE Help program for BestBoard BIN\RUN16.EXE Help program for BestBoard BIN\APITST32.EXE EDIABAS test application BIN\APITAL32.EXE EDIABAS test application BIN\JOBLOO32.EXE EDIABAS test application ECU\TMODE.B1V ECU description file for transparent mode (source code) ECU\TESTG.B1G Example group description file, BEST/1 ECU\TESTV.B2V Example variant description file, BEST/2 TUTORIAL\*.* BEST-tutorial files 4.1.3.2. отладчика BEST/2 BIN\BESTBD32.EXE Разработка окружения BEST: BestBoard BIN\RUN1632.EXE Программа помощи для BestBoard BIN\RUN16.EXE Программа помощи для BestBoard BIN\APITST32.EXE Проверка приложения EDIABAS BIN\APITAL32.EXE Проверка приложения EDIABAS BIN\JOBLOO32.EXE Проверка приложения EDIABAS ECU\TMODE.B1V Файл описания БУ для прояснения метода (исходный код) ECU\TESTG.B1G Пример файла описания группы БУ, BEST/1 ECU\TESTV.B2V Пример файла описания варианта БУ, BEST/2 TUTORIAL\*.* BEST-обучающие файлы Файлы для WIN16 The delivery package BESTDEVELOPMENT-KIT contains the following files: Установочный пакет BEST DEVELOPMENT KIT (Пакета разработки BEST) содержит следующие файлы: README.BDK Installation notes BIN\BEST2WIN.EXE BEST/2 compiler BIN\BEST2WIN.HLP Help file for BEST/2 compiler BIN\B2RUNTIM.LIB BEST/2 runtime library BIN\BESTVIEW.EXE BEST/2 debugger: BestView BIN\BESTVIEW.HLP Help file for BEST/2 debugger BIN\BESTBRD.EXE BEST development environment: BestBoard BIN\APITESTW.EXE EDIABAS test application BIN\APITALKW.EXE EDIABAS test application BIN\JOBLOOPW.EXE EDIABAS test application ECU\TMODE.B1V ECU description file for transparent mode (source code) ECU\TESTG.B1G Example group description file, BEST/1 ECU\TESTV.B2V Example variant README.BDK Замечания к инсталляции BIN\BEST2WIN.EXE Компилятор BEST/2 BIN\BEST2WIN.HLP Файл помощи для компилятора BEST/2 BIN\B2RUNTIM.LIB BEST/2 библиотека времени исполнения BIN\BESTVIEW.EXE отладчик BEST/2: BestView BIN\BESTVIEW.HLP Файл помощи для отладчика BEST/2 BIN\BESTBRD.EXE Разработка окружения BEST: BestBoard BIN\APITESTW.EXE Проверка приложения EDIABAS BIN\APITALKW.EXEПроверка приложения EDIABAS BIN\JOBLOOPW.EXE Проверка приложения EDIABAS ECU\TMODE.B1V Файл описания БУ для прояснения метода (исходный код) ECU\TESTG.B1G Пример файла описания группы БУ, BEST/1 ECU\TESTV.B2V Пример файла описания варианта БУ, BEST/2 25 description file, BEST/2 TUTORIAL\*.* BEST-tutorial files 4.1.3.3. TUTORIAL\*.* BEST-обучающие файлы Документация The following documentation refers to the delivery package BEST-DEVELOPMENTKIT: Следующие ссылки на документацию установочного пакета BEST DEVELOPMENT KIT (Пакета разработки BEST): BEST USER MANUAL Programming description of a BEST/2 Description file. How to operate the supplied programs. BEST USER MANUAL Программное описание BEST/2 файла описания. Как работать с поддерживающими программами. BEST/2 FUNCTION REFERENCE Description of the BEST/2 function BEST/2 FUNCTION REFERENCE Описание BEST/2 функции BEST/2 LANGUAGE DESCRIPTION Syntactic description of the BEST/2 language. BEST/2 LANGUAGE DESCRIPTION Описание синтаксиса языка BEST/2. 4.2. Системные требования 4.2.1. MS-WINDOWS In order to use EDIABAS under MSWINDOWS, the following requirements must be meet: IBM PC/AT or 100% compatible system with at least an 80386 processor For EDIABAS RUNTIME SYSTEM WIN32 for MS-WINDOWS 95/98/ME a network installation is required. For the remote function of the EDIABAS RUNTIME SYSTEM for WIN32 a network installation with TCP/IP is required. Для того, чтобы использовать EDIABAS под MS-WINDOWS, необходимо выполнение системных требований. IBM PC/AT или 100% совместимую систему с процессором 80386 и выше Для EDIABAS RUNTIME SYSTEM WIN32 для MS-WINDOWS 95/98/ME требуется инсталляция сети. Для дистанционной функции EDIABAS системы времени исполнения для WIN32 требуется инсталляция сети с TCP/IP. 4.2.2. MS-WINDOWS CE In order to use EDIABAS under MSWINDOWS CE, the system requirements has to be meet. A Pocket PC 2002/2003 compatible Для того, чтобы использовать EDIABAS под MS-WINDOWS СЕ, необходимо выполнение системных требований. Pocket PC 2002/2003, совместимый с 26 system is required. системой For EDIABAS RUNTIME SYSTEM for WINCE a network installation of TCP/IP is required. Для EDIABAS системы реального времени для WINCE требуется сеть инсталляции TCP/IP. 4.2.3. SCO-UNIX In order to user EDIABAS under SCOUNIX, a computer system which satisfies the following requirements is required: Для того, чтобы использовать EDIABAS под SCO-UNIX, необходимо, чтобы система отвечала следующим требованиям: IBM-PC or 100% compatible with at least a IBM-PC или хотя бы 100% 80486 processor совместимость с процессором 80486 ■SCO OpenServer 5 ■12 MB RAM ■3.5-in diskette drive (5.25-in on request) ■ SCO OpenServer 5 ■ 12 MB RAM ■ 3.5 – в дискете (5.25 – в запросе ) 4.2.4. QNX IBM-PC or 100% compatible with 80386 processor or higher Компьютерная система, которая удовлетворяет следующим требованиям, необходимым для того, чтобы использовать EDIABAS под QNX: IBM-PC или 100% совместимость с процессором типа 80386 или выше ■ QNX 4.23 ■12 MB RAM ■3.5" diskette drive ■ QNX 4.23 ■ 12 MB RAM ■ 3.5 дискета A computer system which satisfies the following requirements is required in order to use EDIABAS under QNX: 4.3. Установка в первый раз 4.3.1. MS-WINDOWS Установка руководства для MS-WINDOWS не является частью этой документации. 4.3.2. SCO-UNIX All shell scripts listed in this chapter require the kernel shell for execution. IMPORTANT: Pre-installed EDIABAS Все сценарии оболочки требуют для выполнения ядро оболочки. Важно: 27 software version 1.3.0 or later can automatically be removed during the installation (optional). Older EDIABAS versions, however, must manually be deleted PRIOR TO installing the new EDIABAS RUNTIME SYSTEM (see also readme file). The step-by-step procedure is subsequently listed. 1. Log in as Root or Super-User login root Предварительно установленная версия EDIABAS в программное обеспечение версии 1.3.0 или более позднее может быть автоматически удалена в ходе инсталляции (опционной). Однако, более поздние версии EDIABAS при инсталляции новой версии EDIABAS RUNTIME SYSTEM (системы времени исполнения) должны удаляться непосредственно под руководством PRIOR TO. 1. Зарегистрируйтесь как или Супер-пользователь Корень Login root (зарегистрированный корень) 2. Copy and install the (new) EDIABAS RUNTIME SYSTEMs 2. Скопируйте и установите (новый) EDIABAS RUNTIME SYSTEM (система времени исполнения) Вызовите “install” (замените накопитель для '?') mount/dev/fd?135ds18 /mnt /mnt/install/mnt umount /dev/fd?135ds18 Cконфигурируйте EDIABAS, используя (смотри конфигурацию EDIABAS) файл конфигурации EDIABAS ediabas.ini Пример: ;EDIABAS sampl configuration in ediabas.ini (образец конфигурации) [Configuration] interface =EDIC EcuPath = /usr/ediabas/ecu TracePath =/usr/ediabas SimulationPath =/usr/ediabas/ecu Apitrace=0 ifhTrace=0 Simulation=0 3. Copy and install the (new) APPLICATION DEVELOPMENT KITs 3. Скопируйте и установите (новый) APPLICATION DEVELOPMENT Kit (пакета разработки приложения) Вызовите “instal” (замените накопитель для '?') 28 mount/dev/fd?135ds18 /mnt /mnt/install/mnt umount /dev/fd?135ds18 4.3.3. QNX 1. Log in as either Root or Super-User login root 1. Зарегистрируйтесь или Корень или как администратор как Login root (зарегистрированный) 2. Copy and install the EDIABAS RUNTIME SYSTEM After inserting the diskette "EDIABAS RUNTIME SYSTEM", invoke 'install' (substitute the drive for '?'): 2.Скопируйте и установите (новый) EDIABAS RUNTIME SYSTEM (Системы времени исполнения) После того, как дискета вставлена “EDIABAS RUNTIME SYSTEM”, вызывайте “instal” (замените накопитель для '?'): mount /dev/fd? /mnt /mnt/install /mnt umount /mnt mount/dev/fd? /mnt /mnt/install/mnt umount /mnt You will be prompted during the installation whether EDIABAS is to automatically be started each time the system is booted. If EDIABAS is to beautomatically started, 'install'. Accordingly adapts the system initialization file sysinit.<node. В процессе установки вам будет даваться подсказка, запускается ли автоматически EDIABAS всякий раз, когда система загружена. Если EDIABAS дважды автоматически запускается, то появляется “instal”. Согласно адаптации система инициализирует файл sysinit.<node>. EDIABAS requires the message queue server 'Mqueue' from QNX. This must first be run BEFORE starting EDIABAS. EDIABAS требует сообщение очередного сервера “Mqueue” из QNX. Это должно придти до запуска EDIABAS. Example for starting 'Mqueue' in sysinit.<node>: Пример для sysinit.<node>: /bin/mqueue & Configure EDIABAS via the configuration file /etc/ediabas.ini (see EDIABAS configuration). запуска “Mqueue” в /bin/mqueue & Сконфигурируйте EDIABAS через файл конфигурации /etc/ediabas.ini (см. Конфигурацию EDIABAS). Пример: [Configuration] EcuPath = /usr/ediabas/ecu 29 TracePath =/usr/ediabas SimulationPath =/usr/ediabas/ecu Apitrace=0 ifhTrace=0 Simulation=0 3. Copy and install the APPLICATION DEVELOPMENT KIT After inserting the diskette "EDIABAS APPLICATION DEVELOPMENT KIT", invoke 'install' (substitute the drive for '?'): mount /dev/fd? /mnt /mnt/install /mnt umount /mnt 3. Скопируйте и установите APPLICATION DEVELOPMENT Kit (пакета разработки приложения) После того, как дискета вставлена “EDIABAS APPLICATION DEVELOPMENT Kit” (пакета разработки приложения), вызывайте “instal” (замените накопитель для '?'): mount/dev/fd? /mnt /mnt/install/mnt umount /mnt 4.4. Программные пути EDIABAS 4.4.1. MS-WINDOWS Субдиректория BIN EDIABAS должна быть введена для поискового пути системы. Пример для AUTOEXEC.BAT: SET OLDPATH=%PATH% PATH=c:\ediabas\bin;%OLDPATH% 4.4.2. SCO-UNIX Субдиректория “bin” EDIABAS автоматически вводится в поисковый путь. 4.4.3. QNX Поисковый путь остается неизменным в течение инсталляции. Полный путь должен быть определен, когда вызывается программа EDIABAS. 4.5. Конфигурации EDIABAS The EDIABAS runtime behavior can be influenced via the EDIABAS configuration. Поведение времени исполнения EDIABAS может зависеть от конфигурации EDIABAS. The EDIABAS configuration consists of Конфигурация EDIABAS состоит из 30 information pairs which are listed in the area [Configuration] of file EDIABAS.INI. In this process, each line here describes a configuration element and its configuration setting: информационных пар, которые перечислены в области [Configuration] EDIABAS.INI. В этом процессе каждая строка здесь описывает элемент конфигурации и установку его конфигурации. Configurationelement = Configurationsetting Элемент конфигурации конфигурации The configuration settings are read from file EDIABAS.INI when EDIABAS is first initialized. The default setting (see Table section 4.5.1) is assumed when configuration settings are missing or when file EDIABAS.INI does not exist. Установки конфигурации читаются из файла EDIABAS.INI, когда EDIABAS впервые инициализируется. Отсутствие установок (см. раздел 4.5.1) принимается, когда расположения конфигурации отсутствуют или когда EDIABAS.INI не существует. All modifications of configurations in EDIABAS.INI must be made manually. NOTE: Modifications are only valid after EDIABAS has been re-started. = Установка Все модификации конфигурации в EDIABAS.INI должны быть сделаны вручную. ПРИМЕЧАНИЕ: Модификации действительны только после перезапуска EDIABAS. Certain configuration elements can also be Определенные элементы конфигураций modified at EDIABAS runtime by могут быть также модифицированы application programs. прикладными программами в течение времени исполнения EDIABAS. NOTE: These configuration changes only ПРИМЕЧАНИЕ: Эти изменения remain valid until EDIABAS is re-initialized. конфигурации остаются действительными только до тех пор, пока EDIABAS не будет заново инициализирована. Even ECU description files can modify Даже БУ может модифицировать configuration values during EDIABAS значения конфигурации в течение runtime. NOTE: These values are only времени исполнения EDIABAS. valid, however, during the job. ПРИМЕЧАНИЕ: Однако, эти значения действительны только в течение выполнения задания. 4.5.1. Последовательность поиска EDIABAS.INI Under MS-WINDOWS EDIABAS first searches for file EDIABAS.INI corresponding environment variable EDIABAS_CONFIG_DIR. If the environment variable was not set or file was not found in the directory, search is made in the Windows directory. If the file Под MS-WINDOWS первичные поиски EDIABAS для файла EDIABAS.INI осуществляются в соответствии с вариабельной окружающей средой EDIABAS_CONFIG_DIR. Если вариабельная окружающая среда не была размещена, или файл не был 31 was not found in the windows directory, обнаружен в директории, то поиск search was made in the EDIABAS осуществляется в директории program directory (subdirectory BIN). WINDOWS. Если файл не был найден в директории WINDOWS, то поиск необходимо вести в программной директории (директории BIN). Under SCO-UNIX and QNX EDIABAS first searches for file EDIABAS.INI corresponding environment variable EDIABAS_CONFIG_DIR. If the environment variable was not set or file was not found in the directory, search is made in the directory /etc. If the file was not found in the directory /etc, search was made in the EDIABAS program directory (subdirectory BIN). Под SCO-UNIX и QNX EDIABAS первичные поиски для файла EDIABAS.INI осуществляются в соответствии с вариабельной окружающей средой EDIABAS_CONFIG_DIR. Если вариабельная окружающая среда не была размещена, или файл не был обнаружен в директории, то поиск осуществляется в директории/etc. Если файл не был найден в директории/etc, то поиск необходимо вести в программной директории (директории BIN). 4.5.2. Обзор конфигурации All configuration elements are listed below along with setting options and default values. Все элементы конфигурации, перечисленные ниже, указаны с опциями размещения и отсутствующими значениями. Each configuration element contains a description whether and how a modification is to be made (INI: via EDIABAS.INI, API: by application, BEST: by ECU description file). Каждый элемент конфигурации содержит описание, где и как была сделана модификация (INI: через EDIABAS.INI, API: посредством приложения, BEST: файлом описания блока управления). Все элементы конфигурации сведены в таблице в разделе КОНФИГУРАЦИЯ. Элемент ApiTrace Примечание Контроль API Trace Размещение 0 (OFF) 1 пользователь trace 2+ время маркировки 3+ процесс ID** 4 API trace 5+ время маркировки 6+ время исполнения 7+процесс ID** 8 отладка trace Изменение Отсутствие INI API BEST 0 32 Уровень отладки в файле описания блока управления Путь файла описания блока управления Путь используемого файла конфигурации EDIABAS.INI (только, если такой существует) Версия EDIABAS Контроль IFH Trace 0….32767 INI API BEST 0 Path (Путь) INI API BEST . Path (Путь) INI API BEST Ряд (String) 0 (OFF) 1пользовательинтерфейса 2+ интерфейс 3+время маркировки INI API BEST INI API BEST 0 IfhnTrace Контроль IFH-network-trace Только действительный XREMOTE 0 (aus) 1 пользователь интерфейса 2+ интерфейс 3+ время маркировки INI API BEST 0 IfhVersion Interface Версия IFH Интерфейс аппаратного устройства Отладчик зажигания (ON/OFF) как ошибка Выбор системы EDIABAS для WIN16-применений Ряд Ряд INI API BEST INI API BEST EDIC 0 (OFF)….1(ON) INI API BEST 1 0 (EDIABAS для WIN16) … 1 (EDIABAS для WIN32) INI API BEST Выбор протокола сети для диагностик дистанционного управления Повторение ошибки связи Контроль симуляции блока управления Путь файлов симуляции блока управления Контроль загрузки: зажигание, установленное напряжение и статус задания – результаты системы Приоритетное размещение EDIABAS (0=оптимальное размещение, 1=наименьший приоритет) Путь Trace файлов Макс.размер Trace файлов в КВ Путь файла кодовой страницы (только с конверсией кода) Отладчик установл. Напряжения (ON/OFF) TCP INI API BEST WINDOWS 9*/ME: 0 WINDOWS NT/2000/xp:1 _ 0(OFF)..1(ON) 0(OFF)..1(ON) INI API BEST INI API BEST 1 0 Путь INI API BEST . 0(нет загрузки) … 1(есть загрузка) INI API BEST 1 0-10 INI API BEST 0 Путь 0…32767 Путь INI API BEST INI API BEST INI API BEST . 1024 . 0(OFF)…1(ON) INI API BEST 1 BipDebugLevel EcuPath EdiabasIniPath EdiabasVersion IfhTrace IgnitionHandling LoadWin32 NetworkProtocol RetryComn Simulation SimulationPath SystemResults TaskPriority TracePath TraceSize CodeMapping UbattHandling с **Примечание: процесс ID обозначается только с EDIABAS для WIN32. Элементы конфигурации для протокола сети ТСР (выборТСР) перечислены в следующей таблице. Этот раздел требуется только тогда, когда значение ТСР задаются элементам конфигурации NetworkProtocol (Протокол сети) в разделе Конфигурация. Элемент Порт RemoteHost TimeoutConnect TimeoutReceive Примечание Номер порта Имя или IP адрес дистанцион. системы Перерыв на миллисекунды для установочной связи Перерыв на миллисекунды размещение 1000..3000 Выбор Отсутствие - Имя/адрес INI API BEST INI API BEST 1000…59000 INI API BEST 5000 1000…59000 INI API BEST 5000 - 33 для получения сообщения Перерыв на Zeit в миллисекунды между отправкой сообщений. Не поддерживается УВШФИФЫ М 6.4.0 Перерыв на миллисекунды для длинной функции IFH (для примера send_and_receive). Полный перерыв: TimeoutFunction + timeoutReceive. Имя или IP адрес компьютера, дистанционно контролируемого TimeResponsePending 500…59000 INI API BEST 2000 TimeoutFunction 5000…59000 INI API BEST 59000 Имя/адрес INI API BEST - RemoteHost 4.5.3. Подбор интерфейса аппаратного устройства 4.5.4. MS-WINDOWS The hardware interface has to be set in the Интерфейс аппаратного устройства configuration file EDIABAS.INI (Interface). должен размещаться в конфигурации файла EDIABAS. INI (Interface). The following hardware interfaces are Следующие интерфейсы аппаратного currently supported: устройства распространенно поддерживаются: ■ SOFTING EDIC ■ SOFTIC EDIC The corresponding interface driver is NOT Соответствующий драйвер интерфейса a constituent of the delivery package не является составной частью RUNTIME SYSTEM установочного пакета RUNTIME STSTEM (системы времени исполнения) 4.5.5. SCO-UNIX В версии SCO-UNIX драйвер интерфейса аппаратного устройства не может быть размещен (Соответствующее размещение Interface в EDIABAS.INI игнорируется). И это не является частью RUNTIME STSTEM (времени исполнения). 4.5.6. QNX В версии QNX драйвер интерфейса аппаратного устройства не может быть размещен (Соответствующее размещение Interface в EDIABAS.INI игнорируется). И это не является частью RUNTIME STSTEM (времени исполнения). 4.5.7. Директория файлов описания блока управления Директория файлов описания блока управления (ссылка на SGBDs) заполняется вручную в EDIABAS.INI (EcuPath) 4.5.8. Character Set Conversion. / Особенность установки конверсии The representation of characters not Представление особенностей, не defined in the 7-bit ASCII character set определенных в 7-bit ASCII (таких, как ö 34 (such as ö or ä) depends on the code table used by the operating system. If SGBDs are developed on a computer different from the target computer and the computers do not use the same code table, the representation of the EDIABAS result string may differ in the two computers. This problem can be avoided with the EDIABAS configuration CodeMapping. A code page to be defined with this configuration (file with 256 characters) is loaded in the program memory when EDIABAS is started and causes all EDIABAS result strings to be automatically converted to the desired character format. The code page ANSI2OEM.TAB, which is part of the delivery, converts the ANSI (Windows) character set into the OEM (DOS) character set. For the conversion, each character of an EDIABAS result string is replaced by the corresponding character from the code page. For conversion, the character to be replaced is used as an index which points to the new character on the code page. и ä), зависят от кода таблицы, используемого операционной системой. Если SGBDs разрабатывается на компьютере, отличном от целевого компьютера и компьютеров, не использующих такие же коды таблицы, полученные ряды результатов могут расходиться на разных компьютерах. Эту проблему можно решить с помощью конфигурации EDIABAS CodeMapping. Код страницы, будучи определенным с помощью этой конфигурации (файл с 256 символами), загружается в память программы, когда запускается EDIABAS, и все ряды результатов EDIABAS автоматически переводятся в требуемый формат. Код страницы ANSI2OEM.TAB, который является частью поставки, переводит особенность установки ANSI (Windows) в особенность установки OEM(DOS). Для конверсии каждое свойство (или символ?) рядов результатов EDIABAS переносится, чтобы использоваться как индекс, который назначает новое свойство на кодовой странице. Пример: ANSI Character Set (Windows) ANSI особенности установки(Windows) G (0x47) E (0x45) R (0x52) Ä (0xc4) T (0x54) OEM Character Set (Dos) OEM особенности установки (Dos) G (0x47) E (0x45) R (0x52) Ä (0x8E) T (0x54) Для перевода, например, свойства Ä из ANSI в OEM, код 0хс4 должен быть заменен на 0х8Е. Для свойств, которые не дублируются (не копируются) в другом коде, используется “.” 4.5.9. WIN16/32-Umsetzung Для операционных систем Windows 9x/ME/NT4/2000/XP автоматическая конверсия вызовов EDIABAS/WIN16 в вызовы EDIABAS/WIN32 возможна. ■ ЗагрузкаWin32=0 35 Используем EDIABAS/WIN16 ■ ЗагрузкаWin32=1 Использование EDIABAS/WIN32 с конверсией всех API вызовов. 4.6. Start and terminate EDIABAS./ Запуск и завершение EDIABAS. 4.6.1. WIN32 When an application with access on EDIABAS is started the following components are loaded automatically: API32.DLL, EBAS32.DLL, EBAS32.EXE and TRACEX32.EXE. EBAS32.DLL loads the interface handler. Access of applications to EDIABAS takes place via API32.DLL. Когда происходит обращение к EDIABAS, следующие компоненты загружаются автоматически: API32.DLL, EBAS32.DLL, EBAS32.EXE и TRACEX32.EXE. EBAS32.DLL загружает отладчик интерфейса. Доступ к приложению EDIABAS производится через API32.DLL. 4.6.2. WIN16 The first time an application accesses EDIABAS, EDIABASW.EXE is automatically started. EDIABASW.EXE subsequently loads the configured Interface Handler. EDIABASW.EXE is accessed by applications via API.DLL. В первый раз доступы к приложению EDIABAS, EDIABASW.EXE загружаются автоматически. EDIABASW.EXE последовательно загружает отладчик конфигурированного интерфейса. EDIABASW.EXE доступен приложением через API.DLL 4.6.3. WINCE Когда происходит обращение к EDIABAS, компоненты EDIABAS APICE.DLL, EBASCE.DLL и TRCSRVCE.EXE загружаются автоматически. В течение первого доступа к EDIABAS, EBASCE.DLL загружает отладчик конфигурированного интерфейса. Access of applications to EDIABAS takes Обращение к EDIABAS идет через place via APICE.DLL. APICE.DLL. When an application with access to EDIABAS is started, the EDIABAS components APICE.DLL, EBASCE.DLL and TRCSRVCE.EXE are automatically loaded. During the first access to EDIABAS, EBASCE.DLL loads the configured Interface Handler. 4.6.4. SCO-UNIX After installing EDIABAS (see "Installing from diskette for the first time"), shut down and re-boot the system. After installation, EDIABAS will После установки EDIABAS (см. ‘’Установка с дискеты в первый раз’), закройте и перезапустите систему. После установки EDIABAS будет 36 automatically be booted and shut down by the system. The EDIABAS configuration file ediabas.ini is only read once the first time an application program is accessed. EDIABAS is accessed by applications via the library libapi.a. which is bounded to the application program. Normally, EDIABAS is started up or shut down automatically during the corresponding system processes. In addition, EDIABAS can be manually started up or shut down with Super-User authorization. Manual EDIABAS startup (if EDIABAS does not run yet): /usr/ediabas/bin/apiboot автоматически закрываться и загружаться. Файл конфигурации EDIABAS ediabas.ini читается однократно только первый раз прикладной программой, которая имеет доступ. EDIABAS доступен к приложению через библиотеку libapi.a., которая связывается с прикладной программой. Нормально, если EDIABAS автоматически запускается или закрывается во время работы соответствующих процессов системы. В добавление следует сказать, что EDIABAS может быть запущен вручную или закрыт самим пользователем. Руководство EDIABAS запускается (если EDIABAS еще не работает): /usr/ediabas/bin/apiboot Manual EDIABAS shutdown (if EDIABAS Руководство EDIABAS закрывается is already running): (если EDIABAS уже работает): /usr/ediabas/bin/apiclose /usr/ediabas/bin/apiclose 4.6.5. QNX If EDIABAS was selected to automatically Если EDIABAS был выбран для start during the installation, the system автоматического запуска в ходе must be re-started. установки, система должна быть перезапущена. Otherwise, EDIABAS must be manually В противном случае EDIABAS должен started (with Super-User access rights): быть запущен вручную (с помощью прав /usr/ediabas/bin/apiboot доступа самого пользователя). The EDIABAS configuraiton file ediabas.ini Файл конфигурации EDIABAS ediabas.ini is read only once the first time the читается однократно только первый раз application is accessed. доступной прикладной программой. Applications access EDIABAS via the Приложение EDIABAS доступно только library libapi.a.linked to the application через библиотеку libapi.a, связанную с program. прикладной программой. Normally, EDIABAS must not be Нормально, что EDIABAS не должен terminated. If, however, this is necessary, завершаться. Однако, если это the instruciton below can be used: необходимо, то могут пригодиться /usr/ediabas/bin/apiclose инструкции, изложенные ниже: /usr/ediabas/bin/apiclose 37 4.7. Un-install. / Деинсталляция. When un-installed, all EDIABAS delivery Когда идет деинсталляция, все пакеты packages are removed from the system. поставки EDIABAS удаляются из системы. Subdirectory ECU (or ecu under SCO- Субдиректории блока управления (или UNIX) containing the ECU description files блоки управления под SCO-UNIX), is only deleted when this is requested by содержащие файлы описания БУ, the user. The subdirectory ECU and the удаляются пользователем тогда, когда residing ECU description files are это требуется. Субдиректории БУ и generally not deleted. основные файлы описания БУ, в основном, не удаляются. 4.7.1. MS-WINDOWS Руководство деинсталляции (Un-install) не является частью этой документации. 4.7.2. MS-WINDOWS CE Руководство деинсталляции (Un-install) не является частью этой документации. 4.7.3. SCO-UNIX Программное обеспечение EDIABAS может быть деинсталлировано, с использованием программы UNINSTALL. Все программы, которые имеют доступ к EDIABAS, должны быть завершены до того, как программное обеспечение будет деинсталлировано. EDIABAS software is to be removed in the Программное обеспечение EDIABAS following way: удаляется следующим способом: 1. Log in as Root or Super-User 1. Зарегистрируйтесь как корень или login root администратор login root EDIABAS software can be un-installed using the program UINSTALL. All programs which access EDIABAS must be terminated prior to un-installing software. 2. Stop any active EDIABAS software and delete the EDIABAS software using uinstall /usr/ediabas/uinstall The un-install program uinstall allows EDIABAS software to be removed without removing the ECU description files (optional). WARNING: Softing-external software in the directory /usr/ediabas will be deleted! Always assure in advance that this is stored in another directory. 3. Delete all API or EDIABAS entries in /etc/profile. 2. Остановите любое действие программного обеспечения EDIABAS и удалите программное обеспечение EDIABAS, используя деинсталляцию /usr/ediabas/uinstall Un-install программа позволяет программному обеспечению EDIABAS быть удаленным без удаления файлов описания блоков управления ( ) Внимание: Softing-external программное обеспечение в директории /usr/ediabas, будет удалено! Всегда убедитесь в том, что это переместилось и сохранилось в другой директории. 3. Удалите все API или данные EDIABAS в /etc/profile. 38 4.7.4. QNX Программное обеспечение EDIABAS может быть деинсталлировано, с использованием программы UNINSTALL. Перед деинсталляцией программного обеспечения, все программы, которые доступны к EDIABAS, должны быть завершены в первую очередь. Программное обеспечение EDIABAS деинсталлируется следующим способом: 1. Log in as Root or Super-User 1. Зарегистрируйтесь как корень или login root администратор login root 2. Stop any active EDIABAS software, and 2. Остановите любое действие delete EDIABAS software using uinstall программного обеспечения EDIABAS и /usr/ediabas/uinstall удалите программное обеспечение EDIABAS, используя деинсталляцию /usr/ediabas/uinstall IMPORTANT: First assure that no Softing- Важно! Сначала удостоверьтесь, что external software resides in the directory Softing-external не в директории /usr/ediabas, since this will also be deleted! /usr/ediabas, поскольку это будет также удалено! The EDIABAS software can be un-installed using the program UINSTALL. Before uninstalling the software, all programs which access EDIABAS must be terminated first. The EDIABAS software is to be un-installed again in the following manner: 4.8. Механизм защиты EDIABAS accesses ECU description files (SGBDs) for processing API jobs (see chapter 3). ECU description files are developed as source code (B2V-, or B2G file) in BEST/2 and subsequently compiled into an object format (PRG-, or GRP file) using the BEST compiler for use with EDIABAS. The object files are loaded and executed at runtime by the runtime system. In order to protect ECU description files in object format, EDIABAS offers a protection mechanism. This mechanism not only prevents unauthorized reading of file contents (job names, table names, table contents, etc.) but also prevents unauthorized use by users (non-authorized external companies or private persons). The ECU description files are protected in two ways: EDIABAS имеет доступ к файлам описания блоков управления для выполнения задания API (см. гл. 3). Файлы описания БУ разработаны как исходный код (B2V-, или B2G файлы) в BEST/2, и последовательно компилированы в целевой формат (PRG-, или GRP файлы), с использованием компилятора BEST для пользования EDIABAS. Целевые файлы загружаются и используются на время исполнения системой исполнения. Для защиты файлов описания блока управления в целевом формате, EDIABAS предлагает защитный механизм. Этот механизм предотвращает не только неразрешенное чтение содержания файлов (название задания, названия таблиц, содержимое таблиц и т. д.), но также защищает от неразрешенного использования пользователями (внешними компаниями, не имеющих разрешения, или частными лицами). Файлы описания блока управления защищаются двумя способами: 39 1) File information is coded and1)not written in plain-language text and 2) the file cannot run under a nonauthorized EDIABAS runtime system; i.e. it cannot be loaded by EDIABAS. Thus, information cannot be read from the ECU description files, and jobs within cannot be executed. After the installation, the EDIABAS runtime system first assumes a state in which only unprotected ECU description files can be executed. ECU description files are protected by means of passwords specified for the runtime system and for the ECU description files. Passwords for the runtime system are specified using the Password Editor (PE) (see section 5.3), whereas passwords in the ECU description files are entered using the BEST compiler BEST2WIN (see BEST User Manual sections 5.1 and 5.2). NOTE: Only the programs PE and BEST2WIN included in the current EDIABAS installation can be used for specifying passwords. To protect an EDIABAS system, perform the following two steps: 1. In order to protect the EDIABAS runtime system, system passwords must be defined (at least one) using the Password Editor (see section 5.3). 2. Next, all ECU description files used must be compiled with at least one password from the list of the passwords entered above (see BEST user Manual, sections 5.1 and 5.2). At runtime, the data read when loading the ECU description file must first be decoded. Afterwards, the runtime system checks whether one of the passwords from the ECU description file is known by the runtime system. If the runtime system recognizes at least one password from the ECU description file, the ECU description file can be executed. The EDU description files which are not protected with a password can be executed from every 1)Информация файла кодируется и не пишется простым текстовым языком; 2)Файл не может читаться в системе времени исполнения EDIABAS, т. е. не может загружаться EDIABAS. Таким образом, информация не может быть прочитана из файлов описания блоков управления, и задание не будет выполнено. После инсталляции система времени исполнения EDIABAS присваивает себе в первую очередь положения, в которых только незащищенные файлы описания блоков управления могут быть использованы. Файлы описания БУ защищены особым паролем для системы времени исполнения и для файлов описания БУ. Пароль для системы времени исполнения создается с помощью Редактора паролей (Password Editor) (см. гл. 5.3), тогда как пароль для файлов описания БУ вводится на языке BEST с помощью компилятора BEST2WIN (см. 5.1 и 5.2). Примечание: Только программы Password Editor и BEST2WIN, включенные в текущую инсталляцию EDIABAS, могут быть использованы для спецификации паролей. Чтобы защитить систему EDIABAS, предпринимаются следующие шаги: 1. Для защиты системы времени исполнения EDIABAS, должна быть установлена система паролей (по крайней мере, одна) с использованием РЕ (см. 5.3). 2. Следующий шаг, все использующиеся файлы описания БУ должны быть компилированы, по меньшей мере, с одним паролем из перечисленных выше паролей (см. BEST в 5.1 и 5.2). Во времени исполнения данные читаются после того, как загруженные файлы описания БУ будут декодированы. Впоследствии, система времени исполнения проверяет, известен ли ей пароль файла описания БУ. Если система времени исполнения узнаёт хотя бы один пароль файлов описания БУ, то файлы описания выполняются. Файлы описания БУ, которые не защищены паролем, могут 40 EDIABAS runtime system (protected or использоваться только в системе not) beginning with version 5.5 времени исполнения EDIABAS (защищенные или нет), начиная с версии 5.5 4.9. Remote diagnostics. / Дистанционная диагностика. EDIABAS for WIN32/CE allows access to diagnostic interfaces and, consequently, cabled ECUs which are connected to another PC. This requires a network connection of local and remote-controlled PC via TCP/IP as well as a WIN32 operating system supported by EDIABAS. The application and EDIABAS run on the local PC, whereas the Interface Handler (IFH) as well as the IFH server run on the remote-controlled PC. Before the remotecontrolled PC can be accessed, the IFH server IFHSRV32.EXE must be started first. The remote control is enabled or controlled via the EDIABAS configuration file EDIABAS.INI. EDIABAS is configured manually on both PCs. The EDIABAS configuration parameters TracePath and SimulationPath are not transmitted to the remote-controlled PC from the local PC. Instead, the corresponding configuration parameters of file EDIABAS.INI (contained on the remote-controlled PC) are used. The network protocol TCP (entry NetworkProtocol) as well as a userselectable port number is to be specified on both PCs. The port number must be identical on both PCs and must not collide with the other TCP applications (1000 < port number < 30000). EDIABAS для WIN32/CE позволяет иметь доступ к диагностическим интерфейсам и, следовательно, передавать БУ, которые связываются с другими компьютерами. Это требует сеть связи локальных или удаленных компьютеров через TCP/IP так же, как и операционная система WIN32, поддерживаемая EDIABAS. Применение и чтение EDIABAS на локальном компьютере происходит так же, как и на удаленных контролируемых компьютерах, где есть отладчик интерфейса Interface Handler (IFH) или IFH сервер. До того, как удаленные контролируемые компьютеры могут быть доступными, должен быть первым запущен IFH сервер IFHSRV32.EXE. Дистанционный контроль осуществляется через файлы конфигурации EDIABAS EDIABAS.INI. EDIABAS вручную конфигурируется на обоих компьютерах (локальном и удаленном). Параметры конфигурации EDIABAS TracePath и SimulationPath не передаются на удаленный контролируемый компьютер с локального. Вместо этого, используются соответствующие параметры конфигурации EDIABAS.INI (содержащиеся на дист. контр. ПК.). Протокол сети TCP (данные NetworkProtocol протокола сети) так же, как и номер порта избранного пользователя, определяются на обоих компьютерах. Номер порта должен быть одинаковым на обоих ПК и не должен сталкиваться с другими приложениями ТСР (1000<номер порта<3000). 4.9.1. EDIABAS.INI on the local PC. / EDIABAS.INI на локальном компьютере The configuration file EDIABAS. INI must Файлы be edited on the local PC in accordance должны конфигурации EDIABAS.INI быть отредактированы на 41 with the list depicted below. The assignment REMOTE to the configuration element Interface causes remote control of the PC, which is specified with the entry RemoteHost. Specification of a logical computer name requires a corresponding HOSTS file or a DNS service. локальном ПК в соответствии с перечнем, описанном ниже. Передача REMOTE (Дистанц.) элементам конфигурации интерфейса вызывает дистанционный контроль ПК, которые определяются с данными RemoteHost. Спецификация логического имени компьютера требует соответствующих файлов HOSTS или сервисов DNS. [Configuration] Interface = REMOTE NetworkProtocol = TCP [TCP] RemoteHost = <Name/addresses of remote-controlled PC> Port = <Port from remote-controlled IFH> TimeoutConnect=<Timeout for connection setup> TimeoutReceive=<Timeout for Receive> TimeoutFunction=<Timeout for IFH > Пример EDIABAS.INI для локального ПК: [Configuration] Interface=REMOTE NetworkProtocol=TCP [TCP] RemoteHost=193.29.29.175 Port=5000 TimeoutConnect=2000 TimeoutReceive=2000 TimeoutFunction=50000 4.9.2. EDIABAS.INI on the remote-controlled PC. / EDIABAS.INI на дист-контр ПК Файл конфигурации EDIABAS.INI должен быть расширен на дист. контр. ПК в соответствии с перечнем, изложенным ниже. Configuration file EDIABAS.INI must be extended on the remote-controlled PC in accordance with the list depicted below. [Configuration] Interface=<Interface> NetworkProtocol=TCP [TCP] Port=<Port of the remote-controlled IFH> Пример EDIABAS.INI дист. контр. ПК: 42 [Configuration] Interface=EDIC NetworkProtocol=TCP [TCP] Port=5000 4.9.3. Procedure for remote diagnostics. / Процедура для дистанционной диагностики 1. Install EDIABAS on the local or remotecontrolled PC. 2. Install the EDIABAS configuration on the local and remote-controlled PC. 3. Start the IFH server on the remotecontrolled PC. 4. Start the application on the local PC. 1. Инсталляция EDIABAS на локальный или дист.контр. ПК. 2. Инсталляция конфигурации EDIABAS на локальный или дист.контр. ПК. 3. Запуск IFH сервера на дист.контр. ПК. 4. Запуск приложения на локальном ПК. 4.10. EDIABAS Parallel Operation. / Параллельные операции EDIABAS. EDIABAS for WIN32/CE and SCO-UNIX enable different application programs to access EDIABAS at the same time. In contrast to the other EDIABAS platforms, WIN32/CE and SCO-UNIX has no single one EDIABAS which runs all application programs consecutively. Instead, a separate EDIABAS runs for each application program and if nec. is started (and under WIN32/CE) finished automatically. Parallel operation of several interfaces of the same type is only possible if this is supported by the corresponding interface software. Under SCO-UNIX up to 64 application programs may access on EDIABAS at the same time. EDIABAS для WIN32/CE и SCO-UNIX дает возможность иметь доступ к EDIABAS в одно время нескольким различным прикладным программам. Для других же платформ EDIABAS WIN32/CE и SCO-UNIX не имеют отдельного EDIABAS, который читался бы всеми прикладными программами последовательно. Вместо этого, Отделенный EDIABAS читается каждой прикладной программой и если nec. запускается (и под WIN32/CE), то завершается автоматически. Параллельные операции нескольких интерфейсов одного типа возможны только, если они поддерживаются соответствующим программным обеспечением интерфейса. Под SCO-UNIX и до 64 прикладных программ могут иметь доступ к EDIABAS одновременно. 5. Программы помощи 5.1. UINSTALL Удаление программного обеспечения EDIABAS. This program is only available under SCO- Эта программа действительна только UNIX and QNX. UINSTALL deletes all для SCO-UNIX и QNX. UINSTALL installed EDIABAS delivery packages. The удаляет все инсталлированные пакеты Remove the EDIABAS software. 43 subdirectory ECU (or ecu under SCO- поставки EDIABAS. Субдиректория UNIX and QNX) containing the ECU блока управления (или БУ под SCOdescription files is not deleted. UNIX и QNX), содержащая файлы описания БУ, не удаляется. 5.1.1. SCO-UNIX This program can only be called by the Superuser. UINSTALL deletes all programs in the EDIABAS directory (also EDIABAS-external software!). After executing the program, all API or API or EDIABAS entries should be deleted in /etc/profile . Call: /usr/ediabas/uinstall Эта программа может быть вызвана только администратором. UINSTALL удаляет все программы в директории EDIABAS (также внешнее программное обеспечение EDIABAS!). После использования программы все данные API или EDIABAS должны быть удалены в /etc/profile. Вызывается: /usr/ediabas/uinstall Пример: login root /usr/ediabas/uinstall 5.1.2. QNX Only the Superuser can invoke this program. UINSTALL can be used to delete all programs in the EDIABAS directory (also EDIABAS-external software). Call: /usr/ediabas/uinstall Только админстратор может запрашивать эту программу. UINSTALL может быть использована для удаления всех программ в директории EDIABAS (также внешнего программного обеспечения EDIABAS). Вызывается: /usr/ediabas/uinstall Пример: login root /usr/ediabas/uinstall 5.2. PE (Password Editor). / Редактор пароля The Password Editor (PE) manages the Редактор паролей Password Editor (PE) 44 passwords of a protected EDIABAS version. The Password Editor is called PE.EXE. A password entry consists of a public label and associated, secret password. The password is only used once in the entry. Only the password label is then used for all further accesses. A maximum of 10 label/passwords can be entered. Labels/passwords which have once been entered cannot be deleted anymore. If this is desired, EDIABAS must be re-installed. Each label/password can be disabled or enabled (more than once possible). A disabled label/password behaves during runtime as if it did not exist. A <Label> consists of 1 to 10 ASCII characters in ANSI code, where only ASCII characters are permitted in the range: 20h <= <ASCII-character> <= 7Eh. The character '@' (40h) is illegal. A <Password> consists of 6 to 10 ASCII characters in ANSI code, where only ASCII characters are permitted in the range: 20h <= <ASCII characters> <= 7Eh. The Password Editor is controlled via the command line. It offers the following functionalities: • Display all commands of the Password Editor This Password Editor function represents a help function and displays all available commands. Call: pe • View all labels of the password file With the Password Editor, the labels of all passwords which are known by the runtime system can be displayed along with their status (enabled/disabled). Call: pe -v • Add a new entry in the password file Enter a new label/password in the EDIABAS runtime system. A total of 10 entries are possible. When entries are added, they automatically are assigned the status "enabled". Call: pe -a <Label>=<Password> управляет паролями защиты версии EDIABAS. Редактор называется PE.EXE. Вводимые пароли состоят из общедоступных ярлыков и объединенных, секретных паролей. Пароль используется только при вводе. Только ярлык пароля используется потом для всех следующих доступов. В пароле может быть введено максимум 10 знаков. Ярлыки/пароли, которые уже однажды введены, больше не могут быть удаленными. Если необходимо, EDIABAS должен быть переустановлен. Каждый ярлык/пароль может быть разрешенным или неразрешенным (возможно, более, чем один раз). Неразрешенный ярлык/пароль ведет себя в течении времени исполнения так, как будто его не существует. <Label> (Ярлык) содержит в себе от 1 10 символов ASCII в ANSI коде, где использование символов ASCII разрешается только в диапазоне: 20h <= <ASCII-character> <= 7Eh. TСимвол '@' (40h) не используется. <Password> содержит от 6 до 10 символов ASCII в ANSI коде, где использование символов ASCII разрешается только в диапазоне: 20h <= <ASCII characters> <= 7Eh. Редактор паролей контролируется посредством командной строки. Предлагаются следующие функции: • Отображение всех команд Редактора паролей. Эта функция Редактора паролей представляет функцию помощи и отображает все возможные команды. Вызывается: pe • Обзор всех ярлыков файла пароля. С помощью редактора паролей ярлыки всех паролей, которые узнаются системой времени исполнения, могут быть отображены с их статусами (способный/неспособный). Вызывается: pe –v • Добавление новых введений в файл пароля. Вводит новые ярлыки\пароли в систему времени исполнения EDIABAS. Всего возможно ввести 10 знаков. Когда данные добавлены, им автоматически присваивается статус «способные». Вызывается: pe -a <Label>=<Password> • Разрешенные данные в файле 45 • Enable an entry in the password file пароля Disabled entries can be re-enabled again. Неразрешенные данные могут стать вновь. Возможно, Possible more than one. Call: pe -e <Label> разрешенными неоднократно. Вызывается: pe -e <Label> • Неразрешенные данные в файле • Disable an entry in the password file пароля. Данные, которые были Entries which have been entered can be введены, могут быть сделаны disabled. In ECU description files неразрешенными. В sequence, disabled entries behave as последовательности файлов описания entries which do not exist. Possible more БУ неспособные данные ведут себя так, than once. Call: pe -d <Label> как если бы они не существовали. Возможно неоднократно. Вызывается: Call: pe -d <Label> Проверка пользования • Check whether an ECU description • описания БУ в file on the installed on the EDIABAS файлом инсталлированном EDIABAS. system can be executed The Password паролей может также Editor can also be used to check whether Редактор использоваться для проверки, могут ли ECU description files can be executed in connection with the installed EDIABAS файлы описания быть использованы в с инсталлированной system. For this purpose, the password связывании editor fetches the passwords from the системой EDIABAS. С этой целью ECU description file and compares them to редактор паролей вызывает пароли из the system passwords. Call: pe -c <SGBD> файла описания БУ и сравнивает их с The Password Editor returns the value 1 in паролями системы. Вызывается: pe -c <SGBD>. Редактор пароля возвращает 1 the case of an error, otherwise 0. в случае ошибки, и 0 в противном случае. Примечание: Может быть использован только Редактор NOTE: Only the Password Editor включенный в included in the EDIABAS installation паролей, инсталляцию EDIABAS. can be used. 5.3. DEVCLOSE Close the interface driver This program is only available under SCOUNIX and QNX. If, after using EDIABAS, an EDIABAS-external software wants to access the interface driver and this is still in the open state, the interface driver can be closed with the program DEVCLOSE. Call: devclose 5.4. Закрытие драйвера интерфейса. Эта программа действительна только под SCO-UNIX и QNX. Если после использования EDIABAS, внешнее программное обеспечение EDIABAS требует доступ к драйверу интерфейса, и все это находится в открытом положении, то драйвер интерфейса может быть закрыт с помощью программы DEVCLOSE. Вызывается: devclose BESTINFO Display of ECU description file contents Отображение содержимого файла 46 описания БУ. Программа BESTINFO позволяет создать следующую информацию, требуемую специфическим файлом описания БУ (в целевом формате): • Имя файла • File name • Пересмотр номера • Revision number • Last user (operator) (output of maximum • Последний пользователь (оператор) (создание 63 символов), данные последнего 63 characters), date of the last change изменения • List of all jobs • Список всех заданий Call: Вызывайется: bestinfo sgbd bestinfo sgbd The program BESTINFO allows the output of the following information regarding the specified ECU description file (object format): Пример: bestinfo testv.prg Выполнение: BEST object file : testv.prg BIP version : 03.03.00.00 Revision number : 2.0 Last modification by softing.sag.Os , Thu Mar 25 16:33:10 1993 5 Jobs: INITIALISIERUNG IDENT CHECK BINPARA WAIT BESTINFO ready. 5.5. BESTVER Version test of ECU description files This program is only available under MSWINDOWS. It allows the versions of ECU description files (object format) to be tested. In addition it allows specification of a uniform version number of the package for several description files. Call: BESTVER [-R RevMAJ.RevMIN username] [-V Packageversion] sgbd(en) Версия теста файлов описания БУ. Эта программа действительна только под MS-WINDOWS. Это позволяет тестировать версию файлов описания БУ (в целевом формате). Вдобавок, это позволяет специфицировать однородную версию пакетов нескольких файлов описания. Вызывается: [-R RevMAJ.RevMIN username] [-V Packageversion] sgbd(en) 47 Example: bestver -R 1.6 Softing -V 20 testv.prg Modifies the revision (revision 2.0 becomes 1.6, and author becomes Softing) and specifies a package version number (20). The following is output: Модификация пересмотра (2.0 стало 1.6, и автор стал Softing) и специфицируется число версий пакета (20). Выполняется следующее: TESTV.PRG BIP version : 03.03.00.00 Revision number : 2.0 Last change : Thu Mar 25 16:33:10 1993 By : softing.sag.Os Package version : 00000000 ==> Revision number : 1.6 Last change : Wed Nov 24 12:41:50 1993 By : Softing Package version : 00000020 Выполнение последнего пользователя ограничиваются максимум 63 символов. 5.6. XTRACT Display help texts from ECU description files This program is only available under MSWINDOWS. XTRACT can be used to display the help texts stored in the BEST object files. Call: XTRACT [-F] objectfile(s) [outdir] XTRACT -? (shows an overview of options) Option -F pipes the output is a file with the extension .biv or .big. The directory can be specified where the output file is to be produced. Wildcards can be used in objectfile. Отображение текстов помощи файлов описания БУ Эта программа действительна только под MS-WINDOWS. XTRACT может быть использована для отображения текстов помощи, имеющихся в целевых файлах BEST. Вызывается: XTRACT [F] objectfile(s) [outdir] XTRACT -? ( показывает обзор опций) Опция -F pipes является конечным файлом с расширением .biv или .big. Директория может быть специфицирована, где выходной файл будет сделан. Wildcards могут быть использованы в objectfile. Пример: xtract -F testv.prg Полученный файл testv.biv содержит следующее: ECU:TESTV ORIGIN:softing.sag.Os REVISION:2.0 48 AUTHOR:softing.sag.Os ECUCOMMENT:Description file WIHTOUT access to the interface ECUCOMMENT:Orignal: TESTV.B1V JOBNAME:initialization JOBCOMMENT:Initialization RESULT:DONE RESULTTYPE:int RESULTCOMMENT:1 if ok, otherwise 0 JOBNAME:IDENT JOBCOMMENT:Determine the identification string RESULT:JOB_STATUS RESULTTYPE:string RESULTCOMMENT:Returns: OKAY or ERROR_PARAMETER ... RESULTCOMMENT:Returns: OKAY or ERROR_PARAMETER Automatic table output: For improved documentation of BEST objects, XTRACT also offers the functionality to output the entries of a table instead of a BEST/2 comment. For this purpose, a BEST/2 comment must have the following structure: Автоматическая выходная таблица: Для улучшения документации объектов BEST, XTRACT также предлагает функциональность для введения таблиц вместо комментариев BEST/2. С этой целью комментарии BEST/2 должны иметь следующую структуру: comment: table <Table name> <Column> [ <Column> ... ] Пример BEST/2 исходного файла: ... table beispielTabelle[2][]= { { "COLUMN1", "COLUMN2", "COLUMN3" }, { "Line1", "xtract", "generated" }, { "Line2", "these", "texts" }, { "Line3", "automatically", "!" } }; job ( name = beispielJob; comment : Start of comment comment : Table beispielTabelle SPALTE2 SPALTE3 comment : End of comment ... XTRACT создает следующие строки в примере выше: ... JOBNAME:beispielJob JOBCOMMENT:Start of comment JOBCOMMENT: "xtract" "generated" JOBCOMMENT: "these" "Text" JOBCOMMENT: "automatically" "!" JOBCOMMENT:End of comment 49 ... 5.7. STRIP. Remove (strip) the extra information from ECU description files This program is only available under MSWINDOWS. STRIP can be used to remove the help text and debug information stored in BEST object files. Call: STRIP [-N] dh sourcefile(s) [outdir] STRIP -? (Shows an overview of options) Parameter d indicates that the debug information is to be removed, whereas parameter h indicates that the help texts are to be removed. The directory can be specified where the output file is to be produced. If an object file is overwritten which already exits, STRIP requests the user for re-confirmation. This interrogation can be suppressed with option -N. Удаление (strip) экстра информации из файлов описания БУ. Эта программа действительна только под MS-WINDOWS. STRIP, и может быть использована только для удаления текстов помощи и информации отладки, которые хранятся в целевых файлах BEST. Вызывается: STRIP [-N] dh sourcefile(s) [outdir] STRIP -? (показывае обзор опций) Параметр d показывает, что информация отладки удаляется, тогда как параметр h показывает, что тексты помощи удаляются. Директория может быть специфицирована, где будет создан выходной файл. Если описывается выходной файл, который уже существует, STRIP требует от пользователя нового подтверждения. Это требование может быть удовлетворено опцией -N. Пример: strip -N dh testv.prg Удаление информации отладки и текстов помощи из файла testv.prg. 50 А. Глоссарий API (Application Programming Interface): EDIABAS interface up to the application. API (Прикладная программа интерфейса): Интерфейс EDIABAS до приложения. Application: Application program for executing the diagnostics and coding ECUs. Применение: Прикладная программа для выполнения диагностики и кодирования БУ. BEST Описание языка для блоков управления. BEST (BEschreibungssprache für STeuergeräte): Description language for ECUs. Description file: Contains all data and methods which are required for describing the diagnostic function of an ECU. Device: Logical device used for connecting the interface. Diagnostic concept: Conventions according to ISO in which access to the diagnostic data is described in ECUs. DLL (Dynamic Link Library): Dynamic function library under MS-Windows. Linked at the to the application only at runtime. Файлы описания: Содержат все данные и методы, которые требуются для описания и диагностики функций БУ. Средство: Логическое средство, используемое для связывания с интерфейсом. Понятие диагностики: Принятые положения в соответствии ISO, в которых диагностические данные описываются БУ. DLL (Библиотека): Динамическая функциональная библиотека под MSWindows. Связана с приложением только в течении времени исполнения. ECM (Электронный контролирующий ECM (Electronic Control Module): модуль): Аббревиатура БУ. Abbreviation for ECU. ECU (Электронная контролирующая ECU (Electronic Control Unit): единица): Аббревиатура БУ. Abbreviation. EDIABAS (Электронная EDIABAS (Elektronik DIAgnose диагностическая базисная система). BASissystem): Electronic Diagnostic Basic API, время исполнения и отладчик System. API, runtime system and Interface интерфейса. Handler. EDIC (Увеличенный диагностический EDIC (Enhanced Diagnostic Interface интерфейс компьютера) Computer) IFH (отладчик интерфейса): IFH (InterFace Handler): Software программное обеспечение интерфейса interface for operating the EDIC functions. для EDIC функций. Связь с EDIC Communication with the EDIC interface интерфейсом осуществляется через occurs via the EDIC driver. EDIC драйвер. 51 Job: Method in the ECU description file which reads data from the ECU. Runtime system: EDIABAS runtime system with BEST interpreter. The runtime system processes a job issued via API by loading and interpreting the corresponding ECU description file. In addition to the ECU-specific parameters, these ECU description files contain the corresponding rules, methods and sequences for processing jobs. SGBD (SteuerGeräteBeschreibungsDatei): ECU (Electronic Control Unit) description file. SG (SteuerGeräte): See ECU (Electronic Control Unit). Control device variant: Functionally different versions of ECU groups. No difference is made in version type (e.g., country version, coding variant). The ECU is also to be conceived as an ECU variant for only one version within an ECU group. Задание: Метод в файлах описания БУ, который читает данные из БУ. Система времени исполнения: Система времени исполнения EDIABAS с интерпретатором BEST. Система времени исполнения задания, исходящего через API загрузкой и интерпретированием файлов описания БУ. Вдобавок к БУ-специфическим параметрам, эти файлы описания БУ содержат соответствующие правила, методы и последовательности выполнения заданий. SGBD: Файл описания БУ. SG: БУ Вариант контроля метода: Функционально различные версии групп БУ. Различия не делаются в типе версии (например, country версия, вариант кодирования). БУ также представляется как вариант БУ только для одной версии в группе БУ. Обзор истории Version 3.0 Created overview and User Manual/Installation Guide Version 3.0A Combined above documents Version 3.0B Added Rev., Glossary and Introduction Version 4.1 Revised for EDIABAS V4.1.0 Version 5 Revised for EDIABAS V5.1.0 Version 5a Extended for EDIABAS V5.5.0 Version 5b Extended for remote diagnostic Win32 Version 5c Configuration for IFH Trace Version 5d Revised the XTRACT output functionality Version 5e Extended for QNX Version 6 Extended for EDIABAS V6.0.0 Version 6c Revised for EDIABAS V6.4.4 52 Содержание. 2. Introduction. / Введение…………………………………………………………. 2.1. About this manual / Об этом руководстве……………………………………. 2.2. Notational conventions / Символьные соглашения…………………………. 2.3. Special features, terms, acronyms / Особые свойства, направления, акронимы………………………………………………………………………………. 2.4 Trademarks / Торговые марки………………………………………………….. 3. General / Основная часть……………………………………………………….. 3.1. Diagnostics and coding of ECUs / Диагностика и кодирование БУ……….. 3.2. Problem definition / Постановка задач……………………………………….. 3.3. Approaches to problem solving / Подходы к решению проблемы…………. 3.4. Implementing solutions with EDIABAS / Осуществление решений с EDIABAS……………………………………………………………………………….. 3.5. Structure / Структура……………………………………………………………. 3.6. Job concept / Истолкование задания………………………………………….. 3.7. Description language BEST / Описание языка BEST………………………… 3.8. Sequences / Последовательности……………………………………………... 3.9. Availability / Доступность………………………………………………………… 4. Installation and administration / Установка и администрирование… 4.1. Delivery packages / Установочные пакеты……………………………………. 4.1.1. Delivery package RUNTIME SYSTEM / Установочные пакеты в системе времени исполнения……………………………………………………….. 4.1.1.1. Файлы для WIN32……………………………………………………………. 4.1.1.2. Файлы для WIN16……………………………………………………………. 4.1.1.3. Файлы для WINCE…………………………………………………………… 4.1.1.4. Файлы для SCO-UNIX………………………………………………………. 4.1.1.5. Файлы для QNX……………………………………………………………… 4.1.1.6. Documentation / Документация…………………………………………….. 4.1.2. Delivery package APPLICATION DEVELOPMENT KIT / Установочный пакет пакета разработки приложения…………………………………………… 4.1.2.1. Файлы для WIN32……………………………………………………………. 4.1.2.2. Файлы для WIN16…………………………………………………………… 4.1.2.3. Dateien unter WINCE………………………………………………………… 4.1.2.4. Файлы для SCO-UNIX……………………………………………………… 4.1.2.5. Файлы для QNX……………………………………………………………… 4.1.2.6. Documentation / Документация…………………………………………….. 4.1.3. Delivery package BEST DEVELOPMENT KIT / Установочный пакет Пакет разработки BEST ………………………………….. 4.1.3.1. Файлы для WIN32…………………………………………………………… 4.1.3.2. Файлы для WIN16………………………………………………………….. 4.1.3.3. Documentation / Документация……………………………………………. 4.2. System requirements / Системные требования……………………………… 4.2.1. MS-WINDOWS………………………………………………………………….. 4.2.2. MS-WINDOWS CE……………………………………………………………… 4.2.3. SCO-UNIX……………………………………………………………………….. 4.2.4. QNX………………………………………………………………………………. 1 1 1 2 2 2 2 3 4 5 6 8 9 10 13 14 14 14 15 16 16 17 18 18 19 20 20 21 21 23 25 25 26 26 27 28 28 28 28 28 53 4.3. Installing for the first time / Установка в первый раз…………………………. 4.3.1. MS-WINDOWS………………………………………………………………….. 4.3.2. SCO-UNIX……………………………………………………………………….. 4.3.3. QNX………………………………………………………………………………. 4.4. EDIABAS program paths / Программные пути EDIABAS…………………… 4.4.1. MS-WINDOWS………………………………………………………………….. 4.4.2. SCO-UNIX……………………………………………………………………….. 4.4.3. QNX………………………………………………………………………………. 4.5. EDIABAS configuration / Конфигурация EDIABAS…………………………… 4.5.1. Search sequence of EDIABAS.INI / Последовательность поиска EDIABAS.INI…………………………………………………………………………… 4.5.2. Configuration overview / Обзор конфигурации……………………………. 4.5.3. Select the hardware interface / Подбор интерфейса аппаратного устройства………………………………………………………………………….. 4.5.4. MS-WINDOWS…………………………………………………………………. 4.5.5. SCO-UNIX………………………………………………………………………. 4.5.6. QNX……………………………………………………………………………… 4.5.7. Directory of ECU description files / Директории файлов описания БУ….. 4.5.8. Character Set Conversion / Особенность установки конверсии…………. 4.5.9. WIN16/32-Umsetzung…………………………………………………………. 41 4.6. Start and terminate EDIABAS / Запуск и завершение EDIABAS………. 4.6.1. WIN32……………………………………………………………………………. 4.6.2. WIN16.......................................................................................................... 4.6.3. WINCE......................................................................................................... 4.6.4. SCO-UNIX.................................................................................................... 4.6.5. QNX.............................................................................................................. 4.7. Un-install / Деинсталляция............................................................................ 4.7.1. MS-WINDOWS............................................................................................. 4.7.2. MS-Windows CE.......................................................................................... 4.7.3. SCO-UNIX.................................................................................................... 4.7.4. QNX.............................................................................................................. 4.8. Protection mechanism / Механизмы защиты................................................ 4.9. Remote diagnostics / Дистанционная диагностика...................................... 4.9.1. EDIABAS.INI на локальном ПК.................................................................. 4.9.2. EDIABAS.INI на удаленном контролируемом ПК..................................... 4.9.3. Procedure for remote diagnostics / Процедура дистанционной диагностики ……………………………………………………………………………. 4.10. EDIABAS Parallel Operation / Параллельные операции …………………. 5. Help programs / Программы помощи ………………………………………… 5.1. UINSTALL …………………………………………………………………………. 5.1.1. SCO-UNIX.................................................................................................... 5.1.2. QNX.............................................................................................................. 5.2. РE (Password Editor) / Редактор паролей…………………………………….. 5.3. DEVCLOSE..................................................................................................... 5.4. BESTINFO...................................................................................................... 5.5. BESTVER........................................................................................................ 5.6. XTRACT.......................................................................................................... 5.7. STRIP.............................................................................................................. A.GLOSSARY / Глоссарий......................................................................................... Обзор истории………………………………………………………………………… 29 29 29 30 32 32 32 32 32 33 34 36 36 36 36 36 36 37 38 38 38 38 38 39 40 40 40 40 41 41 43 44 45 45 45 46 46 46 47 47 49 49 50 51 52 54 55 54 55