Serial Server Documentation

Настройка COM-порта


Редактор COM-порта позволяет настроить выводимые данные, предварительно отформатировав их. Он состоит из общих настроек COM-порта (правая панель) и редактора записей (левая панель).

Редактор записей


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

Mode

TextВыводит текст, указанный в поле "Property".
PropertyПолучает данные мониторинга из MSI Afterburner. Источник данных можно настроить в поле "Property".
TimeЗаписывает текущее время. Формат вывода можно настроить в поле "Out Format". Подробнее о форматировании времени на MSDN.

Property

Если выбран режим "Text", текст в данном поле будет выводиться без изменений. При использовании режима "Property" это параметр определяет название данных, которые MADS попытается найти в активных графиках MSI Afterburner. Если данные не найдены, будут возращены нулевые значения. В выпадающем списке отображаются доступные параметры (требуется запущенный MSI Afterburner).

Prefix и Postfix

Текст, указанный в данных полях, выводится перед и после элемента соответственно. Данные поля удобны для создания разделительных символов или присваивания названий выводимым параметрам.

Target

У каждого графика MSI Afterburner существует множество данных. Это поле позволяет выбрать некоторые из них.
PropertyValueТекущее значение графика.
MinLimitМинимальный предел графика.
MaxLimitМаксимальный предел графика.
PropertyUnitsЕдиницы измерения графика.
PropertyFormatФормат строки.

Operation и Value

Работают только с числовыми параметрами, определенными в поле "Target". Позволяют произвести над полученными данными простую математическую операцию. Выберите в поле "Operation" нужную вам операцию, после чего введите в поле "Value" нужный коэффициент. Удобны для коррекции значений, полученных из мониторинга MSI Afterburner.
NoneНичего не делает.
AddДобавляет число, указанное в поле "Value".
SubtractВычитает число, указанное в поле "Value".
MultiplyУмножает на число, указанное в поле "Value".
DivideДелит на число, указанное в поле "Value". При делении на 0 возвращает 0.
PercentНаходит процент от числа, указанного в поле "Value".

Round

Работает только с числовыми параметрами, определенными в поле "Target". Округляет значение выбранным способом.
NoneНичего не делает.
RoundМатематическое округление.
RoundDownОкругляет к ближайшему целому по направлению к нулю.
RoundUpОкругляет к ближайшему целому по направлению от нуля.

Modulo

Работает только с числовыми параметрами, определенными в поле "Target". Отбрасывает у числа знак, возвращая его модуль.

Out Format

Позволяет модифицировать выводимое значение с помощью средств форматирования данных языка C#. Подробнее на MSDN.

Настройки COM-порта


Decimal SeparatorСимвол, используемый для отделения дробной части числа.
Global PrefixТекст, который будет вставлен перед каждой записью.
Global PostfixТекст, который будет вставлен после каждой записи.
Port SpeedСкорость COM-порта.
EncodingКодировка текста. Для корректной работы, кодировка сервера и клиента должна совпадать.
End Of Line Character Данный текст будет использоваться для определения конца сообщений (входящих и исходящих). По умолчанию используется символ новой строки "\n". Например - если в качестве клиента используется платформа Arduino, ее стандартная функция "Serial.println()" использует комбинацию символа возраста каретки и символа новой строки "\r\n". Чтобы использовать свой символ конца сообщения, используйте функцию Serial.print(). Например: Serial.print("Hello MADS\n"). Подробнее о Escape-символах на MSDN.
Auto Connect Данная опция позволяет включить автоматический поиск клиента. Сервер поочередно отправляет всем открытым портам сообщение, указанное в поле "Request" и ожидает ответа, указанного в поле "Response". Время ожидания ответа можно указать в поле "Response Timeout". Также, на вкладке настроек сервера можно указать "черный список" портов, которые будут проигнорированы во время поиска.
RequestЗапрос, который будет отправлен клиенту.
Response Текст, указанный в данном поле, будет сравниваться с сообщением, полученным от клиента. В случае совпадения, сервер начнет передачу данных.
Response TimeoutВремя, которое сервер будет ожидать ответа от клиента. Время указывается в миллисекундах.
Connection IntervalЕсли автоматический поиск отключен, сервер будет пытаться подключиться к выбранному порту с интервалом, указанным в данном поле. Интервал указывается в миллисекундах.

Send Mode

Сервер может отправлять данные в двух режимах – через указанный период и по запросу от клиента.
StreamЭтот режим отправляет сообщения постоянно, с указанной в поле "Message Interval" периодичностью.
Message Interval Интервал в миллисекундах, с которым сервер будет отправлять сообщения клиенту. Убедитесь, что клиент успевает получить данные и обработать их.
RequestВ данном режиме сервер отправляет сообщение только после запроса от клиента.
Connection Check Интервал в миллисекундах, с которым сервер будет проверять подключение к клиенту. Если подключение отсутствует, сервер попытается восстановить его.
Data Request Текст, указанный в этом поле, будет сравниваться с сообщением, полученным от клиента. В случае совпадения, сервер отправит актуальные данные.

Настройки Сервера


AutorunАвтоматически запускает сервер при старте программы.
Open Last FileАвтоматическая загрузка последнего файла при старте программы.
Server NotificationsИспользовать уведомления с состоянием сервера.
Port Blacklist Позволяет указать список портов, которые сервер должен игнорировать при поиске. Введите имена портов, разделенные запятыми. (COM1,COM2,COM12)