From 0a614e171654a504fe23b497087f1ce86444a3cd Mon Sep 17 00:00:00 2001
From: Jasmine Cha <chajasmine@google.com>
Date: Wed, 15 Feb 2023 15:06:50 +0800
Subject: [PATCH] audio: update playback tuning and volume curve

Merge notes:
* Update full volume curve for sound quality (bass, depth, stereo)
* Updated max volume for louder, punchier, more powerful experience
* Updated volume curve to pass power budgets (based on volume
  20-25 = P10 + 300mW and volume 1-19 = P10).
  - Power testing only based on speaker load (not full monsoon battery
    testing).
  - Only risk at volume 22, over power budget by ~50mW, very small
    increase but can deal with it next iteration before dogfood.
* Update volume curve top volumes to pass heat budget at 41-42C skin
  temp for nominal use case (13dB CF pink noise).

Tuning gaps:
* No thermal throttle merged (2nd LL) yet (next iteration pre dogfood),
  so TMO use case unknown still.
* No BAACL tuning merged yet (next iteration pre dogfood)
* Still some bass distortion at top volume steps (need to address bass
  and piano distortion still).  Not clean but very natural vocals w/
  decent pitch reproduction.

Bug: 269384043
Test: manual test from 269384043#comment10

Change-Id: I01edeb0f5d56d2978f13523fe7ee7dd0f9e253b0
Signed-off-by: Jasmine Cha <chajasmine@google.com>
---
 audio/shiba/audio-tables.mk                 |   3 +-
 audio/shiba/config/audio_policy_volumes.xml | 241 ++++++++++++++++++++
 audio/shiba/tuning/waves/waves_preset.mps   | Bin 142598 -> 148838 bytes
 3 files changed, 243 insertions(+), 1 deletion(-)
 create mode 100644 audio/shiba/config/audio_policy_volumes.xml

diff --git a/audio/shiba/audio-tables.mk b/audio/shiba/audio-tables.mk
index 91f4cc3..7c54626 100644
--- a/audio/shiba/audio-tables.mk
+++ b/audio/shiba/audio-tables.mk
@@ -24,7 +24,8 @@ PRODUCT_COPY_FILES += \
     device/google/shusky/audio/$(AUDIO_TABLE_FOLDER)/config/audio_policy_configuration_a2dp_offload_disabled.xml:$(TARGET_COPY_OUT_VENDOR)/etc/audio_policy_configuration_a2dp_offload_disabled.xml \
     device/google/shusky/audio/$(AUDIO_TABLE_FOLDER)/config/audio_platform_configuration.xml:$(TARGET_COPY_OUT_VENDOR)/etc/audio_platform_configuration.xml \
     device/google/shusky/audio/$(AUDIO_TABLE_FOLDER)/config/sound_trigger_configuration.xml:$(TARGET_COPY_OUT_VENDOR)/etc/sound_trigger_configuration.xml \
-    device/google/shusky/audio/$(AUDIO_TABLE_FOLDER)/config/bluetooth_with_le_audio_policy_configuration_7_0.xml:$(TARGET_COPY_OUT_VENDOR)/etc/bluetooth_with_le_audio_policy_configuration_7_0.xml
+    device/google/shusky/audio/$(AUDIO_TABLE_FOLDER)/config/bluetooth_with_le_audio_policy_configuration_7_0.xml:$(TARGET_COPY_OUT_VENDOR)/etc/bluetooth_with_le_audio_policy_configuration_7_0.xml \
+    device/google/shusky/audio/$(AUDIO_TABLE_FOLDER)/config/audio_policy_volumes.xml:$(TARGET_COPY_OUT_VENDOR)/etc/audio_policy_volumes.xml
 
 # AudioEffectHAL Configuration
 PRODUCT_COPY_FILES += \
