Документация

Взаимное исключение

Для доступа к системным структурам данных с поддержкой взаимного исключения драйвер XCP зависит от основных API для определения, инициализации, блокировки и разблокировки.

Чтобы поддержать взаимное исключение для целевого компьютера, предоставьте пользовательскую реализацию.

Реализация по умолчанию для Linux и Windows поддерживает взаимное исключение.

#if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)
...
#define XCP_MUTEX_DEFINE(lock) HANDLE lock
#define XCP_MUTEX_INIT(lock) lock = CreateMutex(0, FALSE, 0)
#define XCP_MUTEX_LOCK(lock) WaitForSingleObject((lock), INFINITE)
#define XCP_MUTEX_UNLOCK(lock) ReleaseMutex(lock)

#else 
...
#include <pthread.h>
#define XCP_MUTEX_DEFINE(lock) pthread_mutex_t lock
#define XCP_MUTEX_INIT(lock) pthread_mutex_init(&(lock), NULL)
#define XCP_MUTEX_LOCK(lock) pthread_mutex_lock(&(lock))
#define XCP_MUTEX_UNLOCK(lock) pthread_mutex_unlock(&(lock))
...
#endif

Обеспечьте API-интерфейс ожидания, который делает вызывающий поток неактивным до истечения заданного времени. Реализацией по умолчанию для систем Linux и Windows является:

#if defined(_WIN32) || defined(__WIN32__) || defined(WIN32)
...
#define XCP_SLEEP(seconds,microseconds)  Sleep((seconds) * 1000 \  
+ (((microseconds) + 1000 - 1) / 1000))

#else 
...
#if _POSIX_C_SOURCE >= 199309L
#define XCP_SLEEP(seconds,microseconds)  do {struct timespec t;\
 t.tv_sec = seconds; t.tv_nsec = microseconds * 1000; nanosleep(&t, NULL);} while(0)
#else
/* nanosleep is not available. Use select instead. */
#define XCP_SLEEP(seconds,microseconds)  do {struct timeval t; t.tv_sec = seconds;\
 t.tv_usec = microseconds; select(0, NULL, NULL, NULL, &t);} while(0)
#endif /* _POSIX_C_SOURCE >= 199309L */
...
#endif

Логгирование

Для генерации диагностических сообщений ведомому программному обеспечению XCP требуется пользовательский API печати, который поддерживает логгирование услуги, предоставляемые целевому компьютеру. Если вы не задаете XCP_PRINTF макрос препроцессора, реализация по умолчанию пуста.

Преобразование адреса

Стандарт XCP выражает адрес переменной в памяти как 32-битный адрес с 8-битным расширением.

Мастер XCP извлекает адреса сигналов и параметров модели, анализируя информацию отладки, которую создает процесс сборки. Отладочная информация находится в формате DWARF или PDB.

Мастер XCP запрашивает доступ к параметрам и сигналам путем отправки команды XCP, которая содержит аргументы addressExtension и address.

Когда addressExtension и address информация получена целевым компьютером, подчиненный сервер XCP должен преобразовать адрес в местоположение переменной в целевой аппаратной памяти. Местоположение переменной присваивается загрузчиком и зависит от цели.

Используйте XCP_ADDRESS_GET() макрос для определения логики преобразования. Реализацией по умолчанию для систем Linux и Windows является:

#if defined(__MINGW32__) || defined(__MINGW64__)
#define XCP_ADDRESS_GET(addressExtension, address) \ 
(uint8_T*) ((uintptr_t) address)
#else
#define XCP_ADDRESS_GET(addressExtension, address) \ 
(uint8_T*) ((address) + (uint8_T*)&__ImageBase)
#endif

Установите и скопируйте память

Можно задать оптимизированную версию памяти копирования и задать операции памяти.

Если вы не задаете XCP_MEMCPY и XCP_MEMSET макросы препроцессора, реализация по умолчанию задает стандартные функции C, memcpy и memset.

#ifndef XCP_MEMCPY
#define XCP_MEMCPY memcpy
#endif

#ifndef XCP_MEMSET
#define XCP_MEMSET memset
#endif

Синтаксический анализ аргументов в командной строке

Если ваш целевой компьютер не поддерживает синтаксический анализ аргументов в командной строке, задайте макрос препроцессора EXTMODE_DISABLE_ARGS_PROCESSING.

Чтобы заменить -w можно использовать эту команду, чтобы указать, что целевое приложение входит и остается в состоянии ожидания, пока не получит сообщение Connect от Simulink:

set_param(modelName, 'OnTargetWaitForStart', 'on');