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

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

К системным структурам данных доступа с поддержкой взаимного исключения драйвер 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 опция, можно использовать эту команду, чтобы указать, что целевое приложение входит и остается в состоянии ожидания, пока это не получает сообщение Подключения от Simulink:

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