Но как выяснилось, такое производитель заблокировал. Принтер дружит только с приложением Funny Print на смартфоне. USB-порт у него только для зарядки, Windows его как бы видит, но и только. Bluetooth типа есть, но BLE (Bluetooth Low Energy), и никакого «последовательного порта» для ПК. Весной я убил на него ни один вечер, и нейронка, с которой я советовался, после всех мучений выдала гениальное: «Займитесь другим проектом. Или купите принтер с нормальным RS232/TTL».

Вот и кукует теперь этот пластиковый зверёк, пылью покрывается. Но за несколько месяцев нейросети поумнели и набрались опыта. Так что…

Однажды, листопадным осенним вечером я вспомнил про сие чудовище китайской электроники, и… теперь принтер печатает с ПК одной командой, а из Home Assistant печатает сообщения из семейного чата. Ниже о том как это было сделано: с кодом и граблями, на которых я с увлечением отплясывал.

Протокол: спасибо тем, кто был раньше

Сниффать Bluetooth мне не пришлось. Протокол уже разобрали ValdikSS в printer-driver-funnyprint и klimromanyuk в funnyprint. Я сверил их реализации между собой и собрал минимальную версию на Python.

Коротко, как это устроено:

• Принтер рекламирует себя как LX-D02. Команды пишутся в характеристику FFE1, ответы приходят уведомлениями из FFE2.
• Ширина печати 384 точки, то есть 48 байт на строку. За раз отправляется пакет из двух строк, 96 байт.
• Перед печатью нужно «рукопожатие»: принтер присылает вызов, а в ответ ждёт байт, посчитанный по CRC16 от его MAC-адреса. Без этого он молча игнорирует данные. Видимо, это защита от «чужих» приложений.
• Дальше задаётся плотность (0..7), количество пакетов, и пакеты идут потоком. Когда лента допечатана, принтер отвечает 5a06.

Текст принтер не понимает, только картинку. Поэтому текст сначала рисуется в чёрно-белое изображение шириной 384 точки через Pillow, а потом режется на пакеты.

Весь протокол в одном файле

Вот он целиком, это 143 строки. В конце самопроверка: python printer.py должен напечатать в консоль ok.

"""LX-D02 (FunnyPrint) protocol. No Home Assistant imports: also used by ../../lxd02.py.

Protocol from github.com/ValdikSS/printer-driver-funnyprint.
"""
import asyncio
from pathlib import Path

from PIL import Image, ImageDraw, ImageFont

WRITE = "0000ffe1-0000-1000-8000-00805f9b34fb"
NOTIFY = "0000ffe2-0000-1000-8000-00805f9b34fb"
WIDTH = 384  # dots, 48 bytes per row
FONT = Path(__file__).with_name("DejaVuSans.ttf")


def crc16(data):
    crc = 0
    for b in data:
        for i in range(8):
            if ((crc >> 15) & 1) ^ ((b >> (7 - i)) & 1):
                crc = ((crc << 1) & 0xFFFF) ^ 0x1021
            else:
                crc = (crc << 1) & 0xFFFF
    return crc


def handshake_reply(mac):
    r = crc16(b"\x00" + bytes.fromhex(mac.replace(":", ""))) >> 8
    return b"\x5a\x0b" + bytes([r]) * 10


def wrap(text, font, width):
    out = []
    for para in text.split("\n"):
        line = ""
        for word in para.split(" "):
            cand = f"{line} {word}" if line else word
            if line and font.getlength(cand) > width:
                out.append(line)
                line = word
            else:
                line = cand
        out.append(line)
    return out


def render(text, size=28, separator=False):
    font = ImageFont.truetype(str(FONT), size)
    lines = wrap(text, font, WIDTH - 8)
    text_h = (size + 6) * len(lines) + 4
    h = text_h + (16 if separator else 0)
    img = Image.new("1", (WIDTH, h + h % 2), 1)
    d = ImageDraw.Draw(img)
    for i, line in enumerate(lines):
        d.text((4, 2 + i * (size + 6)), line, font=font, fill=0)
    if separator:
        d.rectangle((0, text_h + 6, WIDTH - 1, text_h + 9), fill=0)
    return img


def to_payloads(img):
    """1-bit image, WIDTH wide -> 96-byte payloads, two rows each, 1 = black."""
    if img.height % 2:
        img = img.crop((0, 0, WIDTH, img.height + 1))  # pads with 0 = black
        img.paste(1, (0, img.height - 1, WIDTH, img.height))
    raw = bytes(b ^ 0xFF for b in img.tobytes())
    rows = [raw[i:i + 48] for i in range(0, len(raw), 48)]
    return [rows[i] + rows[i + 1] for i in range(0, len(rows), 2)]


