ALWG-1638

Atreyo LoRaWAN® gateway is powered with an ARM Cortex-A7 processor with ease of outdoor installation and IP67-rated environment-resistant aluminum enclosure to support your smart city, smart industry, professional LoraWAN® network applications, and industrial control systems. 
It also has an emergency Supercap backup supply for the last message.
The gateway’s dual SIMs ensure network connectivity redundancy.

ALWG-1638 has inbuild:

Please read the user manual carefully before starting and proceeding with the device.
Also, read the product safety information.

General Information

Download technical specification Technical Specification

Model selection

Different LoRaWAN Gateway models are available depending on frequency band/region and on the periphery availability and it's type.

Model Selection
Lora frequency / Country Cellular
IN
US
EU
IN
EU
GL
ALWG-1638-IN-LT-IN



ALWG-1638-IN-LT-EU



ALWG-1638-IN-LT-GL



Models with other configurations are available by special order. See “Technical Specification” for how to select the correct model.


Hardware information

The Gateway is made from aluminium back and UV resistant PC front. It is IP67.

Front view dimensions

ALWG-1638-dimensions-top.png

Top/Bottom view dimensions

ALWG-1638-dimensions-side.png


Top connectors

ALWG-1638-top-view.png

Bottom connectors

ALWG-1638-connectors-2.png


Power Supply

Connect the gateway to the power supply as referenced in the below diagram, and use the standard input/output-rated power adapter as per safety guidance.

The Gateway is to be powered via  isolated PoE in the range of 37-57V DC.

ALWG-1638-wiring-1.png

The above connection diagram shows two ways to connect the gateway to the network and power supply.

PoE Ethernet pinout

Below is the PoE Ethernet pinout for reference.

PIN number Function Remark
1
RX+ Data
2
RX- Data
3
TX+ Data
4
DC+ Power supply positive
5
DC+ Power supply positive
6
TX- Data
7
 DC- Power supply negative
8
DC- Power supply negative

Block diagram

A block diagram of the device is shown below.

ALWG-1638-block diagram.png

Note: USB host and microSD card are not available to the user. They are only for the purpose of developing your own software and updates. In case the user would like to use them, Atreyo's permission is required, otherwise the warranty will be void.

Configuration Manual

First start

After unpacking, the gateway is in ready-to-use condition but requires a few configurations to adapt to the required functions.


Power Supply

Connect the gateway to the power supply as referenced in the below diagram, and use the standard input/output-rated power adapter as per safety guidance.

The Gateway is to be powered via  isolated PoE in the range of 37-57V DC.

ALWG-1638-wiring-1.png

The above connection diagram shows two ways to connect the gateway to the network and power supply.


Connect to the network

DHCP

If the gateway is by default in DHCP mode proceed with method 1, which is to connect the gateway directly to your desired WAN network.

Static IP

If the gateway is by default set to static IP, go for method 2 … (Default)


IP assigment
Manual
IPv4 address:
192.168.10.100
IPv4 subnet prefix lenght
24
IPv4 gateway
192.168.10.60

Now, Go to Network > interfaces and switch IP protocol to "br-lan" to your desired settings.

ALWG-1638-web-interfaces-lan.png

You can configure gateway either in DHCP client mode orelse go for Static IP (as shown above), Feed your desired IP in static mode.

Once web UI access method is smoothly configured proceed to explore web UI configuration options after rebooting the gateway once.


Open the LuCI web interface

Through Ethernet

To access the LuCI WebUI, connect the gateway by your convenient method to the local network and enter the assigned IP address in any web browser. Please note that it may take some time from powering on the gateway to booting up the system. When the green LED in the bottom right side socket starts flashing, after about 10-15 seconds the built-in website becomes available to access.

Enter the host IP address and you will find the URL look a like as shown in the below image.

ALWG-1638-web-ip-address.png

Below image shows the login page of Gateway webUI.

ALWG-1638-web-login.png

Default credentials are user/pass: root/root


Through the WiFi interface (if WiFi available)

By default, the gateway creates its hotspot, which is called "ALWG-1638". The network is unsecured. Connect to this network find out the host IP by the same method and enter the IP in the address bar of your browser.

WiFi credentials : ALWG-1638/atreyo12

After logging in, you are automatically taken to the Application page:

ALWG-1638-web-application.png


Chirpstack LNS and NodeRED and Terminal are pre-installed in the gateway. 

If you are using the ChirpStack Gateway OS first time, do not forget to configure your shield first.

If you have a pop-up at the top with a message that no password has been set, set/change it.

ALWG-1638-web-nopassword.png

Set a password on the System>Administration page:

ALWG-1638-web-admin-password.png

To maintain security, it is recommended to use long and complex passwords.


Chirpstack concentratord

ChirpStack Concentratord provides an unified API interface to LoRa(R) concentrator hardware. Please refer to the ChirpStack Concentratord Hardware page for supported hardware and configuration options.

This gateway has pre-installed chirpstack gateway OS and it has Chirpstack concentratord installed in it.
Basically it is used to configure respective shield (LoRa Chip) used in gateway.

