RC522 + ASI Biont: Бескодовая интеграция RFID-считывателя с AI-агентом для автоматизации доступа и учёта

Введение: почему RC522 и AI — идеальная пара для умного доступа

RFID-считыватель RC522 — один из самых популярных модулей для идентификации объектов на частоте 13.56 МГц. Он используется везде: от систем контроля доступа в офисах до учёта инструментов на складах и автоматизации выдачи книг в библиотеках. Но классический подход к его интеграции требует написания кода на C++ для Arduino или Python для Raspberry Pi, настройки базы данных, создания бэкенда для обработки меток — это недели работы для инженера.

AI-агент ASI Biont меняет правила игры: он подключается к RC522 через последовательный порт (COM-порт) с помощью Hardware Bridge, и пользователю достаточно описать задачу на естественном языке. Всю низкоуровневую работу — парсинг UID метки, проверку в белом списке, запись в Google Sheets, отправку уведомлений в Telegram — AI генерирует за секунды. Никаких панелей управления, кнопок «добавить устройство» или ручного программирования. Просто диалог в чате.

В этой статье — реальный кейс: как подключить RC522 к ASI Biont и построить систему автоматизации доступа с голосовым управлением, логированием в Google Sheets и Telegram-уведомлениями без единой строчки ручного кода.

Как устроена интеграция: Hardware Bridge + RC522

Архитектура подключения

ASI Biont не может напрямую общаться с COM-портами пользователя, потому что его вычислительное окружение (sandbox) работает в облаке на Railway. Для доступа к локальным устройствам используется Hardware Bridge — небольшое Python-приложение bridge.py, которое пользователь запускает на своём компьютере (Windows, Linux, macOS).

Схема работы:
1. Пользователь скачивает bridge.py из дашборда ASI Biont (Devices → Create API Key → Скачать bridge).
2. Запускает bridge с токеном и списком портов: python bridge.py --token=YOUR_TOKEN --ports=COM3 --baud=115200.
3. Bridge подключается к облаку ASI Biont через WebSocket (единственный канал связи).
4. AI использует инструмент industrial_command с протоколом serial:// для отправки команд на bridge.
5. Bridge выполняет атомарную операцию serial_write_and_read(data=hex_string) — записывает данные в COM-порт и сразу читает ответ.

Подключение RC522 к компьютеру

RC522 — это SPI-устройство, но для связи с компьютером его проще всего подключить через Arduino (или ESP32) по USB. На Arduino загружается скетч, который читает метки по SPI и выводит UID в последовательный порт. Затем компьютер видит Arduino как виртуальный COM-порт (например, COM3).

Пример минимального скетча для Arduino:

#include <SPI.h>
#include <MFRC522.h>

#define RST_PIN 9
#define SS_PIN 10

MFRC522 mfrc522(SS_PIN, RST_PIN);

void setup() {
  Serial.begin(115200);
  SPI.begin();
  mfrc522.PCD_Init();
  Serial.println("HELP"); // Для проверки связи с ASI Biont
}

void loop() {
  if (mfrc522.PICC_IsNewCardPresent() && mfrc522.PICC_ReadCardSerial()) {
    String uid = "";
    for (byte i = 0; i < mfrc522.uid.size; i++) {
      uid += String(mfrc522.uid.uidByte[i] < 0x10 ? "0" : "");
      uid += String(mfrc522.uid.uidByte[i], HEX);
    }
    uid.toUpperCase();
    Serial.println(uid); // Вывод UID в порт, например: "A1B2C3D4"
    delay(1000);
  }
}

После загрузки скетча Arduino будет выводить UID каждой поднесённой метки. Bridge читает эти строки и передаёт их AI.

Реальный сценарий: автоматизация доступа с голосовым управлением

Проблема

Небольшой коворкинг (на 50 человек) использует RFID-карты для входа. Раньше администратор вручную выдавал карты, вносил данные в Excel и открывал дверь кнопкой. Это занимало время, терялись записи, и нельзя было удалённо управлять доступом. Нужна система, которая:
- автоматически распознаёт UID метки;
- проверяет, есть ли карта в белом списке;
- если да — открывает дверь (через реле на Arduino);
- если нет — отправляет уведомление администратору в Telegram;
- записывает все события (время, UID, статус) в Google Sheets.

Решение: ASI Biont + RC522

Пользователь открывает чат с ASI Biont и пишет:

«Подключись к моему Arduino через COM3 на скорости 115200. Когда на него приходит UID метки, проверь его по белому списку. Если метка есть в списке — отправь команду на Arduino для открытия реле (символ 'O'). Запиши событие в Google Sheets: время, UID, статус. Если метки нет в списке — отправь мне уведомление в Telegram с UID и временем.»