async def print_payloads(client, mac, payloads, density=3, feed=40):
    """Handshake and print on an already connected BleakClient."""
    payloads = payloads + [bytes(96)] * feed
    events = asyncio.Queue()

    def w(data):
        return client.write_gatt_char(WRITE, data, response=False)

    async def wait_for(prefix, timeout=5):
        while True:
            data = await asyncio.wait_for(events.get(), timeout)
            if data[:2] == prefix:
                return data

    await client.start_notify(NOTIFY, lambda _, data: events.put_nowait(bytes(data)))
    await w(b"\x5a\x01" + bytes(10))  # device info
    await asyncio.sleep(0.5)
    await w(b"\x5a\x0a" + bytes(10))  # challenge
    await wait_for(b"\x5a\x0a")
    await w(handshake_reply(mac))
    if (await wait_for(b"\x5a\x0b"))[2] != 1:
        raise RuntimeError("LX-D02 handshake failed")

    await w(b"\x5a\x0c" + bytes([max(0, min(7, density))]))
    await asyncio.sleep(0.3)
    n = len(payloads)
    await w(b"\x5a\x04" + n.to_bytes(2, "big") + b"\x00\x00")
    await asyncio.sleep(0.1)

    # Flow control as in klimromanyuk/funnyprint: the printer's buffer is small.
    # 5a08 = "pause, buffer full"; 5a05 + row number = "lost rows, resend from here";
    # 5a06 = "done". Without this, long prints (pictures) come out cut short.
    cur, paused, rests = 0, False, 0
    try:
        while True:
            if paused or cur >= n:
                data = await asyncio.wait_for(events.get(), 90 if paused else max(60, n * 0.5))
            elif not events.empty():
                data = events.get_nowait()
            else:
                await w(b"\x55" + cur.to_bytes(2, "big") + payloads[cur] + b"\x00")
                cur += 1
                await asyncio.sleep(0.025)
                continue
            kind = data[:2]
            if kind == b"\x5a\x06":
                return
            if kind == b"\x5a\x08":
                paused = True
            elif kind == b"\x5a\x05":
                lost = int.from_bytes(data[2:4], "big")
                if paused:  # let the printer print out its buffer, then resend
                    rests += 1
                    await asyncio.sleep(min(8.0, 2.0 + rests * 0.5))
                    while not events.empty():
                        more = events.get_nowait()
                        if more[:2] == b"\x5a\x06":
                            return
                        if more[:2] == b"\x5a\x05":
                            lost = int.from_bytes(more[2:4], "big")
                    paused = False
                cur = lost
    finally:
        await w(b"\x5a\x04" + n.to_bytes(2, "big") + b"\x01\x00")


if __name__ == "__main__":
    assert handshake_reply("00:00:00:00:00:00") == b"\x5a\x0b" + bytes(10)
    assert to_payloads(Image.new("1", (WIDTH, 2), 0)) == [b"\xff" * 96]
    assert to_payloads(Image.new("1", (WIDTH, 1), 0)) == [b"\xff" * 48 + bytes(48)]
    assert render("x", separator=True).height == render("x").height + 16
    assert len(wrap("a " * 200, ImageFont.truetype(str(FONT), 28), WIDTH)) > 1
    print("ok")

Шрифт DejaVuSans.ttf лежит рядом с файлом. Это не прихоть: системного шрифта с кириллицей в контейнере Home Assistant нет, и вместо русского текста печатаются квадратики.

Печать с компьютера

Скрипт для ПК, lxd02.py, лежит в репозитории рядом с printer.py. Он сам находит принтер по имени, подключается и печатает. Ставим зависимости и печатаем:

pip install "bleak<1.0" pillow
python lxd02.py "Привет" "Вторая строка"
python lxd02.py фото.jpg

Картинки он растягивает на ширину ленты, альбомные поворачивает вдоль неё.

Интеграция в Home Assistant

У меня Home Assistant Supervised крутится в Docker на ТВ-приставке с rk3318, и встроенный в неё Bluetooth доступен через BlueZ. Поверх printer.py я написал небольшую интеграцию lxd02: папку custom_components/lxd02 копируем в /config/custom_components/, в configuration.yaml добавляем MAC принтера и перезапускаем HA.

lxd02:
  mac: AA:BB:CC:DD:EE:FF

После этого появляется действие lxd02.print_text:

action: lxd02.print_text
data:
  text: "Привет из Home Assistant"
  size: 28         # размер шрифта, 10..120
  density: 3       # плотность, 0..7
  feed: 40         # прогон ленты после текста
  separator: true  # линия под текстом

Самое ценное в интеграции — очередь. Принтер может быть выключен, лежать в другой комнате или быть занят телефоном. Поэтому каждое задание сначала попадает в очередь на диске (/config/.storage/lxd02), и перезапуск HA её не теряет. Как только HA снова видит принтер, очередь печатается по порядку. Если задание оборвалось на середине, оно остаётся первым и печатается заново целиком.

Зачем всё это: семейный чат на чековой ленте

У нас дома есть нода MeshCore, это текстовая радиосеть без интернета и без операторов. Интеграция MeshCore для Home Assistant генерирует событие на каждое входящее сообщение. Осталось связать два конца:

triggers:
- trigger: event
  event_type: meshcore_message
  event_data:
    message_type: channel
conditions:
- condition: template
  value_template: "{{ trigger.event.data.channel | lower == 'family' and not trigger.event.data.outgoing | default(false) }}"
actions:
- action: lxd02.print_text
  continue_on_error: true
  data:
    size: 24
    separator: true
    text: "{{ trigger.event.data.sender_name }} · {{ now().strftime('%d.%m %H:%M') }}\n{{ trigger.event.data.message }}"
mode: queued
max: 20

Теперь каждое сообщение из канала Family печатается на ленте: в первой строке отправитель и время, ниже текст, под ним черта. Свои исходящие сообщения я отфильтровал: интеграция MeshCore присылает событие для них заново на каждое обновление статуса доставки, и без фильтра одно и то же сообщение печаталось по несколько раз.

Если принтер в этот момент недоступен, сообщение ждёт в очереди и печатается позже, но с исходным временем получения в заголовке.

Грабли №4: Bluetooth, который засыпает навсегда

Время от времени принтер «отваливался», и приходилось переподключать его руками. Я грешил на принтер: мол, не рассчитан быть наготове 24/7. Одну причину я уже описал выше, это повторы в очереди. Вторая оказалась интереснее, и принтер в ней вообще ни при чём. Зависал Bluetooth-чип самой приставки: в dmesg появлялось hci0: Opcode 0x0c03 failed: -110, адаптер уходил в DOWN, а HA показывал NotReady. Помогал только перезапуск драйвера.

