"Маппинг" - это возможность программного изменения порядка расположения отдельных светодиодов в ленте. Обычно все светодиоды в ленте соединены последовательно (через линию данных): 1->2->3->4->.... Для некоторых спецэффектов или, особенно, для 2D-матриц часто требуется изменить порядок, не припаивая всю ленту по-другому. Например, можно добиться того, чтобы после каждых 3 светодиодов порядок их расположения менялся на противоположный, также с помощью мэппинга, как если бы логический порядок расположения светодиодов на ленте был таким: 1->2->3->6->5->4 ->7 ->8 ->9 ->12 ->11 ->10 и т.д.
Настройка отображения осуществляется через JSON-файл, который должен иметь имя ledmap.json. Также необходимо подготовить специальный файл в формате JSON. Для приведенного выше примера содержимое этого файла будет выглядеть следующим образом: {"map":[0,1,2,5,4,3,6,7,8,11,10,9]}. Обратите внимание, что светодиоды нумеруются, начиная с 0. Также следует избегать использования лишних пробелов. Отдельные позиции светодиодов можно опустить, указав вместо них -1.
Можно также задать несколько карт. Для каждой карты используется отдельный файл ledmapX.json, где X - номер (1, 2 и т.д.). Какая именно карта будет использоваться, можно указать в пресете с помощью команды "ledmap":X,..., где X - номер карты в JSON-файле. В простейшем случае содержимое пресета (команды API) выглядит следующим образом: {"on":true,"ledmap":1}. Файл ledmap.json (даже без номера), с другой стороны, применяется не через пресет, а всегда автоматически при запуске контроллера.
.
Созданный файл ledmap.json (или файлы ledmapX.json) необходимо загрузить в контроллер WLED. Для этого откройте в браузере адрес http://YourWLEDIP/edit, где YourWLEDIP - IP-адрес Вашего контроллера WLED. Это инструмент для редактирования конфигурационных файлов контроллера WLED. Для корректного отображения этой страницы контроллер должен быть подключен к Интернету, а также уже интегрирован в сеть WLAN и больше не быть "только" доступным в качестве WLED-AP. Вы также можете создать JSON-файлы непосредственно здесь. Для того чтобы созданный или загруженный файл ledmap.json был применен, необходимо перезагрузить контроллер.