wiki

OpenIPC Wiki

Table of Content

Installation: how to make OpenIPC running on certain hardware

Supported hardware and installation procedures are given on openipc.org site.

Please follow on site instructions for your CPU and video chip!

Here are some examples:

Hi3516cv300 with IMX291

[[Hi3516Ev300-IMX335]]

How to upgrade OpenIPC

Currently full automatic system upgrade like sysupgrade in OpenWRT is not supported. Use partial manual update instead.

Partial manual update

NB! Partial upgrade of U-boot and kernel are recommended only in special cases and should be done with caution.

The process is described on the main site on firmware page.

Frequently Asked Questions

No. Currently only HiSilicon HI35xx SoC are supported. But theoretically it is possible to support other architectures and boards. Though it will require a lot of efforts and thus it is not a near time focus of the project.

No. Currently it is not possible, though we are working on this.

Buildroot is faster for initial development for new platforms as it is minimalistic and has no dependencies. OpenWRT is convenient for users as a final product, but there are a lot of complexities, dependencies, and there is no point in developing without a community.

Other FAQs

Common network configuration can be done in Luci GUI:

http://<your camera IP>

[[3G_modems]] USB modems support in hilink and ppp modes

Graphical User Interfaces

There are two branches of OpenIPC currently:

OpenWRT based

GUI is based on Luci. There are menu sections for camera specific setup.

Buildroot based

Tere is a different interface planned… Still under development.

Power Over Internet PoE

It is advised to use 48V power adapters with RJ-45 connectors instead of 12V. With 12V adapters the current will be 4 times higher. High current can burn RJ-45 connectors and wires.

How to stream video to Internet

MiniHttp is the main streamer of the OpenIPC based system

It is important to tune configuration of MiniHttp by turning off unneeded protocols and features for better security and performance.

Config file is located in /etc/minihttp.ini

Debug mode:

killall -sigint minihttp; sleep 1; export SENSOR=`ipctool --sensor_id`; minihttp

Production mode:

killall -sigint minihttp; sleep 1; export SENSOR=`ipctool --sensor_id`; minihttp 2>&1 | logger -p daemon.info -t minihttp &

Custom build tools used in OpenIPC OS

Tools repository

ipctool - gets information about hardware and outputs it in common format. Can also be used to make backup and restore of the camera software (still experimental feature).

Integration examples with Digital Video Recording systems

[[Recording stream locally]] with various utilities.

[[YouTube as DVR]] hack

Tips and trick on monitoring OpenIPC system

How to get temperature from chip’s internal sensor (not all devices supported):

ipctool --temp

other commands to [[monitor temperature]]

[[snmp]]

Prometheus monitoring

[[prometheus-node]]

Monitoring templates

Prometheus node configuration

Prometheus is an open-source systems monitoring and alerting toolkit.

OpenIPC has prometheus node exporter as a package. The result output can be viewed as a plaintext:

http://192.168.1.10:9100/metrics

Or visualized if you install proemetheus server and graphana:

[[images/preometheus_node_graphana_example.jpg]]

You can configure the node here

/etc/config/prometheus-node-exporter-lua

Meta package

https://github.com/ZigFisher/Glutinium/tree/master/prometheus-node-exporter-lua

Experiments with I2C on Hi3518EV200

Setting up i2c-x via device tree

The standard i2c-hisilicon driver does not give an option to set pins to i2c mode if they were previously set to dts. To automatically set the required pins to i2c mode you just need to add the following code to the beginning of hi_i2c_hw_init (linux/drivers/i2c/busses/i2c-hisilicon.c)

#ifdef CONFIG_ARCH_HI3518EV200 // Might be the same for other hardware devices
if(pinfo->mem->start = 0x200d0000 /* address i2c-0 */) {
    writel(0x2, 0x200f0040);
    writel(0x2, 0x200f0044);
}
if(pinfo->mem->start = 0x20240000 /* address i2c-1 */) {
    writel(0x1, 0x200f0050);
    writel(0x1, 0x200f0054);
}
if(pinfo->mem->start = 0x20250000 /* address i2c-2 */) {
    writel(0x1, 0x200f0060);
    writel(0x1, 0x200f0064);
}
#endif

How to [[login inside]] original firmware

[[Majestic Log]] comments

[[DevTools]]

[[Docs on different IP cameras]]

Majestic Test Group

Tools used in Research and Development

hisi-trace –> tool to run Sofia inside the OpenIPC. Allows porting stock Sofia functions to the target system without loading in the original firmware.

some tools for dissassembling

Docs on currently unsupported SoC:

Novatek NV98515 SoC