Раз помогает перезапуск, пусть его делает машина. Скрипт-сторож раз в минуту проверяет адаптер, и если тот лежит, перепривязывает чип к драйверу:

#!/bin/sh
# Revive hung built-in Bluetooth (BCM4334 on UART, hci_uart_bcm).
# Symptom: hci0 DOWN, dmesg "hci0: Opcode 0x0c03 failed: -110", HA "NotReady".
# Run by bt-watchdog.timer every minute.
D=/sys/bus/serial/drivers/hci_uart_bcm

up() { hciconfig hci0 2>/dev/null | grep -q "UP RUNNING"; }

up && exit 0
sleep 20  # HA/BlueZ may be resetting the adapter itself
up && exit 0

logger -t bt-watchdog "hci0 down, rebinding serial0-0"
echo serial0-0 > $D/unbind 2>/dev/null
sleep 2
echo serial0-0 > $D/bind
sleep 8
timeout 5 bluetoothctl power on >/dev/null 2>&1
if up; then
    logger -t bt-watchdog "hci0 back up"
else
    logger -t bt-watchdog "hci0 still down after rebind"
fi

Запускается он systemd-таймером:

[Unit]
Description=Check Bluetooth chip every minute

[Timer]
OnBootSec=3min
OnUnitActiveSec=1min

[Install]
WantedBy=timers.target

Имя драйвера (hci_uart_bcm) и устройства (serial0-0) у вас может быть другим, смотрите в /sys/bus/serial/drivers/. Если Bluetooth у вас USB-свисток, то и перезапускать нужно по-другому.

Грабли №5: длинная печать рвётся

В первой версии код слал пакеты с фиксированной паузой и не слушал принтер. Короткие сообщения печатались отлично, а длинная картинка обрывалась на середине. Принтер на самом деле сообщает «подожди, буфер полон» (5a08) и «потерял строки, дошли с такой-то» (5a05). В коде выше это уже учтено, по образцу klimromanyuk/funnyprint. Подробности — в посте про принтер для Windows.

Итог

Устройство, которое «работает только с приложением», оказалось вполне обычным BLE-гаджетом. Чтобы с ним договориться, хватило полутора сотен строк на Python, очереди и одного сторожевого скрипта. Вещь, которая полтора года лежала на полке, теперь каждый день печатает сообщения из семейного чата.

Весь код открыт: git.08h.ru/alex/lx-d02. А в следующем посте принтер становится обычным принтером Windows, на который можно печатать из Блокнота и браузера.

Следующий шаг напрашивается сам: печатать по утрам погоду и задачи на день, а по вечерам список покупок. Если у вас такой же принтер и что-то не заводится, пишите в комментариях, разберёмся.

Историю о том, как это всё рождалось, с отчаянием и счастливым концом, я по ходу дела записывал в личном дневнике.

Удобно, но это всё ещё печать «на программерском». А хотелось, чтобы принтер стоял в списке рядом с обычным, и на него можно было отправить что угодно: заметку из Блокнота, страницу из браузера, картинку.

Своего драйвера у LX-D02 нет, колхозить самописный для Windows с нуля — удовольствие на любителя. Поэтому план был простой: пусть Windows печатает на какой-нибудь готовый драйвер, а уже тот отдаёт результат не в сам принтер, а в порт на этом же компьютере. Там его ловит небольшой сервер на Python, превращает в картинку шириной 384 точки и отправляет по Bluetooth.

Звучит как вечерок работы. Однако, по и тогу, вышло три драйвера, один самописный IPP-принтер и одна вовремя найденная находка из прошлого.

Попытка 1: Microsoft Print to PDF

Самым очевидным кандидатом стал драйвер «Microsoft Print to PDF» (есть в любой Windows начиная с). Порт ему можно назначить любой, в том числе сетевой 127.0.0.1:9100. Тогда вместо сохранения файла, PDF уходит прямиком в мой сервер, а тот рисует его библиотекой pypdfium2.

Заработало сразу. Тестовая лента вышла, я довольный пошёл печатать из Блокнота и получил… буквы размером с маковое зёрнышко.

Причина банальна. PDF-драйвер знает только офисные форматы: A4, Letter, A3 и подобные. Блокнот честно раскладывает текст на лист шириной 210 мм, а сервер потом ужимает этот лист до 48 мм ширины печатной ленты. В четыре с лишним раза. В логе так и было: страница целиком, 555 точек в длину.

Значит, Windows должна с самого начала знать, что бумага у принтера шириной 58 мм. А PDF-драйвер этого не умеет.

Попытка 2: притворяемся сетевым принтером (IPP)

В Windows есть ещё один встроенный драйвер — Microsoft IPP Class Driver. Он для современных сетевых принтеров, которые сами рассказывают о себе по протоколу IPP: какие у них форматы бумаги, разрешение, цветность.

IPP — бинарный протокол поверх HTTP: группы атрибутов, теги типов, вложенные коллекции. Минимальный сервер, который отвечает на «Какие у тебя возможности?», принимает задания и сообщает их статус, занял около 270 строк. Windows подключилась, задала свои вопросы (в логе было видно, что она спрашивает media-supported, media-col-database и ещё полсотни атрибутов)… и показала в списке бумаги только Letter и A4.

Дальше пошли эксперименты. Плюс в том, что Windows перечитывает возможности принтера при каждом запросе, так что переустанавливать ничего не нужно: поменял список, перезапустил сервер, посмотрел, что она выбрала.

