6.2. Описание протокола обмена

Описание протокола v20.8

6.2.1. Описание протокола

Управление контроллером с ПК происходит по интерфейсу последовательного порта (COM-порт). На стороне контроллера жёстко установлены следующие параметры COM-порта:

  • Скорость – 115200 бод
  • Длина кадра – 8 бит
  • Стоп-биты – 2 бита
  • Чётность – нет
  • Контроль потока – нет (Xon/Xoff, CTS/RTS не используются)
  • Таймаут на получение, между байтами одного пакета – 400 мсек
  • Порядок следования бит – LittleEndian
  • Многобайтовые типы данных передаются младшим байтом вперёд

6.2.2. Исполнение команд

Базовый принцип протокола - «Запрос-Ответ», причём все обмены данными инициируются ПК, т.е. ПК посылает команды в контроллер, но не наоборот. Каждая команда подразумевает получение ответа от контроллера (кроме редких случаев специальных команд), т.е. нельзя послать несколько команд подряд, без ожидания ответа на них.

Все команды делятся на сервисные, штатные управляющие и штатные информационные. Команды выполняются сразу после их поступления в контроллер. Установленные командой SХХХ параметры начинают влиять на текущее движение в течение 1 мс после установки. Обработка команды не влияет на своевременность выполнения контроллером действий связанных с оперативным управление и контролем двигателя (работа ШИМ, взаимодействие с энкодером и т.п.).

И контроллер и ПК обладают буфером обмена. Принятые команды и данные, в случае их наличия в команде, обрабатываются один раз. То есть, после обработки эти данные удаляются из буфера и обрабатываются уже новые пришедшие байты. Каждая команда состоит из четырёхбайтной строки, данных (если команда их предусматривает) и двухбайтного кода контроля CRC если команда содержит данные. Данные могут пересылаться как из компьютера, так и контроллером. Команда передаётся на обработку если она распознана и, в случае передачи данных, код CRC верный. После обработки пришедшей без ошибок команды контроллер посылает в компьютер четырехбайтную строку – наименование выполненной команды, затем данные, если формат команды это предусматривает, затем два байта CRC (если есть данные).

6.2.3. Обработка ошибок на стороне контроллера

6.2.3.1. Неверные команды или данные

Если пришедшая в контроллер команда не может быть интерпретирована, как определенная команда управления, то в компьютер посылается строка «errc», команда игнорируется, в данных текущего состояния контроллера выставляется бит «команда не распознана». Если неопознанная команда содержала данные, то возможно неверная интерпретация принятых данных как новых команд. Необходима синхронизация.

Если пришедшая в контроллер команда интерпретирована верно, команда предусматривала данные, они пришли, но два байта CRC не соответствует полученным с ней данным, то в данных текущего состояния контроллера устанавливается флаг ошибки CRC пришедших данных, в компьютер посылается строка «errd», текущая команда игнорируется. Синхронизация приёма/передачи с компьютером не нужна.

6.2.3.2. Расчёт CRC

CRC рассчитывается для передаваемых данных. Четыре байта команды в расчёте не участвуют. Алгоритм CRC на языке Си:

unsigned short CRC16(INT8U *pbuf, unsigned short n)
{
  unsigned short crc, i, j, carry_flag, a;
  crc = 0xffff;
  for(i = 0; i < n; i++)
  {
    crc = crc ^ pbuf[i];
    for(j = 0; j < 8; j++)
    {
      a = crc;
      carry_flag = a & 0x0001;
      crc = crc >> 1;
      if ( carry_flag == 1 ) crc = crc ^ 0xa001;
    }
  }
  return crc;
}

Функция получает указатель на массив данных pbuf, длину данных в байтах n. Функция возвращает двубайтное слово - код CRC.

Пример расчёта CRC:

Код команды (CMD): «home» или 0x656D6F68

0x68 0x6F 0x6D 0x65
CMD

Код команды (CMD): «gpos» или 0x736F7067

0x67 0x70 0x6F 0x73
CMD

Код команды (CMD): «movr» или 0x72766F6D

0x6D 0x6F 0x76 0x72  0x00 0x00 0x00 0xC8  0x00 0x00  0x00 0x00 0x00 0x00 0x00 0x00  0x53 0xc7
CMD                  DeltaPosition        uDPos      Reserved                       CRC
../../_images/crc.png

6.2.3.3. Сбои передачи

Наиболее вероятны следующие сбои в канале связи: исчезновение байта при приёме или передаче контроллером, возникновение лишнего байта при приёме или передаче контроллером и изменение принятого или посланного байта.Сбои происходят при нестандартных условиях и обычно не наблюдаются вообще.

Регулярные сбои возможны при некачественном, сломанном кабеле USB или соединительном кабеле между платами. Протокол не разрабатывался для штатного применения в условиях сильно нестабильной связи. В частности в таких условиях редко возможно выполнение не той команды, что была послана.

Исчезновение байта на стороне контроллера

Байт, ожидаемый, но не полученный контроллером, приводит к таймауту компьютера. Посылка команды считается компьютером неуспешной. На этот момент синхронизация передачи данных будет нарушена, но восстановится по таймауту (если таймаут контроллера меньше таймаута компьютера с учётом времени пересылки).

Исчезновение байта на стороне компьютера

Байт, не полученный компьютером, приводит к таймауту компьютера. Синхронизация не нарушена.

Возникновение байта на стороне контроллера

Лишний байт, возникший при приёме контроллером, приводит к получению компьютером одного или нескольких «errc» либо «errd» (очень редко сочетания «errc» и «errd»). Посылка команды считается неуспешной. В приёмном буфере компьютера может появиться несколько «errc» или «errd» ответов контроллера. На этот момент синхронизация нарушена.

Возникновение байта на стороне компьютера

Байт, возникший при приёме компьютером, приводит к неверно принятой команде или неверному коду CRC. Кроме того, в приёмном буфере останется лишний байт. На этот момент синхронизация нарушена.

Изменение байта на стороне контроллера

Байт, изменившийся при приёме контроллером, приводит к получению компьютером одного или нескольких «errc» либо «errd» (очень редко сочетания «errc» и «errd»). Посылка команды считается неуспешной. В приёмном буфере компьютера может появиться несколько «errc» либо «errd» ответов контроллера. Обычно синхронизация не нарушается, но редко она может быть нарушена.

Изменение байта на стороне компьютера

Байт, изменившийся при приёме компьютером, приводит к неверно принятой команде или неверному коду CRC. На этот момент синхронизация не нарушена.

6.2.3.4. Восстановление синхронизации методом таймаута

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

6.2.3.5. Восстановление синхронизации методом очистительных нулей

Ни одна команда не начинается нулём („\0“). Поэтому возможен такой метод синхронизации: контроллер на каждый полученный первый байт команды равный нулю отвечает нулём, а компьютер игнорирует первые байт ответа если он равен нулю и переходит к рассмотрению следующего. Тогда в случая когда синхронизация нарушена на стороне компьютера или контроллера, но еще не прошло время таймаута контроллера, возможен следующий алгоритм:

Если компьютером в ответ на переданную команду с данными или без, получен от контроллера ответ не на ту команду, «errc» либо «errd» , то с компьютера в контроллер средствами библиотеки посылается от 4 до 250 нулей (ограничение в 250 байт связано с длиной приёмного буфера и протоколом передачи данных по I2C, а передача менее 4 нулей часто не приведёт к восстановлению синхронизации). При этом происходит постоянное считывание приходящих байт от контроллера до появления первого нуля. После этого и считывание и посылка прекращаются.

Принятый нуль обычно не является частью предыдущей передачи, так как в моменты ошибок контроллер получает ответы «errc» / «errd». В редких случаях (особое изменение байта на стороне контроллера) возможна синхронизация с некоторой попытки. Таким образом, приход первого нуля обычно означает, что приёмный буфер контроллера чист и уже не заполнится, пока не придёт первая значимая команда. Сразу после прихода первого нуля от контроллера компьютер готов передавать следующую команду. Остальные нули, находящиеся в пересылке, будут проигнорированы, так как придут до ответа контроллера.

Синхронизация завершена.

6.2.4. Обработка ошибок на стороне библиотеки

Практически каждая функция библиотеки возвращает статус выполнения типа result_t.

После посылки запроса контроллеру библиотека проверяет первые приходящие байты пока не встретит первое ненулевое значение. Все нулевые байты игнорируются. Остальные приходящие байты считаются значимыми. Библиотека ожидает первые 4 байта ответа. Далее она сравнивает их с кодом запроса и, при необходимости, ожидает остальные байты пакета данных. Если полученные 4 байта не соответствуют запросу, то запускается процедура синхронизации очистительными нулями, команда выполнена неуспешно. Если полученные первые 4 байта совпадают с кодом запроса и в ответе есть еще данные, то после их получения проверяется CRC код. Если код неверный, то запускается синхронизация очистительными нулями, выполнение команды считается неуспешным.

Если ошибок не обнаружено, то команда считается выполненной успешно и возвращается result_ok.

../../_images/Synch.png

6.2.4.1. Возможные значения ответа библиотеки

  • result_ok. Ошибок нет.
  • result_error. Общая ошибка. Может быть связана с аппаратными проблемами, отсутствием данных в буфере порта, превышением таймаутов. Также может означать сбой синхронизации, который был устранён. Такой сбой мог быть вызван помехами на линии связи с контроллером. Еще одной причиной может быть несоответствие протоколов в прошивке и в контроллере.
  • result_nodevice. Невозможность открытия устройства, потеря связи с ним в процессе передачи данных, неудачная синхронизация. Требуется повторное открытие устройства или вмешательство пользователя.

Если функция возвращает ошибку, любые переданные в неё структуры для записи считаются неопределёнными. Возврат кода ошибки может сопровождаться записью подробного сообщения в системный лог на unix или в stderr на windows.

6.2.4.2. Процедура синхронизации очистительными нулями

Восстановление синхронизации осуществляется посылкой нулевых байтов и считывания принимаемых байт до появления первого нулевого значения („\0“). Опционально можно в конце синхронизации очистить буфер порта. Посылается изначально 64 нулевых байта. Если от контроллера не пришло ни одного нулевого байта за время таймаута, то 64 байта посылаются еще 3 раза. После 4 посылки и неполучения нулевого байта устройство считается потерянным и библиотека должна вернуть код ошибки result_nodevice. В случае удачной синхронизации возвращаемый код ошибки result_error.

6.2.5. Коды ошибок ответов контроллера

6.2.5.1. ERRC

Ответ: (4 байт)

Код: «errc» или 0x63727265

uint32_t errc Команда недоступна

Описание

Ответ на команду, в случае если команда неизвестна, либо не может быть выполнена и/или обработана в данный момент (в данном состоянии). Устанавливает соответствующий бит в поле «flags» структуры состояния.

6.2.5.2. ERRD

Ответ: (4 байт)

Код: «errd» или 0x64727265

uint32_t errd Неверные данные

Описание

Ответ на команду «errd», устанавливается в том случае, если вычислиные контроллером данные CRC не совпадают с полученым полем CRC. В этом случае устанавливается бит соответствия в поле «flags» структуры состояния.

6.2.5.3. ERRV

Ответ: (4 байт)

Код: «errv» или 0x76727265

uint32_t errv Неверное значение

Описание

Ответ на команду, в случае если команда корректна, контрольная сумма правильная, но передаваемые значения (хотя бы одно из них) выходят за допустимый диапазон и не могут быть приняты. При этом неверное значение заменяется одним из верных методами округления, ограничения или сбрасывания в некое стандартное состояние. Устанавливает соответствующий бит в поле «flags» структуры состояния.

6.2.6. Все команды контроллера

6.2.6.1. Команда GACC

Код команды (CMD): «gacc» или 0x63636167.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (114 байт)

uint32_t CMD Команда
int8_t MagneticBrakeInfo Производитель и номер магнитного тормоза, Максимальная длина строки: 24 символов.
float MBRatedVoltage Номинальное напряжение для управления магнитным тормозом (В). Тип данных: float.
float MBRatedCurrent Номинальный ток для управления магнитным тормозом (А). Тип данных: float.
float MBTorque Удерживающий момент (мН м). Тип данных: float.
uint32_t MBSettings Флаги настроек магнитного тормоза. Это битовая маска для побитовых операций.
  0x1 - MB_AVAILABLE Если флаг установлен, то магнитный тормоз доступен
  0x2 - MB_POWERED_HOLD Если флаг установлен, то магнитный тормоз находится в режиме удержания (активен) при подаче питания
int8_t TemperatureSensorInfo Производитель и номер температурного датчика, Максимальная длина строки: 24 символов.
float TSMin Минимальная измеряемая температура (град Цельсия). Тип данных: float.
float TSMax Максимальная измеряемая температура (град Цельсия) Тип данных: float.
float TSGrad Температурный градиент (В/град Цельсия). Тип данных: float.
uint32_t TSSettings Флаги настроек температурного датчика. Это битовая маска для побитовых операций.
  0x7 - TS_TYPE_BITS Биты, отвечающие за тип температурного датчика
  0x0 - TS_TYPE_UNKNOWN Неизвестный сенсор
  0x1 - TS_TYPE_THERMOCOUPLE Термопара
  0x2 - TS_TYPE_SEMICONDUCTOR Полупроводниковый температурный датчик
  0x8 - TS_AVAILABLE Если флаг установлен, то датчик температуры доступен
uint32_t LimitSwitchesSettings Флаги настроек концевых выключателей. Это битовая маска для побитовых операций.
  0x1 - LS_ON_SW1_AVAILABLE Если флаг установлен, то концевой переключатель, подключенный к ножке SW1, доступен
  0x2 - LS_ON_SW2_AVAILABLE Если флаг установлен, то концевой переключатель, подключенный к ножке SW2, доступен
  0x4 - LS_SW1_ACTIVE_LOW Если флаг установлен, то концевой переключатель, подключенный к ножке SW1, считается сработавшим по низкому уровню на контакте
  0x8 - LS_SW2_ACTIVE_LOW Если флаг установлен, то концевой переключатель, подключенный к ножке SW2, считается сработавшим по низкому уровню на контакте
  0x10 - LS_SHORTED Если флаг установлен, то концевые переключатели замкнуты
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение информации о дополнительных аксессуарах из EEPROM.

6.2.6.2. Команда GBRK

Код команды (CMD): «gbrk» или 0x6B726267.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (25 байт)

uint32_t CMD Команда
uint16_t t1 Время в мс между включением питания мотора и отключением тормоза.
uint16_t t2 Время в мс между отключением тормоза и готовностью к движению. Все команды движения начинают выполняться только по истечении этого времени.
uint16_t t3 Время в мс между остановкой мотора и включением тормоза.
uint16_t t4 Время в мс между включением тормоза и отключением питания мотора.
uint8_t BrakeFlags Флаги. Это битовая маска для побитовых операций.
  0x1 - BRAKE_ENABLED Управление тормозом включено, если флаг установлен.
  0x2 - BRAKE_ENG_PWROFF Тормоз отключает питание шагового мотора, если флаг установлен.
