Формат файла инициализации COM-порта

Файл записан в текстовом формате и состоит из нескольких секций. Порядок следования секций не имеет значения. Каждая секция начинается заголовком вида

[<имя_секции>]

и продолжается до начала следующей секции или конца файла. В каждой секции содержится несколько записей. Запись имеет формат

<имя_записи>=<значение>;

В файле должны быть описаны следующие секции: init, sample, var, var.scale (не обязательно) , var.display (не обязательно).

В секции var описываются переменные. Имена переменных могут подставляться со знаком $ в значения записей. В том случае, если существует секция var.scale, в этой секции могут быть заданы масштабные коэффициенты для преобразования значений переменных в вещественные числа. Тогда в окне параметров клиентского программного обеспечения будут появляться значения, умноженные на масштабные коэффициэнты. Если существует секция var.display, в ней могут задаваться альтернативные названия переменных, более удобные для пользователя.

В секции init должны содержаться следующие записи:

• RdInterval - максимальный интервал (в миллисекундах) между двумя последывательными символами, считываемыми с порта.
• RdTotMult - максимальное время считывания одного символа.
• RdTotConst - постоянная считывания; считывание с порта строки в N символов прерывается по тайм-ауту, если время считывания строки превышает значение, равное N*RdTotMult+RdTotConst, либо интервал между приходом двух последовательных символов превышает значение RdInterval.
• WrTotMult - максимальное время записи одного символа.
• WrTotConst - постоянная записи.
• Speed - формула, задающая максимальную скорость снятия данных (в Герцах). В формуле могут быть использованы переменные, вещественные числа, операции + - * / и скобки ( ). Операции умножения и деления имеют приоритет над операциями сложения и вычитания.
• init - строка инициализации устройства; строка состоит из числовых значений, задержек и escape-функций, разделенных запятыми. Числовые значения представляются в десятичном (например 123), шестнадцатеричном (например 0xa1) или восьмеричном (0175) виде. Каждое числовое значение соответствует одному байту посылаемой информации. Задержка записывается в виде !<время в миллисекундах>, например !500. Escape-функция - одно из следующих значений:
  • CLRDTR
  • CLRRTS
  • SETDTR
  • SETRTS
  • SETXOFF
  • SETXON
  • SETBREAK
  • CLRBREAK
• init_read - число байт, которые нужно считать после посылки строки init

В секции sample должны содержаться следующие записи:

• init - строка инициализации считывания одного значения. Строка состоит только из числовых значений, разделенных запятыми.
• init_read - число байт, которые нужно считать после посылки строки init.
• lobyte - строка инициализации считывания нижнего байта значения.
• lobyte_read - число байт, которые нужно считать после посылки строки lobyte.
• lobyte_offset - смещение к нижнему байту в считанной строке, может быть отрицательным.
• hibyte - строка инициализации считывания верхнего байта значения.
• hibyte_read - число байт, которые нужно считать после посылки строки hibyte.
• hibyte_offset - смещение к верхнему байту в считанной строке, может быть отрицательным.

Общение с портом происходит следующим образом:

• При загрузке DSP, если включен дополнительный канал данных (2.1.2), происходит посылка в выбранный COM-порт строки [init]init и считывается [init]init_read байт.
• В каждой точке изображения в порт посылается строка [sample]init и считывается [sample]init_read байт. После их считывания посылается строка [sample]lobyte и считывается [sample]lobyte_read байт. Затем аналогичным образом посылается строка [sample]hibyte и считывается [sample]hibyte_read байт. Из считанных данных длиной [sample]init_read + [sample]lobyte_read+[sample]hibyte_read берутся два байта со смещениями [sample]init_read + [sample]lobyte_offset и [sample]init_read + [sample]lobyte_read + [sample]hibyte_offset, из которых формируется 16-битный результат.

Ниже приведен пример файла инициализации.

[init]
RdInterval=500;
RdTotConst=500;
RdTotMult=500;
Speed=1.0/(2.0e-6*$CCPR2*$TMRQuanta);
WrTotConst=0;
WrTotMult=0;
init=SETRTS,!100,CLRRTS,!100,0x74,$Uhv,0xf4,0x74,$Ud,0xfc;
init_read=6;

[sample]
hibyte=0xa6;
hibyte_offset=0;
hibyte_read=1;
init=0x30,$C_DvdReg,0x1c,$CCPR2High,0x1b,$CCPR2Low,0x29,$TMRQuanta,0xf2;
init_read=9;
lobyte=0x81;
lobyte_offset=0;
lobyte_read=1;

[var]
CCPR2(Cntr),int,0,0xffff=256;
CCPR2High,int,0,255,,#CCPR2 >> 8=#CCPR2 >> 8;
CCPR2Low,int,0,255,,#CCPR2 & 0xff=#CCPR2 & 0xff;
C_DvdReg(Div),int,0,255=0;
TMRQuanta(Cntr T, ms),int,0,255,0.05*##=40;
Ud(Ud, V),int,0,255=20;
Uhv(Uhv, V),int,0,255=200;
sample_freq,double,,,,,1.0/(2.0e-6*#CCPR2*#TMRQuanta)=1;