diff --git a/audio/shiba/config/audio_policy_volumes.xml b/audio/shiba/config/audio_policy_volumes.xml
new file mode 100644
index 0000000..3fe738d
--- /dev/null
+++ b/audio/shiba/config/audio_policy_volumes.xml
@@ -0,0 +1,241 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Copyright (C) 2015 The Android Open Source Project
+
+     Licensed under the Apache License, Version 2.0 (the "License");
+     you may not use this file except in compliance with the License.
+     You may obtain a copy of the License at
+
+          http://www.apache.org/licenses/LICENSE-2.0
+
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+     See the License for the specific language governing permissions and
+     limitations under the License.
+-->
+<!-- Volume section defines a volume curve for a given use case and device category.
+It contains a list of points of this curve expressing the attenuation in Millibels for a given
+volume index from 0 to 100.
+<volume stream=”AUDIO_STREAM_MUSIC” deviceCategory=””>
+<point>0,-9600</point>
+<point>100,0</point>
+</volume>
+-->
+
+<volumes>
+    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_HEADSET">
+        <point>0,-4200</point>
+        <point>33,-2800</point>
+        <point>66,-1400</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_SPEAKER">
+        <point>0,-2400</point>
+        <point>33,-1600</point>
+        <point>66,-800</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_EARPIECE">
+        <point>0,-2400</point>
+        <point>33,-1600</point>
+        <point>66,-800</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                             ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                             ref="DEFAULT_NON_MUTABLE_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_HEADSET">
+        <point>1,-3000</point>
+        <point>33,-2600</point>
+        <point>66,-2200</point>
+        <point>100,-1800</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_SPEAKER"
+                                         ref="DEFAULT_SYSTEM_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                         ref="DEFAULT_SYSTEM_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                         ref="DEFAULT_DEVICE_CATEGORY_EXT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                         ref="DEFAULT_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                       ref="DEFAULT_DEVICE_CATEGORY_HEADSET_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_SPEAKER">
+        <point>1,-2970</point>
+        <point>33,-2010</point>
+        <point>66,-1020</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                       ref="DEFAULT_DEVICE_CATEGORY_EARPIECE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                       ref="DEFAULT_DEVICE_CATEGORY_EXT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                       ref="DEFAULT_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                        ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_SPEAKER">
+        <point>1,-6438</point>
+        <point>4,-6438</point>
+        <point>8,-5961</point>
+        <point>12,-5543</point>
+        <point>16,-5167</point>
+        <point>20,-4743</point>
+        <point>24,-4391</point>
+        <point>28,-4061</point>
+        <point>32,-3871</point>
+        <point>36,-3673</point>
+        <point>40,-3471</point>
+        <point>44,-3273</point>
+        <point>48,-3065</point>
+        <point>52,-2850</point>
+        <point>56,-2618</point>
+        <point>60,-2355</point>
+        <point>64,-2060</point>
+        <point>68,-1773</point>
+        <point>72,-1482</point>
+        <point>76,-1205</point>
+        <point>80,-989</point>
+        <point>84,-791</point>
+        <point>88,-578</point>
+        <point>92,-374</point>
+        <point>96,-137</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                        ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                        ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                        ref="DEFAULT_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                        ref="DEFAULT_NON_MUTABLE_HEADSET_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_SPEAKER">
+        <point>0,-2970</point>
+        <point>33,-2010</point>
+        <point>66,-1020</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                        ref="DEFAULT_NON_MUTABLE_EARPIECE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                        ref="DEFAULT_NON_MUTABLE_EXT_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                        ref="DEFAULT_NON_MUTABLE_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                               ref="DEFAULT_DEVICE_CATEGORY_HEADSET_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_SPEAKER">
+        <point>1,-2970</point>
+        <point>33,-2010</point>
+        <point>66,-1020</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                               ref="DEFAULT_DEVICE_CATEGORY_EARPIECE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                               ref="DEFAULT_DEVICE_CATEGORY_EXT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                               ref="DEFAULT_DEVICE_CATEGORY_HEADSET_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_HEADSET">
+        <point>0,-4200</point>
+        <point>33,-2800</point>
+        <point>66,-1400</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_SPEAKER">
+        <point>0,-2400</point>
+        <point>33,-1600</point>
+        <point>66,-800</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_EARPIECE">
+        <point>0,-4200</point>
+        <point>33,-2800</point>
+        <point>66,-1400</point>
+        <point>100,0</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                                ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                                ref="DEFAULT_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_HEADSET">
+        <point>1,-3000</point>
+        <point>33,-2600</point>
+        <point>66,-2200</point>
+        <point>100,-1800</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_SPEAKER"
+                                                   ref="DEFAULT_SYSTEM_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                                   ref="DEFAULT_SYSTEM_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                                   ref="DEFAULT_DEVICE_CATEGORY_EXT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                                   ref="DEFAULT_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_HEADSET">
+        <point>1,-3000</point>
+        <point>33,-2600</point>
+        <point>66,-2200</point>
+        <point>100,-1800</point>
+    </volume>
+    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_SPEAKER"
+                                       ref="DEFAULT_SYSTEM_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                       ref="DEFAULT_SYSTEM_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                       ref="DEFAULT_DEVICE_CATEGORY_EXT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                       ref="DEFAULT_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                      ref="SILENT_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_SPEAKER"
+                                      ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                      ref="SILENT_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                      ref="SILENT_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                      ref="SILENT_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                                ref="DEFAULT_NON_MUTABLE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_SPEAKER"
+                                                ref="DEFAULT_NON_MUTABLE_SPEAKER_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                                ref="DEFAULT_NON_MUTABLE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                                ref="DEFAULT_NON_MUTABLE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                                ref="DEFAULT_NON_MUTABLE_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ASSISTANT" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                                ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ASSISTANT" deviceCategory="DEVICE_CATEGORY_SPEAKER"
+                                                ref="DEFAULT_DEVICE_CATEGORY_SPEAKER_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ASSISTANT" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                                ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ASSISTANT" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                                ref="DEFAULT_MEDIA_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_ASSISTANT" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                                ref="DEFAULT_HEARING_AID_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                            ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_SPEAKER"
+                                            ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                            ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                            ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                            ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_HEADSET"
+                                        ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_SPEAKER"
+                                        ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_EARPIECE"
+                                        ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"
+                                        ref="FULL_SCALE_VOLUME_CURVE"/>
+    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_HEARING_AID"
+                                        ref="FULL_SCALE_VOLUME_CURVE"/>
+</volumes>
+
diff --git a/audio/shiba/tuning/waves/waves_preset.mps b/audio/shiba/tuning/waves/waves_preset.mps
index 8212799672feb7b62bc17e8d33fa5519552d8a5c..fd6d8f465321fcf29a3dfbbac94d1f51fb32774b 100644
GIT binary patch
literal 148838
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

