Как изменить луа файл

• Для быстрого поиска существующего файла в консоли введите первые символы и жмите TAB, например edit i [TAB] —> edit /init.lua
• Для удаления всей строки нажмите CTRL+DELETE

• Notepad++
  Стандарт скриптовика. Прост и легок в обращении. Плюсы — малый размер, куча плагинов и расширений. Лучшее средство для начинающего программиста Lua.
• Sublime Text
  Более продвинутый инструмент. Плюсы — расширенный интерфейс, выбор из разнообразных тем, поддержка плагинов, включая подсветку ошибок при написании кода.
  Сам пользуюсь этим редактором на компе, расширив плагинами Corona Editor, Lua Love, Sublime Linter — lua
• SciTE, Atom
  Для хипстеров. По функционалу такие же как выше.

• Пишете код в редакторе
• Вставляете его на Pastebin
• Вписываете код для запуска в игре (заменив XXXXXX на код пасты):
• pastebin get XXXXXX name

— Через облачное хранилище с прямыми ссылками:

• Сохраняйте и работайте с файлами прямо в папке облачного хранилища, с возможностью доступа по прямым ссылкам.
  Например, в дропбоксе это папка Public (в новых аккаунтах ее нет)
• Загружайте обновленные файлы на ОС компьютер через интернет-плату программой wget, получив прямую ссылку на файл, например:

  wget -f https://dl.dropboxusercontent.com/u/12345678/file.lua

• Для удобства вы можете написать короткую программу, которая при нажатии клавиши, например F5, будет выполнять такую загрузку автоматически

• ZeroBrane Studio 
  Суперлегкая (у меня занимает 17мб оперативки) и быстрая кроссплатформенная IDE. Визуальные темы, мониторинг переменных, выделение локальных и глобальных переменных, проверка на неиспользуемые переменные и прочие ништяки.
• Lua Development Tools
  Преимуществ от ZeroBrane практически нет, скорее минусы в роде отсутствие темной темы и требовательности к оперативке.
• Cloud 9
  Облачное браузерное IDE.
  По стандарту отсутствует отладка. Ее нужно устанавливать в проект самостоятельно.
  Плюс — вам не нужно ничего устанавливать на компьютер. Но самое приятное, что к каждому файлу в этой IDE можно обратиться по постоянной прямой ссылке, что крайне упрощает заливку файла в игру. Так же, вы можете раздавать ссылку на проект другим и совместно редактировать код.

Сам я использую Sublime для быстрого редактирования файлов, LDT для больших проектов на стадии написания кода, Cloud9 для совместных проектов с другими программистами, и для отладки текущих проектов в игре.
О ZeroBrane Studio узнал совсем недавно, поэтому планирую перейти на нее в ближайшее время, что и другим советую.

A Lua editor is used to edit Lua code for AddOn development in World of Warcraft.

While any text editor can edit Lua files, many contain additional Lua specific features. See also UI FAQ/AddOn Author Resources.

Free

WoWUIDesigner

Complete IDE for Lua and XML UI files, including intellisense for many WoW API functions — Windows XP/2000/2003/Vista

Eclipse

• Eclipse + the Lua Development Tools plug-ins. For Windows, Mac OS X and other platforms. LDT includes syntax coloring, error markers, code snippets, code navigation, … and a debugger.
• Eclipse + the Lua Eclipse plug-in. For Windows, Mac OS X and other platforms.

IntelliJ IDEA

• IntelliJ + the Lua plugin — For Windows, Mac OS X and other platforms. A complete IDE with support for completions, API documentation, code formatting and more. See this page for more info.

LuaEdit (Open Source)

Complete professional looking Lua IDE — Windows 98/2000/XP

ZeroBrane Studio (Windows/Mac OSX/Linux)

A lightweight Lua IDE with code completion, syntax highlighting, remote debugger, code analyzer, and live coding.

PSPad

Syntax highlighting for Lua and XML files, fully features programmer’s editor.

Komodo Edit (Open Source)

A very nice editor built on top of Mozilla and Scintilla; with the extensibility of Firefox, and the syntax highlighting engine from SciTE.

LuaIDE

Integrated development environment for Lua for Windows

SciTE (Open Source)

A very extensible open source editor. There are three pre-packaged versions for WoW development with Lua and XML syntax highlighting and much more:

• SciTE-WoWUI at wowinterface.com
• WoW SciTe at wowguru.com
• SciTe-Ru at code.google.com — Version with WoW API 3.0 syntax highlighting and calltips.

Notepad++ (Open Source)

A free source code editor, which supports several programming languages, including Lua and XML.

Proton

A nice German freeware editor, unfortunately without UTF-8 support. XML syntax highlighting is supported out of the box, a plugin for Lua is available [1].

Emacs (Open Source)

An extensible, customizable text editor—and more. Complete built-in documentation, including a tutorial for new users. Use lua-mode to get syntax highlighting for .lua files.

gVIM (Open Source)

An extremely powerful, multi-platform editor. Supports syntax highlighting for Lua, XML, and hundreds of other file types, as well as automatic indentation/comment formatting, the ability to jump between matching tags (if then else, <open></close>, etc.), and much more.

TextWrangler

Free general purpose text/code editor with Lua and XML syntax highlighting.

Eddie

Free programmer’s editor Mac OS X. Includes Lua syntax coloring and function popup plus many other features.

Crimson Editor

A Free professional Windows code editor, comes with Lua and XML syntax highlighting, along with many other file types.

• WoWLua CE — A Crimson Editor Specification for color coding World of Warcraft API, Widget, and Event keywords.

B:Lua (Open Source)

Under development and will, in time, hopefully provide a useful IDE for WoW Lua script development.

Programmer’s Notepad

Light weight notepad that adds syntax coloring. Supports many languages (current beta has Lua support)

AddOn Studio for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation.

AddOn Studio 2010 for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation based on Visual Studio 2010, functional and up to date.

