4 Installing OS (optional)

The device is shipped with an operating system by default. If the OS is corrupted during use or the user needs to replace the OS, it is necessary to re-download the appropriate system image and install it. Our company supports to install the OS by installing the standard Raspberry Pi OS first, and then install the firmware package.

The following section describes the specific operations of image download, flashing to SD card and installation of firmware packages.

4.1 Downloading OS File

You can download the corresponding official Raspberry Pi OS file according to your actual needs, the download path is listed below:

OSDownload Path
Raspberry Pi OS(Desktop) 64-bit-bookworm (Debian 12)https://downloads.raspberrypi.com/raspios_arm64/images/raspios_arm64-2024-07-04/2024-07-04-raspios-bookworm-arm64.img.xz
Raspberry Pi OS(Lite) 64-bit-bookworm (Debian 12)https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2024-07-04/2024-07-04-raspios-bookworm-arm64-lite.img.xz
Raspberry Pi OS(Desktop) 32-bit-bookworm (Debian 12)https://downloads.raspberrypi.com/raspios_armhf/images/raspios_armhf-2024-07-04/2024-07-04-raspios-bookworm-armhf.img.xz
Raspberry Pi OS(Lite) 32-bit-bookworm (Debian 12)https://downloads.raspberrypi.com/raspios_lite_armhf/images/raspios_lite_armhf-2024-07-04/2024-07-04-raspios-bookworm-armhf-lite.img.xz

4.2 Flashing to SD Card

The ED-GWL2110 supports booting the system from an SD card. Depending on your application needs, refer to the instructions below to flash the OS image.

It is recommended to use the Raspberry Pi official tools. The download paths are as follows:

Preparation:

  • The downloading and installation of the official tools to the computer have been completed.
  • Opening the device enclosure and removing the Micro SD card:
    1. Unscrew the 9 screws on the bottom of the ED-GWL2110 counterclockwise using a screwdriver, as illustrated in the figure below.
      image-20241011153629436
    2. Remove the Micro SD card from the marked location shown in the figure below.
      image-20241011153629436
  • The OS file has been obtained.
  • An SD card reader has been prepared.
  • Power has been disconnected.

Steps:

The steps are described using Windows system as an example.

  1. Insert the removed SD card into the card reader and then into the USB port of your computer.

  2. Open SD Card Formatter, select the formatted drive letter, and click "Format" at the lower right to format.

image-20241011153629436

  1. In the pop-up prompt box, select "Yes".

  2. When the formatting is completed, click "OK" in the prompt box.

  3. Close SD Card Formatter.

  4. Open Raspberry Pi Imager, select "CHOOSE OS" and select "Use Custom " in the pop-up pane.

image-20241011153343104

  1. According to the prompt, select the OS file under the user-defined path and return to the main page.

  2. Click "CHOOSE STORAGE", select the default device in the "Storage" interface, and return to the main page.

image-20241011153807227
  1. Click “NEXT”, select "NO " in the pop-up “Use OS customization?” pane.
image-20241011154241786
  1. Select “YES” in the pop-up “Warning” pane to start writing the image.
installation-1
  1. After the OS writing is completed, the file will be verified.
installation-2

  1. After the verification is completed, click “CONTINUE” in the pop-up “Write Successful” box.

  2. Close the Raspberry Pi Imager, remove the card reader and SD card, and reinsert them into the device.

4.3 Installing Firmware Package

After flashing the standard Raspberry Pi OS onto the ED-GWL2110 series, you must configure the system by adding the edatec APT repository and installing the firmware package to ensure full functionality.

For the ED-GWL2110, three different LoRaWAN protocol frequency bands are available:

  • 470MHz (CN470): China
  • 868MHz (EU868): Europe
  • 915MHz (US915): United States
LoRa TypeFirmware
470MHz(CN470)gwl2110_470
868MHz(EU868)gwl2110_868
915MHz(US915)gwl2110_915

Preparation:

  • The flashing to SD card of the Raspberry Pi standard OS (bookworm) has been completed.
  • The device has booted normally and the relevant boot configuration has been completed.

Steps:

  1. After the device starts normally, execute the following commands in the command pane to add the edatec apt source and installing firmware package.
  • 470MHz(CN470)
curl -s https://apt.edatec.cn/bsp/ed-install.sh | sudo bash -s gwl2110_470
  • 868MHz(EU868)
curl -s https://apt.edatec.cn/bsp/ed-install.sh | sudo bash -s gwl2110_868
  • 915MHz(US915)
curl -s https://apt.edatec.cn/bsp/ed-install.sh | sudo bash -s gwl2110_915

The figure below uses 915MHz (US915) as an example.

gwl105024

  1. After the installation is complete, the system automatically reboots.

  2. Execute the following command to check whether the firmware package is installed successfully.

dpkg -l | grep ed-

The result in the picture below indicates that the firmware package has been installed successfully.

gwl2222105159

TIP

If you have installed the wrong firmware package, you can execute sudo apt-get --purge remove package to delete it, where “package” is the package name.

  1. Execute the following command to enable the i2c interface.
sudo raspi-config nonint do_i2c 0
  1. Execute the following commands in sequence to check the SPI configuration of LoRa. Then you need set "the spidev_path" to "/dev/spidev1.0".
cd /opt/ed-lora
cat conf/global_conf.json.EU868
spi

TIP

For US915/CN470 modules, replace EU868 with US915 or CN470.

  1. Execute the following commands in sequence to check the reset pin of LoRa. Then you need set the reset pin to 8.
cd /opt/ed-lora
cat reset_lgw.sh
spi
  1. Execute the following command to restart the device.
sudo reboot
  1. Execute the following command to to check the status of the LoRa service.
sudo systemctl status ed-lora.service
spi
  • If the status of LoRa service is running, it's OK.
  • If the status of LoRa service is not running, please Execute sudo systemctl start ed-lora.service to start it manually.