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

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

Для доступа к структурам системных данных с поддержкой взаимного исключения драйвер 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 извлекает адреса сигналов и параметры модели путем анализа отладочной информации, создаваемой процессом построения. Отладочная информация имеет формат DWF или 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 макросы препроцессора, реализация по умолчанию определяет стандартные функции Си, 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');