SCI Receive
Сконфигурируйте последовательный интерфейс стороны хоста, чтобы получить данные из последовательного порта
- Библиотека:
Embedded Coder / Целевые процессоры / Коммуникация Хоста
Описание
Блок SCI Receive задает настройку блока данных, который получен от целевого компьютера этим блоком.
Порты
Вывод
data — Блок данных
скаляр (значение по умолчанию) | вектор
Блок данных в виде скаляра или вектора, который получен от целевого компьютера. Пакет может состоять из заголовков, терминаторов строки и элементов данных. Размер пакета ограничивается 16 байтами символов ASCII, включая заголовки и терминаторы строки. Вычислите размер пакета путем добавления размеров байта заголовков, терминаторов строки и данных.
Эта таблица приводит количество байтов для поддерживаемых типов данных.
| Тип данных | Количество байта |
|---|---|
single | 4 байта |
int8 и uint8 | 1 байт |
int16 и uint16 | 2 байта |
int32 anduint32 | 4 байта |
Например, если ваш блок данных включает 1-байтовый заголовок пакета, 'S', и 1-байтовый терминатор строки пакета, 'E', 14 байтов остаются для данных. Если ваши данные имеют тип int8, данные могут состоять максимум из 14 элементов данных. Если ваши данные имеют тип uint16, данные могут состоять максимум из 7 элементов данных. Если ваши данные имеют тип int32, блок данных может состоять максимум из 3 элементов данных с перенесенными 2 байтами. Поскольку вы не можете смешать типы данных в пакете, остающиеся 2 байта не используются.
Количество элементов данных, которые могут поместиться в блок данных, определяет длину данных (см. параметр длины Данных). В предыдущем примере, 14 элементах данных типа int8 и 7 элементов данных типа uint16 длины данных для каждого блока данных, соответственно. Когда длина данных превышает 16 байтов, неожиданное поведение, включая ошибки времени выполнения, может закончиться.
Типы данных: single | int8 | int16 | int32 | uint8 | uint16 | uint32
status — Состояние Error передачи данных
0 | 1 | 2 | 3 | 4
Дополнительное ошибочное значение состояния для передач данных.
Возможные значения состояния перечислены в этой таблице.
| Значение состояния | Условие |
|---|---|
0 | Никакие ошибки. |
1 | Связь испытала таймаут, в то время как блок ожидал, чтобы получить данные. |
2 | Ошибка контрольной суммы. Полученные данные содержат ошибку. |
3 | Ошибка четности SCI. Символ был получен с несоответствием. |
4 | Ошибка структурирования SCI. Ожидаемый стоп-бит был найден. |
Зависимости от порта
Чтобы включить этот порт, выберите параметр Output receiving status.
Параметры
Port name — Имя COM-порта
COM1 (значение по умолчанию) | COM2 | COM3 | COM4
Задайте имя COM-порта, который вы конфигурируете для этого блока SCI Receive. Можно сконфигурировать до четырех COM-портов для модели, один COM-порт для каждого блока SCI Receive в модели.
Additional package header — Заголовок полученного блока данных
'S' (значение по умолчанию) | 'значение ASCII'
Задайте заголовок полученного блока данных как значение ASCII в одинарных кавычках. Значение может быть текстом или номером в области значений от 0 до 255. Кавычки не получены и не включены в количество байта пакета.
Заголовок не является частью получаемых данных. Как правило, заголовок отмечает запуск данных. Заголовок, который вы задаете, должен совпадать с заголовком, заданным для соответствующего блока SCI Transmit целевого компьютера.
Additional package terminator — Терминатор полученного блока данных
'E' (значение по умолчанию) | 'значение ASCII'
Задайте терминатор строки полученного блока данных как значение ASCII в одинарных кавычках. Значение может быть текстом или номером в области значений от 0 до 255. Кавычки не получены и не включены в количество байта пакета.
Терминатор строки не является частью получаемых данных. Как правило, терминатор строки отмечает конец данных. Терминатор строки, который вы задаете, должен совпадать с терминатором строки, заданным для соответствующего блока SCI Transmit целевого компьютера.
Data type — Тип данных данных в полученном блоке данных
uint8 (значение по умолчанию) | один | int8 | int16 | uint16 | int32 | uint32
Задайте тип данных входного порта соответствующего блока SCI Transmit целевого компьютера. Тип данных и соответствующее количество байта наследованы от входного порта.
Data length — Количество элементов данных заданного типа данных, который получает блок
1 (значение по умолчанию) | вектор
Задайте количество элементов данных заданного типа данных, который блок получает от блока SCI Transmit целевого компьютера. Значение кроме 1 обработано как вектор. Длина данных наследована от длины входных данных блока SCI Transmit целевого компьютера.
Initial output — Значение по умолчанию от блока SCI Receive
0 (значений по умолчанию) | скаляр
Задайте значение, которое блок выводит как последнее значение, полученное, когда эти условия существуют:
Параметр Action taken when connection times out устанавливается на
Output the last received value.Никакие данные не были получены.
Время соединения.
Зависимости от параметра
Чтобы включить этот параметр, установите Action taken when connection times out на Output the last received value.
Action Taken when connection times out — Выходное значение, чтобы записать, когда время соединения
Output the last received value (значение по умолчанию) | Output custom value
Задайте выходное значение, которое блок пишет когда время соединения. Блок может записать последнее полученное значение или пользовательское значение.
Зависимости от параметра
Если вы задаете Output custom value, используйте параметр Output value when connection times out, чтобы установить пользовательское значение.
Output value when connection times out — Выходное значение, чтобы записать, когда время соединения
0 (значений по умолчанию) | скаляр | вектор
Задайте пользовательское значение, чтобы вывести когда время соединения.
Зависимости от параметра
Чтобы включить этот параметр, установите Action taken when connection times out на Output custom value.
Sample time — Частота вызовов блока
- 1 (значение по умолчанию) | скаляр
Задайте частоту, на которой планировщик вызывает блок SCI Receive в секундах. Чтобы достигнуть любого из этих условий, установите этот параметр на -1:
Блок наследовал установку шага расчета модели.
Блок выполняется асинхронно.
Output receiving status — Состояние Error передачи данных
от (значения по умолчанию) | на
Выберите этот параметр, чтобы создать выходной порт блока status, который обеспечивает состояние передач данных.
Расширенные возможности
Генерация кода C/C++
Генерация кода C и C++ с помощью Simulink® Coder™.
Этот блок не поддерживает генерацию кода. Блок поддерживается для симуляций на компьютере разработчика хоста только.