OS

OS

os.version()

Получить весрию ОС.

Аргументы: нет

Возвращает: название операционной системы, номер версии, время сборки системы (выраженное во времени EPOCH) и хеш коммита, использованного при сборке.

-- Get operating system name and version
oss, version, build, commit = os.version();

-- Print to screen
print("OS: "..oss..", version: "..version..", build: "..build..", commit: "..commit)
OS: Lua RTOS, version: beta 0.1, build: 1495574689, commit: 4d92804451cbec7d3ad545c66a92ffab35c63871

os.flashEUI()

Получить идентификатор встроенного SPI FLASH.

Аргументы: нет

Возвращает: идентификатор или ничего.

/ > os.flashEUI()
cb6254185b430e2e

os.uptime(param)

0 - str, 1 - table, 2 - unix ts

Отображение времени непрерывной работы в консоли или возвращение информации о времени непрерывной работы.

Аргументы:

param:

  • 0 - информация о времени работы возвращается в виде строки
  • 1 - информация о времени работы возвращается в виде таблицы
  • 2 - информация о времени работы возвращается в виде UNIX-таймштампа

Если param=1 возвращает таблицу со следующими полями:

  • current: строка с текущим временем в формате %H:%M
  • days: дни времени работы
  • hours: часы времени работы
  • mins: минуты времени работы
  • secs: секунды времени работы
/ > os.uptime()
23:26 up  0:19:05
up = os.uptime(true)
print("days: "..up.days..", hours: "..up.hours..", mins: "..up.mins..", secs: "..up.secs)

os.time([os.settime{year=1970, month=1, day=1, hour=0, min=0, sec=0}])

Функция time, вызванная без аргументов, возвращает текущую дату и время, закодированные в виде числа. Функция time, вызванная с аргументами, возвращает дату и время, закодированные в виде числа, которые были заданы в параметрах. Смотрите для получения дополнительной информации.

/ > os.time()
1552405265

timezone = os.tz([timezone])

Функция установки часового пояса.

Аргументы:

  • tz(опционально): число; часовой пояс.

Возвращет:

  • timezone: число; часовой пояс, если запущена без параметров.

os.date([format, [timestamp]])

Функция date, несмотря на своё название, является своего рода обратной функции time: она преобразует число, представляющее дату и время, обратно в некоторое представление более высокого уровня. Её первый параметр - это строка формата, описывающая желаемое представление. Второй параметр - это числовое представление даты и времени; по умолчанию используется текущая дата и время. Смотрите для получения дополнительной информации.

/ > table = os.date("*t", 906000490)
/ > os.date("today is %A, in %B")
today is Tuesday, in March
/ > os.date()
Tue Mar 12 15:35:36 2019

os.settime(hours, minutes, seconds, month, day, year)

или

os.settime{os.settime{year=1970, month=1, day=1, hour=0, min=0, sec=0}}

Функция settime устанавливает системные часы на дату и время, заданные в параметрах. Поскольку Lua-RTOS не использует концепцию часовых поясов, обычно это должно быть время по Гринвичу (GMT).

/ > os.settime{year=1970, month=1, day=1, hour=0, min=0, sec=0}
0
/ > os.settime{year=1970, month=1, day=1, hour=0, min=1, sec=0}
60

os.factoryreset()

Выполняет сброс до заводских настроек установленного программного обеспечения. Актуально для сборок с разделом “factory”. Сброс до заводских настроек выполняет следующие действия: Стирает раздел данных OTA для прошивок с поддержкой OTA, так что при следующей перезагрузке будет запущен “заводская” прошивка.

Аргументы: нет.

Возвращает: ничего.

os.factoryreset()

os.history([enable])

Включение или выключение запиши истории команд, введенных пользователем в консоли. Доступ к истории осуществляется с помощью клавиш вверх & вниз. Функция актуальна только, если смонтирован внешний раздел для сохранения истории: SD или RAMFS, например fs.mount("/rfs",“ramfs”)

Аргументы:

  • enable (необязательно): true для включения / false для отключения. Если этот аргумент не предоставлен, функция возвращает текущую настройку.

Возвращает: ничего или текущую настройку (true/false), если аргумент enable не предоставлен."

-- Enable history
os.histrory(true)

os.logcons([enable])

Включение или отключение логирования. Если оно включено, сообщения журнала отображаются в консоли и записываются в файл /log/messages.log, если подключена SD-карта. Если оно отключено, сообщения журнала записываются в файл /log/messages.log, если подключена SD-карта.

Аргументы:

  • enable (необязательно): true для включения / false для отключения. Если этот аргумент не предоставлен, функция возвращает текущую настройку logcons.

Возвращает: ничего или текущую настройку logcons (true/false), если аргумент enable не предоставлен."

-- Disable logs on the console
os.logcons(false)

os.loglevel([level])

Устанавливает уровень логирования. Уровень логирования контролирует объем информации журнала, который Lua RTOS отображает на консоли и записывает в файл /log/messages.log (если подключена SD-карта).

Аргументы:

  • level (необязательно): уровень логирования, может быть os.LOG_ALL, os.LOG_INFO, os.LOG_EMERG, os.LOG_ALERT, os.LOG_CRIT, os.LOG_ERR, os.LOG_WARNING, os.LOG_NOTICE, os.LOG_DEBUG. Если этот аргумент не предоставлен, функция возвращает текущую настройку loglevel.

Возвращает: ничего или текущую настройку loglevel, если аргумент enable не предоставлен.

-- Show only error logs
os.loglevel(os.LOG_ERR)

os.syslog(message[, level])

Записывает сообщение в системный журнал (syslog).

Аргументы:

message: сообщение для записи в системный журнал

  • level (необязательно): уровень логирования, может быть os.LOG_ALL, os.LOG_INFO, os.LOG_EMERG, os.LOG_ALERT, os.LOG_CRIT, os.LOG_ERR, os.LOG_WARNING, os.LOG_NOTICE, os.LOG_DEBUG. Если этот аргумент не предоставлен, функция возвращает текущую настройку loglevel.

Возвращает: ничего.

-- Log an informative message
os.syslog("foo", os.LOG_INFO)

os.rsyslog([server])

Включает или отключает логирование на удаленный сервер rsyslog.

Аргументы:

  • server (необязательно): имя или IP-адрес удаленного сервера syslog. Пустая строка или 0.0.0.0 для отключения.

Возвращает: текущий установленный сервер rsyslog.

-- Retrieve the currently set rsyslog server
/ > os.rsyslog()
0.0.0.0
-- Set a new rsyslog server
/ > os.rsyslog("10.0.0.1")
10.0.0.1
-- Retrieve the currently set rsyslog server
/ > os.rsyslog()
10.0.0.1
-- Disable logging to a remote syslog server
/ > os.rsyslog("0.0.0.0")
0.0.0.0

os.shell([enable])

Включить или отключить оболочку Lua RTOS.

/ > ls
f	     370		abp.lua
d	       -		examples
d	       -		sys
f	     468		system.lua
f	     388		wifi.lua
f	      40		autorun.lua
/ > cd examples
/examples > ls
d	       -		blocks
d	       -		lua
d	       -		a
f	       0		system.lua
/examples >

Аргументы:

  • enable (необязательно): true для включения / false для отключения. Если этот аргумент не предоставлен, функция возвращает текущую настройку оболочки.

Возвращает: ничего или текущую настройку оболочки (true/false), если аргумент enable не предоставлен.