SXH Protocol by Spinel Version 3.0 Date:

Transcription

1 SXH Protocol by Spinel Version 3.0 Date:.8 Revision History Vision Date Description V.0 V.0 V3.0 September, 6 December, 6 April, 8 Initial release Added LED control, OSD, Cmd 0x30 Added all ratio image sizes Keep only one command for snapshotting images Keep only one command for set baud rate and ress Deleted auto-focusing, motion detection Added computation reference Notes: all new camera released from April 8 are compatible with older version protocol V.0, no coding change needed for upgraded version cameras. Structure (in HEX format): D D Cmd LenL LenH D CrcL CrcH General guidance: ). is bytes, and is always ). is the ress the camera, ranges from 0x to 0xfe, 0x and 0xff are reserved (broadcasting ), if the camera receives the command which is not for same the camera, the camera will discard this command and will not respond. 3). Cmd is the command issued to the camera. 4). LenH and LenL are the, represents the total the data (not the the frame), and the can be 0~ ). CrcH, CrcL are 6 bit, computed from ress Add to Dn, ing equals data + 4; when sending testing command, if is not computed, 0xc, 0xc can be used instead. 6). = (frame )+ ()+ (command)+ (data )+ n (data)+ (Check Value) =8+ n (data ) =8++*56 ). Minimum is 8 bytes; and can be used to calculate the total.. Testing (Cmd=0x) bit D 8 Spinel USA, LLC D 8

2 Return aa aa 55 F6 (frame =0): eb 0 55 aa c c Return (frame =): 03 aa 55 F6. Snapshot (Cmd=0x) The host can send this command to capture an image, the image gets stored on the camera, waiting for transferring. bit D D 0 05 : eb 0 05 c c 0 Sub-packet size Return: 0b b Packet status 83 6 Image size 05 Resolution 0 Compression ratio reserved reserved Resol -ution Compres sion ratio Example: : 0 05 Return: 0B B 0 05 B5 Compression ratio ranges from to 5, compression ratio value greater, the image gets more compressed, which will sacrifice the image quality. Parameter Resolution 6*480 80*960 8*6 *68 80*8 6* 6* 80*0 90*080 80* 480*0 6*360 8*0 960*5 *56 80*0 366*68 4*80 6*9 8 Spinel USA, LLC Ratio 5:4 Notes Best resolution for MP camera

3 3. Get image by sub-packet (Cmd=0x48) The host can send this command to camera to get certain the image data from start ress, subpacket by sub-packet, and then it combines all data into one JPEG image. bit Retur n D D D6~D9 ~D Cmd Start ress Length XX YY D Dn High bit // Get the first sub-packet, packet size 68 bytes (low bit first) : //request 68 bytes image data from the start ress (Max 0xffff, 65k) Return: d0 d dn c c // returned 0x03 (68 bytes) image data back // Get the second sub-packet, packet size 68 bytes : //request 68 bytes image data from the start ress 68, (Max 0xffff, 65k) Return: d0 d dn c c // returned 0x03 (68 bytes) image data back Notes: If it gets more image data than the total from capturing, it will be processed as error, there will be no valid image returned. 4. Snapshot procedures guide Step : send snapshot command (Cmd=0x), the camera captures a still image (at night time, the camera will turn the LED s on first before capturing), if the return includes the the image, it means the capturing is complete; the image is stored on the camera. Step : send get image by sub-packet command (Cmd=0x48), start from 0, each packet can be k bytes (the range can be from 5 bytes to K bytes), till it gets all the data for the image. Step 3: Combine all image data, combine all image data in order, then it gets a JPEG image. 5. Set baud rate and ress (Cmd=0x) bit Return D D 0 Baud rate 0 0a 0a 0 0a 0a Save or not? Add New Notes: if the baud rate parameter is set as, the baud rate doesn t get modified, if the new is set as 8 Spinel USA, LLC 3

4 or FF, the camera doesn t get modified. Address and FF are broadcasting ress, when they are being used in command, the command gets sent to every camera in the same bus. Return 0 Baud rate Saved Add New For different baud rate parameter, please use the table below as a guide. Baud rate (bps) Parameter OSD Control (Cmd=0x5) The host can display characters at X and Y axis on images by issuing this command. : 5 XL XH YL YH 0B D D bit ED D D 5 5 Length XL XH X axis XL XH YL YH 0B D D.. YL YH Y axis 0B Font size D D s Note: This command is to display characters at X, Y axis, the characters use ASCII table. If the font size is set as 0, then the font size is default size. s =data - 5. For instance, to 34e on coordinate 06, 08, font size is, then: : 5 0A C Return: 5 Common ASCII Table: NUL Line Feed Space # $ % Decimal Spinel USA, LLC Binary HEX A M N O P Q R S T 4 Decimal Binary HEX 4D 4E 4F

