## 一、操作系统简介
DHG系列物联网关运行基于Linux深度定制的嵌入式操作系统，具有灵活的扩展性，并提供完整的SDK开发包和交叉编译工具链，用户可以方便地进行二次开发。
### 1.1 访问网关操作系统
#### WEB方式
若通过WiFi或LAN口连接网关，用浏览器访问`http://192.168.1.1`即可登录WEB管理界面，默认用户密码：`admin`；若通过WAN口连接，需要访问`http://wan.ip:8080`，WAN口IP默认为动态获取，因此最好先用WiFi登录后改为静态再用WAN口连接。
#### 命令行方式
通过WiFi或LAN口连接，`ssh admin@192.168.1.1`；
若通过WAN口，则需要访问10022端口：`ssh -p10022 admin@x.x.x.x` 。
### 1.2 网关上的文件系统
为了保证系统稳定可靠，网关上采用的是**只读**文件系统，系统启动时会把固件加载到内存运行，并初始化一些RAMDISK用于存放运行时产生的临时文件等。因此，对于二次开发的应用程序无法直接保存在网关上，我们提供两种选择：
1. 应用开发调试完成后，由我们来集成到固件中，此法适用于用户应用比较纯粹，依赖外部库不多的情形。
2. 增加外部存储（TF卡），在外部存储上运行一个完整的应用环境（标准C库和其它第三方软件库等），然后把用户应用完全部署在外部存储上。这样的好处是用户环境与系统固件完全分开，容易集成第三方软件包，用户程序可以单独升级。如果用户的应用较为复杂，依赖第三方软件包，或者需要本地存储支持的情况。
### 1.3 网关固件自带的软件资源
* uClibc标准C库
* 常用Linux命令
* libpthread, libiconv, openssl-devel
* libcurl, libghttp（可选）
### 1.4 网关硬件资源
#### 串口
* RS232-1，设备名：/dev/ttyS1
* RS232-2，设备名：/dev/ttyS2
* RS485-1，设备名：/dev/ttySC0
* RS485-2，设备名：/dev/ttySC1
#### DIO
可通过命令控制开关量输入输出，命令行如下：
```
Usage: mtk_gpio -d <pin> <in/out> - gpio pin set direction (in=0, out=1)
mtk_gpio -r <pin> - gpio pin read value
mtk_gpio -w <pin> <value> - gpio pin write value (0/1)
mtk_gpio -m <bit> - gpio mode get bit
mtk_gpio -s <bit> <value> - gpio mode set bit (0/1)
```
也可以通过C程序实现，我们可提供接口函数和调用示例。
开关量接口与GPIO引脚对应关系如下表：
| FUNC | GPIO |
| ------- | ---- |
| IN1 | 29 |
| IN2 | 26 |
| IN3 | 28 |
| OUT1 | 25 |
| SYS LED | 31 |
## 二、交叉编译用户应用
由于网关采用了MIPS架构的CPU，不同于PC的X86架构，因此需要把用户程序在开发机上交叉编译为MIPS架构的可执行程序才能在网关上运行。
### MIPS交叉编译工具链使用说明
以下步骤需要在Linux开发机上执行。
1. 下载toolchain-3.4.x.tgz
链接：http://pan.baidu.com/s/1eSIR6mQ
密码：l4x1
2. 解压安装
`tar xzf toolchain-3.4.x.tgz -C /opt`
3. 交叉编译
`/opt/toolchain-3.4.x/bin/mipsel-linux-uclibc-gcc -o hello hello.c`
4. 在网关上运行程序
```bash
# scp user@192.168.1.8:hello /tmp
# /tmp/hello
```
## 三、在外部存储部署用户应用
前面提到，若用户应用相对复杂、体积较大，不太适合集成到固件中时，可以采用在外部存储部署一个独立的运行环境，具体做法如下：
### 3.1 安装并启用外部存储
网关支持TF卡扩展，插入TF卡后，还需要配置一下Entware才能在TF卡上部署运行环境，可通过WEB界面实现：
### 3.2 初始化Entware运行环境
以下代码中，以#号开头的表示在Linux命令行输入的命令，其它为命令的输出。
1. 通过SSH登录到网关
2. 格式化TF卡为ext4格式：
```bash
# umount /dev/mmcblk0p1 -- 卸载TF卡，如未安装请忽略
# mkfs.ext4 -L SD /dev/mmcblk0p1 -- 格式化
mke2fs 1.42.8 (20-Jun-2013)
Filesystem label=SD
OS type: Linux
Block size=4096 (log=2)
Fragment size=4096 (log=2)
Stride=0 blocks, Stripe width=0 blocks
972944 inodes, 3889280 blocks
194464 blocks (5.00%) reserved for the super user
First data block=0
Maximum filesystem blocks=3984588800
119 block groups
32768 blocks per group, 32768 fragments per group
8176 inodes per group
Superblock backups stored on blocks:
32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632, 2654208
Allocating group tables: done
Writing inode tables: done
Creating journal (32768 blocks): done
Writing superblocks and filesystem accounting information: done
#
```
3. 初始化Entware（此步需要连接外网）
```bash
# mdev_mmc mmcblk0p1 add -- 自动mount TF卡
EXT4-fs (mmcblk0p1): mounted filesystem with ordered data mode. Opts: (null)
event signal: User defined signal 1
rc notification: on_hotplug_mass_storage
# mount -- 确认SD卡已mount
...
/dev/mmcblk0p1 on /media/SD type ext4 (rw,noatime,data=ordered)
# cd /media/SD -- 进SD
# mkdir opt -- 建opt目录
# opt-mount.sh /dev/mmcblk0p1 /media/SD -- mount opt文件系统
# mount -- 确认/opt已mount
...
/dev/mmcblk0p1 on /media/SD type ext4 (rw,noatime,data=ordered)
/dev/mmcblk0p1 on /opt type ext4 (rw,noatime,data=ordered)
# opt-opkg-upd.sh -- 初始化基本Entware运行环境
Downloading http://pkg.entware.net/binaries/mipsel/Packages.gz
Updated list of available packages in /opt/var/opkg-lists/entware-ng
Installing ldconfig (1.0.17-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/ldconfig_1.0.17-1_mipselsf.ipk
Installing findutils (4.6.0-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/findutils_4.6.0-1_mipselsf.ipk
Installing libc (1.0.17-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/libc_1.0.17-1_mipselsf.ipk
Installing libgcc (5.4.0-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/libgcc_5.4.0-1_mipselsf.ipk
Installing libssp (5.4.0-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/libssp_5.4.0-1_mipselsf.ipk
Configuring ldconfig.
Configuring libgcc.
Configuring libc.
Configuring libssp.
Configuring findutils.
# reboot -- 完成，重启后确认是否能自动mount opt文件系统。
```
### 3.3 Entware软件包管理
Entware可以认为是安装于/opt下，独立于网关固件的一套运行环境，包括了基本的libc库、busybox命令集以及简单的软件包管理功能。通过软件包管理工具，用户可以方便地在线安装（已经移植并且交叉编译好的二进制）软件包，常用的开源软件包基本都有，详细列表参见：http://pkg.entware.net/binaries/mipsel/Packages.html.
另外，Entware还有一个完善的buildroot交叉编译环境，在这个buildroot下，不论是移植开源软件包或是交叉编译用户自己的应用，都是非常方便的（我们有单独的buildroot使用说明）。
下面是常用的软件包管理命令：
#### 1. 更新软件包列表
```bash
# /opt/bin/opkg update
Downloading http://pkg.entware.net/binaries/mipsel/Packages.gz
Updated list of available packages in /opt/var/opkg-lists/entware-ng
#
```
#### 2. 查找/安装软件包
```bash
# /opt/bin/opkg find "curl*"
curl - 7.57.0-1 - A client-side URL transfer utility
curlftpfs - 0.9.2-3 - CurlFtpFS is a filesystem for accessing FTP hosts
based on FUSE and libcurl.
# /opt/bin/opkg install curl
Installing curl (7.57.0-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/curl_7.57.0-1_mipselsf.ipk
Installing libcurl (7.57.0-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/libcurl_7.57.0-1_mipselsf.ipk
Installing libopenssl (1.0.2n-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/libopenssl_1.0.2n-1_mipselsf.ipk
Installing zlib (1.2.11-1) to root...
Downloading http://pkg.entware.net/binaries/mipsel/zlib_1.2.11-1_mipselsf.ipk
Configuring zlib.
Configuring libopenssl.
Configuring libcurl.
Configuring curl.
#
```
