Навык iRidium для Amazon Alexa​

голосовое управление оборудованием через Amazon Alexa и iRidium

документация обновлена 19.03.2026

Алекса - голосовой ассистент от Амазон, встроенный в умную колонку Amazon Echo и прочие устройства типа:

• Echo Plus,
• Echo Dot,
• Amazon Tap,
• Echo Sub,
• Echo Show,
• Fabriq Chorus и другие Alexa-enabled устройства сторонних производителей.

Навык iRidium понимает несколько языков:

• Английский (США),
• Aнглийский (Великобритания),
• Английский (Индия),
• Испанский (Испания),
• Испанский (Мексика),
• Испанский (США),
• Итальянский (Италия),
• Немецкий (Германия),
• Португальский (Бразилия),
• Хинди (Индия),
• Французский (Франция),
• Японский (Япония).

С помощью навыка "iRidium" Алекса может управлять умным домом через iRidium cloud и сервер iRidium. Вы можете произнести команду "Включи свет" и лампочка загорится. Произнесите "Выключи свет" и лампочка погаснет. Всё просто!

Поддерживаемые устройства:

• диммеры и выключатели,
• дверные замки,
• развлекательные устройства, например, smart-телевизоры,
• умные домашние камеры,
• термостаты и вентиляторы,
• микроволновки,
• и многое другое.

Работа в iRidium studio​

Добавление драйвера и устройств​

1. Создайте серверный проект.

2. Добавьте драйвер сети Amazon Alexa Network в проект.

3. Добавьте умные устройства в проект.

4. Переименуйте устройства таким образом, как вы хотели бы их произносить при разговоре с Алексой.

Описание устройств и обратных связей​

Устройства Amazon Alexa - это не реальные устройства, а только лишь интерфейс между реальными устройствами и Алексой. Вы должны реализовать функционал этих устройств в iRidium server или обеспечить связи с соответствующими физическими устройствами по тому или иному протоколу. iRidium предоставляет интерфейс с четырьмя типами устройств:

• Switch
• Dock Station
• Dimmer
• HVAC

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

Switch​

Примеры применения:

• выключатель,
• свет,
• реле.

Dock Station​

Примеры применения:

• зарядная док-станция,
• термостат отопления.

Dimmer​

Примеры применения:

• одноканальный диммер,
• электрический теплый пол.

HVAC​

Примеры применения:

• термостат,
• кондиционер,
• вентилятор,
• электрический теплый пол.

TemperatureMode может принимать следующие значения:

• IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_AUTO,
• IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_COOLING,
• IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_DRY,
• IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_FAN,
• IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_HEATING,
• IR.SUB_DEVICE_STATE_CLIMATE_TEMP_MODE_OFF.

Используйте эти константы, чтобы назначать режим работы термостата с помощью скрипта.

Создание скрипта​

Скрипт обеспечивает прием голосовых команд от Алексы и перенаправляет их на реальные устройства.

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

1. Создать серверный проект *.sirpz ;

2. Добавить скрипт, нажав на кнопку JS > + > New script .

3. В скрипт вставить шаблон:

//Let's create a driver, four subdevices and log the name of the device from which the feedback came and its value 

// Device creation (IR.DEVICE_AMAZON_ALEXA - device type)
var l_pDevice = IR.CreateDevice(IR.DEVICE_AMAZON_ALEXA, "Amazon Alexa");
if(l_pDevice)
{
    /* *     * SubDevice creation
    * Params:
    * 1. Name of SubDevice
    * 2. Type of SubDevice:
    * IR.SUB_DEVICE_TYPE_THROUGH_DIMMER - Dimmer
    * IR.SUB_DEVICE_TYPE_THROUGH_RELAY - Switch
    * IR.SUB_DEVICE_TYPE_AIR_CONDITIONER - Thermostat (HVAC)
    * IR.SUB_DEVICE_TYPE_DOCK_STATION - Dock Station
    */
    l_pDevice.AddSubDevice("Dimmer", IR.SUB_DEVICE_TYPE_THROUGH_DIMMER);
    l_pDevice.AddSubDevice("Switch", IR.SUB_DEVICE_TYPE_THROUGH_RELAY);
    l_pDevice.AddSubDevice("Thermostat", IR.SUB_DEVICE_TYPE_AIR_CONDITIONER);
    l_pDevice.AddSubDevice("DockStation", IR.SUB_DEVICE_TYPE_DOCK_STATION);

    //Log the name of the device from which the feedback came and its value 
    IR.AddListener(IR.EVENT_TAG_CHANGE, l_pDevice, function(name, value){
        IR.Log("Name: " + name + " Value: " + value);

        switch(name)
        {
            case 'Dimmer:Level':
            IR.GetDevice("Modbus TCP").Set("Dimmer Level", value);
            break;
            case 'Switch:Power':
            IR.GetDevice("Modbus TCP").Set("Switch Power", value);
            break;
            case 'HVAC:Level':
            IR.GetDevice("Modbus TCP").Set("HVAC Level", value);
            break;
            case 'HVAC:Sensor Temperature':
            IR.GetDevice("Modbus TCP").Set("HVAC Sensor Temperature", value);
            break;
            case 'Dock Station:Level':
            IR.GetDevice("Modbus TCP").Set("Dock Station Level", value);
            break;
        }
    })
}