AddOn Studio 2015 for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation based on Visual Studio 2015, functional and up to date.

AddOn Studio 2017 for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation based on Visual Studio 2017, functional and up to date.

AddOn Studio 2019 for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation based on Visual Studio 2019, functional and up to date.

luaTopping (Open Source)

(Under Development) luaTopping is a NetBeans plugin that adds WoW Addon «Project» support to the NetBeans IDE. Features include common addon file templates and deploy action to WoW folder. Accompaning luaSupport module provides lua language support (syntax highlighting and grammar verification). Desired features include code completition, WoW API hints/help, among others.

Visual Studio

Using Microsoft Visual Studio for WoW AddOn-Development.

Trial

DForD LuaCoding

A full graphical Lua IDE. It supports syntax highlighting, symbol browsing/searching, auto-completion, code snippet, debugging, building and more. If you know MSVC, you’ll be comfortable immediately (F5 to start debugging, F9 for breakpoints, etc). It’s supported by a fully Lua script written plugin framework.

QDE

Quotix Development Environment for Lua. It supports project management, autocomplete functionality, a multi-document interface, debugging and much more. Sadly doesn’t include a debug mode to test scripts with.

Zeus for Windows

IDE with Lua syntax highlighting, code folding, project management, integrated version control. The IDE is fully scriptable using Lua

TextPad

Not an official Lua IDE however, with an available syntax file available as an addon provides great syntax highlighting.

Edit+

Not an official Lua IDE however, with an available syntax file available as an addon provides great syntax highlighting. You can freely download and try it for 30 days. If you find it useful and decide to keep it over 30-day evaluation period, you should pay the registration fee. Nag window remains on startup if not registered.

EmEditor

Excellent text editor which won «Best Application» in the 2008 Shareware Industry Awards. Some notable new features are auto-completion ( all file types ) and Ctags support. The list of syntax files available shows Lua 5.1 is available. Supported OSs are Windows Vista/XP/2000/Server 2008/Server 2003/Windows 7 ( 32-bit & 64-bit ).

EditPad Pro

Great notepad replacement/enhancement with just about the best support of any editor for Regexes. Lua syntax hilight and code navigation with a Lua add-on located on this page. Free 30-day evaluation copy of EditPad Pro or download EditPad Lite, free for non-commercial use. EditPad Lite and Pro are available for Windows and Linux.

UltraEdit

Comprehensive programmer’s text editor with coloration, code folding, autoindentation, code projects, etc. You can freely download and try it for 30 days. Syntax definitions for WoW Lua and XML are maintained here: UltraEdit WoW wordfile.txt or a new complete lua.txt including WoW, WotLK, Ace2 & Ace3 API functions and XML is available at http://wowluatxt.googlecode.com

SubEthaEdit

Collaborative text editor with Lua syntax highlighting. For Mac OS X.

Sublime Text

Beautiful Windows text editor with inbuilt Lua syntax highlighting.

ScriptDev

ScriptDev is a powerful script language IDE, it can support some very popular script language, for example, Tcl, Python, Ruby, Lua, Perl and so on.

Commercial

BBEdit 8.7

Now supports, and has syntax-directed text coloring, for Lua.

Decoda

Lua IDE and graphical debugger with syntax highlighting, source code control (SCC) support, etc. Non-commercial licensing also available.

Adobe Dreamweaver CS3

Will open and edit LUA files in code view.

E-TextEditor

Windows editor with support for TextMate bundles and themes. With the Lua Bundle for syntax highlighting. More information on installing TextMate bundles in E-TextEditor.

Lua Glider IDE (Windows/Mac OSX)

A commercial IDE featuring one click debugging, profiling, class aware code completion, declaration/occurrences finder, semantic highlighting and more.

iLuaBox

iLuaBox is an app for iOS devices (iPhone, iPod, and iPad) that provides an intuitive environment to learn, write, and run scripts written in the Lua Programming Language. This is not a stripped down version of Lua, but rather a full-featured implementation that is optimized for iOS 4.2. iLuaBox is a universal application that runs on any iOS 4.2 compatible device.

Smultron

Editor for the Mac. $4.99 on Mac App Store. Three versions available: Smultron (for 10.6 «Snow Leopard»), Smultron 4 (for 10.7 «Lion»), and Smultron 5 (for 10.8 «Mountain Lion»). Has LUA syntax coloring.

Sublime Text Editor (Windows/Mac OSX/Linux)

A programmable text editor that offers syntax highlighting for multiple languages. It features several time saving shortcuts and is highly customizable.

TextMate

Mac OS X editor. With the Lua Bundle for syntax highlighting. More information on installing TextMate bundles.

External links

• Lua Addons Great resource for more Lua IDEs and other Lua tools

A Lua editor is used to edit Lua code for AddOn development in World of Warcraft.

While any text editor can edit Lua files, many contain additional Lua specific features. See also UI FAQ/AddOn Author Resources.

Free

WoWUIDesigner

Complete IDE for Lua and XML UI files, including intellisense for many WoW API functions — Windows XP/2000/2003/Vista

Eclipse

• Eclipse + the Lua Development Tools plug-ins. For Windows, Mac OS X and other platforms. LDT includes syntax coloring, error markers, code snippets, code navigation, … and a debugger.
• Eclipse + the Lua Eclipse plug-in. For Windows, Mac OS X and other platforms.

IntelliJ IDEA

• IntelliJ + the Lua plugin — For Windows, Mac OS X and other platforms. A complete IDE with support for completions, API documentation, code formatting and more. See this page for more info.

LuaEdit (Open Source)

Complete professional looking Lua IDE — Windows 98/2000/XP

ZeroBrane Studio (Windows/Mac OSX/Linux)

A lightweight Lua IDE with code completion, syntax highlighting, remote debugger, code analyzer, and live coding.

PSPad

