Skip to Content

Changes for page Notes for TTN

Last modified by Xiaoling on 2025/08/04 14:58
From version 202.1
edited by Bei Jinggeng
on 2023/03/15 18:03
Change comment: There is no comment for this version
To version 201.1
edited by Edwin Chen
on 2023/03/15 16:07
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Bei
1 +XWiki.Edwin
Content
... ... @@ -807,102 +807,4 @@
807 807  
808 808  **For TTS in LPS8v2**
809 809  
810 -Open your application and click the button **Import end devices**
811 -
812 -[[image:https://www.thethingsindustries.com/docs/getting-started/migrating/import-end-devices.png||alt="import devices" height="517" width="828"]]
813 -
814 -Select the **File format** and upload the file (e.g. or ).devices/jsondevices.csv
815 -
816 -You can specify **Fallback values** for Frequency plan and LoRaWAN and Regional Parameters version, in case the import file does not specify these settings for the device.
817 -
818 -You can also expand the **Advanced claiming and component settings** to set targeted components, and set the claim authentication code to be generated.
819 -
820 -Start the import by clicking the **Import end devices** button.
821 -
822 -[[image:https://www.thethingsindustries.com/docs/getting-started/migrating/upload-file.png||alt="upload devices.json file" height="536" width="858"]]
823 -
824 -Wait for the end devices to be successfully imported. In case any device fails, you will see a relevant error message in the console.
825 -
826 -[[image:https://www.thethingsindustries.com/docs/getting-started/migrating/operation-finished.png||alt="import finished" height="551" width="882"]]
827 -
828 -If the import was successful, your devices are added to the list of end devices in your application.
829 -
830 -[[image:https://www.thethingsindustries.com/docs/getting-started/migrating/successful-import.png||alt="successful-import" height="556" width="889"]]
831 -
832 -Devices are now registered on The Things Stack.
833 -
834 -= JSON File Reference =
835 -
836 -The Things Stack allows you to import end devices from V2, ChirpStack and other LoRaWAN networks using a JSON file describing those devices.
837 -
838 -Using JSON file with device descriptions, you can migrate end devices with or without their existing sessions.
839 -
840 -Here is an example of an OTAA device description in the file:devices.json
841 -
842 -{{{{
843 - "ids": {
844 - "device_id": "my-device",
845 - "dev_eui": "0102030405060708",
846 - "join_eui": "0102030405060708"
847 - },
848 - "name": "My Device",
849 - "description": "Living room temperature sensor",
850 - "lorawan_version": "MAC_V1_0_2",
851 - "lorawan_phy_version": "PHY_V1_0_2_REV_B",
852 - "frequency_plan_id": "EU_863_870_TTN",
853 - "supports_join": true,
854 - "root_keys": {
855 - "app_key": {
856 - "key": "01020304050607080102030405060708"
857 - }
858 - }
859 -}
860 -}}}
861 -
862 -Multiple end devices can also be contained in a single file like so:devices.json
863 -
864 -{{{{
865 - /* device 1 */
866 -}
867 -{
868 - /* device 2 */
869 -}
870 -}}}
871 -
872 -The format above is considered by the Console and CLI as a JSON stream, processing one object at a time. For more details in how to use the file
873 -
874 -
875 -= CSV File Reference =
876 -
877 -The Things Stack has support for importing end devices from CSV (comma-separated values) files. This is useful when batches of end devices are managed in Microsoft Excel or any other spreadsheet or database that can export to CSV file.
878 -
879 -The CSV import in The Things Stack uses the following settings:
880 -
881 -* Semicolon () as field delimiter. This makes working with Microsoft Excel and other spreadsheets convenient;
882 -* Header row is required
883 -* On each row, the same number of fields as on the header line
884 -* Use quotes to use in a field value;
885 -* Use double quotes to escape quotes
886 -* Unknown header columns are permitted and ignored
887 -
888 -== Example ==
889 -
890 -Minimal example:
891 -
892 -{{{dev_eui;join_eui;frequency_plan_id;lorawan_version;lorawan_phy_version;app_key
893 -1111111111111111;1111111111111111;EU_863_870_TTN;MAC_V1_0_4;RP002_V1_0_3;11111111111111111111111111111111
894 -2222222222222222;2222222222222222;EU_863_870_TTN;MAC_V1_0_4;RP002_V1_0_3;22222222222222222222222222222222
895 -3333333333333333;3333333333333333;EU_863_870_TTN;MAC_V1_0_4;RP002_V1_0_3;33333333333333333333333333333333
896 -}}}
897 -
898 -All columns for a LoRaWAN 1.0.4 device:
899 -
900 -{{{id;dev_eui;join_eui;name;frequency_plan_id;lorawan_version;lorawan_phy_version;brand_id;model_id;hardware_version;firmware_version;band_id;app_key
901 -test-one;1111111111111111;1111111111111111;Device 1;EU_863_870_TTN;MAC_V1_0_4;RP002_V1_0_3;the-things-industries;generic-node-sensor-edition;1.0.4;1.0;EU_863_870;11111111111111111111111111111111
902 -test-two;2222222222222222;2222222222222222;Device 2;EU_863_870_TTN;MAC_V1_0_4;RP002_V1_0_3;the-things-industries;generic-node-sensor-edition;1.0.4;1.0;EU_863_870;22222222222222222222222222222222
903 -test-three;3333333333333333;3333333333333333;Device 3;EU_863_870_TTN;MAC_V1_0_4;RP002_V1_0_3;the-things-industries;generic-node-sensor-edition;1.0.4;1.0;EU_863_870;33333333333333333333333333333333
904 -}}}
905 -
906 -== Excel Template ==
907 -
908 -[[Download the Excel template>>url:https://www.thethingsindustries.com/docs/getting-started/migrating/tts-end-devices-csv-template.xlsx]]. You can remove all columns that are not required (see above).
810 +