ALWG-1638-web-chirpstack-concentratord.png

Antenna gain (dBi) , shield used in gateway, channel plan in which gateway should work ,etc, all these parameters can be configured in this section.

After shield setup gateway can be configured to in two different mode to send data 1) Chirpstack UDP forwarder and 2) Chirpstack MQTT forwarder.


Chirpstack forwarder

Gateway has inbuilt functionality pre-installed for ChirpStack Concentratord, in which one can setup shield and it's operating region.

The gatewat is supported with

Chirpstack UDP forwarder:

If your your LNS server is handling UDP  Data then you need to configure LNS in UDP forwarder mode.

Follow below basic steps to send data to UDP forwarder.

Open Chirpstack > UDP forwarder

ALWG-1638-web-chirpstack-udp.png

Add UDP server address along with port.

ALWG-1638-web-chirpstack-udp-add.png

i.e.

ALWG-1638-web-chirpstack-udp-add-2.png

Save the configuration.

ALWG-1638-web-chirpstack-udp-save.png

ALWG-1638-web-chirpstack-udp-save-2.png

After adding LNS server you can see uplink forwarded to your UDP LNS server.

... in case need to delete UDP server, click the Delete button then Save & Apply

ALWG-1638-web-chirpstack-udp-delete.png


Chirpstack MQTT forwarder

If your your LNS server is handling Data over MQTT then you need to configure LNS in MQTT forwarder mode.

Follow below basic steps to send data to MQTT forwarder.

Open Chirpstack > MQTT forwarder

ALWG-1638-web-chirpstack-mqtt.png

Add MQTT server address along with port.

ALWG-1638-web-chirpstack-mqtt-add.png

Topic prefix is by default from frequency , you can change it or keep as it is.

MQTT server is in this format --> e.g. scheme://host:port where scheme is tcp, ssl, ws, wss, so add your address accordingly (ignor address in picture)

You can provide user, password to connect if you MQTT server is defined in that way.

See how to configure gateway to send uplink/data to internal chirpstack LNS

Moreover you can add CA certificate, TLS certificate, and TLS key-file if needed.(copy paste the file contains, neither path to write or nor file you need to drag here).

ALWG-1638-web-chirpstack-mqtt-tls.png

After adding configuration Save & Apply.

ALWG-1638-web-chirpstack-mqtt-tls-filter.png

Once all configuration done, you can move to LNS server for further integration over cloud.


Chirpstack LNS

Refer Chirpstack MQTT forwarder in Chirpstack forwarder for basic idea to configure MQTT forwarder, When you open Chirpstack > MQTT forwarder add internal LNS server:port in Server and Save.

ALWG-1638-web-chirpstack-mqtt-forwarder.png

Read chirpstack documentation for MQTT forwarder, where MQTT server="tcp://127.0.0.1:1883" for connecting gateway to internal chirpstack LNS.

After adding server and saved it, gateway backend system will reset concentratord modulue to apply new configuration, System Log feature can have this information as shown below.

ALWG-1638-web-chirpstack-system-log.png

Once it has been reset/restarted succesfully, it will start functioning normally.


Gateway configuration is all set to move ahead into LNS configuration.

As like NodeRED, Chirpstack LNS is pre-installed in system as well as can be opened from same Applicaiton menu by clicking the icon or "<gateway_IP>:8080".

ALWG-1638-web-application-chirpstack.pngChirpstack will ask credential to login into chirpstack console.

ALWG-1638-web-chirpstack-lns-login.png

Credentials : user/pass --> admin/admin , Make sure to change it later for security purpose.

After login you will be redirected to Dashboard, where you can see gateway and end devices online/offline status, device dat-rate usage as well as Gateway Map.

ALWG-1638-web-chirpstack-lns.png

in above data there in No Data, as no Gateways/Devices has been added.


Cellular modem

Modem

The Gateway in its basic configuration is equipped with an LTE modem that also supports GPRS and SMS functions. Different modems were used depending on the model variant. Here is a table of models. 

SIM card

The Gateway supports two microSIM cards, both 1.8V and 3V. The card connector is a push-pull type. When installing the SIM card, pay attention to the correct insertion of the card, and it's direction.

Refer to the below image for the SIM insertion guide.

ALWG-1638-sim.png


Activate Cellular Network

To activate the LTE modem, go to Network > Interfaces and select the 3g-wan tab there.

ALWG-1638-web-interfaces-lte.png

The interface is pre-configured but you might need to provide/change the network operator's APN, sometimes it also requires a username and password. Enter the required data and save.

Click the Edit button and enter APN.

ALWG-1638-web-interfaces-lte-apn.png

Then go to System > Custom Commands.

Here you will find below highlighted 4 scripts that are related to cellular modems.

ALWG-1638-web-custom-commands-lte.png

Once the script is successful you will get a pop-up at top right corner (Ref image below).

ALWG-1638-web-custom-commands-success.png

The modem will start up and connect to the Internet. To check if it is working properly and what the signal is, go to Status > Mobile Service.

ALWG-1638-web-status-mobileservice.png


