Используя API C

Помните о следующих инструкциях, когда вы начнете написать программы Simulink® Real-Time™ C API с Simulink Real-Time C DLL API:

  • Тщательно совпадайте с функциональными типами данных, как зарегистрировано в ссылку на функцию. Для C API включает заголовочный файл, который совпадает с типами данных.

  • Можно вызвать API-функции с неязыков C, таких как C++ и Java®. Обратитесь к документации компилятора неязыка C для описания того, как получить доступ к функциям C от библиотеки DLL. Чтобы получить доступ к Simulink Real-Time C DLL API, следуйте за этими направлениями.

  • Можно работать с приложениями реального времени или с MATLAB® или с Simulink Real-Time C приложение управления API. Однако только одно приложение управления может получить доступ к целевому компьютеру за один раз. Чтобы переместиться от сеанса работы с MATLAB до вашего приложения, в Окне Команды MATLAB, введите:

    close(slrt)

    Эта команда освобождает связь с целевым компьютером для использования вашим Simulink Real-Time C приложение API. С другой стороны, чтобы получить доступ к цели от сеанса работы с MATLAB, необходимо выйти приложения управления или сделать эквивалент вызова функционального xPCClosePort.

  • Simulink Real-Time C API-функции, которые связываются с проверкой целевого компьютера на тайм-ауты во время коммуникации. Если время соединения TCP/IP, они выходят с глобальной переменной из набора xPCError к ETCPTIMEOUT. Используйте xPCGetLoadTimeOut и функции xPCSetLoadTimeOut, чтобы получить и установить значения тайм-аута, соответственно.

Несколько вещей, которые характерны почти для всех функций в Simulink Real-Time C API, не покрыты разделами справки для отдельных функций.

  • Почти каждая функция (кроме xPCOpenTcpIpPort, xPCGetLastError и xPCErrorMsg) имеет как один из его параметров целочисленная переменная port. xPCOpenTcpIpPort возвращает эту переменную, чтобы представлять линию связи с целевым компьютером.

  • Почти каждая функция (кроме xPCGetLastError и xPCErrorMsg) устанавливает глобальное ошибочное значение, когда ошибка происходит. Приложение получает это значение путем вызова функционального xPCGetLastError и получает описательную символьную строку об ошибке при помощи функционального xPCErrorMsg. Фактические ошибочные значения подвержены изменениям. Однако нулевое значение обычно означает, что операция завершилась, не производя ошибку, в то время как ненулевое значение обычно показывает состояние ошибки. Сброс библиотеки ошибка оценивает каждый раз API-функцию, называется; поэтому, проверяйте ошибочное состояние как можно скорее после вызова функции.

    Некоторые функции также используют свои возвращаемые значения (если применимо), чтобы показать, что ошибка произошла. В этих случаях также, можно получить точную ошибку с xPCGetLastError.