From 59545de67bf6ba6b072713e15a2e2cd75cf384b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Antonio=20Bagur=20N=C3=A1jera?=
Date: Wed, 28 Aug 2024 21:05:49 -0600
Subject: [PATCH 01/11] Content update (datasheets)
---
.../datasheet/datasheet.md | 130 ++++----
.../datasheet/datasheet_v1.md | 305 ++++++++++++++++++
2 files changed, 380 insertions(+), 55 deletions(-)
create mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet_v1.md
diff --git a/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet.md b/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet.md
index e1c2a26b0e..a3aaa0f1b3 100644
--- a/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet.md
+++ b/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet.md
@@ -8,88 +8,108 @@ variant: 'Collective Datasheet'

# Description
-The Arduino Portenta Vision Shield is an add-on board providing machine vision capabilities and additional connectivity to the Portenta family of Arduino boards, designed to meet the needs of industrial automation. The Portenta Vision Shield connects via a high-density connector to the Portenta boards with minimal hardware and software setup.
+
+Enhance your industrial automation and surveillance projects with the Arduino Portenta Vision Shield. This add-on board integrates with the Portenta family, offering advanced machine vision capabilities and extended connectivity. The Vision Shield's compact design and high-density connector ensure a quick and efficient setup. It transforms your Portenta family board into a powerful tool for real-time image processing and edge computing, suitable for demanding industrial environments.
# Target Areas
-Industry, Surveillance
+Industrial automation, surveillance, machine vision, edge computing
-# Features
-Note: This board needs the Arduino Portenta H7 or Portenta C33 to function.
+# CONTENTS
+## Application Examples
-- **Himax HM-01B0 camera module**
- - Ultra-Low-Power Image Sensor designed for always-on vision devices and applications
- - High-sensitivity 3.6 μ BrightSenseTM pixel technology
- - Window, vertical flip and horizontal mirror readout
- - Programmable black level calibration target, frame size, frame rate, exposure, analog gain (up to 8x) and digital gain (up to 4x)
- - Automatic exposure and gain control loop with support for 50 Hz / 60 Hz flicker avoidance
- - Motion Detection circuit with programmable ROI and detection threshold with digital output to serve as an interrupt
+
+The Vision Shield is an add-on and a gateway to innovative solutions in various industries. Explore the possibilities of integrating advanced machine vision and edge computing into your projects with the following application examples:
- - **Supported resolutions**
- - QQVGA (160x120) at 15, 30, 60 and 120 FPS
- - QVGA (320x240) at 15, 30 and 60 FPS
+- **Industrial automation**: Elevate your automation systems with the Vision Shield, enabling precise and real-time image processing for:
+ - **Quality control**: Implement the Vision Shield in production lines to automatically detect product defects and ensure that only high-quality items pass through.
+ - **Predictive maintenance**: Use machine vision to monitor equipment and identify early signs of wear or failure, reducing downtime and maintenance costs.
+ - **Automated sorting**: Integrate the Vision Shield into conveyor systems to automatically sort items based on color, shape, or size, improving efficiency and accuracy.
- - **Power**
- - \< 1.1 mW QQVGA resolution at 30 FPS,
- - \< 2 mW QVGA resolution at 30 FPS
+- **Surveillance**: Enhance security and monitoring systems with advanced visual capabilities provided by the Vision Shield for:
+ - **Real-time threat detection**: Deploy the Vision Shield in security systems to identify and alert authorities of potential threats, such as unauthorized access or suspicious activities, in real-time.
+ - **Environmental monitoring**: Utilize the Vision Shield's imaging capabilities to monitor environmental conditions in critical areas, such as chemical plants, to ensure safety and compliance with regulations.
+ - **Perimeter surveillanc**e: Implement the Vision Shield in perimeter security to detect intrusions or breaches, triggering immediate responses and minimizing risks.
-- **2x MP34DT06JTR MEMS PDM Digital Microphone**
+- **Machine vision and edge computing**: Unlock the potential of edge computing with the Vision Shield, bringing powerful processing capabilities directly to the field for:
+ - **Smart agriculture**: Use the Vision Shield to monitor crops and soil conditions, identifying issues such as pest infestations or nutrient deficiencies, and enabling precise interventions to optimize yield.
+ - **Autonomous vehicles**: Integrate the Vision Shield into autonomous systems to enhance navigation and obstacle detection, ensuring safe and efficient operation in various environments.
+ - **Robotics**: Empower robots with the ability to see and interpret their surroundings using the Vision Shield, enabling complex tasks such as object recognition and manipulation in dynamic settings.
+
- - AOP = 122.5 dB SPL
- - 64 dB signal-to-noise ratio
- - Omnidirectional sensitivity
- - –26 dBFS ± 1 dB sensitivity
+## Features
-- **MIPI 20-pin compatible JTAG Connector**
+### General Specifications Overview
-- **Memory**
+The Vision Shield expands the capabilities of the Portenta H7 (any variant) or Portenta C33 boards, adding advanced vision and audio processing features to them.
- - Micro SD Card Slot
+Below is a summary of the shield's key components and their specifications.
-# Contents
-## The Board
-The included HM-01B0 camera module has been pre-configured to work with the OpenMV libraries provided by Arduino. Based on the specific application requirements, the Portenta Vision Shield is available in two configurations with either Ethernet or LoRa® connectivity. Ethernet is designed for integration of the Portenta into wired networks and providing high bandwidth. In situations requiring long-range operation at low bandwidth, LoRa® connectivity is the way to go. The multi-core processor of the Portenta H7 makes embedded vision possible by minimizing the data bandwidth required.
+| **Feature** | **Description** |
+|------------------------|--------------------------------------------------------------------------------------|
+| Onboard Camera | 1/6″ 640 x 480 VGA 60FPS CMOS image sensor (HM0360) |
+| Onboard Microphone | Ultra-compact, low-power, omnidirectional, digital MEMS microphone (x2) (MP34DT06J) |
+| External Memory | Onboard microSD card slot |
+| Onboard LoRa® Module | CMWX1ZZABZ-078 (only in LoRa® variant, SKU: ASX00026) |
+| Onboard RJ45 Connector | For Ehthernet capabilities (only in Ethernet variant, SKU: ASX00021) |
+| Dimensions | 67.07 x 25.39 mm |
+| Weight | 8 g |
+| Pinout Features | Onboard High-Density connectors easily connect the shield to Portenta family boards |
+
-### Product Variants
-The Portenta Vision Shield is available in two variants:
-* Ethernet variant (ASX00021)
-* LoRa® variant (ASX00026)
+### Included Accessories
+- No accessories are included
-### Application Examples
-Thanks to the low power consumption of the Portenta Vision Shield, it is well suited for bringing machine learning to a wide range of Industry 4.0 and IoT applications.
+### Related Products
-- **Industrial production:** The included HM-01B0 camera along with the OpenMV libraries allows for quality control of items within a manufacturing or packaging plant. The small footprint, low power consumption and LoRa®/Ethernet connectivity allow for the module to be deployed essentially anywhere so that defects are identified quickly and removed from the production environment.
+- Portenta H7 (SKU: ABX00042)
+- Portenta H7 Lite (SKU: ABX00045)
+- Portenta H7 Lite Connected (SKU: ABX00046)
+- Portenta C33 (SKU: ABX00074)
+- Arduino USB Type-C® Cable 2-in-1 (SKU: TPX00094)
-- **Predictive maintenance:** The combination of machine vision and machine learning capabilities of the Portenta Vision Shield and the Portenta H7 opens up possibilities for predictive maintenance based on subtle differences in the visual representation of machinery. These capabilities are further enhanced with the two MP34DT05 MEMS microphones included in the Portenta Vision Shield.
+
+The Portenta C33 board is not compatible with the onboard camera of the Vision Shield, it is only compatible with the shield's connectivity features (Ethernet or LoRa®).
+
-- **Surveillance:** The Portenta Vision Shield is able to provide surveillance capabilities in areas with low Wi-Fi® penetration (e.g. warehouses) and large areas
- (e.g. shopping centers). The OpenMV libraries enable the Portenta Vision Shield to identify objects and alert the operator via LoRa® while saving a snapshot on the microSD storage slot.
+
-### Related Products
-The Portenta Vision Shield is developed as an add-on shield compatible with the following Portenta boards:
-* Portenta H7 (ABX00042)
-* Portenta H7 Lite (ABX00045)
-* Portenta H7 Lite Connected (ABX00046)
-* Portenta C33 (ABX00074). **Only connectivity. Not compatible with the Portenta Vision Shield camera**
+## Ratings
+### Recommended Operating Conditions
-## Ratings
+
+The table below provides a comprehensive guideline for the optimal use of the Vision Shield, outlining typical operating conditions and design limits. The operating conditions of the Vision Shield are largely a function based on its component's specifications.
+
-### Absolute Maximum
+
-| **Symbol** | **Description** | **Min** | **Typ** | **Max** | **Unit** |
-| ---------- | -------------------------------- | ------- | ------- | ------- | -------- |
-| VINMax | Input voltage from HD Connectors | -0.3 | - | 3.3 | V |
+| **Parameter** | **Symbol** | **Min** | **Typ** | **Max** | **Unit** |
+|:--------------------------------:|:---------------:|:-------:|:-------:|:-------:|:--------:|
+| Supply Input Voltage1 | VIN | - | 3.3 | 3.3 | V |
+| Operating Temperature | TOP | -40 | - | 85 | °C |
-### Thermal
+
-| **Symbol** | **Description** | **Min** | **Typ** | **Max** | **Unit** |
-| ---------- | --------------------- | ------- | ------- | ------- | -------- |
-| TST | Storage Temperature | -30 | | 85 | °C |
-| TOP | Operating Temperature | -40 | | 85 | °C |
+1 Vision Shield powered through a Portenta family board.
-
+### Power Consumption
+
+
+The table below summarizes the power consumption of the Vision Shield in different test cases. Notice that the board's operating current will depend greatly on the application.
+
+
+| Parameter | Symbol | Min | Typ | Max | Unit |
+|:---------------------------------:|:--------------:|:---:|:---:|:---:|:----:|
+| Typical Mode Current Consumption² | INM | - | TBD | - | mA |
+
+
+2 Vision Shield powered through a Portenta family board.
+
+
+The Vision Shield can be only powered through its High-Density Connectors (VCC pin).
+
## Functional Overview
diff --git a/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet_v1.md b/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet_v1.md
new file mode 100644
index 0000000000..8088514349
--- /dev/null
+++ b/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet_v1.md
@@ -0,0 +1,305 @@
+---
+identifier: ASX00021-ASX00026
+title: Arduino® Portenta Vision Shield
+type: pro
+variant: 'Collective Datasheet'
+---
+
+
+
+# Description
+The Arduino Portenta Vision Shield is an add-on board providing machine vision capabilities and additional connectivity to the Portenta family of Arduino boards, designed to meet the needs of industrial automation. The Portenta Vision Shield connects via a high-density connector to the Portenta boards with minimal hardware and software setup.
+
+# Target Areas
+Industry, Surveillance
+
+# Features
+Note: This board needs the Arduino Portenta H7 or Portenta C33 to function.
+
+- **Himax HM-01B0 camera module**
+ - Ultra-Low-Power Image Sensor designed for always-on vision devices and applications
+ - High-sensitivity 3.6 μ BrightSenseTM pixel technology
+ - Window, vertical flip and horizontal mirror readout
+ - Programmable black level calibration target, frame size, frame rate, exposure, analog gain (up to 8x) and digital gain (up to 4x)
+ - Automatic exposure and gain control loop with support for 50 Hz / 60 Hz flicker avoidance
+ - Motion Detection circuit with programmable ROI and detection threshold with digital output to serve as an interrupt
+
+ - **Supported resolutions**
+ - QQVGA (160x120) at 15, 30, 60 and 120 FPS
+ - QVGA (320x240) at 15, 30 and 60 FPS
+
+ - **Power**
+ - \< 1.1 mW QQVGA resolution at 30 FPS,
+ - \< 2 mW QVGA resolution at 30 FPS
+
+- **2x MP34DT06JTR MEMS PDM Digital Microphone**
+
+ - AOP = 122.5 dB SPL
+ - 64 dB signal-to-noise ratio
+ - Omnidirectional sensitivity
+ - –26 dBFS ± 1 dB sensitivity
+
+- **MIPI 20-pin compatible JTAG Connector**
+
+- **Memory**
+
+ - Micro SD Card Slot
+
+# Contents
+## The Board
+The included HM-01B0 camera module has been pre-configured to work with the OpenMV libraries provided by Arduino. Based on the specific application requirements, the Portenta Vision Shield is available in two configurations with either Ethernet or LoRa® connectivity. Ethernet is designed for integration of the Portenta into wired networks and providing high bandwidth. In situations requiring long-range operation at low bandwidth, LoRa® connectivity is the way to go. The multi-core processor of the Portenta H7 makes embedded vision possible by minimizing the data bandwidth required.
+
+
+### Product Variants
+The Portenta Vision Shield is available in two variants:
+* Ethernet variant (ASX00021)
+* LoRa® variant (ASX00026)
+
+
+### Application Examples
+Thanks to the low power consumption of the Portenta Vision Shield, it is well suited for bringing machine learning to a wide range of Industry 4.0 and IoT applications.
+
+- **Industrial production:** The included HM-01B0 camera along with the OpenMV libraries allows for quality control of items within a manufacturing or packaging plant. The small footprint, low power consumption and LoRa®/Ethernet connectivity allow for the module to be deployed essentially anywhere so that defects are identified quickly and removed from the production environment.
+
+- **Predictive maintenance:** The combination of machine vision and machine learning capabilities of the Portenta Vision Shield and the Portenta H7 opens up possibilities for predictive maintenance based on subtle differences in the visual representation of machinery. These capabilities are further enhanced with the two MP34DT05 MEMS microphones included in the Portenta Vision Shield.
+
+- **Surveillance:** The Portenta Vision Shield is able to provide surveillance capabilities in areas with low Wi-Fi® penetration (e.g. warehouses) and large areas
+ (e.g. shopping centers). The OpenMV libraries enable the Portenta Vision Shield to identify objects and alert the operator via LoRa® while saving a snapshot on the microSD storage slot.
+
+### Related Products
+The Portenta Vision Shield is developed as an add-on shield compatible with the following Portenta boards:
+* Portenta H7 (ABX00042)
+* Portenta H7 Lite (ABX00045)
+* Portenta H7 Lite Connected (ABX00046)
+* Portenta C33 (ABX00074). **Only connectivity. Not compatible with the Portenta Vision Shield camera**
+
+
+## Ratings
+
+### Absolute Maximum
+
+| **Symbol** | **Description** | **Min** | **Typ** | **Max** | **Unit** |
+| ---------- | -------------------------------- | ------- | ------- | ------- | -------- |
+| VINMax | Input voltage from HD Connectors | -0.3 | - | 3.3 | V |
+
+### Thermal
+
+| **Symbol** | **Description** | **Min** | **Typ** | **Max** | **Unit** |
+| ---------- | --------------------- | ------- | ------- | ------- | -------- |
+| TST | Storage Temperature | -30 | | 85 | °C |
+| TOP | Operating Temperature | -40 | | 85 | °C |
+
+
+
+## Functional Overview
+
+### Board Topology
+
+
+
+
+| Ref. | Description | Ref. | Description |
+| ------ | ---------------------------------------------- | ---- | -------------------------------------------------- |
+| U1 | Voltage Regulator | J3 | LoRa® Radio Antenna U.FL Connector (ASX00026 Only) |
+| U2,U3 | ST MP34DT06JTR Digital Microphones | J7 | Ethernet Connector (ASX00021 Only) |
+| M1 | Murata CMWX1ZZABZ LoRa® Module (ASX00026 Only) | J9 | Micro SD Card Connector |
+| J1, J2 | High-Density Connectors | CN1 | JTAG Connector |
+| CAM1 | Camera Module Himax HM-01B0 | | |
+
+### Power
+The Portenta H7/C33 supplies 3.3 V power to the LoRa® module (ASX00026 only), Ethernet communication (ASX00021 only), Micro SD slot and dual microphones via the 3.3 V output of the high-density connectors. An onboard LDO regulator supplies a 2.8 V output (300 mA) for the camera module.
+
+### Camera Module
+
+The Himax HM-01B0 Module is a very low-power camera with 324x324 resolution and a maximum of 60 FPS depending on the operating mode. Video data is transferred over a configurable 8-bit interconnect with support for frame and line synchronization. The module delivered with the Portenta Vision Shield is the monochrome version. Configuration is achieved via an I2C connection with the compatible Portenta boards microcontrollers.
+
+HM-01B0 offers very low-power image acquisition and provides the possibility to perform motion detection without main processor interaction. The “Always-on” operation provides the ability to turn on the main processor when movement is detected with minimal power consumption.
+
+***Note: The Portenta C33 is not compatible with the camera of the Portenta Vision Shield***
+
+
+### Digital Microphones
+
+The dual MP34DT05 digital MEMS microphones are omnidirectional and operate via a capacitive sensing element with a high (64 dB) signal-to-noise ratio. The microphones have been configured to provide separate left and right audio over a single PDM stream.
+
+The sensing element, capable of detecting acoustic waves, is manufactured using a specialized silicon micromachining process dedicated to produce audio sensors.
+
+
+### Micro SD Card Slot
+
+A Micro SD card slot is available under the Portenta Vision Shield board. Available libraries allow reading and writing to FAT16/32 formatted cards.
+
+
+### Ethernet (ASX00021 Only)
+
+Ethernet connector allows connecting to 10/100 Base TX networks using the Ethernet PHY available on the Portenta board.
+
+
+### LoRa® Module (ASX00026 Only)
+
+LoRa® connectivity is provided by the Murata CMWX1ZZABZ module. This module contains an STM32L0 processor along with a Semtech SX1276 Radio. The processor is running on Arduino open-source firmware based on Semtech code.
+
+## Board Operation
+
+### Getting Started – OpenMV
+
+The Portenta Vision Shield and Portenta H7 are supported under OpenMV. In order to easily use OpenMV download the latest OpenMV IDE **[1]** and follow the Portenta Vision Shield official documentation **[2]** to learn how to create OpenMV vision applications.
+
+### Getting Started – IDE
+
+If you want to program your Arduino board while offline you need to install the Arduino Desktop IDE **[3]**. To connect the board to your computer, you will need a USB cable. This also provides power to the board, as indicated by the LED.
+
+
+### Getting Started – Arduino Web Editor (Create)
+
+All Arduino and Genuino boards, including this one, work out-of-the-box on the Arduino Web Editor **[4]** by just installing a simple plugin.
+
+The Arduino Web Editor is hosted online, therefore it will always be up-to-date with the latest features and support for all boards. Follow **[5]** to start coding on the browser and upload your sketches onto your board.
+
+
+### Getting Started – Arduino Cloud
+
+All Arduino IoT-enabled products are supported on Arduino Cloud which allows you to Log, graph and analyze sensor data, trigger events, and automate your home or business.
+
+### Online Resources
+Now that you have gone through the basics of what you can do with the board you can explore the endless possibilities it provides by checking exciting projects on ProjectHub **[6]**, the Arduino Library Reference **[7]** and the online store **[8]** where you will be able to complement your board with sensors, actuators and more.
+
+### Board Recovery
+All Arduino boards have a built-in bootloader which allows flashing the board via USB. In case a sketch locks up the processor and the board is not reachable anymore via USB it is possible to enter bootloader mode by double-tapping the reset button right after the power-up.
+
+## Connector Pinouts
+### JTAG
+
+| Pin | Function | Type | Description |
+| ---------------------------- | -------- | ------------- | ---------------------------------------------- |
+| 1 | VDDIO | Power | Positive Reference voltage for debug interface |
+| 2 | SWD | I/O | Single Wire Debug Data |
+| 3,5,9 | GND | Power | Negative reference voltage for debug interface |
+| 4 | SCK | Output | Single Wire Debug Clock |
+| 6 | SWO | I/O | Single Wire Debug Trace |
+| 10 | RESET | Input | CPU Reset |
+| 7,11,12,13,14,15,17,18,19,20 | NC | Not Connected | |
+
+
+
+
+### High-Density Connector
+
+
+## Mechanical Information
+### Board Outline
+
+
+### Mounting Instructions
+
+
+### Connector and Component Positions
+
+
+
+
+
+
+## Certifications
+### Declaration of Conformity CE/RED DoC (EU)
+We declare under our sole responsibility that the products above are in conformity with the essential requirements of the following EU Directives and therefore qualify for free movement within markets comprising the European Union (EU) and European Economic Area (EEA).
+
+### Declaration of Conformity to EU RoHS & REACH 191 11/26/2018
+Arduino boards are in compliance with Directive 2011/65/EU of the European Parliament and Directive 2015/863/EU of the Council of 4 June 2015 on the restriction of the use of certain hazardous substances in electrical and electronic equipment.
+
+| **Substance** | **Maximum Limit (ppm)** |
+| -------------------------------------- | ----------------------- |
+| Lead (Pb) | 1000 |
+| Cadmium (Cd) | 100 |
+| Mercury (Hg) | 1000 |
+| Hexavalent Chromium (Cr6+) | 1000 |
+| Poly Brominated Biphenyls (PBB) | 1000 |
+| Poly Brominated Diphenyl ethers (PBDE) | 1000 |
+| Bis(2-Ethylhexyl} phthalate (DEHP) | 1000 |
+| Benzyl butyl phthalate (BBP) | 1000 |
+| Dibutyl phthalate (DBP) | 1000 |
+| Diisobutyl phthalate (DIBP) | 1000 |
+
+Exemptions : No exemptions are claimed.
+
+Arduino Boards are fully compliant with the related requirements of European Union Regulation (EC) 1907 /2006 concerning the Registration, Evaluation, Authorization and Restriction of Chemicals (REACH). We declare none of the SVHCs (https://echa.europa.eu/web/guest/candidate-list-table), the Candidate List of Substances of Very High Concern for authorization currently released by ECHA, is present in all products (and also package) in quantities totaling in a concentration equal or above 0.1%. To the best of our knowledge, we also declare that our products do not contain any of the substances listed on the "Authorization List" (Annex XIV of the REACH regulations) and Substances of Very High Concern (SVHC) in any significant amounts as specified by the Annex XVII of Candidate list published by ECHA (European Chemical Agency) 1907 /2006/EC.
+
+### Conflict Minerals Declaration
+As a global supplier of electronic and electrical components, Arduino is aware of our obligations with regards to laws and regulations regarding Conflict Minerals, specifically the Dodd-Frank Wall Street Reform and Consumer Protection Act, Section 1502. Arduino does not directly source or process conflict minerals such as Tin, Tantalum, Tungsten, or Gold. Conflict minerals are contained in our products in the form of solder, or as a component in metal alloys. As part of our reasonable due diligence Arduino has contacted component suppliers within our supply chain to verify their continued compliance with the regulations. Based on the information received thus far we declare that our products contain Conflict Minerals sourced from conflict-free areas.
+
+## FCC Caution
+
+Any Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
+This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
+FCC RF Radiation Exposure Statement:
+
+1. This Transmitter must not be co-located or operating in conjunction with any other antenna or transmitter.
+
+2. This equipment complies with RF radiation exposure limits set forth for an uncontrolled environment.
+
+3. This equipment should be installed and operated with a minimum distance 20 cm between the radiator& your body.
+
+
+
+ Antenna manufacturer:
+ |
+ Dynaflex
+ |
+
+
+ Antenna Model:
+ |
+ 2G-3G-4G ADHESIVE MOUNT ANTENNA DIPOLE
+ |
+
+
+ Antenna type:
+ |
+ External omnidirectional dipole antenna
+ |
+
+
+ Antenna gain:
+ |
+ -1 dBi
+ |
+
+
+
+**Important:** The operating temperature of the EUT can’t exceed 85℃ and shouldn’t be lower than -40℃.
+
+Hereby, Arduino S.r.l. declares that this product is in compliance with essential requirements and other relevant provisions of Directive 201453/EU. This product is allowed to be used in all EU member states.
+
+| Frequency bands | Maximum Output Power (ERP) |
+| --------------- | -------------------------- |
+| 863-870 MHz | 0.73 dBm |
+
+
+## Company Information
+
+
+| Company name | Arduino S.r.l. |
+| --------------- | ------------------------------------------ |
+| Company Address | Via Andrea Appiani, 25 20900 MONZA (Italy) |
+
+## Reference Documentation
+
+| **Ref** | **Link** |
+| ------------------------------------ | ------------------------------------------------------------------------ |
+| OpenMV IDE | https://openmv.io/pages/download |
+| Portenta Vision Shield Documentation | https://docs.arduino.cc/hardware/portenta-vision-shield |
+| Arduino IDE (Desktop) | https://www.arduino.cc/en/Main/Software |
+| Arduino IDE (Cloud) | https://create.arduino.cc/editor |
+| Cloud IDE Getting Started | https://docs.arduino.cc/arduino-cloud/guides/overview |
+| ProjectHub | https://create.arduino.cc/projecthub?by=part&part_id=11332&sort=trending |
+| Library Reference | https://www.arduino.cc/reference/en/ |
+| Arduino Store | https://store.arduino.cc/ |
+
+## Change Log
+
+| **Date** | **Revision** | **Changes** |
+| ---------- | ------------ | -------------------------------------- |
+| 20/11/2023 | 4 | Structure Updates. FCC Caution Updated |
+| 15/11/2023 | 3 | Updates as a Collective Datasheet |
+| 13/01/2022 | 2 | Information update |
+| 03/03/2021 | 1 | First Release |
From e3cc49920d09579a986f69ef631ac0b76d5abc10 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Antonio=20Bagur=20N=C3=A1jera?=
Date: Thu, 29 Aug 2024 12:36:49 -0600
Subject: [PATCH 02/11] Content update (datasheet)
---
.../datasheet/datasheet.md | 253 ++++--------------
1 file changed, 54 insertions(+), 199 deletions(-)
diff --git a/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet.md b/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet.md
index a3aaa0f1b3..dab575e564 100644
--- a/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet.md
+++ b/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/datasheet.md
@@ -1,6 +1,6 @@
---
identifier: ASX00021-ASX00026
-title: Arduino® Portenta Vision Shield
+title: Arduino® Portenta Vision Shield Rev 2
type: pro
variant: 'Collective Datasheet'
---
@@ -9,7 +9,7 @@ variant: 'Collective Datasheet'
# Description
-Enhance your industrial automation and surveillance projects with the Arduino Portenta Vision Shield. This add-on board integrates with the Portenta family, offering advanced machine vision capabilities and extended connectivity. The Vision Shield's compact design and high-density connector ensure a quick and efficient setup. It transforms your Portenta family board into a powerful tool for real-time image processing and edge computing, suitable for demanding industrial environments.
+Enhance your industrial automation and surveillance projects with the Arduino Portenta Vision Shield. This add-on board integrates with the Portenta family, offering advanced machine vision capabilities and extended connectivity. The Portenta Vision Shield's compact design and High-Fensity connector ensure a quick and efficient setup. It transforms your Portenta family board into a powerful tool for real-time image processing and edge computing, suitable for demanding industrial environments.
# Target Areas
Industrial automation, surveillance, machine vision, edge computing
@@ -18,29 +18,29 @@ Industrial automation, surveillance, machine vision, edge computing
## Application Examples
-The Vision Shield is an add-on and a gateway to innovative solutions in various industries. Explore the possibilities of integrating advanced machine vision and edge computing into your projects with the following application examples:
+The Portenta Vision Shield is an add-on and a gateway to innovative solutions in various industries. Explore the possibilities of integrating advanced machine vision and edge computing into your projects with the following application examples:
-- **Industrial automation**: Elevate your automation systems with the Vision Shield, enabling precise and real-time image processing for:
- - **Quality control**: Implement the Vision Shield in production lines to automatically detect product defects and ensure that only high-quality items pass through.
+- **Industrial automation**: Elevate your automation systems with the Portenta Vision Shield, enabling precise and real-time image processing for:
+ - **Quality control**: Implement the Portenta Vision Shield in production lines to automatically detect product defects and ensure that only high-quality items pass through.
- **Predictive maintenance**: Use machine vision to monitor equipment and identify early signs of wear or failure, reducing downtime and maintenance costs.
- - **Automated sorting**: Integrate the Vision Shield into conveyor systems to automatically sort items based on color, shape, or size, improving efficiency and accuracy.
+ - **Automated sorting**: Integrate the Portenta Vision Shield into conveyor systems to automatically sort items based on color, shape, or size, improving efficiency and accuracy.
-- **Surveillance**: Enhance security and monitoring systems with advanced visual capabilities provided by the Vision Shield for:
- - **Real-time threat detection**: Deploy the Vision Shield in security systems to identify and alert authorities of potential threats, such as unauthorized access or suspicious activities, in real-time.
- - **Environmental monitoring**: Utilize the Vision Shield's imaging capabilities to monitor environmental conditions in critical areas, such as chemical plants, to ensure safety and compliance with regulations.
- - **Perimeter surveillanc**e: Implement the Vision Shield in perimeter security to detect intrusions or breaches, triggering immediate responses and minimizing risks.
+- **Surveillance**: Enhance security and monitoring systems with advanced visual capabilities provided by the Portenta Vision Shield for:
+ - **Real-time threat detection**: Deploy the Portenta Vision Shield in security systems to identify and alert authorities of potential threats, such as unauthorized access or suspicious activities, in real-time.
+ - **Environmental monitoring**: Utilize the Portenta Vision Shield's imaging capabilities to monitor environmental conditions in critical areas, such as chemical plants, to ensure safety and compliance with regulations.
+ - **Perimeter surveillanc**e: Implement the Portenta Vision Shield in perimeter security to detect intrusions or breaches, triggering immediate responses and minimizing risks.
-- **Machine vision and edge computing**: Unlock the potential of edge computing with the Vision Shield, bringing powerful processing capabilities directly to the field for:
- - **Smart agriculture**: Use the Vision Shield to monitor crops and soil conditions, identifying issues such as pest infestations or nutrient deficiencies, and enabling precise interventions to optimize yield.
- - **Autonomous vehicles**: Integrate the Vision Shield into autonomous systems to enhance navigation and obstacle detection, ensuring safe and efficient operation in various environments.
- - **Robotics**: Empower robots with the ability to see and interpret their surroundings using the Vision Shield, enabling complex tasks such as object recognition and manipulation in dynamic settings.
+- **Machine vision and edge computing**: Unlock the potential of edge computing with the Portenta Vision Shield, bringing powerful processing capabilities directly to the field for:
+ - **Smart agriculture**: Use the Portenta Vision Shield to monitor crops and soil conditions, identifying issues such as pest infestations or nutrient deficiencies, and enabling precise interventions to optimize yield.
+ - **Autonomous vehicles**: Integrate the Portenta Vision Shield into autonomous systems to enhance navigation and obstacle detection, ensuring safe and efficient operation in various environments.
+ - **Robotics**: Empower robots with the ability to see and interpret their surroundings using the Portenta Vision Shield, enabling complex tasks such as object recognition and manipulation in dynamic settings.
## Features
### General Specifications Overview
-The Vision Shield expands the capabilities of the Portenta H7 (any variant) or Portenta C33 boards, adding advanced vision and audio processing features to them.
+
The Portenta Vision Shield expands the capabilities of the Portenta H7 (any variant) or Portenta C33 boards, adding advanced vision and audio processing features to them.
Below is a summary of the shield's key components and their specifications.
@@ -50,7 +50,7 @@ Below is a summary of the shield's key components and their specifications.
| Onboard Microphone | Ultra-compact, low-power, omnidirectional, digital MEMS microphone (x2) (MP34DT06J) |
| External Memory | Onboard microSD card slot |
| Onboard LoRa® Module | CMWX1ZZABZ-078 (only in LoRa® variant, SKU: ASX00026) |
-| Onboard RJ45 Connector | For Ehthernet capabilities (only in Ethernet variant, SKU: ASX00021) |
+| Onboard RJ45 Connector | For Ethernet capabilities (only in Ethernet variant, SKU: ASX00021) |
| Dimensions | 67.07 x 25.39 mm |
| Weight | 8 g |
| Pinout Features | Onboard High-Density connectors easily connect the shield to Portenta family boards |
@@ -70,7 +70,7 @@ Below is a summary of the shield's key components and their specifications.
- Arduino USB Type-C® Cable 2-in-1 (SKU: TPX00094)
-The Portenta C33 board is not compatible with the onboard camera of the Vision Shield, it is only compatible with the shield's connectivity features (Ethernet or LoRa®).
+The Portenta C33 board is not compatible with the onboard camera of the Portenta Vision Shield, it is only compatible with the shield's advanced audio and connectivity features (Ethernet or LoRa® depending of the variant).
@@ -80,7 +80,7 @@ The Portenta C33 board is not compatible with the onboard camer
### Recommended Operating Conditions
-The table below provides a comprehensive guideline for the optimal use of the Vision Shield, outlining typical operating conditions and design limits. The operating conditions of the Vision Shield are largely a function based on its component's specifications.
+The table below provides a comprehensive guideline for the optimal use of the Portenta Vision Shield, outlining typical operating conditions and design limits. The operating conditions of the Portenta Vision Shield are largely a function based on its component's specifications.
@@ -92,12 +92,12 @@ The table below provides a comprehensive guideline for the optimal use of the Vi
-1 Vision Shield powered through a Portenta family board.
+1 Portenta Vision Shield powered through a Portenta family board.
### Power Consumption
-The table below summarizes the power consumption of the Vision Shield in different test cases. Notice that the board's operating current will depend greatly on the application.
+The table below summarizes the power consumption of the Portenta Vision Shield in different test cases. Notice that the board's operating current will depend greatly on the application.
| Parameter | Symbol | Min | Typ | Max | Unit |
@@ -105,221 +105,76 @@ The table below summarizes the power consumption of the Vision Shield in differe
| Typical Mode Current Consumption² | INM | - | TBD | - | mA |
-2 Vision Shield powered through a Portenta family board.
+2 Portenta Vision Shield powered through a Portenta family board.
-The Vision Shield can be only powered through its High-Density Connectors (VCC pin).
+The Portenta Vision Shield can be only powered through its High-Density Connectors (VCC pin).
## Functional Overview
-### Board Topology
-
+The core of the Portenta Vision Shield is its integration with the Portenta family boards, leveraging their processing power for advanced vision and audio applications. The Portenta Vision Shield is equipped with key peripherals, such as dual MEMS microphones (MP34DT06J) and a high-performance camera module (HM0360), all directly interfaced with the main Portenta family board. Two different variants of the shield offer advanced connectivity capabilities, via Ethernet (variant SKU: ASX00021) and via LoRa® variant (SKU: ASX00026).
-
+### Pinout
-| Ref. | Description | Ref. | Description |
-| ------ | ---------------------------------------------- | ---- | -------------------------------------------------- |
-| U1 | Voltage Regulator | J3 | LoRa® Radio Antenna U.FL Connector (ASX00026 Only) |
-| U2,U3 | ST MP34DT06JTR Digital Microphones | J7 | Ethernet Connector (ASX00021 Only) |
-| M1 | Murata CMWX1ZZABZ LoRa® Module (ASX00026 Only) | J9 | Micro SD Card Connector |
-| J1, J2 | High-Density Connectors | CN1 | JTAG Connector |
-| CAM1 | Camera Module Himax HM-01B0 | | |
+The high-density connector pinout for the Portenta Vision Shield Ethernet variant (SKU: ASX00021) is shown in the figure below.
-### Power
-The Portenta H7/C33 supplies 3.3 V power to the LoRa® module (ASX00026 only), Ethernet communication (ASX00021 only), Micro SD slot and dual microphones via the 3.3 V output of the high-density connectors. An onboard LDO regulator supplies a 2.8 V output (300 mA) for the camera module.
+The high-density connector pinout for the Portenta Vision Shield LoRa® variant (SKU: ASX00026) is shown in the figure below.
-### Camera Module
-
-The Himax HM-01B0 Module is a very low-power camera with 324x324 resolution and a maximum of 60 FPS depending on the operating mode. Video data is transferred over a configurable 8-bit interconnect with support for frame and line synchronization. The module delivered with the Portenta Vision Shield is the monochrome version. Configuration is achieved via an I2C connection with the compatible Portenta boards microcontrollers.
-
-HM-01B0 offers very low-power image acquisition and provides the possibility to perform motion detection without main processor interaction. The “Always-on” operation provides the ability to turn on the main processor when movement is detected with minimal power consumption.
-
-***Note: The Portenta C33 is not compatible with the camera of the Portenta Vision Shield***
-
-
-### Digital Microphones
-
-The dual MP34DT05 digital MEMS microphones are omnidirectional and operate via a capacitive sensing element with a high (64 dB) signal-to-noise ratio. The microphones have been configured to provide separate left and right audio over a single PDM stream.
-
-The sensing element, capable of detecting acoustic waves, is manufactured using a specialized silicon micromachining process dedicated to produce audio sensors.
-
-
-### Micro SD Card Slot
-
-A Micro SD card slot is available under the Portenta Vision Shield board. Available libraries allow reading and writing to FAT16/32 formatted cards.
+
+### Block Diagram
-### Ethernet (ASX00021 Only)
+An overview of the high-level architecture of the Portenta Vision Shield Ethernet variant (SKU: ASX00021) is illustrated in the figure below.
-Ethernet connector allows connecting to 10/100 Base TX networks using the Ethernet PHY available on the Portenta board.
+An overview of the high-level architecture of the Portenta Vision Shield LoRa® variant (SKU: ASX00026) is illustrated in the figure below.
+
-### LoRa® Module (ASX00026 Only)
+### Power Supply
-LoRa® connectivity is provided by the Murata CMWX1ZZABZ module. This module contains an STM32L0 processor along with a Semtech SX1276 Radio. The processor is running on Arduino open-source firmware based on Semtech code.
+The Portenta Vision Shield is powered exclusively through the VCC pins (+3V3) of its High Density Connectors. These connectors are designed to be used with boards from the Portenta family, such as the Portenta H7 board (any variant) or the Portenta C33 board. The power is supplied directly from the connected Portenta family board, which acts as the power source for the Portenta Vision Shield.
-## Board Operation
+The detailed figure below illustrates the power architecture of the Portenta Vision Shield.
-### Getting Started – OpenMV
+## Device Operation
-The Portenta Vision Shield and Portenta H7 are supported under OpenMV. In order to easily use OpenMV download the latest OpenMV IDE **[1]** and follow the Portenta Vision Shield official documentation **[2]** to learn how to create OpenMV vision applications.
+
-### Getting Started – IDE
+### Getting Started – OpenMV IDE
+The Portenta Vision Shield and the Portenta H7 boards are supported under OpenMV. In order to easily use OpenMV download the latest OpenMV IDE version **[1]** and follow the Portenta Vision Shield official documentation **[2]** to learn how to create OpenMV vision applications.
-If you want to program your Arduino board while offline you need to install the Arduino Desktop IDE **[3]**. To connect the board to your computer, you will need a USB cable. This also provides power to the board, as indicated by the LED.
+### Getting Started - Arduino IDE
+If you want to program your Portenta family board offline, install the Arduino Desktop IDE **[3]**. To connect the Portenta family board to your computer, you will need a USB-C® cable.
-### Getting Started – Arduino Web Editor (Create)
+### Getting Started - Arduino Web Editor
-All Arduino and Genuino boards, including this one, work out-of-the-box on the Arduino Web Editor **[4]** by just installing a simple plugin.
+All Arduino devices work out of the box on the Arduino Cloud Editor **[4]** by installing a simple plugin. The Arduino Cloud Editor is hosted online. Therefore, it will always be up-to-date with all the latest features and support for all boards and devices. Follow **[5]** to start coding on the browser and upload your sketches onto your device.
-The Arduino Web Editor is hosted online, therefore it will always be up-to-date with the latest features and support for all boards. Follow **[5]** to start coding on the browser and upload your sketches onto your board.
+### Getting Started - Arduino Cloud
+All Arduino IoT-enabled products are supported on Arduino Cloud, which allows you to log, graph, and analyze sensor data, trigger events, and automate your home or business. Take a look at the official documentation to know more.
-### Getting Started – Arduino Cloud
+### Sample Sketches
-All Arduino IoT-enabled products are supported on Arduino Cloud which allows you to Log, graph and analyze sensor data, trigger events, and automate your home or business.
+Sample sketches for the Portenta Vision Shield can be found either in the “Examples” menu in the Arduino IDE or the “Portenta Vision Shield Documentation” section of Arduino documentation **[6]**.
### Online Resources
-Now that you have gone through the basics of what you can do with the board you can explore the endless possibilities it provides by checking exciting projects on ProjectHub **[6]**, the Arduino Library Reference **[7]** and the online store **[8]** where you will be able to complement your board with sensors, actuators and more.
-
-### Board Recovery
-All Arduino boards have a built-in bootloader which allows flashing the board via USB. In case a sketch locks up the processor and the board is not reachable anymore via USB it is possible to enter bootloader mode by double-tapping the reset button right after the power-up.
-
-## Connector Pinouts
-### JTAG
-| Pin | Function | Type | Description |
-| ---------------------------- | -------- | ------------- | ---------------------------------------------- |
-| 1 | VDDIO | Power | Positive Reference voltage for debug interface |
-| 2 | SWD | I/O | Single Wire Debug Data |
-| 3,5,9 | GND | Power | Negative reference voltage for debug interface |
-| 4 | SCK | Output | Single Wire Debug Clock |
-| 6 | SWO | I/O | Single Wire Debug Trace |
-| 10 | RESET | Input | CPU Reset |
-| 7,11,12,13,14,15,17,18,19,20 | NC | Not Connected | |
-
-
-
+Now that you have gone through the basics of what you can do with the device, you can explore the endless possibilities it provides by checking exciting projects on Arduino Project Hub **[7]**, the Arduino Library Reference **[8]**, and the online store **[9]** where you will be able to complement your Portenta family board with additional extensions, sensors, and actuators.
+
-### High-Density Connector
-
+
## Mechanical Information
-### Board Outline
-
-
-### Mounting Instructions
-
-### Connector and Component Positions
-
+The Portenta Vision Shield is a double-sided board measuring 67.07 x 25.39 mm. It features an RJ45 connector that overhangs the top edge (present only in the Ethernet variant, SKU: ASX00021), an onboard camera positioned near the center of the board, and a LoRa® module located near the bottom edge (only in the LoRa® variant, SKU: ASX00026). Additionally, the shield includes two High-Density connectors at the bottom edge, enabling quick and efficient integration with Portenta Family boards.
-
+### Board Dimensions
+The outline and mounting hole dimensions of the Portenta Vision Shield are shown in the figure below, with all measurements in millimeters (mm).
+### Board Connectors
-## Certifications
-### Declaration of Conformity CE/RED DoC (EU)
-We declare under our sole responsibility that the products above are in conformity with the essential requirements of the following EU Directives and therefore qualify for free movement within markets comprising the European Union (EU) and European Economic Area (EEA).
-
-### Declaration of Conformity to EU RoHS & REACH 191 11/26/2018
-Arduino boards are in compliance with Directive 2011/65/EU of the European Parliament and Directive 2015/863/EU of the Council of 4 June 2015 on the restriction of the use of certain hazardous substances in electrical and electronic equipment.
-
-| **Substance** | **Maximum Limit (ppm)** |
-| -------------------------------------- | ----------------------- |
-| Lead (Pb) | 1000 |
-| Cadmium (Cd) | 100 |
-| Mercury (Hg) | 1000 |
-| Hexavalent Chromium (Cr6+) | 1000 |
-| Poly Brominated Biphenyls (PBB) | 1000 |
-| Poly Brominated Diphenyl ethers (PBDE) | 1000 |
-| Bis(2-Ethylhexyl} phthalate (DEHP) | 1000 |
-| Benzyl butyl phthalate (BBP) | 1000 |
-| Dibutyl phthalate (DBP) | 1000 |
-| Diisobutyl phthalate (DIBP) | 1000 |
-
-Exemptions : No exemptions are claimed.
-
-Arduino Boards are fully compliant with the related requirements of European Union Regulation (EC) 1907 /2006 concerning the Registration, Evaluation, Authorization and Restriction of Chemicals (REACH). We declare none of the SVHCs (https://echa.europa.eu/web/guest/candidate-list-table), the Candidate List of Substances of Very High Concern for authorization currently released by ECHA, is present in all products (and also package) in quantities totaling in a concentration equal or above 0.1%. To the best of our knowledge, we also declare that our products do not contain any of the substances listed on the "Authorization List" (Annex XIV of the REACH regulations) and Substances of Very High Concern (SVHC) in any significant amounts as specified by the Annex XVII of Candidate list published by ECHA (European Chemical Agency) 1907 /2006/EC.
-
-### Conflict Minerals Declaration
-As a global supplier of electronic and electrical components, Arduino is aware of our obligations with regards to laws and regulations regarding Conflict Minerals, specifically the Dodd-Frank Wall Street Reform and Consumer Protection Act, Section 1502. Arduino does not directly source or process conflict minerals such as Tin, Tantalum, Tungsten, or Gold. Conflict minerals are contained in our products in the form of solder, or as a component in metal alloys. As part of our reasonable due diligence Arduino has contacted component suppliers within our supply chain to verify their continued compliance with the regulations. Based on the information received thus far we declare that our products contain Conflict Minerals sourced from conflict-free areas.
-
-## FCC Caution
-
-Any Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
-This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
-FCC RF Radiation Exposure Statement:
-
-1. This Transmitter must not be co-located or operating in conjunction with any other antenna or transmitter.
-
-2. This equipment complies with RF radiation exposure limits set forth for an uncontrolled environment.
-
-3. This equipment should be installed and operated with a minimum distance 20 cm between the radiator& your body.
-
-
-
- Antenna manufacturer:
- |
- Dynaflex
- |
-
-
- Antenna Model:
- |
- 2G-3G-4G ADHESIVE MOUNT ANTENNA DIPOLE
- |
-
-
- Antenna type:
- |
- External omnidirectional dipole antenna
- |
-
-
- Antenna gain:
- |
- -1 dBi
- |
-
-
-
-**Important:** The operating temperature of the EUT can’t exceed 85℃ and shouldn’t be lower than -40℃.
-
-Hereby, Arduino S.r.l. declares that this product is in compliance with essential requirements and other relevant provisions of Directive 201453/EU. This product is allowed to be used in all EU member states.
-
-| Frequency bands | Maximum Output Power (ERP) |
-| --------------- | -------------------------- |
-| 863-870 MHz | 0.73 dBm |
-
-
-## Company Information
-
-
-| Company name | Arduino S.r.l. |
-| --------------- | ------------------------------------------ |
-| Company Address | Via Andrea Appiani, 25 20900 MONZA (Italy) |
-
-## Reference Documentation
-
-| **Ref** | **Link** |
-| ------------------------------------ | ------------------------------------------------------------------------ |
-| OpenMV IDE | https://openmv.io/pages/download |
-| Portenta Vision Shield Documentation | https://docs.arduino.cc/hardware/portenta-vision-shield |
-| Arduino IDE (Desktop) | https://www.arduino.cc/en/Main/Software |
-| Arduino IDE (Cloud) | https://create.arduino.cc/editor |
-| Cloud IDE Getting Started | https://docs.arduino.cc/arduino-cloud/guides/overview |
-| ProjectHub | https://create.arduino.cc/projecthub?by=part&part_id=11332&sort=trending |
-| Library Reference | https://www.arduino.cc/reference/en/ |
-| Arduino Store | https://store.arduino.cc/ |
-
-## Change Log
-
-| **Date** | **Revision** | **Changes** |
-| ---------- | ------------ | -------------------------------------- |
-| 20/11/2023 | 4 | Structure Updates. FCC Caution Updated |
-| 15/11/2023 | 3 | Updates as a Collective Datasheet |
-| 13/01/2022 | 2 | Information update |
-| 03/03/2021 | 1 | First Release |
+Connectors of the Portenta Vision Shield are placed on the top and bottom side of the shield; their placement are shown in the figures below; all the dimensions are in mm.
From 1fee079de1d9eac13785125fd875199ee250efcd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Antonio=20Bagur=20N=C3=A1jera?=
Date: Sat, 31 Aug 2024 18:31:41 -0600
Subject: [PATCH 03/11] Content update (datasheet)
---
.../assets/Vision_Shield_Connectors.png | Bin 0 -> 109374 bytes
.../assets/Vision_Shield_Outline.png | Bin 0 -> 51246 bytes
.../datasheet/assets/Vision_Shield_Pinout.png | Bin 0 -> 274940 bytes
.../assets/visionShield_connectors_bot.png | Bin 95107 -> 0 bytes
.../assets/visionShield_connectors_top.png | Bin 148245 -> 0 bytes
.../assets/visionShield_mounting.png | Bin 54533 -> 0 bytes
.../datasheet/assets/visionShield_outline.png | Bin 47740 -> 0 bytes
.../assets/visionShield_topology_bot.png | Bin 35806 -> 0 bytes
.../assets/visionShield_topology_top.png | Bin 43883 -> 0 bytes
.../datasheet/datasheet.md | 119 ++++++++++++++++--
.../downloads/ASX00021-ASX00026-datasheet.pdf | Bin 0 -> 599567 bytes
11 files changed, 110 insertions(+), 9 deletions(-)
create mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/Vision_Shield_Connectors.png
create mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/Vision_Shield_Outline.png
create mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/Vision_Shield_Pinout.png
delete mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/visionShield_connectors_bot.png
delete mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/visionShield_connectors_top.png
delete mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/visionShield_mounting.png
delete mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/visionShield_outline.png
delete mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/visionShield_topology_bot.png
delete mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/visionShield_topology_top.png
create mode 100644 content/hardware/04.pro/shields/portenta-vision-shield/downloads/ASX00021-ASX00026-datasheet.pdf
diff --git a/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/Vision_Shield_Connectors.png b/content/hardware/04.pro/shields/portenta-vision-shield/datasheet/assets/Vision_Shield_Connectors.png
new file mode 100644
index 0000000000000000000000000000000000000000..a1ead19cbd7f69a01e67eb063dca3fa7c87f5705
GIT binary patch
literal 109374
zcmd43^;cEj8!e0?ASK-hf`oK;DJh*I-QC@#fHa77E8X2G-7VeS-Tkh^=X=L^|A70$
zJ!7E5bI#s-ttaQ4>%ky788Ku8d;};cC}i=^!U|AOuWX^9ph;fCf_JQ2={Uh(@HU@S
z?V+I19Uwn17LABqz?*Om;?g2;+wd=--f#)-L@hu;y@L`L{-orRyuaY=68&Yd>*VO)
zx!^n0cMgFtNWU==-(r=0dr68t`IVNI`Zwu^@5nJ<ugLu*F-cX1RehL~{XE5e(b^{u(r
z{U{FP&%UrLRtS7g`X#M9Xk0URFGYse+w0r-PRGsFlnSki#Hio%#XU2?N0HP+oso_e
z300e~>AkIWCEs7<#Qq;-!^yc`x&GXaeZUp
zC|(v=t1fN6VoZI@7f3@OqR*6SNFlRmHYvsULZ%S@U}t6z*6jX)%?LT?*?_s+ISf?6MBQx@<>Q4dzJ|0B>NoZ
zL&zY8*5`F9QMDTAoSW}qw3`HyX$XEO#>cj0ernp`*wvpT`tWy$>(27Ow0J2(5+0Z=
zgcL7iZXvEfo80d6hyb-NC?{VhaSaXkZN_hAYhw4A~N<2S7zZ`v`lBYdq
zV5J4)=~I#mG@iildXT!+^5NIbvWwieaSU+EK@jsMXEYLVSj8bum1$emz{&bI$6c;o
zxY#r-)M{GITX7IYTn)g*-5aP_xRzR0vB6wa?qf6=>kv3h~eh>L_P
zO%ckCLcpjO^m)C!LEF&jZb-`G9*W^wV0&fG)s%Kw
zOURi_PY5G6U2}$V`L>sIc(aWVUtB7zp4GyM|3Xi8sv4(e97J^HJ9`wK>I0qOKNhDJ
zL{clG{|d(gGc&t7#8k_EsN_iz!-M2Xj(PG`*VQ88ryGKgAS;*J>~^)8Il$c9H#XlD
zt={L6`ZF%2GU%3^HvcQr?}MO_kOU(x)~~p&xzqIHo}S-{tHzaniWP?p#}<9rv6mT&o8<%}io(||N7+eQ-OZ3zoerJw-&O_YwU#|X^X{6=RUX$!j>=j%m-|hH
zcT3$;DJN`H<~32KXUivUt%$gPbzcAJ<$E$5rAZ0m+Ogw-!JAWkoS^i$pCQDyoR%zJ
zo4yd?`>VsM6P_zsU~Z+~BXnh_X-C&rj+h1VVqNO~?L1UDHcP&`K=zScOlg^!gSS0X
z+Jb!ASQv^G!sSDUaa7mYW={W1EGh0JF{am}OUNO_d8yVX~1LqBT`=!isWyvC_q
zaq7=DSBGmeyvXrZB>HqHGG}kj32)GF9Pa~-MWuBvf3SI6_Y4-QGXFY>(A-wXrGywr
zLEJUvW?z-be-z~@q{O?wZO1>5{Q%c>lB1D`d1`n)D@S`(pnt5#w!T%T&45{#If?Vp
zV|veat=zEup*tZ|yT%9RN?Nbao@11?5GnX-n)7&^l2>3?gkLjG<{Lq%CA1hT|hcL=0&Ro_2CPm8btL?C$D6#R7XT?o25)DUS~zc
zzI4PaP`K7v?}_KbZ3zv%-LPFyAg;NIQMWrVod__D~f-eLa@sZ}iW#BNMZ+7U8mDGb0E0adqq7Z5mmN!|Lw=eJfMZ
z5Fc&)DT1OxwY-Kwf%F^;l*-^R4mU6jfV#s?)
z(0%ILOK0?ao5p+hdU!}>_)|cFS`m)|gD023fphdeQ7r8I@%9I7>jc48#|Xw%Voeit
zjPEl_tQcKTs954s8k&h!JAzY_?R6J_@GNQ`S{qTa%df+yw$b*yaS%AX+oIaF4O@wC
zaP=9|kEX>NkG&5*zpla@?BHrXF*d+tV%r@V(dXSEsmy9c=H)hHQqRV;S$O~cS}cyD
z!!JI>2;*%7KQ;4@+WJA0@hqC6fTcbmmTLVweIjBh&4ITi7r!wzKVX1z|Cmn;3yjLO
zv(EXVO?;Q<7tWFFYGFZXAxYM>Y**(HgVxs4(oyRsn|#ie$s>#Fhl91E_z2{DG`bSK
zk!vT7vHi4pc0Kk6C$IL*DI?p#XdV-nF_UF7N&-8sx?d*TGwwsbA&>3F83TJd6e7_}Q+QqW_4W)B6PYC$T!ugieEUflVI
z>`g4pl4s}sOvQ~!#|EWkIK^|}Q+0haxVAwOar~J7FfFt@YP;Rw@%U&{PoY-IBiTIm
zJ20p;_qCub#&Ytza;l<4WrjqqRnE4>jAlN}r-H_q@%Z}*_WgKMkN!1YN8^HVSWaU@
zg!j~>=d3S=f=H99(@ihZa~8tiyHkna^o0r%M(X!D*+6%XzF+5hVNZ6#CfLt6UwV|>
zjUr$O4V&-0BbHXplw-|uPij?P1qV;@?vAqg?$8-Q)-BREL+tbe$TBv;0wvxx==ZUK
zv&l=%ESe2YSweOf6|^B35SW$68_LFGfA{y0HFrGLyYZHaCAB#Su|So{jgOOWqb?&0
zE}-8Z?k}dGQeaC!8lmA$VTno_ieJrUb%S;K%nthntvL}K{nt_BPl}&0y`29bnR3PS
zFm=P#SdU+g-QoA^fx&(3V1@TG#zTMZB>QddvTX7Kcp0*);TweiI`uBffMzopRx(
zLbK#meVK9LhJdw~lsr!2=-DRG^^8CB7kCNOJmEeI8~a}=shW*xQXZ9f5#3=^Yjn+V
z5QM|3M;k)*HdVvPnnwW>-+v-oRS({23Atd9KIM
zT313-nClVmprZ8vc?#;P+R{+Gyl39ll)DiFmpaE!Whhi>g*`ITWEjH5`e+9J)K-p=
z$*oTG>?~Ud3qPwBb-ycf;l#`g+3D&
zSrfPCHebkaA5fzLOnNUpgJdOBj(*Kn*2#pN2
z6sWMg;vZwN|4`}9D<;l|G%?CDFk6F#pHl
zGr=LJhViPl)|3XSJ#xl*d%Ehh9_46*(^8_|TV6HSQ(DI~X(oQuDtopM&3Dp(
zXedPz{@K-LBQn9V8?pBBI`od)17ts!D@8cf_t{>}9rr8L!@4}Wi;SX2x?$T*Te6Z5
zLhJ#eXkXH^WQ|DINExAJzS0NSX?pJoQp`9pEU!ikA7->qS@EVu8L!5Znnlf5F*u{t
z1tiT*QqHR3MG>OFZ8mjyUN!fXL$jBP$~EX@rq>z!*@}A0G_0kmE?EF!hU>|ZN!&3x#1FCW
zyIX86D8lC~vz!`|>Yhe*=SS=CPMGAg;#>77?VTx{pd??p3h=gjMzt7y{rsMLelm`r
zUPG#477Z7H`SV<9C|BA;oJi7})9zDeTz1?xe)k{(4B06+`aH$7%~9(RcN=hbf|@G!
z1FPmVv4Dk7TSg}x!e4%Haf+NL2xaoRwBl<=<)YG%kSJ>qG2%+c4;T#?u^2_cLlezk
zN;wrJ4w|D}ZqD*(Qy5DsXaKU&t$fY)lZJpg#SeLE)Aj=NG
zXgsZV(`s-BP^}TIR_}3-l-pXarjr7K`;M3Qo}q;l;F5RD_1un$mFa89&ZozS#HTIf
zR36th&iDcDrEfL5co-V{Pa8j8DL{;yNvc|^@_5>B)@p`KLe|l~@=vwV#@V{KMIZBM
z@GeEFp{3!dwr7x5ZRO+Qu*dD>SHk9H`o(J}qBL3j&fok~BUwU}+}aaK-%wgQD3`oi
z5u1|GR&9TlZ3=05*psLlo6Xwk5f@_9O#Va_i`T!d52^MM3S<@5ME@0F$Z9xn8kP7q4m@N&RHtSwdG(#E_D?59c2*N>86B50
z8cDfFOJ;aljeVKJXkW-hNjY47*N!)Et2jnE1n*8IRhG}e;Vi?dgLf^R-%
zf9~FR_mRi!+KvBrYv8CshY7QO-o*Ds{YA=22cDWxZPClbr_-A;U59%1!~H8r6+p{-
zx$553KJ328bs0k-=EW{{nR7D7P@sC+qUuq1{I!}kxi6|f;j`=c+ePfQkH
zjWz*GJUkbBuq&U8gcE5!P#ruiT;tFRI?rp4yQQi!i|4(DHP3fuzDd$s2rnd-35$rL
zzm5CoyLnK1TOHtfaaQNSolPmCIo*z8Ewdg)$A9&kaHI658*Bf{Crg+3uwhMM2|76n
zm(hPRyMMuVJ3;5w6p?btthiUgKN?8qMn@tI3gvyI`BAHOVKP|`J+;J?d@|l*ym%g|
zp*rQm=Ztek5w3Ti4DB-HHICuh;Zu3i|p0w
z)MM9WezbH7ZIxrqcu)4rErn>cv)esV=cUG-%J~L|Ma|u;94?ctNUPsmtn8mV+7bpg
z@@hf?D=5X+@;ONCQYwX@#bAiG2ffb%V8Ean6lD~#@W
zDN78OQ+7u8*{MvfVXrt0+#)|wLiLZBlRnj7lf|x88G^~{zPu-WksL5{DfWi^*5#Eq
zS2nNT$h46Liyo=IRdE8+!PEsaH1tLzfnG2yznQC)dA*(eSpfNq-lt!CpM)uvwLZ
z)w|cVK~3GI^M*^v>=XBXPq~b%dn!pK
zPnidn#;4VfDwE85b5M9Pl(*VBG^z2v?NUn{_N?6B2mVP=>(-S6Dp;
z-iUO1monm>zf<(l1op3N*@T#&VBEd+-BpWS`)0bTA7Fg^YwIVD1z`UJ{BB5*K}rIb
zrPKO6pJkd$Y$b3V8BBz6eGVAi#}OoK!r+X*olTF?y(b~@N`*r5`PS31i|N?vd!X}%
z-}z4{RR>xg5)uV%wtimu%5<+Rf6#B+vo2vM%)_m#gPUYWQmIyY_9H6%S9G@Gta)1X
zuiJFWkBxDpuIK&jFr+I&7~Ua#m_KDp%ew#8L`yMPi#UDSBAbx3`AVOT-fFJaq%Rvn
zO9L@&jelv|&|WZ#py98Yzta6|(DYdRLgz
z*@)lUi3BsPL9Pp+G9}nc&wW02_byzmI6qu%=or-9YD>un)W1=^4Cd^%)fgp~Jd>rD
zKG2M)3#aHqG=?vAmulkD>2cvpl6)ZblZ3T-QqRF`y*{6_f31JhIjXE1l!|9*|5*bdSnad?HPhX1Sa{r738FG#$6>@H@;d;
z8I58^0n;!OFSf62DA4=+@hl;(?nBI2UCm(|{mu$dsE%kwNimzgL-Jl)krMJaZKl(W
zBsu$nFk{AVB7M$&ohTyoUty+fV@Az~BkIXq)U%*i$@ea7PfjCD&u~4tPa34;4SKNO
zAM+8MLFt*!?bw;cZ2qONh84)7&B;Y%BCBceQFJ2tSh%$`bbQzF6IJiG&7DTqf*Tvh
z{1va_)?>$z@60+5rksjNyHSOHP1<$8QH3rIZRR_Hv_fcgRW@U0*@cNH^Fud(5qFJv
z{a>+vGXF;A>rtc<{AgmMW~^Jw6oi}vuWr0ybB^8
zcdz)qZkmc0&?j%*Yz$YmQ|TK{sVaGFW7avfBcck^jDbwH6k>ECT)muMAW>dscSAi`
zNE#_IXjBoInkv)&1DU4T)|sE(`89UP%|L%}qt$-E*W*_6@fj0nDaW13J$(FRJ#5L=
zW^L7a+L#Ra!MesXa@N56xiEchn{jEJvlZ)to~3iDBX2LBgCo;V>*6!t1KQp$9k-rO
ztiR~0U)XWfT#LH2x80hv2~a7GfATuNUTVOk!M@o>gu&_W}
zVZlzIs%q?!kMFQQXLLM0E--rCrCwWRPJ^C77auB$Bnl1d`=Y&U?Jpk@hd-Rx>YD9)
zm&ZNNS|-%ke<62A7V4D`?b;hfMs0tSTpgv^iAYUtm%Oi+I*2+_j?3Qpt@8w&dTT#)
zbYLYEy4|4>1$+8_g>}x9iHFY^h0;PHawfTpYw6F(;9tfez$I0;-CKAtQM(si7^=pL
zI60RMt2>D$*qNn{G?5&=5EYUqZq#B})W70B9`6n%IN{YkviBtk&D6TGH=c`flUu=D
z{Tx%J-~ERFW*tMz48OM-F9E}LcM;#*IN4C}s0!;}EViA_J;0}k
z4Evp}SuXQx;+;pJC)FJ4o=B`r_vh5|ziPSqf7SMk2@JFC$)LGgX_wT6eDb$hPu+
z^C|Y*;KuI}ufPQYl#^}>{ZRpa@BT<&1eYe4MxR!nUV|<|`J_!vIA)J^9k-fdp;}Re
zXJEF=%Vi;c<72ucwdNnF#%k%vgj2&A(G>*WArheDG}psj89+y%T;}0QZJKa1-Gtp{
zR^wq;ac^Znm4s>aS?GC=v`qjHbYntCkY{ly|
z$U5!GR`b&p&|4F4+M}8x25Fj&57Wc;`^)qZq?gM{hEGj~F=}{^*DXjkd`&%A4q!;l
z*s>-%amH60yT~Xy(BA5GS@y4vq|#ZaR3&fZnHp@)ov5|tECi)oLf206Rq6M8TkjW93xu
zn-|4_T(0aA;&2@HfQ(;N8?Q|F%S59DdxEq`&LtY!w58&(+puuK
zEpT3tGJAxRzVX6U%WD}yX4GGz6;nB6eNpy!lR<$j{+-q~H$ds_xag`r?
z8dJ8I6_-&5oZ4W>H@y(YsY*ZC(5$UDcAjO+`{a^aWf4J(^X$Y-DKtkDwHExnn$6{&
znf`3UyKBpt8W-eyE)2L}VxPpqGFGcg!TeAEXBNPo=6x!0@4*2E*Mw^AX6fgAkwnJz
z`V)L9zb_%AtI<^ck@#@}f9J+CTs9+dt}WViFCXp&7ViwLMlBxKSWFs41@pE4ei5QP
zJ}oWCb8l;s68>i@@nE($leqTI_=qC*;4aK?$t`5@j5sMs@gEF|mXwM|HeJ>uhm{
z!9F$p$;`ZkI#6eS}Re|`I*
zSce361K)+f;#uWxh)R6x;#7sU|;y0KV>N_j^@oX!wb3Vp=R9-Chu@*86dP@_rA3z`YT6y0$`Y=E
z)R0J0xzM=%Xl|zI2{oY(hBH}9>Q7|Hzg%hG>_Jmc)vv`(D`vB7;qQ4n6inGMl>uga
z*^FeRlYJ;%!c@|EKzmQ(pH-kRQ)!6fj$-&zefh6pDLR^ZRDIZR&P0~xw(Hu3gOz+z
zt{h^{oceT5>!3zT$dQYG$?TQU|GP-US>h5-A
zkOPvu0hYIWh4Q11i83?wzqN#NrWKr
zzr%Z)w)dU_UUPtcv&Cpe>y-XLTUnzbp{T%$npw&a3GFVvIy;3z94i;0jur4FfWtmp4g@qx(&BO9`Y!=O$Tn(W)Cj?u29|6_1+RQw${9RH_-uw}veBP&uK2Fswoja&jMabxGp1y|}IxoV9;TUZ{e9YI~f(jAu)O
zQ^4<~rHtw6>AA{9_*-e-{8JkC$P4w38OlX!-{`-rlL4md5gi-b^&JK=p2M1GuG(^K
zTvmXbii&E)Fed40(LDl1;Qr_OxCO)_Gp;Q+e=MlAOCT;X-p$c#)ueGr&aoW
z;Rvg+6K8J^$Vxv-NK2EGllzN=V3#=`Y1!G?_4M~={Qm9p{rmTiabM}BC@|>bLiYD9
z$}1|wWo6-X1{2u^lDVRek8Rr8+k?WxDcIR#vFX%CDvV{DaAJJ`(X+$f+1a60DfKyO
zc}k^Iul^YmBO)X7#^2u`SYXYm0UiZ~5`yBgVhjHLQ<^MPZBJw~k7u`>g@5|p+1WW-
zZYb$?xi8)w{x&Eq4B4R$i!%L%rFCscNJNT^ArnmfJIK0O?jEj|#Kpx)z}goYoTE}w
zq_wn&z%wv0F_%wVUTW%PEjw_Bw5LGBy@4uqyD-a^P1Cy9;-sbyuC3)%t1@%6Y6i=d
z4}8DX_+Bi$)a694`RUP}-Dush+##j1lC|1;Nv6f?
zVY<$q5)uZRo7lsJR0X9JG&CVQ<2iA?P1FjXKD__~Yg>Ddw_4Y=F*ILO&$T$|>BG4l
zcWsWBKbcMBi>RomsKzpU`fW6rc)mTFp>bG*DmH{yS6A1mD{W>*osf{QzP^t6q`zsy
z2{u1cK6fyE;8b2-K3!u?4AmdUVB8l?Md{CTFk6)&7D1$8+ll2D5CB(e2Qg-TzX_`z
zBW`fZB#;g9$CG8buYAzy&LY
z3MUW+kgdbR!y7sc_Ze;U#T06{G)o=f;p0oFsNgCWU=>UR&sc1hbrb22{Qjg;^u^sc
zq2aJTBu_C1wjK#QK5td#B2^!la3D>f#f9sOva)hstfHpZ&Bp!pT7;pBV`tCMP_}OS
z56XdDD)@p4x3S5WMQT;6v*smPLIH0&Iyx|0oF?+WfXma$^t)pnZ|uUyr3mwWfu+@5
zOsaF)EJOA7_R^|VZb$EVEm%3{&Ed0}pjysWQu*f77Mt8d;UhxSjTM!@|gaLvX%wg^~1+H*fn!{s_rlKTZ~@
ztCkzUpKT2rPZet#7#c<cW@9{E(@#M
zf*k_`Lr6(U>14A5_;e+|pg4bwQWnybdU|QG5x;8K!hj!<-;yUu6J{HrY@j&ck$Qp5
zS9n=vHj(cA^mu->^yGJBY-EIvhllq&pSr8ob}gP!_xo^vJ~a-*MzeoItIrV8e{+_n
zz&M$htE;OoH3jQJAO#9OYqNK0aB>0W+G+7SL#Q8zRJv|$*}U5G_tC&}z#w9r?-JjT
zuwI6zhbGCh?Fq8|*LgT)2*+g#~Jbx}M
z^9c;zDcQp64K;*TJ8qpW@Ka9uvCmI$*`bHY5L)4+GOOxiiQD<=EV4Y~4&m?LAOnr3
zZ4CGW*T!CkTcxtob|y6LMekj`q)^a>`br~zmNzCmOHn<&z}!7t@4j!=@bx1SRND-<
zOqIKxnxsmb^|Zi|V-&s5dR_$C=j{(zXj~jB1U3)baW2<=v+-v&$4kayjHdG3Lm#L9
z8|YLJ1TAVkSvP+)^3Ph@YPQiI&T*WxTm9iv!$iIRCTii|K)yn#_pW^7Ew8|#m6{mA
zhxxkbCpvH_JYx6^B?6;;F2TsBz0`*=w+N#)ewvWgqvck9@ofz%kcVh!@UW0u%=O-e7&+UaEh6AHBWKy`n
zx@~6#B7%bQ{+j(4xA8#JMWYf63JUV`_fNST-usuQ_-*3(v7Z?MS|L>!0*FiI&KQi2
z6#bR>|6gRBqs|P_Woyh=E!EclT~Z2xq6$O!99ABEM*(06quy~3p;+|4ScA+FN7^|}
zeEFJk`YOMt=Q9$l5EL~yd5+942A%2~{U_l*NNPsfP1e~PgZ3nQ+boj}`TW#wnD6Qp
znC_;6L$J;4laP|i{92;*jb2D%c~ae)oRyVz#4tJum@nnjFCTO~D5d9_G168El5ize
zP)jSVm-t5vKf^m5%w9zIhvoljNs}{V#jnaMd*14`Feo9PVFJU$`B(M;b_1)%{{24-
z;X*8w2X(PGC9tvw0O+r%C}^dy{~Yrk;ux&o=2OMEVcu`*A|oST6#j3sk&ulbj8vIV
zVaVi;^(sBPVwL9kf_Ge8H+~rTkT&~&{P5pX-gU>x?HEu$hu2BK^BwH&{qn(zAlHG{
zD$DZ?GMx@)KgtK%Ki+J?)#5*Y9iAOzy)gA>&|jcZr2eZnkC5uB@Cocj)WwCftgP%C
z{eM9J`_Jclk7Y{}6e`mI7>wXRMY5#FrPvpxi9maMqp;@dQOgP%Drotl>e(!UcD#6Nv%RrRh05oa+|?*9TB)&^+CU*-Hszw`r8KZK+0(Ms%n
z-wK1Hfx2z?z3cJe4v*R3b(8zm8?Z*>Ow^q321Z7!P7R*TRx54(pt<`{NGC=MeQEsz
za0xCFY+6YYpF2BPcW!R3U2dPVXa-tDH^w$|@Rw{iBv@zw36XFa|8AMTeFF#J=7!vt
zn_Sfj3LwyK9uVQK!*aD-_)++;b$&~}TuyObT=B=z%EhF_*jQhetFc;;IIBny@a7-S
zkiLg&Y#Dha3F#H<;uU;aok^Mh})egxT{LeX$1Z#2cq+Uk^M(+cC0_;
zv`5cJXpzeqs5!s-2L~spkoo%t2RrvJ^eSekza$>o)wzItbiG~)0JKH+?=FByFQX`=
z^?H7iyeL>X(xAs-Pb#`@NqH_Efyq)NGUP@TGd;t@Q?moq6#V?DG{v=~ItQ`|%;Y+j
z|NG^fC(KnPJ({n@nWd$uQN116(n-`4V}RjBj;S@du~irkZ~pxT4T2tM$D$c!|E{X$
z4!o@25#i(SIyXe{p1y`$>h*9t5YLn$!Rwd6>&nbxJk+sw!R&f!@axwvkLG|uBTy>a
zj_|D-4%iEo3znvcaq#fOt*q$f929hp7Mq}N&t@?r
zBMLyO834D)0Q4gik0o1)4H=Kw4{&4jCUy>vICu<-5r7pHs;Cr3Asa!&ru_{zk}>*O
zLLyi&+3sgjlBAj%K8~h?eBNP&geo@kvD8TSZ?(N&4TPV_^k(qmV4&BygXL($_wb#=`u{*>8B)sfesT&w|)c@W*K
z)A|yW6YS++32Q(GJdRu8_UCF)GDZVibv{(Mi;0MwY$jR9USF7+nj*dBjs}7UL?%`q`Ge6C30BH0AE@+p8U|h!sGYg1fg!R*q8u_
zpxsF)PTY2V5C&zr(}7w`Y9KMM%g=+k8fYE%B-=U-s7~2y40Lo8kQfP%-orS1Qzcu(
zPuBt32ONM#{FBWUez~(((qgpxFK^y)N|T)1iW}AI@y58N_-?;qIM~=#SX5Lwe{fB5
z?Hc0%lun4q&~jMjabt&$fze-Hs30jJu?k8X%yPp~a|U1;oh`zd25;VSzw!Z_erzi7
zdbs#{*l@)E?ii)sX@9zPEK3q>z~$o}Di?u2XUw$r64W7J);=-Oi@(SvU4USeC!YZe
z2}r>13>UjJofkI7_qK*o`aul+h0w1+wD&_Bv
zL@_@t3~+H!r*zi3!f4g23p+@LKv-Q*wLFS|)5Hg>J0)2GO(hP)n!-VUL>y+D<&SB_CmhRcxJWM$189O<
zBp2>oO)AVLsDTP`ua>$}kjm#i24tdCw_U0qD8xgcgY-2?N1m2@KY4k9z_PRM)?ozN
zjZeDjR5vmIof)W=oGC*JbcS>^Kt?j?{Y9RclN0sxCup0(G6m;|!&&psng>4*506jG
z^{`Qe?bE~6*+I?H>8Kd-b3{q{oPDK_E4U_(VVNn@7dx>X&T`dryPpLmH=KxX_X-3O
z*bo-+g(kK@QfO!>#^aL*w^dDp@YBIP7CwF-NW`1-aoL^ODw>D8t1UoWKh#{xkOSo=
zIyxG`Qju)ru;s~%zJ8nZ@uI~0i%JrY^WnKUF}8R2@A-KRK|#U$dUh4g6q%Od{(*sW
z*E-va-3eE)$Op4wZP0iL-|{$}-~9Rc+3*y=ywP0w3^$2s|wK
z-(Ve7A|kC_jv)dLt4ynf`j4Zcw&XW606aGf#=XHug4ObVa0H}BeQi6SYIPxx2E1LJZJ23VW51zlmnlLfT50&NKrWFc|uO3|SF#a?IT_4M?t{%$j?vRnT9B9Yy4SJ54y3DDZ@
z?d*c%j8lTA_BMJc(+tiw2O(L`U!@oekwO7rWJ;2Kni3!-O?RP?F*WjeyJStl!BHbj
zYy~DO<23Bx3D_-;8>GEKg#H3G_c`&rpRT+&CWip@E1f$aS5u=v-v^+Y#b`hWU^`=v
zh5MVc8-Rv@x|`*Bcd6ktW4OMt0V$k|o>!Xa=;#oX;hDJOvOPi~8j36bN8eKQZG=`r
z-GWt1v3;EezrcFWzyM^apnoovC}sd@8jr;Y31B}mO3J9@WGTP}=4!0BPP&N!RF5DL
z`T-0Qpr|EaG=O`1c_0b2*!%%#{JdGv=6Ia;A(D0{i#H7*U7<_;bTmo)p0|un`zrYC
z7CoTwZqL`*|CU7O3Ie%jHdAg$>2Yx4qEcxhpFr63brE#6E(oaXx;O$I6TlE(Ad%@-
z%#^Co0#@*S&Z=SXNWY$s2nDnkN^b6Y;k#PE6)_o9X+j1+*xTC=UyE7;Wj4mlI)lX$
z8^}+tZM5Xx0QKRtoD2;QGmKJn0ySO3u9w^ckYBGV_)>=*1xRAH`of*KHIb2#*&I|&
zje+!G0l$Ma&k4cG0G^9Cxn0~_JxNU#Ya(I}O4)Iza1SZxSK?^7d;=Gzov=mlUE;#}
zels1U5GZx=xadnp%W4N^zs^XJ!bT5da3PxD3B5a?GT%y+eBPJ{rl
z_3qyyIRDw6t6_k^FhF8fGa~r)KnF%5%V>~e2B?W5rZIE=q)F9g8&
z-`mh29L@WR-bVH#vl#I&F1zl
z$_@Kt5%@HLG(QdyDS|n}^fkU30TL`YLhx(VIi^y1+Q~_CxjU#yU^AZ-e=(%(|KrCg
z=m3f}R+^#_M4o+98W6=@!2Rm&6X8njn<$Tecw%6x4k!+u8
zpQb2UJA5{O1V_35=513Nl|E6t~5w)s;~;Qr4nfSiO+=fUUwtM&v9O>ahU#5d;Sj
zNONXW#bM%66uRIH<25q!VAa}3&^ti8{Z{a`WbL6WCX
zt%|x^m0K0CmLCF7_ZaqDLy&W*=AkA)WrX&&@39q}Y;Bna*llfWJ{+qp0!*Y4_W_Ht
zWHE`^uy1+E`-yJEMIsBGh=}NBwgxoWcs6tF#-=7)kO;h2kbsl}LfQrns58$BIsI-2I9Yg
z@`SfA+2DLch`}p7xeACT0AQlk0VZT+!$j~OwG_BNh6d#@_DHZ>ArBJ}(}63+DF9p{(!eKh(s25)
zGT7Nku6|--&u?JHir-$C21rc%K>F(8gsQ}5a8MA_KMn~=$$sbW1z__ddlw+&C;@{?
z*lWgN&=U6W;Jv*%N;|3re@1{qOpQjD(QPML*w8eGNqBjAwePfAyxwZo
zJ22f4q6fXgqEYSuC0J{2b92+^oCPnk%H{r=3A8F-0GQ!tIos#cP*ho5z(I%YS!(ta3=oP&2Jy8$U8XN8z?hkxy$TM4v4OQ*kC(rVriZK2W$aB97>~Jt
z(8vXPNNT?sP+@h<%|kZ&c(3gk00Gec-tu2R0na1%Ja11FZ_>(fR<$w7djY}PhO
z#86`&{k#Bm)%dQN{!Rb;pn;gVfE&=>FzA!M@v>1hAqn;)L%i8b4YI
z5Cr2!^1A+7tKQz;
zCJpUiS^pndQV
z$pyvConn-!X#Bo?>HknM+1m?$a&kgJ{1xAf!o|e}(^WyBB~!ul+as|_)hwa6u`L&t
zY5@?xm5Md+0ALXUs&2^rJy^i;$G+sWejt4Rz;gie2Fg?KG6BTl^nT>!<>L#ZuOUN6
z0D=CY#t?gR0GkRyB8$1(jRWSPG-d82M>b6quqsgPsIG5r5fXLfdXZ>e1U
z;k0*jq&udKgcQxWhRux-hUUMZd@L_7``ld}wNyU%YmkV8^66pm
zOP&&i<1#5V6_Ana3dLiH&8lYegSCyQ_6@Z_*=<{Yp?19Ojy
zG#e&MdA|gvgnKZ*9%j&+nDP;XGavyQQ0DgRig9w_paEm_9-Q+CX8_5DF2L}+9>U;81YwHVJTiYMrI0o#H18~qPY0+XufEeD|-3{k_IFH7SNeWG2TQ~rc
z+Aam{S8VJLpe|zne>7bOJeKeJe^IisLT0ukWkeYzy+&3-NRq8&6fzow?42Ydm60+M
zB9V*`N*R@`h8ZPALzMFW-u=$M&pE$yPKWn>p8L7)>$<+h2zZ<`ULxgIaZ+|ozLKq_^4MHf?ZVv^^V@F4VuCJ5KeKLj6HAQAZ3L}sSs-uly9
z<#`Ys%+v8P@T=)acj(FXy}C8YkYz+yC$q6cl99KfZhSZkxK(z1PQ54e}j$
z^2`b=pGX*k!110N)hP~)HqKv*E%+X%RB!LzD03O*Ur*ZGrTq=%X=!O^L4aTO`-EU)
z0^>p6(C4>x%zO9l&Dt5fZpWEn^nL>laUfuDP$T
z5;hqVzhk{1D7b^_zhwgl_vZHkOey$`>!l=~T9_5Zj*0BNqQ2J5Jmcw%wmHAsXnMtW
z6)7qDs;a68E>nM`odsON9^>;UVFmMa6J)LzL^HLamhCRG*obNq+I81+h-d9)8)*eUxk6`q&bBA*6Fwe8RnKNW_LT~s1sCn{
zWhFg5lh6%)7@p!&*6+m)1-jn5
zcW>MDTdQ0RZOeo(=qtQ4W|pP4J1Q=@;KNHa-*_AOeI3`&`+{9cyNOX;=C<{{W2=RQ
zg`qiYvirR==oc60vgTZ!I3`uaZ{<>nepY4nG)M?h2)=~edGEL7P_-lKFjk^i4O|)o({AaPg%dL_#iywiXy{wJHRJ!mWe%Sm7YK>zrQmr0}howRPrW
z!!^+cvG71Ozj-4Bw&o#X?TOc4kTToK9Gc63(k~*ibdP=g`7^lWvY^WytmH4tT7)U9
zYA;bznqa3-R=-0|#fPvV@Hs#q(BTzLc5!xg9v*!Zr&Fc$ns@#B_02|t2Wso}Spx}9qI2DH(X-4O|GUz_l6ZWoPkob;GD;80&d%Qc)2`fcC44YGK_83y
zroCa03Itzpi6!;#diTKsZ7~jCrlYm~GhXkX@_{aFsM;gJ>G1H}N(L5|7I5hoj@&D1
zOA>aP9ezkKe6sC64A@l`rNi#Lp~#G*7azh%XdDq}$ftM&O^16#gX
z3=k$M@^yIjA#?As{a9dDXz7yxYT3FK_RM@NCgg
z@Og?gtAD~DG}kI{oYHPIT3uUvaJ#PIc|D1;ii$PgbEJBT(_3=Hz^?G#vaRC>XW9%J
zxEpY=Z@%Wt&&}|?u?7b(+pJN6Bt^|obU|o}zycqT&^U4FOlstW`TILB>j)pCVBbh-
zww_+ze1%*-K0qF)T*>Vv!@HoLZ`?h%D)X;K1dPJdx5stsSU)g>W9`?tnvzmwyQAnG
z-TL}^D?A#?F#J#_XNPG%&CJZLTz^yp~X^GEj2(&7oNINwwQmsDl%J1=h?SOeD*
zvK2cbx|DZ;>yMeCwJ2L30&oK~C^pNo)!DL@SjGW@h^VNjbn$UVu?jWq77hwW_Tn-f
zZ%rNNXDIzEw)Li1L;mN4ii$1RG}e`_p->n`kcCfrUW3VR6rxEZ2AR$M=(E$3;N*)<
z`RJ=Q_2V>2V=#x7>lxjs#$mV}p}FS(ldk#m-U3rPWw)2?YAh)qeAOzL#rBOL!RsL7
zg|mjWJ0=S6Ohl|49lYy)u61N|)bXT=BxelM%MZPomm{1Hr75@Ra*~#iyp8ojs9sVVQ>yG-xy`#_$p>;=e=UlW}
zsqgmT$LZ#MaSICzv;l0zz=|OFEoG0CEPdS6@u
z2k_C3H|M}b>yk+0n;W~0#KjCpjRa*b`Kk%swrfZP1I+CzSZ>8qXM22}tNYe{IRNyj$H`>Z?{wZ%q^
z1n-tm3;OtOolghb6dauby5=U0qP9WBJz7
zvoo32*R5{8;QM^U(a|w9MFmP^D^x0GrAQN;-9%t+K3hPpXY*f3y|OT!9xdC^+DcD!
zpT7Fjb?egP?9R@xC7)YzaC!#(X2+dNg>9{^){iEm
zZbfBp-n?0Ie)6hi@dUZ*teAb$-%Z*yG@Y~PPnYi~GB2h*bE8A{Jy_b=Z{I5P6t=Be
zwF(Q^*xa0_S+QMKVW?$LFW*dSTfsT54aNorGG0-9a&mG=gw`JglahkBXsD^o9jUbIQhS(LOj_FfSEG$
zcJ;dLywGu`3AXu7??=e@M(p{&VY|E8Btv*
zez0;6?Emv=U<=gk!_yakKwxtOp~k!O?1PYG4!AqLnIbrI3{U60Xc{s}O?7%x<99xd
zTkXaLaamaw)Mj_AIM)Nu-Eu-nI+C^*3Qqaah|6{d7&o67e1BE-M5{@=qJjd4v9a;W
z#N9|$An~eC&WWX{XkR=omdpSXXEWR=Mryas@(mVk=`UWm@O5wjHjy?k&|VWyxKlda
z_kgc)Rvd8ev&=V04NRK*I$@adIS3wckeM|eq0+0MhlHi2tp&6WXO$E&C4^b4_tJtefoOP@5A$z
z>y5Jz1aocX6rxPkT$M7<)!80UJQ^rGa{G3*p^;IzLH-@R9Bq`eT5(6fHoZo{{jSaJ
zuC>;*r=g_Gt(dSdItcd^XN?V~{w~!V7?Vylh^tIX)sv7$6=VD0r0MWKOH*tf(Avw}
zhlXU*#L5q|nDz`C35qK^$~pb6VvbfmqhH08ynig2hEk*_XkAO&^>>SYbLTy})BdwM
z5BcTNjMc8Nq9CnozmT~79~ky*Y82u7kfEP-QNU`a=TrB~
z9Z!n0*QBT%);BcNf+0X>u;zYsb^0OR&yQ2qM<$xXw=a47x9%=Z8=&`d4GlX(o~}rX
zi!%%zBk14j+xtDQ^f9$G*K8xm%VWomSsvKiYQAK&+j-sDN#6Y3t;Msn8){ScUj!VdF0>Z^mK+obL-*qtSeVm$HdB56b-{WzNj&eN;UFT
zqCx(1u^1-zQFIKX6GCNACQZuKtE>S50TfNJ+f_`<@9)4sVX^V`KIAvpKt>sTOq6U9{QL3@a}Kc+S6Q@uts5~
zRNB=h)3H74OV9V6!S6aAWac{md2CmS1auCiWkcgwH7MD^>tua)e7k;K%G-m2{#a!B
zcJEBi+v`2)bz@SUw=yDwO9Nv^_MO$X|GjNkj9dJtu;~VsV27;|6eUGDCAKN&>yN5e
zAFt;Id935+w(He17o@JpjP;Tc#l^*<4_#yube;675a9UkpXAm?h2o7GkTyvRI)J&2
zzU=`adrzaF{-02AX(%vkua;zrmOlPeoL4fmqD!5((s#XeC1Y!PwqLc^pS?z(gJ{}T
z8MSqZ?~DxQQ|}+ImUu$HwRFkmZh1M)dNwQL_kSv%uJ#KE*d`%^2e?Ou^XKRzW@4D2
z$f^&uSYw$)BqdjBzOPf5VAKaft6%zRNXcLnGUR%f^4J+TJ}ZV?SpFr;;s}_Cp5!*(
zkh*kdelJd5SXkJBNr>DnU=~(8Aw{JtvzmH425qn@7L9zFLz_8&HDZ%`aC7v0y_a5G
z%R6S;xuf?Ktb#xAnJK^e*<7In5wXnb5Eu3b2qcOooE#&QlWAX^+cZRjMvbs#4jnx^;o0{c(o;b>J3pVhboD*xJ`tWc(d5}$VtF)J4=(}i;KHc7P+w9quI29oGyx|ADDMbf5=+qT
z_r9{OZU-ypAP)z%yUqx{*rKGJh=}lOo62ZnM;Vti@pI$NcFP
z35$G}OT!&sRCjqVws<{d_(ktoeE;Fr$sZQZyAHh2d$#H7r4=Vk#=Uh}~ZP{+)hy
z3A$nb(NY7s3RY|O@891nn~$X90NsaI(OK{6W0_Qgh$CHBGk$caY(qJqb|rD|LEK5f
zOY1WG&~8y@r{l+yK);|8ZiHiAR8&+diG;gXldV{t5s(J1FK#3}ZsX)WVl_
zaj(Ah!OXLs!<|+}wtk$;f4ReL`;4=fEBO|3oP;ixSJ3QJjp!H}5&$VSJ3n8w(2q>q
z3efS@h^xA$#$l>E2hgPAB+Dx*>Sj(C3@Iiy5lCL|wkMqk2x!A2kzKbJ3MKI>@{k#TA(NWL?xCa*=9RT;&1GC7(PP^MSs&Gx|mwj7fI!E*z
z0JJe&GdHvv#SrM=4e9UMq|b0FLScJs)Z6VAJ3pLIyXFQ?|RpI34WE*-Ud)-
zIyF8M>|9*t!~cdC7ucf>B^uS@d-tj;1*8+#?rfTIpHrcuW$#~2YhP*wX3%raC}|HK
z2)#G>v~lXFyZ1;dkI~dwR*N^bRB_)x$@98-4`HF5Z4(Y2uTClq9yZK3leMX4$HFOZ
zyn!sDb@}TB-Qr$H$mEB6|8m4Vss;jm{pQWLp!k%OH7H-AK(&llcV+JiV;2%y4I(PV
z>7VVl&h|lL+*&yb1vN13ZY^`)
z^pJ94pO<|F@scrBpo1aDs!#-mq#WUGj;4fjBUxA~K4x^lA
zQL&9&yu8s+aw!zTx1q_;WH>rHmOe#gF~4uu%~c|tT3NeC{F1Gh0vK(`B0Y`UEQAXrZ83k!QSYK8aJhOA4jq`)EWj>R{HY;S7Hk)?F~fPe#QG<&uU#d%J*rS$9w1sj%@K0%V;}X$$Gax?4x9MR{Dv9S8d4jB5NC!yww6Ay(7!>piaL&!4A&)ymP@
zzy(GxGUGJDhU@F<@-i9@ZVp_2%>0JGR~MDID(!mHcS!_@64UkTNDhE)<(T|7|qR#Hao2OX?W#wfLd-;F5CT%
zce`eo64~>0MjM}Uq*qF^eCQq-_}
z8~ZcxQ_h~ambW_J$|TQS;rW-tfMvFT$jdg7E<4h-4i+|=`FX`AYs3Hd0?c>24NTRk
zbi3U>Z;%h-aupG6L5n#7dz_sA#D_Y)d*pyQB=~UFP?EgM5MAuSfWfV;1(Q$r&Aq~K
z)G`Y3a2#Mr+sBu}5p$(@xn)9PhqlYxreVpAvren*RAP0yr~OQJ?16FUyu*l#3Q*3V<
zidWw*lBveVaO%3cBQiJ`&Qle?k6dJ)2Mi&GjqTD6Tudv$?Gip3n4H+=xz!{P`f?qM
zA%7xe(w+YKIRW4;4>GwGtk1x^;j9VKOwsy+;=VmM=YD>e>~3DShu-L6f9Ks{(Z%H%
ze~Tf9h1`{TX9w17+50D^knXm~q7SXekLF3Iw!AZk_UkQgxq-sztuTvbL(;b4(Mzs2
z8fWRdB6}m{mf5VbfH!bWkO;zABfdgUv~=w);sz*>f=J3J#ER_ou)<|_C~%1NOV+Kn`!d6t<*>SB3tR0W$rq!+1;y7ow%5~6u_q7v9YST
zyT>jkCrI&ggl+Sd5{BC)bPClKcAXXO9)aEWpI!E%$!4jIXe*33&6jU!>Fy?Tw#89F
zTg>#WI{IQbOs_(~FFX6^G{`-AXbFVHMPv*0S
zsR?V(m30q~Y%`=DpW6
zTxg@BeI`(Wz~xh}ZlTcn*FJI}YH6`M!x7A+sxKd2(B$a;YVZ-U92
z7-5-&cuaG~fRL{nPmD;cbbRhOCt^u=aq)P>WuurQTOG$9^G;Dj{;F-xN~AW(1^MWY
zPvx9mmvoV(v9+8<@YK&|#6pcG&=pJ(Vne^N9Y}*FI}cA}mFE!C8bNLt4w%k`g+VEH
zf_T*Q_N~UyJR!>w;c0cq+cwMtT_k<(93CgN^+wBEA!%u8-8mWPJYV@AX__n6rgV;j
z^{wCVBt=`|O;eAP!<1dc)=z&ck~S~OY?ZZ6II$t5{S{5_cj-@7^XjMTcQSf*j4K7L
zXY4C|t#e^rS@HO)u4Pt(MX^)^s8j8IZ}&@c!Bn%$#N<51G+9zbRn-AuqaST2^?&9M
z;v$)Z{%x=r(Uiw5hQ(xS!zsiyq-|_(FH*lS$_$-Js~nC_=TH!6fi}i2;gybt4~E*g
zyBk_Y^1sbamS|shS3IB7D<-ZL_Wh!sVAc-$E%Vz$Ek`4&=pwTXEjC=}+Pu5_T*I7p
zzOrHwYvIqoO*e#oCbRMdW^Uc(BIW&GHNv2uZ|2coMss=F@vRa*S2coUe66J1-`rPz
zRcgnE(gVfLD9omi@u^Wd=2I$b+IZE2eLt)VNxivk?BSJ!h58|LPzr2*D3$jt^
z{5%-FsqL7!W1{-6D`ES>OiYQd3F+h;ZIm?)Blhp^T@uKvO{Z{D($3@K5S*%-}oZ;y?aZ>j#H#ORj1V@Zuw^POcU)lPx{e2!Ez
zL>YKYHA`*lkSOGFJuuA56~GqKox@?eIUOlgYsdGD26{A1r`Ink=DzUjcK?BdFK|Zg
zB`a_I(S7t|VILDSe%Eeo+g33-dSH~{mWpt~RPFk*9ZQuCQi)r&Rwcir;m%~$oE^Vf
z;PAjw@!uDlCPQMeYB;+CZ9@^D&77cOS)o-M_N55KWuHa~w(8uWf2}thrk8GM8>1(s2bl|f5L_Uv&m|=#;ZBn|j7G-|RtTuCH!oP+
zI(~Ljb{`FUjL4;aO~*=!$`$k6nZq5A1?E1mDV*e87js14y1!;Wwbw0m__O^g^@9S@
zu?sT)_FJ^i*N@MO$o=$}IT($zAJ`z}{Z&gMG$BFa%OAyn$b^y|SsulW@9GrYKF}oV
zv6QD53jC|k?-)bdmlwZ@v(LNLgBN}83}Eqdw8V4wmpwX}!?8>DlBQU)d?+Cww6!hw
zLUltX?!W84mMkE4FuHK4Q)SUp+(x7Sbw+c9Ebko$BPjs4dmAuwM!V=8Y$-0u5_&g3
zwU-}Rros~={#|rC0}cX;Gsoq>f2=AFuf`B?_16u-cKA33{DM%B*ynYJqE_x)<Dwy
zxQ#b@-O7=HVEJi2<93%HRqWHBya1liyQq*cofY{u+ttV8VUM-Mtcl=IOn&60YGKMb
zq$!iSOD0uQ!dDiLO40^n8jwj_9M8VqU<`p87bNP-tL^;geb+U%yVgYYZgxj%lalln
z6Bj2_LWs}^-_gS2Xk2J_-6v@n-REvwLxn$
zD^SPQ?K~R~Otuc>a{87diI3aZ0Q%vqfgH<$qK8S8Dke5Pi<~uzV#Le;FvtDTaVW_J
zCOPN29oUn(YoP^$mcLVX56~c`6}StE)Jj~pXj;c6ULn(w(Yy^ZcUgrs;)#Q_qk}nk
zX>NCYVhu!cJhL*am!L*q^?7ln&v3Ud04#F|2)MtRL;I5J^XrT-vAK@4M@Qd^yK+Sc
z<>U%LA>{rwN1#>R@~*YzIwt)KsdB&$08=@
zLni6(_Zs!~7E3ArM#sUe5u@ECv6I`-Xw;-|J!gyw3V1E(CM;KsR~0jE^C&92M^}`9vB*O0;e$WmYIPe1l8HdJD7IK
zhrxnNnw?Sx$3CN<40$3%PofF7MK5&D_I0kLz|1@FaWoK&V)uvmBbyOgnPHDWAv1p0
zS`8_;b^LKk4~i(kQdKoI{xwoYn#4mJB=j$cXLP5lkCbUBHOwZS_;fw-U!P)73b#4s@cO<%WNZ7_UU&OOdzH~_no7|j5
za{YR(;@lf_3RKMgIf;Lli_>H8`6
z-p05bQ}^WLW}}t+RC~XLUeVDNGjtueBMF=NTDW8yp%%hQrHQWt6EQp0BTm|n($O&s
ztorL9vEq>*Kni9<7*jPjxh1A
zHhl}=+?unwp7CnD07rBA$UENGXJnhFvKbf3?#$(jy)TcD+?{u>BQs$OwrxB<73ln5
z9Bl{=Ce2tdGCZE^M=;5OZfsTM!G}Z}4VzE!4r@Ags}pp+S%4&Z!(
zJRdx`eL1?Ithdxo7zc+(jU`SUzK@vN+aQf?YW))`yrbKlZ(I}xn`IS`Coukt?^-*5
z`R!w@g45p{FMbGh9lf!8X_0%u`^mM1ZHMS_V43T}>#4s=vAe`%WSCf4S-}T4V?%oX
z{Co(Gf7bPTuaazVV*6HXe6r;sZrWZBb=sU^6bWs@3B8BX2diYEX2*X%@_2=@F`VI7
zr(c?Zi^^jZ{4ZqP5tQ=wkqGNrzti!3`+R|YUQ5Hlo5N8n+h%RVeQnIs?;IYB7v8xJ
zx14r1i;BHyO^dWH(T!l@HbFeXd%ARJ*TmR3!Jm@(^TWV~ZD3=fTEnLTVxw5oXRL7)eOFgB!Kp
zQhouZS^_p;(~pB`k;e@H?%$tqs351N>`wU~3kP8sm&S{H<65u2XNt`?oy
zY1Pxur+>hE5n_CEi_Jm6!0^?0O<#K~1PM0(%^p`JLe#<1%e4I!
z%ppCnO7kfCOig7J
zVwup)F&RdQSi>{?tTa1YWW}mg;_~v{w8`9wSYB}?9B^q6ht63RKZ36;g0)x^=>O`@
z;6(UNrQ3{c7X9Ww9dK2$S^97OjpV8$qvL6M^sD?Y-f@Fyz4H9P)yixV72z&ldorsD
zvivzTM%a(G#H1@7NRn2N}=z@Jn%5UVf+AaF{u!wewVh>k|cL-E)Rj-6Sm;M7P;F)sqzCE1fp
zjYTFjy=8;rQ3J_~!1d83H+)*b>&Cg)!{C~Tqy$L{PRf%qbuLZx^
zzEl&LeaV@Z=q>K^^QqMxrIWnc$aU(3($VKDgyYrYtD6|pZoPzMjM;AqT$4RcQ#$(M
zF^JBrVDi7ilbhQnVSHQhJkJ@n^;L1)8dZ!TXx7q#L0%)W+*E@-JL;mTa;DS;*9@D)5V{2xEZmvJeyOZ;f!2XaFr7v0O#-&lVrBQEN^tU^|
zLHl($Y==%w;fyEI_y~uiH9R`BAvrUP*j8{yU|-6?am0+9XhT=DEI$#Uy0JwG?T%`r
z5t4>S&)jk`P8BcAt|W`&H^)%R$x9U9(aV2MO&}B_>hVf@&h@MKlGPQC4hL9qXNIu!
zH@9Y1EszyN`cMcHQqT19*2uGT9GuFk=}XFG(svqD~`nO2`z
zrv$VCie2xVGTKi|B0lVc)ng1nYDrlzLmh=xkC
z0;|6O$YFjDxda#(R)He)@VK*VRcMk!yR@|Q^}*)<_Vp7KY`RlUNet@t2R(g}4{q_xl)Sl`;JO+%o+2WAc>H+9bQREG`HI~r(bl|?9dwthC47pyyLqOYx`QpmDQxLz1|(qA97;TgBMR$
z-FfYw);?_WBPibbF6)-szNjb(ZjRrGo&Pt{o;
zmDLKKn<)+j8y*^-xOA;k&9VQI=ehcCeT|QgQqEfWaj>zja2mF^UwqDS@*ZcJrRihz
zRAG}j_+B)H+C0DfG1HLoq%WR_PuWO@(Fl@c;
zH@nzX?67er>3G^T7qKXV2OQ$Mu*N-h74U`!2;-i3A+TTHrY%tWb!%os2JJU}n|=T|9@$KaN;ANI?of2T>Rtl8w@oqNx5U
z2<~M{NSDTM7F7Fm6yoZvIQ;A!suL*WUYJL6%ch1C1cnyO9_TiXM1-QD00qXNDx{&1
z_D&>fS_+O{6kL#^fHC;tW?*M;{4Rm5(0rN@bTEqN1egNM)?vFAG|xvF#-WR%=1?dk
z(g68TDCoMSphc(!*fIuMEpf!{{JS6y=lDv>0{T#A(RxdvU;sxfbXQKwEP9`Ef|vj5
z?b)LP?OOq6=YOzOU~3Cme`wuBJu^_q(M3pbscsP0ji;O+&>`axR00>|
z(P|xyrphG*0s`jY-JqqT<6vjEufB9^`eS!a*vNe{!NMp@rH9jwURzst2O=ek#?Epj
zO7dM8LB(4p-tE#nBkW=OjdJg=RfK1dwP^Rd1*5PmJ;CCf=I~T@Lwd*d+%*|7S>gBW
zOPvdyWK=;mh@^Eyu!cn&WT5YF1V!?|+kM5oda%l1G^WIbr!L*7Qt8fTM4$TgeFLaj
zrU+{2_3ILXsy-_q|H{2|Q@$i;$C|81lv>>KC~7_|29RANj3BF>oP)YSLX!dwsx7f|
z!8HSSz#4e}O$yC2kn07M)r73a@zf400TbA9s*M?Th1lZcem6f>-FUf}5mTt4@08j(40%__6
z^w-P_nnivo0ImwyOyx1G1DZ2j*>o^FXzA+G!%`9f%R8nB}*l-0jl)aqVMgyguz(A87IB`=?v|57!DO9*S`pJudJ1
znL|6Dn_7mDm>+MDPer#Nq6NiS${)tgm5H%T`y3r}MIG|`rs2PdCl+4;E)MR4!17+c
zzAdOqhNq^aeO0s<;lwbO(3ny>&3XIAQi6=uS?z!=oGJ%e<}GIbPEA;C<_q6-Vy}oU
zbN|pmc}v38V+Jn|nw!B-@nQ}F9vm7!Hu+ka>tTnY5eoDGT;53-Yk;|I2SAz{JOGKP
z^;Jnj!?xev*5P>0&Kn*c9wu_>_>i@S!hB#Jj9{diBLU;#EI&Yrh0H
zCt9YlCl^FKt>F9m?i(;g^xtCipx{3>VUZ*s0KGK_f5RT5O^vdYz>KUi45rIzmgWS%
zfsRxyFxs$v4~Z-G#%HMnzp6T{jK$
zYUrItv*+p>n?%z33|DIi90KUYMC}#|OzrUbbq#?ewYBP`SOlv;Sdj&k2H+vdW1W^@QxwU5URGNwRIFlWowq|36mNh(h*~i-V|5JJ;cQh4IZi!2`{Ls$=9KW
z#B02r1AhsYXc*r?eiC;af=L0S=0XV6MYIQl8HeaKMm`zeMbvciIk*5I?QnEDK?RIL
zEv~sajnDvI0Rd59fiOiP4mX1Gf)=8B6uu74*Rx1eRQwnMAL$-PTklqn{t$qPu`o7`
zMs)9R2n#0x=sA&mXqL}}P))7}yZ{VJT$s8+K8HjjG=`GT0i8ygcknsDAGDMLt8y`f
znw7!9!I%zbkC8qL7(wL)^hOGCEEifI+dx=j4d>eE?_?q0h*0#kcbN+Z4+Bx1@0h@(
zl?|lX^ZRmf!s=_gI8zU!yM_!o{&(hqG{B-B&uJEy@m<=ar~SwP*>CvEmur(}(XG16
z%gd`?;#b3=M@Z&
zE*dp@mU;jy@%fz>)slC4aPT%i4o1V`UM3-0j!=DY
zJh_}Y#l4q)-OPup9&&*O(r+vnxSr9mfT?bpF6irh^#~}|M&Szm*~+QGFM)B60F5}1LncQ;n4-o_MB1C27(BWupdGo
zCet@IDqnGnrq~0}5W2P7;i47kbcX&!rWpp#2!m_H9gf_*c2;J*U3L=fc-T?&pcgVH
z>*1v8ZwTIrDK^9J-&?NeF+ExdiM})QE-e}&sZpBR|GtkM-v?%63L|=eD(0ih{LOLP*+v$&(p#4IE}X_R|oyxN*eF+
z$0K-H2Rj@7WIg!JF%UVl>t_)HfQYCl4Lo0qgFB(NWAIT6Krjsj3@B+%GE$p_!y&%v
z#g3p~l|4H>KmaG;$^d9Ui_VQdUenxA3d
zu*t!xe;T~oF?$x?BJkZ{9GKCl&5zc66^zXf?V5c5J`$DcgZZ<@KQm%G(F-x#wR1V$
z?-Qa;BAHHihbGnR(~`EcPh0TgND0sO?#_&gJ7b}p`P%)`otztrm9F(HHpmZ8hY
z9Y}-2Sa%GZ&(!J6(8=q`2GhD&-vC0VzuH^;P_il8RX+}}gmu>|kU
zylW7~0ejZ>lphvh6w+Xydv2-t;G4+KLeRm8%C_0FV2X)fg!mi)-&fveTTIB4Z@c+G
zRYirg&7tWN=CS21P*qSTa4nvK8NzCOQsT~5qfx627>UD|h5wCU8TgA4ERPr%_ldNd
zUmB&@ncJvneq7hv*LzQ9^Gh|gO6$9R`#0XjM3x>)clSf3wNHY#v#8?9ICsW^=sBcqD?&
z42t0Tn@~6I(HAr;#VZ7Mflh?1v05z#FI))0{^CV-M8qLYk?ylo!E*}Nx}wYqU)E0+
z^}5Y220~7iXUQw+81bs~>liYT<{I{?87!&pxXF1`DO2Y68io}p*Db1^P53+<@ybT`
zwKskPb5P6&BaNg8`Fg{1?2*coYjM^k^v&{RWo57gQ=*y+*c3fKvjA4*Zo76_v
zEYE$luS213p}Mk?3o|}3sBBWXst%d
zM$}Na!`KA`m|I^tad?Evn!MxT`LEM|L2^Hx54x!$8?!
zBy{jcS_jwTYY2eGE~)gq*w%Ahe+{nD@x$|c+zy6kv|+D^ChHMl1T!6*;F8A%+YRH;
ze9gk|-|j=RXw8O?8&wuFCO8o71WOmCEk*|RRCc-GRKu3`G6vI%*vPu!Zsvb@0_flO
z{csNI##o13gVMq~hC=lxU)<5kZm)ik{tJdZ64PIC+~k>)Ctdr#D28LG{><+leDdm7
zn?+l--?=_D!Z52_w{8_ZP-TpuqVIH|#gxPGukCB5J~U?X@bG}z2)lCS(7(s~WM>Gx
zN@W6i%6QvEBJ`t&SV#(r$7Gqlz*C11iijBsY8k+0H~O;ShuS5UJZ!i8YwgMH>u{yC
zkRnO5FU+JX(>fmE&_rYZiHnQV;jujm{`*b163wVOIyzXeD8OTM6p^P0rjm5TqNQ;7
z+ajUrOl@r9$>{~PPR3syd;1^;gd*sCb_~**>MdT2$2vSb9D_m17De
zv7mxuKUoo33kbUr
z$#i&Zj1E;FXr5-|CBQqZJWW*dE@<(?A3hxIZdh&hbNlJ<44MNM=vuz>M$(v6HU2_%
zr*QhatK}Ggv0^*zqUJ#Er?Y3z4mOm7gXKm+UAJpcswG`I#wil!$W-A*9kJvCn=SPj
zhTwcan^(c1?MmCX3nG2@URp0D)%5srOvx;RLd@6XBk#Ar3`99kiUMfr!1N#z+)`T}
zcXsNUnQ@Z21{p^4*0ncpS(WELZ$mx&qBddeJ$5^cG@PHqb^SOt_GlVRbAFIb@BKA+
ziroHU2hm$HKNr_Efw5-K)e|w%%!0oS!}7i#a{?|(t(qI1R&r`(sT+FXs)R?z&ak5W
z*)!$o25(0zzma-NJCNS2khCA6rYFQ1gwWWT^TU&qN6I8RArz9nHPjS%umD5h7gVkr
zXG_8L!9$rRKzcx&TRKS>pPnZ`%&E1DCM}mI#?)=kY<{O@_Yii07a;ISt
z<7wUA?d?~@(&D`6|^QK~D0!v%gmZL%ndXeH|IC!PUoxE*fMVI+IH+ssWz`0SViD%(?59
z?zK+Tzx^6W%`vGx_>9o-=H@FfV}a~ath2Iq0bUcYx|pil|I!7s7}1rh>ER)Z6}k+_
zRw2l(P__1pJ0vUul8`m55{v#GgwYD4yfMNUqna7wc@=V>+-HiQ{SV@8GmzDaWC=xo
z+F&q8fV}96sH;`Tu?bIjlBr;T3i|bwwj^P8aGP@H4x_>>H6o9vyDd?
zFp4;>cKo?^ACzqf_{RFT)euLF)mt7QKkiNxROpZ}u7Urt>EXkXyQKlXzAq1iE8+)^
zsBsnsV=_u*LwZW&2pk-PzcbBcbTB<5h-d2^GVTNLV7I@2m4Eq486NuzS#&KGxjL`(G>Q5WSbG~6P6m8r#~yJs&ru)IS?Cro(vsh
zMMF>U%rs_rN8p@U)cWs%(-#rS-2;6vyQES^u$xi5o8R@bJGKSD4L@F5_Db6mlYKX|I2hWV&IKl1z(BkQ}Ehjzg)Wgg~;K-o6gu0xeP``riW6
zkES|gQWgJCyafFKRWXAu?uYi2>PZ|tz}4i{U!++8!9sM)mNghBLO|{u<}p#FQY?mA
zQO!7bdM2!7<{1WOqX|M2z%dkYjSS603tbyBN(Au}!Lh_WIQ#v3xRDg;H`iERIsr^V
zJT$0x32jYgW`M64L5}NfHT`>%v{oc0>XKRrNg1Q<>=$N7kXOh6r2lbHS~(`>uE$Y!
zfdTyIp2dZN52lJG+rzwha`H-m7r3$4b!XOMTwa*}j_XCEqz!}!8#tIBWn+!_uYL`;
ztHE}@!=?Y{9yl}D;kKV$;w7_apb-wRKAu8f5LmdJpxb!gm(pO;OU8>W3R)Wk@c~){8EFN6NLX_~>HXKfS19%{se#_4sv4$`
z9Y_<5aHrty8{9ZhB*tNDb6~U?Ff*<6(ANh`JKnr_u}^)l8)pM?QXx
z#r7b?4Q(ie*xK^*C5grYCGMHQ_FsR4
z4cww^kG#n4%MeO^(+BfF3o4B&tu1Ftziz9=#OxcuyH8;dNC($a?_)@~9Xox|@$CLRoUac*dGsj1sb=l|!|TJ@wea4uNOPIq
zV$htl_(%NCG?L0o&ZDn{S|-mDhMD2ykfXQabcuib
z-Db&V`AR1)(bVh@=7-5lQ*IuMO?Ep&*r_ZNAR5sX1*D39o-Ps9e%b~0Rwi%&8VqE|
zo%}8L>9PAKksY~TJ-zVQ8AME_|HpNwg0R?Onj%EVAqO7x%JAJm5Mp@k-wWeprR$KL
zAOeNmGt@h@8>LDw5Ln>iMA~4@68c;*K9#=1l!N;5GK4`oO!h>{07Rn+v+Gv#bE^83`!fuiPeOF42eX15$jjAb`_N8$$sl)Cq53!}m4OH;6^
zd-Er+?F>FPs>dMOB40EZ^Kn9`xV@OX4g*9eVJYGTRXIU=;r(-np)kLPh31NfPlZYG
zWfp!F5_~bZ1?{DH`_yHm@En0
zg9#&!czM8G<6(AcKPl@DySpF!;6!CmxVUyF3z_xD%XsP#772_*Dn`8CkqLe#70!Ob
z;!RKj&uH)tu$c;|X1!rWeDG&}2wWrEkSGV$c8#R>)AW>-l=*UPF$V=ss$S4{@Nici
zd41@6cK-wLG&hg(=KYXX9Fha^WdXf!`o?`~OnG`rxoR-8!9vs-dYod3Lmy#@B!Nf=-zRt#
z3y2~VWyfFg#)|?$W17*hkKYmN!J#4X_3Kv=wFO-rJ-^aACX|gQG3G?|UllnGNE00s
zLvzjUo2PM!<+Olf-Ph4h^9eWp-d#`k?qN2Y93M}Y=EO6P&;0CO$sYUzJ{SO1GU{x0
zap`nw@L)TUPU!cJ!e>uX$`_3B&YwU9fLAs7`6%>2Bs03EQP-rG<UjdA@x#2@3ScEIWU@ZGz2
zQ+Y226ftNG=w0v361eMJSeQ`%I4Q_bjlwRdNZmmykl8;_nt1oFGHF~yhl04ai^|V0
z?}!2s&pC;PVX$F01O5Q=jAHuHE_g%m%Evg=jz>FiSWth<%F3Dmyd~>h|2FN5_k!Yc
zVBv=#=6CkP2Duc2d<1;VhYL+j<-TZ;U&TVfJOJYd*zce@P&umoc*2d!{?#kX^;K!V
z0~fvbxFG(NRaMa^wH2G(FpZIwsugetx}s^~nTaEv^qw6HHCP$7`2(yF1kPrEc83`G%=LIF?ChEvR-FysDbz
z`Cx#8k;7p0Jbfr0*=?*3Ua-P3@IZFOY<2qh=%jhNO~JNgYql&dlN!KXOHwS
zFB}e;$llY_(^BgY#yMdGUCs$~S&>Q)n-oN*CX7HZ1r%(8wgx_uoi}n9W?cE6eJCwQ
zM+pe{Dbrya$U;Fx2Isf|RENyP4XFk*sxjKMh&^>fCAXgfe1Tv^zekD5C6s!GhK6vr
zKO7i1ATZQ1^JKyY4Si%yGatOZjT1L|H19Cix&irFgtEVW&TVfREweTOwpjfHF$fJDN>1%>{JHP
z@gImK4hR&0ulDL()cC{;D&g$UDHc`8MDVU$mPce0McUy5(@Wls1B81=h)Gm;_lrWk
zu;&;mOdbGgZGaQ*Dp91o|12p5Wn0e0#W5p-(quPLy^-7p71yu7$rOZ`#RHTIbgSkP
zs3D9*+|$#8!-Mv)`*r@55p)J<4!5vmV46p`0SbC_k+6H79@pHpI
zLWFEIC8$k6-NToH?*t5%5kMVRYMI
zjtjj*7fQ*ZL#|i+3&e0_P@`-&<&092#&R?R9u>*H1DBfW0{YnEQXRZS7MH-Zipt0o
zJy!$;i7Kk*2@1$V2VDl@YLC@Hl5ybXq)wn0u{dZo`dNo$I&k6UE(2hs$(zj#IPw20^)`whbFyYF_=ME#1KDjg$MY^Ln
z)^u>g(_|Rk*wNYE9#T@W34w@mF@b%|XG7cG=o-ANz*&6-`SEmKNpBRip&96h!Q{-M
z9kzGfxX~XK0wt-Oms@n)1?$m_dni27iFsp~dr3nn=>2GL^Hq_#3>hDSCUPRMLfTt>
zAw9KYf&{B(`QBHxs53PFF8m*1?;Xx%AHNS1NkTF*LW!~(L?WVOM6yRoW=6PWC0h#F
zk-f8bb}5n~GD^ybA~Pc+AtXHK)%W}RJ^wt%@%(Wg$9;5n`}kbf`~4c{>pahw*-zJ6
zfhS8Uum2Ah;0N+Zn1Yr$N4Dlpv=n(}ue4X^q
zm{B8HmN?D5scIqSC9tv6t+oRm1Rr&A0)R$qY=V`>_D)WPx1@-00|L1J_P<6s2-i_9
z1(!yMbOY?h3Y-i7^5kT8qK(D*#2G|$K>_VhuJRYG{|!=oeV^_lXfYK#@Q%;p6A*nyt2us+yweLyR^IYf-2^s(>7-d*iO(v&uVOE{~euOo66pyf9j_?mfk?nxts5SG-
zA-u^YWKkZ}ce7fq&*pw}WAj<#_YVN-IbP_SvQVVLA>cBXr48>mKyRg(j8
z?v&FkpP?7AE^*_)eF1z#s{T8B?u}nBdSUDW&)&F=GqXRy1Ymd&P&Mn@8r>_;(J~lg
zAVWvx4+@h?Oj0D8+ffYtPO3NhbUlBfE>|l6k6j39GG3a8i?
zB!U%QR9lA${v;+DrC6-T7Ira^731W61jJ5)&j=puJ!$uq1>415A*&D-F4*%$tvs~q
zv5yWnvg2*CG-6&Hh0}4iXkJpfPYhYJeX;qa!
z`1NSbk>=jGT=1jQ&@eSX;z3k@+=K@zwIf}?Pcfod%{xiu^H#d*%WGAV1
znPvO8qwC6h1r2;>Mv8bEXv=SF+t02HDi$Nc&24<}?bbusq^bXz6PM;nCRwzLq-0IZ9!
zUcg9DT9!JjPHB&37#J9YUmf&2NSV8!9;$b_aO)%by`QM?xSF+5;=@
zG}P5GbR+XUdk6O`L1*NzHLcL--5ZWRmZ6V;(rG}a1Ugx2PGt)^~|DWNe3r}A}|m?RQMQM(0S@<QPlC2W(#)RypO22pVsCq@w!
zJqZHkzsGzJ=9I6{GZYp(ZEbon$e$;Qk*5d(2x0p%$0Q>m$ZhbE^#f4=OF&v2oxk%V
zd>{`s#S5EN8kM6e)md2cB>DlMsIS4D{7L9jfNB#&OK8Xqh9yIkvrYLmWt~y45wE9F
zg(z7_2>MDax3C(pa02}%jNf4R9zSbO$+dh3oKQ?Nvr$BvXQpVSJx);euC_5H&`5LYU;vS{+BNiy9{#NLPpxSIpf2?5nWQ
z4`
zBHo$N%v#fhR7C=OBBeE;5r49>!F$l*dt
zC1K1a;Y2|~6iE<@=;T$nEm}aatUG@i@r@wC7T&7c+VsF=VDefs1{a|H3+r`s7FPg@a5#|J42=DF@hWnx^_vP7X@6Xa*ID`(*XiAE!B-n%n+xA9r{ft?1THVL5
zhPM5`QGoa@Uf;!e7=`2ac@$BRiHWU1=i*~9lN6yCk`Se|$=vTRu(T1GnIyGZ&fpzV7gAC
zBg23DcmQRomT7$`=z^2%pWbUPH$x~;22LXY=hi}gX6~`-0LpZn=h940)-+W!4vp2IBDeh_n=cA1KjU0N~#D_OgoJc7cpZH=)#Z#
zvj9vjFiR~1jnV{A9@=v(ah=5KDxlfi^i=*Q4?7xirpRA7FNfO761=&|>w`a#61Pq>
zixk(Y5xo{%3M4Ld3Y%g0i9QD42kERzHwok~sk3yH`3zPjK-K>}otAM&{m-96i830G
zmZa4s2YV}@cAh|HOpiKuo2t(29|jTQh!IHG7YUOQ_4&&9no{%N2!O2UtWu+&0tQ<>Il
zBM9#bl&2>zTs5xR}M}=>8S#9fA)~cPA^unDvQt78!BdN>O5QYgTx&k|N6y`pKzS-(a6_^Hm0aD9LbL*
zApZ%6Ru6H3J~N_#K(gLOLbNcbatPHM3P}rh_;`(>%xGb_JM#+_3t$
zbu0AQ*YaC6%f$_&3)GsqVhhnvjlP@?2qq4e$rrdkM5LsIAqx^-9)vFdU`-+KzphWt
za~}rnf*NE9ba27MBNH}jVzFh@`6n|yFbf2Z;01$@%tpi@1YDM^YqIUEUQXN=CIC+G
zgaBs~Yl$#cfD$-I;0KU&M0j{!9~2R(Xmuw%_{vz|9s0ODycmUGmkA58eFp#@jO1Eu
zdim!s^3V?x_=^saADT`6?(us<$IoG5rcel0tOS_cbGG%;cRBl
z*#@C4$?ta>#_zO^zjnR(#&$``up2}tVb`C=2u}D}fviMRfv*x76N5aIpQ4)GX>~a~
zlsHKDcRm!S?o!^4N-oQd)ivT532O(H`jOr{yp{eJM-Nj{T2Wb+Z9j74X#J@R7H?R*
zPN)|~tLJyAzl>)bv9BNhRX@7OMfdZD6$5ci0(}{om_WWK%3;g^NLq6)?Igb|P=fZQ
z+Ifl|h)2QKh)2n14-nLAt9A@N|2Mo5m~_N%P_|+I(}e~_Q}Zst7r`W+A}~1O`Kvr7
zb_E@(8+HQkIlhJ)xoic0dMcukl_xF`aC0;~V({j03TxDdk}AQXLZ6o>-O||1`Lo<^
zR6EZc@RsqWV7~dSIkRXYBEP!SC8D0Ul;-pcVHWQD3K`i+M~~R-ks*F_O8!r{jzFMZ
z!;6bxq>_04YT?!KUW1y76~uyVI7h^glbHBa&3=Jj0|F++gQSQ*s3Rx{_Sfah@vmI+
zKU#WS^uh%15x6o0IrYX1#gE1;$AdCk8kSQEORc)q#Mevdluy$AZHXHNGkU#`S*sX=$ZoOF%
zPdG^St(A7r