Cellular modem power ON at boot

To make the gateway automatically connect to the GSM Internet after startup, you need to add a modem startup in the System > Startup section under Local Startup, and add script path before 'exit 0'.

 /usr/commands/modem_on.sh 

Then save the changes. 

ALWG-1638-web-sturtup-lte.png

After each reboot, the gateway will automatically start the modem and connect to the GSM network.


Terminal

Few Gateway configuration need to be done using CLI or some backend files need to be edited or for any CLI based operation we need terminal, Hence same as NodeRED you can click on Terminal icon and it will open terminal in new tab or you can directly open in browser by "<gateway_IP>:7681"

ALWG-1638-web-application-terminal.png

After clicking icon terminal will open in new tab and ask for user/password , it's same as gateway login.

ALWG-1638-web-terminal-login.png

Credentials --> user/pass : root/root

ALWG-1638-web-terminal.png

Now CLI utility can be used for any specific purpose.

ALWG-1638-web-terminal-use.png

Chirpstack LNS

Once the Chirpstack LNS has been configured in gateway side, few things to be done in Chirpstack console. i.e. to add Gateway, End devices, Application etc.

to Add gateway in chirpstack LNS open chirpstack LNS by clicking the icon in Application.

ALWG-1638-web-application-chirpstack.png

Login pop-up will appeare, use admin/admin as user/pass. After login the screen will be like:

ALWG-1638-web-chirpstack-lns.png

Go to Gateway section in Tenant to add perticular gateway.

ALWG-1638-web-chirpstack-lns-add-gateway.png

Click on Add gateway button.

ALWG-1638-web-chirpstack-lns-add-gateway-2.png

It will open another page and ask for Gateway Name, it's EUI and any description you want to add for sack of your application purpose.

ALWG-1638-web-chirpstack-lns-add-gateway-3.png

You can add data as per need and Submit.

ALWG-1638-web-chirpstack-lns-add-gateway-4.png

Makesure to findout Gateway ID from gateway webUI as shown in below image.

ALWG-1638-web-chirpstack-gateway-id.png

After submitting all the data pop-up at upper right side will shown to confirm that gateway has been added succesfully. and it will open page where you can see Dashboard, it's configuration as well as option to see loraWAN frames.

ALWG-1638-web-chirpstack-lns-gateway-created.png

Last seen will change in a while as well as GPS will be fetched from gateway itself , also the metadata will be fetch from gateway.

Gateway status is also visible in Dashboard section as well as in Gateway section.

ALWG-1638-web-chirpstack-lns-gateway-status.png

ALWG-1638-web-chirpstack-lns-gateway-status-2.png

Click on Gateway ID to open Gateway ... (last seen and GPS has been updated after a while).

ALWG-1638-web-chirpstack-lns-gateway-status-location.png

To change configuration or edit anything got to Configuration tab, you can add tag for easy tracebility in Tag tab under Configuration tab as well as gateway metadata will be fetched as shown below. 

ALWG-1638-web-chirpstack-lns-gateway-configuration.png

In TLS certificate tab you can generate TLS certificate for specific application.

ALWG-1638-web-chirpstack-lns-gateway-tls.png

Once can download by clicking on Download button or open another sidebar to view event by clicking on event.

ALWG-1638-web-chirpstack-lns-gateway-event.png

ALWG-1638-web-chirpstack-lns-gateway-event-2.png

 

Node-RED

NodRED functionality is pre-installed and it has been hosted on 1880 port.

To access NodeRED use icon in Application section or open browser and hit "<gateway_IP>:1880

New tab will open and and it might pop-up for user/pass if you are using it either first time or after long.

ALWG-1638-web-nodered-login.png

Credentials : user/pass  --> atreyo/atreyo

After loggin in either you will have blank flow or any example flow saved by atreyo testing team.

1.

ALWG-1638-web-nodered-blank.png

2.

ALWG-1638-web-nodered-flow.png

Above example flow is designed to fetch events of end devices, this flow will provide join, status, uplink, etc, events in debug.
To retrive data from events one should write function in NodeRED, then data can be send to external platforms.

Use cases/ Examples

Application

Firmware releases

The Gateway works on the OpenWRT operating system. The operating system is specially prepared and compiled for hardware. So when it is booted up, it is ready for use. In addition to the pre-installed application, we provide our own repository of free apps compiled for this Gateway. We update the system regularly to keep the latest version. You can check the latest releases here.

OpenWRT system ChirpStack Kernel version Compilation date
23.05 4.3.0 5.10.146

Safety information

Operating environment

Use in inappropriate conditions may damage the device or shorten its life.


Electrical and power supply safety

Only a person with qualification and appropriate knowledge should install the device.


Malfunctioning and damaged device

Radio frequency exposure

This device has been designed and manufactured not to exceed radio frequency energy emission limits set by regulatory agencies. To comply with RF exposure guidelines, the device must be used at least 20 cm away from a person's body. Failure to follow these instructions may result in exceeding the applicable RF exposure limits. This only applies to models with a built-in LTE modem.


What to do and what not to do