Генератор QR-кода Wi-Fi

Что на самом деле содержит строка WIFI:

Полезная нагрузка — это одна строка текста с префиксом и полями через точку с запятой, закрытая двумя точками с запятой. Типичная выглядит так: WIFI:T:WPA;S:Cafe-Guest;P:flatwhite2019;; — и это всё целиком. Это не URL, и в сети он никуда не ведёт.

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

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

• T: — тип защиты, один из WPA, WEP или nopass
• S: — SSID ровно в том виде, в каком его вещает роутер, включая заглавные буквы
• P: — парольная фраза, полностью опускается при типе nopass
• H: — true только тогда, когда сеть скрытая
• Экранируются: обратная косая черта, точка с запятой, запятая, двоеточие и двойная кавычка

Какие телефоны подключаются, ничего не устанавливая

iOS читает коды WIFI: штатным приложением «Камера» начиная с iOS 11, а Android — начиная с версии 10. На более старой сборке Android камера покажет сырой текст WIFI:… или вообще ничего, и гостю понадобится приложение-сканер, реализующее этот формат. Это самая частая причина, по которой Wi-Fi-код кажется нерабочим.

Отдельного токена для WPA3 нет. Используйте WPA — код работает и на WPA2, и на WPA3, и на смешанных сетях переходного режима, потому что телефон выбирает рукопожатие, уже увидев сеть. Некоторые инструменты выдают T:SAE для сетей только с WPA3; парсеры, не знающие SAE, отказывают молча, поэтому здесь такого варианта нет.

Скрытой сети нужен H:true. Без этого флага телефон ищет в эфире подходящий SSID, ничего не находит и сдаётся без внятной ошибки. Ставьте галочку всегда, когда на роутере отключено вещание SSID.

Как напечатать карточку сети, которая продолжит работать

Полезная нагрузка Wi-Fi короткая, поэтому символ остаётся небольшим. Приведённый выше пример — 41 байт, что на уровне Q укладывается в символ версии 4 из 33 на 33 модуля. При печати шириной 30 мм вместе со свободной зоной это примерно 0,7 мм на модуль — с запасом внутри того, что камера телефона различает через стол.

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

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