5 & ` ( ) * +, -(). / : ; < = A B C D E F G H I J K L A B C D E F A 3B 3C 3D 3E 3F A 4B 4C U V W X Y Z [ \ ] ^ - a b c d e f g h i j k l m n o p q r s t u v w x y z Decimal Binary HEX Decimal Binary HEX A 5B 5C 5D 5E 5F A 6B 6C 6D 6E 6F A B D Other supplemental commands:. LED control (Cmd=0x0) The host can set the LED as auto or manual mode then manually turn on/f the LED s by issuing this command. The default is auto mode. : eb (auto mode) 8 Spinel USA, LLC 5

6 eb (manual mode, turn on LED s) eb 0 0 cc (manual mode, turn f LED s) or cc or = auto mode cc =manual mode, turn f 33 =manual mode, turn on computation //Crc6 computing fuction const unsigned short crc_ta[56]= /* Residue Table */ 0x, 0x0, 0x, 0x3063, 0x84, 0x50a5, 0x60c6, 0x0e, 0x808, 0x99, 0xa4a, 0xb6b, 0xc8c, 0xdad, 0xece, 0xfef, 0x3, 0x00, 0x33, 0x5, 0x5b5, 0x494, 0xf, 0x6d6, 0x9339, 0x838, 0xb3b, 0xa35a, 0xd3bd, 0xc39c, 0xf3ff, 0xe3de, 0x46, 0x33, 0x0, 0x4, 0x64e6, 0x4c, 0xa4, 0x5485, 0xa56a, 0xb54b, 0x858, 0x9509, 0xe5ee, 0xf5cf, 0xc5ac, 0xd58d, 0x3653, 0x6, 0x6, 0x0630, 0x6d, 0x66f6, 0x5695, 0x46b4, 0xb5b, 0xaa, 0x99, 0x838, 0xfdf, 0xefe, 0xd9d, 0xcbc, 0x48c4, 0x58e5, 0x6886, 0x8a, 0x08, 0x86, 0x80, 0x383, 0xc9cc, 0xd9ed, 0xe98e, 0xf9af, 0x8948, 0x9969, 0xaa, 0xb9b, 0x5af5, 0x4ad4, 0xab, 0x6a96, 0xa, 0x0a50, 0x3a33, 0xa, 0xdbfd, 0xcbdc, 0xfbbf, 0xeb9e, 0x9b9, 0x8b58, 0xbb3b, 0xaba, 0x6ca6, 0xc8, 0x4ce4, 0x5cc5, 0xc, 0x3c03, 0x0c60, 0xc4, 0xedae, 0xfd8f, 0xcdec, 0xddcd, 0xada, 0xbd0b, 0x8d68, 0x9d49, 0xe9, 0x6eb6, 0x5ed5, 0x4ef4, 0x3e3, 0xe3, 0xe5, 0x0e0, 0xff9f, 0xefbe, 0xdfdd, 0xcffc, 0xbfb, 0xaf3a, 0x9f59, 0x8f8, 0x988, 0x8a9, 0xbca, 0xaeb, 0xd0c, 0xcd, 0xf4e, 0xe6f, 0x080, 0xa, 0x30c, 0x0e3, 0x54, 0x5, 0x6, 0x606, 0x83b9, 0x9398, 0xa3fb, 0xb3da, 0xc33d, 0xd3c, 0xe3f, 0xf35e, 0x0b, 0x, 0xf3, 0x3d, 0x435, 0x54, 0x6, 0x56, 0xb5ea, 0xa5cb, 0x95a8, 0x8589, 0xf56e, 0xe54f, 0xd5c, 0xc50d, 0x34e, 0x4c3, 0x4a0, 0x8, 0x466, 0x6, 0x5, 0x, 0xadb, 0xbfa, 0x899, 0x9b8, 0xe5f, 0xfe, 0xcd, 0xd3c, 0x6d3, 0x36f, 0x069, 0x6b0, 0x665, 0x66, 0x465, 0x5634, 0xd94c, 0xc96d, 0xfe, 0xe9f, 0x99c8, 0x89e9, 0xb98a, 0xa9ab, 0x58, 0x4865, 0x806, 0x68, 0x8c0, 0x08e, 0x388, 0x8a3, 0xcbd, 0xdb5c, 0xeb3f, 0xfbe, 0x8bf9, 0x9bd8, 0xabbb, 0xbb9a, 0x4a5, 0x5a54, 0x6a3, 0xa6, 0x0af, 0xad0, 0xab3, 0x3a9, 0xfde, 0xed0f, 0xdd6c, 0xcd4d, 0xbdaa, 0xad8b, 0x9de8, 0x8dc9, 0xc6, 0x6c0, 0x5c64, 0x4c, 0x3ca, 0xc83, 0xce0, 0x0cc, 0xeff, 0xff3e, 0xcf5d, 0xdfc, 0xaf9b, 0xbfba, 0x8fd9, 0x9ff8, 0x6e, 0xe36, 0x4e55, 0x5e4, 0xe93, 0x3eb, 0x0ed, 0xef0 8 Spinel USA, LLC 6

7 ; //,applies for ing continuous data unsigned short Crc6(unsigned char *ptr, unsigned short len) unsigned short crc; unsigned char da; crc=0; while(len--!=0) da=(unsigned char) (crc/56); crc<<=8; crc^=crc_ta[da^*ptr]; ptr++; return(crc); //applies for ing non-continuous data unsigned short Crc6_New(unsigned short old_crc,unsigned char *ptr, unsigned short len) unsigned short crc; unsigned char da; crc=old_crc; while(len--!=0) da=(unsigned char) (crc/56); crc<<=8; crc^=crc_ta[da^*ptr]; ptr++; return(crc); 8 Spinel USA, LLC