GM8126 DVR-IPC - Open IP Camera Forum - Index v1.1/Docs/Software... · GM8126 DVR-IPC Starter Guide. 3 . 1.2. Video Flow Diagram . Figure 1-1. shows the video flow of 720P IPCAM and

GM8126

DVR-IPC Starter Guide Rev.: 1.0 Issue Date: June 2011

REVISION HISTORY

GM8126 DVR-IPC Starter Guide

Date Rev. From To

Jun. 2011 1.0 - Original

Copyright © 2011 Grain Media, Inc.

All Rights Reserved.

Printed in Taiwan 2011

Grain Media and the Grain Media Logo are trademarks of Grain Media, Inc. in Taiwan and/or other countries.Other company, product and service names may be trademarks or service marks of others.

All information contained in this document is subject to change without notice. The products described in this document are NOT intended for use in implantation or other life support application where malfunction may result in injury or death to persons . The information contained in this document does not affect or change Grain Media’s product specification or warranties. Nothing in this document shall operate as an express or implied license or indemnity under the intellectual property rights of Grain Media or third parties. All information contained in this document was obtained in specific environments, and is presented as an illustration. The results obtained in other operating environments may vary.

THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN “AS IS” BASIS. In no event will Grain Media be liable for damages arising directly or indirectly from any use of the information contained in this document.

Grain Media, Inc.5F, No. 5, Li-Hsin Road III, Hsinchu Science Park, Hsinchu City, Taiwan 300, R.O.C. Grain Media's home page can be found at:http://www.grain-media.com


www.grain-media.com

i

TABLE OF CONTENTS

Chapter 1 Introduction............................................................................................................................ 1 1.1 Overview..................................................................................................................... 2 1.2 Video Flow Diagram................................................................................................... 3

Chapter 2 Run Demonstration ............................................................................................................... 5 2.1 Burn Image in GM8126 EVB...................................................................................... 6 2.2 Prepare Executing Environment ................................................................................ 6 2.3 Run Demonstration .................................................................................................. 13

Chapter 3 Default Configuration and Settings ..................................................................................... 19 3.1 Configuration File ..................................................................................................... 20


www.grain-media.com

ii

LIST OF TABLES

Table 1-1. Product Names and Corresponding Specifications .............................................................. 2 Table 1-2. How-To and Corresponding Reference Documents and Positions ...................................... 2


www.grain-media.com

iii

LIST OF FIGURES

Figure 1-1. Video Flow of 720P IPCAM................................................................................................... 3 Figure 1-2. Video Flow of 1080P IPCAM................................................................................................. 4


www.grain-media.com

1

Chapter 1 Introduction

This chapter contains the following sections:

• 1.1 Overview

• 1.2 Video Flow Diagram


www.grain-media.com

2

1.1 Overview This document describes the basic ideas and demonstrates how to run the IPCAM sample programs in this

SDK. After reading this document, users should be able to develop the applications. Table 1-1 lists the

product names and corresponding specifications.

Table 1-1. Product Names and Corresponding Specifications

Product Name Specification

IPC-1080P GM8126 1080P IPCAM

IPC-720P GM8126 720P IPCAM

IPC-VGA GM8126 VGA IPCAM

IPC-D1-VGA GM8126 two-channel(D1 + VGA) IPCAM

IPC-D1-720P GM8126 two-channel (D1 + 720P) IPCAM

Because this document only describes how to run the demonstration of IPCAM, users may refer to other

documents for more detailed information. For example, users should have a development environment to

build the images from the source code and should know how to write applications with the interfaces

provided by each driver. The previous mentioned procedures are not explained in this document. Table 1-2

lists How-To and corresponding reference documents and positions for convenience.

Table 1-2. How-To and Corresponding Reference Documents and Positions

How-To Reference Documentation and Position

For beginner, using this SDK under the Linux environment and find the relative information about U-BOOT, boot loader, and device drivers

GM8126_Linux_User_Guide.pdf

DVR basic concept and AP programming GM8126_DVR_User_Guide.pdf

DVR basic AP sample code reference GM8126_IPCAM_API_Reference.chm

EVB User Guide GM8126_EVB_User_Guide.pdf

Capture resolution list GM8126_cap_sd_resolution_list.xls

Encoder buffer list GM8126_enc_buffer_list.xls


www.grain-media.com

3

1.2 Video Flow Diagram Figure 1-1 shows the video flow of 720P IPCAM and Figure 1-2 shows the video flow of 1080P IPCAM.

