Изменения документа Функции для разработки фоновых макросов
Редактировал(а) writer 2022/11/01 17:24
Сводка
-
Свойства страницы (3 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Родительский документ
-
... ... @@ -1,0 +1,1 @@ 1 +Руководство пользователя.Описание фоновых операций.WebHome - Теги
-
... ... @@ -1,0 +1,1 @@ 1 +m-код|фрезер|плазма|газ - Содержимое
-
... ... @@ -1,540 +1,3 @@ 1 1 === === 2 2 3 3 {{children style="h4"/}} 4 - 5 -=== bool IsGCodeRunning () === 6 - 7 -Позволяет проверить, находится ли PUMOTIX в режиме выполнения G-кода. 8 - 9 -Возвращаемое значение: 10 - 11 -* true – если PUMOTIX находится в режиме выполнения G-кода; 12 - 13 -=== bool IsMDIRunning () === 14 - 15 -Позволяет проверить, находится ли PUMOTIX в режиме выполнения команды ручного ввода. 16 - 17 -Возвращаемое значение: 18 - 19 -* true – если PUMOTIX находится в режиме выполнения команды ручного ввода; 20 - 21 -=== bool IsRunning () === 22 - 23 -Позволяет проверить, находится ли PUMOTIX в режиме выполнения G-кода или команды ручного ввода. 24 - 25 -Возвращаемое значение: 26 - 27 -* true – если активен любой из двух режимов IsGCodeRunning() или IsMDIRunning(); 28 - 29 -=== bool IsIdle () === 30 - 31 -Позволяет проверить, находится ли PUMOTIX в режиме ожидания (состояние Вкл кнопки включения). 32 - 33 -Возвращаемое значение: 34 - 35 -* true – если PUMOTIX находится в режиме ожидания; 36 - 37 -=== bool IsEStop () === 38 - 39 -Позволяет проверить, находится ли PUMOTIX в режиме EStop (состояние Выкл кнопки включения). 40 - 41 -Возвращаемое значение: 42 - 43 -* true – если PUMOTIX находится в режиме EStop; 44 - 45 -=== number AxisGetPos (number axisId) === 46 - 47 -Получение текущей рабочей координаты указанной оси. 48 - 49 -Параметры: 50 - 51 -* number axisId – номер оси, целое число от 0 до 8 (в качестве этого параметра может передаваться одна из констант, определённых в списке **[[Axis>>url:http://doc.pumotix.ru/pages/viewpage.action?pageId=5180766#id-%D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%D0%BE%D1%81%D1%8F%D0%BC%D0%B8-Axis(%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B%D0%BE%D1%81%D0%B5%D0%B9)||style="text-decoration: none;" rel="nofollow" shape="rect"]]**). 52 - 53 -Возвращаемое значение: 54 - 55 -* значение текущей рабочей координаты указанной оси. 56 - 57 -=== number AxisGetMachinePos (number axisId) === 58 - 59 -Получение текущей машинной координаты указанной оси. 60 - 61 -Параметры: 62 - 63 -* number axisId – номер оси, целое число от 0 до 8 (в качестве этого параметра может передаваться одна из констант, определённых в списке **[[Axis>>url:http://doc.pumotix.ru/pages/viewpage.action?pageId=5180766#id-%D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%D0%BE%D1%81%D1%8F%D0%BC%D0%B8-Axis(%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B%D0%BE%D1%81%D0%B5%D0%B9)||rel="nofollow" style="text-decoration: none;" shape="rect"]]**). 64 - 65 -Возвращаемое значение: 66 - 67 -* значение текущей машинной координаты указанной оси. 68 - 69 -=== number GetCurFeedrate () === 70 - 71 -Получение текущей скорости перемещения. 72 - 73 -Возвращаемое значение: 74 - 75 -* модуль вектора скорости перемещения в пространстве XYZ. 76 - 77 -=== number GetGCodeFeedrate () === 78 - 79 -Получение скорости перемещения, заданной в G-коде. 80 - 81 -Возвращаемое значение: 82 - 83 -* скорость перемещения, заданная в G-коде. 84 - 85 -=== number GetFeedrateOverridePercent () === 86 - 87 -Получение процента переопределения текущей скорости перемещения. 88 - 89 -Возвращаемое значение: 90 - 91 -* процент фактической скорости перемещения от заданной. 92 - 93 -=== void SetFeedrateOverridePercent (number value) === 94 - 95 -Задание процента переопределения текущей скорости перемещения. 96 - 97 -Параметры: 98 - 99 -* number value – желаемый процент переопределения текущей скорости перемещения. 100 - 101 -=== number GetRapidrateOverridePercent () === 102 - 103 -Получение процента переопределения текущей скорости холостых переездов. 104 - 105 -Возвращаемое значение: 106 - 107 -* процент фактической скорости холостых переездов от заданной. 108 - 109 -=== void SetRapidrateOverridePercent (number value) === 110 - 111 -Задание процента переопределения текущей скорости холостых переездов. 112 - 113 -Параметры: 114 - 115 -* number value – желаемый процент переопределения текущей скорости холостых переездов. 116 - 117 -=== bool IsAxisReferenced (number axisId) === 118 - 119 -Позволяет проверить, выполнен ли поиск базы по указанной оси. 120 - 121 -Параметры: 122 - 123 -* number axisId – номер оси, целое число от 0 до 8 (в качестве этого параметра может передаваться одна из констант, определённых в списке **[[Axis>>url:http://doc.pumotix.ru/pages/viewpage.action?pageId=5180766||style="text-decoration: none;" shape="rect"]]**). 124 - 125 -Возвращаемое значение: 126 - 127 -* true – если поиск базы выполнен: 128 -* false – если поиск базы не выполнен. 129 - 130 -=== bool IsAxesMaskReferenced (number axesMask) === 131 - 132 -Позволяет проверить, выполнен ли поиск базы для всех осей, заданных маской axesMask. 133 - 134 -Параметры: 135 - 136 -* number axesMask – маска осей, целое число, в котором биты от 0 до 8 обозначают, выбраны ли соответствующие оси. 137 - 138 -Возвращаемое значение: 139 - 140 -* true – если поиск базы выполнен; 141 -* false – если поиск базы не выполнен. 142 - 143 -=== number GetCurSpindleRPM () === 144 - 145 -Получение текущей скорости вращения шпинделя. 146 - 147 -Возвращаемое значение: 148 - 149 -* текущая скорость вращения шпинделя, об/мин. 150 - 151 -=== number GetGCodeSpindleRPM () === 152 - 153 -Получение скорости вращения шпинделя, заданной в G-коде. 154 - 155 -Возвращаемое значение: 156 - 157 -* Скорость вращения шпинделя, заданная в G-коде, об/мин. 158 - 159 -=== number GetSpindleSpeedOverridePercent () === 160 - 161 -Получение процента переопределения текущей скорости вращения шпинделя. 162 - 163 -Возвращаемое значение: 164 - 165 -* процент, который фактическая скорость вращения шпинделя составляет от заданной. 166 - 167 -=== void SetSpindleSpeedOverridePercent (number value) === 168 - 169 -Задание процента переопределения текущей скорости вращения шпинделя. 170 - 171 -Параметры: 172 - 173 -* number value – желаемый процент переопределения текущей скорости вращения шпинделя. 174 - 175 -=== void FloodEnable () === 176 - 177 -Включение подачи охлаждающей жидкости поливом. 178 - 179 -=== void FloodDisable () === 180 - 181 -Выключение подачи охлаждающей жидкости поливом. 182 - 183 -=== void MistEnable () === 184 - 185 -Включение подачи охлаждающей жидкости распылением. 186 - 187 -=== void MistDisable () === 188 - 189 -Выключение подачи охлаждающей жидкости распылением. 190 - 191 -=== void Sleep (number milliseconds) === 192 - 193 -Ожидание в течение указанного количества миллисекунд. 194 - 195 -Параметры: 196 - 197 -* number milliseconds – количество миллисекунд, в течение которых выполнение фонового макроса будет приостановлено. 198 - 199 -=== void DisplayMessage (string message) === 200 - 201 -Отображение в пользовательском интерфейсе сообщения от фонового макроса. Для корректного отображения символов национальных алфавитов файл макроса должен быть сохранён в кодировке UTF-8. 202 - 203 -Параметры: 204 - 205 -* string message – текст сообщения, которое должно быть показано пользователю. 206 - 207 -=== void Stop () === 208 - 209 -Остановка выполнения G-кода. 210 - 211 -=== void EStop () === 212 - 213 -Экстренная остановка выполнения G-кода и перевод системы в режим Выкл. 214 - 215 -=== void SetUserVariable (number index, number value) === 216 - 217 -Установка значения пользовательской переменной. Данное значение может быть прочитано при выполнении другого макроса, в том числе после перезапуска PUMOTIX. 218 - 219 -Параметры: 220 - 221 -* number index – номер переменной, целое число от 0 до 99; 222 -* number value – значение пользовательской переменной (вещественное число), которое необходимо установить. 223 - 224 -=== number GetUserVariable (number index) === 225 - 226 -Получение значения пользовательской переменной. 227 - 228 -Параметры: 229 - 230 -* number index – номер переменной, целое число от 0 до 99. 231 - 232 -Возвращаемое значение: 233 - 234 -* текущее значение пользовательской переменной (вещественное число). 235 - 236 -=== string str (number value) === 237 - 238 -Преобразование вещественного числа в строку. 239 - 240 -Язык Lua поддерживает неявное преобразование числа в строку, но по умолчанию для очень маленького вещественного числа результат преобразования может иметь экспоненциальный формат, что не позволяет использовать строку как часть строки G-кода. Для удобства можно использовать функцию str, которая гарантирует, что число будет иметь десятичное представление. 241 - 242 -Параметры: 243 - 244 -* number value – вещественное число, которое необходимо преобразовать. 245 - 246 -Возвращаемое значение: 247 - 248 -* строковое представление заданного числа. 249 - 250 -=== number GetSystemTickCount () === 251 - 252 -Получение количества миллисекунд, прошедшего с момента запуска операционной системы. Может использоваться для замера интервалов времени. Для получения текущих календарных даты и времени в UnixTime необходимо использовать стандартную функцию Lua (% style="color: rgb(36,39,41);" %)**os.time()**. 253 - 254 -Возвращаемое значение: 255 - 256 -* количество миллисекунд, прошедшее с момента запуска операционной системы. 257 - 258 -=== bool Is_THC_Mode () === 259 - 260 -Позволяет проверить, находится ли PUMOTIX в режиме плазменной резки. 261 - 262 -Возвращаемое значение: 263 - 264 -* true – если PUMOTIX находится в режиме плазменной резки; 265 -* false – если активен другой режим. 266 - 267 -=== number GetCurrentVoltage () === 268 - 269 -Получение текущего значения напряжения в режиме плазменной резки. 270 - 271 -Возвращаемое значение: 272 - 273 -* текущее напряжение, В. 274 - 275 -=== number GetDesiredVoltage () === 276 - 277 -Получение установленного значения желаемого напряжения в режиме плазменной резки. 278 - 279 -Возвращаемое значение: 280 - 281 -* желаемое напряжение, В. 282 - 283 -=== void SetDesiredVoltage (number value) === 284 - 285 -Установка значения желаемого напряжения в режиме плазменной резки. 286 - 287 -Параметры: 288 - 289 -* number value – желаемое напряжение, В. 290 - 291 -=== bool GetThcTorchOn () === 292 - 293 -Позволяет проверить, включен ли факел в режиме плазменной резки. 294 - 295 -Возвращаемое значение: 296 - 297 -* true – если факел в режиме плазменной резки включен; 298 - 299 -=== bool Is_Oxy_Mode () === 300 - 301 -Позволяет проверить, находится ли PUMOTIX в режиме газовой резки. 302 - 303 -Возвращаемое значение: 304 - 305 -* true – если PUMOTIX находится в режиме газовой резки; 306 -* false – если активен другой режим. 307 - 308 -=== bool GetOxyCuttingOn () === 309 - 310 -Позволяет проверить, включен ли режущий факел в режиме газовой резки. 311 - 312 -Возвращаемое значение: 313 - 314 -* true – если режущий факел в режиме газовой резки включен. 315 - 316 -=== bool GetOxyPreheatOn () === 317 - 318 -Позволяет проверить, включен ли прогрев в режиме газовой резки. 319 - 320 -Возвращаемое значение: 321 - 322 -* true – если прогрев в режиме газовой резки включен. 323 - 324 -=== number, bool ReadModbusRegister (string name) === 325 - 326 -Получение значения Modbus-регистра. 327 - 328 -Параметры: 329 - 330 -* string name – имя регистра, настроенного в меню Настройка Modbus. 331 - 332 -Возвращаемые значения: 333 - 334 -* value - значение Modbus-регистра. Возвращает последнее успешно прочитанное значение из кеша, обновляющегося с интервалом 100 мс (периодичность обновления может изменяться в зависимости от определённых условий). Если значение ни разу не было успешно прочитано, возвращается 0. 335 -* is_online - логическое значение, определяющее, была ли последняя попытка прочитать значение Modbus-регистра успешной. 336 - 337 -=== number, bool ReadModbusRegisterUpdated (string name) === 338 - 339 -Получение значения Modbus-регистра без использования кеша. Значение регистра запрашивается каждый раз при вызове команды. 340 - 341 -Параметры: 342 - 343 -* string name – имя регистра, настроенного в меню Настройка Modbus. 344 - 345 -Возвращаемые значения: 346 - 347 -* value - значение Modbus-регистра. 348 -* is_online - логическое значение, определяющее, была ли последняя попытка прочитать значение Modbus-регистра успешной. 349 - 350 -=== bool WriteModbusRegister (string name, number value) === 351 - 352 -Установка значения Modbus-регистра. 353 - 354 -Параметры: 355 - 356 -* string name – имя регистра, настроенного в меню Настройка Modbus. 357 -* number value - значение регистра, которое необходимо установить (16-битное целое число). 358 - 359 -Возвращаемое значение: 360 - 361 -* true - если установка значения Modbus-регистра выполнена успешно. 362 - 363 -=== bool IsRealDeviceConnected () === 364 - 365 -Позволяет проверить, установлено ли подключение к контроллеру. 366 - 367 -Возвращаемое значение: 368 - 369 -* true – если выбрано реальное устройство (не симулятор) и подключение к нему установлено. 370 - 371 -=== number GetJogOverridePercent (void) === 372 - 373 -Получение процента переопределения текущей скорости ручных перемещений. 374 - 375 -Возвращаемое значение: 376 - 377 -* процент переопределения скорости ручных перемещений. 378 - 379 -=== void SetJogOverridePercent (number value) === 380 - 381 -Установка процента переопределения текущей скорости ручных перемещений. 382 - 383 -Параметры: 384 - 385 -* number value – процент фактической скорости перемещения от заданной. 386 - 387 -=== number GetExecutingMCode () === 388 - 389 -Возвращает номер, выполняющегося макроса. Если макрос не запущен возвращает -1. 390 - 391 -Возвращаемое значение: 392 - 393 -* номер макроса. 394 - 395 -=== bool GetLedUserValue (number index) === 396 - 397 -Выводит значение пользовательской переменной. 398 - 399 -Параметры: 400 - 401 -* number index – номер переменной, целое число от 0 до 29. 402 - 403 -Возвращаемое значение: 404 - 405 -* bool - значение пользовательской переменной. 406 - 407 -=== void SetLedUserValue (number index, bool a_value) === 408 - 409 -Установка значения пользовательской переменной. Данное значение может быть прочитано при выполнении другого макроса, в том числе после перезапуска PUMOTIX. 410 - 411 -Параметры: 412 - 413 -* number index – номер переменной, целое число от 0 до 29; 414 -* bool a_value – значение пользовательской переменной. 415 - 416 -=== number GetNumUserValue (number index) === 417 - 418 -Выводит значения пользовательской переменной. 419 - 420 -Параметры: 421 - 422 -* number index – номер переменной, целое число от 0 до 29. 423 - 424 -Возвращаемое значение: 425 - 426 -* number - значение пользовательской переменной. 427 - 428 -=== void SetNumUserValue (number index, number value) === 429 - 430 -Установка значения пользовательской переменной. Данное значение может быть прочитано при выполнении другого макроса, в том числе после перезапуска PUMOTIX. 431 - 432 -Параметры: 433 - 434 -* number index – номер переменной, целое число от 0 до 29; 435 -* number value – значение пользовательской переменной (вещественное число), которое необходимо установить. 436 - 437 -=== string GetStrUserValue (number index) === 438 - 439 -Выводит значения пользовательской переменной. 440 - 441 -Параметры: 442 - 443 -* number index – номер переменной, целое число от 0 до 29. 444 - 445 -Возвращаемое значение: 446 - 447 -* string- значение пользовательской переменной. 448 - 449 -=== void SetNumUserValue (number index, string value) === 450 - 451 -Установка значения пользовательской переменной. Данное значение может быть прочитано при выполнении другого макроса, в том числе после перезапуска PUMOTIX. 452 - 453 -Параметры: 454 - 455 -* number index – номер переменной, целое число от 0 до 29; 456 -* string value - значение пользовательской переменной (строка), которое необходимо установить. 457 - 458 -=== string Get_Message (number messageId) === 459 - 460 -Получение одного из предопределённых локализованных текстовых сообщений. 461 - 462 -Параметры: 463 - 464 -* number messageId – идентификатор сообщения (в качестве этого параметра должна передаваться одна из констант, определённых в списке Messages). 465 - 466 -Возвращаемое значение: 467 - 468 -* локализованное текстовое сообщение. 469 - 470 -=== void RunGCode () === 471 - 472 -Запуск выполнения G-кода (аналогично нажатию кнопки Старт). 473 - 474 -=== void RunMDI (string command) === 475 - 476 -Выполнение заданной строки G-кода. Функция сразу же после вызова возвращает управление и выполнение фонового макроса продолжается. 477 - 478 -Параметры: 479 - 480 -* string command – строка G-кода, которая должна быть выполнена. 481 - 482 -=== bool UseOmichSensor () === 483 - 484 -Позволяет проверить, включено ли в настройках использование омического датчика PLL-R2. 485 - 486 -Возвращаемое значение: 487 - 488 -* true – если использование омического датчика PLL-R2 включено. 489 - 490 -=== number GetOmichSensorDelta () === 491 - 492 -Получение заданного в настройках омического датчика значения поправки dZ. 493 - 494 -Возвращаемое значение: 495 - 496 -* значение поправки dZ, заданное в настройках омического датчика. 497 - 498 -=== void SetOmichSensorDelta (number value) === 499 - 500 -Установка значения поправки dZ для омического датчика. 501 - 502 -Параметры: 503 - 504 -* number value – значение поправки dZ для омического датчика. 505 - 506 -=== number1, ... , numberN, bool ReadModbusMultipleRegistersUpdated (string name, number count) === 507 - 508 -Получение значений нескольких расположенных подряд Modbus-регистров без использования кеша. 509 - 510 -Параметры: 511 - 512 -* string name – имя регистра, настроенного в меню Настройка Modbus. 513 -* number count – количество запрашиваемых регистров. 514 - 515 -Возвращаемые значения: 516 - 517 -* value1, ... , valueN – значения Modbus-регистров. 518 -* is_online – логическое значение, определяющее, была ли попытка прочитать значения Modbus-регистров успешной. 519 - 520 -=== bool WriteModbusMultipleRegisters (string name, number count, number value1, ... , number valueN) === 521 - 522 -Установка значений нескольких расположенных подряд Modbus-регистров. 523 - 524 -Параметры: 525 - 526 -* string name – имя регистра, настроенного в меню Настройка Modbus. 527 -* number count – количество записываемых регистров. 528 -* number value1, ... , number valueN – значения регистров, которые необходимо установить (16-битные целые числа). 529 - 530 -Возвращаемое значение: 531 - 532 -* true - если установка значений Modbus-регистров выполнена успешно. 533 - 534 -=== void WeldOscillatorEnable () === 535 - 536 -Включение колебателя. 537 - 538 -=== void WeldOscillatorDisable () === 539 - 540 -Выключение колебателя.