From e303cad342f128f5072c20702705903bc2a783e5 Mon Sep 17 00:00:00 2001
From: Jasmine Cha <chajasmine@google.com>
Date: Wed, 27 Oct 2021 14:40:00 +0800
Subject: [PATCH] audio: waves: add test file for unit test

Bug: 204272480
Test: atest audio_waves_halcontroller_tests

Signed-off-by: Jasmine Cha <chajasmine@google.com>
Change-Id: I7aa5205c7443692c95b96ac6537d404e0e15d165
---
 audio/oriole/audio-tables.mk                  |   6 ++
 .../oriole/tuning/waves/tests/test_config.ini |  58 ++++++++++++++++++
 .../oriole/tuning/waves/tests/test_preset.mps | Bin 0 -> 186955 bytes
 audio/raven/audio-tables.mk                   |   6 ++
 .../raven/tuning/waves/tests/test_config.ini  |  58 ++++++++++++++++++
 .../raven/tuning/waves/tests/test_preset.mps  | Bin 0 -> 186955 bytes
 audio/slider/audio-tables.mk                  |   6 ++
 .../slider/tuning/waves/tests/test_config.ini |  58 ++++++++++++++++++
 .../slider/tuning/waves/tests/test_preset.mps | Bin 0 -> 186955 bytes
 audio/whitefin/audio-tables.mk                |   6 ++
 .../tuning/waves/tests/test_config.ini        |  58 ++++++++++++++++++
 .../tuning/waves/tests/test_preset.mps        | Bin 0 -> 186955 bytes
 12 files changed, 256 insertions(+)
 create mode 100644 audio/oriole/tuning/waves/tests/test_config.ini
 create mode 100644 audio/oriole/tuning/waves/tests/test_preset.mps
 create mode 100644 audio/raven/tuning/waves/tests/test_config.ini
 create mode 100644 audio/raven/tuning/waves/tests/test_preset.mps
 create mode 100644 audio/slider/tuning/waves/tests/test_config.ini
 create mode 100644 audio/slider/tuning/waves/tests/test_preset.mps
 create mode 100644 audio/whitefin/tuning/waves/tests/test_config.ini
 create mode 100644 audio/whitefin/tuning/waves/tests/test_preset.mps

diff --git a/audio/oriole/audio-tables.mk b/audio/oriole/audio-tables.mk
index 6c3fc3a..52e4858 100644
--- a/audio/oriole/audio-tables.mk
+++ b/audio/oriole/audio-tables.mk
@@ -69,4 +69,10 @@ PRODUCT_COPY_FILES += \
 # Mixer Path Configuration for Audio Speaker Calibration Tool crus_sp_cal
 PRODUCT_COPY_FILES += \
     device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/cs35l41/crus_sp_cal_mixer_paths.xml:$(TARGET_COPY_OUT_VENDOR)/etc/crus_sp_cal_mixer_paths.xml
+
+# Waves ini/mps files for unit tests of halcontroller
+PRODUCT_COPY_FILES += \
+    device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/tuning/waves/tests/test_config.ini:$(TARGET_COPY_OUT_VENDOR)/etc/test_config.ini \
+    device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/tuning/waves/tests/test_preset.mps:$(TARGET_COPY_OUT_VENDOR)/etc/test_preset.mps
+
 endif
