These instructions will cover converting existing TTN Gemtek/Browan IoT Femto gateways to the myDevices Azure Chirpstack Network Server. They are valid for the following gateway models:

...

Gemtek IoT Femto Gateway

...

Tektelic Kona Micro Gateway

...

You will need a Terminal Emulator application in order to enter command-line commands while following this document. Examples will be provided here for Terminal.app (Mac OS) and Powershell (Windows).

Gather necessary files and information

...

where abcd0000fffff0001 is the 16-digit gateway EUI. These files are generated on the myDevices Azure server and will be provided by myDevices Support. Let us know the Gateway EUI for any TTN gateways you want to convert in the ticket you open.

Determine Gateway local IP address and connect via WiFi

For Tektelic and Multitech modelsGemtek model:

You’ll need the local IP address for each gateway plugged into your network via Ethernet cable for updating. Check with your Network Administrator if you need help determining the local IP Address for a device plugged into your local network.

For Gemtek model:

You’ll need While the gateway must be plugged into Ethernet for internet connectivity, you’ll need to connect to this gateway via WiFi and not Ethernet cableas well to remotely access it. Steps 1-4 in this article show how to do that. You don’t need to login, just make sure you can connect to it’s WiFi and make sure that page 192.168.55.1 loads in a browser. That IP, 192.168.55.1, will be used for SSH connection whenever needed in this document.

SSH login credentials for your gateway

...

gateway

...

Gateway Model	SSH Username	SSH Password
Gemtek	root	mydevices@WXYZ where WXYZ is the last 4 characters of the MAC. The MAC is printed on the gateway and uppercase should be used for any letters. example: For a gateway with MAC 5814D31BE7E9 the password would be mydevices@E7E9
Tektelic	root	Gateway Serial Number (printed on the gateway) example: Image Removed
Multitech	admin	admin

(install packages first, so the cert directories will exist when you try to copy to them)

(chmod 777 for the Multitech directory so you can write to it)

...

Connect to Gateway via SSH:

1. Open Windows Powershell to get a command prompt

2. Type ssh root@192.168.55.1 and press [Enter]. You may get an warning message like this:
   

   Image Added

   
   If you do, type yes then press [Enter]

3. When prompted, enter the SSH password and press [Enter]. With a correct password, you should see this screen indicating you’re logged in:

   Image Added

Install DPS Client and Chirpstack Bridge

1. First, enter the following command on the command prompt to download the DPS Client/Chirpstack Bridge combined package:
   
   wget --no-check-certificate https://hwdartifacts.blob.core.windows.net/hwdassets/gateway-bridge-dps_1.3.8-r0_ramips_24kec.ipk and press [Enter]
   

2. When the download completes, enter the following command to install the combined package:
   
   opkg install gateway-bridge-dps_1.3.8-r0_ramips_24kec.ipk and press [Enter]
   
   When the installation is finished it will return you to a command prompt:
   

   Image Added

Copy Certificate files to gateway

Both certificate files must be placed specifically in a specific directory per model:

...

Multitech: /var/config/app/mydevices/

...

Tektelic: /var/config/mydevices/

...

the directory /mnt/data/app/azureiot/

...

which was created in the last section. This can be accomplished with the following commands, you’ll

1. Type exit and press [Enter] to disconnect from the Gemtek gateway and return to your local PC’s command prompt:
   

   Image Added

2. If necessary, use the cd command to navigate to the directory where you downloaded the .pem files provided from myDevices Support. For example, cd Downloads to switch to your Downloads folder.
   

3. Enter the following commands, one at a time. You’ll need to know your

...

1. SSH password from above

...

1. to enter it when prompted.
   
   scp abcd0000fffff0001.cert.pem

...

1. root@192.168.55.1:/mnt/data/app/azureiot/ (then press [Enter])
   
   scp abcd0000fffff0001.key.pem

...

(chmod 444 the MT directory so its just read read read per instructions)

Change global_conf.json to localhost

(on multitech, easiest through web interface)

...

1. root@192.168.55.1:/mnt/data/app/azureiot/ (then press [Enter])

Set Certificate Folder Permissions and reboot

1. Connect to the gateway via SSH again following the Connect to Gateway via SSH section above

2. Once connected, enter chmod 444 /mnt/data/app/azureiot/ and press [Enter] to set the correct folder permissions. If it was successful there will be no messages, just a return to the command prompt:
   

   Image Added

3. Finally, enter reboot and press [Enter] to reboot the gateway. This will end your SSH session automatically

Verify things are working

After the gateway is rebooted and back online in the myDevices web dashboard (look for a current timestamp), you can verify it is on Azure by either:

Connecting a known Azure-only sensor to it and seeing data on the dashboard
-or-
Contact myDevices Support and we can verify that the gateway is communicating on Azure OK.