SightLine Applications Command and Control SightLine Applications Command and Control 15. January 2015 Software Version 2.20 Copyright © 2014-2015 SightLine Applications, Inc.
SightLine Applications Command and Control Table of Contents Summary.................................................................5 IMPORTANT NOTIFICATON!.............................5 Sample Code...........................................................5 Protocol Changes....................................................6 Coordinate Systems............................................9 Bit & Byte Order................................................9 Packet Header......................................
SightLine Applications Command and Control Example:......................................................63 Current Ethernet Display Parameters (0x52)...80 Serial Port Parameters.................................63 Current Port Configuration (0x53)...................81 Protocol Parser.............................................63 Current Moving Target Indication Parameters Get Port Configuration (0x3F).........................64 (0x54)...............................................................
SightLine Applications Command and Control Table 12: Hardware Type ID....................................................................................................................14 Table 13: Application Bits (App Bits)......................................................................................................68 Illustration Index Illustration 1: Display Modes...................................................................................................................
SightLine Applications Command and Control Summary This document describes the packet-based messaging command and control protocol used by the SightLine Applications video embedded stabilization and tracking systems. IMPORTANT NOTIFICATON! Individual “Getter” commands have been replaced with a single generic getter command Get Parameters Function (0x28) which takes as an input the corresponding “Setter” command type id. For Example: Becomes...
SightLine Applications Command and Control Protocol Changes Summary of changes to protocol from previous release. See complete history below. Please also refer to the sample slfip.h and slfip.cpp. ADD Notes about Disable LIFO mode. MOD Set Network Parameters (0x1C) Add NIC index ADD Set Acquisition Parameters (0x37) New Video Port Types (SLA-2000/2100) MOD Version Number (0x40) Add “Other Version” for hardware dependent version information. e.g.
SightLine Applications Command and Control Current System Type (0x65) ADD Set Packet Destination (0x64) Location where Telemetry data will be sent over the network MOD Version Number (0x40) Added application bits ADD Command Pass-through (0x3D) Set SD Card Recording Parameters (0x1E) ADD Configure Communication Port (0x3E) Add attNav port setting. Added TCP pass-through and Raw pass-through modes.
SightLine Applications Command and Control Copyright © 2014-2015 SightLine Applications, Inc.
SightLine Applications Command and Control Coordinate Systems Image coordinates are referenced as row and column coordinates, with the origin in the upper left corner of the frame. Increasing column values are to the right, and increasing row values are downward in the frame. Unless otherwise identified, a video frame is 640 pixels wide and 480 pixels high. Bit & Byte Order All bits are “right aligned”.
SightLine Applications Command and Control header should be scanned for the the signature header bytes. NOTE: The checksum is also necessary when communicating over Ethernet with SightLine hardware.
SightLine Applications Command and Control Checksum Calculation Example: Data Description Action CRC 0x51 Header 1 Ignored 0x01 0xAC Header 2 Ignored 0x01 0x02 Length Ignored 0x01 0x07 Type Used Look up result 0x01 ^ 0x07 = 0x06 Table[6] = 221 (0xDD) Table 5: Example Checksum Calculation CRC should equal 221.
SightLine Applications Command and Control Transport Layer Inbound Port Reply Port UDP 14001 14002 Table 7: Ethernet Ports Used IP Address Assignment • You can set a STATIC IP address of the SLA-HARDWARE explicitly using Set Network Parameters (0x1C). • If no STATIC IP address has been set, the SLA-HARDWARE will attempt to obtain an IP address using DHCP. • If DHCP fails, the SLA-2000 will use a 192.168.1.ddd, where ddd is internally determined using its MAC address. • SLA-1500 (etc.
SightLine Applications Command and Control Discover Packet Payload 3 2 1 0 ID 4 Length 0 8 Major Version Minor Version 12 Software Features Hardware Type 16 MAC ADDRESS ... 36 IP ADDRESS (see Set Network Parameters (0x1C)) ... 52 Video Address (See Set Ethernet Video Parameters (0x1A)) ... 68 HOST NAME (see Set Host Name (0x66)) ...
SightLine Applications Command and Control SightLine Hardware Types See also Version Number (0x40). Description ID Description ID SLA-2000-OEM 0 SLA-1500-OEM 7 SLA-2100-OEM 1 SLA-1501-OEM 8 SLA-1000-OEM 4 SLA-UPGRADE-SRV 10 SLA-PC-WIN 5 SLA-PC-LINUX 6 Table 12: Hardware Type ID Host Name Default Host Name SLA_ Where MAC is last 3 octets of the MAC address.
SightLine Applications Command and Control Commands Common Commands For reference purposes, below are a list of the the most frequently used commands.
SightLine Applications Command and Control Get Version (0x00) Get Parameters Function (0x28) Version (0x00) Reset (0x01) Allow user to reset different aspects of the system. Byte offset Description 2 Packet length = 3 3 Packet type = 0x01 Reset Type: Value 4 Description 0 parameters only reset to factory defaults 1 video decoder 2 board soft reset (reboot board with saved defaults) 3 Stop application (SLA-1500-ONLY) 4 Deletes any saved parameter files and soft resets the board NEW 2.
SightLine Applications Command and Control 3 Packet type = 0x02 4 Mode: Bit Description 0 0 – Stabilization OFF (default) 1 – Stabilization ON 1 0 – Enable all (default) 1 – Disable all registration, stabilization, enhancement, and tracking 2 0 – Previous Images background, with blur and no color (default) 1 – Black background 3 Reserved - NOTE: Used for Auto-Bias in Current Stabilization Parameters (0x41).
SightLine Applications Command and Control Set Overlay Mode (0x06) Byte offset Description 2 Packet length = 5 3 Packet type = 0x06 4 Bits 0..3 Primary 0 = off track color mode 1 = white (default) 2 = black 3 = auto (white or black) 4 = rainbow 5 = red 6 = orange 7 = yellow 8 = green 9 = blue 10 = violet Bits 4..7 Primary 0 = box corners (default) track reticle type 1 = cross 2 = circle 3 = duplex crosshair 4 = modern range 5 = target dot 6..
SightLine Applications Command and Control 0 = don't 1 = do Start Tracking (0x08) (Deprecated) See Modify Tracking (0x05) Command the system to start a track. Column and Row coordinates correspond to the pixel coordinate within a 640x480 frame of video in display (stabilized) coordinates. The origin is in the upper left corner of the image with values increasing down and to the right. Up to 5 tracks may be simultaneously engaged. Byte offset Description 2 Packet length = 7 3 Packet type = 0x08 4 0..
SightLine Applications Command and Control a track, etc. Column and Row coordinates correspond to the pixel coordinate within a 640x480* frame of video in display (stabilized) coordinates. The origin is in the upper left corner of the image with values increasing down and to the right. Up to 5 tracks may be simultaneously engaged. See the Target Tracking Guide for more details about multiple target tracking.
SightLine Applications Command and Control to location of coordinates and designate as primary. Otherwise, add a new track at coordinates and make primary. 0x08 If there is a track near coordinates, move track to location of coordinates and designate as primary. Otherwise, kill all existing tracks and add a new primary track at location of coordinates. 0x09 Kill track near coordinates. 0x0A Kill all tracks, but the primary track. (Coordinates are ignored).
SightLine Applications Command and Control 2 Packet length = 5 3 Packet type = 0x0A 4 -128..127: Column adjustment (2's complement signed 8-bit integer) 5 -128..127: Row adjustment (2's complement signed 8-bit integer) 6 Nudge Mode: 0: Do not rotate command with display 1: Rotate command with display Nudge Mode Applies the display rotation set using Set Display Parameters (0x16) to the nudge command. Assume rotation enable to 45°.
SightLine Applications Command and Control Flags: Types of Output Bit 5 6 Description 0x00 (DEFAULT) Send Tracking Position and Tracking Positions of primary track only. Same as 0x03 0x01 Send Tracking Position - sends Tracking Position (0x43) 0x02 Send Tracking Positions of primary track – sends Current Tracking Positions (0x51) 0x04 Send Tracking Positions of non-primary tracks – sends Current Tracking Positions (0x51) 0x20 Prioritize Stab/Track/Telemetry over Render/Enhance/Compress/Display.
SightLine Applications Command and Control on. Bit 4 High noise compensation 0 = off (default) 1 = on – improves tracking in very high noise situations Bits 5..7 Reserved = 0 6 Size of object of interest, in pixels. (Used for clustering in motion assist and motion detection systems.) 0 = no change. 7 Maximum number of frames to keep looking for a non-found object before stopping a track. (Default is 45 frames or 1.5 seconds.) Controls how long a track can be off screen or obscured (eg.
SightLine Applications Command and Control least 120x120. MOD 2.17 9 Right image edge pixel band to ignore. 0..255 0 is default. 10 Top image edge pixel band to ignore. 0..255 0 is default. 11 Bottom image edge pixel band to ignore. 0..255 0 is default. Use the “ignore edge pixel band” to indicate that the registration algorithm to not include these pixels when determining the registration match.
SightLine Applications Command and Control Automatically reset video decoder when failed frame synchronization loss is detected Value 10 Description 0 Never 1 When frame synchronization loss detected Set Stabilization Bias (0x12) Adjust the stabilization solution by adding a constant bias in pixel coordinate space to the current coordinates each frame. This is used to feed forward user controlled camera motion so that stabilization does not “fight” against camera pan and tilt.
SightLine Applications Command and Control 14 – 15 Platform heading angle (bit 1) unsigned 16-bit integer 16 – 17 Platform pitch angle (bit 2) signed 16-bit integer 18 – 19 Platform roll angle (bit 3) signed 16-bit integer 20 – 21 Sensor latitude (bit 4) signed 32-bit integer 24 – 27 Sensor longitude (bit 5) signed 32-bit integer 28 – 29 Sensor altitude (bit 6) unsigned 16-bit integer 30 – 31 Sensor horizontal field of view (bit 7) unsigned 16-bit integer 32 – 32 Sensor vertical field of view
SightLine Applications Command and Control 15 = Target Error Estimate LE90 16 = Generic Flag Data 01 17 = Platform Call Sign 5 6 – (6+n-1) Identifier string length (n) Identifier string Set Metadata Frame Data Values (0x15) Sets new KLV metadata frame data values. Latest values are output with H.264 digital video stream. Byte offset Description 2 Packet length = 20 3 Packet type = 0x15 4–5 Valid data bit mask. Update corresponding data element when bit value = 1.
SightLine Applications Command and Control 1 Mission ID (3) 27 Security: Object country coding method (48/12) 2 Platform heading angle (5) 28 Security: Object country (48/13) 3 Platform pitch angle (6) 29 Security: Metadata version (48/22) 4 Platform roll angle (7) 30 UAS local set version (65) 5 Platform designation (10) 31 Motion imagery core identifier (94) 6 Image source sensor (11) 32 Platform tail number (4) 7 Sensor latitude (13) 33 Offset corner latitude point 1 (26)* 8 Sensor longitud
SightLine Applications Command and Control ***Values are calculated from internal tracking information. Multiple targets (either user-designated or automatically-generated) are indicated. Pixel coordinates are in “display” coordinates suitable for directly rendering over streamed digital video. Sets the frame step rates at which KLV metadata is output.
SightLine Applications Command and Control 0x00, 0x00, // KLV Data 0x06, 0x0e, 0x81, 0x89, 0x6d, 0x70, 0x20, 0x53, 0x63, 0x61, 0x02, 0x00, 0x02, 0x00, 0x00, 0x13, 0x00, 0x00, 0x00, 0x15, 0x7a // Reserved (155 bytes) 0x2b, 0x34, 0x02, 0x02, 0x08, 0x00, 0x6c, 0x65, 0x20, 0x69, 0x67, 0x68, 0x74, 0x69, 0x6f, 0x00, 0x0d, 0x04, 0x00, 0x10, 0x02, 0x04, 0x00, 0x00, 0x00, 0x18, 0x04, 0x04, 0x00, 0x00, // Checksum (must be 0) 0x0b, 0x04, 0x4b, 0x74, 0x6e, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0xb2, 0x4c, 0x4c, 0x73,
SightLine Applications Command and Control 40, 41 = Blue, Blue inverted 127 = User Palette. See Set User Palette (0x72) command. Bit 7: Zoom mode 0 = zoom to center of display 1 = zoom to tracking box 10 Zoom – digital image magnification factor times 64. 0 to 31 – No zoom (1X) (subject to change) 32 to 63 – Zoom out by 0.5 to 0.98 64 – No zoom (1X) 65-255 – Zoom in by 1.01 to 3.98 NOTE: Zoom factors may be further limited for some HD camera and hardware combinations.
SightLine Applications Command and Control 128 = default 255 = bright 5 Contrast 0 = minimum contrast 128 = default 255 = maximum 6 Saturation 0 = no color 128 = default 255 = maximum 7 Hue 8-bit signed integer (-128..
SightLine Applications Command and Control 0 to 100 (default 0) 6 Frame Step - 1 shows every frame, 2 shows every other frame, etc. Applies to both MJPEG and H.264 Ethernet video. 1 to 120 (default 1) 7 Lower nibble: Down Sample – Whole integer value that image will be down sampled by. Applies to both MJPEG and H.264 Ethernet video. 0, 1 = no downsample 2 = 2x2 downsample 4 = 4x4 downsample NOTE: Down Sample 4 is not supported for MJPEG on SLA2x00. (default 1) Down sample is not supported on SLA-3000.
SightLine Applications Command and Control Byte offset Description 2 Packet length = 22 NEW 2.20 3 Packet type = 0x1C Mode 4 0 Use DHCP (bytes 5 -16 ignored) 1 Use Static IP address 5–8 IP ADDRESS (dot form, e.g. 192 168 1 197) 0 = No Change 9 – 12 Subnet Mask (dot form, e.g. 255 255 255 0) 0 = No Change 13 – 16 Gateway (dot form, eg. 192 168 1 1) 0 = No Change 17 18 19 – 20 MSB Command and Control Reply Port LSB (0 = No Change) Reserved MOD 2.
SightLine Applications Command and Control Disable Last In First Out (LIFO) By default, the last client to send a command packet will get all future telemetry responses. If disable LIFO field is set to 1, the client must add themselves to response list via Set Packet Destination (0x64). For example, Client A sends commands to the SLA-HARDWARE for configuring stabilization and Set Coordinate Reporting Mode (0x0B) frequency to 10 Hertz.
SightLine Applications Command and Control Clear Flash 5 6 0 Don't clear 1 Clear flash. If a recording is in progress, it will be stopped. 2 If a file name is specified, only that file will be deleted. Reserved Get Directory 0 Don't get directory 7 1 Get directory information.
SightLine Applications Command and Control Hello42 Hello42.ts Count is not appended for FileName ending in a numeric character. NOTE: The file name count resets to 0 on power up. Files will be overwritten if you use the same base file name after a power cycle.
SightLine Applications Command and Control 6 Display Modes Value 0 One UP 1 Picture In Picture 2 Two Up 3 Quad Screen 4 Blended (see also Set Blend Parameters (0x2F)) 5 Stitch 6 Side-By-Side 8 NTSC_VBI (SLA-1500,2000 only) 9 NTSC_VBI and Network (SLA-1500,2000 only) 10– 15 7 9 – 11 12 Copyright © 2014-2015 SightLine Applications, Inc.
SightLine Applications Command and Control 3 screen size zoom on primary track NEW 2.17 8 1 screen size zoom on primary track NEW 2.
SightLine Applications Command and Control Display Modes Illustration 1: Display Modes Illustration 2: Picture-In-Picture Scale Illustration 3: Picture-In-Picture Quadrant Camera Display Order Defines the order in which cameras will be displayed for display mode. For Example: 0 1 1 0 Display order 0,1,2,3 Display Order 1,0,2,3 When using BLEND mode, the first field for Camera Display Order value should be set to “8”.
SightLine Applications Command and Control Byte offset Description 2 Packet length = 6 3 Packet type = 0x21 4 Enhancement Mode Bits 0..3 Enhancement filter mode: 0 = None (default) 1 = CLAHE 2 = LAP Bits 4..7 Sharpening: 0 (none)..15 (max) 5 Alpha blending term 0..255 (200 nominal): 0 = use input frame only 128 = 50/50 mix 255 = use filtered frame only) 6 Enhancement Parameter (Kernel) Bits 0..6 0..
SightLine Applications Command and Control 9 Bits 0..3 0 = Filter All Edges (Default) 1 = Disable All Filtering 2 = Disable Slice Edge Filter Other values = Reserved Bits 4..
SightLine Applications Command and Control Get Parameters Function (0x28) The value of the ID field corresponds to the “Setter” of the same type. Response packets are unique and have their own ID.
SightLine Applications Command and Control Byte offset 2 Packet length = 3 (or 5 for 3000) 3 Type = 0x28 4 ID (0x1A, 0x23, or 0x29) 5–6 (*2) Description 3000 only: [Optional] Network Display ID (0x0002=Net0, 0x0040=Net1), if not present, then Net0 is assumed Get Configuration (3000 only) This packet gets sent from SLA-3000 as a response to the Get Parameter / Get Configuration command.
SightLine Applications Command and Control sends compressed source input image 3 H.264 (HD) – SLA-1500 only 3 - 14 Reserved 15 None 4..6 Reserved, set to 0 7 Broadcast Ethernet video 0 Disable Broadcast Video (default) 1 Enable Broadcast (e.g. 255.255.255.255) Note setting this option may interact strongly with other network traffic. Use with caution. Affects H.264 video ONLY.
SightLine Applications Command and Control Set Stitch Parameters (0x2B) Set the parameters for image stitching mode. Requires Set Video Mode (0x1F) be used to set number of camera inputs to 2, display to Network Mode. Byte offset Two raw images Description 2 Packet length = 10 3 Packet type = 0x2B 4 Reserved = 0 5 Shift camera one up. (0 … 255) number of pixels 6 Shift camera one right. (0 … 255) number of pixels 7 Shift camera one down. (0 … 255) number of pixels 8 Shift camera one left.
SightLine Applications Command and Control mode takes the most compute resource and is the most likely to run at less than full frame rate if other processing is also enabled (such as network video output). 4. Mobile Small Moving Target Indication. This mode works well when the camera is either stationary or slowly moving. It can find objects that are small and move at slow, fast or varying rates of speed. It will lose objects that stop moving.
SightLine Applications Command and Control sensitivity. Default is 5. The moving target indication sensitivity refers to the algorithm's “threshold” for deciding whether a particular candidate moving target is a moving target or a false positive. A lower value translates into greater sensitivity to moving targets and faster detection time, but also may introduce more false positives.
SightLine Applications Command and Control MaxWide s16 Maximum target width (pixels) (-1 = not set) MinHigh s16 Minimum target height (pixels) (-1 = not set) MaxHigh s16 Maximum target height (pixels) (-1 = not set) MaxThresh u8 Maximum automatic threshold (0 to 255 grey levels). A lower level results in higher sensitivity, but more false detects. NFramesBack u8 Number of frames to go back in time to compare frames in MTI difference mode. (1 to 15). Default 15.
SightLine Applications Command and Control exceeds this value for BgWarpFrames frames. 0 to 180, default 1 BgWarpFrames u8 Warp the background model if the above conditions are met for this number of consecutive frames. 0 to 255, default 2. Allows for ignoring a small number of bad frames or temporary large motion, but warps when there is a significant amount of motion. MaxTrackFrames u16 Number of frames to keep tracking once target has disappeared. 0 to 65535. 0 = automatic.
SightLine Applications Command and Control Byte offset Description 2 Packet length = 17 3 Packet type = 0x2F Bit 0 Offset Mode (see examples below) 0 Interpret bytes 5&6 as incremental offsets 1 Interpret bytes 5&6 as absolute offsets Bit 1 Absolute Zoom Mode NEW 2.20 0 Zoom (1 … 255) maps to (0.9 … 1.1). Usually used when both cameras are SD or have matching pixel size on target. 4 1 Zoom (1 … 255) maps to (0.004 … 0.996). Usually used when one camera is HD and the other is SD.
SightLine Applications Command and Control (shown in red) with the EO image. Typically used to highlight hot areas in a daytime EO image. 3 Night Blend – blends bright areas from the EO camera (modify color with Hue) with the IR image. Typically used to highlight bright lights in a night time IR image. 4 Color Blend - percentage (controlled by Amount) blending of the two images like Frame Blend, but the color from the EO image is also passed to the output (also controlled by Amount).
SightLine Applications Command and Control parameters in byte 18 below. Indicate index of preset alignment parameters. This byte ignored if byte 17 above is set to zero. NEW 2.20 18 Offset Mode Examples If byte 4 is 1, then field is interpreted as absolute offset e.g. new EO horizontal offset (relative to EO image) = byte 5 If byte 4 is 0, then field is interpreted as incremental offset e.g.
SightLine Applications Command and Control 5 SLA-2000 0 to 3 4 SLA-2100 0 and 1 2 SLA-1500 0 and 1 2 Video Port Types (SLA-2000/2100) Video Port Types (SLA-1500) 6–7 High (pass 0 for default) NOTE: High, Wide and Bit Depth are ignored except in Generic Digital Mode.
SightLine Applications Command and Control Video Port Types (SLA-2000/2100) Port ID 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 – 255 Description Disabled Hardware Support NOTE: Save parameters and reset to change between PAL and NTSC. NOTE: Sets all analog camera ports to NTSC.
SightLine Applications Command and Control Video Port Types (SLA-1500) Port ID Description 0 Disabled 1 NTSC (Auto) 2 Generic Digital 3–6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 – 255 Reserved 720P 1080P 1080I FLIR TAU 640 8 Bit FLIR TAU 640 14 Bit Reserved PAL Reserved HD Hitachi 720 P DRS Tam 640 8 bit DRS Tam 640 14 bit DRS Tam 320 8 bit DRS Tam 320 814 bit Alticam Barracuda 600P HD-SDI 720P 30 NTSC VBI HD SONY 7500 720P 30 HD SONY 7500 1080P 30 Reserved Hardware Support Automatical
SightLine Applications Command and Control Get Acquisition Parameters (0x38) Get video port configuration. Causes a Current Acquisition Parameters (0x4F) message to be sent. Byte offset Description 2 Length = 3 3 Type = 0x38 4 Video Port Index Draw Object (0x3B) Draw user specified overlay graphics on the screen. All coordinates in this message are specified in with the center of the image at (0, 0) and the upper left corner at (-image width/2, -image height/2).
SightLine Applications Command and Control Value = 4 Reserved Value = 5 This mode should be used for static overlays such as text. Bit 7 If bit 7 = 0, then coordinates are specified with the center of the image at (0, 0). This means that the upper-left corner is at (-display width/2, -display height/2) or (-source width/2, -source height/2) depending on the coordinate mode. If bit 7 = 1, then coordinates are specified with the upper left corner of the image at (0, 0).
SightLine Applications Command and Control Text Length of the text string (referred to as “length” below) TextEx [12] = horizontal scale shifted left 5 (e.g. 32 means no scaling. 0 is also interpreted as no scaling).
SightLine Applications Command and Control Stop Selected Track (0x3C) Command the system to stop the currently selected track. Byte offset Value Description 2 0x02 Packet length 3 0x3C Packet type 4 0x43 Checksum Command Pass-through (0x3D) Outputs data payload to the port specified. Use Configure Communication Port (0x3E) to setup the inbound and outbound physical ports.
SightLine Applications Command and Control Header LEN Type Port Payload 0x51 0xAC 0x08 0x3D 0x01 0x48 0x45 0x4c 0x4c 0x4F Checksum 0xCB H E L L O Where length = type + dest port + payload + checksum = 1 + 1 + 5 + 1 = 8 Configure Communication Port (0x3E) Configure one of the communication ports. Current setting can be retrieved using Get Port Configuration (0x3F).
SightLine Applications Command and Control the serial port. NEW 2.18 NOTE: Serial ports do not offer hardware or software flow control. NOTE: For parameter changes to take effect, a board soft reset should be performed, by issuing Save Parameters (0x25) and Reset (0x01) (Reset Type = 2, soft reset) messages. KLV Pass-through receives formatted KLV metadata via serial port generated by an external processor. This KLV metadata is injected into the MPEG2-TS stream along with compressed digital video.
SightLine Applications Command and Control 1 Scan Eagle Aquarius 2 FLIR TAU 3 SLA Protocol (SLA-1500 at Port 0 only) Get Port Configuration (0x3F) Results in the generation of either a Current Port Configuration (0x53) or a Current Network Parameters (0x49). Byte offset Description 2 Length = 3 3 Type = 0x3F 4 Destination Port ID (see above) Set SnapShot (0x5E) Set up parameters for image snapshot to an FTP server or onboard MicroSD.
SightLine Applications Command and Control Image Source 6 0 Reserved 1 Captured image 2 Display image 3 – 15 7 Reserved Quality – JPEG compression quality level 0 to 100 (default 80) Down Sample 8 1 Full Resolution 2 2x2 downsample 4 4x4 downsample (SLA-1500 SD images only) All other values Reserved 9 – 12 IP ADDRESS of the FTP server. (dot form, eg.
SightLine Applications Command and Control 3 Packet type = 0x60 4 Frame Step – step between frames (e.g. 2 = every other). (default 1) 5 Number of frame snapshots to take. (default 1) 6 [REQUIRED] File Name Length - length of file name string (Default 0) 16 - 6+fileNameLen-1 [OPTIONAL - RECOMMENDED] FileName – Base file name of saved files (see below). FILE NAMING: If FileName ends with non-numeric characters, file will save to _NNNN.
SightLine Applications Command and Control SUM 0x51 0xAC 0x0a 0x60 0x01 0x01 0x05 0x68 0x65 0x6c 0x6c 0x6f 0x95 hello_0001.jpg is now on the MicroSD card.
SightLine Applications Command and Control Version Number (0x40) Get Parameters Function (0x28) Reports software and hardware version numbers. Get Version Number (0x00) Byte offset Description 2 Packet length = 17 3 Packet type = 0x40 4 Software Version Major 5 Software Version Minor 6 Reserved 7 Temperature (degrees F) 8 – 10 Hardware UID 11 – 14 Application Bits (app bits) NEW 2.18 below 15 Hardware Type NEW 2.
SightLine Applications Command and Control Current Stabilization Parameters (0x41) Get Parameters Function (0x28) Set Stabilization Parameters (0x02) Describes the current stabilization mode. See also Set Stabilization Parameters (0x02) and Set Stabilization Bias (0x12).
SightLine Applications Command and Control 4 5 6 Bits 0..3 Primary track color mode Same as primary track color mode, above Bits 4..7 Primary track reticle type Same as primary track reticle type, above Bits 0..3 Secondary track color mode (SLA-2000 only) Same as primary track color mode, above Bits 4..7 Secondary track reticle type (SLA-2000 only) Same as primary track reticle type, above Bit 0 Overlay cursor. 0 = don't, 1 = do Bit 1 Overlay track box.
SightLine Applications Command and Control Positive values of offset indicate shifts down and to the right.
SightLine Applications Command and Control bytes 10 & 11). See below for how to extract scene translation. NEW 2.17 24 & 25 Scene frame to frame rotation (-128 to 127 degrees)*128 (signed 16 bit integer) NEW 2.17 26 & 27 Scene frame to frame scale change factor * 256. 1.0*256 indicates no change. (unsigned 16 bit integer) NEW 2.
SightLine Applications Command and Control 7 Reserved – set to 0 Current Registration Parameters (0x45) Get Parameters Function (0x28) Set Registration Parameters (0x0E) Byte offset Description 2 Packet length = 10 3 Packet type = 0x45 4 Maximum frame to frame translation in pixels, LSB. 0 = the maximum allowed which is ½ of the frame size. (default 0) 5 Maximum translation in pixels, MSB 6 Maximum rotation range in degrees per frame: 0..10.
SightLine Applications Command and Control 0 = no deinterlacing 1 = apply digital deinterlacing 10 Automatically reset video decoder when failed frame unsynchronization detected 0 = Never 1 = When frame unsynchronization detected Current ADC Parameters (0x47) Get Parameters Function (0x28) Set ADC Parameters (0x18) NEW: 2.18 This command now returns all the values that can be set using Set ADC Parameters. See Set ADC Parameters (0x18) for packing order and description of the results.
SightLine Applications Command and Control 255 = use filtered frame only) 6 Bits 0..6 0..127 None: not used CLAHE: contrast limit (typical 25) LAP: width of high pass kernel, clipped to 0..18.
SightLine Applications Command and Control Current Stitch Parameters (0x4C) Get Parameters Function (0x28) Set Stitch Parameters (0x2B) Byte offset Description 2 Packet length = 13 3 Packet type = 0x4C 4 Reserved 5&6 Camera one up shift. (0...480) number of pixels. (signed 16-bit integer) 7&8 Camera one right shift. (0...640) number of pixels. (signed 16bit integer) 9&10 Camera one down shift. (0...480) number of pixels. (signed 16bit integer) 11&12 Camera one left shift. (0...
SightLine Applications Command and Control 10 Zoom scale factor applied to EO camera (1 … 255). Maps to (0.9 … 1.1) or to (0.004 to 0.996), depending on Absolute Zoom Mode in byte 4 11 Blend Mode Value Description 0 don't change/default. 1 FrameBlend 2 ThermalBlend 3 NightBlend 4 Color Blend 12 Amount defines the amount of luminance information from the EO (visible) camera to include in the blended result. Applies to: FrameBlend, NightBlend, ColorBlend and ThermalBlend modes.
SightLine Applications Command and Control 8–9 Display Width 10 – 11 Display Height 12 – 13 Display Rectangle Column Offset 14 – 15 Display Rectangle Row Offset 16 – 17 Display Rectangle Width 18 – 19 Display Rectangle Height Current Acquisition Parameters (0x4F) Sent in response to a Get Acquisition Parameters (0x38) command. Same as Set Acquisition Parameters (0x37). HardwareID (0x50) Get Parameters Function (0x28) Get HardwareID (0x50) Reports the HardwareID.
SightLine Applications Command and Control Current Tracking Positions (0x51) Periodic report of all track's positions. Tracking and scene confidence scores indicates the system's confidence between 0 (low) and 100 (high). Tracking positions are in camera (un-stabilized) coordinates. Enabled using the Set Coordinate Reporting Mode (0x0B) command. For reporting telemetry to multiple destinations see Set Packet Destination (0x64).
SightLine Applications Command and Control n+16 Track Confidence (0 … 100) n+17 Mode Bit Value 0 0 = Not Primary 1 = Primary see Designate Selected Track Primary (0x32) 1 0 = Not Selected 1 = Selected 2 – 3 SL_TRACK_RESULT_STATE NEW 2.18 4 – 7 SL_TRACK_STATE NEW 2.
SightLine Applications Command and Control Current Port Configuration (0x53) Get Port Configuration (0x3F) Format is the same as Configure Communication Port (0x3E). Current Moving Target Indication Parameters (0x54) Get Parameters Function (0x28) Set Moving Target Indication Parameters (0x2D) Same as Set Moving Target Indication Parameters (0x2D), except that the length is only 7 with the final “reserved” parameter removed. Current H.264 Video Parameters (0x56) Get Parameters Function (0x28) Set H.
SightLine Applications Command and Control names that need to be sent, multiple packets (groups) might be needed. Byte offset Description 2 Length = variable 3 Packet Type = 0x58 4&5 Total number of files (16 bit-integer) 6&7 Start index in this packet (0 to nfiles-1) 8&9 End index in this packet (0 to nfiles-1) 10...10+(endIndex-startIndex+1) Length of filename start … Length of filename end 10+(endIndex-startIndex+1)..
SightLine Applications Command and Control Current SnapShot (0x5D) Get Parameters Function (0x28) Set SnapShot (0x5E) 2 Packet length = 18 + uLen + pLen + fLen 3 Packet type = 0x5D 4 Reserved, set to 0 5 Reserved, set to 0 6 Source – 1: Captured image, 2: Display image 7 Quality – JPEG compression quality level 0 to 100 (default 80) 8 Down Sample – 1: none, 2: 2x2 downsample, 4: 4x4 downsample 8– 11 IP ADDRESS (dot form, eg. 192 168 1 197) of the FTP server.
SightLine Applications Command and Control System Type Bit 4–5 Functionality 0 Analyze - System will perform image processing and will produce telemetry 1 Render - System will perform rendering/display 2 Deprecated NEW 2.20 3 – 15 Reserved Set Packet Destination (0x64) Used to configure the output destination for TELEMETRY. See Set Coordinate Reporting Mode (0x0B) for the types of telemetry output that are available. Byte offset Description 2 Packet length = 4 3 Packet type = 0x64 NEW: 2.
SightLine Applications Command and Control Current System Type (0x65) See Set System Type (0x63). Set Host Name (0x66) Get Parameters Function (0x28) Host Name (0x66) See also Set Network Parameters (0x1C) and Discover Protocol. Byte offset Description 2 Packet length = 33 3 Packet Type = 0x66 NEW 2.
SightLine Applications Command and Control Individual fields are delimited by a semicolon (;) followed by a carriage return line feed. Byte offset Description 2–3 Packet length = Variable 4 Packet type = 0x6A 5–N N bytes which are parameter data strings Example payload: ... quality = 80; foveal = 0; frameStep = 1; downSampleFactor = 1; h264.targetBitRate = 1500000; h264.intraFrameInterval = 30; h264.lfDisableIdc = 0; h264.airMbPeriod = 0; h264.sliceRefreshRowNumber = 0; vtep[0].
SightLine Applications Command and Control 5 ... 5 Zoom in Narrow Direction 0 6 Stop Zoom Motion 0 7 Focus in Far Direction 0 8 Focus in Near Direction 0 9 Stop Focus Motion 0 10 One Push Auto Focus 0 11 N/A 1 0 = disabled 1 = enabled 12 Lens NUC (IR camera) 1 0 = no shutter 1 = shutter Optional Data Byte(s) Copyright © 2014-2015 SightLine Applications, Inc.
SightLine Applications Command and Control Current Lens Status (0x6D) Returns current focus and zoom position. This is sent as a response to a GetParameters(CurrentLensStatus) request. Byte offset Description 2 Packet length = 6 3 Packet type = 0x6D NEW: 2.19 4,5 Focus Position Unsigned 16 bit 6,7 Zoom Position Unsigned 16 bit Set Lens Params (0x6E) Set the current parameters for controlling the lens mechanism Byte offset Description 2 Packet length = 9 3 Packet type = 0x6E NEW: 2.
SightLine Applications Command and Control 5 AutoFocus Metric Region Size % of screen (0 to 100) 6 Zoom Track Focus (0= disabled, 1= enabled) 7 Autofocus method (0=scan far to near, 1=seek) 8 Autofocus Rate Adjust (0 to 255) 100 = default speed of motion 9 Autofocus Change Percent (0 to 255) in 1/10ths of a percent. 40 (default) = 4% Set Digital Camera Parameters (0x70) Set parameters that pertain to a specific digital camera.
SightLine Applications Command and Control offset 2 Packet length = 11 3 Packet type = 0x71 NEW: 2.19 4 Mode (1 = freeze Auto-gain at min/max below) 5,6 Auto-gain Max value (max value maps to 255 in 8 bit output) 7,8 Auto-gain Min Value (min value maps to 0 in 8 bit output) 9 Row ROI for Auto-gain stats. Row Offset in % of image height (255=100%) Full image (default) = 0 10 Column ROI for Auto-gain stats.
SightLine Applications Command and Control offset 2, 3 Packet length = 770. Note: extended size packet. 4 Packet type = 0x73 NEW: 2.20 5 Y value for first entry 6 U value for first entry 7 V Value for first entry ... 770 Y value for last entry 771 U value for last entry 772 V Value for last entry Set Multiple Alignment (0x74) Set the (5) alignment sets for a dual camera setup. See details for bytes 5 through 8 in Set Blend Parameters (0x2F).
SightLine Applications Command and Control 2 Packet length = 23 4 Packet type = 0x75 NEW: 2.20 5 Vertical offset for first set 6 Horizontal offset for first set 7 Rotation for first set. 8 Zoom for first set. ... 21 Vertical offset for last set 22 Horizontal offset for last set 23 Rotation for last set. 24 Zoom for last set. Copyright © 2014-2015 SightLine Applications, Inc.
SightLine Applications Command and Control Tracking Box Pixel Stats (0x78) Periodic report of pixel statistics within track boxes. Only reports for 14 bit digital camera data. Enabled using the Set Coordinate Reporting Mode (0x0B) command. Byte offset Description 2 Packet length. Given by the following formula: (7*numTracks)+4 3 Packet type = 0x78 4 Camera Index {0,1,2,3} 5 Number of tracks. 6 Track Index N 7-8 mean value over tracking box area.
SightLine Applications Command and Control Appendix: History Changes for recent releases are summarized above. 2.06 (03) 2.07 (00) 2.08 (00) 2.09 (00) 2.10 (00) 2.12 (00) 2.13 (04) 2.
SightLine Applications Command and Control Contacts SightLine Applications, Inc. 1107 13TH STREET HOOD RIVER, OR 97031 Sales General SightLine Applications, Inc. 524 N Tillamook Street Suite 101 Portland, OR 97227 sales@sightlineapplications.com info@sightlineapplications.com www.sightlineapplications.com Export Controls Exports of SightLine Applications, Inc.