Different hack & mod related to IP Cameras forums:

https://www.goprawn.com/

Below are some examples how to record video streams with various utilities.

gstreamer

gst-launch-1.0 rtspsrc location=rtsp://192.168.1.10:554/stream=0 ! rtpjitterbuffer ! rtph264depay ! h264parse ! mp4mux ! filesink location=stream0_h264.mp4 -e

gst-launch-1.0 rtspsrc location=rtsp://192.168.1.10:554/stream=0 ! rtpjitterbuffer ! rtph265depay ! h265parse ! mp4mux ! filesink location=stream0_h265.mp4 -e

ffmpeg

vlc

How to login inside original firmware

Information applicable only for XM-based camera firmware.

Enable telnet server

In U-Boot console:

setenv telnetctrl 1; saveenv

Connect with telnet

LocalHost login: root
Password: xmhdipc
Welcome to HiLinux.

Also can try other pairs

Optional: enable Linux kernel verbose boot (where armbenv exists)

# armbenv -s xmuart 0
# reboot

Or in case where XmEnv exists:

# XmEnv -s xmuart 0
# reboot

Enable telnet without even open your camera (remotely)

Document origin is here

Commands to measure chip temperature on various SoCs

Hi3516CV200 / Hi3518EV200 / Hi3518EV201

devmem 0x20270110 32 0x60FA0000 ; devmem 0x20270114 8  | awk '{print "CPU temperature: " ((($1)*180)/256)-40}'

Hi3516CV300 / Hi3518EV100

devmem 0x1203009C 32 0x60FA0000 ; devmem 0x120300A4 16 | awk '{print "CPU temperature: " (((($1)-125.0)/806)*165)-40}'

Hi3516EV200 / Hi3516EV300

devmem 0x120280B4 32 0xC3200000 ; devmem 0x120280BC 16 | awk '{print "CPU temperature: " (((($1)-117)/798)*165)-40}'

Hi3536D

himm 0x0120E0110 0x60320000 > /dev/null; himm 0x120E0118 | awk '{print $4}' | dd skip=1 bs=7 2>/dev/null | awk '{print "0x"$1}' | awk '{print "CPU temperature: " (($1*180)/256)-40}'

Hi3536C

himm 0x0120E0110 0x60320000 > /dev/null; himm 0x120E0118 | awk '{print $4}' | dd skip=1 bs=7 2>/dev/null | awk '{print "0x"$1}' | awk '{print "CPU temperature: " (($1-125)/806)*165-40}'

HI3520DV200

devmem 20060020 32

Hi3516AV200

#PERI_PMC68 0x120a0110 (disable-->enable)
himm 0x120a0110 0 > /dev/null;
himm 0x120a0110 0x40000000 > /dev/null;

usleep 100000
#PERI_PMC70 0x120a0118 read temperature
DATA0=$(himm 0x120a0118 0 | grep 0x120a0118)
DATA1=$(printf "$DATA0" | sed 's/0x120a0118: //')
DATA2=$(printf "$DATA1" | sed 's/ --> 0x00000000//')

let "var=$DATA2&0x3ff"
if [ $var -ge 125 -a $var -le 931 ];then
    echo `awk -v x="$var" 'BEGIN{printf "chip temperature: %f\n",(x-125)*10000/806*165/10000-40}'`
else
    echo "$var ---> invalid. [125,931]"
fi

Direct streaming to YouTube

YouTube offers not only LiveStreming but also can record this stream.

Up to 12 hours of LiveStream can be recorded.

Direct streaming to YouTube is possible but not currently supported by OpenIPC.

Direct streaming can be done with MiniHttp

Direct streaming to YouTube could be done with the help of RTMP but there are currently no plans add this protocol to the main streamer MiniHttp.

Direct streaming can be done with FFMPEG

There are two modes available: “old one”, H264 over RTMP an a “new one”, H265 over HLS.

Both methods were not tested in production and still in development mode. See following links for details:

H264 over RTMP

Navigate to the compiled package H264 over RTMP

Copy file silence.aac to /usr/lib/

and file ffmpeg to /usr/sbin/

Also set execution permission:

chmod +x /usr/sbin/ffmpeg

Run ffmpeg with the following parameters:

ffmpeg -stream_loop -1 -i /usr/lib/silence.aac -rtsp_transport udp -thread_queue_size 64 -i rtsp://127.0.0.1:554/stream=0 -c :v copy -c:a copy -f flv rtmp://a.rtmp.youtube.com/live2/

H265 over HLS

Some build instructions:

https://github.com/ZigFisher/Glutinium/blob/master/hi35xx-ffmpeg/0_Build.sh