Home

Using the Audio Processor Workbench (APWorkbench)

Contents

1. 28 KUNING SCHL se A DO aie Dan ei don Se eee 0 Le ves 29 Events in logger upon completion of a script 31 Location of Command Shell button 32 Drop down MENU 32 Command Shell WINDOW 22 0 2 2e en sind ae 32 File menu Filter import wizard 33 FINCHIMpON WIZ pags illa ASILI Anne 33 Filter analysis and scaling information 34 Fiter IMPON ODINS SE onorari RANAY eeeh 35 Exporting COCTIICIONNS sis satira a aa ata ai 35 C C format using Generate C code button 36 C code generation wizard 36 MISCCIIANCOUS CONMOIS 33 eo EER 37 Peak filter gain 10 dB freq 1 kHz Q 1 41 43 Low pass filter gain O dB freq 1 kHz Q 0 71 43 High pass filter gain O dB freq 1 kHz Q 0 71 44 Low shelf filter gain 10 dB freq 1 kHz slope 1 44 High shelf filter gain 10 dB freq 1 KHZ slope 1 45 Filter import wizard all coefficients in range 52 Filter import wizard adjustable attenuation one coefficient out of range 53 Filter import wizard gain not adjustable one coefficient out
2. 46 Appendix Scriptflle ici iii LANA NN WA KB ieri 49 Appendix D Filter import wizard 51 Doc ID 023225 Rev 1 ky UM1545 Contents Appendix E Exporting coefficients 56 Appendix F Shortcuts quick reference 59 Appendix G Software license agreement and disclaimer 60 5 PROVISION AMISIONY cocente AL a se eee ee en ee ee 63 AY Doc ID 023225 Rev 1 3 64 List of figures List of figures Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 Figure 11 Figure 12 Figure 13 Figure 14 Figure 15 Figure 16 Figure 17 Figure 18 Figure 19 Figure 20 Figure 21 Figure 22 Figure 23 Figure 24 Figure 25 Figure 26 Figure 27 Figure 28 Figure 29 Figure 30 Figure 31 Figure 32 Figure 33 Figure 34 Figure 35 Figure 36 Figure 37 Figure 38 Figure 39 Figure 40 Figure 41 Figure 42 Figure 43 Figure 44 Figure 45 Figure 46 Figure 47 Figure 48 4 64 UM1545 APW package Older dd sn sr na dt dire es tdi de rot ea 6 Startup settings device selection 8 Startup settings interface selection 9 APW main dialog device controls 10 SAS Dal 2 de a eo de et e a eat 11 Tools m
3. M Modified but not applied yet M Current value equals default M Curent value differs from default ReadAll write Al Verify al Load Defaults F es Peas eatin Doc ID 023225 Rev 1 lt UM1545 APW walkthrough 2 5 Equalizer Editor Figure 20 Equalizer Editor tab rin pars mg n MP Workbench File Tools Presets Window Help Controls Processing Flow Biguadhatic Filters Input Output Configuration Equalizer Editor Registers Bank Biguadratic editor Biluad O Gain Freq F Coefficients b1 2 000000 bz 000000 al 2 ala alala a2 000000 IA PAR RE a AA bob lb ltd ll 1 bO2 400000 30 40 SO 6070 SO 200 600 800 1k zk 3k 4k Skok amp k 10k Channel controls Presets Prescaler Selected channel Channel 0 ai Gain limit dE 25 00 Auto aligned channels Flat a Peak level dE 0 00 ae chain overview Attenuation dB 0 00 Se 9o TETE pi PEDDEDDECLELA Enable auto apply Enable auto scaler The Equalizer Editor tab offers the possibility to design different types of filters and to compute and download into the device the relevant coefficients either by defining their graphs or their qualitative parameters The supported filters are see Appendix A Types of filters supported Peak e High pass Low pass High shelf e Low shelf The upper part of the tab is occupied by the graphical editor and by the design tools Figure 21 To design a filter by defining its
4. Doc ID 023225 Rev 1 9 64 Getting started UM1545 Figure 4 APW main dialog device controls Register list filter F All ng filter E Fiedisterread wnte Release 1 912 Address O Hex E a Device power up PITNCC0CO Ces Auto apply on bit changes Device controls WG Configuration Presets M1 MD ae a LAC MSI AE Store een Inspection commands Legend registers colors Modified but not applied yet M Curent value equals default Apply E Curent value differs from default Generate C code Ton viewer He ER lister Event Coefficient Event 96 KHz A ACK M Register is read only After pressing the OK button the APW main dialog will be displayed its presentation will depend on the device selected and may vary from product to product On the right side of the APW main dialog the Device controls frame Figure 4 highlighted in red is displayed Use the Device power up button to start the device when the IC is powered the green LED will be switched on as well then use the other controls Reset Initialize as needed Q 10 64 Doc ID 023225 Rev 1 UM1545 Getting started Figure 5 Status bar At the bottom of the APW window a status bar provides some additional information regarding the last executed command concerning both the 1 C registers and the coefficients the processing sampling frequency the chosen interface LPT USB or SIM and so
5. Auto align two or more processing channels Two or more channels are aligned when their biquadratic filters are configured in the same way In other words once a filter or a set of filters has been defined for a processing channel the Auto Aligned Channels option allows automatically applying the configuration to all the other linked channels thus speeding up the setup process The only exception concerns the reserved biquads If a filter is reserved its setting will not be applied to or will not be changed from another linked filter Please be aware that this is a software option offered by the APW that is not related in any way to the physical implementation of the IC under test thus it is available for every device Depending on the Sound Terminal product similar options might be available also as hardware implemented features that can be managed through a dedicated set of device specific controls The controls described above will necessarily vary according to the device architecture and may slightly differ from those shown in Figure 24 The center area of the lower part of this tab is occupied by the Equalization Presets if available for the selected device and the Channel Controls described above AY Doc ID 023225 Rev 1 27 64 APW walkthrough UM1545 At the end the left lower side of the Equalizer Editor tab groups the filter apply option The user through the Enable Auto Apply option can choose whether to automatically a
6. Load preferences on startup Save preferences on exit Enable sounds Startup operations Ho operation O write defaults to DUT Read defaults from CUT Reset device on startup Start ini power down mode Coefficient settings Allow editing coefficient Show value in hexadecimal Save Preferences Using these options the user can decide which kind of events will be logged Coefficient reading Coefficient writing Register reading Register writing Miscellaneous operations on registers Register modifications As a last tracing option the user can also choose to trace all the operations occurring between the PC and the interface by selecting the Trace I O Events flag The log file can be provided with an automatic line numbering feature that can be enabled if needed through the Print Line Number in Log flag Doc ID 023225 Rev 1 13 64 APW walkthrough UM1545 14 64 On the right side of the dialog highlighted in blue some miscellaneous preferences concerning the features of the APW are displayed Hereafter a list of them by group anda brief explanation if needed e Coefficient Settings Allow Editing Coefficients this option enables the editing of the filters coefficients Show Value in Hexadecimal this option allows toggling between the hexadecimal and the decimal notation when displaying the coefficient s value Please note that in case of decimal notation the values are display
7. 0x20 0x7ACC50 0x21 0x881BD5 0x22 0x3F8A7B 48KFs Biquad7 Address 0x1E 0x22 stability 0 967807 lt Doc ID 023225 Rev 1 UM1545 Coefficient array for 96 KHz processing frequency Creation date Biquad 00 Wednesday 04 March 09 Selected product STA339BWS Note only channel 0 is exported FILTOO_B 1 004262 1 991142 0 991241 FILTOO_A 1 000000 1 991142 0 991431 FILTOO_BO 1 004262 FILTOO_B1 1 991142 FILTOO_B2 0 991241 FILTOO_AO 1 000000 FILTOO_A1 1 991142 FILTOO_A2 0 991431 Biquad 01 Hex 4045D5h Hex 809120h Hex 7EEOFEh Hex 7FFFFFh Hex 7F6EEOh Hex 8118C8h FILTO1_B 0 993526 1 986925 0 993453 FILTO1_A 1 000000 1 986856 0 992643 FILTO1_BO 0 993526 FILTO1_B1 1 986925 FILTO1_B2 0 993453 FILTOT AO 1 000000 FILTO1_A1 1 986856 FILTO1_A2 0 992643 Biquad 02 Hex 3F95FOh Hex 80D639h Hex 7F2974h Hex 7FFFFFh Hex 7F28A8h Hex 80F10Fh FILTO2 B 1 017854 1 882406 0 935988 FILTO2_A 1 000000 1 882406 0 917146 FILTO2 BO 1 017854 FILTO2 B1 1 882406 FILTO2 B2 0 935988 FILTO2 AO 1 000000 FILTO2 A1 1 882406 FILTO2 A2 0 917146 Biquad 03 Hex 412486h Hex 8786A9h Hex 77CE73h Hex 7FFFFFh Hex 787957h Hex 8A9AF7h FILTO3 B 1 003719 1 969740 0 967539 FILTO3_A 1 000000 1 969740 0 971260 FILTO3 BO 1 003719 FILTO3 B1
8. ATI UM1545 User manual Using the Audio Processor Workbench APWorkbench Introduction The Audio Processor Workbench APW has been designed as a multi device software control panel supporting all the products in the Sound Terminal family from ST Microelectronics APW has been developed to fit the needs of both the beginner and the experienced user The tool is quite flexible and its configuration can be simple or more advanced in order to access the multitude of features offered by the Sound Terminal products Features of the APW include 1 C register control direct R W access to all IC registers of the device Equalizer editor a powerful graphic tool to design filters or a chain of them and to download their coefficients directly into the device APW makes the use of any other external tool unnecessary thus simplifying device operation Configuration presets the capability of storing up to 8 device configurations that can be loaded just by pushing a button Thanks to this feature the configuration process becomes a rare activity making device testing measuring or listening faster than ever Device common controls embedded or external bridge power up device reset power up and initialization Device specific controls the ST Sound Terminal product family includes many devices APW offers the control of all the various device specific features proprietary audio effects I O configuration and routing and so on
9. Coefficient 0x27 C2H44 b0 2 Coef 028h 000000h Coefficient 0x28 C12H0 b1 2 Coef 029h 000000h Coefficient 0x29 C12H1 b2 Coef 02Ah 000000h Coefficient 0x2A C12H2 a1 2 Coef 02Bh 000000h Coefficient 0x2B C12H3 a2 Coef 02Ch 400000h Coefficient 0x2C C12H4 b0 2 Coef 02Dh 000000h Coefficient 0x2D C3HO b1 2 Coef 02Eh 000000h Coefficient 0x2E C3H1 b2 Coef 02Fh 000000h Coefficient 0x2F C3H2 a1 2 Coef 030h 000000h Coefficient 0x30 C3H3 a2 Coef 031h 400000h Coefficient 0x31 C3H4 b0 2 Coef 032h 7FFFFFh Coefficient 0x32 Channel 1 Pre scale Coef 033h 7FFFFFh Coefficient 0x33 Channel 2 Pre scale Coef 034h 7FFFFFh Coefficient 0x34 Channel 1 Post scale Coef 035h 7FFFFFh Coefficient 0x35 Channel 2 Post scale Coef 036h 7FFFFFh Coefficient 0x36 Channel 3 Post scale Coef 037h 5A9DF7h Coefficient 0x37 Twarn Oc Limit Coef 038h 7FFFFFh Coefficient 0x38 Channel 1 Mix 1 Coef 039h 000000h Coefficient 0x39 Channel 1 Mix 2 Coef 03Ah 000000h Coefficient 0x3A Channel 2 Mix 1 Coef 03Bh 7FFFFFh Coefficient 0x3B Channel 2 Mix 2 Coef 03Ch 400000h Coefficient 0x3C Channel 3 Mix 1 Coef 03Dh 400000h Coefficient 0x3D Channel 3 Mix 2 Coef 03Eh 000000h Reserved Coef 03Fh 000000h Reserved HHHRHHHHHRHHHHERHHHE FFX filters HHHHHHRHHHHERHHHHEE Filt Ch 0 00 type F gain 0 00
10. and nae na nial aa nee nael aa 2 nl ee a 0 04006 053 013 495 028 036 Allowed gain 140 dE Required Attenuation dE Minimum gain mismatch d gt Rounded gain mismatch 0 00 dE Analysis result One or more coefficients are out of range 1 0 1 0 Re scaling is required and the overall filter gain can be preserved Enable auto scaling feature or improper filters will be discarded Filter import options Enable auto scaler automatic gain adjustment Required gain onset r at negative vates only CO Enable auto scaler manual gain adjustment TOO eee gt Disable auto scaler skip invalid filters if ang 0 00 dE Import filter Doc ID 023225 Rev 1 53 64 54 64 Filter import wizard UM1545 Figure 47 Filter import wizard gain not adjustable one coefficient out of range Ore piers inean converter Input filter Lineares format Filename CAD ocuments and Settings francesco bianchi My Documents Filter analysis and scaling Information Processing freg 96 KHz Scaling information Below numbers show for each IR the amount of required coefficients attenuation in red or allowed gain fin black with respect to the allowed range 1 0 1 0 0 i ee di A 5 E i B 3 W TH fe eee ape p ge a I C04 0 06 053 013 340 028 036 Allowed gain 1 40 dB Required Attenuation de Minimum gain mismatch d gt Rounded gain m
11. naga o AE ON Enable auto scaler manual gain adjustment Disable auto scaler skip invalid filters IF any 0 00 db Import filter Doc ID 023225 Rev 1 55 64 Exporting coefficients UM1545 Appendix E Exporting coefficients 56 64 The following two examples of the available formats are respectively the C C arrays and the Matlab arrays In the C C syntax example the stability information shows the magnitude of the filter poles and is provided to avoid exporting unstable filters with unpredictable behaviors Speaker_EQ_Table_48000 0x00 0x8091 20 0x01 Ox7EEOFE 0x02 0x7F6EE0 0x03 0x8118C8 0x04 0x4045D5 48KFs Biquad1 Address 0x00 0x04 stability 0 995706 0x05 0x80D639 0x06 0x7F2974 0x07 0x7F28A8 0x08 0x80F10F 0x09 0x3F95F0 48KFs Biquad2 Address 0x05 0x09 stability 0 996315 OxO0A 0x8786A9 0x0B 0x77CE73 0x0C 0x787957 0x0D 0x8A9AF7 0x0E 0x412486 48KFs Biquad3 Address OxOA Ox0E stability 0 957677 OxOF 0x81EFC8 0x10 0x7BD84F 0x1 1 0x7E1038 0x12 0x83ADC1 0x13 0x403CEF 48KFs Biquad4 Address 0x0F 0x18 stability 0 985525 0x14 0x8005C8 0x15 0x6EF977 0x16 0x4FEB18 0x17 0xBA3B90 0x18 0x58B9B3 48KFs Biquad5 Address 0x14 0x18 stability 0 738280 0x19 0x841969 0x1A 0x785560 0x1B 0x7BE697 0x1C 0x8825A7 0x1D 0x403D7B 48KFs Biquad6 Address 0x19 0x1D stability 0 992950 0Ox1E 0x8533B0 0x1F 0x75AB4A
12. Biquadratic editor Biduad 1 PM Hz 15 0 dE Coefficiente bi 2 812254 b2 78E0F3 21 2 TEDDA a2 822678 b0 2 427046 pm mi co E0 20 pe 200 300 400 FE B00 Lk ak 3k 4k ck Ek Bk 10 k To design a filter by defining its qualitative parameters follow the procedure below 1 Select the kind of filter to be designed by pressing the appropriate button on the right side of the graph It is also possible to select which biquadratic filter of the DUT to write in Figure 21 highlighted in red 2 Enter the desired parameters in their corresponding fields on the right side of the graph Figure 21 highlighted in blue then hit the Enter key to change the focus from the input field to another control of the panel 3 The graph is immediately plotted the filter coefficients are computed and they are applied to the device according to the apply option that will be discussed later on in this section It is important to point out that one filter design method does not exclude another Indeed it is possible either to modify the qualitative parameters of a filter designed starting from a desired graph or to adjust the filter graph generated from a set of qualitative parameters Whichever is the design method applied the hexadecimal values of the computed coefficients are displayed in the area highlighted in green in Figure 21 When changing the selected biquadratic filter the table of coefficients is updated coherently
13. Coef 00Fh 000000h Coefficient OxOF C1H40 b1 2 Coef 010h 000000h Coefficient 0x10 C1H41 b2 Coef 011h 000000h Coefficient 0x11 C1H42 a1 2 Coef 012h 000000h Coefficient 0x12 C1H43 a2 Coef 013h 400000h Coefficient 0x13 C1H44 b0 2 Coef 014h 000000h Coefficient 0x14 C2H10 b1 2 Coef 015h 000000h Coefficient 0x15 C2H11 b2 Coef 016h 000000h Coefficient 0x16 C2H12 a1 2 Coef 017h 000000h Coefficient 0x17 C2H13 a2 Coef 018h 400000h Coefficient 0x18 C2H14 b0 2 Coef 019h 000000h Coefficient 0x19 C2H20 b1 2 Doc ID 023225 Rev 1 Audio processor configuration file 47 64 UM1545 Audio processor configuration file 48 64 Coef 01Ah 000000h Coefficient 0x1A C2H21 b2 Coef 01Bh 000000h Coefficient 0x1B C2H22 a1 2 Coef 01Ch 000000h Coefficient 0x1C C2H23 a2 Coef 01Dh 400000h Coefficient 0x1D C2H24 b0 2 Coef 01Eh 000000h Coefficient 0x1E C2H30 b1 2 Coef 01Fh 000000h Coefficient 0x1F C2H31 b2 Coef 020h 000000h Coefficient 0x20 C2H32 a1 2 Coef 021h 000000h Coefficient 0x21 C2H33 a2 Coef 022h 400000h Coefficient 0x22 C2H34 b0 2 Coef 023h 000000h Coefficient 0x23 C2H40 b1 2 Coef 024h 000000h Coefficient 0x24 C2H41 b2 Coef 025h 000000h Coefficient 0x25 C2H42 a1 2 Coef 026h 000000h Coefficient 0x26 C2H43 a2 Coef 027h 400000h
14. 002 123456 write value 123456h in coeff 02h CR1 002 read coeff 02h CW1F 003 0 500 coefficient single write with float value CW1F 004 1 00 coefficient single write with float value CW1F 005 1 00 coefficient single write with float value CWAF 000 1 0 1 0 0 033 0 5 0 5 coefficient multi write with float values SECTION_BEGIN 100 CWA 005 ABCDEF 123456 6789AB 315683 987654 CWA 00A ABCDEF 123456 6789AB 315683 987654 CCMPA 005 ABCDEF 123456 6789AB 315683 987654 CCMPA 00A ABCDEF 123456 6789AB 315683 987654 CWA 005 347267 ABEFCD 937583 AFEBCD 268439 CWA 00A 347267 ABEFCD 937583 AFEBCD 268439 CCMPA 000 347267 ABEFCD 937583 AFEBCD 268439 CCMPA 005 347267 ABEFCD 937583 AFEBCD 268439 SECTION_END CWA 005 347267 ABEFCD 937583 AFEBCD 268439 CWA 00A 347267 ABEFCD 937583 AFEBCD 268439 RESET lt 50 64 Doc ID 023225 Rev 1 UM1545 Appendix D Filter import wizard Filter import wizard A complete description of the LinearX LEAP suite file import procedure is as follows Press the File menu and select the Filter import wizard Press the Browse button and select the file to import Check the outcome of the filter analysis three cases are possible 1 2 3 a b All coefficients are in range Figure 45 In this case the auto scaler feature is not required and the filters can be imported without hesitation However the user is given the option to apply a user definable attenuation One or more
15. 1 969740 FILTO3 B2 0 967539 FILTO3 AO 1 000000 FILTO3_A1 1 969740 FILTO3_A2 0 971260 Hex 403CEFh Hex 81EFC8h Hex 7BD84Fh Hex 7FFFFFh Hex 7E1038h Hex 83ADC1h Address 04h Address 00h Address 01h Address Address 02h Address 03h Address 09h Address 05h Address 06h Address Address 07h Address 08h Address OEh Address OAh Address OBh Address Address OCh Address ODh Address 13h Address OFh Address 10h Address Address 11h Address 12h Doc ID 023225 Rev 1 Exporting coefficients 57 64 Exporting coefficients 58 64 Biquad 04 FILT04_B 1 386334 1 999647 0 866988 FILTO4_A 1 000000 1 248724 0 545057 FILTO4 BO 1 386334 Hex 58B9B3h FILTO4_B1 1 999647 Hex 8005C8h FILTO4_B2 0 866988 Hex 6EF977h FILTO4_A0 1 000000 Hex 7FFFFFh FILTO4_A1 1 248724 Hex 4FEB18h FILTO4_A2 0 545057 Hex BA3B90h Biquad 05 FILTO5_B 1 003752 1 935949 0 940105 FILTO5_A 1 000000 1 935949 0 936351 FILTO5_BO 1 003752 Hex 403D7Bh FILTO5_B1 1 935949 Hex 841969h FILTO5_B2 0 940105 Hex 785560h FILTO5 AO 1 000000 Hex 7FFFFFh FILTO5_A1 1 935949 Hex 7BE697h FILTO5_A2 0 936351 Hex 8825A7h Biquad 06 FILTO6_B 0 992827 1 918720 0 919290 FILTO6_A 1 000000 1 918720 0 936651 FILTO6_BO 0 992827 Hex 3F8A7Bh FILTO6_B1 1 918720 Hex 8533B0h FILTO6_B2
16. 3 46 PM a STContrals all Application Extension 6 19 2012 3 45 PM 25 STDeviceInterface dil Application Extension 6 19 2017 3 45 PM BD STDirectSound dil i Application Extension 6 19 2017 3 45 PM E STFramework dll Application Extension 6 19 2017 3 46 PM STLicenseManager dil Application Extension 6 19 2012 3 42 PM 2 STModule_UAD2 dil Application Extension 6 19 2012 3 46 PM a STModule_UQ74 dll Application Extension 6 19 2012 3 46 PM a STModule 439 dll 2 827 KB Application Extension 6 19 2012 3 46 PM Es STModule_V519 d 438 KB Application Extension 5 19 2012 3 46 PM STModule_V578 dll 445KB Application Extension 6 19 2012 3 46 PM STMOodule_v702 dil 70KB Application Extension 6 19 2012 3 46 PM 4 STModule_V737 dl 837 KB Application Extension 6 19 2012 3 46 PM 15 objects 4 My Computer In order to quickly get started very few requirements have to be met The user will need the following hardware A supported interface i e APWLink If this interface is not available the tool will run in SIMULATION mode only and no communication with either the target device or the demonstration board will be possible e A demonstration board of one of the Sound Terminal supported products The software requires e complete APW package a complete package consists of the files shown in Figure 1 please note that the structure might change according to the list of supported devices MS Windows operating system from Wind
17. Attack Release Rate 69h Limiter 2 Attack Release Threshold 00h Coefficient Address Bits 5 0 00h Coefficient b1 Data Bits 23 16 00h Coefficient b1 Data Bits 15 8 00h Coefficient b1 Data Bits 7 0 00h Coefficient b2 Data Bits 23 16 00h Coefficient b2 Data Bits 15 8 00h Coefficient b2 Data Bits 7 0 00h Coefficient a1 Data Bits 23 16 00h Coefficient a1 Data Bits 15 8 00h Coefficient a1 Data Bits 7 0 00h Coefficient a2 Data Bits 23 16 00h Coefficient a2 Data Bits 15 8 00h Coefficient a2 Data Bits 7 0 00h Coefficient b0 Data Bits 23 16 00h Coefficient b0 Data Bits 15 8 00h Coefficient bO Data Bits 7 0 lt 46 64 Doc ID 023225 Rev 1 UM1545 Reg 26h 00h Coefficient Write Control Reg 27h 1Ah Max Power Correction Config Msb Reg 28h COh Max Power Correction Config Lsb Reg 29h F3h Variable Distortion Compensation Msb Reg 2Ah 33h Variable Distortion Compensation Lsb Reg 2Bh 00h Fault Detect Recovery Bits Msb Reg 2Ch OCh Fault Detect Recovery Bits Lsb Reg 2Dh 7Fh Device Status Reg 2Eh 00h Bist Activate Reg 2Fh 00h Bist End Reg 30h 00h Bist Bad Reg 31h 00h EQ Coeff and DRC Configuration Reg 32h 30h Limiter 1 Ext Attack Threshold Reg 33h 30h Limiter 1 Ext Release Threshold Reg 34h 30h Limiter 2 Ext Attack Threshold Reg 35h 30
18. Regardless of the filter design approach the APW also embeds a set of controls to protect the user s hearing and the audio equipment from unpleasant effects when designing a filter Single filter gain limitation the gain applicable with a single filter can be set between a range varying from 15 dB to 30 dB This range is fixed and cannot be changed The limits of this range are marked on the graph with a red line as shown in Figure 21 If a higher gain is desired this limitation can be bypassed using a chain of two or more filters Auto scaler APW offers also the possibility of limiting the overall maximum positive gain applicable with any chain of filters This is done by enabling the Enable auto scaler checkbox This feature automatically computes the difference between the overall filter Doc ID 023225 Rev 1 ky UM1545 APW walkthrough gain and the maximum threshold Then it applies the value as an attenuation modifying the device prescaler By acting in this way the auto scaler achieves two key goals The overall filters chain shape is unchanged The dynamic of the filtered audio signal remains within safe boundaries for both ears and speakers Figure 22 shows an example of how the auto scaler works Two peak filters with a 15 dB gain each are applied with a 25 dB threshold thus with a 5 dB in excess APW auto scaler automatically computes the gain in excess and applies the attenuation using the prescaler When th
19. ST or any Affiliate of ST Upon termination of this license you agree not to use the Software for any purpose whatsoever to destroy the Software and any copies thereof in your possession Compliance with laws You agree to comply with all applicable laws regulations decrees ordinances and the like and shall hold ST free and harmless from and indemnify ST for any loss or damage including legal costs arising from their infringement Doc ID 023225 Rev 1 61 64 Software license agreement and disclaimer UM1545 62 64 Applicable Law This Agreement shall be governed by and construed and enforced in accordance with the laws of Switzerland without regard to its rules on conflict of laws or any other rules that would result in the application of a different body of law or to the United Nations Convention on Contracts for the International Sale of Goods You hereby consent to the exclusive jurisdiction of the courts of Geneva Switzerland Entire license This license constitutes the entire agreement between you and ST with respect to the Software and ST shall not be bound by any conditions definitions warranties understandings or representations with respect to the Software other than as expressly provided herein lt Doc ID 023225 Rev 1 UM1545 Revision history 5 Revision history Table 2 Document revision history ICE COSE se 22 Jun 2012 Initial release SZ Doc ID 023225 Rev 1 63 64 UM1545 Please Rea
20. area Figure 34 When a filter adopts one or more out of range coefficients a scaling procedure is required Rescaling a filter implies applying an attenuation in order to bring all its coefficients back into the allowable range The wizard automatically computes the minimum attenuation to be applied To preserve the global filter frequency response an equal gain must be applied in order to compensate the attenuation This goal is reached by applying a different gain Gi to each biquad such that GO G1 GN 1 A where A is the required attenuation The wizard automatically computes also the maximum applicable gains with respect to the notation limits and checks whether the total amount of gain is equal to or exceeds the attenuation required or not In this latter case attenuation not adjustable the minimum gain mismatch reachable between the desired filter frequency response and the rescaled one is displayed Figure 34 shows an example of a filter analysis from the top to the bottom the following information is displayed Processing frequency the sampling frequency for which the coefficients have been computed If it does not match the selected device processing frequency an error message is displayed Scaling information the window shows in black the maximum gain applicable and in red the minimum attenuation required This information is displayed for each filter and globally In this latter case if required the minimum gain mis
21. case of IC failures or not The check for ACK events option has to be checked first Please note that when this option is set a pop up message Figure 8 will warn the user at each I C failure offering the user the possibility of aborting the operation retrying it or ignoring any subsequent warning If this last option is chosen the APW will automatically disable the warn for ACK Failures option To re enable it access the Preferences window as described above Figure 8 I2C failure pop up message FC write operation Failed Press Ignore to disable ACK warnings NirtuallO module will still report failures Css a Doc ID 023225 Rev 1 ky UM1545 Note Note APW walkthrough Delay LPT Only the I C clock speed generated through the LPT interface is strictly related to the performance of the PC the APW is running on and therefore it cannot be predicted with accuracy For this reason from the release 0 910 the Delay option has been added to make the I2C operation slower or faster according to need Its value is basically a counter that has to reach zero before toggling the 1 C clock line The Delay range varies from 1 which corresponds to the fastest configuration possible to 10000 which corresponds to the slowest one Since its effect may vary from one machine to another the following screenshots show three sample cases for Delay 1 Figure 9 5000 Figure 10 and 10 000 Figure 11 Figure 9 1 C data
22. coefficients exceeds the allowable range the scaling is possible and the required attenuation can be compensated Figure 46 In this case the auto scaler feature is recommended Choose between the automatic gain to preserve the overall frequency response or the manual gain to preserve its envelope but not the gain The auto scaler can be disabled as well Under these circumstances the invalid filters are skipped and the overall frequency response is unpredictable One or more coefficients exceeds the allowable range the scaling is possible but the attenuation required cannot be compensated Figure 47 In this case the auto scaler feature is recommended Choose between the automatic gain to minimize the gain mismatch between the desired overall frequency response and the actual response and to preserve the response envelope or the manual gain to preserve the envelope but not minimize the gain mismatch The auto scaler can be disabled as well Under these circumstances the invalid filters are skipped and the overall frequency response is unpredictable In the case of processing frequency mismatch Figure 48 use the LinearX LEAP suite to recompute the coefficients at a sampling frequency supported by the device in use then repeat the analysis with the new coefficients Doc ID 023225 Rev 1 51 64 52 64 Filter import wizard UM1545 Figure 45 Filter import wizard all coefficients in range fore iz inean converte I
23. comply with the following terms and conditions All rights not expressly granted under this license are reserved License Agreement Grant Permission to install use and display the Software on a computer which is owned by you and which is located at your premises is hereby granted to you on a free and non exclusive basis to evaluate and configure Sound Terminal devices It is understood that use of the Software installed at your premises by your subcontractors associates and affiliates shall be considered as use by you for the purpose of this license agreement Restrictions Unless explicitly stated otherwise herein no permission is granted to copy and or modify the Software for any purpose whatsoever The Software is non transferable non sub licensable and may not be distributed in any way by you Any modification of the Software by you requires prior written approval by ST Except as explicitly authorized herein you agree not to c Sell assign sublicense lease rent timeshare grant a security interest in distribute or otherwise make available or transfer the Software d Copy or reproduce the Software e Modify translate adapt reverse engineer decompile disassemble except and only to the extent applicable law specifically prohibits such restriction or otherwise attempt to i discover any source code to the extent the Software is provided in object code or ii create derivative works based on the Softwa
24. graph follow the steps described below 1 Select the kind of filter to be designed by pressing the button on the right side of the graph It is also possible to select which biquadratic filter of the DUT to write in Figure 21 highlighted in red 2 After selecting the filter type a default graph will be plotted A red dot indicates the filter handler Figure 21 Move the mouse over this point left click with the mouse and keep pressed While doing so move the mouse pointer around the graph to modify the filter drawing as needed Release the left button of the mouse when the filter fits the requirements The filter handler may vary according to the filter type In Figure 21 a low pass filter has been selected For this kind of filter a red vertical line is used to clearly identify the frequency whose gain is 3 dB i e the cutoff frequency Doc ID 023225 Rev 1 23 64 APW walkthrough UM1545 24 64 Please note that when moving the mouse pointer to design a graph the corresponding filter coefficients are continuously computed and applied to the device according to the preferences applied that will be discussed below Also the qualitative parameters of the filter Figure 21 highlighted in blue are coherently updated Figure 21 Equalizer Editor tab the upper part graphing and design tools NE Controls Processing Flow Biquadratic Filters Input Output Configuration Equalizer Editor Registers Bank
25. refer to Section 2 6 Scripts or type help the list of available tokens will be displayed in the Log Viewer The Command Shell will appear as depicted in Figure 37 The Command Shell button is located on the right side of the APW window just beneath the log viewer button It can also be activated by left clicking on the Panels drop down menu or pressing F3 Figure 29 Location of Command Shell button Log sieme Lind shell Figure 30 Drop down menu Panels Help Log Viewer Transparent mode Ctl4T Figure 31 Command Shell window Doc ID 023225 Rev 1 ky UM1545 APW walkthrough 2 8 Importing a filter The APW also offers ila possibility of importing the filters designed using the LinearX LEAP suite LinearX Website This feature is implemented by the Filter import wizard option that can be found in the File menu Figure 32 Figure 32 File menu Filter import wizard EPWorkbendi LO Tools Presets Window Help New coul Load configuration Save configuration Run script Run again last script Load Coefficients Table Linear format Filter import wizard LinearX format Export coefficients C array format Export coefficients Matlab format The import wizard appears as depicted in Figure 33 The window is divided into three main areas on top highlighted in red the file selector in the middle highlighted in green the Filter analysis and scaling info
26. the note and press enter The note will be immediately displayed Problems Q The device does not respond to the APW controls A The possible causes are a The device might be in standby b The device may need to be initialized c The Auto Apply option is unchecked Q I do not get any C failure message but keep reading 00h or FFh What s wrong A The possible causes are a The interface board is not properly connected to the ST Sound Terminal device board b The interface board is not correctly powered Q I m importing a LinearX LEAP generated file but the import procedure always skips a filter What s wrong A The possible causes are a The Disable auto scaler option is selected and one of the coefficients is out of range b One filter might be unstable and to avoid dangerous effects it is not applied to the device Doc ID 023225 Rev 1 41 64 F A Q s UM1545 Q I m using an APWLink interface board but it is not listed in the APW startup dialog A The possible causes are a APWLink is a USB device once such a device is connected a short amount of time is required by the OS to recognize and initialize it This time varies depending on the computer Close the APW and wait a few seconds then start it again b Another APW might be opened and using the APWLink Close every APW session and try again Q The DUT stopped reacting to I C commands in the middle of an APW session A A short cir
27. 0 919290 Hex 75AB4Ah FILTO6_AO 1 000000 Hex 7FFFFFh FILTO6_A1 1 918720 o Hex 7ACC50h FILTO6_A2 0 936651 Hex 881BD5h Yo Biquad 07 FILTO7 B 1 000000 0 000000 0 000000 FILTO7 A 1 000000 0 000000 0 000000 FILTO7 BO 1 000000 Hex 400000h FILTO7 B1 0 000000 Hex 000000h FILTO7 B2 0 000000 Hex 000000h FILTO7 AO 1 000000 Hex 7FFFFFh FILTO7 A1 0 000000 Hex 000000h FILTO7 A2 0 000000 Hex 000000h Address 18h Address 14h Address 15h Address Address 16h Address 17h Address 1Dh Address 19h Address 1Ah Address Address 1Bh Address 1Ch Address 22h Address 1Eh Address 1Fh Address Address 20h Address 21h Address Address Address Address Address Address Doc ID 023225 Rev 1 UM1545 lt UM1545 Shortcuts quick reference Appendix F Shortcuts quick reference The following table lists the key shortcuts implemented in the APW Table 1 Shortcut table Leman ee a Doc ID 023225 Rev 1 59 64 Software license agreement and disclaimer UM1545 Appendix G Software license agreement and disclaimer 60 64 Copyright C STMicroelectronics N V ST 2008 Notice This Software including as the case may be software in binary form documentation and other related items is provided by ST under the terms of this license By using this Software you the licensee agree that you have read understood and will
28. 0000 freq 01000 q 1 414000 BiQuad 0 Filt Ch 0 01 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 1 Filt Ch 0 02 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 2 Filt Ch 0 03 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 3 Filt Ch 0 04 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 4 Filt Ch 0 05 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 5 Filt Ch 0 06 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 6 Filt Ch 0 07 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 7 Filt Ch 1 00 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 0 Filt Ch 1 01 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 1 Filt Ch 1 02 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 2 Filt Ch 1 03 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 3 Filt Ch 1 04 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 4 Filt Ch 1 05 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 5 Filt Ch 1 06 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 6 Filt Ch 1 07 type F gain 0 000000 freq 01000 q 1 414000 BiQuad 7 Doc ID 023225 Rev 1 lt UM1545 Script file Appendix C Script file The following example of a script file has extension aps HHH HHH HAHAHAHAHAHA AAAH Test script used to show available commands and their usage HER PE AP REP PE PRE HHH HAHAHAHAHAHA AA This is a comment line Note all values are in hex but the S
29. 3 Reg ceh lt s z1h xxxxxxx1b rio Unserregrvalue Reg csh lt 20h lt xxxxxx0b Fee i es a ee i pe Note This note was added with the Add Note button Select all Clear Save log oy Autoscroll The APW offers the possibility of logging many of the events generated through its controls These logs are automatically saved to a file named debug log that can be found in the APWorkbench Log folder Real time logging is also possible By clicking on the Logs Viewer button Figure 39 the logs viewer window will pop up and show different events in different colors as they are generated Figure 14 Right clicking on the log window will allow the user to copy select clear or save the log Through the preferences customization the user can choose in detail which events to log see Section 2 2 Preferences Using the controls placed on the top margin of the Logs Viewer window the user can also choose between from the left to the right most control keep on top the logger to add a note in the logs or to add an extra break line Please note that the operations regarding the IC register are logged both in hexadecimal and binary notation for easier interpretation lt 18 64 Doc ID 023225 Rev 1 UM1545 2 4 i i T pr zpr TT i A tir Sa FEST NO T SUUND Ppennifial Registers Bank Figure 15 Registers Bank tab ant OTe NET File Tools Help mm ma a e TS Register description FFs C
30. ECTION repeat counter HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH List of available commands HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHE RW Register Write CW1 Coefficient write single hex value CW1F Coefficient write single float value CWA Coefficient write all 5 coeffs hex values CWAF Coefficient write all 5 coeffs float values CR1 Coefficient read single CRA Coefficient read all 5 CCMP1 Coefficient compare single CCMPA Coefficient compare all 5 Pp Pause SECTION_BEGIN Section begin marker then repeat SECTION_END Section end marker RESET Device reset high gt low gt high cycle SET_RST Set RESET line NOTE The CWA CWAF commands make use of the multi write coeffs capability only if the coeff start index is aligned with a bi quadratic starting address Single write operation is used otherwise In any case coeffienct order on the command line is the same as per the relevant device RAM mapping For instance gt gt in case of STA321 CWA lt index gt lt B0 2 gt lt B1 2 gt lt B2 gt lt A2 gt lt A1 2 gt gt gt in case of STA33x CWA lt index gt lt B1 2 gt lt B2 gt lt A1 2 gt lt A2 gt lt B0 2 gt Doc ID 023225 Rev 1 49 64 Script file UM1545 reset the device pause 125 ms set RESET line at 0 low_level pause 200 ms set RESET line at 1 high_level pause 200 ms write value 28h in reg 01h CW1
31. For the complete list of the supported devices please refer to Section 1 1 Supported devices June 2012 Doc ID 023225 Rev 1 1 64 www st com 2 64 Contents UM1545 Contents 1 Ge SA AA AA 5 1 1 Supported devices 5 1 2 Supported interface 5 1 3 Customer requirements 6 1 3 1 Installation notes 2 600006 sis si is ewe ewe bb eae ded 7 1 4 QUICKSIAFE 224542009455 46 064 46505054 oo AA 8 2 APW walkthrough siii ir aa 12 2 1 INMOGUGHON AAP APA e 12 2 2 Preferences 12 2 3 Operations logging 18 2 4 Registers BANK 1502 sans need cr cumin ee eben evan Bees ee ee 19 2 5 Egualizer EQO isotta lane the ite nin 23 2 6 OGIIDIS seudeseeuhoenee gates NA TEBAN ni 29 2 7 Command shell naaa 32 2 8 Importing a filter 33 2 9 Exporting filter coefficients 35 2 10 Miscellaneous controls 37 3 Device specific controls 39 4 FAG S a AA 40 4 1 Questions amp procedures 40 4 2 PIODICMS aldeidi ERI 41 Appendix A Types of filters supported 43 Appendix B Audio processor configuration file
32. NFRINGEMENT OF ANY PATENT COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT UNLESS EXPRESSLY APPROVED IN WRITING BY TWO AUTHORIZED ST REPRESENTATIVES ST PRODUCTS ARE NOT RECOMMENDED AUTHORIZED OR WARRANTED FOR USE IN MILITARY AIR CRAFT SPACE LIFE SAVING OR LIFE SUSTAINING APPLICATIONS NOR IN PRODUCTS OR SYSTEMS WHERE FAILURE OR MALFUNCTION MAY RESULT IN PERSONAL INJURY DEATH OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE ST PRODUCTS WHICH ARE NOT SPECIFIED AS AUTOMOTIVE GRADE MAY ONLY BE USED IN AUTOMOTIVE APPLICATIONS AT USER S OWN RISK Resale of ST products with provisions different from the statements and or technical features set forth in this document shall immediately void any warranty granted by ST for the ST product or service described herein and shall not create or extend in any manner whatsoever any liability of ST ST and the ST logo are trademarks or registered trademarks of ST in various countries Information in this document supersedes and replaces all information previously supplied The ST logo is a registered trademark of STMicroelectronics All other names are the property of their respective owners 2012 STMicroelectronics All rights reserved STMicroelectronics group of companies Australia Belgium Brazil Canada China Czech Republic Finland France Germany Hong Kong India Israel Italy Japan Malaysia Malta Morocco Philippines Singapore Spain Sweden Switzerland United Kingdo
33. PW A Follow this procedure 1 Uncheck the Auto Apply option in the preferences dialog 2 Apply all the desired settings using the controls offered by the APW 3 Select the Registers Bank tab and press the Write All button Q I m not familiar with the device but I d like to know what registers are changed when configure it using the APW is this possible A Follow this procedure 1 Uncheck the Auto Apply option in the preferences dialog 2 Apply all the desired settings using the controls offered by the APW 3 Select the Registers Bank tab and move along the register list Those R W registers marked in violet are the ones you re interested in or this one 1 Configure the device as needed 2 Go to the Registers Bank tab and enable the Enable Check vs Defaults option 3 Now the modified registers are displayed in red move along the list and check Q This device has too many registers and moving along their list to find those want to modify takes too much time is it possible to show only those I m interested in A Of course it is Use the Register List Filter drop down menu to filter the device registers depending on their function Q I m setting up the device but do not get the expected results How do check if the configuration of the device is coherent with the one depicted in the APW controls A Follow this procedure 1 Go to the Register Bank tab and press the Verify All button 2 When the previous operation is o
34. To run a script select from the APW File menu and left click on Run Script as shown in Figure 27 Figure 27 Running a script eer OR STe 36 Tools Presets Window Help New configuration Load configuration Save configuration Run again last script The Run again last script option allows using the last selected script thus avoiding having to specify its location every time For an example of a script please refer to the file SampleScript aps delivered together with the APWorkbench installation package or go to Appendix C Script file Hereafter is a brief description of the syntax and of the functionalities for each token available RESET Resets the device reset pulse to last 50 msec It also sets the I C registers and the coefficients to their default values in the local banks SET RST lt I states Sets the physical reset line to the logic state _state This command together with the P command allows having reset pulses longer than the default value applied with the RESET command Doc ID 023225 Rev 1 29 64 APW walkthrough UM1545 30 64 P lt pause gt Pauses the execution of the script for the time in milliseconds described by pause This argument must be an integer value decimal notation SECTION_BEGIN lt n_iterations gt SECTION END Defines a section of code that has to be cycled n_iteration times decimal notation RW lt address gt lt value gt Writes values into the I C register address hex
35. access the device information The right side of the tab is also occupied by the controls that allow editing the registers hexadecimal and binary notation are supported After choosing the register either from the list on the left or by typing its address in hexadecimal notation in the designated space the user can modify its content by typing the new value for the whole register or by toggling only the desired bits by left clicking on the binary visualization Figure 18 highlighted in blue Press the Write button to apply the new register value once it has been established Please note that both the Read and Write buttons will follow the Auto Apply and Auto Retrieve preferences Finally the Dump button allows dumping all the local bank registers in the log viewer windows as shown in Figure 19 highlighted in red Unavailable registers are displayed with the symbol Figure 19 Local bank register values dumped in the log viewer ic RIS T mia Taman E SU aga 5 Sai aoa E sn ahi A Controls Processing Flow Biquadratic Filters Input Output Configuration Equalizer Editor Registers Bank Register list filter All no filter i MAR hoc ne Register xE 7 Register read write Address Data CC Hex 00 204 Decimal 0 ohh de ga e E Gl ANG ANG Aa ee Be i LI Auto apply on bit changes Read Unite Inspection commands Legend registers colors
36. adecimal notation RR lt address gt Reads the IC register address hexadecimal notation RCMP lt address gt lt value gt Reads the 1 C register address and compares it with va ue hexadecimal notation CWA lt address gt lt coeff 1 gt lt coeff 2 gt lt coeff 3 gt lt coeff 4 gt lt coeff 5 gt Writes all five coefficients of a biquadratic filter at the location address hexadecimal notation CWAF lt address gt lt coeff 1 gt lt coeff 2 gt lt coeff 3 gt lt coeff 4 gt lt coeff 5 gt The same as CWA floating point notation CW1 lt address gt lt coeff gt Writes a single coefficient hexadecimal notation CW1F lt address gt lt coeff gt The same as CW1 floating point notation CR1 lt address gt Reads a single coefficient located at address hexadecimal notation CRA lt address gt Reads five consecutive coefficients starting from location address hexadecimal notation CCMP1 lt address gt lt coeff gt Reads the coefficient located at address and compares it with coeff hexadecimal notation CCMPA lt address gt lt coeff 1 gt lt coeff 2 gt lt coeff 3 gt lt coeff 4 gt lt coeff 5 gt Reads five consecutive coefficients starting from location address and compares them with coeff 1 coeff 5 hexadecimal notation APWLINK_INIT_ADC Initializes the APWLink onboard ADC see AN4118 APWLink USB interface board for Sound Terminal demonstration boards for further inf
37. and clock line when Delay 1 687 490 C07 520 boi 40 1 senile I2C Clock The clock period is 8 6 us hence Fmax is 116 kHz Figure 10 I2C data and clock line when Delay 5000 676 919 Brr 410 12C Clock The clock period is 113 8 us hence Fmax is 8 8 kHz Doc ID 023225 Rev 1 15 64 APW walkthrough UM1545 Figure 11 1 C data and clock line when Delay 10 000 431 534 431 977 Note The clock period is 216 us hence Fmax is 4 6 kHz FC clock USB only when using the APWLink interface the user can set the I C bus clock using this control The supported frequencies are 50 kHz 100 kHz 200 kHz and 400 kHz Register 1 0 settings Auto Apply Registers Values influences how the APW writes the 1 C register and the coefficient values Figure 12 shows the two possible configurations If Auto Apply is set the new register and coefficient values will be written in both the local and the device banks red arrow On the other hand when this option is not set the new information will be transmitted only to the ocal banks blue arrow In this latter case the content of the local banks can be copied into the device banks all at once using the Apply button in the upper right hand corner of the APW window see Section 2 10 Miscellaneous controls By default this option is set to guarantee the content alignment between the two banks Figure 12 Auto Apply option Local Banks Coefficients Write Register Co
38. arallel to serial SAI out config 1 Serial to parallel 2 SA in 2 config O Serial to parallel 2 SA in 2 config Auifshare register Sample rate converter input selection Parallel to senal data PLL contig 0 PLL contig 1 PEL contig PLL contig 3 PLL ple register PLL status ADE config 0 Clock contig 0 Miscellaneous register PLL b register Headphone detection 1 Headphone detection 2 Read All rite All Very all Load Defaults Enable check vs defaults Figure 18 Register filter and register editor Register description Address Data AAW Default i Hagar Met Volume configuration AO Master volume Al Processing ch 0 volume Az Processing ch volume 43 Register read write Processing ch 2 volume A4 Processing ch 3 volume 45 Address Data 80 ated FS 160 Decimal 245 E E 5 ECS 2 tog Auto apply or bit changes On the top right side of the tab is located the Register Filter It allows displaying in the list of registers only those registers that have the same device features Figure 18 highlighted in Doc ID 023225 Rev 1 21 64 APW walkthrough UM1545 22 64 red This option is very useful since it avoids moving along the whole list of registers that can be very long when looking for a specific register thus making it easier and faster to
39. cuit either on the DUT board or on the APWLink board might have occurred Under such circumstances the FTDI chip on the APWLink board might hang Close the APW unplug the interface board and restart from the beginning UM1545 Types of filters supported Appendix A Types of filters supported The following figures show an example of each filter supported by the Equalizer Editor Figure 40 Peak filter gain 10 dB freq 1 kHz Q 1 41 30 40 pai 70 ES 200 300 400 f 500 800 k 3k 4k 5k Ek Bk 10 k Note The gain might also be negative Figure 41 Low pass filter gain 0 dB freq 1 kHz Q 0 71 30 40 mm pai 70 a0 200 300 400 600 800 4k al z zh ak 5k Ek Bk 10 k Doc ID 023225 Rev 1 43 64 Types of filters supported UM1545 Figure 42 High pass filter gain 0 dB freq 1 kHz Q 0 71 200 300 400 f 600 800 4k k zh ak 5k Ek Ek 10 k 30 40 pai mi a0 200 300 400 f 500 800 ak k zh ak 5k Ek Bk 10 k Note As these filters are made to enhance or attenuate the low frequencies the gain might be positive also In any case the gain of the high frequencies is always null 44 64 Doc ID 023225 Rev 1 UM1545 Types of filters supported Figure 44 High shelf filter gain 10 dB freq 1 kHz slope 1 20 30 40 pai 70 a0 200 300 400 f 500 800 ik k 3k ak 5k Ek Ek 10 k Note As these filters are made to enhance or attenuate the high frequencies the gain might be posit
40. d Carefully Information in this document is provided solely in connection with ST products STMicroelectronics NV and its subsidiaries ST reserve the right to make changes corrections modifications or improvements to this document and the products and services described herein at any time without notice All ST products are sold pursuant to ST s terms and conditions of sale Purchasers are solely responsible for the choice selection and use of the ST products and services described herein and ST assumes no liability whatsoever relating to the choice selection or use of the ST products and services described herein No license express or implied by estoppel or otherwise to any intellectual property rights is granted under this document If any part of this document refers to any third party products or services it shall not be deemed a license grant by ST for the use of such third party products or services or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such third party products or services or any intellectual property contained therein UNLESS OTHERWISE SET FORTH IN ST S TERMS AND CONDITIONS OF SALE ST DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY WITH RESPECT TO THE USE AND OR SALE OF ST PRODUCTS INCLUDING WITHOUT LIMITATION IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND THEIR EQUIVALENTS UNDER THE LAWS OF ANY JURISDICTION OR I
41. e total frequency response exceeds the threshold its plot becomes dark orange The prescaler controls highlighted in red show the designed filter maximum gain and the attenuation required to satisfy the requirements The threshold marked by an orange line is user definable and can be changed either by editing the Gain limit box or by manually dragging the marker on the plot Figure 22 Auto scaler Controls Processing Flow Biquadratic Filters Input Output Configuration Equalizer Editor Registers Bank Biquadratic editor Biuad 1 LoShelt HiShelf Gain Freq F 15 00 1000 1 80 Coefficients bi 2 828094 b2 FODF58 al 2 707266 BU a 849163 Ll lp LILI DL Tee ZARA 30 40 506070 30 200 600 800 1k zk 3k 4k Skek amp k 10k 2 Channel controls Presets Prescaler Selected channel Channel E Gain limit dB 2500 Auto aligned channels U Flat Peak level dB 30 00 Biguads chain overview Attenuation JB So E 78 9101112 Uri ASA HAH BE EHE DEE Enable auto scaler Enable auto apply Coefficient scaling Sound Terminal products adopt a 24 bit fixed point notation to handle the filter coefficients APW is also able to check whether the computed coefficients fit the notation or not In this latter case a warning message appears on the top left of the plot Exceeding the mathematical notation limits generates a filter frequency response different from the desired one to see the real freque
42. ed with ten numbers after the comma For this reason and for space constraints they might not be completely displayed e Filter Editor Settings Show Information in EQ Graphic shows gain and frequency information when moving with the pointer over the graphic Miscellaneous Load Preferences on Startup the APW loads the preferences used the previous time Save Preferences on Exit when quitting the APW saves a copy of the current preferences setup e Startup Operations this option modifies how the APW interacts with the device at startup The APW can read the device configuration from the DUT Device Under Test or set it from its local banks in this latter case the device defaults will be applied A No Operation option is also available If chosen the APW will not perform any operation on the DUT at startup Please note that by choosing this latter option the device configuration stored in the APW and the one stored in the device might not be the same On the bottom left side of the dialog are grouped all the preferences concerning the register I O setup Since these options will customize how the APW will behave when performing any I C operation do not modify them unless strictly needed FC Options Check for ACK Events if selected the APW will check for IC operations acknowledge otherwise it will be ignored Warn for ACK Failures through this option the user can choose whether to be informed in
43. efficient Device Banks Coefficients Auto Apply is ON Auto Apply 1s OFF 16 64 Doc ID 023225 Rev 1 AY UM1545 APW walkthrough Auto retrieve registers values influences how the APW retrieves the IC register and the coefficient values Figure 13 Auto Retrieve option Local Banks Coefficients Read Register Coefficient Device Banks Coefficients Figure 13 shows the two possible configurations When the Auto Retrieve is on blue arrow the requested information is read from the device banks and then copied into the local banks and displayed to the user On the other hand when the Auto Retrieve is off the requested information is read only from the Local Banks red arrow By default this option is not set since the content of the local and the device banks are meant to be aligned It is suggested to keep this option disabled unless the Auto Apply option is also modified fe Auto Retrieve is OFF Auto Retrieve is ON Use the Save Preferences button to save all the preferences set up Doc ID 023225 Rev 1 17 64 APW walkthrough UM1545 2 3 Operations logging Figure 14 Real time logger window Keep on top Add note Note right click on the logger window for more options Date Wednesday 12 November os Interface AP Interface LFT Product STASZI Rae START OF LOG 8 r10_SetPFhON device 15 ON rio ResetDevice T reset pulse generated rio SetRegvalue
44. egister address in hexadecimal notation Data the actual value of the register in hexadecimal notation R W register access type if read write or read only Read only or reserved registers are displayed in grey Default the register defaults are defined according to the device datasheet As additional information the list of registers highlights in violet every register whose value in the local bank is not aligned with the value stored in the device bank thus allowing to visualize all the modifications applied only the to local bank Figure 16 shows an example of this feature A small reminder of the colors and their meanings is provided in the bottom right corner of the panel Doc ID 023225 Rev 1 19 64 APW walkthrough UM1545 Figure 16 Registers modified in the local bank ara mm mm ein orar is icaro m_ I rocosmmsrosmrcrismmo e pepe GH Register description Default Volume configuration AQ FE Fa FE Master volume A 00 A O Processing ch 0 volume Ae 35 Rew 40 Processing ch 1 volume As 1F Aw 48 Processing ch 2 volume Ad 45 Hr 46 Processing ch 3 volume la 45 Fu 46 Serial to parallel 1 SAI in 1 config 0 BO Dia RAV DE Serial to parallel 1 SA in 1 config 1 BI J Rew 9 The registers list highlights in violet those registers modified in the local bank with respect to the device bank At the bottom of the tab four buttons and a checkbox implement the following functions Read All
45. ents bank and the filters Doc ID 023225 Rev 1 37 64 APW walkthrough UM1545 38 64 bank Each configuration is saved in a file with extension apc The functionalities of each button include New resets the APW controls and the device to allow the user to specify a new setup starting from the device default settings Open opens a configuration file and if the Auto Apply option is set it also applies the configuration to the device banks Save saves the device configuration in a configuration file see Appendix B Audio processor configuration file Apply applies the configuration loaded with the Open button this control bypasses the Auto Apply preference Once the configuration has been applied a window will pop up to inform the user of the modifications Retrieve reads the device configuration and sets the APW control coherently this control bypasses the Auto Retrieve preference Finally the Presets frame offers the possibility of storing more than one configuration and switching between them on the fly thus avoiding the Load Apply procedure Eight presets are available the store and recall procedures are as follows 3 N 6 N 7 To Store Press the Store button Select the memory in which the user wants to store the configuration To Load Press the Recall button The APW will show the available presets Select the memory from which the user wants to load the configuration Please note that for eac
46. enu preferences 12 Pr l renc s dal LL 2e sea aid eh eh Ada 13 1 C failure pop up message 4 ee ue ee 14 I C data and clock line when Delay 1 15 C data and clock line when Delay 5000 15 C data and clock line when Delay 10 000 16 AUTO ADDY OPTION aias see cb tas ba ee be ens et Han TD Rees So 16 Auto Retrieve ODH M 1 25 24 BAMBANG SLITTA DTO BALA RIINA 17 Real time logger window 18 Registers BANDE deleteria ws bares 19 Registers modified in the local bank 20 Example of the behavior of the Enable check vs defaults option 21 Register filter and register editor 21 Local bank register values dumped in the log viewer 22 Eg alzer Editortab SRE da dE oes He WE Hae bee a Oe eer ee eae AN YA pee 23 Equalizer Editor tab the upper part graphing and design tools 24 SS RR TA 25 SCalING COCTICICNIS aaa apang a fa baila er oct 26 Equalizer Editor tab lower part concerning filter design customization 26 Generic processing block 27 Equalizer Editor tab miscellaneous options
47. fficients bank and the derived filters bank will be considered and referred to as the device configuration Preferences The Preferences dialog allows customizing the behavior of the APW in order to fit the needs of every user Select the Tools menu and left click on Preferences to show the dialog Figure 6 The dialog should appear as shown in Figure 7 It can be divided into three main areas The left top side of the dialog groups all the controls concerning the tracing preferences highlighted in red Figure 6 Tools menu preferences CAP Workbeneh File ME Help Fixed point calculator Max power calculator juadratic Filters Input Output Configuration Equalizer Editar Registers Bank TESE made spica CORE SR I a I i Built in Self Test Preferences Doc ID 023225 Rev 1 ky UM1545 Figure 7 Preferences dialog Trace settings Print line number in logs Events to be traced _ Trace register read operations Trace register write operations Trace coefficient read operations Trace coefficient write op rations Trace register modified operations Trace reg miscellaneous operations Trace O events Virtuall module 3 Register l O settings Auto retrieve registers values Auto apply registers changes 20 options Check for ACE event Wam for ACE failures I2C clock USB only 100kHz E APW walkthrough Filter Editor settings Show information in EC graphic Miscellaneous
48. h Limiter 2 Ext Release Threshold Reg 36h 00h Extended Configuraton Register Reg 37h 00h EQ Soft Volume Config fade in Reg 38h 00h EQ Soft Volume Config fade out Reg 39h 01h DRC RMS Filter Coefficient CO Bits 25 16 Reg 3Ah EEh DRC RMS Filter Coefficient CO Bits 15 8 Reg 3Bh FFh DRC RMS Filter Coefficient CO Bits 7 0 Reg 3Ch 7Eh DRC RMS Filter Coefficient C1 Bits 25 16 Reg 3Dh COh DRC RMS Filter Coefficient C1 Bits 15 8 Reg SEh 26h DRC RMS Filter Coefficient C1 Bits 7 0 Reg 3Fh 00h Reserved HHHHHHHHHHHHHHHHH FFX coefficients HAHAHHHHHHHHHHHHHHE Coef 000h 000000h Coefficient 0x00 C1H10 b1 2 Coef 001h 000000h Coefficient 0x01 C1H11 b2 Coef 002h 000000h Coefficient 0x02 C1H12 a1 2 Coef 003h 000000h Coefficient 0x03 C1H13 a2 Coef 004h 400000h Coefficient 0x04 C1H14 b0 2 Coef 005h 000000h Coefficient 0x05 C1H20 b1 2 Coef 006h 000000h Coefficient 0x06 C1H21 b2 Coef 007h 000000h Coefficient 0x07 C1H22 a1 2 Coef 008h 000000h Coefficient 0x08 C1H23 a2 Coef 009h 400000h Coefficient 0x09 C1H24 b0 2 Coef 00Ah 000000h Coefficient OxOA C1H30 Coef 00Bh 000000h Coefficient 0x0B C1H31 Coef 00Ch 000000h Coefficient 0x0C C1H32 Coef 00Dh 000000h Coefficient 0x0D C1H33 PN b1 2 b2 a1 2 a2 n TT Coef OOEh 400000h Coefficient OxOE C1H34 b0 2
49. h supported device the APW has a dedicated presets folder Figure 1 thus ensuring that different presets for different devices will not be overwritten The device configuration and presets options are also available through the File and Presets menu of the APW main window The lower part of the miscellaneous controls includes the Logs Viewer the Exit and the Help buttons Doc ID 023225 Rev 1 ky UM1545 Device specific controls 3 Device specific controls Apart from the controls described in Section 2 APW walkthrough the APW offers for each supported device a dedicated set of tabs Since these controls will vary significantly from product to product a dedicated Help menu will be provided for each device AY Doc ID 023225 Rev 1 39 64 F A Q s UM1545 4 F A Q s In this section we provide a few guidelines to answer the most common questions 4 1 Questions amp procedures Q I need to interface with a device that has been already set from an external controller How do retrieve these settings with the APW A Follow this procedure 1 Be sure that the interface is not connected to the device start the APW and set the no operation option in the Startup Preferences Save the preferences and close the program 2 Connect the interface and start the APW 3 Press the Retrieve button 4 Press the Save button to save the configuration Q I want to apply all the settings at once and not step by step How do set the A
50. he Device selection frame the View specifications button allows quickly displaying the device datasheet if provided together with the APW installation Q 8 64 Doc ID 023225 Rev 1 UM1545 Getting started Figure 3 Startup settings interface selection aa List of supported devices 214221 External power bridge STASOG xb Device description Digital 4 channel power amplifier up to 13 biguads per channel pre and post mining stages bass treble tone control headphone detection integrated power bridge Output power 105rw Supply voltage 7 55 up to 3 54 Sampling rates 32 KHz up to 192KHz SRC Limiters Anti clipping nga PG Pili earn re Soe WE speciicaliohs Interface selection COM Port oF CO USE AP Link ESM Commurnicalona Fi se C3 Simulation LET Part Sg LPT AFInterface 1378h The lower part of the Startup settings dialog instead allows specifying the interface to be used Figure 3 highlighted in red Please note that when selecting the AP Interface use this option for the LPT interface too or the USB option respectively the available parallel ports or the available COM ports will be enumerated in the drop down menu on the right Select the correct interface and communication port then press OK Among the physical interfaces the Simulation option is also available Use this option if you do not want to be connected to an interface APW evaluation and testing only
51. ismatch 250 dB Analysis result One or more coefficients are out of range 1 0 1 0 Re scaling is required but full gain compensation is not possible Enable auto scaling feature or improper filters will be discarded Filter import options Enable auto scaler automatic gain adjustment Fequired gan offsel 5 bl PIANOI negaliye values only Enable auto scaler manual gain adjustment i Disable auto scaler skip invalid filters if any Import filter Doc ID 023225 Rev 1 lt UM1545 Filter import wizard Figure 48 Filter import wizard wrong processing frequency Filter imeore wizard Lineare converter Input filter Linear format Filename CAD ocuments and settings rancesco bianchi u Documents Filter analysis and scaling information Pia in lata Warning unsupported processing frequency Processing freq 48 KHz Only 96KHz 88 2KHz and 64KHz allowed Scaling information Below numbers show for each IIR the amount of required coefficients attenuation in red or allowed gain in black with respect to the allowed range 1 0 1 0 0 al 3 0 04 0 06 053 0 13 0 00 Allowed gain Hao de Required Attenuation 000 de Minimum gain mismatch dE gt Rounded gain mismatch ni dB Analysis result All coefficients are within allowed range 1 0 1 0 Filter import ophons Enable auto tcater aulomahe gain adjustment Required gain olfsel hegative values only
52. ive also In any case the gain of the low frequencies is always null Doc ID 023225 Rev 1 45 64 Audio processor configuration file UM1545 Appendix B Audio processor configuration file The following example of a device configuration file has extension apc Moving along the text the registers bank the coefficients bank and the filters bank that together comprise the device configuration as described in the introduction of Section 2 1 IntroductionSection 2 APW walkthrough can be easily identified HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH Date Wednesday 12 November 08 Interface Simulation NONE Product STA339BWS HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH HHHRHHHHHRHHH RH FFX registers HHR HHH RHHH RHH Reg 00h 63h Configuration Register A Reg 01h 80h Configuration Register B Reg 02h 97h Configuration Register C Reg 03h 40h Configuration Register D C2h Configuration Register E 5Ch Configuration Register F Reg 06h 10h Master Mute FFh Master Volume 60h Channel 1 Volume 60h Channel 2 Volume 60h Channel 3 Volume 80h Audio Preset Register 1 00h Audio Preset Register 2 00h Reserved 00h Channel 1 Config 40h Channel 2 Config 80h Channel 3 Config 77h Bass and Treble Tone Control 6Ah Limiter 1 Attack Release Rate 69h Limiter 1 Attack Release Threshold 6Ah Limiter 2
53. m United States of America www st com 64 64 Doc ID 023225 Rev 1 ky
54. match is also provided Analysis result a short description of the outcome of the analysis Figure 34 Filter analysis and scaling information Filter analysis and ecalng information Processing freq Ib KHz Scaling ntormation Below numbers show for each A the amount of required coefficiente attenuation in red or allowed gain in black with respect to the allowed range 1 0 1 0 o 2 5 4 E 7 a a Mn fe 0 04 006 053 013 340 028 09 Allowed gairi 1 40 dE Required Attenuation 340 de Minimum gain mi malch 200 di 4Rbunded gain mismatch 2 50 dB Sna result One or more coefficients are out of range 1 0 1 0 Re scaling is required but full gain compensation is not possible Enable auto scaling feature or improper filters will be discarded Depending on the outcome of the filter analysis the user can choose between three possible solutions Figure 35 Enable auto scaler automatic gain adjustment the import option automatically applies the best gains and attenuations to guarantee the preservation of the global frequency 34 64 Doc ID 023225 Rev 1 ky UM1545 2 9 APW walkthrough response If this goal cannot be achieved the import option will apply the best gains to minimize the gain mismatch between the desired overall frequency response and the actual response Enable auto scaler manual gain adjustment the user is given the choice of the attenuation to apply The re
55. me of the selected preferences AA Auto Apply AR Auto Retrieve ACK Warn for ACK Failures Some of the APW features can be activated using easy shortcuts The list is available in Section Appendix F Shortcuts quick reference AY Doc ID 023225 Rev 1 11 64 APW walkthrough UM1545 2 2 1 2 2 12 64 APW walkthrough Introduction This chapter will guide the user through many of the controls and features offered by the APWorkbench Before proceeding with the following paragraphs an important concept has to be clarified For each supported device the APW has an internal registers bank and a coefficients bank which will be referred to from now on as local banks that reproduce the banks contained in the device which will be referred to from now on as device banks It is up to the user to decide how to handle the local and the device banks by setting the Auto Apply and the Auto Retrieve preferences The consequences and the advantages of these choices will be thoroughly explained in Section 2 2 Preferences Please note that the registers bank and the coefficients bank contain all the information needed to completely describe the device setup Nevertheless the APW also uses a third structure called filter bank Starting from the filters coefficients this bank stores the filters setup in terms of each filters qualitative parameters gain cutoff frequency filter type etc From now on the ensemble of the registers bank coe
56. ncy response right click on the plot and select Show fixed point plot A violet graph will appear showing the real applied filter Figure 23 shows an example of this behavior Doc ID 023225 Rev 1 25 64 APW walkthrough UM1545 Figure 23 Scaling coefficients Controls Processing Flow Biquadratic Filters Input Output Configuration Equalizer Editor Registers Bank ate Biquadratic editor 35 ie WARNING coefficients scaling required if Tar Biduad 1 Check FEAE bwienab ing fised point precision plat da n r Gan Freg Slope 4 46 3187 1 00 Coefficients birz 800054 b2 716009 al a _GAB7E7 Add PEQ point 30 40 m 50 FO 90 200 300 400 600 8001k 2k 3k 4k 5k sk Bk 10 k Set ranges E a hannel controls Presets Prescaler w Show coordinates info Selected channel Channel 0 Ing Gain limit dB 25 00 w Show fixed point plot Show individual PEG plats Auto aligned channels NG Peak level dE 21 08 sona chain overview Attenuation dB 0 00 Zoom out gt 6 B 3 101112 BOBDE COCHE Enable auto scaler aga Show usage Filter stability check APW automatically checks the stability of the desired filter before applying it to the device In the case of an unstable filter the coefficients are not applied and a warning message appears on the top left of the plot Figure 24 Equalizer Editor tab lower part concerning filter design customization Channel controls Presets Prescale
57. nput filter Linear format Filename iii t lt lt ANN C Documents and Settings francesco bianchi My Documents Filter analysis and scaling Information Processing freg 96 KHz Scaling information Below numbers show foreach IR the amount of required coefficients attenuation in red or allowed gain fin black with respect to the allowed range 1 0 1 0 Pao aoao os iao a29 a36 Allowed gain 140 dE Required Attenuation dE Minimum gain mismatch d gt Rounded gain mismatch dB Analyse result All coefficients are within allowed range 1 0 1 0 Filter import options Enable auttscalet automatic gain adjustment Preguired gam offset IE n gative values only O Enable auto scaler manual gain adjustment Disable auto ecaler skip invalid filters if any 0 00 db Irnport filter Doc ID 023225 Rev 1 lt UM1545 Filter import wizard Figure 46 Filter import wizard adjustable attenuation one coefficient out of range Input filter Linear format haaa aan an EE Filename CAD ocuments and Settings francesco bianchi My Documents Filter analysis and scaling Information Processing freg 9 KHz Scaling information Below numbers show for each IF the amount of required coefficients attenuation in red or allowed gain fin black with respect to the allowed range 1 0 1 0 0 o FZ 3 4 5 E Fi g 4 G 12
58. oefficients for an example of the exported files lt Doc ID 023225 Rev 1 UM1545 APW walkthrough 2 10 Miscellaneous controls Figure 39 Miscellaneous controls Device controls Device power ut Configuration Presets Ed LL O oF A lle Li hae badi i PRC kl ee POI Ta Pepe Generate once On the right side of the window some miscellaneous controls can be found Figure 39 The Device Controls frame highlighted in red groups the following functions Device power up controls the device standby This control physically handles the device standby pin Reset controls the reset of the device This control physically handles the device reset pin thus it forces the reset It also writes the device default values into the local bank as described in the datasheet It performs the same operations performed by the RESET token in the script 50 milliseconds reset pulse Initialize applies the minimum group of settings to bring the device to an operational status these settings may vary from product to product Bridge power up controls the power up of the bridge Below these controls is located the Configuration frame highlighted in blue The APW indeed offers the possibility of saving or loading a device configuration in order to avoid repeating long setup procedures According to the definition given in the ntroduction the device configuration will comprise the registers bank the coeffici
59. of range 54 Filter import wizard wrong processing frequency 55 Doc ID 023225 Rev 1 UM1545 1 Getting started 1 1 Supported devices Getting started The products actually supported by the APW all belonging to the ST Sound Terminal family include STA308A STA309A STA321 STA323W STA326 STA333BW STA333W STA339BW STASSIBWS STA350BW STA369BW STAS69BWS STA381BW STA381BWS STA529 STA559BW STA559BWS Other customer specific products are supported by the APW but require an activation code For further information please contact your local ST sales office 1 2 Supported interface The APW needs an interface to interact with the various devices it supports At the present time the supported interface is APWLink interface via FTDI USB UART FIFO I C see AN4118 APWLink USB interface board for Sound Terminal demonstration boards for further information Doc ID 023225 Rev 1 5 64 Getting started UM1545 1 3 Customer requirements Figure 1 APW package folder fi APWorkbench_v1090 Seles File Edit View Favorites Tools Help G Bak J Search WE Folders Address C APWorkbench_v 1090 APWorkbench exe Application 6 19 2012 4 37 PM STAudioTools dll A Application Extension 6 19 2012 3 45 PM a STCommonPanels all Application Extension 6 19 2012
60. onfig 1 FF Config 0 FFs Config 2 PM map 1 Ph map 2 Pix map 3 E tristate time upper part EA tristate time lower part EA tristate time after power up upper part EA tristate time after power up lower part CE tristate time upper part CE tristate time lower part CE tristate time after power up upper part CE triztate time after power up lower part Fx status Power status 2 Pi Out 1 config O PM Dub 1 config 1 Pah Cut 1 config 2 Ph Out 2 config 0 Ph Out 2 config 1 Ph Out 2 config 2 Ph Cut 3 config 0 Ph Out 3 config 1 Pix Out 3 config 2 PM Out 4 config 0 veel gutt eonig i Te Last command APW walkthrough Load Defaults a ee TANA ea alain ar ES IC gt PINIGIORIECITONICS H Enable check ve defaults Register Event Register list filter All no filter Register read write Address O Hex q Decimal 208 Ske RE Auto apply on bit changes lnepecton commands Legend registers colors M Modified but not applied yet DB Curent value equals default E Curent value differs from default Register is read only Coefficient Event The Registers Bank tab offers the user direct access to the device I C registers Figure 15 The panel is mainly occupied by the list of the device registers From the left column to the rightmost one the list offers the following information Register description the register extended name Address the r
61. ormation Doc ID 023225 Rev 1 ky UM1545 APW walkthrough APWLINK ADC RW lt address gt lt value gt Writes value into the I C register address of the APWLink onboard ADC hexadecimal notation APWLINK_ADC_RR lt address gt Reads the IC register address of the APWLink onboard ADC hexadecimal notation CLEAR Clears the log viewer contents DUMP_REGISTERS Dumps all the device registers HELP Displays a list of the available commands in the Log Viewer Comment It is the comment token Every word after this tag will be ignored by the command parser Figure 28 Events in logger upon completion of a script Add note Mate right click on the logger window for more options Section repeat 33 100 Coef 014h 018h lt 40EB23h 800659h 7cA63Fh S1837Bh 7F3947h coef 014h 018h gt 000000h 000000h 000000h o00000h 000000h WARNING expected 40EB23h 80C659h 7CAs3Fh S183FEh 7F39A7h rio SertmultipleCoefttva ue WARNING Mmulti write forced not on biguad boundary scripteventi coef 000h 004h lt s0cessh 7CA63Fh 7F3947h S18376h 40EB6z23h C Keep on top SErIPtevent ey SCrIpteventl iy scripteventi SCrIptEvent SCriptevente scriptEvent Section repeat 100 100 Coef 014h 016h lt 40E823h 802659h 7CAs3Fh 81837Bh FFS9AFH coef 014h 018h gt 000000h 000000h 000000h 000000h 000000h WARNING expected 40EB23h 800653h 7CA63Fh 218 327E6h 7F38AFh
62. ows XP to Windows 7 no other OS is supported e The FTDI driver this driver is free and can be downloaded from http www ftdichip com Drivers D2XX htm This driver will only be required to communicate with a target device or demonstration board through the APWLink 6 64 Doc ID 023225 Rev 1 ky UM1545 Getting started interface APW will run in SIMULATION mode only when the FTDI driver is not installed or the APWLink interface is not connected to the PC Microsoft Visual C 2008 Feature Pack Redistributable package if not already available on the target PC These libraries can be downloaded for free from the Microsoft web site see below Section 1 3 1 Installation notes 1 3 1 Installation notes Microsoft Visual C 2008 Feature Pack Redistributable Package x86 To properly run APWorkbench on some machines the user may be required to install the updated Microsoft VC 2008 Feature Pack redistributable libraries available at no cost from the Microsoft web page at http www microsoft com en us download details aspx id 10015 FTDIChip USB communication driver APWLink interface Concerning USB communication APWLink interface proper OS drivers must be installed available for free from the FTDI website below Note that different versions are available depending on the installed OS either x86 32 bit or x64 64 bit All Windows versions including Vista and Win 7 64 bit are supported http www ftdichi
63. p com Drivers D2XX htm AY Doc ID 023225 Rev 1 7 64 Getting started UM1545 1 4 Quick start Figure 2 Startup settings device selection Device selection O List of supported devices Era External power bridge STASUG 2x6 Device description Digital 4 channel power amplifier up to 13 biquads per channel pre and post mining stages bass treble tone control headphone detection integrated power bridge Output power 105m Supply voltage 7 55 up to 3 55 Sampling rates 32 KHz up to 192KHz SRC Limiters Anti clipping WIG spert Interface selection COM Port Po di DJ USE AFW Link BOM Communicationa Fi il 3 Simulation LET Bad Sag LPT APIntefacel 378h To start the APW double click on the file APWorkbench exe Each time the APW is started the Startup settings dialog pops up The upper part of this dialog allows the product selection Figure 2 highlighted in red Use the drop down menu to select between the supported devices Please note that for each device a brief product description will be supplied in the frame underneath For those products not provided with an embedded power bridge the Startup settings dialog offers the possibility of specifying the external bridge in use Selecting the correct power bridge allows the APW to automatically apply the settings to get the best audio performances For those devices embedding a power bridge this selection is not available In the lower part of t
64. pply a filter or not In this latter case to transfer the filter or filters set up for the device the Apply button has to be used Please be aware that this button bypasses the Auto Apply option The figure below shows the global frequency response of the selected channel yellow line overlapped by the graphs of the two filters green lines contributing to it Figure 26 Equalizer Editor tab miscellaneous options Controls Processing Flow Biquadratic Filters Input Output Configuration Equalizer Editor Registers Bank 30 40 506070 90 Channel controle Selected channel Channel o Auto aligned channels Biguads chain overview cee BN E 9 101112 rave alta tala alata ta AE Add PEG point Set ranges w Show coordinates info Show Fixed point plot w Show individual PEQ plots Zoom QUE Copy to clipboard Show usage I JRE The last options available in this tab can be selected using the mouse controls on the graph area By right clicking with the mouse on the graph area a menu will pop up Figure 26 Add Delete PEQ Point a shortcut to add delete a peak filter in the point selected with the mouse Set Ranges allows setting the ranges shown in the graph Show Coordinates Info when this option is enabled the coordinates of the point of the graph on which the mouse is located will pop up Show fixed point plot by default option the APW plots the filters frequency response u
65. r Selected channel Channel 0 Gain limit dB 25 00 i EE Peak level dB 0 00 Auto aligned channels L Rel as chain overview Sal Attenuation dE 0 00 GR OR 94101112 PEEBERLEREBEE ew Enable auto apply The lower part of the Equalizer Editor tab groups several options to customize the design activity Figure 24 On the left side the Channel Controls are displayed Generally the Sound Terminal products are characterized by more than one processing channel and each channel may include several biquadratic filters Figure 25 lt 26 64 Doc ID 023225 Rev 1 UM1545 APW walkthrough Figure 25 Generic processing block Processing Channel 1 BIQ 1 BIQ 2 i i f f f i i f a4 sa x gt A O Processing Channel M BIQ 1 BIQ2 Taking into account this kind of structure the Channel Controls allow the user to Select the processing channel Selecta specific filter among the ones available in the selected channel Each button of the row at the bottom of the controls corresponds to a filter Moreover each button rather than indicating the biquad number indicates the kind of filter in use according to the following abbreviations P peak filter F flat all pass L low pass H high pass lt low shelf gt high shelf R reserved a biquad is reserved when it is used for an alternate function such as a bass enhancement de emphasis filter
66. r no obligation to provide bug fixes patches upgrades or other enhancements or derivatives of the features functionality or performance of this Software ALL WARRANTIES CONDITIONS OR OTHER TERMS IMPLIED BY LAW ARE EXCLUDED TO THE FULLEST EXTENT PERMITTED BY LAW You acknowledge that the Software and processes and products related thereto are not designed nor authorized for use in life supporting devices You agree to hold ST free and harmless from any liability in connection with the use of the Software and products or processes related in any way thereto No liability ST SHALL HAVE NO LIABILITY FOR DIRECT INDIRECT SPECIAL INCIDENTAL CONSEQUENTIAL EXEMPLARY OR PUNITIVE DAMAGES OF ANY CHARACTER INCLUDING WITHOUT LIMITATION PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON ANY THEORY OF CONTRACT WARRANTY TORT INCLUDING NEGLIGENCE PRODUCT LIABILITY OR OTHERWISE ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES Intellectual property protection You may not include this Software in whole or in part in any patent or patent application in respect of any use or application of the Software by you Termination This license shall terminate without any compensation with immediate effect and without notice if you fail to comply with any of the terms of this license or if you institute litigation against
67. re or ili merge the Software into any other software ST reserves all rights not expressly granted to you hereunder and your use of the Software for any other purpose is expressly prohibited Copyright statements trademarks and publications The name and trademarks of ST may NOT be used in advertising or publicity pertaining to the Software or results obtained therefrom without specific written prior permission by ST Title to copyright in this Software will at all times remain with ST You shall not without prior written permission by ST publish documents referring to the Software or to results based on the Software You shall ensure that all Software references copyright statements and license conditions are not altered or removed from the Software Doc ID 023225 Rev 1 ky UM1545 Software license agreement and disclaimer No warranty THIS SOFTWARE IS PROVIDED BY ST AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY OF SATISFACTORY QUALITY AND FITNESS FOR A PARTICULAR PURPOSE OR USE ARE DISCLAIMED ST MAKES NO REPRESENTATION THAT THE SOFTWARE WILL NOT INFRINGE ANY PATENT COPYRIGHT TRADE SECRET OR OTHER PROPRIETARY RIGHT OF A THIRD PARTY ST does not warrant that use in whole or in part of the Software will be uninterrupted or error free will meet your requirements or will operate with the combination of hardware and software selected by you ST is unde
68. reads all the registers from the device bank in this case the Auto Retrieve option is bypassed Write All writes the content of the local registers bank the values shown in the Data column into the device bank in this case the Auto Apply option is bypassed Verify All compares the contents of the local banks with those of the device banks If any difference is detected the register is displayed in violet Load Defaults loads the registers default settings in the APW local register bank To apply these default settings to the device bank press Write All Enable Check vs Defaults enabling this option the register values stored in the local bank are compared with the default values If any difference is detected the registers are displayed in red otherwise they are displayed in green Figure 17 lt 20 64 Doc ID 023225 Rev 1 UM1545 APW walkthrough Figure 17 Example of the behavior of the Enable check vs defaults option File Took Help Controls Processing Flaw Biquadratic Filters Input Output Configuration Equalizer Editar Registers Bank __ Register description Address Data RAW Default ja Processing ch 3 saturation config 3 i OC Volume configuration FE Master volume Processing ch O volume Processing ch 1 volume Processing ch volume Processing ch 3 volume Serial to parallel 1 SAL in 1 contig 0 Seral to parallel 1 SA in 1 contig 1 Parallel to serial SA cut contig O P
69. rio SetMultipledcoefvalueli WARNING multi write forced not on biquad boundary scriptevent coef 000h 004h lt s0c65sh 7CA63FN 7F39A7h 8183760 40EBz3h scriptevent Section end Number of register write operations 0 Number of coefficient single write operations oO Number of coefficient multi write operations 200 Number of coefficient single read operations a Number of coefficient multi read operations o Number of coefficient single compare operations 0 0 failed Number of coefficient multi compare operations 100 100 failed Elapsed time hh mm ss5 00 00 04 APS script completed Doc ID 023225 Rev 1 31 64 APW walkthrough UM1545 2 7 32 64 After a script has been run a summary of the completed operations is available in the Log Viewer window together with the log of the operations performed Different colors are used to signal particular events Figure 28 Green the operation has ended successfully Red the operation failed Orange the operation has been performed with anomalous parameters e g 5 coefficients have been written starting from an address not corresponding to a biquadratic filter Command shell The scripts tokens can also be cast as instantaneous commands through the Command Shell To open it use the button on the right side of the APW window Figure 29 or select it from the drop down menu Panels Figure 30 For a complete list of the available commands please
70. rmation and at the bottom highlighted in blue the Filter import options These latter options are available depending on the outcome of the filter analysis Figure 33 Filter import wizard Filter iagere vizand linean Convener Input filter Linear format Filename Linea input filenames Filter analysis and scaling anal Processing freg KHz Scaling information Below numbers show for each IF the amount of required coefficients attenuation im E or allowed gain in black wath respect to the allowed range 1 0 1 0 4 eas a T TA AE KI pa ma Required Attenuation dB bdinimum gain mismatch gt dE gt Rounded gain mismatch a dE Analysis result Filter import options Enable auto sceier automatic gain adjustment Frequied gan oflset megahyewaluss oni Enableauto scaler manual gamadjustment Disable auto sesler skip invalid filters if ang do Doc ID 023225 Rev 1 33 64 APW walkthrough UM1545 The LinearX LEAP tool as well as the APW computes the coefficients using a floating point notation which allows a much broader ange e of values than the one allowed by the fixed point notation used by the Sound Terminal devices 1 1 The Filter import wizard takes this difference into account and performs an analysis to verify whether the coefficients fit the fixed point notation or not The outcome of this analysis is given in the Filter analysis and scaling information
71. sing a floating point notation Use this option to generate the plots using the 24 bit fixed point notation as used by the Sound Terminal products Show PEQ Curves the Equalizer Editor shows by default the whole frequency response of the selected processing channel Since as stated before this curve 28 64 Doc ID 023225 Rev 1 ATI UM1545 2 6 APW walkthrough might be the sum of the contribution of two or more filters this option forces the APW to plot also the graph of each single filter Figure 26 Zoom Out resets the zoom setup to the default Copy To Clipboard copies the graph to the clipboard Show Usage displays a short explanation about the usage of the Equalizer Editor Moving the mouse wheel on a filter handler will increase or decrease its Q Moving the wheel on any other point of the graph will vary the zoom Please note that the Sound Terminal products support different processing sampling frequencies and obviously this frequency is a key factor when plotting the filter graphs or computing the coefficients The APW is able to take into account this parameter thus plotting the correct frequency response Depending on the selected device this is performed either automatically or by setting manually the sampling frequency In any case the frequency in use is shown in the APW status bar Scripts Another powerful tool offered by the APW is the capability of writing and running a script
72. sulting global frequency response envelope will be preserved although attenuated by the selected gain Under these circumstances the attenuation might be compensated using the volume controls Disable auto scaler skip invalid filters if any the scaling procedure is disabled and the filters that cannot be applied are skipped The overall frequency response will differ from the desired response Figure 35 Filter import options Filter import options 2 Enable auto scaler automatic gain adjustment Enable auto scaler manual gain adjustment Disable auto scaler skip invalid filters if ang Once the scaling options are set the filters are imported by pressing the Import filter button Before downloading any information into the device the APW also performs a stability check to prevent the user from applying unstable filters thus causing dangerous and unpredictable behaviors At the end of the procedure a message will give the user the number of applied coefficients Invalid filter whether instable or out of range coefficients are skipped each time this happens a warning message appears For further information about the import process please refer to Appendix D Filter import wizard Exporting filter coefficients Filter coefficients can be imported but they can also be exported The APW offers two export formats C C arrays format c file e Matlab arrays format m file The first format is very usef
73. ul for MCU programming while the second one might be used for in depth filter analysis Left click on the File menu to enable these features Figure 36 Figure 36 Exporting coefficients Sea OT Ae TIC Ng Tools Presets Panels Help New configuration Ctrl M Load configuration CtlH Save configuration Ctrl 5 Run script Ctrl R Run again last script Ctrl A Filter import wizard LinearX format Ctrl F Export coefficients C array format Export coefficients Matlab format Doc ID 023225 Rev 1 35 64 APW walkthrough UM1545 36 64 The C C format export feature is also available through the Generate C Code button on the right side of the APW window In both cases the wizard window will appear as depicted in Figure 38 Figure 37 C C format using Generate C code button Retieve Generate C code Emdshel Hep Et Help 96 KHz A ACK Through the wizard the user is given the possibility to customize the information to be exported Figure 38 C code generation wizard stone Wizard Coefficients Aray format Include RAM indexes in the coefficients amay al jee es eee iy L m me leale A ML Sr mt Tira condi EL Lu LE Li indi Bank selection for multi bank enabled devices only _ Bank 0 48 KHz _ Bank 1 44 1 KHz _ Bank 2 32 KHz Output filename APW settings Li Generate C code See Section Appendix E Exporting c
74. ver move along the registers list The APW will display in violet the register whose value is different from the expected one UM1545 4 2 F A Q s Q I m not comfortable with hexadecimal notation when editing the coefficient values in the control panel Can use the floating point one A Of course uncheck Show Values in Hexadecimal in the preference window and you ll be able to enter the values in decimal notation Please be aware that the floating point notation implies a long number of significant decimal digits that cannot be displayed all at once As a result some digits might be hidden from view but can be easily displayed by highlighting the whole number with the mouse Please remember that the coefficients range is from 1 to 1 Q The reset pulse length applied by default using the RESET command in the script does not fit my needs Can set a different value A There s no direct way to change the reset pulse length in a script However the reset procedure can be manually executed using the SET_RST command to move the reset line Just use the following syntax set RESET line at 0 low_level pause 200 ms set RESET line at 1 high level The reset pulse will now last 200 milliseconds This value can be changed as needed Q want to add a note in the log to mark a section of interest for my work How do do that A Follow this procedure 1 Press the Add Note button in the Log Viewer window 2 Write

Download Pdf Manuals

Related Search

Related Contents

NovoLAB User`s Manual (Novo Tech Software Ltd)  Global Machinery Company SA146 User's Manual  KULINARISK Backofen  「GZ-HD320/HD300」（2009-1）  Operating Instructions Instrucciones de Uso Mode d`emploi  OPT3225 User Manual R1.5  真空管回路シミュレータを使って お宝“アンティーク・ラジオ”を復活！  

Copyright © All rights reserved. Failed to retrieve file