4. Преобразовать имена устройств таким образом, как вы хотели бы их произносить при разговоре с Алексой.

Пример создания устройств:

Диммер "Свет ванная":

l_pDevice.AddSubDevice("Bathroom light", IR.SUB_DEVICE_TYPE_THROUGH_DIMMER);

Диммер "Свет гараж":

l_pDevice.AddSubDevice("Garage light", IR.SUB_DEVICE_TYPE_THROUGH_DIMMER);

Остальные устройства создаются аналогично примеру.

5. Настройте связь подустройств Алексы с оборудованием.
   

Пример обработки ответов от Alexa и отправка команд в драйвер Modbus:

IR.AddListener(IR.EVENT_TAG_CHANGE, l_pDevice, function(name, value){
    switch(name)
    {
        case 'Dimmer:Level':
        IR.GetDevice("Modbus TCP").Set("Dimmer Level", value);
        break;
        case 'Switch:Power':
        IR.GetDevice("Modbus TCP").Set("Switch Power", value);
        break;
        case 'HVAC:Level':
        IR.GetDevice("Modbus TCP").Set("HVAC Level", value);
        break;
        case 'HVAC:Sensor Temperature':
        IR.GetDevice("Modbus TCP").Set("HVAC Sensor Temperature", value);
        break;
        case 'Dock Station:Level':
        IR.GetDevice("Modbus TCP").Set("Dock Station Level", value);
        break;
    }
})

6. Загрузить проект на сервер через облако;

7. Синхронизировать проект с Алексой.

Загрузка проекта в iRidium cloud и на сервер​

1. Авторизуйтесь на сайте iRidium.

2. Загрузите серверный и панельный проекты на облако iRidium cloud.

3. На вкладке Users and Panels добавьте в проект конечного пользователя.

4. Запустите iRidium server.

5. Зайдите в веб-интерфейс сервера, набрав в адресной строке браузера:

<IP-адрес сервера>:8888

(Если iRidium server запускается на том же компьютере, на котором он настраивается, то наберите:

127.0.0.1:8888)

6. Наберите пароль доступа по умолчанию 2007. Нажмите кнопку "LOGIN".

7. Найдите вкладку Cloud / Projects .

8. Загрузите проект из облака на сервер, нажав кнопку "CLOUD SYNC" и затем "Download" напротив нужного проекта.

Настройка Алексы​

Регистрация умной колонки​

Алекса настраивается с помощью приложения Alexa App на мобильных устройствах или в веб-сервисе Amazon на ноутбуках или компьютерах.

1. Зарегистрируйтесь на сайте Amazon, если у вас ещё нет учётной записи.

2. На мобильных устройствах будет предложено скачать приложение Alexa App . На ноутбуках и компьютерах можно продолжить настройку на сайте Amazon.

Операционные системы, на которых Alexa App может работать:

• Fire OS 3.0 или выше,
• iOS 9.0 или выше,
• Android 5.0 или выше,
• Windows 10 версии 17134.0 или более поздняя.

3. Пройдите пошаговую процедуру регистрации умной колонки, все инструкции будут на экране.

Установка навыка​

Навык устанавливается только в приложении Alexa App .

1. Запустите приложение. В левом верхнем углу нажмите кнопку меню.

2. Перейдите на вкладку Smart Home .

3. Нажмите кнопку YOUR SMART HOME SKILLS , чтобы посмотреть все установленные навыки умного дома.

4. Нажмите кнопку ENABLE SMART HOME SKILLS , чтобы добавить новый навык.

5. В строке поиска наберите iridium , чтобы найти навык iRidium и затем кликните по нему.

6. Прочитайте про навык и затем нажмите кнопку ENABLE .

7. Вы попадёте на форму регистрации на сайте iRidium mobile. Введите данные учётной записи конечного пользователя и нажмите Login .

8. В выпадающем списке выберите объект, с которым будет работать Алекса. Нажмите Grant Access .

9. Alexa успешно подключилась к объекту iRidium.

Выгрузка устройств из iRidium cloud​

1. Нажмите DISCOVER DEVICES .

2. Процесс займёт не более 20 секунд.

3. Устройства из серверного проекта iRidium автоматически загрузятся в приложение Alexa App .

4. Если вы скорректируете проект, то не забудьте загрузить его в iRidium cloud, затем обновите его в iRidium server. После этого нажмите кнопку Add Device на вкладке Smart Home приложения Alexa App .

Тестирование проекта​

Проект для сервера можно запустить на том же компьютере, на котором производится работа в iRidium studio. Но проект следует загружать только через iRidium cloud.

Произносите голосовые команды в колонку Amazon Echo и Алекса передаст команды в iRidium server, и тот, в свою очередь, исполнит команды согласно скрипту.

Вы может использовать любой эмулятор сервера Modbus TCP, например, бесплатный Modbus PLC Simulator для тестирования проекта.

Секреты Алексы​