• Самоописывающие названия по стандарту PWG om_..._58x200mm и custom_58x200mm — выброшены.
• Визитка, A7, A8, карточка 3×5 дюйма — выброшены.
• A6 для проверки — принят.
• A5, которому я подсунул размеры 58×200 мм, — принят, но с честными размерами A5. Мои цифры Windows проигнорировала и взяла размер по названию.
• Диапазон «ширина 58 мм, длина любая» для своего размера бумаги — проигнорирован.

Вывод: IPP-драйвер Windows понимает только знакомые ему названия бумаги, и самое узкое из них — A6, 105 мм. Это лучше, чем A4, но всё равно вдвое мельче нужного. 270 строк отправились в корзину.

Была ещё идея из серии: «А может его как факс добавить?». Увы: факс-драйвер тоже живёт в мире A4 и Letter и выдаёт TIFF для факсимильного аппарата, то есть те же грабли.

Попытка 3: находка из прошлого

Пока я перебирал драйверы командой Get-PrinterDriver, в списке мелькнуло POS-58 11.2.0.0. Это стандартный драйвер для китайских 58-мм чековых принтеров. Я сам поставил его весной, когда первый раз пытался подружить LX-D02 с компьютером, ничего не добился и забыл.

А ведь это ровно то, что нужно. Драйвер — обычный Unidrv, то есть текстовый файл описания POS58.GPD плюс встроенный в Windows движок.

Внутри:

• разрешение 203×203 точки на дюйм, как у LX-D02;
• бумага шириной 58 мм, длиной 210, 297 или 3276 мм, плюс свой размер;
• печатная ширина 1151 единица при 609 единицах на дюйм — это ровно 384 точки. Совпадение до точки.

Выдаёт он команды ESC/POS — язык, на котором говорят почти все чековые принтеры. Я поставил принтер на этот драйвер с портом 127.0.0.1:9100, напечатал строчку из Блокнота и посмотрел, что пришло:

1b 70 00 40 50        ESC p  — открыть денежный ящик (спасибо, не надо)
1b 40                 ESC @  — сброс
1b 42 04 01           ESC B  — пискнуть
1d 76 30 00 30 00 18 00 + 1152 байта   GS v 0 — картинка 48×24 байта
1b 4a 15              ESC J  — прогнать ленту
...и так 99 раз

Драйвер режет страницу на полосы по 24 строки и отправляет каждую командой GS v 0: ширина 48 байт (384 точки), высота 24 строки, дальше сами точки, единица — чёрный. Между полосами идёт прогон ESC J, и он сдвигает бумагу ровно на высоту полосы, так что полосы можно просто сложить друг под другом. Весь разбор:

rows, pos = [], 0
while True:
    pos = data.find(b"\x1dv0", pos)
    if pos < 0 or pos + 8 > len(data):
        break
    w = data[pos + 4] | data[pos + 5] << 8
    h = data[pos + 6] | data[pos + 7] << 8
    band = data[pos + 8:pos + 8 + w * h]
    rows += [band[r * w:(r + 1) * w] for r in range(h)]
    pos += 8 + w * h

Блокнот напечатал текст нормального размера.

С третьей попытки.

Доводка: рулон, поля и картинки

Рулон бумаги. По умолчанию у POS-58 выбрана лента длиной 3276 мм, и браузер честно показывает в превью трёхметровую полоску с картинкой посередине. Колонтитул «Страница 1» уезжает в самый низ листа. Чтобы не тратить рулон, сервер срезает белое сверху и снизу и ужимает любой пустой промежуток длиннее 6 мм до 6 мм. Трёхметровая страница из Блокнота превратилась в 2 см ленты.

Левое поле. Программы держат свои поля страницы, и текст начинался с отступом в треть ленты. Сервер находит, где начинаются чернила, и сдвигает всё содержимое к левому краю. Сдвиг общий для всей страницы, так что выравнивание по центру или вправо не ломается.

Правый край. А вот здесь ничего не поделаешь: у драйвера печатная полоса 48 мм начинается от левого края листа 58 мм. Браузер с обычными полями сдвигает картинку к центру, и правые миллиметры драйвер срезает ещё до моего сервера. Лечится настройкой: поля «Минимальные». Тогда браузер берёт их у драйвера, и всё помещается.

Картинки. Из «Фотографий» и браузера картинки выходили то мелкими, то обрезанными: они раскладывают картинку по листу, как им удобно.

Поэтому для картинок я сделал обходной путь без драйвера. Правый клик по файлу → «Печать на LX-D02», и картинка растягивается ровно на ширину ленты. Альбомная поворачивается вдоль ленты, чтобы выйти крупнее, полутона передаются растром, как в газете. Это пункт в реестре HKCU\Software\Classes\SystemFileAssociations\image\shell, права администратора не нужны.

И последние грабли: длинная печать

Скриншот с часами вышел почти целым по ширине и обрезанным по длине. Первая версия кода слала пакеты с фиксированной паузой и не слушала принтер. А принтеру есть что сказать:

• 5a08 — «подожди, буфер полон»;
• 5a05 + номер строки — «я потерял строки, дошли с этой»;
• 5a06 — «готово».

Вот так выглядело вертикальное фото.

Доходило примерно до середины, потом принтер думал, а затем спохватывался и заканчивал печать.

Потому, что короткие тексты проскакивали, а длинная картинка переполняла буфер. Код ждал ответа «готово» 30 секунд и потом сам закрывал задание, обрывая печать на середине.

Доработал. Теперь код по образцу klimromanyuk/funnyprint на паузе ждёт, пока принтер допечатает буфер, досылает потерянные строки и закрывает задание только по «готово»..  Время ожидания растёт вместе с длиной задания. Картинка напечаталась целиком.