CMOS Sensor

CAP0_0

CAP0_1

CAP1_1

CAP1_0

ISP

TVE

H264MPEG4MJPEG

H264MPEG4MJPEG

H264MPEG4MJPEG

Scaler

H264MPEG4MJPEG

Scaler

720 at 30 fps RTSP/Record

RTSP

RTSP/Record

RTSP/Record

H264MPEG4MJPEG

RTSP/Record

720P at 30 fps

VGA at 30 fps

QVGA at 30 fps

QQVGA at 30 fps

176x128 at 30 fps

640x480 at 30 fps

1280x720 at 30 fps1280x720 at 30 fps

Mobile Phone

NTSC/PAL TV

SD Card

PC

SD Card

PCH264

(MPEG4)(MJPEG)

Enable ROIRTSP/Record

ROI (ePTZ) x 8ch

720P/ROI (ePTZ)

VGA at 30 fps

Roi_1 (x,y, 320x240)at 30 fps

Figure 1-1. Video Flow of 720P IPCAM


CMOS Sensor

CAP0_0

CAP1_1

CAP1_0

ISP

TVE

H264MPEG4MJPEG

H264MPEG4MJPEG

H264MPEG4MJPEG

Scaler

H264MPEG4MJPEG

Scaler

1080P at 15 fps RTSP/Record

RTSP/Record

RTSP/Record

RTSP/Record

1080P at 30 fps

VGA at 30 fps

QVGA at 30 fps

QQVGA at 30 fps

640x480 at 30 fps

1080P at 30 fps1080P at 30 fps

NTSC/PAL TV

SD Card

PC

SD Card

PC

H264(MPEG4)(MJPEG)

Enable ROIRTSP/Record

ROI (ePTZ) x 8ch

Full_resoluton/ROI (ePTZ)

VGA at 30 fps

CAP0_1H264

MPEG4MJPEG

720P at 15 fps720P at 15 fps

RTSP/Record

Middle_resolution 720P

Roi_1 (x,y, 320x240) at 30 fps

Figure 1-2. Video Flow of 1080P IPCAM

www.grain-media.com

4


www.grain-media.com

5

Chapter 2 Run Demonstration

This chapter contains the following sections:

• 2.1 Burn Image in GM8126 EVB

• 2.2 Prepare Executing Environment

• 2.3 Run Demonstration


www.grain-media.com

6

Several examples are addressed in this chapter to show users the steps to run the demonstration

programs of liveview, playback, and record. In this chapter, Grain Media will also show users how to run the

sample programs step by step.

2.1 Burn Image in GM8126 EVB Users can adopt the following files in SDK to burn the images in the target. This action should only be

executed once unless the files have new updates.

File Directory Path in SDK

rom.bin [SDK]/StartCell_Drivers/image

nsboot.bin [SDK]/Spi_nand/nsboot/image

u-boot_xxx.bin

linux

[SDK]/Embedded_Linux/image

