AH66T Serial Query Commands

Transcription

1 November 24, 2010 AH66T Serial Query Commands PURPOSE This bulletin explains how to understand the serial response received when a query command is sent to the AH66T. Query Commands In addition to the standard query commands listed in Appendix A of the AH66T manual (available for download at there are two newly implemented query commands that are of particular importance when integrating 3 rd party serial controllers with the AH66T. One of these commands queries the overall status of a particular zone and the other queries the overall status of a complete AH66T chassis. This status information includes selected Sources, Volume levels, Bass and Treble EQ levels, volume Mute status, Do-Not-Disturb and Whole House Music settings, Page/Doorbell mode status and System On/Off status. Command Format The command to query a single zone is: &AH66,ZQRY,ZZ,?<cr> where ZZ is the zone number 1 through 12. So, &AH66,ZQRY,1,?<cr> would query the status of zone one and &AH66,ZQRY,11,?<cr> would query the status of zone eleven. The command to query an entire chassis is: &AH66,QRY,U,?<cr> where U is the chassis unit number 1 or 2. So, &AH66,QRY,1,?<cr> would query the status of chassis one and &AH66,QRY,2,?<cr> would query the status of chassis two. Note: <cr> is a carriage return. This is NOT a typed part of the command. ATON 2010 All rights reserved. Page1

2 Zone Query Response Format The response format for the zone query command is straight forward and is presented as Comma Separated Values (CSV). Query Response Format: *AH66,ZQRY,zz,a,b,c,d,e,f,g,h,I,j,k<cr> zz= Zone number a= Selected source where: A0= Zone OFF A1= Analog Input 1 A5= Analog Input 5 A2= Analog Input 2 A6= Analog Input 6 A3= Analog Input 3 R1= Chassis 1 s Internal Tuner A4= Analog Input 4 R2= Chassis 2 s Internal Tuner b= Zone Volume Level in Percent c= Zone Bass Level in db -12 to +12 db Range d= Zone Treble Level in db -12 to +12 db Range e= Zone Mute Status 0= Not Muted 1= Muted f= Zone Do Not Disturb (DND) Status 0=Not in DND mode 1=In DND mode g= Zone Whole House Music (WHM) Status 0=Not in WHM mode 1=In WHM mode h= Zone Loudness Status 0=Loudness OFF 1=Loudness ON i= Zone Page Status 0= Page Inactive 1=Page Active j= Source Audio Status 0= Source Audio Inactive 1=Source Audio Active k= System Status 0= System OFF 1=System On ATON 2010 All rights reserved. Page2

3 Zone Query Response Format (Continued) Zone Query Response Examples: Zone two has been queried using the command &AH66,ZQRY,2,? The response is: *AH66,2,A2,76,+4,+6,0,0,1,1,0,0,1 This indicates: Zone 2 (2) has analog audio input 2 (A2) selected, the current zone volume is set to 76 (76), the Bass is set to +4dB (+4) and the Treble is set to +6 (+6). Additionally, the zone is NOT muted (0), the zone is NOT in DND (0), the zone is currently part of WHM (1), the zone Loudness EQ is ON (1), the zone is NOT in Page mode (0), the currently selected source does NOT have audio present (0) and finally, the system is ON (1). Zone 10 has been queried using the command &AH66,ZQRY,10,? The response is: *AH66,10,R2,42,-1,+1,1,0,0,1,1,1,1 This indicates: Zone 10 (10) has the internal tuner of chassis 2 (R2) selected, the current zone volume is set to 42 (42), the Bass is set to -1dB (-1) and the Treble is set to +1dB (+1). Additionally, the zone IS muted (1), the zone is NOT in DND (0), the zone is currently NOT part of WHM (0), the zone Loudness EQ is ON (1), the zone IS in Page mode (1), the currently selected source DOES have audio present (1) and finally, the system is ON (1). Zone 12 has been queried using the command &AH66,ZQRY,12,? The response is: *AH66,12,A0,52,+3,+1,0,1,0,0,0,0,0 This indicates: Zone 12 (12) has NO source (A0) selected, the current zone volume is set to 52 (52), the Bass is set to +3dB (+3) and the Treble is set to +1dB (+1). Additionally, the zone is NOT muted (0), the zone IS in DND (1), the zone is currently NOT part of WHM (0), the zone Loudness EQ is NOT on (0), the zone is NOT in Page mode (0), the last selected source does NOT have audio present (0)* and finally, the system is OFF (0). *When a zone is OFF, the feedback will always indicate that there is no audio present for the selected source. The Zone Query command is the recommended query method. The following pages cover the Chassis Query Response format. ATON 2010 All rights reserved. Page3

4 Chassis Query Response Format The Chassis Query command is only recommended for advanced programmers with a thorough understanding of ACSII formatted HEX data. The response format for the chassis query command is presented as ASCII formatted HEX data. This response format allows status information for all zones on one chassis to be obtained with just one query command but the response is much more complex than the Zone query command response previously covered. Each chassis must be queried separately. Chassis Query Response Format: *AH66,QRY,U,ABCDEFGHIJKLABCDEFGHIJKLABCDEFGHIJKLABCDEFGHIJKLABCDEFGHIJKLABCDEFGHIJKL U= The Unit number ABCDEFGHIJKL = The combined status information for one zone. Each value is made by using four bits of binary data (abcd) to create a HEX value where: A= 8 (This value is a constant. It will always be 8.) Binary Equivalent: 1000 B= The zone number in HEX. Binary Equivalent: 0001 to 1100 C= System and Zone Information in HEX comprised of: a= 0 (This value is a constant. It will always be 0.) b= System Status (0=OFF, 1=ON) c= Zone Do Not Disturb (DND) Status (0=OFF, 1=ON) d= Zone Mute Status (0=OFF, 1=ON) D= Source and Zone Information in HEX comprised of: a= Source Audio Detect Status (0= No Audio Detected, 1= Audio Detected) bcd= Source Selected (0= OFF, 1-6 = Source 1-6, 7= Source > 6 see F data) Binary Equivalent: 000 to 111 E= Additional Zone information in HEX comprised of: a= 0 (This value is a constant. It will always be 0.) b= Zone Whole House Music (WHM) Status (0=OFF, 1=ON) c= Zone Page Status (0=OFF, 1=ON) d= 0 (This value is a constant. It will always be 0.) F= Additional Source and Zone information in HEX comprised of: a= Zone Loudness EQ Status (0=OFF, 1=ON) bcd= Source Selected (0= Source < 7 see D data, 1= Source 7 (The Internal Radio)) Binary Equivalent: 000 to 111 ATON 2010 All rights reserved. Page4

5 Chassis Query Response Format (Continued) G= Zone Volume Attenuation Level information in HEX comprised of: H= Additional Zone Volume Attenuation Level information in HEX comprised of: a= 0 or 1 b= 0 or 1 *This information is used by ATON products only. 3 rd party controllers should be programmed to ignore this information for proper operation. It is necessary to combine the information contained in Gc, Gd and Ha, Hb, Hc, and Hd to determine the attenuation level in a zone. Attenuation is shown in HEX as a range of 0 (full volume) to 30 (minimum volume). This is a range of 48 volume steps. Binary Equivalent: to I= Zone Treble Level information in HEX comprised of: J= Additional Zone Treble Level information in HEX comprised of: a= 0 or 1 b= 0 or 1 *This information is used by ATON products only. 3 rd party controllers should be programmed to ignore this information for proper operation. It is necessary to combine the information contained in Ic, Id and Ja, Jb, Jc, and Jd to determine the Treble level in a zone. Treble level is shown in HEX as a range of 4 (minimum Treble -12dB) to 1C (maximum Treble +12dB). This is a range of 24 steps. Binary Equivalent: to ATON 2010 All rights reserved. Page5

6 Chassis Query Response Format (Continued) K= Zone Bass Level information in HEX comprised of: L= Additional Zone Bass Level information in HEX comprised of: a= 0 or 1 b= 0 or 1 *This information is used by ATON products only. 3 rd party controllers should be programmed to ignore this information for proper operation. It is necessary to combine the information contained in Ic, Id and Ja, Jb, Jc, and Jd to determine the Bass level in a zone. Bass level is shown in HEX as a range of 4 (minimum Bass -12dB) to 1C (maximum Bass +12dB). This is a range of 24 steps. Binary Equivalent: to Chassis Query Response Examples: Chassis one has been queried using the command: &AH66,QRY,1,? The response is: *AH66,QRY,1, f The 1 after *AH66,QRY indicates Chassis 1 (1) was queried. All of the information for each zone is contained in 12 HEX characters. To make it easier to understand the information presented, each zone s information is grouped individually below. (ABCDEFGHIJKL) Zone 1: ( ) Zone 2: ( ) Zone 3: ( ) Zone 4: ( ) Zone 5: (854f ) Zone 6: ( ) ATON 2010 All rights reserved. Page6

7 Chassis Query Response Examples (Continued) Zone 1: (8 A 1 B 4 C 1 D 0 E 0 F 2 G 4 H 1 I 9 J 0 K 6 L ) (A=8 (constant value) B=1) Shows this information is for Zone 1 C=4 in HEX which is 0 a 1 b 0 c 0 d in Binary a= 0 (This value is a constant. It will always be 0.) b= System Status (1=ON) c= Zone Do Not Disturb (DND) Status (0=OFF) d= Zone Mute Status (0=OFF) D=1 in HEX which is 0 a 0 b 0 c 1 d in Binary a= Source Audio Detect Status (0= No Audio Detected) bcd= Source Selected (1= Source 1) E=0 in HEX which is 0 a 0 b 0 c 0 d in Binary a= 0 (This value is a constant. It will always be 0.) b= Zone Whole House Music (WHM) Status (0=OFF) c= Zone Page Status (0=OFF) d= 0 (This value is a constant. It will always be 0.) F=0 in HEX which is 0 a 0 b 0 c 0 d in Binary a= Zone Loudness EQ Status (0=OFF) bcd= Source Selected (0= Source < 7 see D data) G=2 in HEX which is 0 a 0 b 1 c 0 d in Binary (Ignore this value) (Ignore this value) c= 1 d= 0 H=4 in HEX which is 0 a 1 b 0 c 0 d in Binary a= 0 b= 1 c= 0 d= 0 Combine G data with H data in Binary is 24 in HEX which is 36 in decimal. This indicates the Volume is attenuated by approximately 75 %. (36 divided by 48 multiplied by 100%.) ATON 2010 All rights reserved. Page7

8 Chassis Query Response Examples (Continued) I=1 in HEX which is 0 a 0 b 0 c 1 d in Binary c= 0 d= 1 J=9 in HEX which is 1 a 0 b 0 c 1 d in Binary a= 1 b= 0 c= 0 d= 1 Combine I data with J data in Binary is 19 in HEX. Since 10 HEX is 0dB, this indicates the Treble is set to +9dB. (19 HEX {25 Decimal} - 10 HEX {16 Decimal} = 9 HEX {9 Decimal} = 9 Decimal steps above 0dB) K=0 in HEX which is 0 a 0 b 0 c 0 d in Binary c= 0 d= 0 L=6 in HEX which is 1 a 0 b 0 c 1 d in Binary a= 0 b= 1 c= 1 d= 0 Combine K data with L data in Binary is 6 in HEX. Since 10 HEX is 16 in Decimal, which is 0dB, this indicates the Bass is set to -10dB. (10 HEX {16 Decimal) -6 HEX {6 Decimal} = A HEX {10 Decimal} = 10 Decimal steps below 0dB) ATON 2010 All rights reserved. Page8