diff --git a/audio/oriole/tuning/waves/tests/test_config.ini b/audio/oriole/tuning/waves/tests/test_config.ini
new file mode 100644
index 0000000..ba12a8e
--- /dev/null
+++ b/audio/oriole/tuning/waves/tests/test_config.ini
@@ -0,0 +1,58 @@
+########################################################################################################
+# (Optional) The supported features list for platform vendors to query from.
+# Platform vendors should call maxxaudio_qdsp_is_feature_supported with a string to query from the list.
+# This config has no effect in the MaxxAudioQdspHalController. It's only meaningful for platform vendors.
+# Putting any value other than 1 would be equivalent to not supported.
+########################################################################################################
+[HAL_SUPPORTED_FEATURES]
+CUSTOM_ACTION_256=1
+
+########################################################################################################
+# This defined the options of supported sample rates.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_SUPPORTED_SAMPLE_RATES]
+SR_COMMON   = 48000
+
+########################################################################################################
+# (Optional) The subtypes that applies to different angles(0, 90, 180, 270). Can be empty if not applicable.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_ORIENTATION_SUBTYPES]
+OST_SPEAKER = 0:12,90:13,180:12,270:0|13
+
+########################################################################################################
+# This defines available preset configurations.
+# This should be configured by Waves only unless platform vendor is familiar with MPS structure.
+########################################################################################################
+[HAL_SUPPORTED_PRESETS]
+SPEAKER_MUSIC = OM:1,SM:2,OST:OST_SPEAKER
+SPEAKER_SAFE_MUSIC = OM:10,SM:2,OST:OST_SPEAKER
+SPEAKER_SAFE_CALL = OM:10,SM:2,OST:OST_SPEAKER
+HEADSET_MUSIC = OM:2,SM:2
+
+########################################################################################################
+# This defines available CONTROL configurations. Only define the CONTROL if you need it.
+# The numbers could vary from device to device.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_SUPPORTED_CONTROLS]
+SPEAKER_INSTANCE = INSTANCE:1,DEV:0,SR:SR_COMMON,PRESET:SPEAKER_MUSIC|SPEAKER_SAFE_MUSIC|SPEAKER_SAFE_CALL
+A2DP_INSTANCE = INSTANCE:2,DEV:0,SR:SR_COMMON,PRESET:HEADSET_MUSIC
+USB_HEADPHONE_INSTANCE = INSTANCE:4,DEV:0,SR:SR_COMMON,PRESET:HEADSET_MUSIC
+
+[COEFS_CONVERTER_SETTING]
+AlgFxPath=/vendor/lib/libAlgFx_HiFi3z.so
+AlgFxPath64=/vendor/lib64/libAlgFx_HiFi3z.so
+# do not modify the following if not necessary
+#AudioFormatType=0
+#AudioFormatChannels=2
+#AudioFormatSampleRate=48000
+#AudioFormatBitsPerSample=32
+#AudioFormatSampleSize=4
+#AudioFormatIncrement=8
+
+[CUSTOM_ACTION_256]
+CASE_1=PRIORITY:0,NUMBERS:2:0|1,PRESET:SPEAKER_MUSIC
+CASE_2=PRIORITY:1,NUMBERS:1|2|4194304:2|3|4,PRESET:SPEAKER_SAFE_CALL
+CASE_3=PRIORITY:2,NUMBERS:1|4194304:0|1,PRESET:SPEAKER_SAFE_MUSIC
diff --git a/audio/oriole/tuning/waves/tests/test_preset.mps b/audio/oriole/tuning/waves/tests/test_preset.mps
new file mode 100644
index 0000000000000000000000000000000000000000..bd08ee30a1ee969ddde614206486e06935e0a2d3
GIT binary patch
literal 186955
zcmeI537i$h)%MS@$OTabL8Echk&pn2D61ku9kvJwnn7>{Wd@i56k%A@fF|CkxV}bW
zK1Eb;Kqc;A68B}=B?}2ejERcbFh+!EOe=z0l<(B->3Yrp_sy^ji0|nicZUB|cirmh
z>h9{Qr=QcWr0)s+Uu!`75>Y`D`9TdEP{E!=d;9;(@-z7~*po5?%cfRNC?8W^P&jzf
z^zx~b$|e>Mt1K@&r+jLI7AFtu*S~mBdD+;?@slT&Pixq;-^BCEr%#?deSD)9H7gZQ
zm{dGq@|bfPH!GR&-SUaW{mvUZt;^ounKZm?^u+SwZ<dWIKe@7Nq2>XTFPPM<dAj+q
zvWoJttu)naRKD+KfAm{+kYYD%SJI_(@$m9<D<_ssFF$g4`LyZ9CzK2;KD@a9ppym`
zA5q-ps4kt4>d~cZzm*NB(O2n`wgnCRF3*sk1+?ejVWS3>O&U9>eBxOD*Np#>TM9JD
zx=3lLp%I`rHx5uTp7#hqv6D(qGw9CpzZw`(%}oQy*ER!mW;s6THbl)e>;;IO9K&?A
zB5nZ~9u)$*aLWMMvZz%6DO+m|(nQkSVs{{bs7S*>fNoq2Ao{w7b{g7ikVBV#PhURF
zL)YALNOZV|o9FsvrR#{*Vs`|fkUIgGj|31M<sr?Wvrg%vp=*GsoV$5gzRWNCaCZ-{
z&usm`@vm=iJ;G{IRYwDejscW#PXN)efDHEn5FMw0djpQ*J~dD^ckbG1=i!ZB7gx-$
z+Ta+g#jY=as2`w|`vZsu05UufK=e%w#{(*PkcXrW-l-mplnj3h5W8;!h=u?v`2+yb
ziGU1$2S8M!VQ7G5^Y|nW$&vfGdRR!I3=apy?qmSbDS#}W3LrWSkm1t-L}zFi5ujuW
zkMxj~piOk9hdU~JH+$vwefg}gnzVya0HRXBY%T*3jRs_R41h>3Hfi%GDi83;gIp1S
znn&XR86FRa-2?#9*?=lO2S79tkl}LyM3Xd31}x!90MQgchNl8zHw{2E9k7JY0}!1L
z$nXUKqVH;$0f=}efapR%hA#rd?t1{D?*k&f7(kQ-WcUXFqDvI;r2+O^&X)zC!f2L<
z7jtLhYIiwOVs{0A_)5SEz6wBewTCo=Yjn!B8g9^VBOrEj0z||3rU2Ozo*O`#<;{TN
z=oUby=vDynJPq>!tK4lKHg4Q_$OFf(byXhT-nenpb<ck07I;WbjCQ=RW*dL4a<?O8
zt-GTpg-D8Xrw4!bRQCSdEea_-DEdhND&o5UZTW6M?Ct>&-3!R@eSkiEKY;iFK<t(P
zh<*-;-9s841`s`>;n4uIr}AR~r~y9?AbLW>lNz1^#O`STQ8i!yM}VIEjE4>*uX}cV
z`<DDHQaVS^0f?Rl#O@aWqF-wGRe<PR{<VjS-13QA8dBtN{RR-b-vWr10b;itK=eC6
z3BM3v)eK${fV%OEfR54c0YonWV)q9C(H}Lu9AL=x{ECNk7hVl1vI{E#v3m_b^d~^<
z{tO`c3!sSq8X!A}|K=g-lr-g4A%!|duLFqw4v5_w0HS|rcr(EMvv{?KbQj(VDY6S|
z0I^#OApR#Hc5efS-T@TyzXD_@^1A`#DEu4HJ&FND?*U@>K7eSQh7SVVaXqj1knF;0
zw;`m+E_?`x-A5We*6;~{=u<!;|0h7<6#guL?84^(vYn%i0pv@iE1&VdWQkn?Kptx}
zGz3&}BM<3OXp9u1Jpj^m2go-9V%HQPU3WlF-ZOwSq~;!cXL4ri=Db%(p$^gB0HPLv
z*cAeZT58xQz@HazD-Y=|v<@j!3;Sx=Ps3LLvD+U&bO4|)e>H&Y!hs%gd+@+IR}@m{
z=;$B-(ZPV&9ReUK)^KQm@y~M`56Lbx=dXnn*@d=%*nJ&9^bJ7l+5w2#2ar;C2oRml
zhk2Ow_RvQUp4E{L4=LFmQO5xCrAKJ!q~S;pxjWzieWIguN@opSG<4O_9T2-70HUJ-
zU87?FL_IYetKmdI>`DMcLjkcH4j?)i(3ejE92}kMA-TP;bf+ODcBccR;~XHG$|C~M
zDmT(Yn!%Y!iQQQMqEP`#E4b7{1L;6lRP4iL9@0mi(P1??oyP#A;|#cp%RMAty4F=7
zCBx$Yu^SH{nh+pc#%BkhgZUf}(mbS%yzeF=C3fcmh$jWOXaP_5kd$C)b!AAACzdII
z*i8ixO$(5n%+oz28SKU9g%ru)d_e3j07%CfP{}g@L^A;yz7Rlkk%sRD$js;Odq_&~
zarMO^MM{tb#O?<G={N(jd?|qFGC+oB0f;Wwa76&Q#$V|nxzo0Zt_mqqf~x_sy9Pk?
zKY-bMEr95UfDB&;Aeyb=M*(hpkgxZUJo+||ejHMy1pf~ZyBh#RHv+174uI$;K!)c6
zh;G(!3t$P~3Lu&X$nbnX>}~@PRRNap0szrMK!$Gz5Z$5S&H#UTniqLU+QDPhKk?u@
zpd+u_;O+{m$=P@}fao4T#P<S-?gM1_egM$}3V3k}+5KMNB_3)9Al!o<(r2chrmOke
z`_BNxKL@PfhX6zmdq^{QM5iojC@IO(jTdWpNW;?_egly1v4&+DmTPzcK(s=`yG=p~
zh~_p`aI1!SfG#{A(35WioXk}oYL1*+5K^)gyfA?5?jj9$0ebS?0D0&F$U_$(cJ~Fy
zRz&v)kVEnSfM_v5p1=S^j{{=&goY<IJf-1j4b>VV4bNzJR>N}|p4adT4ZqazD-BBl
z^2h@y;ukcm(D0&$-)neD!yf>h_>X`hep$mS8eY|~Qp0N+UI)lS3LtiG0zPo70d4s$
zfINx-dPQpivHNELzL?+kkX*b!b?<}}X%zng5WlN{{vBY+!yE^oLVgdB;r9WtTNj|J
zj6Vn<m+18xHh4&i(<=JVLvlx7?LN}*8McYt=K**eZww&Cp=Odnx)cCn*8p$^Hv|-N
zBLGoj4SRS<y1E-&6Ax+GG9HprzvP<gZJKG=Q$uqN?KN}&l<;8yqQe0h?g$|2qM<9G
zlDh$jx&t!Y10W;Y8hQg}a~}Ya17w&1GBB;-c)$`K1Rxp=kb!A{j4Nvx3W)e50MRgj
zj4K1AcdKCppoB*Ph|UCL_$+{QPBoMRD!BqcG!7u6x&RrJ)i4<_n=1h_C<~B5S%7p6
zHOv4k;h6v#Qw7MFDnNR68ZHGyd>Mdf79hiy1Egc7;aWgz{vm+qIt@2^NKTB_JjX+F
zH*3i^VKwPW0i-Jhh}|t3Zq+bP!+ZeIZ5paHEYPq}!##l5-3w^MG2nD=EK{lJRfG1{
z&_Y9@hL#%k(a;JIyL|zJd4E9c4ge5+Rl|WAiZmRg;b0AiXeicjsD?HgzNVq0h9fj|
z0u1LP1IWGPD8ORw;^7_ty#978?&={olH9B<cMGe@U8cK+9vY6;a1216sx=&|p_hi^
zH1yWcM}yNKv$i<&eKqvc&|kv<KoJiFta8HvGVKMBX)g_@255T^pXMPMZjx!QkRt8z
z3_$Eg0Ek8cVs|Eh=qx}_9u+`FS4soO$Xr<f8JQa$K)!SgAa-K`GVP_IBEU`e@;DFa
z#KHKGBDqb_aJB+I2N1i70HSjPWC!vjz#yLN;W_`1^K4VDL`tt{N&xxN0%|y<(U9DK
z<oTnS{705X^6^J{$b?DdWim15Ik)hX0R`Ff2FSy>eAe`pzx9)?<oBAs1qD8{+^lKt
zcbZpY`P+ZXYx$7o{r%_W0}km=*?#?f23yMOz&hk5tJGd<@;Xlb>hny?RV@G4<&v?Q
zn#J#1%~G@NSV6sQA7Q<1lXU%P%mCu?0}7&v@>|zcx&rxIf%Bi`%Z60@Pr9$eH~9{k
z$g1@nz8?LudEVTY$bVL`{FV=Kn&+nbJYN!Zxi{HoC&@0|cGEU-+a}vK63#7ZKRb+E
z?EL4s^;fzny}uRm+O!;1vSGe*T-f?u=Rf(%v2c@Zw^R;UCATj!zwPTe<h5xX%j8Y1
za-?;f9z(SC%rmm4d`LblpVDX2^7+P6AfL2dl?v#6Yba^CMe50)H_{X4<n!ZjoHi|&
z^sH;;k(O)IV=p}kSM%v3V+%4LCyRW)FVCiRF1PAhd2Vv-bDQSdR_^R|-nLV5gIw0%
zm7g*&F{otJ3Fl3lFvjQat0h@#>L>wO5h+q#06De*se}}|X#o<EoPKFa?te9K<x6=5
zNJKSz<Vz5{<~oDDH0-UR1)!DyNoFxZ%Ksujl8KA3ntZKX%uwng4F>_baWSBd0;EFj
zfNeMtAo>0D%i%sH>44S}Aj#waw%MTqBq~V+NXhrhQx?8Qp0WTkQ=s7(z%~hxs5dew
z4FaTGA>`7KR=hl>0f_o)=m*$Q0;IGK1|#cQ0wkhuBV~sQkSLo7kkS(56ClYviY~z^
zfbA6^(d<Nkl$PL3WGzpc0GUV8Pzu;y0TNYd0g^nbBI{ZLB<YDEWtRw$WFAGAU^-xD
z36O}shcDfs0wh|Y1xWI=?Y}1-%D!BG=@km<Pk=-;2j4ST36N;879hz(IaaHq0BJBw
zhbz6*)CiE0<{!H%q;%s28WsYGZU@9#fJAhsPdO<!$X3XUuv%L!KsrSUkZziz1xPZ#
zfo<e@Kfv>IlmKb|?Rf=AMEL|rL=T1BWOpCd@Q4NokmM$j6CfqyB%ip)^=eN5V)rC~
z=qW&c0a77HVKsTQdnSO~_@4z3J*VM$4ZqOvOAWsQl-8dBsZa@!WEYeGDR$C_O`8}|
zJ^>QZAM|Q})bKK(vi<}}g<B9HrRTyblz`}U4S(10hK7G=coUG_76B4%y#Q&D79hn=
z36P{iiQ?1}AQ9C?fFw7{^*)32T-cy<%O^l0+G+ukG^EdvwagR%h&F2Q{rKcq$xnIC
z2Q<*o5KxZ-q{1x-kkW><7fK-Se`si-p-@9h4f_C=)J=dCyZx{Y(N_TZ1xSTk5Fn+y
zpae)n`2<KrbrB#@qy<QyxUZpX+bckl=_3e`q#+%KtYZfOlI+yh2#}IGke3{gTWjtN
zkeM6}TQ5K=u0H`%Au9nAYXK6`slL?dLzfaD5h(#u>>xnOUZe#`GK8r!Py!?w!qgQ4
z0g~KLOLa;aAj6{pGK8rC0;I}0i2x}*Bo$b#mH>$;j{u2EwE&4ICqPPa%diq4$q**8
z)&itUsuBTGT7pWfR!e|HG!-dYfJBvv04dENp8$#I0-eDQ6d=h%S5APGmLQ)1iRcHq
z1eXA|SAZn<lAHi3EkQm35>b5#kmRB3dh8ETJ^>QZt`;E4teGxo6<~V>NOB=wgxrX7
z0;J@SWLOE1i0VmzBnq8GfRwg_d;%nSTT&I&1W058BtJfyPk<!POi+}>&ICwAN`Mq=
z0TNL@0TR)F5g?@}tr8#+X#o=D5g^g&T7X1afF$oi;K<3l5CQlFEkGht0;JgG1W0Ld
z>LfrSQUavObrT@TdksNwz>Bv^fRvVPa{*GSMlt~skqMB9{*MWek`p772$0gVq)q}P
zA|*f~QUWB=a)<L&vfMcWB#|9z`NGZ-Aj#`P`b$lKByItykl5|^0wkIC!v5qHAW1(y
zCqPO^=60k2sW7hqDRvMb$!V5PfFue{y$g8+NU{q#0aCgP`2<L@(*h)_ivUT+gf<r-
zC6}7mL4YKGsU<*aw_oE1eyyJtc)dW2oVkkkR;iH<$Y0fPqXwlEXdNk~K#f&NZV&g%
zZ&lKZCEuE?`~65O1!B?hrYTe`qPGCGtV-IlQVP^ql_Y~ajq_TSw6AxolH|Z{sQ$Vx
zbvr=p+5@ywp!A%&DFy1!sw8`<RthvqtV)s^U0;t@B}ys4Qxl~?qE>IgIi)}XA38?8
z?O>$<AD?EOEq*SsDoMU{-zcXPSYBh6@~w0=f4<b0QlRSmL@AIq<(yI=={<kqM5vUW
zjrC_$a?kDBs-$URRg%1~^>?>ZlmgMUiBce~gK>Vh6V2xPZoIC8`cewq@N8mLlC*<8
zd5Ztiq#dkwqR7Nis4u0!K93|;B}pALjV{EO)~8hoT^hcJ=Os#kqy$UdET59V%5AqQ
zNh|T1@I7)eU8~_n4G;%pzpcapJY0(d^1G9Kqn0}f%|q75B;tVNt?f4wcalLlW2W_q
zI3R(hi8vr}%s47>CrRv^UQ66b5*7KD+)1_|4(Or90bP|ifR57QfK}R^M2iFDjimdq
z3vKg?19qr8N%oX2hy&*2Otc=W-cE5qYb6elI>?CwHh9hS`qr$(0f%p=J4xmFTM!2%
zP5D6n4QiC=w;GlK^1G90aR42chy#)q(n`CN9JQV9B(v{M!~w60<4v<y*13G{Bt);F
z)Z5@rLVXi=lGIdU6>{qm<r4?g&7I`e3lecalJ#HRTgbYWJBf_Q>6AK&1B$deNsTxl
zd8ea^b|-0**PX<~0lrtW2c{pk#ht{&0lpG<dvQSQI-wm99qFMw_hi#qyOYFjM~VY_
zY=byJUd+@59jZaOlW1{3bY|Ve0kzyo3K`-6dB;P!lhjolzz_$NPD{iAsT)B~9FUHW
zD{(-6caoCr6bED{B;tVdIV&d)$a#W|{4l>e2~9%vmTspwU`35MAh`#B>~i9O<a%AO
zbKFVpx?H=HG>vlNfb=;li#^@J?j(Fg$a>Z2L>!O|8SKG1aX|X4xl`Op-ukH)2Q<>|
zB>V3icalawO591(=d7GNN&1YjQ`|`wEzs^Ht)iSbz}pHod!?Zk2h^K837vI!A`a-5
ztAsZacar2>c+1JK9G*3|MjVhnXFY-p#HIsAA=~CoQp<Lvmea`An~QYZ73LzR)YV*M
z_w*A{79xGLg-9P(79xFES%~yuWg*gsm1{^J?HbaDI~6y}4HVbBSSIGyJLJW({La?3
zUM$P+Y+Y-(cw3yUTdU#Xs6;zkcdGZ{V&7d9g-71uVsV|*k3t;)H7}MW7tUSbY%L~h
z-F$J9Zp=<|wpPQ%RF(`EC-;k`E;n49z<c#LTufoOm_*|^$k##grF(I1xHvhcwO%Z%
zKWFRv<|o6&$x-;vE^xLMleLkkgI(cl{pxPxY+ZjZmVKpKJ6nI`a>K<*cXorj2$zle
zd$BBawyt@o_)<Gt)8;RhC8L&WlCk5&_hC!U*2$Hk#@Ram*m1Jjp8CbIUV7|UzgSi|
zO^+SteX*?e*zuRZ*;>C?M!VkGdRxYh>*#F#jqMyeu1{y{<G1i)S#k-e<!pWEc8(o?
z37oCttM!XzyTaL;I-0Y!Ia~V&jxV#bb?kcTF^^+4oCw$!XX{!omTiNxHO;8o*l}KG
zYw=ypy;zov8P+&krz5v@89Pp2EK52VORFnTA+=sC%j;}iTH|b8^WeGl&eo6Kpq;JP
zx_mE|<#o1BUo1=NVDDYvY`tceJ6p$<=4?%MbhfU)7t2y->*QSc)aAyGx8Q7DZ!eYw
zXX~T{>#Fm;SZ2=F;>>8y)^g)FXX_%~9i6Sk<08Bywk^)q*&XX_Z7-JjVP12#HfL+!
z4ldCzV(nCCYya&sx|_UMmg^C(K6<xww%#Q#mYK7)9}D<D?`-|+yLWqM>&zF<+4|!)
z5)8YLXheeod9f^0GI{Fssbv$yOHofoiJ~Btw@A2c4V%AF=C>pZex0j^cDkzaNdzqT
zwRl+t?^z3eoqJ`&f?vy9q!#>It|B|>jWP><Eg>v#^Ve$&evNxQyk{-=wVaFjUoWep
zM8JYy)0aRZV8O3*=R#9VN?P!1-`_tN6=K1!eT8hj_w2R>zgBOQS-fk1o62K1E3*q{
zqm5d;>$!6+-u1F&7VmoQT#I*262s5pUGM04*A|1>Vlc~axW!-=OFfIhY%!R9=XB>-
zpw^1PEXIS{_R(T66Lms`SPW+Wuxc@wCG2i!6c&Sdi}9Q-1~ZY^TZ&XbuH<3>>ld->
z%gF=MIM|JIf0cDMi|@>REe5kxj*0~>B=5tMvlz^1PjaiS)t+*G7P&UHdCc+S<nOvI
zZcPm4PrUS{*h^o0=1qr`O&U9GOj%{QCrp9u0_{uRyl%=wo4YCd;t~}pdkm@-ce%?>
zvd5@n++`wVk73#u)4oXKT{cg<DVz4iv@f}9nrUC;X&Kha(J*DLoGq!FwQ{Fg*2=7`
zm1zrcmreVE8^38^<id=ekZE5eOsm;rnD#|(O|diW%h6H3xXY$}@x2$*z7Q!l<r+r}
zd73V*sHkzoc%vp_OI;i>=&Hm`Id$gRYDWyyzR10NmpfvJ4Ph?Sa^i&0Cd#=fC!PHa
z?-V!X8y`&EloKmP)4rJY#Wz3GzW7?WH+UCF7w5hJ*^0W_F)s<*NN%QmG3|?KU;KGx
z+7}WVsF~V+;X;4}N(1almxjcutaakjkaRR#?v^eMrhV~eUB@715I91EX<vx?>k2XL
zi)mkK&AE%OL$WBXf@xn&`;s(@nFB6t{jT#LFTU{liy`vSI*f(Fekvu^1Z}B3NwR5Q
zHmSFrrG2@wZI_(tWrqALpq3IQ<~x&ymyMoSKI)rgW6Dpilwv6jj2v0ai^&!MGlL;I
z2o=(eivcEx@vZ1sR7i$<0f<Dq6&e!v2ACO)31Xz-JhI!wi-}!*g%_8RgPAxn%nZg)
zy_z6K25QkLYQ-A=62yxcpks~i`gk$1+xl4JW(MQW(>KsYiT<JC%>ZTwBR9I(eG)1}
z@KZn`|0jUVoPHKS=BqvrknL>oVk}-vt|7I9yNAT243Hhf9RftB^I;xly**SS&voR(
zLrS(s)G>hMcZ7z`V~yuV$PehFV~rE-$XMgsW(Jcl*0?#t_)CpB!w_Ah+x7PXm^y~Y
z)G<V9yqIJL(41jR9V7QbS$3>CX7`L-zElf*R2cIj9mc#!hcPeGVa$tk81o{23Aq*N
znC6{yO!FdsS+DkrhF3N0j`3oMwl7{x)sBr96T8ntjq*6&7=Q|yv`C`>5W5C|Gq@q3
zkQ)Ica)gFGJS2jP4X%lYBn<Lum+_G3Ltk=D^)}5k?5Ux-hV~jd0L+EQlt}(MZb~Ho
zAYd*$^3uH4z#OFEU=4?8DAsVOhBg|$roog*M16II^wVHUB%*R%A?Cs(SLy#vIbupA
zQzH30Igu%md@V@NTKdd5XYx5P$%uxl`Sg+ZpPusDrV6f2opg4V66xbMqC~O)RJlVT
z-Liedw2r`m0O_n~FwGIsF{qFd?g=o>k#9^VqCztK9e})%qhV+OGvP7KQSK^anj>Eg
zH--~KF2treGR=|9ZAZ_cQ4l>3h}|y$M8DMVs{qlt{A&-%u;(XkX-JXw_8Wj{jz|;>
zfAbZRi~~32Rj3^^;UP2OkrT#Dc!<n|M;gKxKyzdPs4_e*2x;WhG?|gfjQpuN8;yeK
zM*&P`WHKY)JVeL*P{Z8NWdas}YDdeA%!J2Gc+7;yUtP?E$D}X59hmgR*Mdo3h<a+#
z#jzTCX*f<pZw-AkI1LiPBfQ&g(idrOV^ATn8w)V$i(HXv0x9`vdp(W6CDRm>zL@mI
zU%yTIlGMWPEPeUJOJ9mD09A4%P5ZKJ**@Ie-vVBr+4_OwU*F(*VAd;kM*~dz;+u?k
zj-`F9N<IN#+819tqfsFl9s?j6tD!uA`Rz!pnfArE9n-$V?w)XBNQIc+j%i<L$o2e+
zZxpF~=T+T8Rsv%88i43efY|*RATvOKBK~Ut)4up?5UmRpBJe=~)4oV`nD)iAFa8`c
z?aSP`E8UqvS0E?GSpW+_<y*+KP$AjLJl#WLY_b=h7g8w0=L2GQ0f6YcfJ&YLkRd2Q
zhA#w|_QhAcX<vx$(2e5G0A{fx?ZdP$z9VxFJVs3WLgKUX9x5cm?*n4DE`Zs-_zNtV
z?MsHg1%n&W`DhplFzt(JU;GJU+8197rhPH(i$51eXc@{#K<v&05S<0+$)f_uFkNW?
z>CBY{5JTqC0i?Z|_J#UMefK3=)3-ok$;iLW0tT7(W##~XZAupzWOn|ueA$p{|4D5+
zhRX`R{!-1*Jo&%Y4EcKWOF=Yo0IA?zL@f31KdV@N%ZE74b5rY&`I4yfY#^L0xiaR0
zHl^Ec8u;lpSy6AhB@I)Dk&B)GJh%QzH>LNtLJ+A<%TcvSUb-9>fNJ-)eYvu2*WBT>
z08~+{Ft;K1q}CeD48{a8%a*-UJs6Eb9{2#U`!>J?G5#J^iVB&{WdIYz_}V!i6_Vi#
z05Zt0VFthiF}~hR5MzRv_3c~ovp6wK5MzQEe`$!_+h`O-?*Iz<Ujecc`P~3ASnzK^
z_b3Jsy$6Wh`v4Qf__}TqrVyp-GXN9Bm>|ZVjb8*oj0K=t>nd<+nlp@CsZ1Rsb#NUT
zg{fowwaU~nM2ocl%VG`Y3{$V_7z;pU0jT^%$O2GV04m=@VaSDuzNz7Oz!Dw=AQ}uX
zC6ceisi+VcQ`Im7U;(K7qr3&6G9{9~|CkGpDUrP2_hc`bdTxFDk=H%jlq-XND%&fX
z5<r?u0W}=bXj9dRSDE}b)rnUh$!h)N+9SVBi6nI)@4Jr?mC*PBo2!L#sktAfL?Wt^
zn$Ydblt{HzXuGouPp9Isxx@Kg`6&ZbgNKbe;k;=R#4#f|<o<VVXZ`U{7FiL{P=j2D
z(v;pTQoI@{8P9tJkUW|Iy0ffPv)YJiZW=&(NMZ|?=GIvZ<pRiy4;uCY#BOguYi<!B
zDv2b<R+?KUZW$n3R(}Gdxcckidt|rUX=tyZ1AzH34@uyML!!eyBrhzkbRDr;?2Z5w
zawh=ukpQBjJfs<P)+t>ybPZ5i!QDJafHYZlngEG<hZ0a3_wkUFdZ`n^WeV>(#%dB&
zQ$s&MDfb5uiLx|3^cfxqkmo!N#{(*Pkcae5(VZ_qx^F(8<V%noh5u9!L)kJcBG`0)
zVs|ot=oCPfPX!R22FUQ~0HQNAj0jLTg-3cw>Yz<@riVK!dpCRK_I>%Ru$r8wqX0Wp
zfb{BvT!E~cN8<n)9uJ7!1OU<5fGR!*Kr|7M;d22*lQc{QEa6H3(G-9@>jLC0V-3>*
zOZYs%HVBZuQq41w!AI^w4@s!-4elbO5PeU>_W==K3?Rw^GW-Jo(IpD_(g6D{=gT}K
zSELrvEDtaCy0~I~)oOQnSWVi&6#(KZ0W0__0MXSR(hRQADc5SaLBmcGAdyJF(=%(8
z6D@a!Huw(t`Zcb~L()C}%q{ScoEYtRAz-b$-NQRW{SjL0?(mQ-vAYwi?a7Of(kuE2
z;1s?qK;<;PJAmYJ4<L5;0y2Cbpby^<AbtQ4yCndkp95m|kcNi=5)n?rqXA}5<;Mb0
z1AZJp^n`{dH9Q4~-O~V~YCs`JfS&w}hYtQA>>2?Q(Qi>4qGf>CEe8<&4p71`1XwkL
zR|F90%Zq?-M85|Ry#$Ee9{@yu)bMhE`gG(uzHW{@heof5;z%3)J0Ny%0Eqsf;mrX1
z&*Ie{Qd6O~LW<<J1`xZo0OEfFcDVp4zM9wj;v~DU+HFADh&}|w?jsE!Yxo2}^eLc_
z{}VuN$e#s}hV(h0W3&+<6^DuD*vT75=|zaBfrf^FDsJQ<JqnGHLbM0K1W10Q=0IN|
zVo)hAmFrv)YR95cNz<#pXjHN5iMo~`w;E0a#BS>aNX(}ogM*_}JtVjHmF_g8#O`!}
zbesV*cm#lGq=z(vy4dq%E4b8elbnG2aG8hPJ#XZPZZxuv-57vaSq7+_!{r{5FI`%_
z)dHl_GCtd9Q1jr)=Xgjun(w=b;d`W;cP@Z<Qh-Nq;K?4660CKVAw}kerT}6$6`<{T
zs4}tVN$OzlU0~0%W<Gx(yYO-K#VBZovw+zB03aP_K$b5B5M2hy@GJn)<r=OC5Lfb*
z9+IQbCb}x5NF`nkh}|^+qW=NR=4$~&KLmW)1V}`;VdrFw60n390EiX>GJHGWzY36&
zqwuNwiQmR|Ku2D;!QG`ZxLd<LfQat}5ZwpJ@cjUy2Ndw)6terhz)L(NC0JMepojFC
z>8I&xej4#-0OFqmR`5drqK7@C89bs>On^jmS8$f0o_sf8Ckc?UgZYW@r2<cCcuK?5
z8mcu!8lKVctcK?_Jg?yw8h)waR~nWEkbC{_07d+Qh7}rK)bM)^FKPG#pcDTQP{c25
zctyjj8dhp}O~V&A3|Q>8Pk@vy;}5W>8D6hpgNNiAQpYf0M4yKYcrtGcAkIt#35Psl
zXlM|C7jwe^vP~mE?uBhUitM3Nns`Wh8>?MLLsPw4GYxxcFe@YzAju=}mqvi(pQQZ$
z%<+vp*CSqiG~a|4pW(RxqMHG+yG6sT8s=%(IRYd(>$QAgZw)Op6l!RxVIK{x01`0+
zFqroT#O?q9(N{GbsKKm|zRUuoU*FBA`J?TliOg&*(_Z?}p8@y+3y?DR@;F~mKkZi8
z`*SxQr6!u7;cNwb4j^_D0Yv8p$PVO5fI171Iu(~U@Yg2O3rHpGSi=(23;2e0EQYc(
z+zUW-oQB>2(+iO41&B;9KxBFWe+k)Hh9#yKkUOC11&Drwn~~`S{2b}ue1#+<Pfd9h
zYRB{fWO@O)K$~HS8J74Pwdn<X9hhFg^a8#em|lSBCQMGtAU8k;xi#DZSi-jgh~@z@
zJRe|s0n-ckldLD-hFQ&%xynN#T6)Ya2q~h-S{OjKTBO1B0)yG~0w1{5XcTSvEr3Xu
z0llKNfY|*r0AI{+dq`zQ?}QZT9{&qK{4T)s0{$E}y?_~($e;p`$Aq@L#HC>}U^Z6*
z<RvbE=>>e3!1My97x3+%N0<#3I9kIo0MiTjs`|o)PWmG11)4RWLa!Gn@b4v+OrAP@
zYS{#NMHYj?<}cve)PcG}iZmPq=*GnW(+l`kWO@Oj6VWI#{2hRV#MCe}fawKHFW^re
z(+l`oFuj1(f%yyUk^m>B7cjj*?ixhv!rfW;g8-%%km@kKfawL2v!t`0(d(k2tA_3X
z8QB0xH3GUu#{kS<z@KL3FA%#6&?scw0#L~_07NqZbqjD}{sPj|evq&C^_CdhHIII*
zEAjsUVs`^THUm`g9DwNs{8iEX1!DICVy6(T(C}^(X>aK=7gMQ3w`!ON=)&^>rWYXb
zBrt!0A~t^k^B3^fk@lEDCh7nv;llt#hXXR)5kS;MLsvj0cLNZ02V}ShK;DGY&>JwD
z`v8c<LOH$inO;C1s7)^*t@lRVD9m4g$ovHsa~D6upZM0c;;tTYFPt}P%iS>dAG_`v
zOfO*m0)EI~$NCE#SuA>i;>2HosOgZhNn@vtDXT2^H{SGSW`Y3|40uzI4Xy_og=m%l
zM8^P1xF^5_1O7}h!2r={G>Qz50f?`v2D$RoTzAZ1zyt&S<dNmZ&?w{vI43|fjBg5%
zE#bKVWVM?C#nCN*PSLFZ;&}?pU_k243<k_#fXD(8_&(qJ`r=@M0SicA0SS^D@{xW{
zF!vhg0ezyQ^aP;^2Fze!?p!k%@aKsc447cRw*wOlm|(znCzn9xK=gP33rHa6ND*5=
zf`>T{jY8b~-vea$eL(Ei1+ahw{sK!DkiY^G$g{cyB#^s|84Q@gfbVUXV88?ez8&mX
z!9atr6*M3w8j%Z2(DJ16^UJ4BD=*F?9FUcuB50_g5ui6W4p1_l_Xr?`ZvyDfl2uJ^
zBdWP+0J;A+1N7xR0n#(juoob9djpEN1z>n2{t0QRyKu_@*|Mlr04ZB*4f|@?dUFAy
zuOkDZb{g7i=m6-;hj~a0tqzF}_mEhtt#lo+TI`Mh6mlm3^N|3eqdcS;bk-?dG;|FR
zm2)=_$=e0{aCZ+rP;32a1y}_mIEwq!6sJl?ovNLOH*(?9H#ljf>0yjrUjR`*Kq>bJ
z5Dfricp!l2n;MP>RPrDXNgcdXJs2s{B?H9n+W?{=fJ#0Aunk&)W%KwXpFwiuKCT{y
z+%h~I5WABBM5h3<d@6wGG=M~L0Z0s14I=`SOyQ9pk`lCu&h&6crH`VrFP{}wlT&6C
zfT$EOo67*(pcQ!JL9Rds&7*Muk)Z-&HvvF&HlT{n0T4|DWcXZw_+Dw43|PXI0P(#7
zNVgOayJ-NT>3}7C9)Re4K!z^>h*nF(3_!#)0Yn!9GJFvrcHaXKeIF3<#Q>r#Aj3ZZ
zNDNj5d})CFmh)u+s4$x4Aq|6hIZ|SG1%UWUzzV(!Ky<Z-G=pn&%C#D9(6E!V0z4mI
zy2{<=VdKV)hdglnT36-a?Ts5pUH9x~Zh?p7#AwG0Yqs&%Dt9|l*19`tQpn%2@AQzy
zAX*escu@3{05V{57oaWQ4UjmR0HS*V8NLtDhwldvKLC)CDge>X0kL~X!>-l}4B!aG
z>B-M{=#UHKyi3dlV)t7VhiDlfcFO@0$rDh*F9cXMgI5HQnDZ|JI!3<-5WNJ5-5&r%
zf7I}DfFalOD<0CA^RI>!X>lt7v3m_b^d~^<{tO`c3!sSq8sL8kM$j>OJ**~Q`gcI=
z-T)B&L&KW^_MgS8J*2zvR!EWD)&OF+7C`(@K<wTI5WNE^<bMUoPULq3$Wiz=pnDVp
zh~5L#O)GH6^}OD1lkCE3w*eUteF%u%M;boX@CktEQ$QjACqUs8{w#p(!sh|9ouiEb
zq~5$qnExe9><R!xVjz~L5H$o;aU&1uQD}@5qCEhn6)>$p(yn%aRzPeM(Go?1tl>mJ
z?1pL>4j?)i(3ejE92}kMA$?3b4JolZ9Uy(>0MS$)5r9^?t&TrXTEV40g9g%PuBh0D
z%RHn{IirzvUOxf4ip%|KNvYSm3T%_%ae&y32S~)j05Z*Rb^tn<&+(8%5PsiHL`v+=
z1rSdPaM1#u>>(+^((1~PBBQob0I{12Aet5+JDI0@NHW-q&kHG%!TEst^ApI-=kKEg
zA6H+DFU@ck5W61$q^}If@}+=nkO#<R{Ysxf^2FaJx(c~v_-a7xt^pAJ4`4Q53n2O-
zAj8)Ih-Pc}QGngYPat-;g;L9Ps0y%z7XXMB0y2C%fanelcLw;&)4a$-(h?u5{)va{
zo?YL5<aHa|U12r3pWY1+!!JO@_X4&<9#Avp;2!k3rH@HJMb@$V8G!ibfED}@faqZl
zX$Ftzltp;8zZ);s@Q{Y5HT(u3Jz@>ZG%VL(egd1w16~hPywZCA4v5{GfL-E=PxS9l
zf+gE9WnERqAA}6#;=NwO1`o;gtyT1)hcr(8M;boEHnICW0FUF10b~YU#)Z*`Eda!>
z0pJX72q@%60EwopVGj>UzjuS%+!H@3^-Hd)-lmy`JvG>rwM|*elh~JL$~rkQT669l
z_vGH#l5awbm+(RW2`>crf=yYU&W-hZ*LwqqT4*TL&{BiF<8JS`lRW7SN28G07l6#Z
zXgD=M+k5yl4}J=5W^0*!2`SPGI0Ntn_Qb#GULNNQnvP$ON2%qBQp4E__#D8Fp0X~W
zhC><+kqRu3Puxs?$kIqYzHcyO!ld#tnV<2TTX@QVg6w$%#BfeNYx>IH`pH)Edre;%
zAIs&jX<m(GrT>=K@*&Op`_Ih>9MYe%{rdZi<e#4itW~Z9>yVeMQhTY%>p1zV&okY}
zV)?%=my93OEPmf=mYQwH3hHh92<vT|r0Yjx1`v-QP!LU&-@2~S70CCIoc}CeHl*5r
ze8xU+nT)LU9rJ|scldhr%jS7=Un2im#qwJ|#A%+J?z2qG)XH;{eRh)U(rq`bdzr<l
zwQVEe+@kig!^p+Xf1X=^rJK_GTOqGa%TXm8>V4DYxUluR&VTZiW8o&-ZmAryN^W0d
zn$_2H$ZOL&mN|r4<w)x|J%(uOnP+58`H*~AKBdp3<@1fDKt5@^DizTC)=<)Ni`0`p
zZ=@&8$>+!6IBi-k=~>sxBQ4ja$6k68uIAH6o_C+heUE&<FVCiRF1PAhdFnb(3MfDG
zY%6#6I&XWlH_hPGG~>T%U}`EWDS#Bo*Icqly#eGPr;uL|BeA%!T7E%HELKz@x6a!j
zh-s|^F;R&Y#B|z8f*6ao;oHcuIE)$Y1<1Aiw7C%VMoL*Ch)Fu&OPyRJ(vhn79Ah=2
zz8d-gc9b9{DZySm7+LQmL5xM)uxK0p<gsWQz81_pL+aojT!dnGFW}22h$;MH31TeT
zhDF=RU4tyzhD--G(GzPKfJNJ|XdB5{(ix3HY>PEmw2j!Er7L7q0Erzh0}|=XT#Y&=
zCjuS$p&K1mlM`?ZKwRenRL;@rn5ESfAw{NV>Y|P*tx?A$Gk}L|y*lR68?-vc%rpGi
zaG5>|vj9YwYq%mnTxseUTEe%63Xw{j2gvYz08xFbW0G^>Q<qO2LsZ}Dn4|>js!bgu
z?EtC>i?-ndY*dE|v1l7|ov>&dGA6LSN+cqsM4DVTC6egugAjrjZ<P|s-z5FAxe_Ur
zOqmi%j4VU-%Dr(AfM_tllt{k$Pep~u+?IwJfF(Q=ATJpL<RwFZ=$<uP3W)eJ0MRT!
zhA#(*Y+1v#fY$s&0MT_CEZPQ<DUmMbqk@`5E~*x7V;hu6zc%v>5j^a0^NcPz;eeTE
zn0bboXGq`G%rnT$Go&4uc?OwzhM8yh$9Y*E4FZMPQ~9v~)PNrc5Iv#cNe!ZsOvPcb
zdm2Dg4KVWz-@!BU3^UIlc~$T~;lwcWjNC=2rJgO?C%~T<a4QeV>t3I@)*(f<+E>GV
z8omOE-TnZg0|0&bs{zDF=0Fd*7hxV)=ZZoK9UUD6AUYTjyF&m(#TpI`F#dUN<009F
z=KQsgBD>HQ5WBAfh`s@cT|0n8C=MW{?hqh4oe%Rc>+PX3BHNJ<4=LFmQO5xCrAKJ!
zq`}NH%shk4JVVYAGtUqg3!bAd4mSbh?OK4mU8~_1Kpo`)W}e}@hGw48lWz<2<a9Du
zc}U*tc+4#bDI&mH7(mX{MH=n`^yIq%Vp0eYlR`l3?hBBui0%&{hvWeO(PDs^XGr&z
z%{+ss1EvE@_%Hy`;eZTx1c=g7Lsvj0cLNZ02V}ShKwieu&>JwD`vByHO+bbjAm+jv
zY|5HwGAd*?R|3RX7x3kovQ8dF%sfNx9%SYjHf3$*8L!-4+52;6<{3Fd0W;4q^9+A$
z@a7U`o{_VqlP58l*X&N_8SSZ{fj95)AELd!Gj&4wr0HeTCrq9+sxy^fs3Lalsac)Z
z>{917yVh~dA;n`GP+@BF@r{zfrwtrZd{VdKVI>3metY0a!}@-6VDSlqPb==(rTCjC
z4;fNCWZ)?Sy`fC*!1&*}T}-FpMCYqh%=v@pAXG><E(VzMhi^OP{ILz8aLoC`oIm`@
zW6mGG7R>oW>cE^oc1b84bN(>rkK8rLoIhmRstF!zq@N2g=MQuKNX`;-{vg`wxH#tg
zA&sXpiHnoWAnm;i;^M5?<#BP$`9s=49i=_y{9)1_f6Lijr9F=a(T^B+JfY!94Nqx!
zT7x-%6!EK}Ld^L?&INP+@K=QP5Z0KC%2&uxR7k`p0f>eHB*Z#EVsvO20Vv^-0HQMi
z89oajwsacG0hL?<AQ}gd0OtUSPp;wrn2gFFHGewiVi4te#H)|qEn^VL6mM{_kUg>(
zMDmV|u8>ZE;e2EOHs=rT<ux!=$hO2FGUpFD<94+3M@~&pY-)m_j<7f)(#og{WDi7L
z1C&;9HxEgG*L}FV2MGu!FGFr{J;G|zN{<E*9Rn!go&Zx5__{t36_Vla0EkL73=Lpv
z0#g(ChGS|1Ukj!tkUB6mfvE}nx$tthNesE3U-6L4zkK3e4JoqPN<i#h0}%ZQ5W7DE
zi2edNp8py^oCW^oA#t^C%Bw;O9U8q3kYM3}*u4QD`iF)$1MEMGS9?fz;jNG&yRZfj
zyR`t~e*$9nHh}0IKq3DtKz1U(8-Tj;zX9E&7(nzMAa?Hq$kYU;CJ-wC^9GSKlXihO
zNbGt-y&{hl8cqbnP6_#CAXTRf2N0bMU_J$KaCEAN<X!WX?lh#t?sR~Rw*qGH2!N>x
z=FYV^BK|C~I3h&#W)xy-0#g(Clg!ivKB!0(rqu<W(eSK>=QKR8;TIZyso_@|mIjcj
z{~e%+U(m2Z!;2bzui+&Pe*kpiKLU#QWeu-rFf~CLe}D=xHG#h(n3_PwmGxA-sR@WI
zj!5k0p;5$cK0vxs8mcrb(6CU$Jpc)83~0nLz|;i(iqsLa;-)6>71B>vNPi6j0H!9O
z%)LC$S4i(>Uldc8oSJ}5O&|v)Sximf>%r6n;-sf%3yufWL>fs(6!+r6NRi-gfY^N-
zAO<UdN<IN#Y69QhMx#P9JO&^tRt@C=UVV@&0#Ng496(g8fY?m{5S<OE;&T8*69E}M
z7a%fN4U++Nj5I<t4cib+2Q1<907T~lGJF9*F3uWe1TZy$Z#t$XkUB6mfvE}nxnODn
zQxlK~B0di{3F;Va1V|IX%x3Hg0Aeeqp&_7(8+k}I9gUGfv<JYv2~17kFF~dz@O5Bn
z0^&*G;_&DVJlR9?%w%c;-$G1HU}^&24(<zQiM(!jKY-`~1-v+g?0zrs5)X-fb6xd=
z9$xHqamD<q)$XV1YNjUem1}AOQxo`hP{b=StzN{hX?PtVl4n5d-UNK$Rs-7dTL2L@
z1A0Yk0kQjM0C}JEZ4b#w`>A^;q=*dnUjX8F0kQjcfF%!e96+KBz6Z$g`+(T33y?K6
zfj{`o_57u&2~17k8^w2ZqcAmrsR?|eI1sbda?j9kkcNXb9HOCE!=W15X!x22Qxg#N
z)fHlDg4m7K6;iIDBET0>O;B!;4k8KlU}^%?fvE}nt;N&?GAODW#fShBCVixbWOT4i
zbf$+pD!oW*Up_0WCJ#!Z07RvL*<1!NHGyw$rY0b|+Bb@HWb7K<Lax<tgN7Rcv6~Yh
z8pbyT$d>Tj0MaaP1{6oP06Imt0*L1+p!tAR?lun_+K;^M+4XB&m51lnd-}{R@Q|Ds
z?RX(zt-IaBJ3b!#+iTq&9+D+?cVe|Yc@a{2MLz+Y!gmFzoW^$tkX%enU}^&2m`qJz
zY64ReB$w5F!o<p-7jP>NsUV_tNRc)7)v%w2uK;4VKY-`}Kwti90P`lu)x3EVn3_Nu
zf~g6l5-tfB2g>rL08<nAONDt8n3}-L9$sh|9)^fkXn41YN|_txNu}-Fs$m|W3(p6b
zn!wZq{z7AF0vRpf^*Avyyum{vZfF&K=)n(641IL9`$)rQ*oNry06dvD1`u%r>B-pw
z4GjYDVs02fwrK>&g|$w{Lqw#kQ<`{4%a+m5RIk=d!=4&UO(3ti=?XD#0#g(C+wQGs
z6s9Kdw+T}d#O|0dTP+pRQ^T<udTBULLvIazG&l{c!PEpqV^ATxwVI&Vya~cHi+L0H
z%c^-3n3}-115*>2H-T>lm#C?0zBIso%lR@7$wO(2XqJam3~+f^O**bu0En*ytl+Bv
zrY4v>*VF|5Ip=BJD5?R4907XrGafp4Nk@BA6ZrGg)C8s`Fg1Zc6NpSrK=cjFU&gK-
zKpbBKhz6oVfar8S%!40SK6q9~K0Kskdqf=rNcA3}p_2wv6PTJn8i=V0q!LU`Am(AX
zI8^Z*fT;<jftWXesR^VN#BK>DXNevUAh8La(D0;&r!+jRp<07QIxsbXJSm%+Ku$FC
zCNOUTf7>;00#g(CcJNiq;hLJj_d`rgAW!dT6tNotkT`{a*qsR=It$Q~M+K14mC^v>
U8d?@0+c_E?Kw9FLKuz%f0jHY*L;wH)

literal 0
HcmV?d00001

diff --git a/audio/raven/audio-tables.mk b/audio/raven/audio-tables.mk
index cc64f06..b79674e 100644
--- a/audio/raven/audio-tables.mk
+++ b/audio/raven/audio-tables.mk
@@ -69,4 +69,10 @@ PRODUCT_COPY_FILES += \
 # Mixer Path Configuration for Audio Speaker Calibration Tool crus_sp_cal
 PRODUCT_COPY_FILES += \
     device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/cs35l41/crus_sp_cal_mixer_paths.xml:$(TARGET_COPY_OUT_VENDOR)/etc/crus_sp_cal_mixer_paths.xml
+
+# Waves ini/mps files for unit tests of halcontroller
+PRODUCT_COPY_FILES += \
+    device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/tuning/waves/tests/test_config.ini:$(TARGET_COPY_OUT_VENDOR)/etc/test_config.ini \
+    device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/tuning/waves/tests/test_preset.mps:$(TARGET_COPY_OUT_VENDOR)/etc/test_preset.mps
+
 endif
diff --git a/audio/raven/tuning/waves/tests/test_config.ini b/audio/raven/tuning/waves/tests/test_config.ini
new file mode 100644
index 0000000..ba12a8e
--- /dev/null
+++ b/audio/raven/tuning/waves/tests/test_config.ini
@@ -0,0 +1,58 @@
+########################################################################################################
+# (Optional) The supported features list for platform vendors to query from.
+# Platform vendors should call maxxaudio_qdsp_is_feature_supported with a string to query from the list.
+# This config has no effect in the MaxxAudioQdspHalController. It's only meaningful for platform vendors.
+# Putting any value other than 1 would be equivalent to not supported.
+########################################################################################################
+[HAL_SUPPORTED_FEATURES]
+CUSTOM_ACTION_256=1
+
+########################################################################################################
+# This defined the options of supported sample rates.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_SUPPORTED_SAMPLE_RATES]
+SR_COMMON   = 48000
+
+########################################################################################################
+# (Optional) The subtypes that applies to different angles(0, 90, 180, 270). Can be empty if not applicable.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_ORIENTATION_SUBTYPES]
+OST_SPEAKER = 0:12,90:13,180:12,270:0|13
+
+########################################################################################################
+# This defines available preset configurations.
+# This should be configured by Waves only unless platform vendor is familiar with MPS structure.
+########################################################################################################
+[HAL_SUPPORTED_PRESETS]
+SPEAKER_MUSIC = OM:1,SM:2,OST:OST_SPEAKER
+SPEAKER_SAFE_MUSIC = OM:10,SM:2,OST:OST_SPEAKER
+SPEAKER_SAFE_CALL = OM:10,SM:2,OST:OST_SPEAKER
+HEADSET_MUSIC = OM:2,SM:2
+
+########################################################################################################
+# This defines available CONTROL configurations. Only define the CONTROL if you need it.
+# The numbers could vary from device to device.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_SUPPORTED_CONTROLS]
+SPEAKER_INSTANCE = INSTANCE:1,DEV:0,SR:SR_COMMON,PRESET:SPEAKER_MUSIC|SPEAKER_SAFE_MUSIC|SPEAKER_SAFE_CALL
+A2DP_INSTANCE = INSTANCE:2,DEV:0,SR:SR_COMMON,PRESET:HEADSET_MUSIC
+USB_HEADPHONE_INSTANCE = INSTANCE:4,DEV:0,SR:SR_COMMON,PRESET:HEADSET_MUSIC
+
+[COEFS_CONVERTER_SETTING]
+AlgFxPath=/vendor/lib/libAlgFx_HiFi3z.so
+AlgFxPath64=/vendor/lib64/libAlgFx_HiFi3z.so
+# do not modify the following if not necessary
+#AudioFormatType=0
+#AudioFormatChannels=2
+#AudioFormatSampleRate=48000
+#AudioFormatBitsPerSample=32
+#AudioFormatSampleSize=4
+#AudioFormatIncrement=8
+
+[CUSTOM_ACTION_256]
+CASE_1=PRIORITY:0,NUMBERS:2:0|1,PRESET:SPEAKER_MUSIC
+CASE_2=PRIORITY:1,NUMBERS:1|2|4194304:2|3|4,PRESET:SPEAKER_SAFE_CALL
+CASE_3=PRIORITY:2,NUMBERS:1|4194304:0|1,PRESET:SPEAKER_SAFE_MUSIC
diff --git a/audio/raven/tuning/waves/tests/test_preset.mps b/audio/raven/tuning/waves/tests/test_preset.mps
new file mode 100644
index 0000000000000000000000000000000000000000..bd08ee30a1ee969ddde614206486e06935e0a2d3
GIT binary patch
literal 186955
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
U8d?@0+c_E?Kw9FLKuz%f0jHY*L;wH)

literal 0
HcmV?d00001

diff --git a/audio/slider/audio-tables.mk b/audio/slider/audio-tables.mk
index 5bab01f..03783c2 100644
--- a/audio/slider/audio-tables.mk
+++ b/audio/slider/audio-tables.mk
@@ -63,4 +63,10 @@ PRODUCT_COPY_FILES += \
 # Mixer Path Configuration for Audio Speaker Calibration Tool crus_sp_cal
 PRODUCT_COPY_FILES += \
     device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/cs35l41/crus_sp_cal_mixer_paths.xml:$(TARGET_COPY_OUT_VENDOR)/etc/crus_sp_cal_mixer_paths.xml
+
+# Waves ini/mps files for unit tests of halcontroller
+PRODUCT_COPY_FILES += \
+    device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/tuning/waves/tests/test_config.ini:$(TARGET_COPY_OUT_VENDOR)/etc/test_config.ini \
+    device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/tuning/waves/tests/test_preset.mps:$(TARGET_COPY_OUT_VENDOR)/etc/test_preset.mps
+
 endif
diff --git a/audio/slider/tuning/waves/tests/test_config.ini b/audio/slider/tuning/waves/tests/test_config.ini
new file mode 100644
index 0000000..ba12a8e
--- /dev/null
+++ b/audio/slider/tuning/waves/tests/test_config.ini
@@ -0,0 +1,58 @@
+########################################################################################################
+# (Optional) The supported features list for platform vendors to query from.
+# Platform vendors should call maxxaudio_qdsp_is_feature_supported with a string to query from the list.
+# This config has no effect in the MaxxAudioQdspHalController. It's only meaningful for platform vendors.
+# Putting any value other than 1 would be equivalent to not supported.
+########################################################################################################
+[HAL_SUPPORTED_FEATURES]
+CUSTOM_ACTION_256=1
+
+########################################################################################################
+# This defined the options of supported sample rates.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_SUPPORTED_SAMPLE_RATES]
+SR_COMMON   = 48000
+
+########################################################################################################
+# (Optional) The subtypes that applies to different angles(0, 90, 180, 270). Can be empty if not applicable.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_ORIENTATION_SUBTYPES]
+OST_SPEAKER = 0:12,90:13,180:12,270:0|13
+
+########################################################################################################
+# This defines available preset configurations.
+# This should be configured by Waves only unless platform vendor is familiar with MPS structure.
+########################################################################################################
+[HAL_SUPPORTED_PRESETS]
+SPEAKER_MUSIC = OM:1,SM:2,OST:OST_SPEAKER
+SPEAKER_SAFE_MUSIC = OM:10,SM:2,OST:OST_SPEAKER
+SPEAKER_SAFE_CALL = OM:10,SM:2,OST:OST_SPEAKER
+HEADSET_MUSIC = OM:2,SM:2
+
+########################################################################################################
+# This defines available CONTROL configurations. Only define the CONTROL if you need it.
+# The numbers could vary from device to device.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_SUPPORTED_CONTROLS]
+SPEAKER_INSTANCE = INSTANCE:1,DEV:0,SR:SR_COMMON,PRESET:SPEAKER_MUSIC|SPEAKER_SAFE_MUSIC|SPEAKER_SAFE_CALL
+A2DP_INSTANCE = INSTANCE:2,DEV:0,SR:SR_COMMON,PRESET:HEADSET_MUSIC
+USB_HEADPHONE_INSTANCE = INSTANCE:4,DEV:0,SR:SR_COMMON,PRESET:HEADSET_MUSIC
+
+[COEFS_CONVERTER_SETTING]
+AlgFxPath=/vendor/lib/libAlgFx_HiFi3z.so
+AlgFxPath64=/vendor/lib64/libAlgFx_HiFi3z.so
+# do not modify the following if not necessary
+#AudioFormatType=0
+#AudioFormatChannels=2
+#AudioFormatSampleRate=48000
+#AudioFormatBitsPerSample=32
+#AudioFormatSampleSize=4
+#AudioFormatIncrement=8
+
+[CUSTOM_ACTION_256]
+CASE_1=PRIORITY:0,NUMBERS:2:0|1,PRESET:SPEAKER_MUSIC
+CASE_2=PRIORITY:1,NUMBERS:1|2|4194304:2|3|4,PRESET:SPEAKER_SAFE_CALL
+CASE_3=PRIORITY:2,NUMBERS:1|4194304:0|1,PRESET:SPEAKER_SAFE_MUSIC
diff --git a/audio/slider/tuning/waves/tests/test_preset.mps b/audio/slider/tuning/waves/tests/test_preset.mps
new file mode 100644
index 0000000000000000000000000000000000000000..bd08ee30a1ee969ddde614206486e06935e0a2d3
GIT binary patch
literal 186955
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
U8d?@0+c_E?Kw9FLKuz%f0jHY*L;wH)

literal 0
HcmV?d00001

diff --git a/audio/whitefin/audio-tables.mk b/audio/whitefin/audio-tables.mk
index 4b13502..b299e4b 100644
--- a/audio/whitefin/audio-tables.mk
+++ b/audio/whitefin/audio-tables.mk
@@ -63,4 +63,10 @@ PRODUCT_COPY_FILES += \
 # Mixer Path Configuration for Audio Speaker Calibration Tool crus_sp_cal
 PRODUCT_COPY_FILES += \
     device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/cs35l41/crus_sp_cal_mixer_paths.xml:$(TARGET_COPY_OUT_VENDOR)/etc/crus_sp_cal_mixer_paths.xml
+
+# Waves ini/mps files for unit tests of halcontroller
+PRODUCT_COPY_FILES += \
+    device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/tuning/waves/tests/test_config.ini:$(TARGET_COPY_OUT_VENDOR)/etc/test_config.ini \
+    device/google/raviole/audio/$(AUDIO_TABLE_FOLDER)/tuning/waves/tests/test_preset.mps:$(TARGET_COPY_OUT_VENDOR)/etc/test_preset.mps
+
 endif
diff --git a/audio/whitefin/tuning/waves/tests/test_config.ini b/audio/whitefin/tuning/waves/tests/test_config.ini
new file mode 100644
index 0000000..ba12a8e
--- /dev/null
+++ b/audio/whitefin/tuning/waves/tests/test_config.ini
@@ -0,0 +1,58 @@
+########################################################################################################
+# (Optional) The supported features list for platform vendors to query from.
+# Platform vendors should call maxxaudio_qdsp_is_feature_supported with a string to query from the list.
+# This config has no effect in the MaxxAudioQdspHalController. It's only meaningful for platform vendors.
+# Putting any value other than 1 would be equivalent to not supported.
+########################################################################################################
+[HAL_SUPPORTED_FEATURES]
+CUSTOM_ACTION_256=1
+
+########################################################################################################
+# This defined the options of supported sample rates.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_SUPPORTED_SAMPLE_RATES]
+SR_COMMON   = 48000
+
+########################################################################################################
+# (Optional) The subtypes that applies to different angles(0, 90, 180, 270). Can be empty if not applicable.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_ORIENTATION_SUBTYPES]
+OST_SPEAKER = 0:12,90:13,180:12,270:0|13
+
+########################################################################################################
+# This defines available preset configurations.
+# This should be configured by Waves only unless platform vendor is familiar with MPS structure.
+########################################################################################################
+[HAL_SUPPORTED_PRESETS]
+SPEAKER_MUSIC = OM:1,SM:2,OST:OST_SPEAKER
+SPEAKER_SAFE_MUSIC = OM:10,SM:2,OST:OST_SPEAKER
+SPEAKER_SAFE_CALL = OM:10,SM:2,OST:OST_SPEAKER
+HEADSET_MUSIC = OM:2,SM:2
+
+########################################################################################################
+# This defines available CONTROL configurations. Only define the CONTROL if you need it.
+# The numbers could vary from device to device.
+# This can be configured by Waves or platform vendor.
+########################################################################################################
+[HAL_SUPPORTED_CONTROLS]
+SPEAKER_INSTANCE = INSTANCE:1,DEV:0,SR:SR_COMMON,PRESET:SPEAKER_MUSIC|SPEAKER_SAFE_MUSIC|SPEAKER_SAFE_CALL
+A2DP_INSTANCE = INSTANCE:2,DEV:0,SR:SR_COMMON,PRESET:HEADSET_MUSIC
+USB_HEADPHONE_INSTANCE = INSTANCE:4,DEV:0,SR:SR_COMMON,PRESET:HEADSET_MUSIC
+
+[COEFS_CONVERTER_SETTING]
+AlgFxPath=/vendor/lib/libAlgFx_HiFi3z.so
+AlgFxPath64=/vendor/lib64/libAlgFx_HiFi3z.so
+# do not modify the following if not necessary
+#AudioFormatType=0
+#AudioFormatChannels=2
+#AudioFormatSampleRate=48000
+#AudioFormatBitsPerSample=32
+#AudioFormatSampleSize=4
+#AudioFormatIncrement=8
+
+[CUSTOM_ACTION_256]
+CASE_1=PRIORITY:0,NUMBERS:2:0|1,PRESET:SPEAKER_MUSIC
+CASE_2=PRIORITY:1,NUMBERS:1|2|4194304:2|3|4,PRESET:SPEAKER_SAFE_CALL
+CASE_3=PRIORITY:2,NUMBERS:1|4194304:0|1,PRESET:SPEAKER_SAFE_MUSIC
diff --git a/audio/whitefin/tuning/waves/tests/test_preset.mps b/audio/whitefin/tuning/waves/tests/test_preset.mps
new file mode 100644
index 0000000000000000000000000000000000000000..bd08ee30a1ee969ddde614206486e06935e0a2d3
GIT binary patch
literal 186955
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
U8d?@0+c_E?Kw9FLKuz%f0jHY*L;wH)

literal 0
HcmV?d00001