EZF Wiki/Data and USB
Article · EN

Import a luminaire list from CSV

Prepare and validate a list for AirBUS, BUS1 or BUS2, then import it over USB.

ON THE DISPLAY · STEP BY STEP

Import luminaires from USB

480 × 320 display screens in the selected language. The yellow outline marks where to tap. Illustrated data is for demonstration.

Display interface
Before you start

Export the existing list first. Validate the new CSV and copy it to the USB root directory using the filename for the selected channel. Import changes luminaire data.

  1. EZF480 × 320 · Classic
    Step 1: Press MENU
    1Step 1 / 6

    Press MENU

    On the home screen, tap MENU in the upper right. If prompted for a PIN, sign in with an authorised account. Controller access codes →

  2. EZF480 × 320 · Classic
    Step 2: Open the second menu page
    2Step 2 / 6

    Open the second menu page

    Tap the right arrow in the top bar. USB is on the second menu page.

  3. EZF480 × 320 · Classic
    Step 3: Open USB
    3Step 3 / 6

    Open USB

    Tap the USB tile in the lower right.

  4. EZF480 × 320 · Classic
    Step 4: Tap “Imp. lumin.”
    4Step 4 / 6

    Tap “Imp. lumin.”

    Choose luminaire import. Accidentally selecting export could replace the prepared file with data from the controller.

  5. EZF480 × 320 · Classic
    Step 5: Choose the luminaire channel · Wireless / AirBUS
    5Step 5 / 6

    Choose the luminaire channel · Wireless / AirBUS

    Wireless means AirBUS. Choose the channel matching the file and installation. The USB operation starts after selecting the channel.

  6. EZF480 × 320 · Classic
    Step 6: AirBUS: file read — interface limitation
    6Step 6 / 6

    AirBUS: file read — interface limitation

    This confirms the file was read, not that data was applied. In the checked version, no active OK control appears after a successful read to continue importing. Overwriting cannot be confirmed here; the controller software needs a fix.

Finish and verify

BUS1/BUS2: wait for completion and check count, addresses, names, groups and communication. AirBUS: a CSV-read message does not mean import is complete; the next step is unavailable from the display in the checked version. Do not treat it as a successful data update.

Other USB walkthroughsExport luminaires to USB →Export test group assignments →Export a selected test report →Export the event log →

Screen by screen: import luminaires

Open the guide with screens and highlighted buttons.

  1. Prepare the file and copy it to the USB drive's root directory. Connect the drive to the controller.
  2. Press the Menu icon at the top right of the home screen. If the PIN keypad appears, sign in with your own code. Controller access codes →
  3. On menu page 1, press the right arrow in the top toolbar. On page 2, choose USB, the bottom-right tile.
  4. In the USB menu, choose Imp. lumin., the middle tile in the top row.
  5. Under Select channel, press Wireless for AirBUS or BUS1 / BUS2 for a wired channel. Selecting the channel starts reading the file.
  6. For AirBUS, wait for the file to be read. File read, everything OK! confirms reading only. In the described version, this success screen provides no button to continue and apply the data. This message does not confirm a completed import. Use the back arrow to leave. Full AirBUS import from the display requires a corrected software version. Do not press invisible areas of the screen.
  7. For BUS1/BUS2, data is applied during the USB operation; the second AirBUS confirmation is not used. Wait for BUS import complete. An error or cancellation does not mean the whole import succeeded.
  8. Check the luminaire list and communication. Remove USB only after the operation finishes.

Prepare the file

Open the CSV generator and validator. Select the destination channel: AirBUS, BUS1 or BUS2. Enter the HEX address, test group, name/location, luminaire type and bright/dark mode. Add luminaires, generate the CSV and validate it.

File format

UTF-8 text, semicolon separator, no header. Each row has exactly five fields: HEX address;group;name;type;mode. Do not use CSV quoting or semicolons in names.

01A2;A;Corridor 01;AW;1
01A3;B;Exit 01;PIKTO;0
01A4;A;Room 01;KOMBI;1
Field Accepted values
Address HEX 0002–FFFE, without 0x; 0010 means decimal 16
Group AirBUS: A–D; BUS: A/B, also 1/2
Name For reliable transfer, use 1–16 ASCII characters, e.g. Corridor 01
Emergency luminaire / Sicherheitsleuchte AW, also S or E
Exit sign luminaire / Rettungszeichenleuchte PIKTO, also R or P
Combined luminaire / Kombileuchte KOMBI, also K or C
NVG NVG, BUS importer only
Mode 1 = bright, 0 = dark; BUS also accepts ? = unchanged

The current AirBUS importer rejects NVG, although the exporter can write this type. Validate exported files before importing them again. The generator blocks this combination and does not replace NVG with another type.

BUS also accepts UNKNOWN/U and picture numbers 0–7. Preserve these only when they come from a known exported configuration. The generator offers the four named luminaire types.

Import into the controller

  1. Export the existing list and keep it as a backup.
  2. Download lamps.csv for AirBUS, lamps_BUS1.csv for BUS1 or lamps_BUS2.csv for BUS2.
  3. Copy the file to the root directory of a FAT32 or exFAT USB drive, not a subfolder.
  4. Connect the drive to the controller, open luminaire import and select the correct channel. Wait for completion.
  5. Check the count, addresses, groups, names, operating modes and communication.

AirBUS supports up to 500 rows; BUS up to 200 per channel. The controller licence may impose a lower limit. BUS can fall back to lamps.csv if its channel file is missing; use channel-specific filenames for clarity.

What validation covers

Validation checks field counts and contents, address range and duplicates, groups, types, name length and mode. It uses a stricter profile than some tolerant importer functions to avoid silent truncation or changes.

A valid format does not guarantee a successful import: available capacity/licensing and communication with BUS luminaires are also required. Import may stop after some changes have already been applied. Do not disconnect USB during the operation. CSV does not program the physical device address or the rated duration of 1/3/8 h.

EZF Wiki · Wiedza pod ręką.