Set Up and Claim Your Cubicore Gateway¶
Connect your preconfigured Cubicore Gateway or claim it to your own The Things Network account.
Product status: Confirm the current product status and supported features in the applicable product documentation before deploying in production.
Claiming is optional
You do not need to claim the gateway to use it. If you only want to start using the gateway, follow the Wi-Fi setup instructions in Getting Started: Cubicore Gateway Series.
Overview¶
The Cubicore Gateway Hub and Cubicore Gateway Pocket are dual-channel LoRaWAN-compatible gateways containing two internal one-channel gateway devices. Each internal channel has its own Gateway EUI, so every physical gateway has two Gateway EUIs but only one claim code.
Cubicore Gateway Series devices are shipped preconfigured to work with The Things Network by default, using the recommended Philippine LoRaWAN settings.
After you provision both gateway channels to Wi-Fi, the gateway is ready to forward LoRaWAN packets. You normally do not need to configure the gateway manually in a LoRaWAN network server.
You still need a TTN account to create applications, register end devices, configure your LoRaWAN deployment, and view incoming data.
Claiming the gateway is optional. You can either continue using the preconfigured Cubicore gateway setup or claim the gateway so that your TTN account becomes an administrator collaborator.
Create a The Things Network account — a TTN account is required whether or not you claim the gateway.
Create a TTN account¶
A The Things Network (TTN) account is required whether or not you claim the Cubicore gateway. You will use your account to create applications, register end devices, view gateway activity, and access incoming application data.
- Visit The Things Network.
- Select Sign up or Create account.
- Complete the account registration.
- Sign in to the TTN Console.
- Find the TTN User ID in the user profile.
A TTN account is still required
Claiming the gateway is optional, but you still need a TTN account to create and manage your LoRaWAN applications and end devices.
Onboarding options¶
There are two ways to use your Cubicore Gateway:
Option A: Use the preconfigured Cubicore setup¶
Choose this option if you want to start using the gateway without managing its gateway registration directly from your own TTN account.
The gateway is already configured to work with TTN by default. You only need to create your TTN application and end devices, provision both gateway channels to Wi-Fi, and configure your LoRaWAN end devices with compatible settings.
The gateway's registration in TTN is separate from your TTN applications and end devices. Your applications and end devices belong to your TTN account, while the gateway registration is managed by Cubicore.
In the TTN Console, use the Add menu to create an application and register an end device.
- Create or sign in to a TTN account.
- Create a TTN application and register the end device.
- Provision both internal gateway channels to Wi-Fi.
- Follow the existing Getting Started: Cubicore Gateway Series guide for Wi-Fi provisioning via BLE.
- Configure compatible LoRaWAN end-device settings.
- Check the end-device data in the TTN Console.
The recommended Philippine configuration is AS923 Group 3, 916.6 MHz / 916.8 MHz, SF10 / BW125, with ADR and dwell time disabled.
BLE is used only for Wi-Fi setup
The ESP BLE Provisioning app uses Bluetooth Low Energy to configure the gateway's Wi-Fi connection. After provisioning, the gateway uses Wi-Fi to connect to the network server. BLE is not the gateway's LoRaWAN backhaul.
Application data and network metadata
Your sensor or application payload is protected by LoRaWAN encryption. However, technical metadata such as gateway status, timestamps, radio statistics, and device identifiers may still be visible to the network infrastructure operator.
Option B: Claim the gateway to your TTN account¶
Choose this option if you want your own The Things Network account to manage the gateway.
Claiming adds your TTN account as an administrator collaborator for the gateway. Cubicore remains an administrator by default, but you may remove Cubicore's access later if you prefer to manage the gateway independently.
Claiming does not interrupt operation
Claiming is an account-access and administration step. It does not update the firmware, change the Wi-Fi settings, modify the LoRaWAN frequency settings, or interrupt packet forwarding.
Before you begin¶
Have the following information ready:
You can find your TTN User ID in the Profile settings page of the TTN Console.
| Requirement | Details |
|---|---|
| Email address | Where Cubicore can contact you about the claim |
| TTN User ID | Your The Things Network User ID, exactly as it appears in your TTN profile |
| Gateway claim code | The 16-character claim code printed on the device label |
The claim code is printed on the serial label underneath the gateway. The same label also contains the device serial number and both Gateway EUIs.
The serial label shows both Gateway EUIs, the serial number, and the QR claim code.
Gateway EUIs are for verification
You do not need to type the Gateway EUIs into the claim form. Each claim code is already associated with both Gateway EUIs. You may compare the EUIs on the label with the EUIs shown in TTN after claiming to verify that the correct gateway was onboarded.
The gateway does not need to be online
The claim request is processed through the claim portal. The physical gateway does not need to be powered on or connected to Wi-Fi while you submit the claim.
Claiming procedure¶
Step 1: Open the claim portal¶
Open the Cubicore Gateway Claim Portal in a web browser:
The Cubicore Gateway Claim Portal collects your email, TTN User ID, and the gateway claim code.
The portal is used to associate your TTN User ID with the two Gateway EUIs assigned to the physical gateway.
Step 2: Enter your email address¶
Enter an email address where Cubicore can contact you about the claim request.
Email verification
Email verification is not required to complete the claim process.
Step 3: Enter your TTN User ID¶
Enter your The Things Network User ID exactly as it appears in your TTN profile.
Use your TTN User ID
Enter your TTN User ID, not your email address, TTN password, gateway serial number, or Gateway EUI.
You can find your TTN User ID in your TTN profile.
Step 4: Enter or scan the claim code¶
Enter the 16-character claim code printed on the gateway label. You can type the code manually or select Scan code to scan the QR code on the label.
One claim code is associated with both Gateway EUIs inside the physical gateway. You do not need to submit two separate claims.
The claim code and QR code are printed on the device label. Keep the label secure.
Keep your claim code secure
Your claim code is a private onboarding credential. Do not share it publicly, post a photo of the device label online, or send it to an unauthorized person.
Anyone with access to the claim code may be able to submit a claim request for the gateway. Keep the original label secure and email support@cubicore.io if the code has been exposed, lost, or appears to have been used.
- Enter the code exactly as printed.
- Do not add spaces.
- Be careful with similar characters such as
0andO, or1andI. - The claim code is normally intended for one-time use.
Step 5: Submit the registration¶
Select Submit registration.
The portal validates the claim code and associates your TTN User ID with both Gateway EUIs assigned to the gateway.
One code claims both gateway channels
A Cubicore Gateway contains two one-channel gateway devices and therefore has two Gateway EUIs. One claim code is used to onboard both EUIs.
Step 6: Wait for completion¶
The claim normally completes within 1–2 minutes. The gateway does not need to be powered on while the claim is being processed.
After waiting, continue to Verify the gateway in TTN.
Processing time
Most claims complete within 1–2 minutes. If the gateway does not appear after several minutes, refresh the TTN Console and follow the troubleshooting steps below.
What claiming changes¶
After a successful claim, your TTN account is added as an administrator collaborator for the gateway. Cubicore remains an administrator by default.
The gateway continues operating normally. Claiming does not modify the gateway hardware, firmware, Wi-Fi configuration, LoRaWAN channel settings, or packet-forwarding behavior.
- Your TTN account can manage the gateway.
- Both Gateway EUIs are associated with the claimed gateway.
- Cubicore remains an administrator by default.
- You may remove Cubicore's access from your TTN account.
- You may delete the gateway and configure it independently if desired.
- No additional physical setup is required after claiming.
- The gateway continues operating while the claim is processed.
Cubicore access remains by default
Cubicore remains an administrator collaborator after a successful claim so that support can continue when needed. You may remove Cubicore's access if you prefer to manage the gateway independently.
Verify the gateway in TTN¶
Confirm the gateway is connected and online in the TTN Console.
- Sign in to your The Things Network account.
- Open the TTN Console.
- Select the appropriate TTN region or cluster, if requested.
- Open the gateway list.
- Find the claimed Cubicore gateway.
- Confirm that both Gateway EUIs are present.
- Confirm that your TTN User ID is listed as an administrator collaborator.
- Confirm that Cubicore remains listed as an administrator, unless you have removed Cubicore's access.
- Check the gateway connection or activity status.
- Test the gateway with a compatible LoRaWAN end device.
To verify that the gateway is receiving LoRaWAN traffic, use a properly configured end device. The gateway must have Wi-Fi internet access, and the end device must use compatible Philippine LoRaWAN settings.
Use the EUIs as a sanity check
The Gateway EUIs are not required during claim form submission. They are useful after claiming to confirm that the two gateway channels shown in TTN match the two EUIs printed on the device label.
Recommended end-device settings¶
To exchange packets successfully, the end device must use LoRaWAN settings compatible with the gateway and the Philippine deployment requirements.
| Setting | Recommended value |
|---|---|
| Region | AS923 Group 3 |
| Frequency 1 | 916.6 MHz |
| Frequency 2 | 916.8 MHz |
| Data rate | DR2 |
| Spreading factor | SF10 |
| Bandwidth | 125 kHz |
| ADR | Disabled |
| Dwell time | Disabled |
For full Wi-Fi provisioning and configuration details, see Getting Started: Cubicore Gateway Series.
Troubleshooting¶
| Symptom | Recommended action |
|---|---|
| The claim code is rejected | Scan the QR code or carefully re-enter the code. Contact support@cubicore.io if the issue continues. |
| The TTN User ID is rejected | Copy the exact TTN User ID from the TTN profile. |
| The wrong TTN User ID was submitted | Contact support@cubicore.io. Cubicore will advise on the reclaim process. |
| The gateway does not appear in TTN | Wait a few minutes, refresh TTN, and check again. |
| The gateway is not visible after waiting | Contact support@cubicore.io with the gateway serial number and TTN User ID. Do not send the claim code publicly. |
| Only one Gateway EUI appears | Compare the label with TTN and contact support@cubicore.io. |
| The gateway is registered but offline | Repeat Wi-Fi provisioning for both channels and verify internet access. |
| The gateway is online but receives no uplinks | Check the AS923 Group 3 settings, frequencies, spreading factor, bandwidth, ADR, and dwell time. |
| A second claim attempt fails | Do not repeatedly submit the form. Contact support@cubicore.io. |
| The claim code has been exposed | Contact support@cubicore.io immediately. Do not share the code further. |
When contacting support, provide the gateway serial number, your TTN User ID, a description of the problem, and a screenshot of the error with the claim code and any sensitive credentials hidden. Never share your TTN password or post the full claim code publicly. Contact support@cubicore.io.
Contact Cubicore Support¶
Your gateway is now ready to use with your TTN account. If you need help with Wi-Fi provisioning, end-device configuration, or a claim that did not complete successfully, contact Cubicore Support.
For a previously owned gateway, the previous and new users should agree on the transfer and administration arrangement before claiming the device. If the claim code has already been used, or if the gateway is associated with another account, contact support@cubicore.io.