Difference between revisions of "10393 manual"

user@hostname:~$ ssh root@192.168.0.9

$ minicom -c on

port 0: http://192.168.0.9:2323/img
port 1: http://192.168.0.9:2324/img
port 2: http://192.168.0.9:2325/img
port 3: http://192.168.0.9:2326/img

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

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

root@elphel393:~# /usr/bin/str

rtsp://192.168.0.9:554
rtsp://192.168.0.9:556
rtsp://192.168.0.9:558
rtsp://192.168.0.9:560

gst-launch-1.0 -v playbin uri=rtsp://192.168.0.9:554 uridecodebin0::source::latency=0

or

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

vlc rtsp://192.168.0.9:554 --network-caching=0

• http://192.168.0.9/camogmgui.php

• /home/root, file prefix=test_, 1GB or 10min files whichever occurs first
  • setup and start (in one line):

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

• • stop recording:

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

http://192.168.0.9/autocampars.php?sensor_port=0 (stores to /etc/elphel393/autocampars0.xml)
http://192.168.0.9/autocampars.php?sensor_port=1 (stores to /etc/elphel393/autocampars1.xml)
http://192.168.0.9/autocampars.php?sensor_port=2 (stores to /etc/elphel393/autocampars2.xml)
http://192.168.0.9/autocampars.php?sensor_port=3 (stores to /etc/elphel393/autocampars3.xml)

Read:   http://192.168.0.9/parsedit.php?sensor_port=0&PAR1&PAR2
Change: http://192.168.0.9/parsedit.php?sensor_port=0&PAR1&PAR2 - update values - submit 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
Change for multiple ports at once:
        http://192.168.0.9/parsedit.php?immediate&sensor_port=0&PAR1=VAL1&*PAR1=MASK1&PAR2=VAL2&*PAR2=MASK2

# A port bit mask is set by adding a * to a parameter name, like *PAR1 - it is individual for each parameter.
# The mask is 4 bits - 1 bit per port, bit[0] = port 0,... bit[3] = port 3, where 1 - enabled, 0 - disabled:
#   0xf - the parameter's new value will be applied to all ports.
# More information

http://192.168.0.9/parsedit.php?sensor_port=0&immediate&TRIG_CONDITION=0&TRIG_OUT=0x66555&TRIG_PERIOD=10000000&TRIG=4

~# sync
~# shutdown -hP now

http://192.168.0.9/autocampars.php?reboot

root@elphel393:~# cat /dev/imu > /path/filename.log

PHP

If in the current firmware includes http://192.168.0.9/utils.php then the clock is checked every time the index page is opened (http://192.168.0.9). The clock is then updated if the browser time differs from the camera time by more than 24h.

It's also possible to force apply time using the following GET request:

http://192.168.0.9/utils.php?cmd=time&apply&ts=<timestamp_in_ms>
#example:
http://192.168.0.9/utils.php?cmd=time&apply&ts=1589913066650

eSATA port switching

• requres 10389
• available connections:
  • camera <=> internal SSD (default)
  • camera <=> external drive (external drive requires a separate power source)
  • PC <=> internal SSD
• More information

Firmware/software update

More information

Firmware images

• 20200520
• 20200508
• 20190321

Changelog

==20200520==
(rocko build)
* Set time on main page access - taking browser time and writing to 10393 if times differ by 24h+.
* Added script for sensor testing (switch to test pattern, check md5sum).
  Supporting MT9P006. Linked to main page.
* Main page:
  * Added links to page displaying MJPEG stream in canvas
  * Added more controls (FPS, Manual Exposure and Auto Exposure Limit)
  * Added quick switch to 1080p@30fps (MT9P006)
* Updated JPEG/JP4 decoding javascript plugin - less time (-10ms) spent on EXIF reading.
* Created utils.php, currenty helps to GET-request:
  * ports configuration
  * set/get system time
* Fixed snapshot button for cameras with unused ports in multicam/ UI.
==20200508==
(rocko build)
* updated camogm
* added FLIR Lepton driver to kernel
* added FLIR Lepton record to device tree
==20190321==
* overall minor changes
  * fixed photofinish demo
