SDK Quick Start Guide

Product Name: L-Serial Smart Gateway

Model Name: DSGW-021

Revision History

Approvals

1. Introduction

This Quick Start Guide explains the basics: how to connect and set up your target on the network; how to install the SDK; and how to build the firmware images.   

The Linux Software Developer's Kit (SDK) is an embedded hardware and software suite that enables Linux developers to create applications on Dusun's DSGW-021 gateway.

Base on the MTK OpenWrt V19.07, and leveraging existing open source software, the SDK simplifies the process of adding custom applications. Device drivers, toolchain, Pre-defined configuration profiles, and sample applications are all in included.   

2. Gateway Information

2.1 Basic information

Processor: MTK7628A   

Supply: DC-5V

ZigBee: EFR32MG1B232F256G

Z-Wave: ZGM130S037HGN

Bluetooth: EFR32BG21 or NRF52840

RAM: 64MB

Flash: 16MB

2.2 Gateway appearance   

3. Target Setup

This section describes how to connect the gateway into your host computer and network.   

3.1 Connecting a gateway - Power   

3.1.1 Make sure that the power adapter is 5V/2A.   

3.1.2 Select the appropriate power plug adaptor for your geographical location. Insert it into the slot on the Universal Power Supply; then plug the power supply into an outlet.   

3.1.3 Connect the output plug of the power supply to the gateway

3.2 Connecting a gateway – LAN port   

3.2.1 Connect one end of the network cable to the Ethernet port on the laptop or desktop 3.2.2 Connect the other end of network cable to the LAN port on the gateway.   

Figure3-1. Connecting a gateway via Ethernet port

Before you set up your development test bed, please connect the PCB serial port to your develop PC via USB-to-serial bridge.

Serial port setting:   

Baud rate: 57600

Bits: 8

Stop Bits: 1

Hardware flow control: None

4. Compile the Environment to Build

4.1 OpenWrt Version

Take OpenwWRT19.07 as an example

4.2 PC Compile the Environment to Build

Compilation environment: Linux

Openwrt's compilation tool is automatically generated by SDK built, no additional installation is required

4.3 OpenWrt configuration and compilation

Get the source code from Dusun FTP server or github and uncompress it under your work directory.

Github link: https://github.com/openwrt/openwrt.git

Checkout to correct branch after clone, take OpenWRT19.07 as an example, git checkout openwrt-19.07 git branch –a

4.3.1 DTS file

About DTS file for connecting to Dusun gateway’s   hardware, please download in Dusun FTP server.

Then move it to the right directory mv DSGW021.dts target/linux/ramips/dts/

   c) Add the component in file vi target/linux/ramips/image/mt76x8.mk

4.3.2 Configure compilation options

a) Configure compilation options

There is already a default configuration in the SDK, which satisfies the basic functions of routing. Customers could also customize the configuration according to their own needs.

Command:   

cd <work_dir>/openwrt/ make menuconfig

Choose system (MediaTek Ralink MIPS)   

Select Subtarget MT76x8 based boards

Choose target profile DSGW-021

If user want to change kernel configuration make kernel_menuconfig

Exit and save the configuration. b) Build the image

Just use command 'make V=99', the image built will take a long time.

The target image will be under ./ bin/targets/ramips/mt7620

Image used for update is openwrt-ramips-mt7620-dsi0134-squashfs-sysupgrade.bin

5. Network interfaces

Login into the gateway device, using command 'ifconfig', you can get all network interfaces.

Interface eth1 connects to WAN port (Blue RJ45 port), eth0 is LAN port, it's connected to an internal switch on SoC, all LAN ports are connected to eth0。

Interface ra0 is 2.4G radio, rai0 is 5G radio.

6. Openwrt restore to factory setting

Command: firstboot

Press 'y' to confirm and then reboot system.

7. Add APP component in Openwrt

Take openwrt-sdk/package/dusun/lib_dusun as an example,   

If user want to add a new user lever application into openwrt SDK, just follow the example.

After code is ready, you still need to add it to config file by "make menuconfig", and select Dusun

Select libdusun package,

Exit and save config, 'make V=99' again, you can get the image with libdusun

8. uboot build and upgrade

1. uboot configuration and build

On development PC:

cd Uboot make

You get uboot.img

2. uboot upgrade

Setup tftp server on the development PC, and put uboot.img under tftp root directory.

Make sure connect the board to PC via serial port, reset board and press '9' when current uboot is booting up. Follow the steps in the console:

The uboot.img will be downloaded to the board and upgraded, then automatically reset to boot new uboot:

9. System firmware upgrade

Put the image on any server which supports ssh/scp service.

scp user@serverip:~/openwrt-ramips-mt7621-mt7621-squashfs-sysupgrade.bin   

/tmp/

sysupgrade -v /tmp/openwrt-ramips-mt7621-mt7621-squashfs-sysupgrade.bin

10. Communication between zigbee module   

    User can obtained the zigbee module’s NCP program in simplicity studio, the module number is EFR32MG1B232F256G

For detailed information to flash image to the zigbee module, please refer to document

ZIGBEE MODULE FLASH FIRMWAREv1.0

For SDK to develop program in gateway, please refer to document API Reference for

EmberZNet PC Host It can be found in the ss5’s directory of C:\SiliconLabs\SimplicityStudio\v4_3\developer\sdks\gecko_sdk_suite\v2.7\protocol\zigb ee\documentation

11. Communication between Z-Wave module   

User can obtained the Z-Wave module’s NCP program in simplicity studio, and acquire the Z-Wave sdk in siliconlabs for further development   

Find the correct Z-Wave module in simplicity studio, then follow the same guide in section 10

12. Communication between BLE module   

For silicon labs BLE module   

User can obtained the ble module’s NCP program in simplicity studio, the module number is ERF32BG21

Find the correct BLE module in simplicity studio, then follow the same guide in section 10

For Nordic BLE module   

If Gateway is implemented the Nordic BLE module NRF52840, follow the official SDK from Nordic.

https://www.nordicsemi.com/Products/Development-software/nRF5SDK/GetStarted?lang=en#infotabs

13. System firmware upgrade

Using sysupgrade in gateway   

scp user@serverip:~/openwrt-ramips-mt7688-mt7688-squashfs-sysupgrade.bin   

/tmp/

sysupgrade -n /tmp/openwrt-ramips-mt7688-mt7688-squashfs-sysupgrade.bin

Using LUCI web server in gateway

Using Uboot method

Please refer to document update gateway using uboot.pdf

14. Others

For more information, please visit OpenWRT official website.