When you define a Bulk Registration, you need to upload a CSV (comma separated variable) file which includes information about each device, 1 device per line:
- Registration key
- Hardware ID
- Device Name
- Optional metadata (Category columns) for each device
Download the Registration Template file by clicking on the indicated button on the Registrations page.
- The Registration Template file is shown below. There are 13 columns defined in the CSV, each with its own column heading in row 1 and a sample value in row 2. Open the file in Microsoft Excel. You can also use a raw text editor, although it will not organize the information in nice rows and columns and you should remember to always "Save as" file type CSV.
Text editor view
Edit the CSV starting in row 2 to add the information for the devices you will be bulk registering. Do not make any edits to row 1 (column headings) and always save this file as type "CSV" or it will not be recognized by the remote.it system.
Column A contains the REGISTRATION_KEY for the device being registered. In the sample CSV we are using a dummy ethernet MAC address (00:F1:23:45:67:89) representing the device eth0 interface with the colons removed. The values in column A are case sensitive and must be 12-digits, no colons, spaces, or other special characters. The valid characters for REGISTRATION_KEY are a-z, A-Z, and 0-9. Use leading zeros (or any valid character) if the REGISTRATION_KEY used in your application is fewer than 12-digits. The REGISTRATION_KEY value cannot be left blank. The REGISTRATION_KEY does not need to be unique across devices or accounts. For example, the same REGISTRATION_KEY could be used to Bulk Register any number of devices.
Column B contains the HARDWARE_ID field for the device being registered. In this example we are using a dummy Wi-Fi MAC address (AA:98:76:54:32:10) from the device wlan0 interface with the colons removed. The values in Column B are case sensitive and must be 12-digits, no colons, spaces, or other special characters. The valid characters for HARDWARE_ID are a-z, A-Z, and 0-9. Use leading zeros (or any valid character) if the HARDWARE_ID used in your application is fewer than 12-digits. The values entered in Column B must be unique in the remote.it system. The HARDWARE_ID value cannot be left blank and must be a value that the device can access on its own when booting in the field (such as an interface MAC address or serial number stored in ROM).
Column C contains the DEVICE_NAME value. In this example we are using the arbitrary device name "My_Device_001" The DEVICE_NAME field can contain the following characters: a-z, A-Z, 0-9, and -_ and " " (space, no quotes). No other special characters are supported in the DEVICE_NAME field. The DEVICE_NAME value cannot be left blank and must be unique across all devices in a single remote.it account.
Columns D-M are required in the CSV. Any values in the CSV columns D-M are used to populate the Category A-J columns (respectively) in the remote.it portal. By default only the first three Category columns (Category A-C) are displayed in the remote.it portal. The CSV file columns D-M may be left blank or they may contain a value with characters a-z, A-Z, 0-9, " " (space, no quotes), or - _ .