# EasyCamera

**Repository Path**: xldc/EasyCamera

## Basic Information

- **Project Name**: EasyCamera
- **Description**: open source streaming camera
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2015-10-10
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasyCamera #

**EasyCamera** 并不是做摄像机硬件方案，我们是在硬件方案的基础上，通过硬件方案商提供的SDK与摄像机主服务进行交互，包括实时视频、云台控制、联动报警等功能，我们在摄像机内部植入EasyCamera方案，一方面通过SDK操作摄像机，一方面与EasyDarwin云平台对接，上传数据、接受指令，形成一套云视频摄像机方案.

EasyCamera服务支持跨平台Windows/Linux，支持ARM摄像机，支持安卓/IOS移动设备(开发中)，对接EasyDarwin开源平台，我们定制的摄像机采海思3518E方案，支持RTSP、Onvif、WEB管理、配套SDK工具，作为开发和演示硬件工具，我们提供了全套完备的程序和文档，既可以用于流媒体学习，又可以用于方案移植参考，更可以直接用于项目中，购买参考设备可以在：[https://easydarwin.taobao.com/](https://easydarwin.taobao.com/ "EasyDarwin TaoBao")，用户可以将摄像机定制的部分替换成自己摄像机的硬件SDK，移植非常方便；

## EasyCamera包括 ##

- **SDK** 摄像机SDK调用示例
- **src** EasyCamera开源程序


## 编译和部署方法 ##

### 1、编译EasyCamera最新版本 ###

- Windows版本编译：

可以直接用Visual Studio 2008打开源码文件中的：/EasyCamera-master/src/WinNTSupport/EasyCamera.sln解决方案文件，编译出exe可执行文件EasyCamera.exe；

- arm版本编译：

这里只说明EasyDarwin开源摄像机的编译方法,其他类型摄像机编译方法类似, 前提是配置相应的交叉编译工具链，具体安装交叉编译工具链参考：

> “
> 交叉编译工具链为所提供的EasyCamera-master\SDK\8126交叉编译工具\crosstool.tgz文件，解压crosstool.tgz至Linux开发宿主机的/opt目录，在/etc/profile里设置将交叉编译工具链目录设置到PATH变量，重启完成安装。
> 解压命令：tar zxvf crosstool.tgz -C /opt
> 在/etc/profile添加:
> export PATH="$PATH:/opt/crosstool/arm-none-linux-gnueabi-4.4.0_ARMv5TE/bin"
> “

编译方法,

    cd ./EasyCamera-master/src/
    chmod +x ./Buildit
    ./Buildit
    cd ./Bin


### 2、配置easycamera.xml ###
EasyCamera主要的几个配置项：

***cms_addr***：EasyCMS服务的IP地址或者域名；

***cms_port***：EasyCMS服务的监听端口；

***local\_camera\_addr***：本地摄像机地址，例如EasyCamera Windows版本是与硬件分离的，那么具体配置摄像机的ip地址，arm版本EasyCamera内置于摄像机内部，可以直接配置成127.0.0.1；

***local\_camera\_port***：摄像机监听端口，默认80，也可以在摄像机WEB管理页面重新配置；

***serial_number***：自定义配置的摄像机序列号，12位字母与数字组合；

***run\_user\_name***：摄像机用户名，默认admin;

***run_password***：摄像机密码，默认admin；

***camera\_stream\_type***：默认摄像机传输的码流类型，0表示子码流，1表示主码流；

### 3、运行EasyCamera ###
Windows版本运行(控制台调试运行)：

    EasyCamera.exe -c ./easycamera.xml -d


摄像机内运行：
首先是将arm程序如何放入摄像机内部，方法见随后的*摄像机操作指南*部分，加入我们将可执行文件放置于**/mnt/mtd/easydarwin/**目录；

调试模式运行（具体配置文件路径根据实际情况设置）,

	cd /mnt/mtd/easydarwin/
    ./easycamera -c ./easycamera.xml  -d
后台服务运行,

    ./easycamera -c ./easycamera.xml  &
注：如果xml配置文件路径不能确定，建议最保险的方式就是用全路径，例如 “/mnt/mtd/easydarwin/easycamera.xml”，这样在下一次更新服务的时候，配置文件可以保留！

### 4、跟随摄像机系统自启动 ###
需要让EasyCamera程序跟随摄像机系统自动启动，我们需要修改**/mnt/mtd/ipc/allexit.sh**和**/mnt/mtd/ipc/platform.sh**两个启动脚本：

在allexit.sh最后一行加上：

	#! /bin/sh
	...

	OPID=`ps | grep easycamera | awk '{print $1}'`
	kill -9 $OPID

在platform.sh最后一行加上：

	#! /bin/sh
	...

	cd /mnt/mtd/easydarwin &&
	./easycamera -c ./easycamera.xml &


### 5、检查EasyCamera是否运行成功 ###
可以通过EasyCamera -d调试模式，查看是否配置成功，也可以到EasyCMS查看设备是否上线；


## 系统架构 ##
![](http://www.easydarwin.org/skin/easydarwin/images/architecture20150825.png)

## 摄像机操作指南 ##

### 1、连接网络 ###
将摄像机通过有线的方式连接到摄像机，路由器需要开启DHCP功能，给摄像机分配到IP地址（如果路由器没有开启DHCP功能，摄像机连接网线后，摄像机的默认IP就是*192.168.1.88*）；

### 2、查找摄像机 ###
打开EasyCamera-master\SDK\网络库&播放库\bin\HiCamSearcher.exe，搜索摄像机：

![HiCamSearcher](http://www.easydarwin.org/d/file/article/doc/EasyCamera/001.png)

### 3、摄像机开启Telnet服务 ###
通过浏览器访问摄像机进入web管理页面，进入系统维护页面，在系统升级项中点击浏览找到所提供的EasyCamera-master\SDK\telnet_8126.pkg升级包，点击确定，等待系统重启。 例如：http://192.168.*.*/web/admin.html

![EasyCamera Telnet](http://www.easydarwin.org/d/file/article/doc/EasyCamera/002.png)

### 4、通过Telnet访问摄像机 ###

摄像机开启telnet服务后即可通过telnet 终端进行访问。登录名为root，密码为空。如下图所示。**摄像机自带的程序与配置位于/mnt/mtd/，请勿删除此目录下任何内容！！！**

![telnet](http://www.easydarwin.org/d/file/article/doc/EasyCamera/003.png)

### 5、下载文件到摄像机 ###

可通过http、ftp协议进行文件传输，摄像机提供wget、ftpget、ftpput命令。用户可以自己的程序下载至/mnt/mtd目录(受嵌入式资源的限制，此款设备用户可支配的空间大约为2M)。

下面以wget命令示例下载EasyCamera-master\SDK\pure-ftpd程序至摄像机并运行。在Windows上可使用所提供的EasyCamera\SDK\hfs241.exe作为文件服务器。如下图所示，打开HFS，将需要下载至相机的文件拖拽到HFS，拷贝地址:

![pure-ftp](http://www.easydarwin.org/d/file/article/doc/EasyCamera/004.png)

在telnet终端里输入wget url进行下载：

![download](http://www.easydarwin.org/d/file/article/doc/EasyCamera/005.png)

赋予所下载程序的可执行程序即可运行程序:

	chmod +x pure-ftpd
	./pure-ftpd &
![](http://www.easydarwin.org/d/file/article/doc/EasyCamera/006.png)



### 6、通过FTP传输文件到摄像机 ###

我们提供了EasyCamera\SDK\pure-ftpd程序以便在摄像机里建立ftp服务器，下载执行方法如上节所述。下面便可以用ftp客户端访问摄像机了,**用户名为root，密码为空**;

图为FileZilla客户端的访问界面，可以看到我们上一步建立的目录及上传的文件:

![filezilla](http://www.easydarwin.org/d/file/article/doc/EasyCamera/007.png)

### 7、摄像机多码流的RTSP地址 ###

摄像机提供1/2/3种码流，RTSP地址分别为：

- 主码流：RTSP://[IP]:[PORT]/11
- 子码流：RTSP://[IP]:[PORT]/12
- 三码流：RTSP://[IP]:[PORT]/13

具体每一个码流的参数细节可在WEB管理中进行设置：
![EasyCamera RTSP](http://www.easydarwin.org/d/file/article/doc/EasyCamera/008.png)

### 8、摄像机wifi无线连接设置 ###

WEB连接到摄像机后，可以通过WEB管理界面进行WIFI连接的设置：
![EasyCamera wifi](http://www.easydarwin.org/d/file/article/doc/EasyCamera/009.png)


## 摄像机硬件购买 ##
[http://easydarwin.taobao.com/](http://easydarwin.taobao.com/ "EasyDarwin TaoBao")

## 获取更多信息 ##

邮件：[support@easydarwin.org](mailto:support@easydarwin.org) 

WEB：[www.EasyDarwin.org](http://www.easydarwin.org)

QQ交流群：288214068

Copyright © EasyDarwin.org 2012-2015

![EasyDarwin](http://www.easydarwin.org/skin/easydarwin/images/wx_qrcode.jpg)