Заодно лечится ещё одна мелочь: Windows иногда не может подключиться к уснувшему принтеру с первого раза и пишет Unreachable. Теперь подключение пробуется три раза.

А почему не свой драйвер?

Вопрос напрашивается: раз уж всё равно разбирался, почему бы не написать для LX-D02 настоящий драйвер?

Вариантов два, и оба проигрывают.

• Свой файл описания для встроенного движка Windows (те же .gpd и .inf, что у POS-58). Написать можно за вечер, но 64-битная Windows не ставит неподписанные драйверы. Для себя можно подписать своим сертификатом и добавить его в доверенные на каждом компьютере. Для других нужна подпись Microsoft, а это платный сертификат и их проверка. И даже после всего этого получится ровно то же, что уже даёт POS-58, только с другим названием в списке.
• Драйвер, который сам ходит в Bluetooth (монитор порта на C/C++ внутри службы печати). Тогда не будет нужен сервер на Python. И это плюс. Но зато и ошибка в таком модуле роняет печать во всей системе, отлаживать его тяжело, а подписывать всё-равно придётся. И это уже минус, при том размером с копьё.

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

Драйвер POS-58 уже подписан и потому без проблем ставится везде.

Вся логика сервера живёт в паре сотен строк на Python: упал — перезапустился, не печатает — смотрю журнал и сохранённое задание, поправил — перезапустил, без перезагрузки и без переустановки драйвера. И тот же код печатает из командной строки и из Home Assistant.

Единственный минус — драйвер POS-58 придётся найти, но он обычно идёт с любым дешёвым 58-мм чековым принтером. Но если нашёл даже я, то это не должно стать проблемой.

Как поставить у себя

Нужны Python, Bluetooth и драйвер POS-58. Он обычно идёт с любым дешёвым 58-мм чековым принтером (либо ищем на просторах интернета). Дальше в PowerShell от имени администратора:

git clone https://git.08h.ru/alex/lx-d02.git
cd lx-d02
pip install -r requirements.txt
Set-ExecutionPolicy -Scope Process Bypass
.\windows\install.ps1

Скрипт добавит принтер LX-D02, сервер в автозапуск через Планировщик задач и пункт для картинок в контекстное меню. Удаление — install.ps1 -Uninstall.

Итог

Чековый принтер за копейки, который «работает только с приложением», теперь стоит в Windows рядом с офисным. Текст печатает из любой программы, а картинки — правым кликом (через «Отправить»), длинные задания не рвёт.

Самый полезный урок этого вечера даже не про принтеры. Решение нашлось не в коде, а в списке того, что уже стоит на машине. Весенняя неудачная попытка оставила после себя драйвер, без которого осенью ничего бы не вышло. Так что не спешите удалять «бесполезное» после неудачных экспериментов.

Если у вас похожий принтер и что-то не заводится, пишите в комментариях или открывайте задачу в репозитории.

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

Разработчики LaserGRBL предусмотрели элегантное решение — пользовательские кнопки (Custom Buttons). Это инструмент, который позволяет упаковать сложный набор команд в один клик мыши. Давайте разберем, как с ними работать и как с помощью встроенных переменных вывести автоматизацию на новый уровень.

Состояние на Июнь 2026: Интерфейс LaserGRBL остается стабильным. Все приведенные скриншоты и пути актуальны для версии 3.8.2 и выше. Убедитесь, что ваша версия обновлена, чтобы использовать переменные [$num].

Что такое пользовательские кнопки?

По сути, это программируемые макросы. Вы создаете графическую кнопку прямо на панели управления LaserGRBL и привязываете к ней блок команд G-кода. При нажатии станок выполняет всё, что вы прописали: от простого перемещения до запуска сложных циклов.

Это незаменимо, когда нужно:

• Быстро обрисовать «габаритный прямоугольник» будущей гравировки, чтобы убедиться, что заготовка лежит правильно.
• Переместить инструмент в точку смены материала.
• Реализовать сложную логику, например, включение лазера на минимальной мощности для прицеливания.

Где их найти и как создать?

В LaserGRBL нет отдельного меню «Настройки макросов». Всё интуитивно спрятано в контекстном меню:

1. Запустите программу и посмотрите на верхнюю панель, где расположены стрелки перемещения, кнопка «Домой» и т.д.
2. Кликните правой кнопкой мыши по любому пустому месту в этой области (или даже по существующей кнопке).
3. В выпадающем списке выберите Add new (Добавить новую), чтобы начать с чистого листа, или Import (Импортировать), если хотите загрузить готовый файл-образец.

Три типа кнопок: выбираем под задачу

Перед написанием кода вы столкнетесь с выбором типа кнопки. От этого зависит, как она будет реагировать на ваши действия мышкой.

1. Обычная кнопка (Button)

Самый простой и популярный тип. Одно нажатие — один блок кода.

• Когда использовать: Для абсолютного большинства задач. Запуск подготовительных процедур, установка нуля координат, выполнение конкретной G-команды.
• Пример: Рисуем рамку вокруг загруженной картинки.

2. Кнопка-переключатель (TwoStateButton)

У нее два визуальных состояния (Вкл/Выкл) и два разных блока кода. Первое нажатие выполняет действие и «залипает», второе — выполняет альтернативный код и отлипает.

• Когда использовать: Для опций, требующих фиксации. Идеальный пример — тестовое включение лазера.
• Сценарий: Нажали кнопку — лазер зажегся на минимальной мощности (помогает поймать фокус в середине линзы). Отпустили — лазер не гаснет. Нажали еще раз — лазер погас.

3. Кнопка с удержанием (PushButton)

Выполняет код, только пока вы держите ее нажатой. Отпустили — срабатывает второй блок кода (обычно стоп или отмена).

