Amazon Alexa (v3)

голосовое управление оборудованием через iRidi и Amazon Alexa (3-ей версии API).

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

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

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

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

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

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

Работа в iRidi Studio​

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

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

2. Добавьте драйвер Amazon Alexa (v3) Network в проект.

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

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

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

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

• Contact sensor,
• Motion sensor,
• Door,
• Curtains,
• Switch,
• Thermostat (Heat - Cool),
• Thermostat,
• Light Color Temperature,
• Light Color,
• Light,
• Dimmer.

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

Contact sensor​

Концевые выключатели, контактные термометры, электронные датчики.

Motion sensor​

Автоматическая регулировка освещения.

Door​

Управление замком на двери.

Curtains​

Управление шторами.

Switch​

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

Thermostat (Heat - Cool)​

Управление термостатом с ограничением максимальной и минимальной температуры.

Thermostat​

Управление термостатом.

Light Color Temperature​

Лампочка, светильник, ночник или люстра с изменением теплоты света.

Light Color​

Лампочка, светильник, ночник или люстра с RGB управлением.

Light​

Управление диммируемыми лампами.

Dimmer​

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

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

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

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

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

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

3. В скрипт вставьте шаблон и настройте связь подустройств Алексы с оборудованием:

//Let's get a link to the "Amazon Alex (v3) Network" driver.
var l_pDevice = IR.GetDevice("Amazon Alexa (v3) Network");
if(l_pDevice)
{

    //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 "Contact sensor:State":
            IR.GetDevice("Modbus TCP").Set("Contact sensor:State", value);
            break;
            case "Light Color:Color":
            IR.GetDevice("Modbus TCP").Set("Light Color:Color", value);
            break;
            case "Thermostat (Heat-Cool):Power":
            IR.GetDevice("Modbus TCP").Set("Thermostat (Heat-Cool):Power", value);
            break;
        }
    })
}

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

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

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

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

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

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

4. Запустите iRidi Server.

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

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

(Если iRidi 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. Запустите приложение. Перейдите на вкладку Devices и нажмите кнопку YOUR SMART HOME SKILLS , чтобы посмотреть все установленные навыки умного дома..

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

3. В строке поиска наберите iridium assistant для поиска навыка и кликните по нему.

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

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

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

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

Выгрузка устройств из iRidi Cloud​

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

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

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

4. Если вы скорректируете проект, то не забудьте загрузить его в iRidi Cloud, затем обновите его в iRidi Server. После этого нажмите кнопку Add Device на вкладке Devices приложения Alexa App .

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

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

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

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