Syntax highlighting for Lua and XML files, fully features programmer’s editor.

Komodo Edit (Open Source)

A very nice editor built on top of Mozilla and Scintilla; with the extensibility of Firefox, and the syntax highlighting engine from SciTE.

LuaIDE

Integrated development environment for Lua for Windows

SciTE (Open Source)

A very extensible open source editor. There are three pre-packaged versions for WoW development with Lua and XML syntax highlighting and much more:

• SciTE-WoWUI at wowinterface.com
• WoW SciTe at wowguru.com
• SciTe-Ru at code.google.com — Version with WoW API 3.0 syntax highlighting and calltips.

Notepad++ (Open Source)

A free source code editor, which supports several programming languages, including Lua and XML.

Proton

A nice German freeware editor, unfortunately without UTF-8 support. XML syntax highlighting is supported out of the box, a plugin for Lua is available [1].

Emacs (Open Source)

An extensible, customizable text editor—and more. Complete built-in documentation, including a tutorial for new users. Use lua-mode to get syntax highlighting for .lua files.

gVIM (Open Source)

An extremely powerful, multi-platform editor. Supports syntax highlighting for Lua, XML, and hundreds of other file types, as well as automatic indentation/comment formatting, the ability to jump between matching tags (if then else, <open></close>, etc.), and much more.

TextWrangler

Free general purpose text/code editor with Lua and XML syntax highlighting.

Eddie

Free programmer’s editor Mac OS X. Includes Lua syntax coloring and function popup plus many other features.

Crimson Editor

A Free professional Windows code editor, comes with Lua and XML syntax highlighting, along with many other file types.

• WoWLua CE — A Crimson Editor Specification for color coding World of Warcraft API, Widget, and Event keywords.

B:Lua (Open Source)

Under development and will, in time, hopefully provide a useful IDE for WoW Lua script development.

Programmer’s Notepad

Light weight notepad that adds syntax coloring. Supports many languages (current beta has Lua support)

AddOn Studio for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation.

AddOn Studio 2010 for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation based on Visual Studio 2010, functional and up to date.

AddOn Studio 2015 for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation based on Visual Studio 2015, functional and up to date.

AddOn Studio 2017 for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation based on Visual Studio 2017, functional and up to date.

AddOn Studio 2019 for World of Warcraft

A free version of Visual Studio tailored for WoW mod creation based on Visual Studio 2019, functional and up to date.

luaTopping (Open Source)

(Under Development) luaTopping is a NetBeans plugin that adds WoW Addon «Project» support to the NetBeans IDE. Features include common addon file templates and deploy action to WoW folder. Accompaning luaSupport module provides lua language support (syntax highlighting and grammar verification). Desired features include code completition, WoW API hints/help, among others.

Visual Studio

Using Microsoft Visual Studio for WoW AddOn-Development.

Trial

DForD LuaCoding

A full graphical Lua IDE. It supports syntax highlighting, symbol browsing/searching, auto-completion, code snippet, debugging, building and more. If you know MSVC, you’ll be comfortable immediately (F5 to start debugging, F9 for breakpoints, etc). It’s supported by a fully Lua script written plugin framework.

QDE

Quotix Development Environment for Lua. It supports project management, autocomplete functionality, a multi-document interface, debugging and much more. Sadly doesn’t include a debug mode to test scripts with.

Zeus for Windows

IDE with Lua syntax highlighting, code folding, project management, integrated version control. The IDE is fully scriptable using Lua

TextPad

Not an official Lua IDE however, with an available syntax file available as an addon provides great syntax highlighting.

Edit+

Not an official Lua IDE however, with an available syntax file available as an addon provides great syntax highlighting. You can freely download and try it for 30 days. If you find it useful and decide to keep it over 30-day evaluation period, you should pay the registration fee. Nag window remains on startup if not registered.

EmEditor

Excellent text editor which won «Best Application» in the 2008 Shareware Industry Awards. Some notable new features are auto-completion ( all file types ) and Ctags support. The list of syntax files available shows Lua 5.1 is available. Supported OSs are Windows Vista/XP/2000/Server 2008/Server 2003/Windows 7 ( 32-bit & 64-bit ).

EditPad Pro

Great notepad replacement/enhancement with just about the best support of any editor for Regexes. Lua syntax hilight and code navigation with a Lua add-on located on this page. Free 30-day evaluation copy of EditPad Pro or download EditPad Lite, free for non-commercial use. EditPad Lite and Pro are available for Windows and Linux.

UltraEdit

Comprehensive programmer’s text editor with coloration, code folding, autoindentation, code projects, etc. You can freely download and try it for 30 days. Syntax definitions for WoW Lua and XML are maintained here: UltraEdit WoW wordfile.txt or a new complete lua.txt including WoW, WotLK, Ace2 & Ace3 API functions and XML is available at http://wowluatxt.googlecode.com

SubEthaEdit

Collaborative text editor with Lua syntax highlighting. For Mac OS X.

Sublime Text

Beautiful Windows text editor with inbuilt Lua syntax highlighting.

ScriptDev

ScriptDev is a powerful script language IDE, it can support some very popular script language, for example, Tcl, Python, Ruby, Lua, Perl and so on.

Commercial

BBEdit 8.7

Now supports, and has syntax-directed text coloring, for Lua.

Decoda

Lua IDE and graphical debugger with syntax highlighting, source code control (SCC) support, etc. Non-commercial licensing also available.

Adobe Dreamweaver CS3

Will open and edit LUA files in code view.

E-TextEditor

Windows editor with support for TextMate bundles and themes. With the Lua Bundle for syntax highlighting. More information on installing TextMate bundles in E-TextEditor.

Lua Glider IDE (Windows/Mac OSX)

A commercial IDE featuring one click debugging, profiling, class aware code completion, declaration/occurrences finder, semantic highlighting and more.

iLuaBox