• Когда использовать: Для ручных перемещений. Это аналог джойстика. Пока держите — ось едет. Бросили — остановка.
• Важно: Требует особой осторожности в настройке, чтобы не сломать механику.

Магия переменных: G-код, который подстраивается сам

Главная сила кастомных кнопок — использование переменных. Вам не нужно вручную переписывать координаты каждый раз, когда меняется размер изображения. Переменные берут актуальные данные из интерфейса LaserGRBL. Они заключаются в квадратные скобки [ ], и внутри них можно проводить вычисления.

Вот список самых необходимых переменных (валидны для LaserGRBL 2026):

Лайфхак: Внутри скобок работают простые формулы. Запись [left+5] сработает корректно и сдвинет каретку на 5 мм правее границы картинки. По состоянию на июнь 2026 года эта функция критически важна для точной обводки контура (Overscan).

Готовые решения: стартуем без программирования

Если вы пока не готовы писать макросы самостоятельно, создатели LaserGRBL выложили в открытый доступ пакеты предустановленных кнопок. Это отличная база для обучения.

Что нужно сделать:

1. Скачайте официальный файл с готовыми кнопками (обычно он идет в формате .zip или рядом с дистрибутивом программы).
2. Кликните правой кнопкой мыши по панели инструментов в LaserGRBL.
3. Выберите «Import», укажите путь к файлу и загрузите его.

Сразу после импорта вы получите рабочие кнопки для обводки контура, включения/выключения лазера и перемещений. Изучив их код (правый клик -> Edit), вы быстро поймете логику и создадите свои.

Заключение

Пользовательские кнопки — это «секретное оружие» опытных операторов LaserGRBL. Потратив 15 минут на их настройку, вы навсегда избавитесь от рутины и ускорите позиционирование в разы. Начните с импорта готового шаблона, а затем адаптируйте его под специфику вашего станка.

Данное руководство проверено и обновлено в июне 2026 года. Все упомянутые функции и переменные полностью работоспособны на актуальных сборках ПО.

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

Зачем вообще отключать автозапуск FortiClient? Не проще удалить приложение совсем?

Проще. Но, допустим, вас перевели в другой отдел, а там используют совсем другой VPN-клиент. Однако, удалять FortiClient вы не желаете, поскольку вас запросто могут перевести обратно, и вам очень не хочется заново проходить довольно непростую настройку FortiClient.

Чтобы всякий раз не выключать FortiClient вручную (от имени администратора), нужно всего-лишь отключить автозапуск.

Значит, придётся идти другим путём, и мы не побоимся его пройти.

Способ отключения автозапуска FortiClient, во всей красе и всего из пяти пунктов

Шаг 1. Щелкните правой кнопкой мыши значок FortiClient на панели задач и выберите Shutdown FortiClient (т.е. отключите его). 

Шаг 2. Перейдите в командную строку (под администратором), введите: net stop fortishield и прожмите ENTER.

net stop fortishield

Шаг 3. Прожмите горячие клавиши Win-R (запустится приложение «Выполнить»), введите в текстовое поле msconfig, прожмите ОК.

Откроется приложение «Конфигурация системы». В ней нужно перейти во вкладку Службы (Services), снять флажок на FortiClient Service Scheduler и прожать кнопку «Применить».

Шаг 4. Перейдите в Пуск и напишите там «Службы» (имеется в виду поиск). В результатах поиска вижу вот это.

Кликаю и открываю приложение «Службы».

В приложении найдите строку FortiClient Service Scheduler. Щелкните правой кнопкой мыши по данной строке, выберите пункт «Свойства», измените тип запуска на: «Ручной».

Шаг 5. Перезагрузите компьютер.

Всё. FortiClient перестал стартовать вместе с системой.

Как и говорилось выше, при попытке старта FortiClient вручную, он будет ругаться вот таким окном.

Если всё-таки нужно стартовать то вам достаточно повторить шаги 2 и 3.

Только в шаге 2 нужно использовать вот такую команду. Она запустит отключенную службу.

net start fortishield

А в шаге 3 не снимать флажок, а наоборот, проставить его обратно. И прожать «Применить».

Перезагрузка системы, в моём случае не потребовалась. FortiClient запустился без проблем. Вроде ничего сложного.

А с вами был Доктор Лексиум.
До новых постов.

В ходе написания автотеста мне время от времени нужно добывать селекторы из кода веб-страницы. Отличным инструментом для этого является дебагер (DevTools). Она-же — инструменты разработчика.

Это на редкость удобный инструмент, необходимый для веб-разработчика, но не только.

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

Дело в том, что если на выбранном варианте нажать левую кнопку мыши (ЛКМ), то нужный пункт выбирается, как и задумано авторами. Однако, при нажатии на правую кнопку (или на любое другое действие) модальное окно просто исчезало.

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

Как это сделать?

В интернете описано множество способов, но я для себя написал вот этот короткий скрипт.

document.addEventListener('keyup',function(event){if(event.key=='F9'){setTimeout(()=>{debugger;},3000);}});

Чтобы им воспользоваться, достаточно скопировать, перейти на нужный сайт, запустить панель отладки (F12), выбрать в ней вкладку Консоль.

В консоль вписать фразу «allow pasting» (естественно, без кавычек) и прожать Enter.

allow pasting

Иначе консоль ГуглоХрома откажется принимать вставку скрипта.

После этого вставьте код скрипта в консоль и прожмите Enter.

Теперь, будучи на странице сайта, прожимаем F9 и, в течение трёх секунд (пока на сработала пауза), нажимаем на тот элемент, который вызывает нужное модальное окно.

Там появится характерная плашка, через которую паузу можно будет снять.

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