uint8_t Reserved [10] Зарезервировано (10 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек управления тормозом.

6.2.6.3. Команда GCAL

Код команды (CMD): «gcal» или 0x6C616367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (118 байт)

uint32_t CMD Команда
float CSS1_A Коэффициент масштабирования для аналоговых измерений тока в обмотке A.
float CSS1_B Коэффициент сдвига для аналоговых измерений тока в обмотке A.
float CSS2_A Коэффициент масштабирования для аналоговых измерений тока в обмотке B.
float CSS2_B Коэффициент сдвига для аналоговых измерений тока в обмотке B.
float FullCurrent_A Коэффициент масштабирования для аналоговых измерений полного тока.
float FullCurrent_B Коэффициент сдвига для аналоговых измерений полного тока.
uint8_t Reserved [88] Зарезервировано (88 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения калибровочных коэффициентов. Команда только для производителя. Эта функция заполняет структуру калибровочных коэффициентов. Эти коэффициенты используются для пересчёта кодов АЦП в токи обмоток и полный ток потребления. Коэффициенты сгруппированы в пары, XXX_A и XXX_B; пары представляют собой коэффициенты линейного уравнения. Первый коэффициент - тангенс угла наклона, второй - постоянное смещение. Таким образом, XXX_Current[mA] = XXX_A[mA/ADC]XXX_ADC_CODE[ADC] + XXX_B[mA].

6.2.6.4. Команда GCTL

Код команды (CMD): «gctl» или 0x6C746367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (93 байт)

uint32_t CMD Команда
uint32_t MaxSpeed Массив скоростей (в полных шагах), использующийся при управлении джойстиком или кнопками влево/вправо. Диапазон: 0..100000.
uint8_t uMaxSpeed Массив скоростей (в микрошагах), использующийся при управлении джойстиком или кнопками влево/вправо. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint16_t Timeout Timeout[i] - время в мс, по истечении которого устанавливается скорость max_speed[i+1] (используется только при управлении кнопками).
uint16_t MaxClickTime Максимальное время клика (в мс). До истечения этого времени первая скорость не включается.
uint16_t Flags Флаги. Это битовая маска для побитовых операций.
  0x3 - CONTROL_MODE_BITS Биты управления мотором с помощью джойстика или кнопок влево/вправо.
  0x0 - CONTROL_MODE_OFF Управление отключено.
  0x1 - CONTROL_MODE_JOY Управление с помощью джойстика.
  0x2 - CONTROL_MODE_LR Управление с помощью кнопок влево/вправо.
  0x4 - CONTROL_BTN_LEFT_PUSHED_OPEN Нажатая левая кнопка соответствует открытому контакту, если этот флаг установлен.
  0x8 - CONTROL_BTN_RIGHT_PUSHED_OPEN Нажатая правая кнопка соответствует открытому контакту, если этот флаг установлен.
int32_t DeltaPosition Смещение (дельта) позиции (в полных шагах)
int16_t uDeltaPosition Дробная часть смещения в микрошагах. Используется только с шаговым двигателем. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint8_t Reserved [9] Зарезервировано (9 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек управления мотором. При выборе CTL_MODE=1 включается управление мотором с помощью джойстика. В этом режиме при отклонении джойстика на максимум двигатель стремится двигаться со скоростью MaxSpeed [i], где i=0, если предыдущим использованием этого режима не было выбрано другое i. Кнопки переключают номер скорости i. При выборе CTL_MODE=2 включается управление мотором с помощью кнопок left/right. При нажатии на кнопки двигатель начинает двигаться в соответствующую сторону со скоростью MaxSpeed [0], по истечении времени Timeout[i] мотор двигается со скоростью MaxSpeed [i+1]. При переходе от MaxSpeed [i] на MaxSpeed [i+1] действует ускорение, как обычно.

6.2.6.5. Команда GCTP

Код команды (CMD): «gctp» или 0x70746367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (18 байт)

uint32_t CMD Команда
uint8_t CTPMinError Минимальное отличие шагов ШД от положения энкодера, устанавливающее флаг STATE_RT_ERROR. Измеряется в шагах ШД.
uint8_t CTPFlags Флаги. Это битовая маска для побитовых операций.
  0x1 - CTP_ENABLED Контроль позиции включен, если флаг установлен.
  0x2 - CTP_BASE Управление положением основано на датчике вращения, если установлен этот флаг; в противном случае - на энкодере.
  0x4 - CTP_ALARM_ON_ERROR Войти в состояние ALARM при расхождении позиции, если флаг установлен.
  0x8 - REV_SENS_INV Сенсор считается активным, когда на нём 0, инвертирование делает активным уровень 1. То есть если не инвертировать, то действует обычная логика - 0 это срабатывание/активация/активное состояние.
  0x10 - CTP_ERROR_CORRECTION Корректировать ошибки, возникающие при проскальзывании, если флаг установлен. Работает только с энкодером. Несовместимо с флагом CTP_ALARM_ON_ERROR.
uint8_t Reserved [10] Зарезервировано (10 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек контроля позиции(для шагового двигателя). При управлении ШД с энкодером (CTP_BASE 0) появляется возможность обнаруживать потерю шагов. Контроллер знает кол-во шагов на оборот (GENG::StepsPerRev) и разрешение энкодера (GFBS::IPT). При включении контроля (флаг CTP_ENABLED), контроллер запоминает текущую позицию в шагах ШД и текущую позицию энкодера. Далее, на каждом шаге позиция энкодера преобразовывается в шаги и, если разница оказывается больше CTPMinError, устанавливается флаг STATE_CTP_ERROR. При управлении ШД с датчиком оборотов (CTP_BASE 1), позиция контролируется по нему. По активному фронту на входе синхронизации контроллер запоминает текущее значение шагов. Далее, при каждом обороте проверяет, на сколько шагов сместились. При рассогласовании более CTPMinError устанавливается флаг STATE_CTP_ERROR.

6.2.6.6. Команда GEAS

Код команды (CMD): «geas» или 0x73616567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (54 байт)

uint32_t CMD Команда
uint16_t stepcloseloop_Kw Коэффициент смешения реальной и заданной скорости, диапазон [0, 100], значение по умолчанию 50.
uint16_t stepcloseloop_Kp_low Обратная связь по позиции в зоне малых скоростей, диапазон [0, 65535], значение по умолчанию 1000.
uint16_t stepcloseloop_Kp_high Обратная связь по позиции в зоне больших скоростей, диапазон [0, 65535], значение по умолчанию 33.
uint8_t Reserved [42] Зарезервировано (42 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение расширенных настроек.

6.2.6.7. Команда GEDS

Код команды (CMD): «geds» или 0x73646567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (26 байт)

uint32_t CMD Команда
uint8_t BorderFlags Флаги, определяющие тип границ и поведение мотора при их достижении. Это битовая маска для побитовых операций.
  0x1 - BORDER_IS_ENCODER Если флаг установлен, границы определяются предустановленными точками на шкале позиции. Если флаг сброшен, границы определяются концевыми выключателями.
  0x2 - BORDER_STOP_LEFT Если флаг установлен, мотор останавливается при достижении левой границы.
  0x4 - BORDER_STOP_RIGHT Если флаг установлен, мотор останавливается при достижении правой границы.
  0x8 - BORDERS_SWAP_MISSET_DETECTION Если флаг установлен, мотор останавливается при достижении обоих границ. Нужен для предотвращения поломки двигателя при неправильных настройках концевых выключателей
uint8_t EnderFlags Флаги, определяющие настройки концевых выключателей. Это битовая маска для побитовых операций.
  0x1 - ENDER_SWAP Если флаг установлен, первый концевой выключатель находится справа; иначе - слева.
  0x2 - ENDER_SW1_ACTIVE_LOW 1 - Концевой переключатель, подключенный к ножке SW1, считается сработавшим по низкому уровню на контакте.
  0x4 - ENDER_SW2_ACTIVE_LOW 1 - Концевой переключатель, подключенный к ножке SW2, считается сработавшим по низкому уровню на контакте.
int32_t LeftBorder Позиция левой границы, используется если установлен флаг BORDER_IS_ENCODER.
int16_t uLeftBorder Позиция левой границы в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
int32_t RightBorder Позиция правой границы, используется если установлен флаг BORDER_IS_ENCODER.
int16_t uRightBorder Позиция правой границы в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек границ и концевых выключателей.

6.2.6.8. Команда GEIO

Код команды (CMD): «geio» или 0x6F696567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (18 байт)

uint32_t CMD Команда
uint8_t EXTIOSetupFlags Флаги настройки работы внешнего ввода-вывода. Это битовая маска для побитовых операций.
  0x1 - EXTIO_SETUP_OUTPUT Если флаг установлен, то ножка в состоянии вывода, иначе - ввода.
  0x2 - EXTIO_SETUP_INVERT Если флаг установлен, то нули считаются активным состоянием выхода, а спадающие фронты как момент подачи входного сигнала.
uint8_t EXTIOModeFlags Флаги настройки режимов внешнего ввода-вывода. Это битовая маска для побитовых операций.
  0xf - EXTIO_SETUP_MODE_IN_BITS Биты, отвечающие за поведение при переходе сигнала в активное состояние.
  0x0 - EXTIO_SETUP_MODE_IN_NOP Ничего не делать.
  0x1 - EXTIO_SETUP_MODE_IN_STOP По переднему фронту входного сигнала делается остановка двигателя (эквивалент команды STOP).
  0x2 - EXTIO_SETUP_MODE_IN_PWOF Выполняет команду PWOF, обесточивая обмотки двигателя.
  0x3 - EXTIO_SETUP_MODE_IN_MOVR Выполняется команда MOVR с последними настройками.
  0x4 - EXTIO_SETUP_MODE_IN_HOME Выполняется команда HOME.
  0x5 - EXTIO_SETUP_MODE_IN_ALARM Войти в состояние ALARM при переходе сигнала в активное состояние.
  0xf0 - EXTIO_SETUP_MODE_OUT_BITS Биты выбора поведения на выходе.
  0x0 - EXTIO_SETUP_MODE_OUT_OFF Ножка всегда в неактивном состоянии.
  0x10 - EXTIO_SETUP_MODE_OUT_ON Ножка всегда в активном состоянии.
  0x20 - EXTIO_SETUP_MODE_OUT_MOVING Ножка находится в активном состоянии при движении.
  0x30 - EXTIO_SETUP_MODE_OUT_ALARM Ножка находится в активном состоянии при нахождении в состоянии ALARM.
  0x40 - EXTIO_SETUP_MODE_OUT_MOTOR_ON Ножка находится в активном состоянии при подаче питания на обмотки.
uint8_t Reserved [10] Зарезервировано (10 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения параметров настройки режимов внешнего ввода/вывода.

6.2.6.9. Команда GEMF

Код команды (CMD): «gemf» или 0x666D6567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (48 байт)

uint32_t CMD Команда
float L Индуктивность обмоток двигателя.
float R Сопротивление обмоток двигателя.
float Km Электромеханический коэффициент двигателя.
uint8_t BackEMFFlags Флаги автонастроек шагового двигателя. Это битовая маска для побитовых операций.
  0x1 - BACK_EMF_INDUCTANCE_AUTO Флаг автоопределения индуктивности обмоток двигателя.
  0x2 - BACK_EMF_RESISTANCE_AUTO Флаг автоопределения сопротивления обмоток двигателя.
  0x4 - BACK_EMF_KM_AUTO Флаг автоопределения электромеханического коэффициента двигателя.
uint8_t Reserved [29] Зарезервировано (29 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение электромеханических настроек шагового двигателя. Настройки различны для разных двигателей.

6.2.6.10. Команда GENG

Код команды (CMD): «geng» или 0x676E6567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (34 байт)

uint32_t CMD Команда
uint16_t NomVoltage Номинальное напряжение мотора в десятках мВ. Контроллер будет сохранять напряжение на моторе не выше номинального, если установлен флаг ENGINE_LIMIT_VOLT (используется только с DC двигателем).
uint16_t NomCurrent Номинальный ток через мотор (в мА). Ток стабилизируется для шаговых и может быть ограничен для DC(если установлен флаг ENGINE_LIMIT_CURR). Диапазон: 15..8000
uint32_t NomSpeed Номинальная (максимальная) скорость (в целых шагах/с или rpm для DC и шагового двигателя в режиме ведущего энкодера). Контроллер будет сохранять скорость мотора не выше номинальной, если установлен флаг ENGINE_LIMIT_RPM. Диапазон: 1..100000.
uint8_t uNomSpeed Микрошаговая часть номинальной скорости мотора (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint16_t EngineFlags Флаги, управляющие работой мотора. Это битовая маска для побитовых операций.
  0x1 - ENGINE_REVERSE Флаг реверса. Связывает направление вращения мотора с направлением счета текущей позиции. При сброшенном флаге (по умолчанию) прикладываемое к мотору положительное напряжение увеличивает счетчик позиции. И наоборот, при установленном флаге счетчик позиции увеличивается, когда к мотору приложено отрицательное напряжение. Измените состояние флага, если положительное вращение мотора уменьшает счетчик позиции.
  0x2 - ENGINE_CURRENT_AS_RMS Флаг интерпретации значения тока. Если флаг снят, то задаваемое значение тока интерпретируется как максимальная амплитуда тока. Если флаг установлен, то задаваемое значение тока интерпретируется как среднеквадратичное значение тока (для шагового) или как значение тока, посчитанное из максимального тепловыделения (BLDC).
  0x4 - ENGINE_MAX_SPEED Флаг максимальной скорости. Если флаг установлен, движение происходит на максимальной скорости.
  0x8 - ENGINE_ANTIPLAY Компенсация люфта. Если флаг установлен, позиционер будет подходить к заданной точке всегда с одной стороны. Например, при подходе слева никаких дополнительных действий не совершается, а при подходе справа позиционер проходит целевую позицию на заданное расстояния и возвращается к ней опять же справа.
  0x10 - ENGINE_ACCEL_ON Ускорение. Если флаг установлен, движение происходит с ускорением.
  0x20 - ENGINE_LIMIT_VOLT Номинальное напряжение мотора. Если флаг установлен, напряжение на моторе ограничивается заданным номинальным значением(используется только с DC двигателем).
  0x40 - ENGINE_LIMIT_CURR Номинальный ток мотора. Если флаг установлен, ток через мотор ограничивается заданным номинальным значением(используется только с DC двигателем).
  0x80 - ENGINE_LIMIT_RPM Номинальная частота вращения мотора. Если флаг установлен, частота вращения ограничивается заданным номинальным значением.
int16_t Antiplay Количество шагов двигателя или импульсов энкодера, на которое позиционер будет отъезжать от заданной позиции для подхода к ней с одной и той же стороны. Используется, если установлен флаг ENGINE_ANTIPLAY.
uint8_t MicrostepMode Настройки микрошагового режима(используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Это битовая маска для побитовых операций.
  0x1 - MICROSTEP_MODE_FULL Полношаговый режим.
  0x2 - MICROSTEP_MODE_FRAC_2 Деление шага 1/2.
  0x3 - MICROSTEP_MODE_FRAC_4 Деление шага 1/4.
  0x4 - MICROSTEP_MODE_FRAC_8 Деление шага 1/8.
  0x5 - MICROSTEP_MODE_FRAC_16 Деление шага 1/16.
  0x6 - MICROSTEP_MODE_FRAC_32 Деление шага 1/32.
  0x7 - MICROSTEP_MODE_FRAC_64 Деление шага 1/64.
  0x8 - MICROSTEP_MODE_FRAC_128 Деление шага 1/128.
  0x9 - MICROSTEP_MODE_FRAC_256 Деление шага 1/256.
uint16_t StepsPerRev Количество полных шагов на оборот(используется только с шаговым двигателем). Диапазон: 1..65535.
uint8_t Reserved [12] Зарезервировано (12 байт)
uint16_t CRC Контрольная сумма

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

6.2.6.11. Команда GENI

Код команды (CMD): «geni» или 0x696E6567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение информации об энкодере из EEPROM.

6.2.6.12. Команда GENS

Код команды (CMD): «gens» или 0x736E6567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (54 байт)

uint32_t CMD Команда
float MaxOperatingFrequency Максимальная частота (кГц). Тип данных: float.
float SupplyVoltageMin Минимальное напряжение питания (В). Тип данных: float.
float SupplyVoltageMax Максимальное напряжение питания (В). Тип данных: float.
float MaxCurrentConsumption Максимальное потребление тока (мА). Тип данных: float.
uint32_t PPR Количество отсчётов на оборот
uint32_t EncoderSettings Флаги настроек энкодера. Это битовая маска для побитовых операций.
  0x1 - ENCSET_DIFFERENTIAL_OUTPUT Если флаг установлен, то энкодер имеет дифференциальный выход, иначе - несимметричный выход
  0x4 - ENCSET_PUSHPULL_OUTPUT Если флаг установлен, то энкодер имеет двухтактный выход, иначе - выход с открытым коллектором
  0x10 - ENCSET_INDEXCHANNEL_PRESENT Если флаг установлен, то энкодер имеет дополнительный индексный канал, иначе - он отсутствует
  0x40 - ENCSET_REVOLUTIONSENSOR_PRESENT Если флаг установлен, то энкодер имеет датчик оборотов, иначе - он отсутствует
  0x100 - ENCSET_REVOLUTIONSENSOR_ACTIVE_HIGH Если флаг установлен, то активное состояние датчика оборотов соответствует логической 1, иначе - логическому 0
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек энкодера из EEPROM.

6.2.6.13. Команда GENT

Код команды (CMD): «gent» или 0x746E6567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (14 байт)

uint32_t CMD Команда
uint8_t EngineType Тип мотора. Это битовая маска для побитовых операций.
  0x0 - ENGINE_TYPE_NONE Это значение не нужно использовать.
  0x1 - ENGINE_TYPE_DC Мотор постоянного тока.
  0x2 - ENGINE_TYPE_2DC Два мотора постоянного тока, что приводит к эмуляции двух контроллеров.
  0x3 - ENGINE_TYPE_STEP Шаговый мотор.
  0x4 - ENGINE_TYPE_TEST Продолжительность включения фиксирована. Используется только производителем.
  0x5 - ENGINE_TYPE_BRUSHLESS Бесщеточный мотор.
uint8_t DriverType Тип силового драйвера. Это битовая маска для побитовых операций.
  0x1 - DRIVER_TYPE_DISCRETE_FET Силовой драйвер на дискретных мосфет-ключах. Используется по умолчанию.
  0x2 - DRIVER_TYPE_INTEGRATE Силовой драйвер с использованием ключей, интегрированных в микросхему.
  0x3 - DRIVER_TYPE_EXTERNAL Внешний силовой драйвер.
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Описание: Возвращает информацию о типе мотора и силового драйвера.

6.2.6.14. Команда GEST

Код команды (CMD): «gest» или 0x74736567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (46 байт)

uint32_t CMD Команда
uint16_t Param1  
uint8_t Reserved [38] Зарезервировано (38 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение расширенных настроек. В настоящее время не используется.

6.2.6.15. Команда GFBS

Код команды (CMD): «gfbs» или 0x73626667.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (18 байт)

uint32_t CMD Команда
uint16_t IPS Количество отсчётов энкодера на оборот вала. Диапазон: 1..65535. Поле устарело, рекомендуется записывать 0 в IPS и использовать расширенное поле CountsPerTurn. Может потребоваться обновление микропрограммы контроллера до последней версии.
uint8_t FeedbackType Тип обратной связи. Это битовая маска для побитовых операций.
  0x1 - FEEDBACK_ENCODER Обратная связь с помощью энкодера.
  0x4 - FEEDBACK_EMF Обратная связь по ЭДС.
  0x5 - FEEDBACK_NONE Обратная связь отсутствует.
  0x6 - FEEDBACK_ENCODER_MEDIATED Обратная связь по энкодеру, опосредованному относительно двигателя механической передачей (например, винтовой передачей).
uint8_t FeedbackFlags Флаги. Это битовая маска для побитовых операций.
  0x1 - FEEDBACK_ENC_REVERSE Обратный счет у энкодера.
  0xc0 - FEEDBACK_ENC_TYPE_BITS Биты, отвечающие за тип энкодера.
  0x0 - FEEDBACK_ENC_TYPE_AUTO Определяет тип энкодера автоматически.
  0x40 - FEEDBACK_ENC_TYPE_SINGLE_ENDED Недифференциальный энкодер.
  0x80 - FEEDBACK_ENC_TYPE_DIFFERENTIAL Дифференциальный энкодер.
uint32_t CountsPerTurn Количество отсчётов энкодера на оборот вала. Диапазон: 1..4294967295. Для использования поля CountsPerTurn нужно записать 0 в поле IPS, иначе будет использоваться значение из поля IPS.
uint8_t Reserved [4] Зарезервировано (4 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек обратной связи.

6.2.6.16. Команда GGRI

Код команды (CMD): «ggri» или 0x69726767.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение информации о редукторе из EEPROM.

6.2.6.17. Команда GGRS

Код команды (CMD): «ggrs» или 0x73726767.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (58 байт)

uint32_t CMD Команда
float ReductionIn Входной коэффициент редуктора. (Выход = (ReductionOut/ReductionIn) вход) Тип данных: float.
float ReductionOut Выходной коэффициент редуктора. (Выход = (ReductionOut/ReductionIn) вход) Тип данных: float.
float RatedInputTorque Максимальный крутящий момент (Н м). Тип данных: float.
float RatedInputSpeed Максимальная скорость на входном валу редуктора (об/мин). Тип данных: float.
float MaxOutputBacklash Выходной люфт редуктора (градус). Тип данных: float.
float InputInertia Эквивалентная входная инерция редуктора(г см2). Тип данных: float.
float Efficiency КПД редуктора (%). Тип данных: float.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек редуктора из EEPROM.

6.2.6.18. Команда GHOM

Код команды (CMD): «ghom» или 0x6D6F6867.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (33 байт)

uint32_t CMD Команда
uint32_t FastHome Скорость первого движения (в полных шагах). Диапазон: 0..100000.
uint8_t uFastHome Дробная часть скорости первого движения в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint32_t SlowHome Скорость второго движения (в полных шагах). Диапазон: 0..100000.
uint8_t uSlowHome Дробная часть скорости второго движения в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
int32_t HomeDelta Расстояние отхода от точки останова (в полных шагах).
int16_t uHomeDelta Дробная часть расстояния отхода от точки останова в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint16_t HomeFlags Набор флагов, определяющие такие параметры, как направление и условия останова. Это битовая маска для побитовых операций.
  0x1 - HOME_DIR_FIRST Определяет направление первоначального движения мотора после поступления команды HOME. Если флаг установлен - вправо; иначе - влево.
  0x2 - HOME_DIR_SECOND Определяет направление второго движения мотора. Если флаг установлен - вправо; иначе - влево.
  0x4 - HOME_MV_SEC_EN Если флаг установлен, реализуется второй этап доводки в домашнюю позицию; иначе - этап пропускается.
  0x8 - HOME_HALF_MV Если флаг установлен, в начале второго движения первые пол оборота сигналы завершения движения игнорируются.
  0x30 - HOME_STOP_FIRST_BITS Биты, отвечающие за выбор сигнала завершения первого движения.
  0x10 - HOME_STOP_FIRST_REV Первое движение завершается по сигналу с Revolution sensor.
  0x20 - HOME_STOP_FIRST_SYN Первое движение завершается по сигналу со входа синхронизации.
  0x30 - HOME_STOP_FIRST_LIM Первое движение завершается по сигналу с концевого переключателя.
  0xc0 - HOME_STOP_SECOND_BITS Биты, отвечающие за выбор сигнала завершения второго движения.
  0x40 - HOME_STOP_SECOND_REV Второе движение завершается по сигналу с Revolution sensor.
  0x80 - HOME_STOP_SECOND_SYN Второе движение завершается по сигналу со входа синхронизации.
  0xc0 - HOME_STOP_SECOND_LIM Второе движение завершается по сигналу с концевого переключателя.
  0x100 - HOME_USE_FAST Если флаг установлен, используется быстрый поиск домашней позиции; иначе - традиционный.
uint8_t Reserved [9] Зарезервировано (9 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения настроек для подхода в home position. Эта функция заполняет структуру настроек, использующихся для калибровки позиции, в память контроллера.

6.2.6.19. Команда GHSI

Код команды (CMD): «ghsi» или 0x69736867.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение информации о датчиках Холла из EEPROM.

6.2.6.20. Команда GHSS

Код команды (CMD): «ghss» или 0x73736867.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (50 байт)

uint32_t CMD Команда
float MaxOperatingFrequency Максимальная частота (кГц). Тип данных: float.
float SupplyVoltageMin Минимальное напряжение питания (В). Тип данных: float.
float SupplyVoltageMax Максимальное напряжение питания (В). Тип данных: float.
float MaxCurrentConsumption Максимальное потребление тока (мА). Тип данных: float.
uint32_t PPR Количество отсчётов на оборот
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек датчиков Холла из EEPROM.

6.2.6.21. Команда GJOY

Код команды (CMD): «gjoy» или 0x796F6A67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (22 байт)

uint32_t CMD Команда
uint16_t JoyLowEnd Значение в шагах джойстика, соответствующее нижней границе диапазона отклонения устройства. Должно лежать в пределах. Диапазон: 0..10000.
uint16_t JoyCenter Значение в шагах джойстика, соответствующее неотклонённому устройству. Должно лежать в пределах. Диапазон: 0..10000.
uint16_t JoyHighEnd Значение в шагах джойстика, соответствующее верхней границе диапазона отклонения устройства. Должно лежать в пределах. Диапазон: 0..10000.
uint8_t ExpFactor Фактор экспоненциальной нелинейности отклика джойстика.
uint8_t DeadZone Отклонение от среднего положения, которое не вызывает начала движения (в десятых долях процента). Максимальное мёртвое отклонение +-25.5%, что составляет половину рабочего диапазона джойстика.
uint8_t JoyFlags Флаги управления джойстиком. Это битовая маска для побитовых операций.
  0x1 - JOY_REVERSE Реверс воздействия джойстика. Отклонение джойстика к большим значениям приводит к отрицательной скорости и наоборот.
uint8_t Reserved [7] Зарезервировано (7 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек джойстика. При отклонении джойстика более чем на DeadZone от центрального положения начинается движение со скоростью, определяемой отклонением джойстика от DeadZone до 100% отклонения, причем отклонению DeadZone соответствует нулевая скорость, а 100% отклонения соответствует MaxSpeed [i] (см. команду SCTL), где i=0, если предыдущим использованием этого режима не было выбрано другое i. Если следующая скорость в таблице скоростей нулевая (целая и микрошаговая части), то перехода на неё не происходит. DeadZone вычисляется в десятых долях процента отклонения от центра (JoyCenter) до правого или левого максимума. Диапазоны DeadZone показаны на следующем рисунке.

../../_images/range25p.png

Зависимость между отклонением и скоростью экспоненциальная, что позволяет без переключения режимов скорости сочетать высокую подвижность и точность. На графике ниже показан пример экспоненциальной зависимости скорости и работы мертвой зоны:

../../_images/ExpJoystick.png

Параметр нелинейнойсти можно менять. Нулевой параметр нелинейности соответствует линейной зависимости.

6.2.6.22. Команда GMOV

Код команды (CMD): «gmov» или 0x766F6D67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (30 байт)

uint32_t CMD Команда
uint32_t Speed Заданная скорость (для ШД: шагов/c, для DC: rpm). Диапазон: 0..100000.
uint8_t uSpeed Заданная скорость в единицах деления микрошага в секунду. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым мотором.
uint16_t Accel Ускорение, заданное в шагах в секунду^2 (ШД) или в оборотах в минуту за секунду (DC). Диапазон: 1..65535.
uint16_t Decel Торможение, заданное в шагах в секунду^2 (ШД) или в оборотах в минуту за секунду (DC). Диапазон: 1..65535.
uint32_t AntiplaySpeed Скорость в режиме антилюфта, заданная в целых шагах/c (ШД) или в оборотах/с(DC). Диапазон: 0..100000.
uint8_t uAntiplaySpeed Скорость в режиме антилюфта, выраженная в микрошагах в секунду. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым мотором.
uint8_t MoveFlags Флаги, управляющие настройкой движения. Это битовая маска для побитовых операций.
  0x1 - RPM_DIV_1000 Флаг указывает на то что рабочая скорость указанная в команде задана в милли rpm. Применим только для режима обратной связи ENCODER и только для BLDC моторов.
uint8_t Reserved [9] Зарезервировано (9 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения настроек перемещения (скорость, ускорение, threshold и скорость в режиме антилюфта).

6.2.6.23. Команда GMTI

Код команды (CMD): «gmti» или 0x69746D67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение информации о двигателе из EEPROM.

6.2.6.24. Команда GMTS

Код команды (CMD): «gmts» или 0x73746D67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (112 байт)

uint32_t CMD Команда
uint8_t MotorType Тип двигателя. Это битовая маска для побитовых операций.
  0x0 - MOTOR_TYPE_UNKNOWN Неизвестный двигатель
  0x1 - MOTOR_TYPE_STEP Шаговый двигатель
  0x2 - MOTOR_TYPE_DC DC двигатель
  0x3 - MOTOR_TYPE_BLDC BLDC двигатель
uint8_t ReservedField Зарезервировано
uint16_t Poles Кол-во пар полюсов у DС или BLDC двигателя или кол-во шагов на оборот для шагового двигателя.
uint16_t Phases Кол-во фаз у BLDC двигателя.
float NominalVoltage Номинальное напряжение на обмотке (В). Тип данных: float
float NominalCurrent Максимальный постоянный ток в обмотке для DC и BLDC двигателей, номинальный ток в обмотке для шаговых двигателей (А). Тип данных: float.
float NominalSpeed Не используется. Номинальная скорость (об/мин). Применяется для DC и BLDC двигателей. Тип данных: float.
float NominalTorque Номинальный крутящий момент (мН м). Применяется для DC и BLDC двигателей. Тип данных: float.
float NominalPower Номинальная мощность(Вт). Применяется для DC и BLDC двигателей. Тип данных: float.
float WindingResistance Сопротивление обмотки DC двигателя, каждой из двух обмоток шагового двигателя или каждой из трёх обмоток BLDC двигателя (Ом). Тип данных: float.
float WindingInductance Индуктивность обмотки DC двигателя, каждой из двух обмоток шагового двигателя или каждой из трёх обмоток BLDC двигателя (мГн). Тип данных: float.
float RotorInertia Инерция ротора (г cм2). Тип данных: float.
float StallTorque Крутящий момент удержания позиции для шагового двигателя или крутящий момент при неподвижном роторе для других типов двигателей (мН м). Тип данных: float.
float DetentTorque Момент удержания позиции с незапитанными обмотками (мН м). Тип данных: float.
float TorqueConstant Константа крутящего момента, определяющая коэффициент пропорциональности максимального момента силы ротора от протекающего в обмотке тока (мН м/А). Используется в основном для DC двигателей. Тип данных: float.
float SpeedConstant Константа скорости, определяющая значение или амплитуду напряжения наведённой индукции при вращении ротора DC или BLDC двигателя (об/мин / В) или шагового двигателя (шаг/с / В). Тип данных: float.
float SpeedTorqueGradient Градиент крутящего момента (об/мин / мН м). Тип данных: float.
float MechanicalTimeConstant Механическая постоянная времени (мс). Тип данных: float.
float MaxSpeed Максимальная разрешённая скорость для шаговых двигателей (шаг/с) или для DC и BLDC двигателей (об/мин). Тип данных: float.
float MaxCurrent Максимальный ток в обмотке (А). Тип данных: float.
float MaxCurrentTime Безопасная длительность максимального тока в обмотке (мс). Тип данных: float.
float NoLoadCurrent Ток потребления в холостом режиме (А). Применяется для DC и BLDC двигателей. Тип данных: float.
float NoLoadSpeed Скорость в холостом режиме (об/мин). Применяется для DC и BLDC двигателей. Тип данных: float.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек двигателя из EEPROM.

6.2.6.25. Команда GNET

Код команды (CMD): «gnet» или 0x74656E67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (38 байт)

uint32_t CMD Команда
uint8_t DHCPEnabled Определяет способ получения IP-адреса каналов. Может принимать значения: 0 — статически, 1 — через DHCP.
uint8_t IPv4Address IP-адрес устройства в формате x.x.x.x.
uint8_t SubnetMask Маска подсети в формате x.x.x.x.
uint8_t DefaultGateway Шлюз сети по умолчанию в формате x.x.x.x.
uint8_t Reserved [19] Зарезервировано (19 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения сететвых настроек. Только для производителя. Эта функция возвращает текущие сетевые настройки.

6.2.6.26. Команда GNME

Код команды (CMD): «gnme» или 0x656D6E67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (30 байт)

uint32_t CMD Команда
int8_t PositionerName Пользовательское имя подвижки. Может быть установлено пользователем для его удобства. Максимальная длина строки: 16 символов.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение пользовательского имени подвижки из EEPROM.

6.2.6.27. Команда GNMF

Код команды (CMD): «gnmf» или 0x666D6E67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (30 байт)

uint32_t CMD Команда
int8_t ControllerName Пользовательское имя контроллера. Может быть установлено пользователем для его удобства. Максимальная длина строки: 16 символов.
uint8_t CtrlFlags Настройки контроллера. Это битовая маска для побитовых операций.
  0x1 - EEPROM_PRECEDENCE Если флаг установлен, то настройки в EEPROM подвижки имеют приоритет над текущими настройками и заменяют их при обнаружении EEPROM.
uint8_t Reserved [7] Зарезервировано (7 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение пользовательского имени контроллера и настроек из FRAM.

6.2.6.28. Команда GNVM

Код команды (CMD): «gnvm» или 0x6D766E67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (36 байт)

uint32_t CMD Команда
uint32_t UserData Пользовательские данные. Могут быть установлены пользователем для его удобства. Каждый элемент массива хранит только 32 бита пользовательских данных. Это важно на системах где тип int содержит больше чем 4 байта. Например это все системы amd64.
uint8_t Reserved [2] Зарезервировано (2 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение пользовательских данных из FRAM.

6.2.6.29. Команда GPID

Код команды (CMD): «gpid» или 0x64697067.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (48 байт)

uint32_t CMD Команда
uint16_t KpU Пропорциональный коэффициент ПИД контура по напряжению
uint16_t KiU Интегральный коэффициент ПИД контура по напряжению
uint16_t KdU Дифференциальный коэффициент ПИД контура по напряжению
float Kpf Пропорциональный коэффициент ПИД контура по позиции для BLDC
float Kif Интегральный коэффициент ПИД контура по позиции для BLDC
float Kdf Дифференциальный коэффициент ПИД контура по позиции для BLDC
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение ПИД коэффициентов. Эти коэффициенты определяют поведение позиционера. Коэффициенты различны для разных позиционеров.

6.2.6.30. Команда GPWD

Код команды (CMD): «gpwd» или 0x64777067.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (36 байт)

uint32_t CMD Команда
int8_t UserPassword Строчка-пароль для доступа к веб-странице, который пользователь может поменять с помощью USB команды или на веб-странице.
uint8_t Reserved [10] Зарезервировано (10 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения пароля к веб-странице. Только для производителя. Эта функция пользователяет прочитать пользовательский пароль к веб-странице из памяти контроллера.

6.2.6.31. Команда GPWR

Код команды (CMD): «gpwr» или 0x72777067.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (20 байт)

uint32_t CMD Команда
uint8_t HoldCurrent Ток мотора в режиме удержания, в процентах от номинального. Диапазон: 0..100.
uint16_t CurrReductDelay Время в мс от перехода в состояние STOP до уменьшения тока.
uint16_t PowerOffDelay Время в с от перехода в состояние STOP до отключения питания мотора.
uint16_t CurrentSetTime Время в мс, требуемое для набора номинального тока от 0% до 100%.
uint8_t PowerFlags Флаги параметров управления питанием. Это битовая маска для побитовых операций.
  0x1 - POWER_REDUCT_ENABLED Если флаг установлен, уменьшить ток по прошествии CurrReductDelay. Иначе - не уменьшать.
  0x2 - POWER_OFF_ENABLED Если флаг установлен, снять напряжение с обмоток по прошествии PowerOffDelay. Иначе - не снимать.
  0x4 - POWER_SMOOTH_CURRENT Если установлен, то запитывание обмоток, снятие питания или снижение/повышение тока происходят плавно со скоростью CurrentSetTime, а только потом выполняется та задача, которая вызвала это плавное изменение.
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения параметров питания мотора. Используется только с шаговым двигателем. Используется только с шаговым двигателем.

6.2.6.32. Команда GSEC

Код команды (CMD): «gsec» или 0x63657367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (28 байт)

uint32_t CMD Команда
uint16_t LowUpwrOff Нижний порог напряжения на силовой части для выключения, десятки мВ.
uint16_t CriticalIpwr Максимальный ток силовой части, вызывающий состояние ALARM, в мА.
uint16_t CriticalUpwr Максимальное напряжение на силовой части, вызывающее состояние ALARM, десятки мВ.
uint16_t CriticalT Максимальная температура контроллера, вызывающая состояние ALARM, в десятых долях градуса Цельсия.
uint16_t CriticalIusb Максимальный ток USB, вызывающий состояние ALARM, в мА.
uint16_t CriticalUusb Максимальное напряжение на USB, вызывающее состояние ALARM, десятки мВ.
uint16_t MinimumUusb Минимальное напряжение на USB, вызывающее состояние ALARM, десятки мВ.
uint8_t Flags Флаги критических параметров. Это битовая маска для побитовых операций.
  0x1 - ALARM_ON_DRIVER_OVERHEATING Если флаг установлен, то войти в состояние Alarm при получении сигнала подступающего перегрева с драйвера. Иначе - игнорировать подступающий перегрев с драйвера.
  0x2 - LOW_UPWR_PROTECTION Если установлен, то выключать силовую часть при напряжении меньшем LowUpwrOff.
  0x4 - H_BRIDGE_ALERT Если установлен, то выключать силовую часть при сигнале неполадки в одном из транзисторных мостов.
  0x8 - ALARM_ON_BORDERS_SWAP_MISSET Если флаг установлен, то войти в состояние Alarm при получении сигнала c противоположного концевого выключателя
  0x10 - ALARM_FLAGS_STICKING Если флаг установлен, то только по команде STOP возможен сброс всех флагов ALARM
  0x20 - USB_BREAK_RECONNECT Если флаг установлен, то будет включен блок перезагрузки USB при поломке связи
  0x40 - ALARM_WINDING_MISMATCH Если флаг установлен, то войти в состояние Alarm при получении сигнала рассогласования обмоток
  0x80 - ALARM_ENGINE_RESPONSE Если флаг установлен, то войти в состояние Alarm при получении сигнала ошибки реакции двигателя на управляющее воздействие
uint8_t Reserved [7] Зарезервировано (7 байт)
uint16_t CRC Контрольная сумма

Описание: Команда записи установок защит.

6.2.6.33. Команда GSNI

Код команды (CMD): «gsni» или 0x696E7367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (28 байт)

uint32_t CMD Команда
uint8_t SyncInFlags Флаги синхронизации входа. Это битовая маска для побитовых операций.
  0x1 - SYNCIN_ENABLED Включение необходимости импульса синхронизации для начала движения.
  0x2 - SYNCIN_INVERT Если установлен - срабатывает по переходу из 1 в 0. Иначе - из 0 в 1.
  0x4 - SYNCIN_GOTOPOSITION Если флаг установлен, то двигатель смещается к позиции, установленной в Position и uPosition, иначе двигатель смещается на Position и uPosition
uint16_t ClutterTime Минимальная длительность входного импульса синхронизации для защиты от дребезга (мкс).
int32_t Position Желаемая позиция или смещение (в полных шагах)
int16_t uPosition Дробная часть позиции или смещения в микрошагах. Используется только с шаговым двигателем. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint32_t Speed Заданная скорость (для ШД: шагов/c, для DC: rpm). Диапазон: 0..100000.
uint8_t uSpeed Заданная скорость в микрошагах в секунду. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым мотором.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек для входного импульса синхронизации. Эта функция считывает структуру с настройками синхронизации, определяющими поведение входа синхронизации, в память контроллера.

6.2.6.34. Команда GSNO

Код команды (CMD): «gsno» или 0x6F6E7367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (16 байт)

uint32_t CMD Команда
uint8_t SyncOutFlags Флаги синхронизации выхода. Это битовая маска для побитовых операций.
  0x1 - SYNCOUT_ENABLED Синхронизация выхода работает согласно настройкам, если флаг установлен. В ином случае значение выхода фиксировано и подчиняется SYNCOUT_STATE.
  0x2 - SYNCOUT_STATE Когда значение выхода управляется напрямую (см. флаг SYNCOUT_ENABLED), значение на выходе соответствует значению этого флага.
  0x4 - SYNCOUT_INVERT Нулевой логический уровень является активным, если флаг установлен, а единичный - если флаг сброшен.
  0x8 - SYNCOUT_IN_STEPS Если флаг установлен использовать шаги/импульсы энкодера для выходных импульсов синхронизации вместо миллисекунд.
  0x10 - SYNCOUT_ONSTART Генерация синхронизирующего импульса при начале движения.
  0x20 - SYNCOUT_ONSTOP Генерация синхронизирующего импульса при остановке.
  0x40 - SYNCOUT_ONPERIOD Выдает импульс синхронизации после прохождения SyncOutPeriod отсчётов.
uint16_t SyncOutPulseSteps Определяет длительность выходных импульсов в шагах/импульсах энкодера, когда установлен флаг SYNCOUT_IN_STEPS, или в микросекундах если флаг сброшен.
uint16_t SyncOutPeriod Период генерации импульсов (в шагах/отсчетах энкодера), используется при установленном флаге SYNCOUT_ONPERIOD.
uint32_t Accuracy Это окрестность вокруг целевой координаты, попадание в которую считается попаданием в целевую позицию и генерируется импульс по остановке.
uint8_t uAccuracy Это окрестность вокруг целевой координаты в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint16_t CRC Контрольная сумма

Описание: Чтение настроек для выходного импульса синхронизации. Эта функция считывает структуру с настройками синхронизации, определяющими поведение выхода синхронизации, в память контроллера.

6.2.6.35. Команда GSTI

Код команды (CMD): «gsti» или 0x69747367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение информации о позиционере из EEPROM. Не поддерживается.

6.2.6.36. Команда GSTS

Код команды (CMD): «gsts» или 0x73747367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (70 байт)

uint32_t CMD Команда
float LeadScrewPitch Шаг ходового винта в мм. Тип данных: float.
int8_t Units Единицы измерения расстояния, используемые в полях MaxSpeed и TravelRange (шаги, градусы, мм, …), Максимальная длина строки: 8 символов.
float MaxSpeed Максимальная скорость (Units/с). Тип данных: float.
float TravelRange Диапазон перемещения (Units). Тип данных: float.
float SupplyVoltageMin Минимальное напряжение питания (В). Тип данных: float.
float SupplyVoltageMax Максимальное напряжение питания (В). Тип данных: float.
float MaxCurrentConsumption Максимальный ток потребления (А). Тип данных: float.
float HorizontalLoadCapacity Горизонтальная грузоподъемность (кг). Тип данных: float.
float VerticalLoadCapacity Вертикальная грузоподъемность (кг). Тип данных: float.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение настроек позиционера из EEPROM.

6.2.6.37. Команда GURT

Код команды (CMD): «gurt» или 0x74727567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (16 байт)

uint32_t CMD Команда
uint32_t Speed Cкорость UART (в бодах)
uint16_t UARTSetupFlags Флаги настройки UART. Это битовая маска для побитовых операций.
  0x3 - UART_PARITY_BITS Биты, отвечающие за выбор четности.
  0x0 - UART_PARITY_BIT_EVEN Бит 1, если четный
  0x1 - UART_PARITY_BIT_ODD Бит 1, если нечетный
  0x2 - UART_PARITY_BIT_SPACE Бит четности всегда 0
  0x3 - UART_PARITY_BIT_MARK Бит четности всегда 1
  0x4 - UART_PARITY_BIT_USE Бит чётности не используется, если „0“; бит четности используется, если „1“
  0x8 - UART_STOP_BIT Если установлен, один стоповый бит; иначе - 2 стоповых бита
uint8_t Reserved [4] Зарезервировано (4 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения настроек UART. Эта функция заполняет структуру настроек UART.

6.2.6.38. Команда SACC

Код команды (CMD): «sacc» или 0x63636173.

Запрос: (114 байт)

uint32_t CMD Команда
int8_t MagneticBrakeInfo Производитель и номер магнитного тормоза, Максимальная длина строки: 24 символов.
float MBRatedVoltage Номинальное напряжение для управления магнитным тормозом (В). Тип данных: float.
float MBRatedCurrent Номинальный ток для управления магнитным тормозом (А). Тип данных: float.
float MBTorque Удерживающий момент (мН м). Тип данных: float.
uint32_t MBSettings Флаги настроек магнитного тормоза. Это битовая маска для побитовых операций.
  0x1 - MB_AVAILABLE Если флаг установлен, то магнитный тормоз доступен
  0x2 - MB_POWERED_HOLD Если флаг установлен, то магнитный тормоз находится в режиме удержания (активен) при подаче питания
int8_t TemperatureSensorInfo Производитель и номер температурного датчика, Максимальная длина строки: 24 символов.
float TSMin Минимальная измеряемая температура (град Цельсия). Тип данных: float.
float TSMax Максимальная измеряемая температура (град Цельсия) Тип данных: float.
float TSGrad Температурный градиент (В/град Цельсия). Тип данных: float.
uint32_t TSSettings Флаги настроек температурного датчика. Это битовая маска для побитовых операций.
  0x7 - TS_TYPE_BITS Биты, отвечающие за тип температурного датчика
  0x0 - TS_TYPE_UNKNOWN Неизвестный сенсор
  0x1 - TS_TYPE_THERMOCOUPLE Термопара
  0x2 - TS_TYPE_SEMICONDUCTOR Полупроводниковый температурный датчик
  0x8 - TS_AVAILABLE Если флаг установлен, то датчик температуры доступен
uint32_t LimitSwitchesSettings Флаги настроек концевых выключателей. Это битовая маска для побитовых операций.
  0x1 - LS_ON_SW1_AVAILABLE Если флаг установлен, то концевой переключатель, подключенный к ножке SW1, доступен
  0x2 - LS_ON_SW2_AVAILABLE Если флаг установлен, то концевой переключатель, подключенный к ножке SW2, доступен
  0x4 - LS_SW1_ACTIVE_LOW Если флаг установлен, то концевой переключатель, подключенный к ножке SW1, считается сработавшим по низкому уровню на контакте
  0x8 - LS_SW2_ACTIVE_LOW Если флаг установлен, то концевой переключатель, подключенный к ножке SW2, считается сработавшим по низкому уровню на контакте
  0x10 - LS_SHORTED Если флаг установлен, то концевые переключатели замкнуты
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись информации о дополнительных аксессуарах в EEPROM. Функция должна использоваться только производителем.

6.2.6.39. Команда SBRK

Код команды (CMD): «sbrk» или 0x6B726273.

Запрос: (25 байт)

uint32_t CMD Команда
uint16_t t1 Время в мс между включением питания мотора и отключением тормоза.
uint16_t t2 Время в мс между отключением тормоза и готовностью к движению. Все команды движения начинают выполняться только по истечении этого времени.
uint16_t t3 Время в мс между остановкой мотора и включением тормоза.
uint16_t t4 Время в мс между включением тормоза и отключением питания мотора.
uint8_t BrakeFlags Флаги. Это битовая маска для побитовых операций.
  0x1 - BRAKE_ENABLED Управление тормозом включено, если флаг установлен.
  0x2 - BRAKE_ENG_PWROFF Тормоз отключает питание шагового мотора, если флаг установлен.
uint8_t Reserved [10] Зарезервировано (10 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек управления тормозом.

6.2.6.40. Команда SCAL

Код команды (CMD): «scal» или 0x6C616373.

Запрос: (118 байт)

uint32_t CMD Команда
float CSS1_A Коэффициент масштабирования для аналоговых измерений тока в обмотке A.
float CSS1_B Коэффициент сдвига для аналоговых измерений тока в обмотке A.
float CSS2_A Коэффициент масштабирования для аналоговых измерений тока в обмотке B.
float CSS2_B Коэффициент сдвига для аналоговых измерений тока в обмотке B.
float FullCurrent_A Коэффициент масштабирования для аналоговых измерений полного тока.
float FullCurrent_B Коэффициент сдвига для аналоговых измерений полного тока.
uint8_t Reserved [88] Зарезервировано (88 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи калибровочных коэффициентов. Команда только для производителя. Эта функция записывает структуру калибровочных коэффициентов в память контроллера. Эти коэффициенты используются для пересчёта кодов АЦП в токи обмоток и полный ток потребления. Коэффициенты сгруппированы в пары, XXX_A и XXX_B; пары представляют собой коэффициенты линейного уравнения. Первый коэффициент - тангенс угла наклона, второй - постоянное смещение. Таким образом, XXX_Current[mA] = XXX_A[mA/ADC]XXX_ADC_CODE[ADC] + XXX_B[mA].

6.2.6.41. Команда SCTL

Код команды (CMD): «sctl» или 0x6C746373.

Запрос: (93 байт)

uint32_t CMD Команда
uint32_t MaxSpeed Массив скоростей (в полных шагах), использующийся при управлении джойстиком или кнопками влево/вправо. Диапазон: 0..100000.
uint8_t uMaxSpeed Массив скоростей (в микрошагах), использующийся при управлении джойстиком или кнопками влево/вправо. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint16_t Timeout Timeout[i] - время в мс, по истечении которого устанавливается скорость max_speed[i+1] (используется только при управлении кнопками).
uint16_t MaxClickTime Максимальное время клика (в мс). До истечения этого времени первая скорость не включается.
uint16_t Flags Флаги. Это битовая маска для побитовых операций.
  0x3 - CONTROL_MODE_BITS Биты управления мотором с помощью джойстика или кнопок влево/вправо.
  0x0 - CONTROL_MODE_OFF Управление отключено.
  0x1 - CONTROL_MODE_JOY Управление с помощью джойстика.
  0x2 - CONTROL_MODE_LR Управление с помощью кнопок влево/вправо.
  0x4 - CONTROL_BTN_LEFT_PUSHED_OPEN Нажатая левая кнопка соответствует открытому контакту, если этот флаг установлен.
  0x8 - CONTROL_BTN_RIGHT_PUSHED_OPEN Нажатая правая кнопка соответствует открытому контакту, если этот флаг установлен.
int32_t DeltaPosition Смещение (дельта) позиции (в полных шагах)
int16_t uDeltaPosition Дробная часть смещения в микрошагах. Используется только с шаговым двигателем. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint8_t Reserved [9] Зарезервировано (9 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек управления мотором. При выборе CTL_MODE=1 включается управление мотором с помощью джойстика. В этом режиме при отклонении джойстика на максимум двигатель стремится двигаться со скоростью MaxSpeed [i], где i=0, если предыдущим использованием этого режима не было выбрано другое i. Кнопки переключают номер скорости i. При выборе CTL_MODE=2 включается управление мотором с помощью кнопок left/right. При нажатии на кнопки двигатель начинает двигаться в соответствующую сторону со скоростью MaxSpeed[0], по истечении времени Timeout[i] мотор двигается со скоростью MaxSpeed [i+1]. При переходе от MaxSpeed [i] на MaxSpeed [i+1] действует ускорение, как обычно.

6.2.6.42. Команда SCTP

Код команды (CMD): «sctp» или 0x70746373.

Запрос: (18 байт)

uint32_t CMD Команда
uint8_t CTPMinError Минимальное отличие шагов ШД от положения энкодера, устанавливающее флаг STATE_RT_ERROR. Измеряется в шагах ШД.
uint8_t CTPFlags Флаги. Это битовая маска для побитовых операций.
  0x1 - CTP_ENABLED Контроль позиции включен, если флаг установлен.
  0x2 - CTP_BASE Управление положением основано на датчике вращения, если установлен этот флаг; в противном случае - на энкодере.
  0x4 - CTP_ALARM_ON_ERROR Войти в состояние ALARM при расхождении позиции, если флаг установлен.
  0x8 - REV_SENS_INV Сенсор считается активным, когда на нём 0, инвертирование делает активным уровень 1. То есть если не инвертировать, то действует обычная логика - 0 это срабатывание/активация/активное состояние.
  0x10 - CTP_ERROR_CORRECTION Корректировать ошибки, возникающие при проскальзывании, если флаг установлен. Работает только с энкодером. Несовместимо с флагом CTP_ALARM_ON_ERROR.
uint8_t Reserved [10] Зарезервировано (10 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек контроля позиции(для шагового двигателя). При управлении ШД с энкодером (CTP_BASE 0) появляется возможность обнаруживать потерю шагов. Контроллер знает кол-во шагов на оборот (GENG::StepsPerRev) и разрешение энкодера (GFBS::IPT). При включении контроля (флаг CTP_ENABLED), контроллер запоминает текущую позицию в шагах ШД и текущую позицию энкодера. Далее, на каждом шаге позиция энкодера преобразовывается в шаги и если разница оказывается больше CTPMinError, устанавливается флаг STATE_CTP_ERROR. При управлении ШД с датчиком оборотов (CTP_BASE 1), позиция контролируется по нему. По активному фронту на входе синхронизации контроллер запоминает текущее значение шагов. Далее, при каждом обороте проверяет, на сколько шагов сместились. При рассогласовании более CTPMinError устанавливается флаг STATE_CTP_ERROR.

6.2.6.43. Команда SEAS

Код команды (CMD): «seas» или 0x73616573.

Запрос: (54 байт)

uint32_t CMD Команда
uint16_t stepcloseloop_Kw Коэффициент смешения реальной и заданной скорости, диапазон [0, 100], значение по умолчанию 50.
uint16_t stepcloseloop_Kp_low Обратная связь по позиции в зоне малых скоростей, диапазон [0, 65535], значение по умолчанию 1000.
uint16_t stepcloseloop_Kp_high Обратная связь по позиции в зоне больших скоростей, диапазон [0, 65535], значение по умолчанию 33.
uint8_t Reserved [42] Зарезервировано (42 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись расширенных настроек.

6.2.6.44. Команда SEDS

Код команды (CMD): «seds» или 0x73646573.

Запрос: (26 байт)

uint32_t CMD Команда
uint8_t BorderFlags Флаги, определяющие тип границ и поведение мотора при их достижении. Это битовая маска для побитовых операций.
  0x1 - BORDER_IS_ENCODER Если флаг установлен, границы определяются предустановленными точками на шкале позиции. Если флаг сброшен, границы определяются концевыми выключателями.
  0x2 - BORDER_STOP_LEFT Если флаг установлен, мотор останавливается при достижении левой границы.
  0x4 - BORDER_STOP_RIGHT Если флаг установлен, мотор останавливается при достижении правой границы.
  0x8 - BORDERS_SWAP_MISSET_DETECTION Если флаг установлен, мотор останавливается при достижении обоих границ. Нужен для предотвращения поломки двигателя при неправильных настройках концевых выключателей
uint8_t EnderFlags Флаги, определяющие настройки концевых выключателей. Это битовая маска для побитовых операций.
  0x1 - ENDER_SWAP Если флаг установлен, первый концевой выключатель находится справа; иначе - слева.
  0x2 - ENDER_SW1_ACTIVE_LOW 1 - Концевой переключатель, подключенный к ножке SW1, считается сработавшим по низкому уровню на контакте.
  0x4 - ENDER_SW2_ACTIVE_LOW 1 - Концевой переключатель, подключенный к ножке SW2, считается сработавшим по низкому уровню на контакте.
int32_t LeftBorder Позиция левой границы, используется если установлен флаг BORDER_IS_ENCODER.
int16_t uLeftBorder Позиция левой границы в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
int32_t RightBorder Позиция правой границы, используется если установлен флаг BORDER_IS_ENCODER.
int16_t uRightBorder Позиция правой границы в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек границ и концевых выключателей.

6.2.6.45. Команда SEIO

Код команды (CMD): «seio» или 0x6F696573.

Запрос: (18 байт)

uint32_t CMD Команда
uint8_t EXTIOSetupFlags Флаги настройки работы внешнего ввода-вывода. Это битовая маска для побитовых операций.
  0x1 - EXTIO_SETUP_OUTPUT Если флаг установлен, то ножка в состоянии вывода, иначе - ввода.
  0x2 - EXTIO_SETUP_INVERT Если флаг установлен, то нули считаются активным состоянием выхода, а спадающие фронты как момент подачи входного сигнала.
uint8_t EXTIOModeFlags Флаги настройки режимов внешнего ввода-вывода. Это битовая маска для побитовых операций.
  0xf - EXTIO_SETUP_MODE_IN_BITS Биты, отвечающие за поведение при переходе сигнала в активное состояние.
  0x0 - EXTIO_SETUP_MODE_IN_NOP Ничего не делать.
  0x1 - EXTIO_SETUP_MODE_IN_STOP По переднему фронту входного сигнала делается остановка двигателя (эквивалент команды STOP).
  0x2 - EXTIO_SETUP_MODE_IN_PWOF Выполняет команду PWOF, обесточивая обмотки двигателя.
  0x3 - EXTIO_SETUP_MODE_IN_MOVR Выполняется команда MOVR с последними настройками.
  0x4 - EXTIO_SETUP_MODE_IN_HOME Выполняется команда HOME.
  0x5 - EXTIO_SETUP_MODE_IN_ALARM Войти в состояние ALARM при переходе сигнала в активное состояние.
  0xf0 - EXTIO_SETUP_MODE_OUT_BITS Биты выбора поведения на выходе.
  0x0 - EXTIO_SETUP_MODE_OUT_OFF Ножка всегда в неактивном состоянии.
  0x10 - EXTIO_SETUP_MODE_OUT_ON Ножка всегда в активном состоянии.
  0x20 - EXTIO_SETUP_MODE_OUT_MOVING Ножка находится в активном состоянии при движении.
  0x30 - EXTIO_SETUP_MODE_OUT_ALARM Ножка находится в активном состоянии при нахождении в состоянии ALARM.
  0x40 - EXTIO_SETUP_MODE_OUT_MOTOR_ON Ножка находится в активном состоянии при подаче питания на обмотки.
uint8_t Reserved [10] Зарезервировано (10 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи параметров настройки режимов внешнего ввода/вывода. Входные события обрабатываются по фронту. Выходные состояния сигнализируются логическим состоянием. По умолчанию нарастающий фронт считается моментом подачи входного сигнала, а единичное состояние считается активным выходом.

6.2.6.46. Команда SEMF

Код команды (CMD): «semf» или 0x666D6573.

Запрос: (48 байт)

uint32_t CMD Команда
float L Индуктивность обмоток двигателя.
float R Сопротивление обмоток двигателя.
float Km Электромеханический коэффициент двигателя.
uint8_t BackEMFFlags Флаги автонастроек шагового двигателя. Это битовая маска для побитовых операций.
  0x1 - BACK_EMF_INDUCTANCE_AUTO Флаг автоопределения индуктивности обмоток двигателя.
  0x2 - BACK_EMF_RESISTANCE_AUTO Флаг автоопределения сопротивления обмоток двигателя.
  0x4 - BACK_EMF_KM_AUTO Флаг автоопределения электромеханического коэффициента двигателя.
uint8_t Reserved [29] Зарезервировано (29 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись электромеханических настроек шагового двигателя. Настройки различны для разных двигателей. Пожалуйста, загружайте новые настройки, когда вы меняете мотор.

6.2.6.47. Команда SENG

Код команды (CMD): «seng» или 0x676E6573.

Запрос: (34 байт)

uint32_t CMD Команда
uint16_t NomVoltage Номинальное напряжение мотора в десятках мВ. Контроллер будет сохранять напряжение на моторе не выше номинального, если установлен флаг ENGINE_LIMIT_VOLT (используется только с DC двигателем).
uint16_t NomCurrent Номинальный ток через мотор (в мА). Ток стабилизируется для шаговых и может быть ограничен для DC(если установлен флаг ENGINE_LIMIT_CURR). Диапазон: 15..8000
uint32_t NomSpeed Номинальная (максимальная) скорость (в целых шагах/с или rpm для DC и шагового двигателя в режиме ведущего энкодера). Контроллер будет сохранять скорость мотора не выше номинальной, если установлен флаг ENGINE_LIMIT_RPM. Диапазон: 1..100000.
uint8_t uNomSpeed Микрошаговая часть номинальной скорости мотора (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint16_t EngineFlags Флаги, управляющие работой мотора. Это битовая маска для побитовых операций.
  0x1 - ENGINE_REVERSE Флаг реверса. Связывает направление вращения мотора с направлением счета текущей позиции. При сброшенном флаге (по умолчанию) прикладываемое к мотору положительное напряжение увеличивает счетчик позиции. И наоборот, при установленном флаге счетчик позиции увеличивается, когда к мотору приложено отрицательное напряжение. Измените состояние флага, если положительное вращение мотора уменьшает счетчик позиции.
  0x2 - ENGINE_CURRENT_AS_RMS Флаг интерпретации значения тока. Если флаг снят, то задаваемое значение тока интерпретируется как максимальная амплитуда тока. Если флаг установлен, то задаваемое значение тока интерпретируется как среднеквадратичное значение тока (для шагового) или как значение тока, посчитанное из максимального тепловыделения (BLDC).
  0x4 - ENGINE_MAX_SPEED Флаг максимальной скорости. Если флаг установлен, движение происходит на максимальной скорости.
  0x8 - ENGINE_ANTIPLAY Компенсация люфта. Если флаг установлен, позиционер будет подходить к заданной точке всегда с одной стороны. Например, при подходе слева никаких дополнительных действий не совершается, а при подходе справа позиционер проходит целевую позицию на заданное расстояния и возвращается к ней опять же справа.
  0x10 - ENGINE_ACCEL_ON Ускорение. Если флаг установлен, движение происходит с ускорением.
  0x20 - ENGINE_LIMIT_VOLT Номинальное напряжение мотора. Если флаг установлен, напряжение на моторе ограничивается заданным номинальным значением(используется только с DC двигателем).
  0x40 - ENGINE_LIMIT_CURR Номинальный ток мотора. Если флаг установлен, ток через мотор ограничивается заданным номинальным значением(используется только с DC двигателем).
  0x80 - ENGINE_LIMIT_RPM Номинальная частота вращения мотора. Если флаг установлен, частота вращения ограничивается заданным номинальным значением.
int16_t Antiplay Количество шагов двигателя или импульсов энкодера, на которое позиционер будет отъезжать от заданной позиции для подхода к ней с одной и той же стороны. Используется, если установлен флаг ENGINE_ANTIPLAY.
uint8_t MicrostepMode Настройки микрошагового режима(используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Это битовая маска для побитовых операций.
  0x1 - MICROSTEP_MODE_FULL Полношаговый режим.
  0x2 - MICROSTEP_MODE_FRAC_2 Деление шага 1/2.
  0x3 - MICROSTEP_MODE_FRAC_4 Деление шага 1/4.
  0x4 - MICROSTEP_MODE_FRAC_8 Деление шага 1/8.
  0x5 - MICROSTEP_MODE_FRAC_16 Деление шага 1/16.
  0x6 - MICROSTEP_MODE_FRAC_32 Деление шага 1/32.
  0x7 - MICROSTEP_MODE_FRAC_64 Деление шага 1/64.
  0x8 - MICROSTEP_MODE_FRAC_128 Деление шага 1/128.
  0x9 - MICROSTEP_MODE_FRAC_256 Деление шага 1/256.
uint16_t StepsPerRev Количество полных шагов на оборот(используется только с шаговым двигателем). Диапазон: 1..65535.
uint8_t Reserved [12] Зарезервировано (12 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

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

6.2.6.48. Команда SENI

Код команды (CMD): «seni» или 0x696E6573.

Запрос: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись информации об энкодере в EEPROM. Функция должна использоваться только производителем.

6.2.6.49. Команда SENS

Код команды (CMD): «sens» или 0x736E6573.

Запрос: (54 байт)

uint32_t CMD Команда
float MaxOperatingFrequency Максимальная частота (кГц). Тип данных: float.
float SupplyVoltageMin Минимальное напряжение питания (В). Тип данных: float.
float SupplyVoltageMax Максимальное напряжение питания (В). Тип данных: float.
float MaxCurrentConsumption Максимальное потребление тока (мА). Тип данных: float.
uint32_t PPR Количество отсчётов на оборот
uint32_t EncoderSettings Флаги настроек энкодера. Это битовая маска для побитовых операций.
  0x1 - ENCSET_DIFFERENTIAL_OUTPUT Если флаг установлен, то энкодер имеет дифференциальный выход, иначе - несимметричный выход
  0x4 - ENCSET_PUSHPULL_OUTPUT Если флаг установлен, то энкодер имеет двухтактный выход, иначе - выход с открытым коллектором
  0x10 - ENCSET_INDEXCHANNEL_PRESENT Если флаг установлен, то энкодер имеет дополнительный индексный канал, иначе - он отсутствует
  0x40 - ENCSET_REVOLUTIONSENSOR_PRESENT Если флаг установлен, то энкодер имеет датчик оборотов, иначе - он отсутствует
  0x100 - ENCSET_REVOLUTIONSENSOR_ACTIVE_HIGH Если флаг установлен, то активное состояние датчика оборотов соответствует логической 1, иначе - логическому 0
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек энкодера в EEPROM. Функция должна использоваться только производителем.

6.2.6.50. Команда SENT

Код команды (CMD): «sent» или 0x746E6573.

Запрос: (14 байт)

uint32_t CMD Команда
uint8_t EngineType Тип мотора. Это битовая маска для побитовых операций.
  0x0 - ENGINE_TYPE_NONE Это значение не нужно использовать.
  0x1 - ENGINE_TYPE_DC Мотор постоянного тока.
  0x2 - ENGINE_TYPE_2DC Два мотора постоянного тока, что приводит к эмуляции двух контроллеров.
  0x3 - ENGINE_TYPE_STEP Шаговый мотор.
  0x4 - ENGINE_TYPE_TEST Продолжительность включения фиксирована. Используется только производителем.
  0x5 - ENGINE_TYPE_BRUSHLESS Бесщеточный мотор.
uint8_t DriverType Тип силового драйвера. Это битовая маска для побитовых операций.
  0x1 - DRIVER_TYPE_DISCRETE_FET Силовой драйвер на дискретных мосфет-ключах. Используется по умолчанию.
  0x2 - DRIVER_TYPE_INTEGRATE Силовой драйвер с использованием ключей, интегрированных в микросхему.
  0x3 - DRIVER_TYPE_EXTERNAL Внешний силовой драйвер.
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись информации о типе мотора и типе силового драйвера.

6.2.6.51. Команда SEST

Код команды (CMD): «sest» или 0x74736573.

Запрос: (46 байт)

uint32_t CMD Команда
uint16_t Param1  
uint8_t Reserved [38] Зарезервировано (38 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись расширенных настроек. В настоящее время не используется.

6.2.6.52. Команда SFBS

Код команды (CMD): «sfbs» или 0x73626673.

Запрос: (18 байт)

uint32_t CMD Команда
uint16_t IPS Количество отсчётов энкодера на оборот вала. Диапазон: 1..65535. Поле устарело, рекомендуется записывать 0 в IPS и использовать расширенное поле CountsPerTurn. Может потребоваться обновление микропрограммы контроллера до последней версии.
uint8_t FeedbackType Тип обратной связи. Это битовая маска для побитовых операций.
  0x1 - FEEDBACK_ENCODER Обратная связь с помощью энкодера.
  0x4 - FEEDBACK_EMF Обратная связь по ЭДС.
  0x5 - FEEDBACK_NONE Обратная связь отсутствует.
  0x6 - FEEDBACK_ENCODER_MEDIATED Обратная связь по энкодеру, опосредованному относительно двигателя механической передачей (например, винтовой передачей).
uint8_t FeedbackFlags Флаги. Это битовая маска для побитовых операций.
  0x1 - FEEDBACK_ENC_REVERSE Обратный счет у энкодера.
  0xc0 - FEEDBACK_ENC_TYPE_BITS Биты, отвечающие за тип энкодера.
  0x0 - FEEDBACK_ENC_TYPE_AUTO Определяет тип энкодера автоматически.
  0x40 - FEEDBACK_ENC_TYPE_SINGLE_ENDED Недифференциальный энкодер.
  0x80 - FEEDBACK_ENC_TYPE_DIFFERENTIAL Дифференциальный энкодер.
uint32_t CountsPerTurn Количество отсчётов энкодера на оборот вала. Диапазон: 1..4294967295. Для использования поля CountsPerTurn нужно записать 0 в поле IPS, иначе будет использоваться значение из поля IPS.
uint8_t Reserved [4] Зарезервировано (4 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Чтение настроек обратной связи.

6.2.6.53. Команда SGRI

Код команды (CMD): «sgri» или 0x69726773.

Запрос: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись информации о редукторе в EEPROM. Функция должна использоваться только производителем.

6.2.6.54. Команда SGRS

Код команды (CMD): «sgrs» или 0x73726773.

Запрос: (58 байт)

uint32_t CMD Команда
float ReductionIn Входной коэффициент редуктора. (Выход = (ReductionOut/ReductionIn) вход) Тип данных: float.
float ReductionOut Выходной коэффициент редуктора. (Выход = (ReductionOut/ReductionIn) вход) Тип данных: float.
float RatedInputTorque Максимальный крутящий момент (Н м). Тип данных: float.
float RatedInputSpeed Максимальная скорость на входном валу редуктора (об/мин). Тип данных: float.
float MaxOutputBacklash Выходной люфт редуктора (градус). Тип данных: float.
float InputInertia Эквивалентная входная инерция редуктора(г см2). Тип данных: float.
float Efficiency КПД редуктора (%). Тип данных: float.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек редуктора в EEPROM. Функция должна использоваться только производителем.

6.2.6.55. Команда SHOM

Код команды (CMD): «shom» или 0x6D6F6873.

Запрос: (33 байт)

uint32_t CMD Команда
uint32_t FastHome Скорость первого движения (в полных шагах). Диапазон: 0..100000.
uint8_t uFastHome Дробная часть скорости первого движения в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint32_t SlowHome Скорость второго движения (в полных шагах). Диапазон: 0..100000.
uint8_t uSlowHome Дробная часть скорости второго движения в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
int32_t HomeDelta Расстояние отхода от точки останова (в полных шагах).
int16_t uHomeDelta Дробная часть расстояния отхода от точки останова в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint16_t HomeFlags Набор флагов, определяющие такие параметры, как направление и условия останова. Это битовая маска для побитовых операций.
  0x1 - HOME_DIR_FIRST Определяет направление первоначального движения мотора после поступления команды HOME. Если флаг установлен - вправо; иначе - влево.
  0x2 - HOME_DIR_SECOND Определяет направление второго движения мотора. Если флаг установлен - вправо; иначе - влево.
  0x4 - HOME_MV_SEC_EN Если флаг установлен, реализуется второй этап доводки в домашнюю позицию; иначе - этап пропускается.
  0x8 - HOME_HALF_MV Если флаг установлен, в начале второго движения первые пол оборота сигналы завершения движения игнорируются.
  0x30 - HOME_STOP_FIRST_BITS Биты, отвечающие за выбор сигнала завершения первого движения.
  0x10 - HOME_STOP_FIRST_REV Первое движение завершается по сигналу с Revolution sensor.
  0x20 - HOME_STOP_FIRST_SYN Первое движение завершается по сигналу со входа синхронизации.
  0x30 - HOME_STOP_FIRST_LIM Первое движение завершается по сигналу с концевого переключателя.
  0xc0 - HOME_STOP_SECOND_BITS Биты, отвечающие за выбор сигнала завершения второго движения.
  0x40 - HOME_STOP_SECOND_REV Второе движение завершается по сигналу с Revolution sensor.
  0x80 - HOME_STOP_SECOND_SYN Второе движение завершается по сигналу со входа синхронизации.
  0xc0 - HOME_STOP_SECOND_LIM Второе движение завершается по сигналу с концевого переключателя.
  0x100 - HOME_USE_FAST Если флаг установлен, используется быстрый поиск домашней позиции; иначе - традиционный.
uint8_t Reserved [9] Зарезервировано (9 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи настроек для подхода в home position. Эта функция записывает структуру настроек, использующихся для калибровки позиции, в память контроллера.

6.2.6.56. Команда SHSI

Код команды (CMD): «shsi» или 0x69736873.

Запрос: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись информации о датчиках Холла в EEPROM. Функция должна использоваться только производителем.

6.2.6.57. Команда SHSS

Код команды (CMD): «shss» или 0x73736873.

Запрос: (50 байт)

uint32_t CMD Команда
float MaxOperatingFrequency Максимальная частота (кГц). Тип данных: float.
float SupplyVoltageMin Минимальное напряжение питания (В). Тип данных: float.
float SupplyVoltageMax Максимальное напряжение питания (В). Тип данных: float.
float MaxCurrentConsumption Максимальное потребление тока (мА). Тип данных: float.
uint32_t PPR Количество отсчётов на оборот
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек датчиков Холла в EEPROM. Функция должна использоваться только производителем.

6.2.6.58. Команда SJOY

Код команды (CMD): «sjoy» или 0x796F6A73.

Запрос: (22 байт)

uint32_t CMD Команда
uint16_t JoyLowEnd Значение в шагах джойстика, соответствующее нижней границе диапазона отклонения устройства. Должно лежать в пределах. Диапазон: 0..10000.
uint16_t JoyCenter Значение в шагах джойстика, соответствующее неотклонённому устройству. Должно лежать в пределах. Диапазон: 0..10000.
uint16_t JoyHighEnd Значение в шагах джойстика, соответствующее верхней границе диапазона отклонения устройства. Должно лежать в пределах. Диапазон: 0..10000.
uint8_t ExpFactor Фактор экспоненциальной нелинейности отклика джойстика.
uint8_t DeadZone Отклонение от среднего положения, которое не вызывает начала движения (в десятых долях процента). Максимальное мёртвое отклонение +-25.5%, что составляет половину рабочего диапазона джойстика.
uint8_t JoyFlags Флаги управления джойстиком. Это битовая маска для побитовых операций.
  0x1 - JOY_REVERSE Реверс воздействия джойстика. Отклонение джойстика к большим значениям приводит к отрицательной скорости и наоборот.
uint8_t Reserved [7] Зарезервировано (7 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек джойстика. При отклонении джойстика более чем на DeadZone от центрального положения начинается движение со скоростью, определяемой отклонением джойстика от DeadZone до 100% отклонения, причем отклонению DeadZone соответствует нулевая скорость, а 100% отклонения соответствует MaxSpeed [i] (см. команду SCTL), где i=0, если предыдущим использованием этого режима не было выбрано другое i. Если следующая скорость в таблице скоростей нулевая (целая и микрошаговая части), то перехода на неё не происходит. DeadZone вычисляется в десятых долях процента отклонения от центра (JoyCenter) до правого или левого максимума. Подробнее см. раздел „Управление с помощью джойстика“ на сайте https://doc.xisupport.com.

6.2.6.59. Команда SMOV

Код команды (CMD): «smov» или 0x766F6D73.

Запрос: (30 байт)

uint32_t CMD Команда
uint32_t Speed Заданная скорость (для ШД: шагов/c, для DC: rpm). Диапазон: 0..100000.
uint8_t uSpeed Заданная скорость в единицах деления микрошага в секунду. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым мотором.
uint16_t Accel Ускорение, заданное в шагах в секунду^2 (ШД) или в оборотах в минуту за секунду (DC). Диапазон: 1..65535.
uint16_t Decel Торможение, заданное в шагах в секунду^2 (ШД) или в оборотах в минуту за секунду (DC). Диапазон: 1..65535.
uint32_t AntiplaySpeed Скорость в режиме антилюфта, заданная в целых шагах/c (ШД) или в оборотах/с(DC). Диапазон: 0..100000.
uint8_t uAntiplaySpeed Скорость в режиме антилюфта, выраженная в микрошагах в секунду. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым мотором.
uint8_t MoveFlags Флаги, управляющие настройкой движения. Это битовая маска для побитовых операций.
  0x1 - RPM_DIV_1000 Флаг указывает на то что рабочая скорость указанная в команде задана в милли rpm. Применим только для режима обратной связи ENCODER и только для BLDC моторов.
uint8_t Reserved [9] Зарезервировано (9 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи настроек перемещения (скорость, ускорение, threshold и скорость в режиме антилюфта).

6.2.6.60. Команда SMTI

Код команды (CMD): «smti» или 0x69746D73.

Запрос: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись информации о двигателе в EEPROM. Функция должна использоваться только производителем.

6.2.6.61. Команда SMTS

Код команды (CMD): «smts» или 0x73746D73.

Запрос: (112 байт)

uint32_t CMD Команда
uint8_t MotorType Тип двигателя. Это битовая маска для побитовых операций.
  0x0 - MOTOR_TYPE_UNKNOWN Неизвестный двигатель
  0x1 - MOTOR_TYPE_STEP Шаговый двигатель
  0x2 - MOTOR_TYPE_DC DC двигатель
  0x3 - MOTOR_TYPE_BLDC BLDC двигатель
uint8_t ReservedField Зарезервировано
uint16_t Poles Кол-во пар полюсов у DС или BLDC двигателя или кол-во шагов на оборот для шагового двигателя.
uint16_t Phases Кол-во фаз у BLDC двигателя.
float NominalVoltage Номинальное напряжение на обмотке (В). Тип данных: float
float NominalCurrent Максимальный постоянный ток в обмотке для DC и BLDC двигателей, номинальный ток в обмотке для шаговых двигателей (А). Тип данных: float.
float NominalSpeed Не используется. Номинальная скорость (об/мин). Применяется для DC и BLDC двигателей. Тип данных: float.
float NominalTorque Номинальный крутящий момент (мН м). Применяется для DC и BLDC двигателей. Тип данных: float.
float NominalPower Номинальная мощность(Вт). Применяется для DC и BLDC двигателей. Тип данных: float.
float WindingResistance Сопротивление обмотки DC двигателя, каждой из двух обмоток шагового двигателя или каждой из трёх обмоток BLDC двигателя (Ом). Тип данных: float.
float WindingInductance Индуктивность обмотки DC двигателя, каждой из двух обмоток шагового двигателя или каждой из трёх обмоток BLDC двигателя (мГн). Тип данных: float.
float RotorInertia Инерция ротора (г cм2). Тип данных: float.
float StallTorque Крутящий момент удержания позиции для шагового двигателя или крутящий момент при неподвижном роторе для других типов двигателей (мН м). Тип данных: float.
float DetentTorque Момент удержания позиции с незапитанными обмотками (мН м). Тип данных: float.
float TorqueConstant Константа крутящего момента, определяющая коэффициент пропорциональности максимального момента силы ротора от протекающего в обмотке тока (мН м/А). Используется в основном для DC двигателей. Тип данных: float.
float SpeedConstant Константа скорости, определяющая значение или амплитуду напряжения наведённой индукции при вращении ротора DC или BLDC двигателя (об/мин / В) или шагового двигателя (шаг/с / В). Тип данных: float.
float SpeedTorqueGradient Градиент крутящего момента (об/мин / мН м). Тип данных: float.
float MechanicalTimeConstant Механическая постоянная времени (мс). Тип данных: float.
float MaxSpeed Максимальная разрешённая скорость для шаговых двигателей (шаг/с) или для DC и BLDC двигателей (об/мин). Тип данных: float.
float MaxCurrent Максимальный ток в обмотке (А). Тип данных: float.
float MaxCurrentTime Безопасная длительность максимального тока в обмотке (мс). Тип данных: float.
float NoLoadCurrent Ток потребления в холостом режиме (А). Применяется для DC и BLDC двигателей. Тип данных: float.
float NoLoadSpeed Скорость в холостом режиме (об/мин). Применяется для DC и BLDC двигателей. Тип данных: float.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек двигателя в EEPROM. Функция должна использоваться только производителем.

6.2.6.62. Команда SNET

Код команды (CMD): «snet» или 0x74656E73.

Запрос: (38 байт)

uint32_t CMD Команда
uint8_t DHCPEnabled Определяет способ получения IP-адреса каналов. Может принимать значения: 0 — статически, 1 — через DHCP.
uint8_t IPv4Address IP-адрес устройства в формате x.x.x.x.
uint8_t SubnetMask Маска подсети в формате x.x.x.x.
uint8_t DefaultGateway Шлюз сети по умолчанию в формате x.x.x.x.
uint8_t Reserved [19] Зарезервировано (19 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи сететвых настроек. Только для производителя. Эта функция меняет сетевые настройки на заданные.

6.2.6.63. Команда SNME

Код команды (CMD): «snme» или 0x656D6E73.

Запрос: (30 байт)

uint32_t CMD Команда
int8_t PositionerName Пользовательское имя подвижки. Может быть установлено пользователем для его удобства. Максимальная длина строки: 16 символов.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись пользовательского имени подвижки в EEPROM.

6.2.6.64. Команда SNMF

Код команды (CMD): «snmf» или 0x666D6E73.

Запрос: (30 байт)

uint32_t CMD Команда
int8_t ControllerName Пользовательское имя контроллера. Может быть установлено пользователем для его удобства. Максимальная длина строки: 16 символов.
uint8_t CtrlFlags Настройки контроллера. Это битовая маска для побитовых операций.
  0x1 - EEPROM_PRECEDENCE Если флаг установлен, то настройки в EEPROM подвижки имеют приоритет над текущими настройками и заменяют их при обнаружении EEPROM.
uint8_t Reserved [7] Зарезервировано (7 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись пользовательского имени контроллера и настроек в FRAM.

6.2.6.65. Команда SNVM

Код команды (CMD): «snvm» или 0x6D766E73.

Запрос: (36 байт)

uint32_t CMD Команда
uint32_t UserData Пользовательские данные. Могут быть установлены пользователем для его удобства. Каждый элемент массива хранит только 32 бита пользовательских данных. Это важно на системах где тип int содержит больше чем 4 байта. Например это все системы amd64.
uint8_t Reserved [2] Зарезервировано (2 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись пользовательских данных во FRAM.

6.2.6.66. Команда SPID

Код команды (CMD): «spid» или 0x64697073.

Запрос: (48 байт)

uint32_t CMD Команда
uint16_t KpU Пропорциональный коэффициент ПИД контура по напряжению
uint16_t KiU Интегральный коэффициент ПИД контура по напряжению
uint16_t KdU Дифференциальный коэффициент ПИД контура по напряжению
float Kpf Пропорциональный коэффициент ПИД контура по позиции для BLDC
float Kif Интегральный коэффициент ПИД контура по позиции для BLDC
float Kdf Дифференциальный коэффициент ПИД контура по позиции для BLDC
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись ПИД коэффициентов. Эти коэффициенты определяют поведение позиционера. Коэффициенты различны для разных позиционеров. Пожалуйста, загружайте новые настройки, когда вы меняете мотор или позиционер.

6.2.6.67. Команда SPWD

Код команды (CMD): «spwd» или 0x64777073.

Запрос: (36 байт)

uint32_t CMD Команда
int8_t UserPassword Строчка-пароль для доступа к веб-странице, который пользователь может поменять с помощью USB команды или на веб-странице.
uint8_t Reserved [10] Зарезервировано (10 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи пароля к веб-странице. Только для производителя. Эта функция меняет пользовательский пароль к веб-странице.

6.2.6.68. Команда SPWR

Код команды (CMD): «spwr» или 0x72777073.

Запрос: (20 байт)

uint32_t CMD Команда
uint8_t HoldCurrent Ток мотора в режиме удержания, в процентах от номинального. Диапазон: 0..100.
uint16_t CurrReductDelay Время в мс от перехода в состояние STOP до уменьшения тока.
uint16_t PowerOffDelay Время в с от перехода в состояние STOP до отключения питания мотора.
uint16_t CurrentSetTime Время в мс, требуемое для набора номинального тока от 0% до 100%.
uint8_t PowerFlags Флаги параметров управления питанием. Это битовая маска для побитовых операций.
  0x1 - POWER_REDUCT_ENABLED Если флаг установлен, уменьшить ток по прошествии CurrReductDelay. Иначе - не уменьшать.
  0x2 - POWER_OFF_ENABLED Если флаг установлен, снять напряжение с обмоток по прошествии PowerOffDelay. Иначе - не снимать.
  0x4 - POWER_SMOOTH_CURRENT Если установлен, то запитывание обмоток, снятие питания или снижение/повышение тока происходят плавно со скоростью CurrentSetTime, а только потом выполняется та задача, которая вызвала это плавное изменение.
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи параметров питания мотора. Используется только с шаговым двигателем.

6.2.6.69. Команда SSEC

Код команды (CMD): «ssec» или 0x63657373.

Запрос: (28 байт)

uint32_t CMD Команда
uint16_t LowUpwrOff Нижний порог напряжения на силовой части для выключения, десятки мВ.
uint16_t CriticalIpwr Максимальный ток силовой части, вызывающий состояние ALARM, в мА.
uint16_t CriticalUpwr Максимальное напряжение на силовой части, вызывающее состояние ALARM, десятки мВ.
uint16_t CriticalT Максимальная температура контроллера, вызывающая состояние ALARM, в десятых долях градуса Цельсия.
uint16_t CriticalIusb Максимальный ток USB, вызывающий состояние ALARM, в мА.
uint16_t CriticalUusb Максимальное напряжение на USB, вызывающее состояние ALARM, десятки мВ.
uint16_t MinimumUusb Минимальное напряжение на USB, вызывающее состояние ALARM, десятки мВ.
uint8_t Flags Флаги критических параметров. Это битовая маска для побитовых операций.
  0x1 - ALARM_ON_DRIVER_OVERHEATING Если флаг установлен, то войти в состояние Alarm при получении сигнала подступающего перегрева с драйвера. Иначе - игнорировать подступающий перегрев с драйвера.
  0x2 - LOW_UPWR_PROTECTION Если установлен, то выключать силовую часть при напряжении меньшем LowUpwrOff.
  0x4 - H_BRIDGE_ALERT Если установлен, то выключать силовую часть при сигнале неполадки в одном из транзисторных мостов.
  0x8 - ALARM_ON_BORDERS_SWAP_MISSET Если флаг установлен, то войти в состояние Alarm при получении сигнала c противоположного концевого выключателя
  0x10 - ALARM_FLAGS_STICKING Если флаг установлен, то только по команде STOP возможен сброс всех флагов ALARM
  0x20 - USB_BREAK_RECONNECT Если флаг установлен, то будет включен блок перезагрузки USB при поломке связи
  0x40 - ALARM_WINDING_MISMATCH Если флаг установлен, то войти в состояние Alarm при получении сигнала рассогласования обмоток
  0x80 - ALARM_ENGINE_RESPONSE Если флаг установлен, то войти в состояние Alarm при получении сигнала ошибки реакции двигателя на управляющее воздействие
uint8_t Reserved [7] Зарезервировано (7 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи установок защит.

6.2.6.70. Команда SSNI

Код команды (CMD): «ssni» или 0x696E7373.

Запрос: (28 байт)

uint32_t CMD Команда
uint8_t SyncInFlags Флаги синхронизации входа. Это битовая маска для побитовых операций.
  0x1 - SYNCIN_ENABLED Включение необходимости импульса синхронизации для начала движения.
  0x2 - SYNCIN_INVERT Если установлен - срабатывает по переходу из 1 в 0. Иначе - из 0 в 1.
  0x4 - SYNCIN_GOTOPOSITION Если флаг установлен, то двигатель смещается к позиции, установленной в Position и uPosition, иначе двигатель смещается на Position и uPosition
uint16_t ClutterTime Минимальная длительность входного импульса синхронизации для защиты от дребезга (мкс).
int32_t Position Желаемая позиция или смещение (в полных шагах)
int16_t uPosition Дробная часть позиции или смещения в микрошагах. Используется только с шаговым двигателем. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint32_t Speed Заданная скорость (для ШД: шагов/c, для DC: rpm). Диапазон: 0..100000.
uint8_t uSpeed Заданная скорость в микрошагах в секунду. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым мотором.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек для входного импульса синхронизации. Эта функция записывает структуру с настройками входного импульса синхронизации, определяющими поведение входа синхронизации, в память контроллера.

6.2.6.71. Команда SSNO

Код команды (CMD): «ssno» или 0x6F6E7373.

Запрос: (16 байт)

uint32_t CMD Команда
uint8_t SyncOutFlags Флаги синхронизации выхода. Это битовая маска для побитовых операций.
  0x1 - SYNCOUT_ENABLED Синхронизация выхода работает согласно настройкам, если флаг установлен. В ином случае значение выхода фиксировано и подчиняется SYNCOUT_STATE.
  0x2 - SYNCOUT_STATE Когда значение выхода управляется напрямую (см. флаг SYNCOUT_ENABLED), значение на выходе соответствует значению этого флага.
  0x4 - SYNCOUT_INVERT Нулевой логический уровень является активным, если флаг установлен, а единичный - если флаг сброшен.
  0x8 - SYNCOUT_IN_STEPS Если флаг установлен использовать шаги/импульсы энкодера для выходных импульсов синхронизации вместо миллисекунд.
  0x10 - SYNCOUT_ONSTART Генерация синхронизирующего импульса при начале движения.
  0x20 - SYNCOUT_ONSTOP Генерация синхронизирующего импульса при остановке.
  0x40 - SYNCOUT_ONPERIOD Выдает импульс синхронизации после прохождения SyncOutPeriod отсчётов.
uint16_t SyncOutPulseSteps Определяет длительность выходных импульсов в шагах/импульсах энкодера, когда установлен флаг SYNCOUT_IN_STEPS, или в микросекундах если флаг сброшен.
uint16_t SyncOutPeriod Период генерации импульсов (в шагах/отсчетах энкодера), используется при установленном флаге SYNCOUT_ONPERIOD.
uint32_t Accuracy Это окрестность вокруг целевой координаты, попадание в которую считается попаданием в целевую позицию и генерируется импульс по остановке.
uint8_t uAccuracy Это окрестность вокруг целевой координаты в микрошагах (используется только с шаговым двигателем). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек для выходного импульса синхронизации. Эта функция записывает структуру с настройками выходного импульса синхронизации, определяющими поведение вывода синхронизации, в память контроллера.

6.2.6.72. Команда SSTI

Код команды (CMD): «ssti» или 0x69747373.

Запрос: (70 байт)

uint32_t CMD Команда
int8_t Производитель Производитель. Максимальная длина строки: 16 символов.
int8_t PartNumber Серия и номер модели. Максимальная длина строки: 24 символа.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись информации о позиционере в EEPROM. Не поддерживается. Функция должна использоваться только производителем.

6.2.6.73. Команда SSTS

Код команды (CMD): «ssts» или 0x73747373.

Запрос: (70 байт)

uint32_t CMD Команда
float LeadScrewPitch Шаг ходового винта в мм. Тип данных: float.
int8_t Units Единицы измерения расстояния, используемые в полях MaxSpeed и TravelRange (шаги, градусы, мм, …), Максимальная длина строки: 8 символов.
float MaxSpeed Максимальная скорость (Units/с). Тип данных: float.
float TravelRange Диапазон перемещения (Units). Тип данных: float.
float SupplyVoltageMin Минимальное напряжение питания (В). Тип данных: float.
float SupplyVoltageMax Максимальное напряжение питания (В). Тип данных: float.
float MaxCurrentConsumption Максимальный ток потребления (А). Тип данных: float.
float HorizontalLoadCapacity Горизонтальная грузоподъемность (кг). Тип данных: float.
float VerticalLoadCapacity Вертикальная грузоподъемность (кг). Тип данных: float.
uint8_t Reserved [24] Зарезервировано (24 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек позиционера в EEPROM. Функция должна использоваться только производителем

6.2.6.74. Команда SURT

Код команды (CMD): «surt» или 0x74727573.

Запрос: (16 байт)

uint32_t CMD Команда
uint32_t Speed Cкорость UART (в бодах)
uint16_t UARTSetupFlags Флаги настройки UART. Это битовая маска для побитовых операций.
  0x3 - UART_PARITY_BITS Биты, отвечающие за выбор четности.
  0x0 - UART_PARITY_BIT_EVEN Бит 1, если четный
  0x1 - UART_PARITY_BIT_ODD Бит 1, если нечетный
  0x2 - UART_PARITY_BIT_SPACE Бит четности всегда 0
  0x3 - UART_PARITY_BIT_MARK Бит четности всегда 1
  0x4 - UART_PARITY_BIT_USE Бит чётности не используется, если „0“; бит четности используется, если „1“
  0x8 - UART_STOP_BIT Если установлен, один стоповый бит; иначе - 2 стоповых бита
uint8_t Reserved [4] Зарезервировано (4 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда записи настроек UART. Эта функция записывает структуру настроек UART в память контроллера.

6.2.6.75. Команда ASIA

Код команды (CMD): «asia» или 0x61697361.

Запрос: (22 байт)

uint32_t CMD Команда
int32_t Position Желаемая позиция или смещение (в полных шагах)
int16_t uPosition Дробная часть позиции или смещения в микрошагах. Используется только с шаговым двигателем. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint32_t Time Время, за которое требуется достичь требуемой позиции, в микросекундах.
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Это команда добавляет один элемент в буфер FIFO команд, выполняемых при получении входного импульса синхронизации. Каждый импульс синхронизации либо выполнится то действие, которое описано в SSNI, если буфер пуст, либо самое старое из загруженных в буфер действий временно подменяет скорость и координату в SSNI. В последнем случае это действие стирается из буфера. Количество оставшихся пустыми элементов буфера можно узнать в структуре GETS.

6.2.6.76. Команда CLFR

Код команды (CMD): «clfr» или 0x72666C63.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда очистки FRAM контроллера. Память очищается путем заполнения всего объема памяти байтами 0x00. После очистки контроллер перезагружается. Ответа на эту команду нет.

6.2.6.77. Команда CONN

Код команды (CMD): «conn» или 0x6E6E6F63.

Запрос: (14 байт)

uint32_t CMD Команда
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Ответ: (15 байт)

uint32_t CMD Команда
uint8_t sresult Результат выполнения команды.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Команда служит для открытия сеанса ISP (in-system programming) при загрузке прошивки. Result = RESULT_OK, если команда выполнена загрузчиком. Result = RESULT_SOFT_ERROR, если во время выполнения команды произошла ошибка. Result не доступен через функцию библиотеки command_update_firmware, значение поля обрабатывается внутри функции.

6.2.6.78. Команда DBGR

Код команды (CMD): «dbgr» или 0x72676264.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (142 байт)

uint32_t CMD Команда
uint8_t DebugData Отладочные данные.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение данных из прошивки для отладки и поиска неисправностей. Команда только для производителя. Получаемые данные зависят от версии прошивки, истории и контекста использования.

6.2.6.79. Команда DBGW

Код команды (CMD): «dbgw» или 0x77676264.

Запрос: (142 байт)

uint32_t CMD Команда
uint8_t DebugData Отладочные данные.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись данных в прошивку для отладки и поиска неисправностей. Команда только для производителя.

6.2.6.80. Команда DISC

Код команды (CMD): «disc» или 0x63736964.

Запрос: (14 байт)

uint32_t CMD Команда
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Ответ: (15 байт)

uint32_t CMD Команда
uint8_t sresult Результат выполнения команды.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Команда служит для закрытия сеанса ISP (in-system programming) при загрузке прошивки. Result = RESULT_OK, если команда выполнена загрузчиком. Result = RESULT_HARD_ERROR, если во время выполнения команды произошла аппаратная ошибка. Result = RESULT_SOFT_ERROR, если во время выполнения команды произошла программная ошибка. Result не доступен через функцию библиотеки command_update_firmware, значение поля обрабатывается внутри функции.

6.2.6.81. Команда EERD

Код команды (CMD): «eerd» или 0x64726565.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Чтение настроек контроллера из EEPROM памяти позиционера. Эта операция также автоматически выполняется при подключении позиционера с EEPROM памятью. Функция должна использоваться только производителем.

6.2.6.82. Команда EESV

Код команды (CMD): «eesv» или 0x76736565.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись настроек контроллера в EEPROM память позиционера Функция должна использоваться только производителем.

6.2.6.83. Команда GBLV

Код команды (CMD): «gblv» или 0x766C6267.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (10 байт)

uint32_t CMD Команда
uint8_t Major Мажорный номер версии загрузчика
uint8_t Minor Минорный номер версии загрузчика
uint16_t Release Номер релиза версии загрузчика
uint16_t CRC Контрольная сумма

Описание: Чтение номера версии загрузчика контроллера.

6.2.6.84. Команда GETC

Код команды (CMD): «getc» или 0x63746567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (38 байт)

uint32_t CMD Команда
int16_t WindingVoltageA В случае ШД, напряжение на обмотке A (в десятках мВ); в случае бесщеточного, напряжение на первой обмотке; в случае DC - на единственной.
int16_t WindingVoltageB В случае ШД, напряжение на обмотке B (в десятках мВ); в случае бесщеточного, напряжение на второй обмотке; в случае DC не используется.
int16_t WindingVoltageC В случае бесщеточного, напряжение на третьей обмотке (в десятках мВ); в случае ШД и DC не используется.
int16_t WindingCurrentA В случае ШД, ток в обмотке A (в мA); в случае бесщеточного, ток в первой обмотке; в случае DC в единственной.
int16_t WindingCurrentB В случае ШД, ток в обмотке B (в мА); в случае бесщеточного, ток в второй обмотке; в случае DC не используется.
int16_t WindingCurrentC В случае бесщеточного, ток в третьей обмотке (в мА); в случае ШД и DC не используется.
uint16_t Pot Значение на аналоговом входе. Диапазон: 0..10000
uint16_t Joy Положение джойстика в десятитысячных долях. Диапазон: 0..10000
int16_t DutyCycle Коэффициент заполнения ШИМ.
uint8_t Reserved [14] Зарезервировано (14 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения состояния обмоток и других не часто используемых данных. Предназначена в первую очередь для получения данных для построения графиков в паре с командой GETS.

6.2.6.85. Команда GETI

Код команды (CMD): «geti» или 0x69746567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (36 байт)

uint32_t CMD Команда
int8_t Производитель Производитель
int8_t ManufacturerId Идентификатор производителя
int8_t ProductDescription Описание продукта
uint8_t Major Основной номер версии железа.
uint8_t Minor Второстепенный номер версии железа.
uint16_t Release Номер правок этой версии железа.
uint8_t Reserved [12] Зарезервировано (12 байт)
uint16_t CRC Контрольная сумма

Описание: Возвращает информацию об устройстве. Доступна как из прошивки, так и из бутлоадера.

6.2.6.86. Команда GETM

Код команды (CMD): «getm» или 0x6D746567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (216 байт)

uint32_t CMD Команда
int32_t Speed Текущая скорость в микрошагах в секунду (целые шаги пересчитываются с учетом текущего режима деления шага) или отсчетах энкодера в секунду.
int32_t Error Текущая скорость в микрошагах в секунду (целые шаги пересчитываются с учетом текущего режима деления шага) или отсчетах энкодера в секунду.
uint32_t Length Длина фактических данных в буфере.
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Описание: Команда чтения буфера данных для построения графиков скорости и ошибки следования. Заполнение буфера начинается по команде „start_measurements“. Буфер вмещает 25 точек, точки снимаются с периодом 1 мс. Для создания устойчивой системы следует считывать данные каждые 20 мс, если буфер полностью заполнен, то рекомендуется повторять считывания каждые 5 мс до момента пока буфер вновь не станет заполнен 20-ю точками.

6.2.6.87. Команда GETS

Код команды (CMD): «gets» или 0x73746567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (54 байт)

uint32_t CMD Команда
uint8_t MoveSts Состояние движения. Это битовая маска для побитовых операций.
  0x1 - MOVE_STATE_MOVING Если флаг установлен, то контроллер пытается вращать двигателем. Не используйте этот флаг для ожидания завершения команды движения. Вместо него используйте MVCMD_RUNNING из поля MvCmdSts.
  0x2 - MOVE_STATE_TARGET_SPEED Флаг устанавливается при достижении заданной скорости.
  0x4 - MOVE_STATE_ANTIPLAY Выполняется компенсация люфта, если флаг установлен.
uint8_t MvCmdSts Состояние команды движения (касается command_move, command_movr, command_left, command_right, command_stop, command_home, command_loft). Это битовая маска для побитовых операций.
  0x3f - MVCMD_NAME_BITS Битовая маска активной команды.
  0x0 - MVCMD_UKNWN Неизвестная команда.
  0x1 - MVCMD_MOVE Команда move.
  0x2 - MVCMD_MOVR Команда movr.
  0x3 - MVCMD_LEFT Команда left.
  0x4 - MVCMD_RIGHT Команда rigt.
  0x5 - MVCMD_STOP Команда stop.
  0x6 - MVCMD_HOME Команда home.
  0x7 - MVCMD_LOFT Команда loft.
  0x8 - MVCMD_SSTP Команда плавной остановки(SSTP).
  0x40 - MVCMD_ERROR Состояние завершения движения (1 - команда движения выполнена с ошибкой, 0 - команда движения выполнена корректно). Имеет смысл если MVCMD_RUNNING указывает на завершение движения.
  0x80 - MVCMD_RUNNING Состояние команды движения (0 - команда движения выполнена, 1 - команда движения сейчас выполняется).
uint8_t PWRSts Состояние питания шагового двигателя (используется только с шаговым двигателем). Это битовая маска для побитовых операций.
  0x0 - PWR_STATE_UNKNOWN Неизвестное состояние, которое не должно никогда реализовываться.
  0x1 - PWR_STATE_OFF Обмотки мотора разомкнуты и не управляются драйвером.
  0x3 - PWR_STATE_NORM Обмотки запитаны номинальным током.
  0x4 - PWR_STATE_REDUCT Обмотки намеренно запитаны уменьшенным током от рабочего для снижения потребляемой мощности.
  0x5 - PWR_STATE_MAX Обмотки двигателя питаются от максимального тока, который драйвер может обеспечить при этом напряжении.
uint8_t EncSts Состояние энкодера. Это битовая маска для побитовых операций.
  0x0 - ENC_STATE_ABSENT Энкодер не подключен.
  0x1 - ENC_STATE_UNKNOWN Состояние энкодера неизвестно.
  0x2 - ENC_STATE_MALFUNC Энкодер подключен и неисправен.
  0x3 - ENC_STATE_REVERS Энкодер подключен и исправен, но считает в другую сторону.
  0x4 - ENC_STATE_OK Энкодер подключен и работает должным образом.
uint8_t WindSts Состояние обмоток. Это битовая маска для побитовых операций.
  0x0 - WIND_A_STATE_ABSENT Обмотка A не подключена.
  0x1 - WIND_A_STATE_UNKNOWN Состояние обмотки A неизвестно.
  0x2 - WIND_A_STATE_MALFUNC Короткое замыкание на обмотке A.
  0x3 - WIND_A_STATE_OK Обмотка A работает адекватно.
  0x0 - WIND_B_STATE_ABSENT Обмотка B не подключена.
  0x10 - WIND_B_STATE_UNKNOWN Состояние обмотки B неизвестно.
  0x20 - WIND_B_STATE_MALFUNC Короткое замыкание на обмотке B.
  0x30 - WIND_B_STATE_OK Обмотка B работает адекватно.
int32_t CurPosition Первичное поле, в котором хранится текущая позиция, как бы ни была устроена обратная связь. В случае работы с DC-мотором в этом поле находится текущая позиция по данным с энкодера, в случае работы с ШД-мотором в режиме, когда первичными являются импульсы, подаваемые на мотор, в этом поле содержится целое значение шагов текущей позиции.
int16_t uCurPosition Дробная часть текущей позиции в микрошагах. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым двигателем.
int64_t EncPosition Текущая позиция по данным с энкодера в импульсах энкодера, используется только если энкодер установлен, активизирован и не является основным датчиком положения, например при использовании энкодера совместно с шаговым двигателем для контроля проскальзования.
int32_t CurSpeed Текущая скорость.
int16_t uCurSpeed Дробная часть текущей скорости в микрошагах. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым двигателем.
int16_t Ipwr Ток потребления силовой части, мА.
int16_t Upwr Напряжение на силовой части, десятки мВ.
int16_t Iusb Ток потребления по USB, мА.
int16_t Uusb Напряжение на USB, десятки мВ.
int16_t CurT Температура процессора в десятых долях градусов Цельсия.
uint32_t Flags Флаги состояний. Это битовая маска для побитовых операций.
  0x3f - STATE_CONTR Флаги состояния контроллера.
  0x1 - STATE_ERRC Недопустимая команда. Полученная команда отсутствует в списке известных команд контроллера. Наиболее вероятной причиной является устаревшая прошивка.
  0x2 - STATE_ERRD Обнаружена ошибка целостности данных. Данные внутри команды и ее CRC-код не соответствуют, поэтому данные не могут считаться действительными. Эта ошибка может быть вызвана электромагнитными помехами в интерфейсе UART/RS232.
  0x4 - STATE_ERRV Недопустимое значение данных. Обнаружена ошибка в значении. Значения в команде не могут быть применены без коррекции, поскольку они выходят за допустимый диапазон. Вместо исходных значений были использованы исправленные значения.
  0x10 - STATE_EEPROM_CONNECTED Подключена память EEPROM с настройками. Встроенный профиль подвижки загружается из микросхемы памяти EEPROM, что позволяет подключать различные подвижки к контроллеру с автоматической настройкой.
  0x20 - STATE_IS_HOMED Калибровка выполнена. Это означает, что шкала относительного положения откалибрована с помощью аппаратного датчика абсолютного положения, такого как концевой переключатель.
  0x1b3ffc0 - STATE_SECUR Флаги опасности.
  0x40 - STATE_ALARM Контроллер находится в состоянии ALARM, показывая, что случилась какая-то опасная ситуация. В состоянии ALARM все команды игнорируются пока не будет послана команда STOP и состояние ALARM деактивируется.
  0x80 - STATE_CTP_ERROR Контроль позиции нарушен(используется только с шаговым двигателем). Флаг устанавливается, когда положение энкодера и положение шага слишком далеки друг от друга.
  0x100 - STATE_POWER_OVERHEAT Перегрев силового драйвера. Управление двигателем отключено до восстановления рабочей температуры драйвера. Этого не должно происходить в коробочных версиях контроллера. Это может произойти в версии контроллера с «голой» платой и с пользовательским радиатором. Решение: используйте другой радиатор.
  0x200 - STATE_CONTROLLER_OVERHEAT Перегрелась микросхема контроллера.
  0x400 - STATE_OVERLOAD_POWER_VOLTAGE Превышено напряжение на силовой части.
  0x800 - STATE_OVERLOAD_POWER_CURRENT Превышен максимальный ток потребления силовой части.
  0x1000 - STATE_OVERLOAD_USB_VOLTAGE Превышено напряжение на USB.
  0x2000 - STATE_LOW_USB_VOLTAGE Слишком низкое напряжение на USB.
  0x4000 - STATE_OVERLOAD_USB_CURRENT Превышен максимальный ток потребления USB.
  0x8000 - STATE_BORDERS_SWAP_MISSET Достижение неверной границы.
  0x10000 - STATE_LOW_POWER_VOLTAGE Напряжение на силовой части ниже чем напряжение Low Voltage Protection
  0x20000 - STATE_H_BRIDGE_FAULT Получен сигнал от драйвера о неисправности
  0x100000 - STATE_WINDING_RES_MISMATCH Сопротивления обмоток слишком сильно отличаются друг от друга. Обычно это происходит с поврежденным шаговым двигателем у которого полностью или частично закорочены обмотки.
  0x200000 - STATE_ENCODER_FAULT Получен сигнал от энкодера о неисправности
  0x800000 - STATE_ENGINE_RESPONSE_ERROR Ошибка реакции двигателя на управляющее воздействие. Отказ алгоритма управления двигателем означает, что он не может определять правильные решения с помощью полученных данных обратной связи. Единичный отказ может быть вызван механической проблемой. Повторяющийся сбой может быть вызван неправильной настройкой двигателя.
  0x1000000 - STATE_EXTIO_ALARM Ошибка вызвана внешним входным сигналом EXTIO.
uint32_t GPIOFlags Флаги состояний GPIO входов. Это битовая маска для побитовых операций.
  0xffff - STATE_DIG_SIGNAL Флаги цифровых сигналов.
  0x1 - STATE_RIGHT_EDGE Достижение правой границы.
  0x2 - STATE_LEFT_EDGE Достижение левой границы.
  0x4 - STATE_BUTTON_RIGHT Состояние кнопки „вправо“ (1, если нажата).
  0x8 - STATE_BUTTON_LEFT Состояние кнопки „влево“ (1, если нажата).
  0x10 - STATE_GPIO_PINOUT Если флаг установлен, ввод/вывод общего назначения работает как выход; если флаг сброшен, ввод/вывод работает как вход.
  0x20 - STATE_GPIO_LEVEL Состояние ввода/вывода общего назначения.
  0x200 - STATE_BRAKE Состояние вывода управления тормозом. Флаг „1“ - если тормоз не запитан(зажат), „0“ - если на тормоз подаётся питание(разжат).
  0x400 - STATE_REV_SENSOR Состояние вывода датчика оборотов(флаг „1“, если датчик активен).
  0x800 - STATE_SYNC_INPUT Состояние входа синхронизации(1, если вход синхронизации активен).
  0x1000 - STATE_SYNC_OUTPUT Состояние выхода синхронизации(1, если выход синхронизации активен).
  0x2000 - STATE_ENC_A Состояние ножки A энкодера(флаг „1“, если энкодер активен).
  0x4000 - STATE_ENC_B Состояние ножки B энкодера(флаг „1“, если энкодер активен).
uint8_t CmdBufFreeSpace Данное поле служебное. Оно показывает количество свободных ячеек буфера цепочки синхронизации.
uint8_t Reserved [4] Зарезервировано (4 байт)
uint16_t CRC Контрольная сумма

Описание: Возвращает информацию о текущем состоянии устройства.

6.2.6.88. Команда GFWV

Код команды (CMD): «gfwv» или 0x76776667.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (10 байт)

uint32_t CMD Команда
uint8_t Major Мажорный номер версии прошивки
uint8_t Minor Минорный номер версии прошивки
uint16_t Release Номер релиза версии прошивки
uint16_t CRC Контрольная сумма

Описание: Чтение номера версии прошивки контроллера.

6.2.6.89. Команда GOFW

Код команды (CMD): «gofw» или 0x77666F67.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (15 байт)

uint32_t CMD Команда
uint8_t sresult Результат выполнения команды.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Команда инициирует передачу управления прошивке. Эта команда так же доступна из прошивки, для совместимости. Только для производителя. Result = RESULT_OK, если переход из загрузчика в прошивку возможен. После ответа на эту команду выполняется переход. Result = RESULT_NO_FIRMWARE, если прошивка не найдена. Result = RESULT_ALREADY_IN_FIRMWARE, если эта команда была вызвана из прошивки.

6.2.6.90. Команда GPOS

Код команды (CMD): «gpos» или 0x736F7067.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (26 байт)

uint32_t CMD Команда
int32_t Position Позиция в основных шагах двигателя
int16_t uPosition Позиция в микрошагах (используется только с шаговыми двигателями). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
int64_t EncPosition Позиция энкодера.
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Описание: Считывает значение положения в шагах и микрошагах для шагового двигателя и в шагах энкодера всех двигателей.

6.2.6.91. Команда GSER

Код команды (CMD): «gser» или 0x72657367.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (10 байт)

uint32_t CMD Команда
uint32_t SerialNumber Серийный номер платы.
uint16_t CRC Контрольная сумма

Описание: Чтение серийного номера контроллера.

6.2.6.92. Команда GUID

Код команды (CMD): «guid» или 0x64697567.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (40 байт)

uint32_t CMD Команда
uint32_t UniqueID0 Уникальный ID 0.
uint32_t UniqueID1 Уникальный ID 1.
uint32_t UniqueID2 Уникальный ID 2.
uint32_t UniqueID3 Уникальный ID 3.
uint8_t Reserved [18] Зарезервировано (18 байт)
uint16_t CRC Контрольная сумма

Описание: Считывает уникальный идентификатор каждого чипа, это значение не является случайным. Только для производителя. Уникальный идентификатор может быть использован в качестве инициализационного вектора для операций шифрования бутлоадера или в качестве серийного номера для USB и других применений.

6.2.6.93. Команда HASF

Код команды (CMD): «hasf» или 0x66736168.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (15 байт)

uint32_t CMD Команда
uint8_t sresult Результат выполнения команды.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Команда определяет наличие в контроллере ПО. Только для производителя. Данная команда доступна так же из прошивки. Result = RESULT_NO_FIRMWARE, если прошивка не найдена. Result = RESULT_HAS_FIRMWARE, если прошивка найдена.

6.2.6.94. Команда HOME

Код команды (CMD): «home» или 0x656D6F68.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Движение в домашнюю позицию. Алгоритм движения: 1) Двигает мотор согласно скоростям FastHome, uFastHome и флагу HOME_DIR_FAST до достижения концевого выключателя, если флаг HOME_STOP_ENDS установлен. Или двигает до достижения сигнала с входа синхронизации, если установлен флаг HOME_STOP_SYNC. Или до поступления сигнала с датчика оборотов, если установлен флаг HOME_STOP_REV_SN 2) далее двигает согласно скоростям SlowHome, uSlowHome и флагу HOME_DIR_SLOW до достижения сигнала с входа синхронизации, если установлен флаг HOME_MV_SEC. Если флаг HOME_MV_SEC сброшен, пропускаем этот пункт. 3) далее двигает мотор согласно скоростям FastHome, uFastHome и флагу HOME_DIR_SLOW на расстояние HomeDelta, uHomeDelta. Описание флагов и переменных см. описание команд GHOM/SHOM.

6.2.6.95. Команда IRND

Код команды (CMD): «irnd» или 0x646E7269.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (24 байт)

uint32_t CMD Команда
uint8_t key Случайный ключ.
uint8_t Reserved [2] Зарезервировано (2 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение случайного числа из контроллера. Только для производителя.

6.2.6.96. Команда LEFT

Код команды (CMD): «left» или 0x7466656C.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: При получении команды „left“ двигатель начинает смещаться, с заранее установленными параметрами (скорость, ускорение), влево.

6.2.6.97. Команда LOFT

Код команды (CMD): «loft» или 0x74666F6C.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: При получении команды „loft“ двигатель смещается из текущей точки на расстояние Antiplay, заданное в настройках мотора (engine_settings), затем двигается в ту же точку.

6.2.6.98. Команда MOVE

Код команды (CMD): «move» или 0x65766F6D.

Запрос: (18 байт)

uint32_t CMD Команда
int32_t Position Желаемая позиция (в целых шагах или отсчетах энкодера).
int16_t uPosition Дробная часть позиции в микрошагах. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings). Используется только с шаговым двигателем.
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: При получении команды „move“ двигатель начинает перемещаться (если не используется режим „ТТЛСинхроВхода“), с заранее установленными параметрами (скорость, ускорение, удержание), к точке указанной в полях Position, uPosition. Для шагового мотора uPosition задает значение микрошага, для DC мотора это поле не используется.

6.2.6.99. Команда MOVR

Код команды (CMD): «movr» или 0x72766F6D.

Запрос: (18 байт)

uint32_t CMD Команда
int32_t DeltaPosition Смещение (дельта) позиции (в целых шагах или отсчетах энкодера)
int16_t uDeltaPosition Дробная часть смещения в микрошагах, используется только с шаговым двигателем. Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
uint8_t Reserved [6] Зарезервировано (6 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Перемещение на заданное смещение. При получении команды „movr“ двигатель начинает смещаться (если не используется режим „ТТЛСинхроВхода“), с заранее установленными параметрами (скорость, ускорение, удержание), влево или вправо (зависит от знака DeltaPosition) на количество импульсов указанное в полях DeltaPosition, uDeltaPosition. Для шагового мотора uDeltaPosition задает значение микрошага, для DC мотора это поле не используется.

6.2.6.100. Команда PWOF

Код команды (CMD): «pwof» или 0x666F7770.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Немедленное отключение питания двигателя вне зависимости от его состояния. Команда предназначена для ручного управления питанием двигателя. Не следует использовать эту команду для отключения двигателя во время движения, так как питание может снова включиться для завершения движения. Для автоматического управления питанием двигателя и его отключения после остановки следует использовать систему управления электропитанием.

6.2.6.101. Команда RDAN

Код команды (CMD): «rdan» или 0x6E616472.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (76 байт)

uint32_t CMD Команда
uint16_t A1Voltage_ADC „Выходное напряжение на 1 выводе обмотки А“ необработанные данные с АЦП.
uint16_t A2Voltage_ADC „Выходное напряжение на 2 выводе обмотки А“ необработанные данные с АЦП.
uint16_t B1Voltage_ADC „Выходное напряжение на 1 выводе обмотки B“ необработанные данные с АЦП.
uint16_t B2Voltage_ADC „Выходное напряжение на 2 выводе обмотки B“ необработанные данные с АЦП.
uint16_t SupVoltage_ADC „Напряжение питания ключей Н-моста“ необработанные данные с АЦП.
uint16_t ACurrent_ADC „Ток через обмотку А“ необработанные данные с АЦП.
uint16_t BCurrent_ADC „Ток через обмотку B“ необработанные данные с АЦП.
uint16_t FullCurrent_ADC „Полный ток“ необработанные данные с АЦП.
uint16_t Temp_ADC Напряжение с датчика температуры, необработанные данные с АЦП.
uint16_t Joy_ADC Джойстик, необработанные данные с АЦП.
uint16_t Pot_ADC Напряжение на аналоговом входе, необработанные данные с АЦП
uint16_t L5_ADC Напряжение питания USB после current sense резистора, необработанные данные с АЦП.
uint16_t H5_ADC Напряжение питания USB, необработанные данные с АЦП
int16_t A1Voltage „Выходное напряжение на 1 выводе обмотки А“ откалиброванные данные (в десятках мВ).
int16_t A2Voltage „Выходное напряжение на 2 выводе обмотки А“ откалиброванные данные (в десятках мВ).
int16_t B1Voltage „Выходное напряжение на 1 выводе обмотки B“ откалиброванные данные (в десятках мВ).
int16_t B2Voltage „Выходное напряжение на 2 выводе обмотки B“ откалиброванные данные (в десятках мВ).
int16_t SupVoltage „Напряжение питания ключей Н-моста“ откалиброванные данные (в десятках мВ).
int16_t ACurrent „Ток через обмотку А“ откалиброванные данные (в мА).
int16_t BCurrent „Ток через обмотку B“ откалиброванные данные (в мА).
int16_t FullCurrent „Полный ток“ откалиброванные данные (в мА).
int16_t Temp Температура, откалиброванные данные (в десятых долях градуса Цельсия).
int16_t Joy Джойстик во внутренних единицах. Диапазон: 0..10000
int16_t Pot Аналоговый вход во внутренних единицах. Диапазон: 0..10000
int16_t L5 Напряжение питания USB после current sense резистора (в десятках мВ).
int16_t H5 Напряжение питания USB (в десятках мВ).
uint16_t deprecated  
int32_t R Сопротивление обмоток двигателя(для шагового двигателя), в мОм.
int32_t L Псевдоиндуктивность обмоток двигателя(для шагового двигателя), в мкГн.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Чтение аналоговых данных, содержащих данные с АЦП и нормированные значения величин. Эта функция используется для тестирования и калибровки устройства.

6.2.6.102. Команда READ

Код команды (CMD): «read» или 0x64616572.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Чтение всех настроек контроллера из flash памяти в оперативную, заменяя текущие настройки.

6.2.6.103. Команда RERS

Код команды (CMD): «rers» или 0x73726572.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Чтение важных настроек (калибровочные коэффициенты и т.п.) контроллера из flash памяти в оперативную, заменяя текущие настройки. Только для производителя.

6.2.6.104. Команда REST

Код команды (CMD): «rest» или 0x74736572.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда сброса контроллера и перехода в режим загрузчика, добавлена для совместимости с Протоколом Обмена Загрузчика. Ответа на эту команду нет.

6.2.6.105. Команда RIGT

Код команды (CMD): «rigt» или 0x74676972.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: При получении команды „rigt“ двигатель начинает смещаться, с заранее установленными параметрами (скорость, ускорение), вправо.

6.2.6.106. Команда SARS

Код команды (CMD): «sars» или 0x73726173.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: При получении команды контроллер выполняет операцию сохранения важных настроек (калибровочные коэффициенты и т.п.) во встроенную энергонезависимую память контроллера. Только для производителя.

6.2.6.107. Команда SAVE

Код команды (CMD): «save» или 0x65766173.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: При получении команды контроллер выполняет операцию сохранения текущих настроек во встроенную энергонезависимую память контроллера.

6.2.6.108. Команда SPOS

Код команды (CMD): «spos» или 0x736F7073.

Запрос: (26 байт)

uint32_t CMD Команда
int32_t Position Позиция в основных шагах двигателя
int16_t uPosition Позиция в микрошагах (используется только с шаговыми двигателями). Величина микрошага и диапазон допустимых значений для данного поля зависят от выбранного режима деления шага (см. поле MicrostepMode в engine_settings).
int64_t EncPosition Позиция энкодера.
uint8_t PosFlags Флаги. Это битовая маска для побитовых операций.
  0x1 - SETPOS_IGNORE_POSITION Если установлен, то позиция в шагах и микрошагах не обновляется.
  0x2 - SETPOS_IGNORE_ENCODER Если установлен, то счётчик энкодера не обновляется.
uint8_t Reserved [5] Зарезервировано (5 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Устанавливает произвольное значение положения в шагах и микрошагах для шагового двигателя и в шагах энкодера для всех двигателей.

6.2.6.109. Команда SSER

Код команды (CMD): «sser» или 0x72657373.

Запрос: (50 байт)

uint32_t CMD Команда
uint32_t SN Новый серийный номер платы.
uint8_t Key Ключ защиты для установки серийного номера (256 бит).
uint8_t Major Основной номер версии железа.
uint8_t Minor Второстепенный номер версии железа.
uint16_t Release Номер правок этой версии железа.
uint8_t Reserved [4] Зарезервировано (4 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Запись серийного номера и версии железа во flash память контроллера. Вместе с новым серийным номером и версией железа передаётся „Ключ“, только при совпадении которого происходит изменение и сохранение. Функция используется только производителем.

6.2.6.110. Команда SSTP

Код команды (CMD): «sstp» или 0x70747373.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Плавная остановка. Двигатель останавливается с ускорением замедления.

6.2.6.111. Команда STMS

Код команды (CMD): «stms» или 0x736D7473.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Начать измерения и буферизацию скорости, ошибки следования.

6.2.6.112. Команда STOP

Код команды (CMD): «stop» или 0x706F7473.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Немедленная остановка двигателя, переход в состояние STOP, ключи в режиме BREAK (обмотки накоротко замкнуты), режим „удержания“ дезактивируется для DC двигателей, удержание тока в обмотках для шаговых двигателей (с учётом Power management настроек). При вызове этой команды сбрасывается флаг ALARM.

6.2.6.113. Команда UPDF

Код команды (CMD): «updf» или 0x66647075.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Команда переводит контроллер в режим обновления прошивки. Только для производителя. Получив такую команду, прошивка платы устанавливает флаг (для загрузчика), отправляет эхо-ответ и перезагружает контроллер.

6.2.6.114. Команда WDAT

Код команды (CMD): «wdat» или 0x74616477.

Запрос: (142 байт)

uint32_t CMD Команда
uint8_t Data Закодированная прошивка.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Записывает данные (прошивку) во Flash память контроллера. Не возвращает результат выполнения, хотя может завершаться ошибкой. Ошибочность заливки и тип ошибки можно узнать при завершении заливки.

6.2.6.115. Команда WKEY

Код команды (CMD): «wkey» или 0x79656B77.

Запрос: (46 байт)

uint32_t CMD Команда
uint8_t Key Ключ защиты для установки серийного номера (256 бит).
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Ответ: (15 байт)

uint32_t CMD Команда
uint8_t sresult Результат выполнения команды.
uint8_t Reserved [8] Зарезервировано (8 байт)
uint16_t CRC Контрольная сумма

Описание: Команда записи ключа для расшифровки прошивки. Result = RESULT_OK, если команда выполнена загрузчиком. Result = RESULT_HARD_ERROR, если во время выполнения команды произошла ошибка. Result не доступен через функцию библиотеки write_key, значение поля обрабатывается внутри функции. Функция используется только производителем.

6.2.6.116. Команда ZERO

Код команды (CMD): «zero» или 0x6F72657A.

Запрос: (4 байт)

uint32_t CMD Команда

Ответ: (4 байт)

uint32_t CMD Команда

Описание: Устанавливает текущую позицию равной 0. Устанавливает позицию, в которую осуществляется движение по командам move и movr, равной нулю во всех случаях, кроме движения к позиции назначения. В последнем случае позиция назначения пересчитывается так, что в абсолютном положении точка назначения не меняется. То есть если мы находились в точке 400 и двигались к 500, то команда Zero делает текущую позицию 0, а позицию назначения - 100. Не изменяет режим движения: т.е. если движение осуществлялось, то оно продолжается; если мотор находился в режиме „удержания“, то тип удержания сохраняется.

Об этом документе