iLuaBox is an app for iOS devices (iPhone, iPod, and iPad) that provides an intuitive environment to learn, write, and run scripts written in the Lua Programming Language. This is not a stripped down version of Lua, but rather a full-featured implementation that is optimized for iOS 4.2. iLuaBox is a universal application that runs on any iOS 4.2 compatible device.

Smultron

Editor for the Mac. $4.99 on Mac App Store. Three versions available: Smultron (for 10.6 «Snow Leopard»), Smultron 4 (for 10.7 «Lion»), and Smultron 5 (for 10.8 «Mountain Lion»). Has LUA syntax coloring.

Sublime Text Editor (Windows/Mac OSX/Linux)

A programmable text editor that offers syntax highlighting for multiple languages. It features several time saving shortcuts and is highly customizable.

TextMate

Mac OS X editor. With the Lua Bundle for syntax highlighting. More information on installing TextMate bundles.

External links

• Lua Addons Great resource for more Lua IDEs and other Lua tools

Одной из отличительных особенностей всех продуктов комплекса НЕЙРОСС и, в частности, IP-контроллеров БОРЕЙ, ЯРС v.1 (снят с производства!) и других является возможность модификации и расширения алгоритмов работы продукта посредством скриптов автоматизации. С помощью скрипта возможно, например, изменить или полностью заменить алгоритм доступа в контроллере БОРЕЙ. Или реализовать логику сопряжения со внешней информационной системой по протоколу HTTP. Или управлять исполнительными устройствами по заданному алгоритму.

В данном документе приведены общие сведения о скриптах автоматизации, их возможностях и руководство программиста по написанию таких скриптов.

Оглавление

Общие сведения

Скрипт автоматизации — текстовый сценарий, выполнение которого осуществляется программными средствами продукта.

Данный сценарий всегда один. Он может быть пустым — в таком случае скрипт не делает ничего. В скрипте могут быть команды управления — они выполняются по мере выполнения скрипта.

Скрипт автоматизации должен быть написан на языке Lua (версия 5.1). Разработчику доступны стандартные средства языка (операторы, структуры данных и др.), часть функций стандартной библиотеки (см. далее), а также наборы констант и функций, определённых в прикладных Lua-модулях продукта. Прикладные Lua-модули специально разработаны для упрощения написания скриптов и двустороннего взаимодействия с программными средствами продукта — чтобы можно было из скрипта вызывать какие-либо функции продукта или, наоборот, передавать управление в скрипт в процессе функционирования продукта.

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

Как редактировать скрипт

Для удобство редактирования и отладки скрипта автоматизации предназначен текстовый online-редактор, доступный в наших продуктах по адресу http://[ip-address]/lua-editor/ или http://[ip-address]/internal/lua-editor/.

1. В левом блоке — текст скрипта автоматизации. Внесите в него изменения, для сохранения нажмите на кнопку «Сохранить» внизу.
2. В правом блоке можно просматривать lua-код модулей и сниппеты — примеры скриптов автоматизации. Для просмотра сниппета или модуля выберите его в раскрывающемся списке под правым блоком.
   1. Lua-код модулей обычно содержит определение констант, структур, функций, а также обеспечивает удобную для разработчика «обёртку» на доступными функциями основных программных средств.
      ЗАМЕЧАНИЕ: в списке обычно можно посмотреть Lua-код всех модулей всех продуктов, их можно подключить к скрипту автоматизации, но фактически «отсутствующий» модуль просто не будет работать.
   2. Сниппеты — блоки кода, из которых можно почерпнуть идеи при разработке скрипта. Или можно скопировать «куски» сниппета в свой скрипт. Библиотека сниппетов постоянно пополняется разработчиками с добавлением примеров создания скриптов автоматизации.
3. При сохранении скрипта автоматизации выполнение текущего скрипта будет автоматически прервано. После чего будет запущен новый скрипт.

Скриншот редактора скриптов приведён на изображении ниже.

Как отлаживать скрипт

Сообщения об ошибках в Lua-скрипте, а также отладочные сообщения, выводимые из скрипта с помощью модуля log.lua, записываются в журнал аудита. Просмотр этих сообщений в реальном времени возможен при помощи веб-приложения «Журнал аудита», доступного с веб-страницы Рабочий стол.