delta 4529
zcmb8xO=w(I6bJBor}ky0=G!hpTb(48w8d&tkg-CoGqEjb5-05{#SnDk#x{vUmuBM^
z=ptz^@<4+vh!I@1$s$|hLc};Vfq)=LS`asGB17t;P<(U#|9g2KcaSUs=lsvPcP9Dq
z$ouQl!pFbogW>VY*rStof`Ts8pUJ7my4ChE)1xo1eDZLjJ-qs%J`v7u=u@jN9?&<s
zg6*2#u00!W9@eF(R#9y_er%KyPk*k<ZA#rM>!@ucqvp;(MRR+n)qFK}$Zp*~q953L
z<BBeso!2{UKYLYQXu;WYH-0Lb&fU&~N)1(%Dn~y<6?<{mJFQQfyVZcpqh_sM3~#-o
zTg{_OdDA}L&B2*)ZCV$@+x@xL&fmVCEr0a)DfjKnySJY2Ix$(TOwQ+AI2m3%mn)ik
z^&@6>_h8$D<C8Dj4?Sb9@5)u}X6Rzxe&x4%_1mn?;QDab(WhJOtgla(>=!W`>p0xr
z{ex0}uGw3|vtR1h%=edC-LG=}-(uK#K9>)l?AK4(t1A8ato@i@YZq+1*)I}}KlaML
zli&0Piz9k*BoCp*5f#-U#5g8|Bq_u#5n}Cx*ozSACPG|vLg+n082E)SO9>(L3h}O_
z5W-M|c%c*GOoZ&=j1ZTc5c*M*6ylZ$p*9U6#toqZsH+1y7j_-hW%qE6HJ+;vg7Br!
z^y6W%C)c)G?$$H=%^%a>tzPcY@9hifTe`mWK0NDNDyqekam*7*(vw@_$=Z3c7f;kp
zJh|vR(R(~G@OxsG@<izM<XuTmgz)5r&XY6ow1+dETymc1)1KTCPt@YcSUgdWH$10D
zb!88pgG+jFX%U`-ODd|xlX1)wNz#*B;>p^1vKLR(O+2~iJkfhRG4Ok0mhwdC_2gYi
zPlWK~h0c>R@wA6Co?LRC=+mCu5>M3P$yhv5Pc%G#xu##;gXfIWGwKU?&L|bt;>kGX
zi6rUCE%9XSJlTsU>L#9Cbe`xvo*4K&F-v(O^m_8Hq$fgn@<QjynRwd68BZ=bPxNU|
zZiy#q@nkHXsE@12vwS``kh_1(ys+_xV@<r%R13OVSchP>prTp?8OH>XBn7!8f~=h&
zdl5w4M39S45WPnb1HT|<DM5r@LEe=VL<m7%=ma?vL3=nO$R#I;J}t;C5kxJ5j2nUh
z>XoM-e%l+&*YtetO$g1`R8)%)<CqYVxX|JKI4eLrK%g#;#0R4$K0HUCmO!q|@H~Os
zuY)U6ItaZw7$x2~3;e$FI>Y-M4*F1V?AZ(smx$A5e~;wb441?Pwb(Fj*yK@H2f~h{
zde}Ww|NkyiTGplI9XOVjRaA>3<Cr6oxZ|OKTLQ`2J!$Mk5_J<vF1jZTeTK5T1p~h&
zW+_XAUQ6DUe9{o&N#lhMlQY4zhclR5a!(ri^pnOd(L^npj71am_&|7NRKKzZ&8Y=F
zwXg}zsRb3)qRBX>i6p7XEzxA{G}((L>L!|8beiZrni%*sF-vJ8^lI|1q$WaW@<OM{
znP}R>8BH!ZP4sC^Ziyyp(PS)|s3!)(pRehWJ!sBV^jzg8H0LTRszsA=OcO~`lUt(6
z+G(;EP1H>^x#%>}do(fdYhsqtMCjGzT}e%Z(By?qlQYq@hclX7a+>JVn%oji)S}5)
O{tKdBeeR|{z4RaPxkC#8