Это не очень удобно, но вполне реально.

Ну а после снятия с паузы можно снова прожать F9, ткнуть уже в другой элемент (вызывающий очередную «исчезающую модалку»), снова дождаться паузы и найти искомые элементы.

Я проверил, у меня работает. Во всяком случае пока.

Если тебе был полезен этот пост, пожалуйста поддержи автора.

Ну а с вами был Доктор Лексиум.
До новых постов.

Как проверить?

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

• Во-первых, настройки теста меняют поведение браузера. Так что ручной запуск может быть неинформативным (хотя с этого я и начал).
• Во-вторых, ну сколько вкладок можно запустить таким образом. Две? Три? А если хочу сразу 10?

Я работаю из под Windows 10, а потому следующим этапом стало создание двух cmd-файлов.

Первый — запускает один автотест. Вот его примерный текст.

starter.cmd

cd C:\pyproject\
venv\Scripts\pytest.exe \tests\test_auth.py
pause

• Первая строка переходит в папку проекта.
• Вторая — запускает нужный мне автотест.
• Третья — ставит паузу, чтобы окно не захлопнулось сразу после окончания теста. Это на всякий случай.

Второй файл — запускает заданное количество экземпляров первого файла.

multistarter.cmd

cd C:\pyproject\
set x=0
:A
set /a x=%x%+1
start starter.cmd
if not %x%==10 goto :A

В первой строке мы переходим в папку проекта (где лежит starter.cmd). В последней — задано количество одновременно запущенных экземпляров starter.cmd

Всё. Теперь запускаю multistarter.cmd и наслаждаюсь процессом.

Вместо C:\pyproject\ можно указать путь к папке, где лежат оба ваши cmd-файла.
Вместо venv\Scripts\pytest.exe \tests\crowd_mos_ru\ideas\test_proverka_predlozhit_ideju.py — любую другую программу, которую нужно запустить в нескольких экземплярах.

Все экземпляры автотеста авторизовались и отработали без ошибок. Баг не подтвердился.
А что если один из автотестов использует логаут? Пошёл копать код в поисках подобной неприятности.

А с вами был Доктор Лексиум. До новых постов.

Превратить php-скрипт в xls легко.

<? //Генерация xls-файла
header ( "Expires: Mon, 1 Apr 1974 05:00:00 GMT" );
header ( "Last-Modified: " . gmdate("D,d M YH:i:s") . " GMT" );
header ( "Cache-Control: no-cache, must-revalidate" );
header ( "Pragma: no-cache" );
header ( "Content-type: application/vnd.ms-excel;charset=UTF-8;" );
header ( "Content-Disposition: attachment; filename=items_export.xls" );
?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//RU" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ru" lang="ru">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="author" content="none" />
<title>Demo</title>
</head>
<body>
<table><tr><th>Заголовок</th></tr><tr><td>Содержимое</td></tr></table>
</body>
</html>

По сути php файл прикинется файлом xls.

Осталось только передать ему ID нужных товаров. И вот в этом получается затык.

Есть ajax. С его помощью можно передать данные серверному скрипту и получить от него ответ. Однако с его помощью нельзя получить файл и открыть его в соседней вкладке. И тогда на помощь приходит костыль.

Создаём скрытую форму со скрытым текстовым полем. Прописываем в тэге form путь к php-скрипту и его открытие в соседней вкладке.

<form id="item_ids_form" method="POST" target="_blank" action="/php_scripts/xls/">
<textarea style="display:none;" id="item_ids_container" name="item_ids"></textarea>
</form>

Делаем js-скрипт, который при работе с выборкой (при снятии/простановке галочек) будет добавлять ID в textarea нашей скрытой формы (через запятую).

Создаём кнопку получения прайс-листа, по которой эта форма будет отправляться.

<p><button id="button_price">Получить прайс</button></p>

Раз кнопка вне формы (поскольку форма скрыта), то пропишем для неё обработчик на js.

$('#button_price').on('click', function(e){
e.preventDefault();
$("#item_ids_form").submit();
return false;
});

Получается, в html-форма умеет отправить данные на страницу, которая откроется в соседнюю вкладке.

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

Алгоритм прост:

1. Открываю сайт,
2. Авторизуюсь,
3. Перехожу на первую попавшуюся страницу,
4. В сайдбаре страницы открываю вертикальное выпадающее меню и кликаю на один из пунктов (берётся из массива),
5. На открывшихся страницах проверяю сайдбар на наличие меню, на возможность свернуть-развернуть, на всплывающие подсказки, на ширину и прочее-прочее.

И всё вроде было нормально, когда эти действия шли в обычном цикле for. Однако, у цикла был жирный минус, который всё портил.

Представь, что один из пунктов меню пропал. Или на одной из страниц сайдбар оказался битый. В этом месте цикла тест падал и остальные пункты меню уже не проверялись.

Было найдено более корректное решение — параметризованный тест. Массив такому тесту передаётся в виде параметра и тест запускается до тех пор, пока не пройдёт массив до конца.

Т.е. по сути это тот же цикл, но каждая итерация в нём — отдельный тест, с отдельным результатом выполнения. Таким образом я вижу в каких разделах сайта не всё в порядке с сайдбаром.

Вот кусок кода с примером.

items_text = ["текст 1", "текст 2", "текст 3"]
@allure.feature('Функциональное тестирование')
@pytest.mark.parametrize("item_text", items_text)
@allure.story("Общие функции сайдбара в разделе")
def test_sidebar_in(pages, item_text):
    page = SidebarElements(pages.browser)
    with allure_step(f"Шаг 5: Проверка сайдбара в разделе '{item_text}'"):
        print(f" Раздел: '{item_text}'")
        ................