1. Авторизуйтесь в веб-интерфейсе и перейдите на Рабочий стол.
2. Перейдите в веб-приложение «Журнал аудита».
3. На второй вкладке «Фильтры» выберите в списке логгер web.
4. В настройках фильтрации укажите следующие строки (первая строка:
   1. * — OFF
   2. LuaManager — DEBUG
   3. lua_scall — DEBUG
   4. neyross::LogLuaModule — DEBUG
5. Пример корректно настроенного логгера:
   
6. Перейдите на третью вкладку «Живой журнал».
7. Установите флаги DEBUG, INFO, WARN, ERROR для вывода сообщений всех возможностей уровней тревожности.
   
8. При выполнении Lua-скрипта на странице будут появляться соответствующие сообщения. Более свежие сообщения выводятся сверху.
   

Руководство разработчика

Общие сведения о Lua

Скрипт автоматизации должен быть написан на языке Lua версии 5.1.

Официальный сайт языка Lua (на английском языке) — http://www.lua.org/

Официальная документация по языку Lua версии 5.1 — http://www.lua.org/manual/5.1/ (английский язык)

Перевод документации по языку Lua версии 5.1 на русский язык: http://www.lua.ru/doc/

Также можно ознакомиться с документацией на русском языке для последней актуальной версии Lua (5.3 на момент написания статьи) по ссылке http://lua.org.ru/contents_ru.html. Большая часть содержимого также актуальна и для версии 5.1, поддерживаемой продуктами НЕЙРОСС.

Ограничения стандартной библиотеки

В скриптах автоматизации доступны следующие разделы стандартной библиотеки:

• Basic Functions
• Coroutine Manipulation
• Modules
• String Manipulation
• Table Manipulation
• Mathematical Functions

Следующие разделы недоступны (не могут быть использованы) в скрипте автоматизации:

• Input and Output Facilities
• Operating System Facilities

Прикладные Lua-модули

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

Подключение прикладного Lua-модуля осуществляется функцией require. Рекомендуемая форма использования:

local log = require("log")

Вызвать функцию Lua-модуля в таком случае можно следующим образом, например:

local logger = log.get_logger("MyLogger")

alarm.lua

Описание временно недоступно.

common.lua

Данный модуль предоставляет общесистемные функции. Перечень функций приведён в таблице ниже.

deviceio.lua

Описание временно недоступно.

fec.lua

Данный модуль позволяет управлять выходами (на плате контроллера БОРЕЙ, ЯРС, а также на модулях расширения АМ-06) и световой / звуковой индикацией подключенных к контроллеру считывателей.

В перечислении fec.TYPE описаны различные типы периферии. Для управления пригодны типы fec.TYPE.RELE (выход на плате контроллера) и fec.TYPE.SART_RELE (выход на модуле расширения). Для управления выходами следует использовать функцию set_value(тип периферии, ID элемента, состояние), где в первый параметр необходимо передать одно из значений перечисления fec.TYPE, во второй параметр — идентификатор (адрес) элемента для управления, в третий параметр — требуемое состояние (для выходов это 0 = Выключено, 1 = Включено). Например:

local fec = require("fec")
fec.set_value(fec.TYPE.RELE, 1, 1)

В этом примере выполняется включение первого реле на плате контроллера.

Нумерация выходов начинается с 1. Адрес выхода на модуле расширения определяется его адресом на шине.

К контроллеру БОРЕЙ (и ЯРС) можно подключить два считывателя, на плате есть выходы для управления красным, зелёным светодиодами и звуковой индикацией. Управлять светодиодами и бипером можно также с помощью функции set_value. Возможные режимы индикации светодиода определены в перечислении fec.DIOD. Доступно некоторое количество предустановленных режимов различной частоты и скважности. Звуковую индикацию можно только либо включить, либо выключить (см. перичесление fec.BEEPER).

Поскольку управление светодиодной / звуковой индикацией на считывателях осуществляется в рамках алгоритмов доступа и состояние красного, зелёного светодиодов и звука взаимосвязано (если красный светодиод горит, то зелёный погашен и др.) — для удобства управления всей индикацией реализована функция-обёртка fec.set_reader(ID считывателя, зелёный светодиод, красный светодиод, звук). Пример использования функции приведён ниже:

local fec = require("fec")
fec.set_reader(1, fec.DIOD.MODE_OFF, fec.DIOD.MODE_025_025, fec.BEEPER.MODE_OFF)

http.lua

Модуль позволяет отправлять HTTP-запросы прямо из Lua-скрипта, а также асинхронно обрабатывать ответы на отправленные ранее запросы.

Для отправки запроса и обработки ответа необходимо:

1. Определить объект-обработчик ответа (Lua-таблицу) с методом on_http_response(данные ответа).
2. Создать объект-запрос посредством вызова функции-фабрики http.with(объект-обработчик). Функция возвращает создаёт и возвращает объект-запрос.
3. Вызывать на объекте-запросе метод transmit(параметры запроса). Запрос будет отправлен в соответствии с заданными параметрами запроса. По мере получения ответа (или если запрос не удастся) будет асинхронно вызван метод on_http_response у созданного на первом шаге объекта-обработчика.

Ниже приведён пример использования модуля HTTP для отправки GET-запроса на IP-адрес веб-сайта http://example.com.

local log = require("log")
local http = require("http")
local logger = log.get_logger("script.lua")

-- обработчик ответа на HTTP-запрос
local example_handler = {}

-- этот метод обработчика будет вызван при получении ответа на запрос
function example_handler:on_http_response(response_data)
  if response_data == nil then
    logger:error("connection has failed; no response received")
  else
    logger:debug("response received; status="..response_data.status..", type(body)="..type(response_data.body))
  end
end
 
-- параметры запроса
local http_request = {
  url = "http://93.184.216.34",  -- адрес http://example.com
  method = http.METHOD.GET,
  version = http.VERSION.HTTP10,
  timeout = 5000
}

-- отправка HTTP-запроса
logger:debug("querying http://example.com")
http.with(example_handler):transmit(http_request)

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

• method — используемый HTTP-метод, значение из перечисления http.METHOD; значение по умолчанию http.METHOD.GET;
• version — используемая версия протокола HTTP, значение из перечисления http.VERSION; значение по умолчанию http.VERSION.HTTP11;
• url — целевой адрес / URL запрашиваемого ресурса, обязательный параметр;
• timeout — таймаут ожидания ответа / сетевого соединения, в миллисекундах; по умолчанию 13000 (13 секунд);
• header — таблица HTTP-заголовков (см. далее);
• body — тело запроса (см. далее).

Заголовки HTTP-запроса

Можно указать произвольные заголовки HTTP-запроса в форме Lua-таблицы со строковыми парами типа «ключ = значение». При этом «ключ» будет выступать в роли имени HTTP-заголовка, а «значение» — в роли значения HTTP-заголовка.

Пример:

-- параметры запроса
local http_request = {
  url = "http://93.184.216.34",
  method = http.METHOD.GET,
  version = http.VERSION.HTTP10,
  timeout = 5000
}
 
http_request.header = {}
http_request.header["X-Extra-Header"] = "my extra header value"

Тело HTTP-запроса

Модуль позволяет отправлять в HTTP-запросах (PUT или POST) данные в форме текста или JSON.

Для передачи запроса с телом в форме текста достаточно присвоить параметру запроса body соответствующее строковое значение. Например:

local http_request = {
  url = "http://10.1.30.3:8080/myservice",
  method = http.METHOD.POST,
  body = "<a>hello XML</a>"
}
http_request.header = {}
http_request.header["Content-Type"] = "text/xml; charset=UTF-8"

Модуль также позволяет передавать запрос с телом в форме JSON-документа, который автоматически формируется из Lua-таблицы. Например:

local http_request = {
  url = "http://10.1.30.3:8080/myservice",
  method = http.METHOD.POST
}
http_request.body = {
  myParam = "A",
  wowThisIsSubTable = {}
}
http_request.body["ohNumberHere"] = 42
http_request.body.wowThisIsSubTable["robot"] = "kill all human"

При отправке запроса с такими параметрами HTTP-заголовок Content-Type будет автоматически установлен в application/json, а тело запроса будет содержать следующий JSON-документ:

{
  "myParam": "A",
  "ohNumberHere": 42,
  "wowThisIsSubTable": { "robot": "kill all human" }
}

Обработка ответа

При поступлении ответа или сбое при отправке запроса асинхронно вызывается метод on_http_response(response_data) на объекте-обработчике. Параметр метода — это Lua-таблица, содержащая следующие данные:

• status — код HTTP-ответа, число в соответствии со спецификацией [https://ru.wikipedia.org/wiki/Список_кодов_состояния_HTTP];
• header — HTTP-заголовки ответа в форме Lua-таблицы (аналогично HTTP-заголовкам запроса);
• body — тело ответа.

Если отправка запроса не удалась и ответ не был получен, то аргумент метода равен nil.

Тело ответа в зависимости от Content-Type может быть либо Lua-таблицей (если Content-Type ответа равен application/json — тело автоматически преобразуется в Lua-таблицу), либо текстом / строкой (в остальных случаях).

ignis.lua

Описание временно недоступно.

log.lua

Модуль позволяет выводить текстовые сообщения в журнал аудита.

Для вывода сообщений разработчику необходимо:

1. Подключить модуль log.lua в скрипт автоматизации командой require.
2. Создать объект-логгер с заданным именем, вызвав функцию log.get_logger(имя-логгера).
3. В требуемом месте скрипта вывести сообщение в журнал аудита с заданным уровнем «тревожности», вызвав один из методов trace, debug, info, warn или error у объекта-логгера.

Пример приведён ниже:

local log = require("log")
local logger = log.get_logger("MyLogger")
 
local answer = 42
logger:debug("The answer is "..tostring(answer))

Обратите внимание:

1. В журнал аудита сообщения выводятся от имени компонента программных средств neyross::LogLuaModule, а потому в настройки журнала аудита следует добавить соответствующий фильтр, например: neyross::LogLuaModule | DEBUG.
2. Имя объекта-логгера также выводится в журнале аудита перед заданным текстовым сообщением. В скрипте автоматизации можно создать и использовать любое количество объектов-логгеров с разными именами. Это позволяет различить сообщения в журнале аудита от разных логических разделов скрипта автоматизации.
3. В журнале аудита для каждой записи также выводится имя функции (если таковая есть), в которой вызван объект-логгер и номер соответствующей строки в скрипте, что ещё более упрощает понимание — к какой части скрипта относится соответствующее сообщение в журнале аудита.
4. Различные методы объекта-логгера выводят в журнал сообщения с разным уровнем «тревожности». Доступны следующие методы и уровни по приоритетам (от низкого / неважного до высокого / тревожного):
   1. trace (только для отладочного режима, в журнал не попадают никогда);
   2. debug (отладочные сообщения);
   3. info (информационные сообщения);
   4. warn (сообщения-предупреждения);
   5. error (сообщения об ошибках).
5. Методы объекта-логгера принимают на вход один строковой параметр. Для формирования строки из нескольких параметров используйте оператор конкатенации строк .. и функцию приведения нестроковых типов к строке tostring из стандартной библиотеки.

longate.lua

Описание временно недоступно.

loninput.lua

Модуль предоставляет API для мониторинга состояния входов (зон) на модулях расширения ЯРС.

loninput.lua позволяет «подписаться» на изменения состояния входов. Для управления «подписчиками» в модуле доступны следующие функции:

Каждый объект-подписчик должен быть представлен Lua-таблицей с функцией on_loninput_input_state_changed(device_address, input_index, raw_state, logical_state).

Данная функция будет вызвана:

1. при изменении состояния входа какого-либо модуля расширения,
2. сразу в процессе добавления подписчика через add_listener для всех входов всех модулей (что позволяет получить текущее состояние нужных входов в момент добавления подписчика).

В функцию on_loninput_input_state_changed передаются следующие параметры:

Логическое состояние входа может быть следующим:

• 0 (LOGICAL_INPUT_STATE.UNKNOWN) — значение не известно;
• 1 (LOGICAL_INPUT_STATE.OFF) — вход выключен, нормальное состояние (логический 0);
• 2 (LOGICAL_INPUT_STATE.ON) — вход включен, тревожное состояние (логическая 1).

lonpacs.lua

Модуль предоставляет API для интеграции с подсистемой доступа модулей расширения ЯРС, таких как МДС и М2. Модуль позволяет модифицировать стандартные алгоритмы доступа.

Получить список точек доступа с их идентификаторами можно через поле lonpacs.ap_instance, которое заполняется при инициализации модуля и виртуальной Lua-машины (до того, как будет выполняться пользовательский Lua-скрипт). Поле lonpacs.ap_instance содержит Lua-таблицу, в которой ключами являются токены точек доступа, а значениями — Lua-таблицы с системными параметрами точек доступа. Структура таблицы представлена в коде ниже:

lonpacs.ap = {
  "токен первой точки доступа" = {
    ...
  },
  "токен второй точки доступа" = {
    ...
  },
  ... -- и так далее
}

Каждая точка доступа в списке — это либо точка доступа модуля расширения МДС, либо одна из точек доступа М2.

Управление точкой доступа

Для управления точками доступа на модулях расширения доступна функция transmit_status(token, status), которая позволяет отправлять модулям команды управления. Функция принимает следующие параметры:

Для управления точкам доступа доступны следующие команды (значения параметра status):

Состояние точки доступа

Модуль lonpacs.lua позволяет «подписаться» на события изменения состояния точек доступа, мониторинга связи с точками доступа, изменения состояния прохода (фазы алгоритма прохода). Для управления «подписчиками» в модуле доступны следующие функции:

Каждый объект-подписчик должен быть представлен Lua-таблицей со следующими функциями:

Параметр ap_status может принимать одно из следующих значений:

ap_status определяет интегральное состояние составляющих точку доступа элементов (замок, дверной контакт). Для получения состояния этих элементов нужно использовать функцию lonpacs.parse_ap_status(ap_status). 

Функция parse_ap_status возвращает Lua-таблицу следующего вида:

{
  door_state = ..
  lock_state = ..
  mode = ..
  alarm = ..
}

где значение полей таблицы следующее:

Значение кода состояния алгоритма прохода (фазы прохода) status, полученного в функции lonpacs_on_pass_status_changed(token, status, notify_key), может принимать одно из следующих значений:

pacs.lua

Модуль предоставляет API для интеграции с подсистемой доступа (только для контроллеров БОРЕЙ и ЯРС). Модуль позволяет либо модифицировать стандартные алгоритмы доступа, либо реализовать собственный алгоритм.

Общие сведения

Подсистема доступа в контроллерах БОРЕЙ, ЯРС поддерживает две точки доступа (поддержка дополнительных точек доступа на модулях расширения ЯРС осуществляется в Lua-модуле lonpacs.lua). Соответственно, первый считыватель относится к первой точке доступа, а второй — ко второй. У каждой точки доступа есть строковой уникальный идентификатор, называемый токеном.

Получить список точек доступа с их идентификаторами можно через поле pacs.ap, которое заполняется при инициализации модуля и виртуальной Lua-машины (до того, как будет выполняться пользовательский Lua-скрипт). Поле pacs.ap содержит Lua-таблицу, в которой ключами являются токены точек доступа, а значениями — Lua-таблицы с системными параметрами точек доступа. Структура таблицы представлена в коде ниже:

pacs.ap = {
  "токен первой точки доступа" = {
    "#" = 0,
    ...
  },
  "токен второй точки доступа" = {
    "#" = 1,
    ...
  }
}

Соответственно, для перебора точек доступа (например, чтобы для каждой точки доступа проинциализировать свой алгоритм) удобно использовать следующий код:

for key,item in pairs(pacs.ap) do
  if item["#"] == 0 or item["#"] == 1 then
    -- код обработки точки доступа с токеном = key
  else
    logger:error("unexpected access point number; #="..item["#"].."; token="..key)
  end
end

В контроллере БОРЕЙ точек доступа всегда ровно две, с номерами 0 и 1. Точка доступа с номером 0 (у которой значение свойства pacs.ap["токен"]["#"] равно 0 — это первая точка доступа), точка доступа с номером 1 — вторая.

В настройках доступа у контроллера можно выбрать «Режим работы» — «Две односторонние», «Одна двусторонняя», «Пользовательский». В стандартных режимах работы «Две односторонние» и «Одна двусторонняя» программные средства самостоятельно реализуют алгоритм доступа, таблицы параметров (pacs.ap["токен"]) содержат параметры, которые пользователь может изменить через веб-приложение. В режиме «Пользовательский» таблицы параметров по умолчанию обычно пусты.

Управление состоянием точки доступа, а также режимом её работы (начало транзакции доступа, завершение транзакции и так далее) осуществляется из Lua-скрипта. Соответствующие функции описаны в разделе «Управление точкой доступа».

В каждый момент времени состояние точки доступа описывается N-мерным вектором:

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

Через каждую точку доступа в один момент времени может осуществляться одна транзакция доступа. Транзакция доступа — это процесс, который начинается с момента идентификации доступа, и завершается при возврате точки доступа в начальное состояние. В случае удержания двери транзакция доступа продолжается.

Транзакция доступа начинается либо вызовом pacs.authenticate в случае разрешения доступа, либо по вызову pacs_grant (для случая анонимного доступа). Завершается транзакция по вызову pacs_reset. Соответствующие функции описаны в разделе «Управление точкой доступа».

В процессе транзакции сохраняются идентификационные признаки посетителя и прочая информация, эти данные подставляются во все извещения, формируемые контроллером.

Часть извещений (в основном о запрещении доступа) формируются программными средствами. Пользователь также может в любой момент времени отправить извещение из Lua-скрипта с помощью функции pacs_notify, с указанием кода извещения. Для отправки доступно более полусотни извещений. Полный список доступных для отправки извещений приведён в документации на HTTP-API контроллера в части СКУД.

Изменение системных параметров

В режиме доступа «Пользовательский» для реализации алгоритма может потребоваться задать из Lua-скрипта для каждой точки доступа системные параметры. Для указания параметров из Lua-скрипта предназначена функция pacs.set_configuration(token, {...}), в первом аргументе необходимо передать токен точки доступа, во втором аргументе — Lua-таблицу с параметрами. Например:

for key,item in pairs(pacs.ap) do
  local configuration = {}
  configuration["input.mode"] = "card"
  pacs.set_configuration(key, configuration)
end

Ниже приведены основные системные параметры, которые можно / нужно настраивать:

Функции-обработчики

Модуль позволяет разработчику определить глобальные Lua-функции с заданными именами. Такие функции-обработчики будут вызваны программными средствами контроллера по мере выполнения функций доступа.

function pacs_reader_input(token, data)
  -- тело функции
end

local pacs_reader_input = function(token, data)
  -- функция не будет вызвана
end

Ниже приведён список доступных для определения функций-обработчиков:

{
  "facility_code" = "123",
  "card_number" = "12345",
  "pincode" = "12345"
}

{
  "use_extended_time" = true,
  "access_time_duration" = число (unix-timestamp),
  "open_too_long_time_duration" = число (unix-timestamp),
  "pre_alarm_time_duration" = число (unix-timestamp)
}

Изменение состояния периферии

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

local fec = require("fec")
 
-- Логическое состояние элемента
local VALUE = {
	OFF     = 0,
	ON      = 1,
	SHORT   = 2,
	BROKEN  = 3
}
 
-- Получение логического состояния для элемента типа «Сухой контакт»
function get_dry_contact_value(raw, invert)
    if raw == 1 then
        if invert then
            return VALUE.OFF
        else
            return VALUE.ON
        end
    else
        if invert then
            return VALUE.ON
        else
            return VALUE.OFF
        end
    end
end
 
-- Получение логического состояния для элемента типа «Резистивный шлейф»
function get_rin_value(raw,invert)
	if raw <= 17 then -- эмпирический порог резистивного шлейфа
		if invert then
			return VALUE.OFF
		else
			return VALUE.ON
		end
	else
		if invert then
			return VALUE.ON
		else
			return VALUE.OFF
		end
	end
end
 
-- Получение логического состояния входов разного типа
-- Дополнительный аргумент invert позволяет обрабатывать настройку вида «нормально-открыт»
function get_input_value(raw, invert, type_)
    if (type_ == fec.TYPE.DRY_CONTACT) then
        return get_dry_contact_value(raw, invert)
    elseif (type_ == fec.TYPE.RADIAL_INPUT) then
        return get_rin_value(raw, invert)
    else
        log_error("invalid type: "..type_)
        return 0
    end
end

Управление точкой доступа

Для управления точкой доступа / транзакцией доступа по выбранной точке доступа предназначены следующие функции:

{
  "facility_code" = "123",
  "card_number" = "12345",
  "pincode" = "12345",
  "transaction_uuid" = "..."
}

{
  "lock" = Unlocked,
  "door" = Open,
  "mode" = Accessed,
  "alarm" = Normal,
}

Поиск в базе данных

Описание временно недоступно.

storage.lua

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

В некоторых случаях может потребоваться сохранять состояние или параметры работы скрипта автоматизации при перезапуске продукта. Или, например, может возникнуть потребность, чтобы определённые параметры были сохранены в резервной копии и восстановлены в случае сбоя файловой системы на IP-контроллере (БОРЕЙ, ЯРС и пр.). Для работы с такими данными и предназначен модуль storage.lua.

Модуль позволяет сохранять в персистентное хранилище Lua-таблицы с данными под заданным именем, а впоследствии извлекать их из хранилища по имени. Таблица с данными может содержать только пары «ключ = значение», где «ключ» это всегда строка, а «значение» может быть строкового, числового или булевого типа.

Для помещения данных в хранилище предназначена функция storage.set(ключ, данные), для сохранения — storage.save(ключ), для извлечения — storage.get(ключ).

Пример использования модуля приведён ниже:

local storage = require("storage")
 
local my_options = storage.get("my_key")
my_options.param1 = "A"
my_options.param2 = 42
storage.save("my_key")
 
local another_options = {
  param1 = "B",
  param2 = 43
}
storage.set("my_key", another_options) -- my_options более не ссылается на объект в хранилище!
storage.save("my_key")

tenso.lua

Описание временно недоступно.

timer.lua

Данный модуль предоставляет для скрипта автоматизации две функции для выполнения отложенных во времени вычислений. Первая функция — это set_timeout. Она предназначена для разового выполнения некоторой Lua-функции спустя заданное количество времени. Вторая функция — set_interval. Она позволяет запланировать выполнение некоторой Lua-функции каждые N миллисекунд. Функция будет выполняться периодически до тех пор, пока задание на выполнение не будет явно отменено (см. clear_interval далее) или Lua-машина не будет перезапущена.

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

set_timeout

Запланировать вызов указанной Lua-функции спустя заданное количество миллисекунд.

Полная сигнатура функции: set_timeout(имя-функции, длительность, ключ), где

• имя функции — строка, имя Lua-функции для вызова;
• длительность — число, задержка выполнения функции, в миллисекундах;
• ключ — строка, ключ, по которому можно будет понять в Lua-функции, кто и когда запланировал её отложенный вызов.

При вызове set_timeout возвращает уникальный идентификатор созданного задания на отложенное выполнение. Это значение можно использовать в последующем вызове clear_timeout для отмены запланированного ранее задания.

Пример:

local log = require("log")
local logger = log.get_logger("script.lua")
 
local key1_id = set_timeout("my_timeout", 10000, "key1") -- выполнить my_timeout через 20 секунд с key1
local key2_id = set_timeout("my_timeout", 20000, "key2") -- выполнить my_timeout через 20 секунд с key2
 
function my_timeout(key)
  if key == "key1" then
    logger:debug("stopping timeout on key2")
    clear_timeout(key2_id) -- отменяем задание с key2
  elif key == "key2" then
    logger:error("this should be never invoked")
  else
    logger:error("unexpected key="..key)
  end
end

clear_timeout

Функция позволяет отменить ранее запланированное задание: clear_timeout(ID задания), где ID задания — результат выполнения функции set_timeout.

set_interval

Сигнатура налогична set_timeout: set_interval(имя-функции, длительность, ключ), где

• имя функции — строка, имя Lua-функции для вызова;
• интервал — число, период выполнения функции, в миллисекундах;
• ключ — строка, ключ, по которому можно будет понять в Lua-функции, кто и когда запланировал её отложенный вызов.

clear_interval

Аналогично clear_timeout функция позволяет отменить запланированное ранее периодическое задание: clear_interval(ID задания), где ID задания — результат выполнения функции set_interval.

terminal.lua

Описание временно недоступно.