Please refer to “GM8126_Linux_User_Guide.pdf]/[ GM8126_Flash_User_Guide.pdf” to complete this step.

After writing these images, users should erase the user data under /mnt/mtd in target before continuing

the next step.

2.2 Prepare Executing Environment Users should boot the system and find the following files in the target and copy these files to the correct

directories.

Product Name Item File Directory Path on Target

Config gmdvr_mem.cfg

config_8126

/product/IPC-1080P/memory

IPC RTSP Demo ipc.cfg /product/IPC-1080P/demo

isp_ov2715 isp_ov2715.cfg

boot_ov2715.sh

/product/IPC-1080P/module/isp_ov2715

IPC-1080P

Sensor module

isp_mt9p031 isp_mt9p031.cfg

boot_mt9p031.sh

/product/IPC-1080P/module/isp_mt9p031


www.grain-media.com

7



config_8126

/product/IPC-720P/memory

IPC RTSP Demo ipc.cfg /product/IPC-720P/demo


boot_ov2715.sh

/product/IPC-720P/module/isp_ov2715

isp_mt9p031 isp_mt9p031.cfg

boot_mt9p031.sh

/product/IPC-720/module/isp_mt9p031

isp_mn34031 isp_mn34031.cfg

boot_mn34031.sh

/product/IPC-720/module/isp_mn34031


boot_ov9710.sh

/product/IPC-720/module/isp_ov9710

isp_imx036 isp_imx036.cfg

boot_imx036.sh

/product/IPC-720/module/isp_imx036

IPC-720P

Sensor module

mt9d131 boot_mt9d131.sh /product/IPC-720/module/mt9d131


config_8126

/product/IPC-VGA/memory

IPC RTSP Demo Ipc.cfg /product/IPC-VGA/demo

IPC-VGA

Sensor module

ov7740 boot_ov7740.sh /product/IPC-VGA/module/ov7740


config_8126

/product/ IPC-D1 /memory

IPC RTSP Demo Ipc.cfg /product/ IPC-D1/demo

IPC-D1

Sensor module

tw99x0 boot_tw99x0.sh /product/IPC-D1/module/tw99x0


config_8126

/product/ IPC-D1 /memory

IPC RTSP Demo Ipc.cfg /product/ IPC-D1-VGA /demo

IPC-D1-VGA

Sensor module

tw99x0_ov7740 boot_tw99x0_ov7740.sh

/product/IPC-D1-VGA /module/tw99x0_ov7740


www.grain-media.com

8



config_8126

/product/IPC-D1-720P/memory

IPC RTSP Demo Ipc.cfg /product/ IPC-D1-720P/demo

tw99x0_ov9d131 boot_tw99x0_ov9d131.sh

/product/ IPC-D1-720P/module/tw99x0_ov9d131


isp_ov2715.cfg

/product/ IPC-D1-720P/module/tw99x0_ov2715


isp_ov9710.cfg

/product/ IPC-D1-720P/module/tw99x0_ov9710

IPC-D1-720P

Sensor module

tw99x0_mt9p031 boot_tw99x0_mt9p031.sh

isp_mt9p031.cfg

/product/ IPC-D1-720P/module/tw99x0_mt9p031


www.grain-media.com

9

Step 1: Check hardware connections

In this EV board, please ensure that the following ports are connected properly.

• Video input port: CMOS Sensor

• Video output port: CVBS

• Storage: None

• Peripheral: LAN and UART

Step 2: Boot

After powered on, the Linux bootstrap will start. The following messages provide users with information for

checking the correctness of the hardware environment and images, such as the IC name and Linux

version.

Linux version 2.6.28 ([email protected]) (gcc version 4.4.0 (Faraday C/C++ Compiler Release 20100325) ) #88 PREEMPT Thu Jun 9 15:25:30 CST 2011 CPU: FA626TE [66056261] revision 1 (ARMv5TE), cr=0000797f CPU: VIPT aliasing data cache, VIPT aliasing instruction cache Machine: Faraday GM8126 Warning: bad configuration page, trying to continue Memory policy: ECC disabled, Data cache writeback Built 1 zonelists in Zone order, mobility grouping on. Total pages: 32512 Kernel command line: mem=128M console=uart,shift,2,io,0xF9830000,38400 Early serial console at I/O port 0xf9830000 (options '38400', shift 2) console [uart0] enabled PID hash tableIC: GM8126 MP

entries: 512 (order: 9, 2048 bytes)

GM Clock: CPU = 540 MHz, AHBCLK = 270 MHz, PLL1CLK = 800 MHz, PLL2CLK = 540 MHz console handover: boot [uart0] -> real [ttyS0] Dentry cache hash table entries: 16384 (order: 4, 65536 bytes) Inode-cache hash table entries: 8192 (order: 3, 32768 bytes) Memory: 128MB = 128MB total Memory: 122808KB available (3613K code, 319K data, 2996K init) ...(skipped)

Note: Different executing environments will have different messages.

Step 3: Copy configurations files and run boot script file


www.grain-media.com

10

IPC-1080P/isp_ov2715

/ # cp /product/IPC-1080P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-1080P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-1080P/demo/ipc.cfg /mnt/mtd/ / # cp /product/IPC-1080P/module/isp_ov2715/isp_ov2715.cfg /mnt/mtd/ / # sh /product/IPC-1080P/module/isp_ov2715/boot_ov2715.sh

IPC-1080P/ isp_mt9p031

/ # cp /product/IPC-1080P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-1080P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-1080P/demo/ipc.cfg /mnt/mtd/ / # cp /product/IPC-1080P/module/isp_mt9p031/isp_mt9p031.cfg /mnt/mtd/ / # sh /product/IPC-1080P/module/isp_mt9p031/boot_mt9p031.sh

IPC-720P/isp_mn34031

/ # cp /product/IPC-720P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-720P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-720P/demo/ipc.cfg /mnt/mtd/ / # cp /product/IPC-720P/module/isp_mn34031/isp_mn34031.cfg /mnt/mtd/ / # sh /product/IPC-720P/module/isp_mn34031/boot_mn34031.sh

IPC-720P/isp_mt9p031

/ # cp /product/IPC-720P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-720P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-720P/demo/ipc.cfg /mnt/mtd/ / # cp /product/IPC-720P/module/isp_mt9p031/isp_mt9p031.cfg /mnt/mtd/ / # sh /product/IPC-720P/module/isp_mt9p031/boot_mt9p031.sh

IPC-720P/isp_ov2715


IPC-720P/isp_ov9710



www.grain-media.com

11

IPC-720P/isp_imx036

/ # cp /product/IPC-720P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-720P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-720P/demo/ipc.cfg /mnt/mtd/ / # cp /product/IPC-720P/module/isp_imx036/isp_imx036.cfg /mnt/mtd/ / # sh /product/IPC-720P/module/isp_imx036/boot_imx036.sh

IPC-720P/mt9d131

/ # cp /product/IPC-720P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-720P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-720P/demo/ipc.cfg /mnt/mtd/ / # sh /product/IPC-720P/module/mt9d131/boot_mt9d131.sh

IPC-VGA/ov7740

/ # cp /product/IPC-VGA/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-VGA/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-VGA/demo/ipc.cfg /mnt/mtd/ / # sh /product/IPC-VGA/module/ov7740/boot_ov7740.sh

IPC-D1-VGA/tw99x0_ov7740

/ # cp /product/IPC-D1-VGA/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-D1-VGA/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-D1-VGA/demo/ipc.cfg /mnt/mtd/ / # sh /product/IPC-D1-VGA/module/tw99x0_ov7740/boot_tw99x0_ov7740.sh

IPC-D1-720P/tw99x0_ov9d131

/ # cp /product/IPC-D1-720P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-D1-720P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-D1-720P/demo/ipc.cfg /mnt/mtd/ / # sh /product/IPC-D1-720P/module/tw99x0_ov9d131/boot_tw99x0_ov9d131.sh

IPC-D1-720P/tw99x0_ov2715

/ # cp /product/IPC-D1-720P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-D1-720P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-D1-720P/demo/ipc.cfg /mnt/mtd/ / # cp /product/IPC-D1-720P/module/tw99x0_ov2715/isp_ov2715.cfg /mnt/mtd/ / # sh /product/IPC-D1-720P/module/tw99x0_ov2715/boot_tw99x0_ov2715.sh


www.grain-media.com

12

IPC-D1-720P/tw99x0_ ov9710

/ # cp /product/IPC-D1-720P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-D1-720P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-D1-720P/demo/ipc.cfg /mnt/mtd/ / # sh /product/IPC-D1-720P/module/tw99x0_ov9710/ boot_tw99x0_ov9710.sh IPC-D1-720P/tw99x0_mt9p031

/ # cp /product/IPC-D1-720P/memory/gmdvr_mem.cfg /mnt/mtd/ / # cp /product/IPC-D1-720P/memory/config_8126 /mnt/mtd/ / # cp /product/IPC-D1-720P/demo/ipc.cfg /mnt/mtd/ / # cp /product/IPC-D1-720P/module/tw99x0_mt9p031/isp_mt9p031.cfg /mnt/mtd/ / # sh /product/IPC-D1-720P/module/tw99x0_mt9p031/boot_tw99x0_mt9p031.sh


www.grain-media.com

13

2.3 Run Demonstration There are two demonstrations in this SDK. The first demonstration shows the general IPCAM features; and

the other demonstration is the simple_ipc RTSP demonstration.

The first demonstration shows the general IPCAM features, please read

“GM8126_DVR_Programming_Guide.doc” for more information.

The following examples focus on the IPCAM applications that use the default settings.

Product sample using default settings

Item File Directory Path in SDK Image

Liveview liveview.c

2ch_liveview.c

pip.c

Record main-bitstream-record.c

mjpeg-record.c

mpeg4-record.c

sub-bitstream-record.c

update-bitrate.c

update-record-setting.c

motion-detection.c

snapshot.c

roi.c

Playback playback.c

2ch_playback.c

/product/samples/


www.grain-media.com

14

Run Liveview samples

# /product/samples/liveview

liveview.c sample shows one-channel liveview, the duration is 20 seconds.

# /product/samples/2chliveview

2ch_liveview.c sample shows two-channel liveview.

# /product/samples/pip

pip.c sample shows one channel to be layer 0 and another channel to be layer 1. Users should update the

position of layer 1 at window, then switch layer 0 to layer 1 and layer 1 to layer 0.

Run Record samples

# /product/samples/record

main-bitstream-record.c sample shows recording the main bit-stream for 20 seconds.

# /product/samples/mjpg

mjpeg-record.c sample shows recording the main bit-stream motion JPEG for 20 seconds.

# /product/samples/mpeg4

mpeg4-record.c sample shows recording the main bit-stream MPEG4 for 20 seconds.

# /product/samples/subrecord

sub-bitstream-record.c sample shows recording the main bits-tream + sub1 bit-stream + sub2 bit-stream

for 20 seconds.

# /product/samples/update-bitrate

update-bitrate.c sample shows that the main bit-stream only updates the bit rate. After recording 10

seconds, update the bit rate of the main bit-stream again.

# /product/samples/update

update-record-setting.c sample implements the main bit-stream + sub1 bit-stream + sub2 bit-stream to

update the record function; after recording 10 seconds, update the main bit-stream for recording; after

recording 15 seconds, update the sub1 bit-stream for recording; after recording 25 seconds, finish the

recording procedure.


www.grain-media.com

15

# /product/samples/motion

motion-detection.c sample implements the motion detection function without the ISP module and record

for 20 seconds.

# /product/samples/snapshot

snapshot.c sample implements the snapshot function, records for 15 seconds, triggers snapshot at 5th

second, and perform snapshot three times.

# /product/samples/roi

roi.c sample implements the ROI function, main_bitstream records for 20 seconds in the H264 format.

sub1_bitstram records for ROI (320x240)/ROI (640x480)/disable_ROI, and dynamically change the

position every second.

Run Playback sample:

# /product/samples/playback

playback.c sample implements the playback function and playback for 20 seconds. The demonstration file

is CH0_video_0.avi. Please place the demonstration file in the same directory with the executable binary

file.

# /product/samples/2CH_PB

2ch_playback.c sample shows two-channel playback.


www.grain-media.com

16

simple_ipc RTSP demonstration

Run simple_ipc

/ # /product/samples/simple_ipc --------------<Live View>------------ 1: LV Start 2: LV Stop ----------------<rtsp>--------------- r: RTSP Test ------------------------------------- Q: back to main menu ------------------------------------- r ----------------<RTSP>------------------------------------------------- Note: If users want to use PC's Player to connect to a RTSP live streaming, the following are examples: channel=0, rtsp://IP/live/ch00_0 channel=1, rtsp://IP/live/ch01_0 channel=2, rtsp://IP/live/ch02_0 ----------------------------------------------------------------------- Setup: f: Set power frequency 60/50 for ISP. u: Update configuration. ----------------------------------------------------------------------- 0: Stop 1: Start s: Show configuration Q: Exit ----------------------------------------

The default setting of the simple_ipc sample is ipc.cfg in /mnt/mtd/. Press “s” to show the detailed

configurations. Users can also change the settings of the bit rate and frame rate, and so on.

Press [1] to start.

Press [0] to stop.


www.grain-media.com

17

Setting VLC media player in PC site

Step 1: Execute VLC media player

Step 2: Select Media Open network stream


Step 3: Fill in network URL information and other related settings

Edit options: □:rtsp-caching=200□:rtsp-tcp

□ means a space.

Step 4: Users should be able to see the IP Cam stream video

www.grain-media.com

18


www.grain-media.com

19

Chapter 3 Default Configuration and Settings

This chapter contains the following section:

• 3.1 Configuration File


www.grain-media.com

20

3.1 Configuration File The system configuration files are listed in the following table.

[gmdvr_mem.cfg]

Only the used memory items are listed below.

Category Item Name Size Count Description

lcd 829440

1244160

8 720*576*2 (PAL with 3DI)

720*(576+288)*2 (PAL with 3DI and PIP)

3di_scl_in 829440 5 720*576*2

dvr_disp

lv_scl_in 829440 5 720*576*2

dvr_enc Please check 8126_enc_buffer_list.xls

dec_in 352512 5 (720*576/256)*64 + (720*576*1.5*0.4) dvr_dec

pb_scl_in 352512 3 (720*576/256)*64 + (720*576*1.5*0.4)