Difference between revisions of "10393 manual"

Revision as of 15:23, 19 December 2016

Important Notes

• As of 2016/12/15, the software ported from 10353 supports only 5MPix sensors, for 14MPix, please see:
  • older version of this manual with links to older software images

In the package

• 10393 camera system

Fig.1 10393 interfaces

• Power supply wall adapter (default: 18-75V, more information)
• CAT6 network cable
• μUSB-to-USB cable
• Recovery μSD card

Power on

• Plug in the power supply
• Connect to LAN using the network cable

Notes

• Boot time: ~30s
• The default boot is from the on-board NAND flash. More information on available boot options and recovery boot.

Defaults

• The default IP address is set in the /etc/elphel393/init_elphel393.py.

Command line access

• ssh from PC terminal:

$ ssh root@192.168.0.9

Serial console access

• Use a microUSB-USB cable to connect console μUSB port (see Fig.1) to PC - the cable's end should be thin enough otherwise interferes with an inserted mmc (multi media card = μSD card).

• In Linux the minicom program can be used

$ minicom -c on

Most likely the device will be /dev/ttyUSB0. Settings:

• 115200 8N1, no for hardware/software flow control

Web user interface (camvc)

http://192.168.0.9/closeme.html (will be changed soon):

• The page contains links to camvc user interface for each individual camera port.
• camvc was ported from the 10353 camera series:
  • many parameters like image format ,resolution, auto exposure, auto white balance can be changed from camvc.
  • pause compressor and search within buffered images
  • help tips available - see Fig.2 - select then mouse over a control element of interest

Fig.2 camvc help

Fig.3 camvc controls

Download live images

camvc

• For a currently opened port:

Fig.3 Acquire an image from the Camera Control Interface

browser

channel 1: http://192.168.0.9:2323/img
channel 2: http://192.168.0.9:2324/img
channel 3: http://192.168.0.9:2325/img
channel 4: http://192.168.0.9:2326/img

command line

wget http://192.168.0.9:2323/bimg -O filename.jpeg
wget http://192.168.0.9:2324/bimg -O filename.jpeg
wget http://192.168.0.9:2325/bimg -O filename.jpeg
wget http://192.168.0.9:2326/bimg -O filename.jpeg

Video

Display

Multipart JPEG stream

http://192.168.0.9:2323/mimg
http://192.168.0.9:2324/mimg
http://192.168.0.9:2325/mimg
http://192.168.0.9:2326/mimg

GStreamer

gst-launch-1.0 souphttpsrc is-live=true location=http://192.168.0.9:2323/mimg ! jpegdec ! xvimagesink

• Only mjpeg, no rtsp yet.
• More examples at Using GStreamer

Record (to internal storage)

• Recording to internal storage is performed by the camogm program
• important: Event logger (GPS, IMU, IMG, EXT) recording is started/stopped separately. See instructions below.
• For SATA devices camogm supports:
  • recording to a partition with a file system - up to 80MB/s
  • faster recording to a partition without a file system avoiding OS calls - up to 220MB/s
• Can record to an mmc partiton as well.
• More info
• If the prefix parameter, which is absolute path + prefix, for a channel is not set the file will be written somewhere to rootfs

browser

Example 1: (provide a correct media mount point - /mnt/sda1/)

command line

Example:

echo "format=mov;status=/var/tmp/camogm.status;prefix=/home/root/test_;duration=600;length=1073741824;start" > /var/volatile/camogm_cmd

echo "stop" > /var/volatile/camogm_cmd
sync

Record the Event Logger data (GPS, IMU, IMG & EXT)

• Start:

http://192.168.0.9/logger_launcher.php?cmd=start&file=/mnt/sda1/test.log&index=1&n=10000000

• Stop:

http://192.168.0.9/logger_launcher.php?cmd=stop

Change parameters

• http://192.168.0.9/autocampars.php - read & write parameters (through parsedit.php), save configuration (if booted from NAND flash - "shutdown -r now" will sync changes or copy /etc/elphel393/*.xml to /tmp/rootfs.ro/etc/elphel393/ (lower layer of overlayfs), if booted from mmc - no need to reboot, just sync)
• parsedit.php

The response is in XML form:

Read:

http://192.168.0.9/parsedit.php?immediate&sensor_port=0&PAR1&PAR2

Change:

http://192.168.0.9/parsedit.php?immediate&sensor_port=0&PAR1=VAL1&PAR2=VAL2

Note 1: It's just if the parameter value is specified it will be applied. The call can have mixed specified and unspecified parameters.

Note 2: The new value is read on the next call.

Notes

• parsedit.php and autocampars.php were ported from 353 camera series. There are a few changes from the originals related to 4x sensor ports:
  • parameters are individual for each sensor port - writing parameters to multiple port at once is controlled with a (bit-)mask input box
  • if opened w/o sensor_port specified the page will show links to available ports
  • sensor_port=x, where x=0..3 - in the address string - for a single sensor camera it is normally 0

Temperature monitor

• http://192.168.0.9/hwmon.html:
  • T_shutdown - automatic shutdown temperature level

Proper shutdown

• if not properly shutdown - μSD might get corrupted (run sync at least)

shutdown -hP now

Firmware image

• 20160804 (new)
  • root/pass
  • overlayfs enabled if rootfs is on flash - lower: /tmp/rootfs.ro, upper: /tmp/rootfs.rw - changes to the filesystem are made on:

reboot -f

or

shutdown -hP now

or (most likely will work but correct work is not guaranteed)

overlay_sync 

• 20160626 (old)
  • python scripts moved to /tmp - dependencies create pycs
  • init_elphel393.sh moved from μSD card to /etc in rootfs - boot from flash doesn't require an inserted card for fixed boards.
  • default IP address changed to 192.168.0.9 as in the image built from our repositories.
• 20160622 (old)
• 20160614 (old)
• 20160607 (old)
• 20160601 (old)
• 20160526 (old)
• 20160524 (old)
• 20160519 (old)

Known problems

• [solved] Vertical artifacts in jpegs. Images are ok at 100% quality. Fixed, testing.
• http://192.168.0.9:232x/noexif/mimg - multipart jpeg displays corrupted frames from time to time. Reason: network bandwidth?
• [solved] Sometimes on power-on (NAND flash boot) cannot mount the card's rootfs partition. Kernel Panics. Power off/on. Soft "reboot -f" works ok.

...
Kernel panic - not syncing: VFS: Unable to mount root fs on unknown-block(179,2)
...

More info

• Changing exposure/quality/gains - can corrupt images - needs testing.

• After rewriting rootfs to μSD card - some of the cards get a corrupted partition - re-partitioning (reformatting?) solves the problem.

On the camera the rootfs is mounted as RW and some of the files are changed (also links created) -
most of the changes are now moved to tmpfs but something might have been missed.

Notes

• In case rootfs is on flash, it might make sense (or maybe not as the history is updated only once on session exit) to disable bash sessions command history - disable bash history