Вот тут и появилась новая проблема. Дело в том, что параметры из массива PyTest отображает в отчёте. А поскольку пункты меню на русском, он заменяет кириллицу на эскейп-последовательности. Получаются совершенно неинформативные строки. И это раздражает всякий раз.

Слышал, что в PyTest 2.9 такой проблемы не было, но начиная с 3.0 — появилась.

Я кучу времени угрохал на то, чтобы найти решение. Баг известный, и достаточно давно, но в сети не попадалось ничего кроме стенаний пользователей. Решение нашёл мой коллега.

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

Как исправить отображение кириллицы в отчётах PyTest?

• В корень проекта кладём файлик pytest.ini
• В фале пишем вот такой текст:

[pytest]
disable_test_id_escaping_and_forfeit_all_rights_to_community_support = true

• Сохраняем.
• ??????
• PROFIT!

Вот так отчёт выглядит теперь.

Совсем другое дело. И в ходе выполнения теста текущие шаги тоже корректно отображают кириллицу.

Флаг «disable_test_id_escaping_and_forfeit_all_rights_to_community_support» экспериментальный, но работает уже несколько месяцев. Т.е. типа временный, но прижился вроде-как.

А с вами был Доктор Лексиум.
До новых постов.))

Т.е. кто-то навёл мышку на начало заголовка, зажал правую кнопку, дотянул до конца заголовка, и отпустил. А теперь, нужно это дело повторить, чтобы убедиться, что текст можно выделить.

Я потратил несколько часов, чтобы реализовать данный шаг. Чего только не делал. В итоге, получилась вот такая функция, на базе запуска js.

def select_string_by_css(self, css_selector):
    script1 = f"var rttt = document.createRange();" \
              f"rttt.selectNode(document.querySelector('{css_selector}'));" \
              f"document.getSelection().removeAllRanges();" \
              f"document.getSelection().addRange(rttt);"
    script2 = f"return document.getSelection().toString();"
    self.browser.driver.execute_script(script1)
    return str(self.browser.driver.execute_script(script2)).split("\n")[0]

Функция принимает на вход css-селектор элемента, где находится заголовок, а возвращает содержимое выделения.

В ходе тестов выяснилось, что на выход иногда попадают переносы строк и даже какие-то фрагменты текста из соседних областей. Пришлось обрезать по значку переноса строк.

Код выкладываю как есть. Поскольку функция является методом класса, там присутствует self.
self.browser.driver — это объект Webdriver.

А вот и сам js. Вытащил его с какого-то сайта и добавил чуть-чуть отсебятины.

var rttt = document.createRange();
var css_selector = "h1";
rttt.selectNode(document.querySelector('{css_selector}'));
document.getSelection().removeAllRanges();
document.getSelection().addRange(rttt);
var result = document.getSelection().toString();

Таким образом, селектор будет в переменной css_selector, а результат (в нашем случае — выделенный текст) — в переменной result.

Оставляю здесь, чтобы снова не искать долго-долго-долго.

С вами был Доктор Лексиум.
Всего доброго.

Если ты рядовой пользователь, который ходит в интернет что-нибудь почитать или посмотреть, то тебе это не нужно от слова «почти совсем». Однако, ситуации бывают разные. Например, ты хочешь разделить работу и отдых.

Т.е. в одном браузере у тебя открыт Гугл, где ты авторизован под неким логином. Там у тебя открыты определённые вкладки и стоят какие-то плагины.

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

Теперь давай рассмотрим, Как одновременно открыть несколько браузеров Яндекс с разными профилями под Windows?

1. Для начала, понадобится скачать и установить Яндекс.Браузер.

Для этого нужно открыть yandex.ru и написать там «яндекс браузер скачать», перейти по полученной ссылке и.. Ну ты понимаешь.

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

2. Создаём папки для профилей. Их будет два: job и rest.

Тут тоже всё просто. Переходим на диск C: и создаём там папку Browsers. Открываем её и уже в ней создаём папки job и rest.

3. Делаем копию ярлыка Yandex на рабочем столе.

Для этого клацаем по нему правой кнопкой мыши. В контекстном меню (которое выпало при клике) выбираем «Копировать».

Потом, клацаем правой кнопкой мыши на пустом месте рабочего стола и в контекстном меню жмём «Вставить».

Если всё сделано правильно, у нас появится копия этого ярлыка. Переименуйте его в Job. Повторите процедуру и новую копию переименуйте в Rest.

4. Вносим изменения в ярлык.

Кликаем правой кнопкой мыши по ярлыку Job и в выпадающем меню выбираем «Свойства».

В появившемся окне нас интересует поле «Объект». 

Кликаем по полю, переходим в конец строки и (через пробел) добавляем туда вот это:

--user-data-dir="C:\Browsers\job"

Жмём кнопку «Применить». Ярлык готов.

Кликаем по нему, выполняем требования браузера и вот рабочая версия готова.

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

--user-data-dir="C:\Browsers\rest"

В нашем случае, это папка rest (которую мы создали в шаге 2).

Ничего сложного. Теперь, кликнув сначала на один ярлык, а затем на другой мы одновременно открываем несколько браузеров Яндекс с разными профилями.

А на этом всё.

(UPDATE 04.05.2022): Как выяснилось немного позднее, яндекс-браузер умеет переписывать ярлыки. Не спрашивай зачем. Поэтому, перед тем как сохранить ярлык (или открыв его свойства), следует проставить галочку в чекбоксе «Только чтение» во вкладке «Общие».

Это должно помочь.

Если этот пост был полезен, буду рад вашему пожертвованию на печеньки к чаю.

А с вами был Доктор Лексиум.
Всего доброго.