AI сам генерирует код интеграции и выполняет его. Пользователю не нужно писать ни строчки.

Как это выглядит технически

После запуска bridge.py, AI отправляет команду для проверки связи:

industrial_command(
    protocol="serial://",
    command="serial_write_and_read",
    params={
        "port": "COM3",
        "baud": 115200,
        "data": "48454c500a"  # "HELP\n" в hex
    }
)

Arduino отвечает HELP, bridge читает ответ и передаёт AI. Связь установлена.

Затем AI создаёт Python-скрипт для постоянного мониторинга порта (через execute_python в sandbox, но с учётом того, что sandbox не имеет доступа к COM-портам — поэтому AI использует industrial_command в цикле с задержкой):

import requests
import json
from datetime import datetime

# Белый список меток (UID)
WHITE_LIST = ["A1B2C3D4", "E5F6A7B8"]

# Telegram config
TELEGRAM_BOT_TOKEN = "YOUR_BOT_TOKEN"
TELEGRAM_CHAT_ID = "YOUR_CHAT_ID"

# Google Sheets API (через сервисный аккаунт)
SHEETS_ID = "YOUR_SHEETS_ID"
SHEETS_RANGE = "Logs!A:C"

def send_telegram(message):
    url = f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage"
    requests.post(url, json={"chat_id": TELEGRAM_CHAT_ID, "text": message})

def log_to_sheets(uid, status):
    url = f"https://sheets.googleapis.com/v4/spreadsheets/{SHEETS_ID}/values/{SHEETS_RANGE}:append?valueInputOption=RAW"
    body = {"values": [[datetime.now().isoformat(), uid, status]]}
    headers = {"Authorization": f"Bearer {SHEETS_TOKEN}", "Content-Type": "application/json"}
    requests.post(url, json=body, headers=headers)

# Цикл опроса порта (без while True — используем industrial_command в AI-агенте)
# Каждые 5 секунд AI отправляет команду на чтение

AI не использует while True в sandbox (таймаут 30 секунд). Вместо этого он запускает циклический опрос через industrial_command с задержкой 5 секунд. При получении UID:
- проверяет по WHITE_LIST;
- если найден — отправляет команду serial_write_and_read с данными "4f0a" (символ 'O' + newline) для открытия реле;
- записывает событие в Google Sheets;
- если не найден — отправляет уведомление в Telegram.

Все действия выполняются автоматически, без участия человека.

Результаты и метрики

После внедрения системы в коворкинге:

Почему это выгодно

1. Бескодовая интеграция. Пользователь не пишет код вручную. Он описывает задачу на русском языке, AI генерирует и выполняет код за секунды.
2. Универсальность. ASI Biont подключается к любому устройству через execute_python — AI сам пишет код интеграции под каждое устройство. Не нужно ждать, пока разработчики добавят поддержку RC522 — подключайте его прямо сейчас.
3. Голосовое управление. Можно сказать: «Открой дверь для метки A1B2C3D4» — AI отправит команду на Arduino.
4. Автоматизация без программирования. Весь процесс — от распознавания метки до записи в Google Sheets и Telegram — выполняется AI без участия человека.
5. Масштабируемость. К одному bridge можно подключить несколько COM-портов с разными Arduino. AI управляет каждым независимо.

Как начать: пошаговая инструкция

1. Подготовьте оборудование: Arduino (Uno, Nano, Mega) + модуль RC522. Подключите по SPI (SS→10, MOSI→11, MISO→12, SCK→13, RST→9, 3.3V→3.3V, GND→GND).
2. Загрузите скетч (см. выше) в Arduino через Arduino IDE.
3. Скачайте bridge.py из дашборда ASI Biont (Devices → Create API Key).
4. Запустите bridge: python bridge.py --token=YOUR_TOKEN --ports=COM3 --baud=115200.
5. Откройте чат с ASI Biont и опишите задачу: «Подключись к COM3, читай UID с RC522, проверяй по белому списку, открывай реле и записывай в Google Sheets».
6. AI сделает всё остальное.

Заключение

Интеграция RC522 с ASI Biont через Hardware Bridge — это простой способ построить умную систему контроля доступа без программирования. AI берёт на себя всю работу: от чтения UID до логирования и уведомлений. Вы просто описываете задачу — AI её решает.

Попробуйте сами: подключите RC522 к ASI Biont на asibiont.com и автоматизируйте доступ к вашему офису, складу или лаборатории за 10 минут.