==20180511==
* added cron program
* multi cameras control interface
* multi camera system info reporting
* fixed rtc
==20180416==
* 20180419 - mt9f002: fixed changing window size
* mt9f002: added triggered mode
* mt9f002: added vertical and horizontal flips (mirror)
==20180406==
* added initial support for MT9F002 sensor: no triggered mode, no binning/decimation
* display serial number in http://camera-ip:port/meta
* decode jp4s on the index page (http://camera-ip)
* turn off auto wb button for all ports on the index page
==20180130==
* added photo finish demo
* fixed fps limit calcs for triggered mode
==20180118==
* raw.py & raw.php, see wiki.elphel.com
* added python3 and python3-opencv
==20180116==
* raw pixel data downloading through membridge
* added gcc,make
==20180109==
* fixed autoexposure
==20171228==
* + strace, ltrace, dmsetup
* added to drivers: register devs to sysfs - nodes then created by udev
==20171226==
* kernel updated to 4.9 (from 4.0)
* lots of drivers is updated to newer versions
* +dm-crypt and cryptsetup
==20171120==
* bugfix - incorrect displaying of TRIG_PERIOD at init
==20171115==
* Fixed autocampars to let 10393 work with the mux board - 10359, see wiki.elphel.com for
  docs
==20170823==
* Fixed autocampars for multiple sensors getting desynced at init
* Fixed Garmin GPS 18x USB driver
==20170802==
* fixed a page for taking snapshots - works in chrome and firefox for bigger images (>2MB)
* enabled "Access-Control-Expose-Headers: Content-Disposition" and CORS
==20170627==
* viewing decoded jp4 format in camvc
==20170623==
* fixed incorrect default setting of the master channel

Development

Usage of SDK, which is Eclipse and project tree cloned from git.elphel.com, simplifies the development. At the same time lots of things can be done using Python, PHP, JavaScript or C/C++ (if compiled on hardware) and do not require SDK.

Other info

Change default ip address

Modify /etc/network/interfaces, sync the changes to the file system and reboot (or rerun init scripts).

For firmware 20180511 or older, follow these instructions to fix network configuration (= disable setting ip address via /etc/elphel393/init_elphel393.py).

Add a program or a shell command to autostart on boot

There's a way to do this using cron or init.d but it might run before the sensors are initialized by init_elphel393.py. The recommended way is the following:

• nano or vi

ssh root@192.168.0.9
pass
root@elphel393:~# nano /etc/elphel393/init_elphel393.py
edit - save
example: to launch the rtsp streamer - add shout("/usr/bin/str") to the end of the file. shout() function is just a wrapper for subprocess.call(cmd,shell=True)

Then:

#boot from NAND flash?
root@elphel393:~# overlay_sync 1 
root@elphel393:~# shutdown -hP now
#powercycle

#boot from card?
root@elphel393:~# sync
root@elphel393:~# reboot -f

Set up histogram window and autoexposure parameters

Read article

Tools for calibrated systems

• Install ImageJ plugins
  • decode jp4 raw format
  • aberrations correction
  • distortion correction (pixel mapping)
  • rectification and projection
  • JP46 Reader camera - decode JP4/JP46
  • Eyesis correction - post-process JP4s using calibration data

Switch between ERS and GRR modes in MT9P006

• Read article

External/internal synchronization & triggering and FPS control for single/multi-camera systems

• Trigger_393

SSD/MMC/USB formatting

• Format_SSD_MMC

Boot modes

• Boot options

Pointers monitor

• Displays sensor, compressor and buffer states per 10393 port:

http://192.168.0.9/pointers/

Powering from batteries (12V or 48V)

12V and 48V power options

Accessing raw pixel values

Working with raw pixel data (how to capture raw images)

Photo finish (linescan mode)

Photo Finish (works for JP4 image format)

Controlling multiple cameras from single GUI

• Recording

Developers version's half enclosure

Available lengths for cables for connecting sensors in custom setups

• FPC cables - click for available lengths.
• The cables are asymmetrical - for correct connecting a sensor to a system board see the figure below. As a rule of thumb, the cable's back side (no contacts) will be on the same side with the connector's cover.

Connecting sensors to the system board

Known problems

• [SOLVED] Vertical artifacts in jpegs. Images are ok at 100% quality. Fixed, testing.
• [SOLVED] 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

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

• [SOLVED] 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

• [SOLVED] 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

• [SOLVED] When using overlays, deleting, existing in the lower layer, dirs can cause errors (hopefully it gets fixed someday), example:
  • /mnt/sda1 exists in lower layer: /tmp/rootfs.ro/tmp
  • upper layer is mounted to "/"

# rmdir /mnt/sda1
# mkdir /mnt/sda1
mkdir: cannot create directory '/mnt/sda1': Operation not supported