From 61c85e099f0be5778ec73b9f17c232fcfd3abd5a Mon Sep 17 00:00:00 2001 From: Andreas Motl Date: Sun, 4 Feb 2024 19:38:20 +0100 Subject: [PATCH] Prune details related to HaniMandl firmware. Improve directory layout. --- .github/dependabot.yml | 20 - .github/workflows/platformio-ci.yaml | 43 - .gitignore | 2 - LICENSE | 910 ++----- LICENSE-hardware | 289 -- Makefile | 12 - README.md | 26 + changelog.md | 44 - hani-mandl.bin | Bin 279024 -> 0 bytes hani-mandl.ino | 2374 ----------------- platformio.ini | 24 - readme.md | 222 -- ...dl-wiring_corresponding-to-code-v0.1.3.fzz | Bin .../hani-mandl_v0.0.1.ino | 0 .../hani-mandl_v0.0.2.ino | 0 .../hani-mandl_v0.1.0.ino | 0 .../hani-mandl_v0.1.2.ino | 0 .../hani-mandl_v0.1.3.ino | 0 .../readme.md => variants/README.md | 0 .../variante-1_heilbronn/anlenkstange.stl | Bin .../variante-1_heilbronn/bodenplatte.stl | Bin .../distanzplaettchen-oben.stl | Bin .../distanzplaettchen-unten.stl | Bin .../variante-1_heilbronn/gehaeuse.stl | Bin .../hanimandl-heilbronn-1.jpg | Bin .../hanimandl-heilbronn-2.jpg | Bin .../hanimandl-heilbronn-3.jpg | Bin .../variante-1_heilbronn/klemmring.stl | Bin .../variante-1_heilbronn/readme.md | 0 .../variante-1_heilbronn/servoarm.stl | Bin .../variante-1_heilbronn/servohalter.stl | Bin .../variante-1_heilbronn/waegeplatte.stl | Bin .../hanimadl-ds3218/hahn/hahn.jpg | Bin .../hanimadl-ds3218/hahn/hahn.stl | Bin .../hanimadl-ds3218/hahn/mutter.stl | Bin .../hanimadl-ds3218/hahn/schieber.stl | Bin .../hanimadl-ds3218/halter.stl | Bin .../hanimadl-ds3218/hanimadl.jpg | Bin .../hanimadl-ds3218/schelle.stl | Bin .../hanimadl-ds3218/schieberarm.stl | Bin .../hanimadl-ds3218/servoarm.stl | Bin .../nachzeichnung-kunstoffhahn/hahn.jpg | Bin .../nachzeichnung-kunstoffhahn/hahn.step | 0 .../nachzeichnung-kunstoffhahn/hahn.stl | Bin .../k\303\266rper12.stl" | Bin .../nachzeichnung-kunstoffhahn/schelle.stl | Bin .../nachzeichnung-kunstoffhahn/schieber.stl | Bin .../nachzeichnung-kunstoffhahn/schubkappe.stl | Bin .../va-hahn/va-befestigungskappe_1.png | Bin .../va-hahn/va-befestigungskappe_2.png | Bin .../va-hahn/va-befestigungskappe_3.png | Bin .../va-hahn/va-schieber.step | 0 .../va-hahn/verbindungskappe.stl | Bin .../xxs-modell-mit-sg90/xxs-hahn.stl | Bin .../xxs-modell-mit-sg90/xxs-halter.stl | Bin .../xxs-modell-mit-sg90/xxs-modell.jpg | Bin .../xxs-modell-mit-sg90/xxs-mutter.stl | Bin .../xxs-modell-mit-sg90/xxs-schelle.stl | Bin .../xxs-modell-mit-sg90/xxs-schieber.stl | Bin .../xxs-modell-mit-sg90/xxs-schieberarm.stl | Bin .../xxs-modell-mit-sg90/xxs-servoarm.stl | Bin .../variante-3_woerth/hanimandel-woerth-1.jpg | Bin .../variante-3_woerth/hanimandel-woerth-2.jpg | Bin .../variante-3_woerth/hanimandel-woerth-3.jpg | Bin .../variante-3_woerth/hanimandel-woerth-4.jpg | Bin .../variante-3_woerth/servo-arm-1.stl | Bin .../variante-3_woerth/servo-arm-2.stl | Bin .../servo-halterung-1-oben.stl | Bin .../servo-halterung-2-unten.stl | Bin .../waage-1a-oben-oled1.3.stl | Bin .../waage-1b-oben-oled0.96.stl | Bin .../waage-2-waageplattform.stl | Bin .../variante-3_woerth/waage-3-unten.stl | Bin .../hanimandl-dresden-1.jpg | Bin .../hanimandl-dresden-2.jpg | Bin .../hanimandl-dresden-3.jpg | Bin .../hanimandl-dresden-4.jpg | Bin .../hanimandl-dresden-5.jpg | Bin .../hanimandl-dresden-6.jpg | Bin .../hanimandl-dresden-7.jpg | Bin .../variante-5_dresden/readme.md | 0 ...i-mandl-wiring_esp32_v0.2_experimental.fzz | Bin ...i-mandl-wiring_esp32_v0.2_experimental.png | Bin ...hani-mandl-wiring_heltec_v0.5_netzteil.fzz | Bin ...hani-mandl-wiring_heltec_v0.5_netzteil.png | Bin .../hani-mandl-wiring_heltec_v0.5_usb.fzz | Bin .../hani-mandl-wiring_heltec_v0.5_usb.png | Bin ...hani-mandl-wiring_heltec-v1-and-v2_pot.fzz | Bin ...hani-mandl-wiring_heltec-v1-and-v2_pot.png | Bin ...i-mandl-wiring_heltec-v1-and-v2_rotary.fzz | Bin ...i-mandl-wiring_heltec-v1-and-v2_rotary.jpg | Bin .../hani-mandl-wiring_heltec-v1-only_pot.fzz | Bin .../hani-mandl-wiring_heltec-v1-only_pot.png | Bin 93 files changed, 315 insertions(+), 3651 deletions(-) delete mode 100644 .github/dependabot.yml delete mode 100644 .github/workflows/platformio-ci.yaml delete mode 100644 LICENSE-hardware delete mode 100644 Makefile create mode 100644 README.md delete mode 100644 changelog.md delete mode 100644 hani-mandl.bin delete mode 100644 hani-mandl.ino delete mode 100644 platformio.ini delete mode 100644 readme.md rename {historic_copy-fb-group_imkerei-technik-eigenbau => upstream}/hani-mandl-wiring_corresponding-to-code-v0.1.3.fzz (100%) rename {historic_copy-fb-group_imkerei-technik-eigenbau => upstream}/hani-mandl_v0.0.1.ino (100%) rename {historic_copy-fb-group_imkerei-technik-eigenbau => upstream}/hani-mandl_v0.0.2.ino (100%) rename {historic_copy-fb-group_imkerei-technik-eigenbau => upstream}/hani-mandl_v0.1.0.ino (100%) rename {historic_copy-fb-group_imkerei-technik-eigenbau => upstream}/hani-mandl_v0.1.2.ino (100%) rename {historic_copy-fb-group_imkerei-technik-eigenbau => upstream}/hani-mandl_v0.1.3.ino (100%) rename parts-3d-printing/readme.md => variants/README.md (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/anlenkstange.stl (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/bodenplatte.stl (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/distanzplaettchen-oben.stl (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/distanzplaettchen-unten.stl (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/gehaeuse.stl (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/hanimandl-heilbronn-1.jpg (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/hanimandl-heilbronn-2.jpg (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/hanimandl-heilbronn-3.jpg (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/klemmring.stl (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/readme.md (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/servoarm.stl (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/servohalter.stl (100%) rename {parts-3d-printing => variants}/variante-1_heilbronn/waegeplatte.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.jpg (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/hahn/mutter.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/hahn/schieber.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/halter.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/hanimadl.jpg (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/schelle.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/schieberarm.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/hanimadl-ds3218/servoarm.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.jpg (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.step (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.stl (100%) rename "parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/k\303\266rper12.stl" => "variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/k\303\266rper12.stl" (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/nachzeichnung-kunstoffhahn/schelle.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/nachzeichnung-kunstoffhahn/schieber.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/nachzeichnung-kunstoffhahn/schubkappe.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/va-hahn/va-befestigungskappe_1.png (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/va-hahn/va-befestigungskappe_2.png (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/va-hahn/va-befestigungskappe_3.png (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/va-hahn/va-schieber.step (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/va-hahn/verbindungskappe.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/xxs-modell-mit-sg90/xxs-hahn.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/xxs-modell-mit-sg90/xxs-halter.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/xxs-modell-mit-sg90/xxs-modell.jpg (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/xxs-modell-mit-sg90/xxs-mutter.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schelle.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieber.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieberarm.stl (100%) rename {parts-3d-printing => variants}/variante-2_hamburg/xxs-modell-mit-sg90/xxs-servoarm.stl (100%) rename {parts-3d-printing => variants}/variante-3_woerth/hanimandel-woerth-1.jpg (100%) rename {parts-3d-printing => variants}/variante-3_woerth/hanimandel-woerth-2.jpg (100%) rename {parts-3d-printing => variants}/variante-3_woerth/hanimandel-woerth-3.jpg (100%) rename {parts-3d-printing => variants}/variante-3_woerth/hanimandel-woerth-4.jpg (100%) rename {parts-3d-printing => variants}/variante-3_woerth/servo-arm-1.stl (100%) rename {parts-3d-printing => variants}/variante-3_woerth/servo-arm-2.stl (100%) rename {parts-3d-printing => variants}/variante-3_woerth/servo-halterung-1-oben.stl (100%) rename {parts-3d-printing => variants}/variante-3_woerth/servo-halterung-2-unten.stl (100%) rename {parts-3d-printing => variants}/variante-3_woerth/waage-1a-oben-oled1.3.stl (100%) rename {parts-3d-printing => variants}/variante-3_woerth/waage-1b-oben-oled0.96.stl (100%) rename {parts-3d-printing => variants}/variante-3_woerth/waage-2-waageplattform.stl (100%) rename {parts-3d-printing => variants}/variante-3_woerth/waage-3-unten.stl (100%) rename {parts-3d-printing => variants}/variante-5_dresden/hanimandl-dresden-1.jpg (100%) rename {parts-3d-printing => variants}/variante-5_dresden/hanimandl-dresden-2.jpg (100%) rename {parts-3d-printing => variants}/variante-5_dresden/hanimandl-dresden-3.jpg (100%) rename {parts-3d-printing => variants}/variante-5_dresden/hanimandl-dresden-4.jpg (100%) rename {parts-3d-printing => variants}/variante-5_dresden/hanimandl-dresden-5.jpg (100%) rename {parts-3d-printing => variants}/variante-5_dresden/hanimandl-dresden-6.jpg (100%) rename {parts-3d-printing => variants}/variante-5_dresden/hanimandl-dresden-7.jpg (100%) rename {parts-3d-printing => variants}/variante-5_dresden/readme.md (100%) rename {wiring-fritzing => wiring/fritzing}/hani-mandl-wiring_esp32_v0.2_experimental.fzz (100%) rename {wiring-fritzing => wiring/fritzing}/hani-mandl-wiring_esp32_v0.2_experimental.png (100%) rename {wiring-fritzing => wiring/fritzing}/hani-mandl-wiring_heltec_v0.5_netzteil.fzz (100%) rename {wiring-fritzing => wiring/fritzing}/hani-mandl-wiring_heltec_v0.5_netzteil.png (100%) rename {wiring-fritzing => wiring/fritzing}/hani-mandl-wiring_heltec_v0.5_usb.fzz (100%) rename {wiring-fritzing => wiring/fritzing}/hani-mandl-wiring_heltec_v0.5_usb.png (100%) rename {wiring-fritzing => wiring/fritzing}/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.fzz (100%) rename {wiring-fritzing => wiring/fritzing}/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.png (100%) rename {wiring-fritzing => wiring/fritzing}/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.fzz (100%) rename {wiring-fritzing => wiring/fritzing}/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.jpg (100%) rename {wiring-fritzing => wiring/fritzing}/historic/hani-mandl-wiring_heltec-v1-only_pot.fzz (100%) rename {wiring-fritzing => wiring/fritzing}/historic/hani-mandl-wiring_heltec-v1-only_pot.png (100%) diff --git a/.github/dependabot.yml b/.github/dependabot.yml deleted file mode 100644 index e8efd8b..0000000 --- a/.github/dependabot.yml +++ /dev/null @@ -1,20 +0,0 @@ -# To get started with Dependabot version updates, you'll need to specify which -# package ecosystems to update and where the package manifests are located. -# Please see the documentation for all configuration options: -# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates - -version: 2 -updates: - - # Check GitHub Actions - # Workflow files stored in the default location of `.github/workflows` - - directory: "/" - package-ecosystem: "github-actions" - schedule: - interval: "monthly" - - # Python dependencies. - - directory: "/" - package-ecosystem: "pip" - schedule: - interval: "weekly" diff --git a/.github/workflows/platformio-ci.yaml b/.github/workflows/platformio-ci.yaml deleted file mode 100644 index b10ce65..0000000 --- a/.github/workflows/platformio-ci.yaml +++ /dev/null @@ -1,43 +0,0 @@ -name: PlatformIO CI - -on: - pull_request: - branches: ~ - push: - branches: [ main ] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - name: Acquire sources - uses: actions/checkout@v4 - - - name: Cache pip - uses: actions/cache@v4 - with: - path: ~/.cache/pip - key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - - - name: Cache PlatformIO - uses: actions/cache@v4 - with: - path: ~/.platformio - key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }} - - - name: Setup Python - uses: actions/setup-python@v5 - with: - python-version: '3.11' - - - name: Install PlatformIO - run: | - python -m pip install --upgrade pip - pip install --upgrade platformio - - - name: Run build - run: pio run diff --git a/.gitignore b/.gitignore index 71f9712..485dee6 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1 @@ .idea -.pio -.venv* diff --git a/LICENSE b/LICENSE index 810fce6..0f10922 100644 --- a/LICENSE +++ b/LICENSE @@ -1,621 +1,289 @@ - GNU GENERAL PUBLIC LICENSE - Version 3, 29 June 2007 - - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The GNU General Public License is a free, copyleft license for -software and other kinds of works. - - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -the GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. - - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they -know their rights. - - Developers that use the GNU GPL protect your rights with two steps: -(1) assert copyright on the software, and (2) offer you this License -giving you legal permission to copy, distribute and/or modify it. - - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. - - Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic -pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we -have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we -stand ready to extend this provision to those domains in future versions -of the GPL, as needed to protect the freedom of users. - - Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. - - The precise terms and conditions for copying, distribution and -modification follow. - - TERMS AND CONDITIONS - - 0. Definitions. - - "This License" refers to version 3 of the GNU General Public License. - - "Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. - - To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. - - A "covered work" means either the unmodified Program or a work based -on the Program. - - To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - - An interactive user interface displays "Appropriate Legal Notices" -to the extent that it includes a convenient and prominently visible -feature that (1) displays an appropriate copyright notice, and (2) -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. - - 1. Source Code. - - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source -form of a work. - - A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. - - The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -"Major Component", in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. - - The "Corresponding Source" for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. - - The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. - - The Corresponding Source for a work in source code form is that -same work. - - 2. Basic Permissions. - - All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - - You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. - - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. - - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. - - No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. - - When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - - 4. Conveying Verbatim Copies. - - You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. - - You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. - - 5. Conveying Modified Source Versions. - - You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: - - a) The work must carry prominent notices stating that you modified - it, and giving a relevant date. - - b) The work must carry prominent notices stating that it is - released under this License and any conditions added under section - 7. This requirement modifies the requirement in section 4 to - "keep intact all notices". - - c) You must license the entire work, as a whole, under this - License to anyone who comes into possession of a copy. This - License will therefore apply, along with any applicable section 7 - additional terms, to the whole of the work, and all its parts, - regardless of how they are packaged. This License gives no - permission to license the work in any other way, but it does not - invalidate such permission if you have separately received it. - - d) If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your - work need not make them do so. - - A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. - - 6. Conveying Non-Source Forms. - - You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: - - a) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium - customarily used for software interchange. - - b) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a - written offer, valid for at least three years and valid for as - long as you offer spare parts or customer support for that product - model, to give anyone who possesses the object code either (1) a - copy of the Corresponding Source for all the software in the - product that is covered by this License, on a durable physical - medium customarily used for software interchange, for a price no - more than your reasonable cost of physically performing this - conveying of source, or (2) access to copy the - Corresponding Source from a network server at no charge. - - c) Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This - alternative is allowed only occasionally and noncommercially, and - only if you received the object code with such an offer, in accord - with subsection 6b. - - d) Convey the object code by offering access from a designated - place (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to - copy the object code is a network server, the Corresponding Source - may be on a different server (operated by you or a third party) - that supports equivalent copying facilities, provided you maintain - clear directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. - - e) Convey the object code using peer-to-peer transmission, provided - you inform other peers where the object code and Corresponding - Source of the work are being offered to the general public at no - charge under subsection 6d. - - A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. - - A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, "normally used" refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. - - "Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. - - If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). - - The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - - Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. - - 7. Additional Terms. - - "Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. - - When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. - - Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: - - a) Disclaiming warranty or limiting liability differently from the - terms of sections 15 and 16 of this License; or - - b) Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or - - c) Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or - - d) Limiting the use for publicity purposes of names of licensors or - authors of the material; or - - e) Declining to grant rights under trademark law for use of some - trade names, trademarks, or service marks; or - - f) Requiring indemnification of licensors and authors of that - material by anyone who conveys the material (or modified versions of - it) with contractual assumptions of liability to the recipient, for - any liability that these contractual assumptions directly impose on - those licensors and authors. - - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. - - If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. - - Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. - - 8. Termination. - - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - - However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. - - Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. - - Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - - 9. Acceptance Not Required for Having Copies. - - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. - - 10. Automatic Licensing of Downstream Recipients. - - Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - - An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. - - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. - - 11. Patents. - - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's "contributor version". - - A contributor's "essential patent claims" are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, "control" includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. - - Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - - In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - - If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - - If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - - A patent license is "discriminatory" if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license (a) in connection with copies of the covered work -conveyed by you (or copies made from those copies), or (b) primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. - - Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. - - 12. No Surrender of Others' Freedom. - - If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. - - 13. Use with the GNU Affero General Public License. - - Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the special requirements of the GNU Affero General Public License, -section 13, concerning interaction through a network will apply to the -combination as such. - - 14. Revised Versions of this License. - - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - - Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU General -Public License "or any later version" applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU General Public License, you may choose any version ever published -by the Free Software Foundation. - - If the Program specifies that a proxy can decide which future -versions of the GNU General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. - - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. - - 15. Disclaimer of Warranty. - - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - - 16. Limitation of Liability. - - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. - - 17. Interpretation of Sections 15 and 16. - - If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. - - END OF TERMS AND CONDITIONS +CERN Open Hardware Licence Version 2 - Strongly Reciprocal + + +Preamble + +CERN has developed this licence to promote collaboration among +hardware designers and to provide a legal tool which supports the +freedom to use, study, modify, share and distribute hardware designs +and products based on those designs. Version 2 of the CERN Open +Hardware Licence comes in three variants: CERN-OHL-P (permissive); and +two reciprocal licences: CERN-OHL-W (weakly reciprocal) and this +licence, CERN-OHL-S (strongly reciprocal). + +The CERN-OHL-S is copyright CERN 2020. Anyone is welcome to use it, in +unmodified form only. + +Use of this Licence does not imply any endorsement by CERN of any +Licensor or their designs nor does it imply any involvement by CERN in +their development. + + +1 Definitions + + 1.1 'Licence' means this CERN-OHL-S. + + 1.2 'Compatible Licence' means + + a) any earlier version of the CERN Open Hardware licence, or + + b) any version of the CERN-OHL-S, or + + c) any licence which permits You to treat the Source to which + it applies as licensed under CERN-OHL-S provided that on + Conveyance of any such Source, or any associated Product You + treat the Source in question as being licensed under + CERN-OHL-S. + + 1.3 'Source' means information such as design materials or digital + code which can be applied to Make or test a Product or to + prepare a Product for use, Conveyance or sale, regardless of its + medium or how it is expressed. It may include Notices. + + 1.4 'Covered Source' means Source that is explicitly made available + under this Licence. + + 1.5 'Product' means any device, component, work or physical object, + whether in finished or intermediate form, arising from the use, + application or processing of Covered Source. + + 1.6 'Make' means to create or configure something, whether by + manufacture, assembly, compiling, loading or applying Covered + Source or another Product or otherwise. + + 1.7 'Available Component' means any part, sub-assembly, library or + code which: + + a) is licensed to You as Complete Source under a Compatible + Licence; or + + b) is available, at the time a Product or the Source containing + it is first Conveyed, to You and any other prospective + licensees + + i) as a physical part with sufficient rights and + information (including any configuration and + programming files and information about its + characteristics and interfaces) to enable it either to + be Made itself, or to be sourced and used to Make the + Product; or + ii) as part of the normal distribution of a tool used to + design or Make the Product. + + 1.8 'Complete Source' means the set of all Source necessary to Make + a Product, in the preferred form for making modifications, + including necessary installation and interfacing information + both for the Product, and for any included Available Components. + If the format is proprietary, it must also be made available in + a format (if the proprietary tool can create it) which is + viewable with a tool available to potential licensees and + licensed under a licence approved by the Free Software + Foundation or the Open Source Initiative. Complete Source need + not include the Source of any Available Component, provided that + You include in the Complete Source sufficient information to + enable a recipient to Make or source and use the Available + Component to Make the Product. + + 1.9 'Source Location' means a location where a Licensor has placed + Covered Source, and which that Licensor reasonably believes will + remain easily accessible for at least three years for anyone to + obtain a digital copy. + + 1.10 'Notice' means copyright, acknowledgement and trademark notices, + Source Location references, modification notices (subsection + 3.3(b)) and all notices that refer to this Licence and to the + disclaimer of warranties that are included in the Covered + Source. + + 1.11 'Licensee' or 'You' means any person exercising rights under + this Licence. + + 1.12 'Licensor' means a natural or legal person who creates or + modifies Covered Source. A person may be a Licensee and a + Licensor at the same time. + + 1.13 'Convey' means to communicate to the public or distribute. + + +2 Applicability + + 2.1 This Licence governs the use, copying, modification, Conveying + of Covered Source and Products, and the Making of Products. By + exercising any right granted under this Licence, You irrevocably + accept these terms and conditions. + + 2.2 This Licence is granted by the Licensor directly to You, and + shall apply worldwide and without limitation in time. + + 2.3 You shall not attempt to restrict by contract or otherwise the + rights granted under this Licence to other Licensees. + + 2.4 This Licence is not intended to restrict fair use, fair dealing, + or any other similar right. + + +3 Copying, Modifying and Conveying Covered Source + + 3.1 You may copy and Convey verbatim copies of Covered Source, in + any medium, provided You retain all Notices. + + 3.2 You may modify Covered Source, other than Notices, provided that + You irrevocably undertake to make that modified Covered Source + available from a Source Location should You Convey a Product in + circumstances where the recipient does not otherwise receive a + copy of the modified Covered Source. In each case subsection 3.3 + shall apply. + + You may only delete Notices if they are no longer applicable to + the corresponding Covered Source as modified by You and You may + add additional Notices applicable to Your modifications. + Including Covered Source in a larger work is modifying the + Covered Source, and the larger work becomes modified Covered + Source. + + 3.3 You may Convey modified Covered Source (with the effect that You + shall also become a Licensor) provided that You: + + a) retain Notices as required in subsection 3.2; + + b) add a Notice to the modified Covered Source stating that You + have modified it, with the date and brief description of how + You have modified it; + + c) add a Source Location Notice for the modified Covered Source + if You Convey in circumstances where the recipient does not + otherwise receive a copy of the modified Covered Source; and + + d) license the modified Covered Source under the terms and + conditions of this Licence (or, as set out in subsection + 8.3, a later version, if permitted by the licence of the + original Covered Source). Such modified Covered Source must + be licensed as a whole, but excluding Available Components + contained in it, which remain licensed under their own + applicable licences. + + +4 Making and Conveying Products + +You may Make Products, and/or Convey them, provided that You either +provide each recipient with a copy of the Complete Source or ensure +that each recipient is notified of the Source Location of the Complete +Source. That Complete Source is Covered Source, and You must +accordingly satisfy Your obligations set out in subsection 3.3. If +specified in a Notice, the Product must visibly and securely display +the Source Location on it or its packaging or documentation in the +manner specified in that Notice. + + +5 Research and Development + +You may Convey Covered Source, modified Covered Source or Products to +a legal entity carrying out development, testing or quality assurance +work on Your behalf provided that the work is performed on terms which +prevent the entity from both using the Source or Products for its own +internal purposes and Conveying the Source or Products or any +modifications to them to any person other than You. Any modifications +made by the entity shall be deemed to be made by You pursuant to +subsection 3.2. + + +6 DISCLAIMER AND LIABILITY + + 6.1 DISCLAIMER OF WARRANTY -- The Covered Source and any Products + are provided 'as is' and any express or implied warranties, + including, but not limited to, implied warranties of + merchantability, of satisfactory quality, non-infringement of + third party rights, and fitness for a particular purpose or use + are disclaimed in respect of any Source or Product to the + maximum extent permitted by law. The Licensor makes no + representation that any Source or Product does not or will not + infringe any patent, copyright, trade secret or other + proprietary right. The entire risk as to the use, quality, and + performance of any Source or Product shall be with You and not + the Licensor. This disclaimer of warranty is an essential part + of this Licence and a condition for the grant of any rights + granted under this Licence. + + 6.2 EXCLUSION AND LIMITATION OF LIABILITY -- The Licensor shall, to + the maximum extent permitted by law, have no liability for + direct, indirect, special, incidental, consequential, exemplary, + punitive or other damages of any character including, without + limitation, procurement of substitute goods or services, loss of + use, data or profits, or business interruption, however caused + and on any theory of contract, warranty, tort (including + negligence), product liability or otherwise, arising in any way + in relation to the Covered Source, modified Covered Source + and/or the Making or Conveyance of a Product, even if advised of + the possibility of such damages, and You shall hold the + Licensor(s) free and harmless from any liability, costs, + damages, fees and expenses, including claims by third parties, + in relation to such use. + + +7 Patents + + 7.1 Subject to the terms and conditions of this Licence, each + Licensor hereby grants to You a perpetual, worldwide, + non-exclusive, no-charge, royalty-free, irrevocable (except as + stated in subsections 7.2 and 8.4) patent licence to Make, have + Made, use, offer to sell, sell, import, and otherwise transfer + the Covered Source and Products, where such licence applies only + to those patent claims licensable by such Licensor that are + necessarily infringed by exercising rights under the Covered + Source as Conveyed by that Licensor. + + 7.2 If You institute patent litigation against any entity (including + a cross-claim or counterclaim in a lawsuit) alleging that the + Covered Source or a Product constitutes direct or contributory + patent infringement, or You seek any declaration that a patent + licensed to You under this Licence is invalid or unenforceable + then any rights granted to You under this Licence shall + terminate as of the date such process is initiated. + + +8 General + + 8.1 If any provisions of this Licence are or subsequently become + invalid or unenforceable for any reason, the remaining + provisions shall remain effective. + + 8.2 You shall not use any of the name (including acronyms and + abbreviations), image, or logo by which the Licensor or CERN is + known, except where needed to comply with section 3, or where + the use is otherwise allowed by law. Any such permitted use + shall be factual and shall not be made so as to suggest any kind + of endorsement or implication of involvement by the Licensor or + its personnel. + + 8.3 CERN may publish updated versions and variants of this Licence + which it considers to be in the spirit of this version, but may + differ in detail to address new problems or concerns. New + versions will be published with a unique version number and a + variant identifier specifying the variant. If the Licensor has + specified that a given variant applies to the Covered Source + without specifying a version, You may treat that Covered Source + as being released under any version of the CERN-OHL with that + variant. If no variant is specified, the Covered Source shall be + treated as being released under CERN-OHL-S. The Licensor may + also specify that the Covered Source is subject to a specific + version of the CERN-OHL or any later version in which case You + may apply this or any later version of CERN-OHL with the same + variant identifier published by CERN. + + 8.4 This Licence shall terminate with immediate effect if You fail + to comply with any of its terms and conditions. + + 8.5 However, if You cease all breaches of this Licence, then Your + Licence from any Licensor is reinstated unless such Licensor has + terminated this Licence by giving You, while You remain in + breach, a notice specifying the breach and requiring You to cure + it within 30 days, and You have failed to come into compliance + in all material respects by the end of the 30 day period. Should + You repeat the breach after receipt of a cure notice and + subsequent reinstatement, this Licence will terminate + immediately and permanently. Section 6 shall continue to apply + after any termination. + + 8.6 This Licence shall not be enforceable except by a Licensor + acting as such, and third party beneficiary rights are + specifically excluded. diff --git a/LICENSE-hardware b/LICENSE-hardware deleted file mode 100644 index 0f10922..0000000 --- a/LICENSE-hardware +++ /dev/null @@ -1,289 +0,0 @@ -CERN Open Hardware Licence Version 2 - Strongly Reciprocal - - -Preamble - -CERN has developed this licence to promote collaboration among -hardware designers and to provide a legal tool which supports the -freedom to use, study, modify, share and distribute hardware designs -and products based on those designs. Version 2 of the CERN Open -Hardware Licence comes in three variants: CERN-OHL-P (permissive); and -two reciprocal licences: CERN-OHL-W (weakly reciprocal) and this -licence, CERN-OHL-S (strongly reciprocal). - -The CERN-OHL-S is copyright CERN 2020. Anyone is welcome to use it, in -unmodified form only. - -Use of this Licence does not imply any endorsement by CERN of any -Licensor or their designs nor does it imply any involvement by CERN in -their development. - - -1 Definitions - - 1.1 'Licence' means this CERN-OHL-S. - - 1.2 'Compatible Licence' means - - a) any earlier version of the CERN Open Hardware licence, or - - b) any version of the CERN-OHL-S, or - - c) any licence which permits You to treat the Source to which - it applies as licensed under CERN-OHL-S provided that on - Conveyance of any such Source, or any associated Product You - treat the Source in question as being licensed under - CERN-OHL-S. - - 1.3 'Source' means information such as design materials or digital - code which can be applied to Make or test a Product or to - prepare a Product for use, Conveyance or sale, regardless of its - medium or how it is expressed. It may include Notices. - - 1.4 'Covered Source' means Source that is explicitly made available - under this Licence. - - 1.5 'Product' means any device, component, work or physical object, - whether in finished or intermediate form, arising from the use, - application or processing of Covered Source. - - 1.6 'Make' means to create or configure something, whether by - manufacture, assembly, compiling, loading or applying Covered - Source or another Product or otherwise. - - 1.7 'Available Component' means any part, sub-assembly, library or - code which: - - a) is licensed to You as Complete Source under a Compatible - Licence; or - - b) is available, at the time a Product or the Source containing - it is first Conveyed, to You and any other prospective - licensees - - i) as a physical part with sufficient rights and - information (including any configuration and - programming files and information about its - characteristics and interfaces) to enable it either to - be Made itself, or to be sourced and used to Make the - Product; or - ii) as part of the normal distribution of a tool used to - design or Make the Product. - - 1.8 'Complete Source' means the set of all Source necessary to Make - a Product, in the preferred form for making modifications, - including necessary installation and interfacing information - both for the Product, and for any included Available Components. - If the format is proprietary, it must also be made available in - a format (if the proprietary tool can create it) which is - viewable with a tool available to potential licensees and - licensed under a licence approved by the Free Software - Foundation or the Open Source Initiative. Complete Source need - not include the Source of any Available Component, provided that - You include in the Complete Source sufficient information to - enable a recipient to Make or source and use the Available - Component to Make the Product. - - 1.9 'Source Location' means a location where a Licensor has placed - Covered Source, and which that Licensor reasonably believes will - remain easily accessible for at least three years for anyone to - obtain a digital copy. - - 1.10 'Notice' means copyright, acknowledgement and trademark notices, - Source Location references, modification notices (subsection - 3.3(b)) and all notices that refer to this Licence and to the - disclaimer of warranties that are included in the Covered - Source. - - 1.11 'Licensee' or 'You' means any person exercising rights under - this Licence. - - 1.12 'Licensor' means a natural or legal person who creates or - modifies Covered Source. A person may be a Licensee and a - Licensor at the same time. - - 1.13 'Convey' means to communicate to the public or distribute. - - -2 Applicability - - 2.1 This Licence governs the use, copying, modification, Conveying - of Covered Source and Products, and the Making of Products. By - exercising any right granted under this Licence, You irrevocably - accept these terms and conditions. - - 2.2 This Licence is granted by the Licensor directly to You, and - shall apply worldwide and without limitation in time. - - 2.3 You shall not attempt to restrict by contract or otherwise the - rights granted under this Licence to other Licensees. - - 2.4 This Licence is not intended to restrict fair use, fair dealing, - or any other similar right. - - -3 Copying, Modifying and Conveying Covered Source - - 3.1 You may copy and Convey verbatim copies of Covered Source, in - any medium, provided You retain all Notices. - - 3.2 You may modify Covered Source, other than Notices, provided that - You irrevocably undertake to make that modified Covered Source - available from a Source Location should You Convey a Product in - circumstances where the recipient does not otherwise receive a - copy of the modified Covered Source. In each case subsection 3.3 - shall apply. - - You may only delete Notices if they are no longer applicable to - the corresponding Covered Source as modified by You and You may - add additional Notices applicable to Your modifications. - Including Covered Source in a larger work is modifying the - Covered Source, and the larger work becomes modified Covered - Source. - - 3.3 You may Convey modified Covered Source (with the effect that You - shall also become a Licensor) provided that You: - - a) retain Notices as required in subsection 3.2; - - b) add a Notice to the modified Covered Source stating that You - have modified it, with the date and brief description of how - You have modified it; - - c) add a Source Location Notice for the modified Covered Source - if You Convey in circumstances where the recipient does not - otherwise receive a copy of the modified Covered Source; and - - d) license the modified Covered Source under the terms and - conditions of this Licence (or, as set out in subsection - 8.3, a later version, if permitted by the licence of the - original Covered Source). Such modified Covered Source must - be licensed as a whole, but excluding Available Components - contained in it, which remain licensed under their own - applicable licences. - - -4 Making and Conveying Products - -You may Make Products, and/or Convey them, provided that You either -provide each recipient with a copy of the Complete Source or ensure -that each recipient is notified of the Source Location of the Complete -Source. That Complete Source is Covered Source, and You must -accordingly satisfy Your obligations set out in subsection 3.3. If -specified in a Notice, the Product must visibly and securely display -the Source Location on it or its packaging or documentation in the -manner specified in that Notice. - - -5 Research and Development - -You may Convey Covered Source, modified Covered Source or Products to -a legal entity carrying out development, testing or quality assurance -work on Your behalf provided that the work is performed on terms which -prevent the entity from both using the Source or Products for its own -internal purposes and Conveying the Source or Products or any -modifications to them to any person other than You. Any modifications -made by the entity shall be deemed to be made by You pursuant to -subsection 3.2. - - -6 DISCLAIMER AND LIABILITY - - 6.1 DISCLAIMER OF WARRANTY -- The Covered Source and any Products - are provided 'as is' and any express or implied warranties, - including, but not limited to, implied warranties of - merchantability, of satisfactory quality, non-infringement of - third party rights, and fitness for a particular purpose or use - are disclaimed in respect of any Source or Product to the - maximum extent permitted by law. The Licensor makes no - representation that any Source or Product does not or will not - infringe any patent, copyright, trade secret or other - proprietary right. The entire risk as to the use, quality, and - performance of any Source or Product shall be with You and not - the Licensor. This disclaimer of warranty is an essential part - of this Licence and a condition for the grant of any rights - granted under this Licence. - - 6.2 EXCLUSION AND LIMITATION OF LIABILITY -- The Licensor shall, to - the maximum extent permitted by law, have no liability for - direct, indirect, special, incidental, consequential, exemplary, - punitive or other damages of any character including, without - limitation, procurement of substitute goods or services, loss of - use, data or profits, or business interruption, however caused - and on any theory of contract, warranty, tort (including - negligence), product liability or otherwise, arising in any way - in relation to the Covered Source, modified Covered Source - and/or the Making or Conveyance of a Product, even if advised of - the possibility of such damages, and You shall hold the - Licensor(s) free and harmless from any liability, costs, - damages, fees and expenses, including claims by third parties, - in relation to such use. - - -7 Patents - - 7.1 Subject to the terms and conditions of this Licence, each - Licensor hereby grants to You a perpetual, worldwide, - non-exclusive, no-charge, royalty-free, irrevocable (except as - stated in subsections 7.2 and 8.4) patent licence to Make, have - Made, use, offer to sell, sell, import, and otherwise transfer - the Covered Source and Products, where such licence applies only - to those patent claims licensable by such Licensor that are - necessarily infringed by exercising rights under the Covered - Source as Conveyed by that Licensor. - - 7.2 If You institute patent litigation against any entity (including - a cross-claim or counterclaim in a lawsuit) alleging that the - Covered Source or a Product constitutes direct or contributory - patent infringement, or You seek any declaration that a patent - licensed to You under this Licence is invalid or unenforceable - then any rights granted to You under this Licence shall - terminate as of the date such process is initiated. - - -8 General - - 8.1 If any provisions of this Licence are or subsequently become - invalid or unenforceable for any reason, the remaining - provisions shall remain effective. - - 8.2 You shall not use any of the name (including acronyms and - abbreviations), image, or logo by which the Licensor or CERN is - known, except where needed to comply with section 3, or where - the use is otherwise allowed by law. Any such permitted use - shall be factual and shall not be made so as to suggest any kind - of endorsement or implication of involvement by the Licensor or - its personnel. - - 8.3 CERN may publish updated versions and variants of this Licence - which it considers to be in the spirit of this version, but may - differ in detail to address new problems or concerns. New - versions will be published with a unique version number and a - variant identifier specifying the variant. If the Licensor has - specified that a given variant applies to the Covered Source - without specifying a version, You may treat that Covered Source - as being released under any version of the CERN-OHL with that - variant. If no variant is specified, the Covered Source shall be - treated as being released under CERN-OHL-S. The Licensor may - also specify that the Covered Source is subject to a specific - version of the CERN-OHL or any later version in which case You - may apply this or any later version of CERN-OHL with the same - variant identifier published by CERN. - - 8.4 This Licence shall terminate with immediate effect if You fail - to comply with any of its terms and conditions. - - 8.5 However, if You cease all breaches of this Licence, then Your - Licence from any Licensor is reinstated unless such Licensor has - terminated this Licence by giving You, while You remain in - breach, a notice specifying the breach and requiring You to cure - it within 30 days, and You have failed to come into compliance - in all material respects by the end of the 30 day period. Should - You repeat the breach after receipt of a cure notice and - subsequent reinstatement, this Licence will terminate - immediately and permanently. Section 6 shall continue to apply - after any termination. - - 8.6 This Licence shall not be enforceable except by a Licensor - acting as such, and third party beneficiary rights are - specifically excluded. diff --git a/Makefile b/Makefile deleted file mode 100644 index db6c16d..0000000 --- a/Makefile +++ /dev/null @@ -1,12 +0,0 @@ -$(eval venvpath := .venv) -$(eval python := $(venvpath)/bin/python) -$(eval pip := $(venvpath)/bin/pip) -$(eval platformio := $(venvpath)/bin/platformio) - - -build: setup-virtualenv - $(platformio) run - -setup-virtualenv: - @test -e $(python) || `command -v virtualenv` --python=python3 $(venvpath) - $(pip) install platformio diff --git a/README.md b/README.md new file mode 100644 index 0000000..426fbb3 --- /dev/null +++ b/README.md @@ -0,0 +1,26 @@ +# HaniMandl Hardware + +Ein halbautomatischer Honig-Abfüll-Roboter. + + +## Ressourcen + +- Repository für Firmware und Dokumentation: https://github.com/hiveeyes/hani-mandl + +- [3D-Druck-Dateien] für verschiedene Ausführungsvarianten. + +- Diskussionsforum: [HaniMandl, halbautomatischer Honig-Abfüllbehälter] + +- Weitere Diskussionen über Code, Infos zur Hardware, Fotos und Videos in der [Facebook-Gruppe »Imkerei und Technik. Eigenbau«]. + + +## Lizenzen + +Die HaniMandl Hardware ist unter der Open Hardware Lizenz "CERN-OHL-S" +verfügbar. Für frühere Versionen und einige aktuelle Derivate finden +abweichende Lizenzen Anwendung. + + +[3D-Druck-Dateien]: ./variants +[Facebook-Gruppe »Imkerei und Technik. Eigenbau«]: https://www.facebook.com/groups/139671009967454 +[HaniMandl, halbautomatischer Honig-Abfüllbehälter]: https://community.hiveeyes.org/t/side-project-hanimandl-halbautomatischer-honig-abfullbehalter/768 diff --git a/changelog.md b/changelog.md deleted file mode 100644 index 38ac91a..0000000 --- a/changelog.md +++ /dev/null @@ -1,44 +0,0 @@ -# Change Log -## 2020-08-13, (v0.2.4 bis) v0.2.6 - -Display: -- Logo und Umlaute implementiert -- Stop-Taste verlässt Setup-Untermenüs -- Anzeige der vorherigen Werte im Setup -- minimaler Servowinkel einstellbar -- Reihenfolge der Boot-Meldungen optimiert - -Programmlogik: -- Autokorrektur implementiert -- Kulanzwert für Autokorrektur einstellbar -- Kalibrierung der Waage verbessert - - -## 2020-06-15, v0.2.3 - -Hardware: -- Angepasst an Heltec NEW Wifi Kit 32 mit angepasster Beschaltung - -Programmcode: -- nicht/wenig benutzte Funktionen und Variablen eliminiert - -Display: -- Display-Ausgabe mit sprintf-Formatierung und kleinerem Font -- Play/Pause Symbol zeigt an, ob der Servo aktiv ist -- Boot-Meldung - -Programmlogik: -- Servo wird beim Boot und Umschalten zwischen den Modi auf Minimum gefahren -- Umschaltung zwischen den Modi deaktiviert den Servo -- Der Automatik-Modus muss ebenfalls mit der grünen Taste aktiviert werden: - - ohne Autostart kann die Automatik _nur_ aktiviert werden, wenn ein Glas (oder anderes Gewicht!) auf der Waage steht. - Es kann also ein leeres oder teilweise gefülltes Glas bis zum konfigurierten Wert gefüllt werden. - - bei Autostart wird die Automatik mit grün aktiviert und startet, wenn für 1.5 Sekunden ein leeres Glas auf der Waage steht (Anzeige START). - Damit wird verhindert, dass ein schwankendes Gewicht den Vorgang auslöst. - Ändert sich in den 1.5 Sekunden das Gewicht, wird der Vorgang nicht gestartet! - Mit der roten Taste werden beide Automatiken unterbrochen und der Servo auf Minimum gefahren (Not-Aus). - Auch der Autostart wird damit unterbrochen und muss mit grün neu gestartet werden! - -Diese Änderungen müssen sich in der Praxis noch bewähren, z.B.: -- wird durch Nachtropfen der Autostart unterbrochen? -- soll ein halbvolles Glas über die Automatik (ohne Autostart) weiter befüllt werden? diff --git a/hani-mandl.bin b/hani-mandl.bin deleted file mode 100644 index bf27440d6a4fbf6a24bc80d7d25ca69a5f4ff776..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 279024 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

5ssm zeRkkSj5b!88J}-^Xu>@qX0bgf<|(`;mU2r44s`Mqb@53iE#(*6jt5c{DG$IqwI`EC zPYaj)R9Zr|@Fa+*QOXH0)sXMYEk^^gSKpaBR9Ia<$At*KGfWUu|gy;YjX{;8!Z`&3# zHw0@-6`j+F*F4r97e(Cszi7`@(Eb`+e~{<->!M*utP4I_1G1i;5~>0w8+Dq~%UbDn z;w`X&aA{mF2AOD4w@fiMfKhLAY41%DiU<`%}BgWMC7zQ>&S@VGtn83YxPdE z9Po|8i!FkKzbd+~(o@BEZ`KQ4+7Dgb?n~l}+J;Ym@UOtr6)ufm+F)oH>D_lo*Zk!V zFH+l{ceM>4|8OFhenLuTx9mH_1=HAu_kWtU@wdqOqPF9oQhjWQMkuE(!oTmk=Fdd` z$5a*lD5BxOPit+G)b$j(=eQ`iFm;&c0jyjLN=)skE5y5GkaN07+Frk!#djF}0?E)1 z{UN~sX^}4QyJVsI3`a(+)nef_G5ea>8bN$%#AzUodcXUkxbt1J?V^}oC`;eV2f=d; zvh)SCb3(ac<+(0EcgP_t<*pPEvMG%BiZyhMEgGXC|0l6#QJoxd8#Fl6U%Po)@dmB? zA7X8!>Y^yUuj5iZBI%o@)mgG2@ZCPOC~R;13XjZ&b+wo1@?Y50yS#> zkXTmk&WlV}lC-qP^lxZwjbirOqUm4a%1G;ey1iet*HN%iw*h8Wb@C0fiZUg>R1;w} z=QS{<=TuE9GumxV2kEV0)XLUqBD0*m_L&sK`ns4S+|sHf_S;B7y?^IB<7y&}d!0B( z1z-ktxhecK!2c`BAj5G0$33P`iZcB}Oh<69BS}HHc%4ytZ2)H3e-v|!#5;}T-Gv4{ z8CGX7tw;5FOq~MVnYRFuCKGu+tk5Zzs?ph|X(ao3aV@P@w-VKEGG<8CPCy#8$U3=H z4mxX==$=LCccZsllzuRPT{_K`2`XcJK1D6H^HlsAv23#s-GKvUAe+5Pv>v~pcgmn@ z8_`D$0oFh{CDJ&L)&&DzdN?u5*=LUh#@7&Fs9ipKdKRKds{RyMRz3T~+mW)7T*L+Hk3ASuc4i)%EsYb@2cca-r%IcKJG zOF4sNBYcDZXd+|#N~9Kd=|7|`pd~M2(*H6#gfiM%MZ^0+Pzd=T`GaYgRt(~Zb;Si_buqJCec6A#ZW|t1 zsjO41y!(s_{o>12@=4i}uqk1Od_KwAIiT;hatah;7|*(S!NaSw`4T$djd zPf7y>d>6uD>vc93=~s|G-g8BS*#fW}O`nW%;zr9V|6i2l`2Q*EC6x14eSQ5Jd|hyr za9MD4z8DZ&;z^P)&2RK`@djKl@Ee^o_D2RTio#(In%i;QFIr6zwmp6w_a|~Nlg0v^tRsph+3vocJt(Fq>Xb?Ga%e73hQTb( zahGk~SK``aAtkx&f$>dYz)&fPKIkV?ds5Wx$*de=%^NSrjb&en?9D0KqW+;|y7D5@S~HF#1lQSDKGP zAAiMjRJ6~f`gs1Ne0A!?RAmNiO>3fdq}EOhkv=6V0jFg7QLQqR1#eXTBsRK9I`ynp zhE{XNaXs0-eBMS8p}a8RtAjZN3T zVY_(C3;GAImsJN^=@W)j{+!Oi-hq6HJatSPu>SLWDumOLQ{~tT_{~l6pGonweV?Ak zawa!NU4RS1^43X&oOvM9_R0CQ1&*{gINzLMtSkBU^A$_?CF_CC@6+YnvsYl!DB=LN4|N}|;Vo}~%Em4EBJD(zE;1LKEr8@7jr zd~w5uZRhEpOF144C{HR+FV872Dql}m-^5*ge!J_~Yui#@qYO$N=!`vO*{VqWr_)2@ zps@V>>LPaHI@kHf56W02%#PNToqujUtLID4KXZsF5(q4@E|@N;Bo60tg*@de3*yPr z$aTLzzhTldcQF}TNNh2c00gkJ?mpe{+qTjEzRb}=4pErrmw|J&#bqZ(r3s@_v-nU z`Tp4Xiwv+|!$t7>RXC2pa3-Fm=Y=-}5QNV@zt}|=7c05V^i*cMCU$=8(%GeDcYcZM z;T@Dv1@rw2qgAoRnTCba59b*kdSx=pq(t6WZDq<56bacFrLFTxmYw9UdmgpqXRk6O zSWAtli=3GeX-hqymQMM~q#uTk$lraw!ia68iNn10{ByMa9j6Xi_q~hAZ z8PjolV1AGtW1op#O4Bk8v!^{1#lST0Nk!c{zLqx7z@0ZUdA5YRDvcj6Sd@NK5$Og+ zdJ##OziLA2v{1BFf8H#QH74Lu(oj@hWWwn5HMhs?=BE3JF*2oLwlPJPAZJIln9Rbw z?1$dI)&4EHfFbO!w!?);H1SSM@9X-!9aS95z;qetiYpo{kA=KOGKK<#Pl z+FlQ1mDdH*X5?&Vq=ZA_1WwFNCWULCD2BxCC zEdHO^=2y}peRl+98~?j5h$$#eiOC%syS|8r0Nca1!iIzh`+jr^;z4u5zL#xyaWpm! z53e?qbnUAZq`Q~p+7MsyYr87yzo;ym-7d)=^mEpa?cZ8gbfsEZ^%BKgbt#m4V%yNQ z$ht(G?t!9qzbS@5o~x+IujdhptLf{ZoiE?IHrY>-Bhw9X%bgBL;4eFYXdoVIjcZ&y zhr*NIlP!!tUhpQze@2t+Mru8Yc=T~@k=$0$g`pcbHN-l(dJf&NYmC^oWnFs|_Roim zd;MI!4wqppvnfC--EB5J*hP15|32gtG>%}t(ZMjc$MCBz5c<<0=UzXqU);zC4nv)R zdl|a}ChRa!??P#?Tc*E)EJzsMb|Z3(RCBt}LtrZXp%H#|m%}O0!&PX3CVnU|9W%N# zPhL3dxr1_`y?sdF9`sndd>;=9JKrvza@96NYT_{WRf7NUC-4cOdVEJ$1`S;-^SB%V_hBq1?2?vbPojwDDW@yPbxiDP)^{}ucF)AF zz=QeOku)XAPV6O2@f1!EhSha7M*!eIJrP}jocso5*S=cvrgFI`w;-LxSI)3bI?gsP=o=csk`|<;i582LjrtKG?eEcA$Q6%sjPLMZ()=9Xi z9hGLL4dlP3Xt*>BW5#uS*V+6XN_oZeRc9b0pWaw5M$@8qC_2t`HvbDLHJ*QTBHFYd ze`CM3gJvur6;pT#@K~qi1=@v*z~`bRNjM}2Cz(DM?M2u(kHDK|ehQx?X&O|b6w#L% zeFaEV(x6)I^Q|21b545H1`-#`GOlhDOx>-GotDEG7@}#}kfl+erw9KEo?!?-$OVk! z`c6j$DmR@FP0NR9F?1Yw{@fX;8=AFxJUn*l3By))71BZ)0$?h0rW;w6EEs2~>zvwS z@Zm?w51*uO$qjFG(gTAc*u7RpLC^C|Qr{lN|EUv?SFCi!=*@JEhdzxl)OI?h21@G3 zs19Ny!S@qR`{yUvAgvAi=Ae=)Rc6l;!bl+$X`ZFZ*yf)w{zPxv(xdA#lpk%t_L^MX1T{UJ1KAtW&+qEmt?u^na)f_3(`}|D-l; z<<|RES>;y)SZ$af|dRmADzP{p?#W{tB&XxLy4ltz~h<^Sp8(Rx*GEUYop>yYv z(M^VSZDs$mO%BI|_EUJA4NEKO-Chk=$xw15Rg=g%ZRgt373H#JzX>*@Ch~OoOihi< zQM;lRciq<>gh{!MKSl_R~84MC-7gJ(nV{T#+KzW498At(0IX z*4bWP2kNkXK@%THiLQ)Bn)UNwC|(LRDZpfba?#Ln4nwHOoTN9>b>bd%;KQHt68I-L zY{=c;5OlxioYeiQcZmM6+p}BFfk&3YO$2{{lkd8H<1sF4!m{`0vtr5`=2i7%}n+T{egPHwBORH-3;+tXs7%t4OzM%=TnuVPf&BF=f`ZZuQEn zTwOlTnfwWEZoYq!C&Y-hmFE`EW23THo?G}1gE<>QxUl%#>J>SHY@Pkw;|H;8Ot3D= zjUq?yg1pKuy#bf~!ntJ+uoDV5ox_kw7YJ_f0&K^$Oxxmk+=yyF%SK@lhv#)9c}CfY zNw9|M&0ClIqlQ(NCKFKr$1h09i9U%jHn+P-V1daZE<$X5#4*rdW$*X#BpAVg3a=N0OG3d)NXuOZytMbZ93v(noB55wIQtjHV{cWDx1@m|GuK%znPIX*G zg+Ltt8m;lT3UBklTpzPdE0or($Na?yVkyMO9{%MJK-}t`u+5{kbabK26|{0$`yBwN zqyYR0ib_aM&17MHp*DR8^76-m2|+Q{esJ|t%EL;G6V;a@wbMworNUG>bzLf->P{US zQP!gYNi4+&#S)!AO!Gv;fxu5?jfn^SuzN49jWAAvUknwj(G-+m4YmeKxJ<=Dyfql} zfHYSd_5`j7jpiwAT!4WA@B^Yj$jf;e`0W> zIAh_Mj%0W>0EI$t9Ou~(Fx@&d>-$O8r%{yemK$oioQ`o3Q<7 z0IF5&5WC4Ts?f6b`TrPu7l5XY?0@{`-kT6GATJS> zwn;P?tlcG13%FVmKptvaa4TRRyMPU9x816Bx9ZxK8x?|L3+PsK?QSj_1uNEzw#8O= z0WGB#x5aiV@-jSPZP&JHd86e2nVSUN{eFMH-yc1hxie?Zyv{lEo~ay{dj1W^(Te^1 zOTDRLD?upJ?cWb$pU&K<#FRV!FT7b|bQDy6;FY7~pLRGVxx34{R0r9d6ntNIc_lSD zXQoG;@Tm?>kPG+Ux+H?D3B;IU5Mv6G09U^{o7$wZt#eiew7+oI%QaXfy&3LV!UnJT zkiF_ly|P}tG~rcF>7cv}d25ANSvv7aYV9BV(?1OgZwL+l;KA_x8R3Z!hlkS*ODIKh zp-yo+9}^;IA$5vj9Ff2_CY|ED2IxI4ELZX+@Qa4+Gd%B*np!e2UEJBkJ?2P?rW^1Y zOs<5BcI?PqHJ8qxPi03sqIDEw$jTB7IJxd^Fc?a54&}X&Aj8phiqnxmGQAk+VOJno zBvrgMAX|MeTrLThWhlWR%CFhzfYl6ED-<#^5G`89UGF8;$vJxSwpml(&O_1Q-kZ4d z64ybGXjRmsSK4nI2YN9JG&Z6>9*g3O)>)_HOokG;5v*%GYy62I-1*-SJoSOatmzWy zRk3U)%g~*f+<-AvuBSbDU{!uW{pH@z<73Jm~+;=*&JJ3?8EyO|CYoUzRdzR%9 zv1>!)cB7d!!Od;G_0|JITQA?%%MJE`Axs8n!$&!4eKr%9Em@XLtxSb zR5FPywM;F&q@omx>bfwuqbHWkKrhoPib)Eum%J6GRWz~S3{nDby7y= zy4*=iGnaM9FM4@GX9iSCJ>jF7sQJOo6}|Q4$%3tyxAk&$Bwr3a8@=wp?&flMqzHfO z<^R^peM~$wI#$700%FG3pQA5b3zA}L7dg~hC1mpLuq4hZL7j%nq?)A?Yep>@)*q5& zJW412-Kn=yk28swHnCC|w&n&+AjN{~zbbA!GAOcl7j&S9($`Cxw;}EuLS8SQ*UKFs zabwVBiok&-h1V{x$o#E_Ra*;W!Ofe2_Ji=pUjC20T&bAEnQV@lPWpgOjG%JVlF7Mr z2dC$U*>V1j&prv6K9BV*VHP)*pOaF!b_{->~U+0<<- zb@M0XrMj?-6RYcR#V0ziwnMTRnM&C$#dSl`-;^P$&jUC+Urm?;BsM)7|ZfD)sS1CXSfJ z^y%x9q3Ug`CD2Z0wVzr&ab}rxyv-sl#%6JdP4ZHYV=4-X9vepEaXqla_A(t4*r29v zY&*+TsJR^^rO9f&+JFAs7_~=)k^__GJR42NsPPg6UdKGk;LR8A4T1{9$jB^w#1&ndkHo~OGNt)m8spox!(jLCFhdW3T zp!qkG8ze2SPj>tn`Y{>$@o`B7ZMj{o_CHZ(-oJlepz99X?n?E9vf`cQ9Xks3H^zG_ z(Q(ICme>1hCSwxlLDxKsW7-HQN4P?LXuhJ$>t~QzoJ%zFW_m`Vc1^F4JT%Q&BSXGY zWDx`UTz}j;FT<_#I5?Uc;L0P0F75i}-yy}D1yc`i>fv4$Q*397;v>t=sGV{vRem9r zJ4Ku^IT6xI{ovEV)?Y{^JqQQ3l}ZVllekJY8lKv#T*W!z5Ne*6|1zec%4Q zhsBx~B22vy)x$^iaLMj4rmq<{4{=mnHj`d28AsOx{R`pY9{%ATZUI5JHDjh*5~ub* zFt_<(cz!9&=;3GdaPvgZFPL1-l;qpt!NJWl;MpvM_3#h$aK9j)j*E=u5ed%D=nm{@ z4ukL4!lWL4QV$nSd^JssLe_wC$+40uC#}UJgh@-)ewNz>F?6ox88Qii68yxeR|gze zc~*)nVlg>)>Z7hYw%r}h#~UnqwRgy`C8%J{pd@$dRCoQ44(FreTy)g+iE?s`3=_Wo zmAmfEDki;=A};f>g;A`arnk%MLJ7MBNfaR@J<&LiYMUX!C;}duVEP8RoAe{+fz35K zFqX+qydRagBkUW_zvzU+JW2lNPK4IXLrm_wOG8T0Y)~K5Yzv&=>GpmKVh~Y z3AX%mrQ_-6s1#j$wI{;n3?#Q)Sklce?dF~nle>>;-|EUrD*O%#3EljnZZ4hpIrcJ| zLCP&($?!caEbQhNc5_bOISy~S zGSK6oSF<6%X2A50TFBUJxBPuFjGj(Bq&cxm)brnSF zG>l8?JTm8K!+CW`j|4Jh`hogffW$f4v7MWALL7gfkIlExP047RP2WnYRY=JUTLlrn zG0H7|XNDU-aZ+%(OXZ&vhdJck%Wv?v|Z!*XvCB zLCG>4jK%qpYw%4ITDtg_F7A8c>)66%t)!OKCzFF9S4nN4V{+^|sSC|cvezuS+uaNB zlzVjCfq0a+`Xj7xtcyR^#hoSiq#hrzuGf6w#%o%Qo)cZ+};9c|j;wYJHBng%PTImhiUsMo6fchUKn*Ymu@G0jr&{%u#G zXPdj$1S(`}^y{s)o7ZoO^HjyUYxYfaOleBF$3eHLD@I*AuU3D~x&?1g`LBDW>nwRX zV2l(97Dd;s?^^uo{3v}+*s@Qo*qyjWx@OYoqAlkl=laKJT=_Ijr!}{*IhW4+H+hIe zwZx8#2^4|q)ztQAu}vanu}JcW5B6l(+;{GSSKb_U*Kq}HQhM;LD?M*4d}z;8TgTt) zAWLU|BuR3I;U4e8Q6PCCS_iS55RMD&+F>pU?J9^#L_*5wf+>E@30-xIx~i@3@CjYE z;tWgR1WRFH({)eYxdkACZZG!T6jVRmyr8Qt2FM5bm@dLGyE5El0-EP^)jcYb(Gwp{ zk(*Nc_&}120Hu6!u8Yv}YmVruix6prcWDYUxFk=~Nu5^LKh(UzUT;;J-?QVUSTvTV zm&L&o#*S&%?b$QBR=rOrPN%Tmm_4;C%M^(VI_m4hjo_F+68yUO;4af$Toc2r3hgPF z6rASMm4W3%|E{_KM7f6d?s9M$X%o9rEqR#aUT>w|@yh%2?&7=+*|M(HAz2x_F}}_y z^K16%s$&u01^%wx@p{HG>)5LI{hFDsI;Xwb`a6EeZhI|bT5j5~ea$4Cilwst&6Et< zi{FmSN>_3}*w_7R&r<{~`@QK*1zjXl<|SL(nz+cXr37jO-unSsz3WRe`~M%4(KoN9d^ebN%XJ2AJE)muj>(`Z?U7KO@GLk z_G(&-ebe~HI*5BF9rb5fG?_t+p*@>x$!^wtcHKAjDE$)UzZu=<_Go5ikYDq8d)+4> z_YQyFZd;q7Yp`pBCa5EV+G!69=svcqYVG7DD81D=^W<~QAKU9{5aJ+TW4FDOL1@+3 zvGI%$6YO=TL}G&7@w*INwH-4+BDL`bMt8)nsuHPTjsWERnvdA)j)>$A*=?&ch`eCl zc_pQL$v$77_L3bZj%7;n*j1X)ED^ec1Ko* z-a3|n^z5|P6~OU#e4gF*+l*<;R|Lw!Cj z8zo-0sjfYcpvSGSgE??uMBY@hWtdARU*fw)+^^jp(U#~kEtl%?K$tt~=Ev=IPuPVg z?EDjU?w5ol5p_Std@dB~tSq$Xw9AGicLrw_rp+O378BBQ7y2Ay*nkzPP2=NOZQVt- z+G?w~#Dx(;mP-?!dO8z_ZM$Y8&db#5^1`c7i+meW7VP#pXYuBug zDA(r%cewYUG+wG{UQ({PBavY&8Hem7SaYmY&hylo;AwM0$o)cyMW2%{{$`ZduQsLK z>0laFH38VzxYy}9ak}tkw62JWz)U8}3!`WdQD~V_9c}Md!-(kN`m}O?ocRI>W z#)8)+D(6-7JHD0hV^`7P;qP8`TqD0W{NA~$xhCO$x{5gOO~>hm$oKdj5v0UXfb_7o zcbw)+60eS?%K>isoh68%r*hGM>v+vNEU*9JFVyIObcs?d6sZ@bE!=>($b zmZy#3W?se0Fk-?@+4|Mvs(@=FvBRz4yj_vO|S zmN@3~|Db`H75@3Fro&F%N>W-DMlo^W#C#Jr&t_WfivrS?TwS~f8#~y^_T+#a3HG@G z^FN6WYnijN>C@c{lY1zOzt8(%_xEreJF!?l~U5~ zFt_(}_j!x`OhzVg(F)nhe#<1;D*|>LweN=lxVnFT#gvMvl~az~OMBT=ckzvOE?%@R zIIqGARFZ#wuygiuyCQ0drJx+I;Z;~`CNbewpan%I+2KzCz=f4YvtT$_h>urI@6D0Ge8G~8#0YavkT%DEF!1r>%~#ZC|PpWH-Fk$ z_i3l_ZYTe4C$~#Xfen{IMZ4wlT2N4v-Z2DJJ(M}QC`y#>ak)*8qcnr?RjXa;x~BH! zzVC1;D-oAqy3)%XCt0w_53F`+6V+eFQ{H4&sPoCR1*syM+v~|kHl^c9piHJ{dDcow z)Jrm5Oy_*PF{Tr{s$KmV}89bk=PL>I?j~PRCd2=+7jfKeM&7?hQEpj(?-m zb}1eExW)bqcwybr&b6;Z?qZDbod#EbX7a6qpa8P(ZhdFnAH_J=cbdLP*CqU4;(VdA z?nN=qRh_mbPn@}(b-7}kIi04@#W;`6b7^oF!|C4Ya5Wmyw0e3lZt`0hj5EaKyxuRH604Vv%pk9TSs(p>|U_VLvLE}*lJZovFJc*ZqWN$IRh z0{%hX*okh6qdwhDDWKWdSr;!-nooR8bsl2(#wueS|2bB9w6pF}k=8FdO@B{UMUdJB zi{gqMSFX5c+{}adUbQy(K+XhQLmJ%V9%(MTS+1SLO?0yd;brsrv6AVX1u?v=A zJt7Qu@WUNkTRUl9HqpFyr>)Id@_@*A*jA0m?%U7%b9=#_SYvDl;YuRJ$-xI&js=%B zTIvfB%(ru=^7u zQdbS(@b_IY3VCj5jOG=xv4Xqda=2mP9&)2YEaY6+_=lyjtiB+|hnwtni5M@@l7Dwt zkdu4aFsl_M&4eDVQ7t&_Rq{__FZ9l{SfTEBRzn4T(6RrhDO18XbfAyVU3A4AqGkE| z4##JBO0nIQ0qp79NR>5$Ucu=HP{kNt7wqx1ikmPs`-j9$JvH^1FWThfPj-+FYb!bw z;+n3PK3nF=tuVWziq&L{zUFh_BO#)roPXYwKDyASX#S>F%unJN!z@yL5M{lU3W;ae ze?h;1~u7aO8ZG?y~-c=8IfC$$fT|7NIN+b zqKYEf)6)2f5YTZ{P|8cny1#XVO~57>)0vEjaf-LLblkjc?Y2_(PG$WeJW3hHzukcc z8}Q(-`U37YadctDa|Ze)3b|^nSfCV6kIDQ8MXf z$4g3H{;&GxO55|c5{AS1kie-5Z$)Ti;qH=M?RY#DjySRrC@ob7?k#%|OSJrg4qLQ@ zTS*cSrzLw6U`dffJO#lSPD zkPTAfhIT_di6w3Zl~no&|8R#@?5g1!0Dbe4j(Xb^VM+%-rGp!7Bl2gYUCd+p;}CL< zjv8hkA`k7><+Ml6CsZ)hjVh%bjxl$cgs5dMw$n}Oh!op2y%sDYX`Tnte--Esp6TFv z32D=>XkAbTS&@9l$;n9qE%F^|SKyMx?XFI0g?#5x+b`XV4QFXh5+0twxdJyszl1bF zfAEqH+dfhQwjHDfwDtVmcH1$+*G61I6?H1Od2$DtvFvH*d)m2ANaVITH1UxvWcl0e zjz2ry&1pVb!8mnD(r!9`Ar*CMnL$(=+|2g81d>_oJPOPxR|oF$ad{+7l^VZlOWHrl z^;z;jd$AiY`Fzqzy&Ea?muDGl0)yHiM-|*81Medl3^j!LO`?_*!3`3kp+vQ0sV`NB z>@AbT)a!G`dx>T1-(Ew7?Td`5jalyztco0$rqETj&yR`PAGvcG);_}|+Iro`?MODJ zHcoo!P7`Ycqf}e%`hdvk%GCFjJl`I9G|v$z$qklUMIGVD7~-qiZDrypgXm@#kINpW z_=yGa>g^GHG9FG{W0_d|HPrOj25 zgwaDI57a6iP{<#b7eBsLINAQunG?IV8gSChQZZF^qJ8H6lM4D+x6NNtQclup@t*LX z%KpEc8%X5XhsCwqb~!_qNyzX>Mi~AfCz1yO7_zMIbMvL?XQ$08HUF*?d9s}uD{8eZ z7*dL(C^WVC&$}lPb*tK4Eir<|P2zvouG!#JWs7ADGNL7nnQIXA) z&3Wy0dF?_dn%6oLGdb{iT^OaNdX zLkx+GocDr34s*FE5LPxS+C5a7;$53WNW&nGOI>xPbGEta2i*Biix7r>*Wm)y*#nu zB&DGZ(6zNGr{}5Fj23H{VUBCmPAu%3u2GiylHN9iCne}r(nYME2Ky{Sh7cFp_8--B zV9hVkMXn%7$~CqY?4A`}?@nBRJ8`%XsD9?0K$olTbCN|x5a`9YC&*pZf)hS9ZTm~L z-s#=_s&7erTKbM&7JxFfU2-0n>JI+#eZf8YLDw##GZRRet5=S<(W-A;WYX(L-J#!g zm#>!24Gge~D!~>qB@3h$r z&OEUYjV-MPu^Fh5SAQM`5ycXS%g5zhAuqomH#Jka%!BSEG_|^_xQ4F&T+YAV=4hnE ziE`B&B(c?M>cq)BSISJ+#&~m^<8dTGSosy2RA8<#>-W&2v< zPS2_P(}PuobN@3rwnj?zygRbUk3ErH9RoEqK(4&=&$pTMSm>pWeWlfF^%#TgXsg@N zCM<5_7q@YxyS=Cy6PxR+bcDbsQZAuKC0})dMlPE(SxPyl(YU*uYjbXt~0!Iu6 z`6+F-Ij;7Y4{38e=-~~8J7dXm?BZF_R=1!{7-{84TDkTsr2I}xxJO&_aP9WEri|8O z1DCF?ZcdwUvz5Qu$~6;2#|PL|sHviM#$z$<7<8LztQCpU(goFW)hMxI5Ke?h8-V^4 zbX!lW@@SsvAZ{24v@TY<_-^J@smgw3=Kfz;&bb^)B3g?@-64u+bcj3C2s@r>88Yn- z9jvH1XF7j>p4(eZGhBHlYm8oPbzW`4xmNyMD|d(_nvAvHl^{EkwmP~^IMd3XY32SZ zW~WlZH?^7+PVO8@dzswAgv)2w&~U^jPGL`DD*}(4eyAeQdb+mY;|GiP7YzP%t8JQ_Z?6S~^Y6FXWMYSPa17lg*PK8Ky&}+~F8HceTd0T6 zkG47(XNcantUgZ^XukJ~RTOB)+Ya!j#;>o6V{{3@6`W%TmhmD#WmYPuO!qBT_QK#lEsa8GJT0xuEA+ z`xs{=Zr53zu@&r*OQ{U4SROD@TukeIYXDKL=tU^PCMb^D_S{v?ZLOr+Kk}r#d2Va{ z!TrMAR(@_P*U$p7(`=CNvs-Q7yYih)nTDLInXTgN1$KL0k=*rFJScKV-78lFZ7Z*B z)%amh0CkIuwdXWzTI>0lg0huYwsO^kAel}1y##fWO>vV@h9OV0F_M&k2-UTfvu#ad zxw8VWJ4tp{qVglfQ+AhZrMM(+iuD(iDmffAdp(ZWLIg+KDe>FgLZECKCS!VqiBnTr z{SvU4?KhOARNT00S)Uu4V9D9Bt>Dz;!oY|)A_?T5>eiJC+LlS>;~u|mad3>?y?!XW zerNmq=Kd@72mc`abcO%v3dfNwIC3Pa-YZ(#LZ@dA>w2zO7^D44Av?aVg15I#uM<_l zUB3cZD)`99Hh`OZ3th9jxF*9>+?@SN1UW2;G#kIXlFTO0O`f~tknPu$WkYW0oSNr5 z=!?v(kI`JUVQa~Bg=@Bp91_)QsQNvl~`u96`>i}CFtA8oc}85zN|Hay}~ zr!f756?C@LivAv*ID;xVLbQuTZUuH)O%Ar4`+QUb4SW$<+h8e0PlwP!1+8jKv*eJx z?r0))VCrzD&zClrp%Pf(%`5zyS2(4Z*~OBYw9`55AA1V3`7NMK6SiOBw_o8Vizvww zYpc?FL3!e%JT!Qpig!5Ur5~F6lz6+i3P=99SFV(6DO=^;^cQZEtdcckWB{+&V-FEd z8sn1h#8Gn3iR)c~6&$%Uzfjm$SJ`~Jt2;XY4-G^zj6OREFB#~wLn0;kog7KyH}oB< zK6}cg?5U;M(;9E#X8p1{*9!;RZ_%!Y5$aV_E~%!Ls-~&y)_$U3e7*7V1Jyy1FE7T| zSFH-st0pU{AhjwqQWB)3gY>E(ZCWG~6rG*CE|Vh{_FIIqx{BtSE-?aJ-H*HeLF7>t zrAlnssaLQm^b&QHo=iu;Emb^Yt%#3YZq_~4^7Nb~@d_zsnKv@8mP%GIOXeia`8n%a z5O9@t=0MI5)F%&6zJ5hl)xV{i=d=v{(kq9#?mO}r=>I@T!{Bw`m->fj<($ZvhngS$ z4}Zkv?g7lYqMVKnx@)-(%%mz6WDx}cWGxmJt{yIpr%oe*@~VVddT;tVj{}Nh&sbouqL%<$EY}l z*l8{d+%mjRyuF6pWJ8LG~E5s$CQEmJDwM?M~~OeqYC0gad`|9dz~Tv=d+x-!B;vrJtPSUF|NYrO}H=47KCs>4atH$yTl9{wqjsP=+Y2-fYy5a=KF4OP;qNM=^*y zYjC;GRYC$HU0&pr3h1co{b%k@YW{so-ODZ2)*AlzEw;y&Tj-0l*LA;Y>&N`>TDTv- zffCY;;fO?0XjF7)8RNC);U)D2LE+WbfAA|?xND;S9V$<&R7_FGm4##+6Q!3Zy!Tp8 zVNOEq-&9FgGuZf$?_X3AnOVE+lRJqLQ~#-#M2}$Ly*EkLoU4g)XY=U-HzH@!n?g)Fl^^q7cDc-oJ(0 zEk^Jyg$E%P`4??in@}5f{toy`!Da@M=r%E%ri$fhuJQ^h6E%nM-{vm;qnJ9~)%XLGSNm<;!Y*G<8oaGqHN~>b=efU9PfKBd+$yLmY`CoW%d3UyXnMaOs9cK zw)=;KN(!b2G=Fiq?h7%EpItUhT8_dk2o4a_)5d>tnM)Swe@!kS&dXzqDvDFtqCY4m zk)%`4$ENLj1?^hj4`5KNX@Ghl>qHap= z#5M*PVwLorSVG|o*qh+?4NN=CR+wMH?1xzk^IMo_VBUgR1Jeof6in|xL+p8&6@U=f z*&Cy=Dwq_^*)TW2JsRfFzei)^VXnn@D$I>AdjU}6v2y{>!EGD96$rNq_H}?;El%e~ zm|Fmi^^~FDH-=aX(whfZ3%qS`F9J}8w+wq=w!|4?55VmBr6INg=5as`;0Hj$XO!Wo z2psX6O&N+cfQKo=M{sXJoLc~xgo>343SwjYd2(VV?(x2c!X> z0jvS^{1IUhMvlC_itp`!-GFj{H{e}>51Y zp8@em$CH5HZZO0;@x2Q634kDg60j;aH#ZseFy#e9tQ`LB2>a0Xf2TbQ^GlS=PT-WS zH^dghv;um=DZ`h(s0V~OhHnAzA>bc?m_Hd}w{AAX<{|9Yfad{OfSX8HJ^a_fejWBZ zfJS_O1-K0O2JzZq-hzpZmxf!gOAvPeAQTV*D4HiTTt|59-jh@H5^AjiJcN2U>= z2b?E&e$P`-*OPq>HCU*ak1z&6GT;e73+iAwOiK_&&1UYzZh*ZOxJ58eJmzaS5$kJM zy3r7uih4Q(w>?s%pS=@17q|ytKLl8Mo-!PRd2@-cq3m(Ulx(753p>$(`&X$kKqkT$ z0gid!iTwiR1;9DL8NkviH6`!s0(N8$rHevdvhXHj532{{-X%>-w3xYFl%6j z0q+UGbATOyj{&&Y^^N`e$lvMMAMni}tP1cL;90;Mfc8ga2DuN)9%XVxT;#y3h(AVB zW$JWuq=|%x5EHHxlwX^aW*zhJ9=2w0M*g!80JTT8x4y zCnJ7~7v91>kI21m07XS3zCPqN4>~Usb^|~Q{;UnA3{fyG_$K^X46_OOsXa#-GIOMc zKOp?6T&dxZ+rJFvF~AAHV&HFl$=7fS_A`K5z7Up=1V zPYMJ;@|cIT(OE%q!;5Qu4U`=?D79kLGbzv}(C7=48$#i~01)~b^woCc5uqF5_Y~qq zzGLUZd`z^@Fce40466a!KY<=f`z9^&M(l|^U&FH;WB{Nu`x^EDW-yT90`R!S*D!m# zuOS(7v=rcUK14euqirVIqiv#DZ~927ePRxRx8$cc2$#Rn6tN{d;n)avk~9dza5P|zfo>ri99&#kfkx_i|~Jb8~6+67MQ&-Q(=Nr{^4}~ zJn;r-${&y$pf_r3K_j@_*Pw;JLBtt|^`8kLQpydAJ%-p|z|u10A9!{^3&BVJ{P%%2 z+}rU@K`*fQUV8|-OocLsFx`OrG05d1Kp*S};NN8PHIT4}V4n?0&g+Z44)bf6R32^E za@g14zaMyjEWiTd{s*K3?~Ss4fFr(!KH#wA4Pyw0RSJDkJCU*jHxPfc$t)DWGxl2y_t4Lx@9Lfj$(> zxd&12aLK1_-#lROW5Euf|f<&Jl!vj7KB zUS)tifMP%qzyjC?umXm9eGMCdN4*VhS^}j++8((VMQwu~=z{$M7~bEHQu4SuUK37b z^@LD)+a9E-Jpq(`6>fU)UP#rV%@{(w8;+q&09ydiuGAsW&x5@f>DdEw8_bP>JFsWM zd=YR8I7?wx5M02ENQ>o1U&Hku(9YlRH5`Ju4R9UyNPzu2U&GvMz6Lp<$>D3b(d}zk z00;&RCEx&{7&OjpWm&Q!?Y$H)V~>Ad;|3M`Lwd0xafX|FcH z3=Nbda0aH=r6von5(e6gWPq|xake5geO=l>> z*RV%}rt_-Pxu8&Lh zr3-z92@?&OpFtN~K)u221BAgo8!+Q}si7F=b-)Qgg+Fu!;LC{s(7g%xQVO{Ocz^C{ z=X_z3Hm?j206Qxq>8S-o8oMHLN$_9QX0L601 z1Yqf#QUjqyXr9Nn!N(9A31}>m8d71d1*A?u{Q~|^>DUH845`p&x#FDxdXE4|8YV&y zPlt(m8^co*vDxu2uRKz4DfVPz)=uq?hSn&=rVh0pKY>9(ZoSHSm%v?pkOzY9s7gxD_{{ zokn{d{VnAEpWtnn3cw85hv0u5&;mFQH~}aF_*4G1VPAnR?1ryVw*NvHxNZ3ca&Z}L zSqtKV-`7`AUND0J?MPE2Nmnmq6X`*h2dqK*0O$iEzIMQuXfMm)XZQ}`ue;K}0j3ph znQ%*hK0g6_F!JaR=)LA=SXv9ZaL+;>2+w5!FZg@p3nuBy5FmXR0<#h3Dd1)T{K1<_ ze1`(GfK<3SonF)o`$%jJ;!wgo0f>a(DVV80!7U7ZI?!JFZ=@Bb;RioM?~i_l8F1GE zHvRzKhF{YS=pEoYoeD^d0`*v1n~8Rl>~ubwiY$}9ASGcJ+=QOE1v)UFg8vDaeSq_T z7C;u}Q}JemFjU`4dTdM*IvFL!jyO zGi(HI5#R*iYrtB#Zv))8gEYgW?)n*?g=qneZGd9fpGUe^1NPwi48HAv;9=A&zQ3d= z8p1}vYoow}TLSEuKQpT%uu>m+Vgoh@+U1n_y}NmNeMh3>>gmdAx}w9UinXOPX4)Jc z8d$V3TstW|`azs+GSd}1j$+QxOjp8W$+xwlwj8&a)5J}*SB~$I!Q#U42i^02n7^p< z*bfJKV{t4>IzgR}H=@57zkidvI9jU?n5DfrC*Wp6z|G|WF?34c3iTSjNTZHYeL5<9 zGOAEue(DXj?i2C>vVUcD=SPL}qm@{7LyUV^u6|UgAFY&&pS#(T+EJlyw9;GrEM9Nn1p>6l;2`YPLB#7k+2K!`6esWjIOI0t(?&4 zC45Mt-o<8rFe-d7+9<2^!eM3t6ss6#OD=2Tpn2Y_5oWHL{1F zC3h-in@5Gb(JGm#bK*wUTo-EJ8?ZmK5pQr*(ff3!jcl1NZS&~n!bUdLVy%?d7Fl7E z?F7OfM|Tuf$qE@qD*{&6&9+|-X#Gp0Hwkz}=h(ou=o;D0yGW=|cc@T=TH_97yF9UO z)#yf+pljB%jqKV2Lb+1w#?=Bh%M-)b6VJ*vvLZ9Qd=E9+jT#NqbT_Kz(m1N^MM876 znC|4Pd~0f^)v_p)nU?!><_cyFEBgn|ywkQ7;@mVxsiuwIdT3NjGZQK0lhRoU2BV4! zzR>mHC<;>R*9RHkLxa;7NR2A@|8eKEMyC9Nq*k3*KV5P` z-8daE2N1767kojj^MPFO^3fWf4@+51Bi1G(d{oy)gx(QSdWE`u#w%&xWe=~@B(X#5 zgzk~XiD2VQ_IkF^Gtx*_7E@WFbL1kJ+x8^ek|taoY4iog6Kt6g?v2QQ7Bbd30uG=JA^FVO{@vB8J z+p+t-7J=e?Hkp~0kk~@@ip~>xD4SBfJ3^N9qUmcvbiM|=oTq8dzK0#;`G2Qo`*q|2=%rXJQ;Uk!9hMM%mis)^+ zFRHN2g?rvnbK4y5^%1C@x`dJDS4NOLZVUPBm>{ehx#&|Rv%M__T>62AlE$46UbVXn zIkHudWShQZWnVdQOhDo;+Xg)nZaP8|-mnVAth62Wq}+Cq)jct??%|Oft2B8|1v4Sn zaMTRR;C?Gct{G{5YJ_`^*dO<)@_KFp_YARL^y!#@cVDI43i8Eel3&~~+AwO2A5km^ z*Zh?hl1Xh{r*(!AA#r3`e8n>B#AWf7*i+Ka3i0q$*fihLa9^My&R*OiLL_b02yz%b zg7x+)smU@C_qi~d+bk&lh2+du&o*2@g&6M)d$Kl%QcPD!W46T{+Vb;?Ju#=!?hKO( z!zRJQLG6U2%EbDbMMZBDrj10tES>*o_SBI`ovKQPd&(W1bd}7so7RPlC>j+4av(Vve7zh>>eJM4g2u8Y+M?KY;+8}Wka)G zlmJaT+n5O1Xc-=t4cl6`Y?xZv|B?-pnN)@5=>L=r6E`j!wmc7qnU1h&e;*dk3_~^? zpF%cFTZn83!)d3HLYHjR40~kb=rCmC{b5lyOsho}*IZ&fvXL+@8y^mXTk2jLZay|l zWaEAE3C=k>Ok~6HyjwO*|76Ey!|_LvgZ}!z$%gF@_hiGd!IN^wUszqi@Ve)RbF5Ty zd<9xUw``P&k^g46dDk%aHnF>9V-K;9%SI{r;!4QxYd*Q@XN+5h6_cR6UZe$%)YgZz zZqu-^WB5MVFr8zCE$~y=Oz+<>8?O^0X)A|`^bd=&VM`Zf!&D2|Fs&gua}>K}W8VK+ zHs-l`>Tpm86hf}ZPoiWjA9hK`Q^TTU#7Iq55DZ5)txFvi1tVj4oS9Fv!t&vJf}yD) zf{`}-UxMNI06cH|Ed;~y+xOCs62VAu;oK(}rc*?Eo+E-WC;O3MMdlwZvY5n}N1=$Z zOpNnVqHLJ9{)cQ}pVP!))#y+%o4sHdedrW(+LU3%HU*PXzNIflhI>=0W2AZwl|Cnc z$bTluWnw&0d!~%{(l4;OUk>Al^j7|t!-{uJk1^a#Qn(ta9~Vh1G6|(P>WFvhG{col zSp1QL!O`Z(C#Cb}qF{{daO4~-w#!%IsZjFRM2ytvH7rO`W2XI(J;xJt_UMq_>ccU^ zin(#g75e1L$K@r|usK{(A5IlptmOy4U3Yuvl9m$uhd(_kt@9s-g(&VAQQS-i*^<7Y zr8SM==9CJ3N~JJi_;A=nK|WmNWs3qvKGXxwf1UHK5{2?Zla)nLy}J9&XtQu@NUTC6 zGje5d#;Cx(MC2`mb zni>ObJUK*e5qe3gWe*4H!Edo*P5d4$r|q%#@C@qHV`={!60Qu9gA(sQsCc(ZYSS|1 ze4pugHiB)q<-{>1EDGDU(YgaesyBwP*9C*77_;8m7*nci8j2~0qOXo&b^C_2%(Xze zA%ir}F(eY%a!U2eQ1+WcTC*}%I%~R8rBdfoHsgC~e;Ins2hHqsk-oMpSlWLG40%-S(k@=!xi}RS%)A91l*Ek?8^9y&*JP zCx*Z@G zLq$ZiZ9F2!>#SfV-U}LXkTu5f8X|Ip)2j7DC}vtSk>QetYUI>}3x*RTTpr1SZuZbw zA2NnB9e5BJ?>wlQJyf1UK>*PuRT+m;XqgSYW9)B1+ca}Xw_(Wmt0Bdt)ihpEWAR|# zwMn!rl62u5O4NXFTF}tV#DF*xyM|7jMREQ^!qY>U$*FHipUzB8Q>~!WVunx+t4MP& zjb0Zuq&SXTXAN~HRg@;7H}IX#v7QaPIJ>ZhzLZp1npB}UR^@difV^a|oxQGG;3K3H z+;W1eS<9BG6vu$H)Ej}%%19lVNroq*WHq7hz2nmokbbmZh!}#J1iA90iYl*tDvWnf z+>>ZzQL_*v_OXc9D})2rzHodx&|{< zt997WcwodewX~?3-1-@=jttiu z^CwZdGlS7vBY!KMKM%65m=w8eYii_%{E1ZB2ZP*&!OZQc|BycY@d-hN3)9l7@B2RO zEhC44(yH!vlZX78;$=g)d5izoVAvmQG`;TYL9S+SSyE-%r-O>ajdFn+%0YoiO+Wde zH|Awp!E&btXD^1w$RNsJ^t1gS`q?tr1ykY19~~6>1{-}uKgYjCKgV)*!S}*VPY^H1 zQ!Ko5k}B^6m-G(S^$rT(4@Q2r6}5I<#8)mWwk^Z^p4NAl3m*-}B~>6rh&_#Mz&Zfl zaS*N!HkFrrGg$Y{pwQ+DX>y1mHBYi><%2@YAZQtAWqq--$@*@SV#3l#YHK$jA5pZh z4}O|hI;{+*sb2#5>pz~p+2?Q^orqoCeSQt$hyx9Vrtf&j3(j(@k7gPh9;msdW{b)b zA3{|u4A(y`dw}Ae9=sVJkYZ8HNU2Z+N0g=1B!*JP7YDOf4_?CPt7fn|oT{He{Xi>b zne1bhfXC@VNdwk9j5&kZD@By&+$ahnbe&@sRiOmuPmJ#lc3UNc#EL=1tVY(DK3F}2 z(zK7Q)~%5!f|1_ukzVFn+}!j-Y(6#)z~#H+A)B3;a`I=3c5}&te90i5etC-Fbb~kJ z0u+TQmVFfpcFS-|*}fWJUppQiN9RA~Odt6=AIBh%YJ6GQIT9QvB5#mhD8FpbY<*F9 zcF?@I!fbuaytvX9L*%7fLgdAVOiv5ue4c%aT@AcFr8mYWJS|)Ja=j^ zUZdjt2eo)+Ll-o-PaYv#LBwOFYHR@Ffw_hm5RYZ`cNGb#Gq&ajKuD&At7qT2WE>da zn8D<2hTlpTFT!+0iX69Ppsa5V+~+1sB*)Q>HwH@XxSS1(@_-w+hTQT1gT{ctG}&Nn;cg*m@S=QuLdANFDW#6T6Fy^YS~hG`qpUQclAAkNGIvmj zC72=_%IS=VV+v&8wm-7|Hu`72D`u^JUj@uWgyGirn9fHX+ICNZ&jL$ zamL_Xi*RQ^pHP9|Xu(x%A~r?{YH+MA=)bv|w4gq;&@%wy0c7~u2%a`I9#8*Xc1{1g zkRG4JDK38g)Wgp|GU0(?;cC4iD7~C5d4GUAG7#+@QAQeAi(+~rSjr;Pl@Hvs1Qc#X zJ@3Xn@&_YME~LSnB~=650bsjunV2%YwIQYgZE;P5(~0h0?eQBIuIXo`&tWl{ia#>m z{0E5_+;xrNb`9Lr2PoFW5PoE~49B?m@vO*?f5H>)ov0!3V=qI-uvq>(YU*JUeprZ=rkl7cp;3D954W*^dvbQ~v+U z8!8%kbL^2AgIsx==FZ!#elc&tuLt(-onTQlKZP9m%ES!uK?CkQ@lukZH~a)FE5I97GFume2zH3vUd<@j{L{|W(sft+vl6Yqw6Ne5LPzG^{x})6;vil&I+^xae~Jz# zJJ`6D^0<}WW)qctzTe%4*-Z4ZZ7YgBK&_&=5BrmKx{vxJGbTQ{iM?;lS$#Ckc)0`$gb#5HSabjqUX{toa%?# zYLGylH%qv`_OG+|H_FpG`?C-C*JkV%Zuei5LY7wfr5)>6962jnzo=q8rq86NFBxuc zf5~_K^%!bj>leQ37gaC{>v_MhjUt|z;NgDg1=oZx`w=cj{BB}ilHOb&&>p*W%~lE%ac&RcU;TuF%<&n+7xmlLqp}_AkK;7SHFau8uy=l-sNdGP^{TCm zA$gyQ>od5Q`XhEH%LyZIMgQO+82Kc$C&m4)KjLJZoN{@vDZ7d1<23fRk%nFK((xOc zuc=~jI{C}A@hkjL=-V6s@*Cq>Q}xjofV#)(2u6M zN){nCRZ0-ca}t%IUz|SJ-j9LG`nU=*Jba%K%>A%qVvP*DG^ZHM4H)}9^9Lec744{I zP>auy;(q3M`U_|y&>yiq;?H5~ z2-}w1DNF=j=Izg((2r?PnRdJBFXRr{CnXqNu9NrAnyxsAjO&vs^huT1@XFy6{b-yH zGhv&ArTuU%C0$pWjhUSy%)Iw~h*>ZNB?nKS!2cj4#1r2IJ)lD71j-q~fcR{CBujlS z`Zi2LO$rM@S;G^`zZ$2cu@cJB_rCu|D9;b4f?wIMs0EXCefJ=P6h)|l7FU+Al0jop0;&1qspur{7H*7im0R`X*k z*ocF1)*;mS)`*kBwZ7R!JMlzQABM=Xd4g0Vn*`Rz$DV z)TV9in-B+0_6vz{r4M>%qeS`qZsQw$ibnKUc5->S)*4yZx1<}$+O{#J^@9r8G;?wO z)&mLG!h43yih-m4cAeXm|L zFW##cP29bDG5OuA7svj4_2Ss`{}K200Zkq0{`fg3FNEZ%1Q3B>Hwgw%ac>f|1gpCw zQUqUiA*~3u?h0)XyX{?|w7%5dO=1f{@m@vOg4*4aXx2bsB~&fyvJ2Q!YH_#P*0o-- zzD2>876P@_s`-891gyLFyZ8S2qxR&Sd3olUXP$ZHnP;Av`Jr7bMGx5R?zs=<*D{); ze7ihH+J#Ve>K-CY_;$hm)1(nx!qIE+b)#cieEcv)^fujVBZZSjuysJSZp655B-b>O zkQBovwTYe2j#LX+!C^-KJY}h5Y)_4(iP9vtJHxsM!w!k{_o9u}R-39?U`rjTle{j8 zDxjUSMp`+>7ocr3NE5od*>317>@=U~fh~cAY?gXN)vCifTRi!4sOogQ0avo+u+mme zf^5_I=gJW*m><_fK1-K&;1wH z7E4};U2&S_!Tko2Ls%TGuw5J`i^A4w`&RSFmbzB!f9baTR%Na3z&PL#S7TdfoA|w? zkix$Yw~1TY<~b*i9A+%5an=m@9E)Yh+<5^kQ5@zAzYL#b1YhJ{bE~k4XywRF`gLKWYS*$FrpV@ zPiGIq9zG-R>P7&sme*xf?ytuYUDjP7aH!N=x;nE#t)URz899RCpz}u~-h>edf?Iql z%~Anm6h*tGe+=s3BBN@=s~YLR&M#q?3pbwOOhIr(mry=QvW9v+Xx2*wh@-}gl9p!Q*9ONBv@fMrO` z?x)LdKOsy|qw0i$|q*tvVSjZqyOW`&0t)q&w`#*)XVP7N0>!mH}!ux&Z{{m)@%I)0PH z1@BT5)2SjSB$HLm_7P z3}~7y$WjCEZ02fYh|x35ip->^u-I1SKHrSvvWsI=vzR|%?*ArD#6F@lea#86w~4() zC@9>G99d#^k}PAhD7|WfF@LyPw^j@onmhMN|2x}ke0eyxcDS&1xHvYtOg8NN_u=wH zthfx9zd+#-G~rs&TJc&*+05ZJAyIG9&Xi$xy5%plZ8~8)O(koaNnWtk%>@DR{{3<_ zRod85_R_FxCH3Nms~h9WZu`B+*C?sM62UftfN#v8peL~wop|ZI8Sv5NfI$1R#U1Zd?%?A_mcimHfJ~~LicT#CYUGS9{G?;_`hd|R)>&#QdDk#`ofMRX4;b3vlh(DW*216cL`S%b*y4t zoWR!;&?OJ6<0*3cJRs{C>ZZWB)1TYqHwd9* zi^G*F(J*N6hoVVEnD0i>D!(7~WmHka#GFrQjs*&D`Ezgj4Px}>Of6-r@;g`ivm^#- zl1iIl*WLDOXOeMSJ4=;5uR}NF&lWiZ*76Sc50!-s$A?f#`d6=pF_o9#X?{H2c{jcF zZZ$11(zf^fXb%BR=fvI(qoz4%;w>cVK11PgmNNdzpC!x|f$C!8h`(G&-JGN<_S@F@ z*D$54IqPc9k&2@SQyug1oL|n-zK`#hXHdqae$x~xAu_~y(T~a33zTsQz!XP@WC?WV z{U)5C7pplGP__A;zw@^-mPw4|U^7Z;7HT|{??AI|v%l;$zqZk}CIr)a?QECI;vZeL znB8%85+hEe$`1QqJl+`Ff=okdkkKai7M`0?-$1t zxx_ZQAXfkAPsT4y8EfV4o0KitUnloSK!xJiY2Jf=kE}RW?Gc|lyC!7)k$s7iu=kx? z-Qj%G@0v#K+b8KP@p}*X55az z1V0M6$#^FMy5&4&`(~(4zKHcmkf6)dkQ;)!MtdDdR84mk((VBU1`(5|M~+AbT_P@y zGOG&x9&`+N8(|@Zk{(az?%HM$MzP7sv-9(zlWYC9|KLMn$nz9u{bbra_N!*$oMcw! zwoWI z*m`s5?|*o#MB<3(%=K?EaQy<^&-}9DllO*J9NXYs?(Zfh3>;ou1iM2DcPXCgobT6V zB87LUA1NSq%Ewhsp{U#ONyP~oU54M=I+QOkNP1+2bNnag_+=^HpZT??H!SNVlZ0Q7 ztAzQmuyx4!KG3KgL!)0%__*Ks(U5n~(6t72kGLcP2Qxg*)yeJ%PA2Bl)n?+gHHbWsJ+l!Y4;?|MhHKPHz z@x;YVvaD|I-5B?R@73nsSa$)hY(m#$cd^HPOPbkTWJn>uaqE0flb;tX{LeDqQ_ZSy zzb@Rr{z2z>zjwSpjbFA-)gn(8j1e9s4Pxyio= zoacsoo0xoY@x;Ph&5%Gu<*J5qCPMa2f0aswzP5t$<`O`SRNR~1Q$uExhu5_%?=h?! zAKt$X&3Tg#(Hz2gqnck*Sh}LnONiqb3XB}WOPfe@I*v>Q$r|P|%DZ)lXm4)pJReU$ z{COxY2*T%OSPKa`ItJ9&LJl!4px6bz=g5+_#s*X|BEvKR0ttQTv`sgJ{^ky0ZL`Ts z?&_iBk_M6Mc*H)#cof~rNqt5d!%?P^vfUaKpvw*n=0peU$8;-rlyWI=G(pL-n~HOI zcMn0`gm^*Idl;zOz^8s_jw2YdkKmI-Ie$B3Sp)TJcR4}Bf-^)XkkT~)nJtFA@Y4Xz zPcRKgE+V+-8S%LQJI%c`p!yKETlCdKrJ=&$vgDv6T<0&JV)+9bV1o zO&;5?hxDcf-4}!QqN!*Zcbx6Tp_4BTb-p;{eF-gE&G;5mapTxU?DvR$AAg#di8oUJHFZwjl$MFiOi_M!!IlI-RkJZwS}!%#bpgu$d5 zb4TanL#-TzEAyPQhFFE=yP!NUQcm5F@0)=0$3vEH_@FU*CJ$XWuSC}N@oqag(t(68 z2Sydit+=)?RX-`&!-iL-FqH->*`63NIk`45A{S1LRPvdsh^I)@3^RH9<~ z50Y7-nG3iC)Y91Tte>4ezm;a6fzZ;7YgS|cVqB3TC2{+CETOQ{bk{aZDnBtmZ?>43 zZhrc}E<1$to~98;nOV(2e{`+(>DjaLGH90|8M>~d8Ncm9iz=9v1U{n)34YAE!!oID zsn(RR*%~#IY{!As;YZjzsRkK;ExqQk=E~~TokgTve6yXS)f~koZBsv)IAip@ zp*~T1M+MyL(IJ{}Mbbk$Um6^vmG9RC%yl5cEb`*$WQDSe{4HG02klpyy3j}kl8{G;S zqgAyI=Sw+sQAY%Q5_bG(E#}9ukM)U1KQiNF2ZNt2e6u_m=g`SMM3EA#ee;K2WRTtq zd`)Vqh{@42xn`l<1S5u;x}=UcB?-e34xen6r$ef}Ph+>l#;?dN!HN_hYWZ~>uv>Y6 zS(@@m5Qc+ssUx~1VRj~mm05c`Kk1d*o*#siBNaj!AP_nhd6vZyGLbMlv#Z8{G5%hF zm64vVAu$LClid!qGP!yt$HB~g!Y+}cu&R_$gufKWAIn8@mNYYDV826vV(zR_#i_ZV z>;TBSd{N&A@?HpVM{t;g#b+8MlI0drX1$48(Zldi1#%^Nl0=x_C0-@a`vuMuB zY-Y-fn3s{*R2X7nDpqW%C}-B?WOPsi@zk5~NZ?{h(}$lUf>6>I@|~`}usZirq0k)} z=g93hzAbezWhcgysQO$>Se&EmgtRXAj;zG?~fBi-u-oer+~d#Xl7n<`@u0AIBf+6 z{2{!)!Ik0_*PLBqDmbp9K}Y>({MBftJDsA2<8!nX>oycI>#Wulr~~DQKOt$K&?g?C ztL5LR+>$t#snj9Aqk5fG0sRS)79j%5`sswIST?%m)r5q^gvX8Dk<|5T7e1+IybK|R z)gMZ`qhse=*RLy9mwr-#ATd$BFZ6e44IS6tnmt?bFha{!Y$+wth`hdW-KUD{kVME} z3Y-i!yI+lUGa+qN%dKi<&8fs~f+wa-9#jjNX&IGw#>Q4VvknamCd$bfNr;|A z_FO3w3_q?M5AhSrAFkK97X%vn;P!NgLw@+$+rgz*z;cFYAOI=D?XjZm^`=sjsSFMo zm@DEk-PG97b}7(07eE|;#uD_6jIZrQIGTs=L+Y4zL2C3kSJ!%dQH-w>`w@IM6r*v> zGmz{6jxnujPOP1Iw(3ujcBY`}iSc%3S=CX=B@Pof+C4a$zLj~_#XPejI3Dl=jr*OoP?%N=-`-zKv@-vQoVnHmor zHoYYH&Qxk~G2H9omqOnbEthN#eOoYBxHuH!;%K07v1mC7L=+oSda{CjtZF862@T5y ztZ#O>xCho{8?fw>*Fa-*Ll?pxCHWV+0Tud4o&1chUzLe<6L0?p{~Ifi2**K4e<$;`M+Z=l{tH4%(k_>n6{nbAbTPkdWtKyhU&n3eF4J~Ive9UsM!cB8I9`6k{%u>x&{T zh{%ZD!-v((!+17kTlswc4iUFwCB^lSs&43Kz!$<%}w{nX# z-+%@fJ4wZmmW^BV-)Pg}F?ya5)Vz#t`5*wnLXjwqpQOKwKIi^Ez_N=zM$k|YX6t@y z%e!HSxEEL?32x4zD*v( z6Gp9udFGY zLBK)zZWR%tnBEUqMgry!Xr#&8`=C3D1cC-1`!1uJgcus~;=U2UhBiH;iMmYK<`$5# zTqlnkL|<{=3_y~%a*Gjg0jYic0YVm*wS1{yBU+g$dXomBxA^NiC@PqioI`&CNfaqaB)%R%wpMN`k|3+*ltO=u>Apgo5+2eR)MKTGo@2zxRN?tsE5>N7 zJ9o=0plYzK%>8FnRnx8@nkXvR%wSG)1@x%IAq+%vxi1GQ<0#!Hw~CPdaeN(H2AG6oZMV+Hng}K>>y3 zXVuYLyj8iIOhk0=-7=wonJD0(f@Re6V4fY5?cjY(^QNa7B<#VZ5n+(p6x&}FF^|1d z74eLC2IXzIRTGH^3LY3;W6g`Cy??j`1krTZt)v%_6NtSoB+*<87#O`ELT^%MLYqLI z186`Se)lVQ+*?2ogpoNPURo7)My(f#7RjtBEuc`70*o6c(H<~bk1Fx~jzZf4q!HdK z66^Q3Xpbs`lY@5jTJPc+S8ryl@cqnjl0b5rU zF|l~tj|lz@<$V=siHO7Q^2*B#1 z^>^yk_4;~KZ4s37DRxs*Ef=NkN`AE(8aoyqz|f<8;~wdR`XVMXkQOkDBsak}|C6R>@wrH!u8CcfXC5J9tY#*9U=F0`!Zib=Oxw{CHSZEg@(k_XU zyy_4gcO8~4RKw{alyCb^N|%1~C59}0lWS0>4kbmMHscUzY~dWffhw~C)s~wlr0nEd zxaw^4_$})@N;hw?mR972Oi)x?U*C{dHC~ajP+dIlLgpm!VsR+_5tCNQhGP0AsLrh~ z{HW{;2p|v*$k8pQn=e}00y{UWU=0FU%HP}^zt$0vl4Jg&|u25+&F_M}!E`}wT z%TYKKnlYXtjC`M04ji##eCG&1?V!BVZ#uuep?Q){g6I#*1YUZD`tD;6h$*l8`(R(U zQO5Ugpzom0_9?`ajhE^&La)<-CMm>N_+FtcesnR_|NPx5M(lf4YVtk2RI$v}4! z4zIr80CA2mq@fItBq4FgxXbSgr|AM+?)DqmDiSH`!EB_Nq{DI8MI1S9S@UVYVb}R? zXbsTDQWKc&XK-IfySQ3T;>?Py@VQcleEv=*^J&U>_D1?T4$J>5BkQW(ie@T*P7!#X zm2InSuMxg4`{G9D*&C(1!cKm1qdnC2B?-HV4d_o&-qSZ+orF5>U(s#hU7Xa_N%kaK zUIr6J24gI5(%ut%&8z6wrG!j4EP^0WhBV2|A>?%f?d>K>d~eV_s#7WfCh(Uy#?@&c zkrha1fTthc-B#NBCz8-&e+Vmse7=Y@89Xe@f6(58d~sI#LW+F$8xG0q(w>qtYuF#V zI&%oTUn6Y}pVs{v?R|#__d02xB0ifE?LyMwax_;b0j?o01QSTqAnIgEBv?=KLJ;$% z)40PFem`}(>gVcTRuqf50EOl-sV4F5!-l6uE)hqdX$ffG++dgDp^v`v15(dJ}`ie1Vul1Witwk9iX>NlRq?(i>y4Uc-#ZdOb%O%{R)-H=sx8%r}a-Ftba!N?(AJ zUDle?%&x9z&7Q!Vq*eO$x9vq?YfY=vBr44u?87#y@Qdr9r9+HIb(#Ixz1vAlWg1l+ z&xj3F?Xi)#d`xOHe@xlt+@M0qSb`IEi(%H%QsSwUZPtxyQ=Ft)Z<~1o3nETjxB65z zV;s2dQir84nFowa3|kOx`_*-@HW}@J%`G8DHbU`1XwgKEr^foVCZG0BAZfR7cXoJ zZ+Ukfr0|_Ug9+AS(q@fg^IE%;c$K9lP3+kH-zUQfU|QnZo@+@Ooi~hd#g?2VLt8z(pkD0 zK|cFeY20-`q+wY$8X!K>X=}Cth(W}!MGzvN>STRD=j;QuiVzNXjM}L01pt^;Yz|G| zv>|8Lh6WufbM6keX~Q|szJnrGN@kP6{ORvwy~$1L^1!1DvgQA%4>8-0%ASmeJYqRA z#v|*$t2KqznxwTRS*?lPI_Ekofg4nHI7atsQ@z=4iYB;WT{HDM`-Jb_sE$!c*=AnH zT;!C5g6J#LU(cIMcj~U!Vv+5dvUM*Nbg0M^+GboItd&p0fh1h3R8n)p6I;_*t*XU> z-G5PaI)_SGZ?#r)u0$$Lk{w-?C2>!0@`R|nl$L>5qw=~=c|G0EK}eJ&X&(tkUFzIR%SEOcga;BJ?ezRqkJUuT=yM)A=ix^Lcdot0ogLO~;j9+{eD7gyF z$QUn!XW3{tb+dTE_H|bCi+3oSl`} z&Ea-)M6e{3<5JVD`vdMLTZ?0dTbWSmX#9?a=#;oHrInFB{PG7ptSB);TO5|2Ny1Dk zBTD$eu3MWCmXkq(vb(cLNXchl>YN}tpLxPrp=H=h1Pe$HdPbECYo1Gpi0K}OZ{4p3 zmcE-Bq>)BLXtaeF0f1tkMp?HIZ<`yI2lF1^78VmK%R|h zG|d@aNmI3{th41Ouwl>kJmERpbL81WpOM>M?kC?X$amS#2bN3sy*KCN%>K^B18pj# zeujjf5YLq!R@s*DIr(P~eM&`}IKbg^=aQJxWzTiPl2Oj#a@&2WjM+(*%^gr~FjmvG zaFMh{R_pRsVWqKlK2ukt3Xe?nxMBP{TrP3nSMCvx4;Tv zcm8|-#!VgDZ5Yyy)+`di21y*Fj3>aRN-CkvD5vvPQ&ZZRB$dACVbwH_ zQJx@U^&M0&)$kba!T9IKMc?1vKrebtt0h(ZzE*(m!Q*!_mAoNKINER<}qsq`I!dt+0`VUJ&D|^w*F4dGQ|0@@#vu* z^8bkc>d|?G(ANC1WxT(3T6(nsIX{v31#iw-BafD2P~~K4f6TDF_ioWs&*B zy@1DbZdy)N#h)B(%!;ZC>#A*R8h_pbHVPxSDVl8<4Xy`=6i*9BU`J5J~vP!*;Owzxj8q9g`ih!1;yRo6n_d%nfOxxI@SB0e>ndLEC zl=NI_)3R9ulJ)GDN40)jn#67`Za`34lp zl-R~UC^8zCtloa9l?lP|Gy>m5s!_wk1br5d(ciY^n%*R=W-xCvo5V$?u{}qubYDay z#^ma2U<%ynBy||b6owxVNYjzFbHsP9xd!7`Pgu?Fc7e6Wl1Ua9aIIC1qANmRkQ!33 zOvTT4pv%5XCZQIX@}?=r@_S#thA_={By5aVMvWRsH(LpE+z&Ly^Ei*@za0!m`_7(* za3^JJy^0wqI(0tIuf$J*7yEdO)0azbPodept)0`^-Rax9(yKdLKMq*2Nfaveu~c%$ z)Etrim{x18urH*xq$%^N?}PNnZ&JzdG>CvwY9zJ?j?Fnqf9`!B@~5T3G=;e!BpY+E z;shOeY+hul=CqXVigibp9B$^-Q@o)~_v>$N0hWc4LEntiy`XT&Jb9W_P1Q zZ*A;wsHMz*VjG zdA&(ir=BaZ)`#`R)S4Nx2IQ8-I@DT6SZ}nwXbca#n%UtXV#+6r&D)8Bu!O|(5f}iq z6k`=>RHkZ1*ZT`8LukYmqu;8Uv~7WLtW|!WB2t&mxnWo)ir0j zIGM6liEUK2Vj%yeB3&&H!~|*MgaL!ZKM&9qp0>SRcC|?A74+;9Z*<;^jzC zx`IX;4f=|dJ{Y5TAGBOY(B%6yq4t-7s0bPstRVI$q(sobr-F}b=fN=`Z)n3gff$80S;-eR--gqpF3N1ZUJK;&VKOnw@hapIe zVk|HJAbT`l#PrU?)!*O=ViEXEv|t&(qIx9|weA7(y3fYEBvoYWOGyUhPRBI3_DEtvIVv8ksi|^p-Aw+%}!w+i8#y{BZULoNad&tO7>{b#s?uNIS z(HqAT|B0ZeLmQ*1kPUWhf%|VUXfER8@J*n1Hp>2hGzl3Sc1M6fcL|dP+tWQ9OmK{E zv!MLC=Y#)0*#=;FE8xBBbKdp&_$DR!o!|Q09iwU8f4ip|@!1(FDxZRUvAo1sj^C?< zi~^3fuY9!}h3z%&Uj;64^w14o=Q}>{4WILdZ-8dUX;wZ`-ZkHt9I|W~!&7yc049D; zbu^9`iA57&1zr+ZDeG{bBk#H5m|C?h%n?&ni?eNQ6$B6&DK>}JN%E#X z$d&*v5t-)r&bF`1xv6ScC>OleLBv5KGDTH2&9Di>iRzpux z>dr7vbmC4~lB8KOl^{U2pG%^q-LISW*0$lg*tcrGf;@O6r{=R3;^m>9MyX3E+s_G3 zmEWRWY?MWDsA+cc%llF$>}!qVbjH;1sGwz%+SkhR-(n8O#bH4`@kpe8f7on&%`yG{ z6|?m?@J-*pRKr;%VZfY(D!kkLY{6q62VThn$c5xIHe;^|__8u}-(>?q&x$Sb%Y6BwEe_Y#r9Nw=u{tzr*0(`0wEJ9;&kCt#+81$%x0RB2O~fIGZqawD zEMHaHIEP&I?G@P(L;9ao^3M9G>>_EclJp=`j0!0dVObF@`+BA^$Mc%p1zM)yM|0VO`2%y=Dq2r zz4Plj@R{_AQu#`riHIM(Ce6yLeK2{jRZZD6g!Z-5NujRkA`H>o-dP>>ax!ttkZ;N8 z>R2LAU(%J6VMKzuXRL388E;+5$(fm+9cF!lh|ub1>KNlh0>o3$@g|+VEX>NAPYVk2 z88#BZj#(^j<(XCdefKIp_FK_(}~hqXTpdsuf*xTOib3q1Y^p){8Xq2PPD-->*7 zyMVKuE45bh*z9U!Z2l`_;kLmmW8rm-t(%0m)mu05DeE1CZgmE(fqXU?>KN967f+gX zBOjkuM~n~u5aM9ge}{m2xROhfr`6m^o}CaabM-u6LzA;`oj`MF=jT^0b%g;}*stB! z8N7JH`TqL*F&V)J5z*p4jam#k;4lY>X?3HZ(+oUT^;sU1rl0YIrW<;%8n-F)F)yp`E~2b;qniAH78?o0oio+0UpRhngCt{!d(!o@y7 zk@A@h#5b6CGrIXr@|sk`bo2{NZvz2wqvlR4Cr^l$w)Q*#gqHjb?IOftV6hCMM7RO+ z?PTY$bBbL)9=Mqy5Q!(cjSUwyD)*q+%M_3>X8Km|oE&T)~Qr9Ryj_J7q z*xmqQ(NB2u+%eGYYmdHWndU|dW|Tw`W{Ez3*x?E9lbw)hs^Ni#$rRB=>J0Ga&3H!+(tN1N_^AbqiXb4ieU0 zFb~-)Ve3XV$66l3h+RM_QV7UwYJP;Uj>)_;N|T^;U;7Z=sYhjsrG>!bS<0|Rt9>PJ z9!wj_UiC8IyN5<>UB2$YWp*6Q@LbTuogeH?nqQ$5j6d0B z%Jd2~oeowjFschh#7bZtIW$wqk3#uIOzaB^i$x+TAwGe*exX91>%Y7pF-OhSh1X=? zj3yLzakRZqVEK<0R}qcN?S7)HH(U;Om<&vw0(B@VGhd5Y?4|T=g69z;S0!M;6c0;MK9gy#H@Gj<7gUPQDV~1ti`cFK3?&ew&|@>zXew zn6J&?z`&6w#zA+mENRIvOb|(Xa$8kGsE(FDW2BEy5J-A*+u?qWy$asnT}IC;88&iT@gA=4aPO;2yAxq4oY6{BvQ>}-wRgi3TFJK_C zX)ccr7%$W@>-!PxS!LZw42spOAgjYkx)SA7LQZvwcobKo<+5H#-Fvr=(G?O%j#Zf0 z>LM;{4J2I}GOp(fC;=yvfD#Nfq$3$tjV>>(vS&bHqzS#@4k4KjP# z8NcdPVkEMx3#b-e);4yr(Qh;Ch#`DmO1La*%M>n&!7eInR@tYYPzg!lSg4j|kJeI^c-*6<(ebJ@?kMZaA>mk@yi~gE$$MCEq;cg zo{z6tvfiJg)=n$#?7Dce>tb^VCKvxk+Ja?HpQThomt@7bG@K15ygW6R6*>=J^j^IL z6|(ct#gkJmo8G5wza-F5+S2XU$-0BH<)SzCvTfiZLQjPB32go3t)cL689PbUa1n$9 zcTkGeGbD3EJKYyghJ)cy=+6k0&C<7J1cs-utqeD#sBGhSw$Rn7P9MKV0#7gic!~fd zNlS}6l8nj3Hftg-w;rSN@s8QEuSN{A}%oT@L1f)tP^ zz^jGiAPESzR*#aLY%lJk@c$Lvi%gP2!Knb@hfV>=S<*Xs2=X;Hj>#9@)a9A4wKE zs@@){H#eB{0-2+$W{+;&CGc<>udnK~cn=G{gO6-2moDVUt^YYu>7eJ3Gn|+lvk{t~ zO++f@^jzB7aH*gO{-x&5bXHPePBYb)x5F8SeY2XbR#oe&jn%mYa?FRbi+K6)tfZ=T z!V}wZ19^RzBXnVX_fJs)rFACz5q8#yXHi>sT;kc7Lpw;`7M_qO>SYZsDaExsPvJ7S zqfXK`4&`gTI~F{^fq*1UJD;XYN_BA0Qwrh=O`VJ9kml%)#Sh}{zITMFR8lKn{LT8i zB=(3C*}LP&4zgMyWp&80wlsY^IraL{5UV48`u1)dxG1DykF6Cl)<(HqC}?Sf_$4~C z)j=cQ!tI!e|L;jQZO^31L|1d_-Q8I(u9S0yxsDHV^R`jy_yvyB;gmyCEt&z(S;#2t zq^b%x5FJ+?me4ghS(0dwG?f>({-_e0ZW2yKf_C9CbMO#%GgQ*H$%9FI@IO`^2>jl6 zgTfAWRB|m(c0_i3c1rfV?5Fa(JViOb6v>uk+grP)EQ8&cz9ogvV)u&_?wo%iy|`mn zX0z~8p~Oa$Cbf%06^&-j(zv(ZwzMv}Tr4$nB}?Cmw@Yc0lq#1pW~l&FgQicdmZ#5G zT9?pRc*;&$*myKk(I{JH#%Q}FeupOT4a2{nAKvdis=vDXQBug*Bf+JSNPP#J!o25kX{KoTw5IEZ%q7H!*Uu zAD9HvWxt4eA68n~lP1`sGU9hk377<-MO>Jq;tmvVgU{eu0(Zo@8j6={Tyd~W7`8KO>+d_35+b(Gi{rh-H zRgB11egSR0FeP!vnIFbTGG@3B1sqS+BvqrgIwGukm6Gg{v05XwUi2M#1i;>~v?JPAuY|1&=Ohj^YYSWoFnDzg5U zsG5&Jz97Aj-yY1L)JlE}DOXn@%nR)jt^o|o;LHOA^X0fk)7A3n=+|jW;Xz&Q#S0yB z?N25uQ|OK^V=LF<`p}^5RjxZ~aR=tq9Dfg&MBMul^lkmHv^m7`m%v;ptGFL>i)of6 zJe5$B!s>AnqdhUMw~kNXyAbFe;psq{twtNvVth_K!K0SjnrKbyRlLvX+RlwDqchHtda19O|Jg!@;y-MU- zchtQz(E6caP7RPfNdUKpr0KIwV7&{0gmnV4o)HB9=|6*~9w)GUIR|a>e+ApOeT)uA z2xy1C9jmv!B{2SCoqf>u&4vGGeM*m7-J7wm&d~9m6*bx&tPwJQN{Vuqzspy~-Tlv%0Z%y8HTmrf z-yu-$Me220Gw-1B94QBVTbV)HIK5XHY|JV`wB`_v3%vmyHKZo8`04Nq44T@|yR$hY z;ptG{u|VeS0INqI3i=!lz9PrY2Rco@GLiTSEf*+KSH_2=CvtN`Fz2~YC0}^v>}MON zv@t#7JhVf8s*nN6&ZxN5cexpR(wA^OOq+;A48AN!gktsSMyieRhz^Syn3aiS0*E@~ zM{asPr_3l@T^usr=D8qyW#f_+OSr3(;0o9ma!VvzeL_scissuuamcN1?AoE~M2;!- zQ>sO`LNF2MBW0^K-(YX!y}U%&ssNK82d5~lQxcLQaise09x-HNf+32vCuBvCb|f}! zjCsCi`7w`ph4Oud&-df8@iUemKX;!hZjBa0X(i*P>{&r-trRjiDFOp${NzD*J`Vw9 z{-1iu>I?rr=_UU|Eg>H8|A$&aR>%MMG-G;+JL~__OA4ucQ#+IMR0U?i?g8x1YL_lN zx#<}Bx`~zfc5&EAW!L)>ZchbvpO(n;X*PW2EXmTx88rtllNEg16jHnNSVI^fox{XP z6pf904rN3_6~K;Kyjo{(J00w2!VQ}NQvJOA9zQP&y6_gm1IZ?*cs`w>Su+EK1i$+>!lP~H<@1- zX(wYoux{ljEBCzSLI5fnwX|-tqEV3o@QHP2#Ul`d;6)qtlE5H{`c%paUKgYp+XY!s zQBy(}{sD*Bzqegfnp1(cXclVx0o3DlY3feV`eCt>qBv}l!_^4B(-6QOlYQSEt}U!; z*TmA6iY`wGwm^0?hC!2TFkuRZ#P3$TH%W{Q#w4VV-qel$LbAeo@VCJF`?nXcpESzZ ziBxPl<#wJu+e5btKO8sSVe~LK;Lo`4PuL#SF3b`y%veyICC+>Q8@)<6iu)S0Tj|Rc zkl>oX1{?xbd`rqcxe|9|FlZD6eGc6w@SF^-@ zEU^Cje&Z$eBtQhY)1Ra0v6(+#c;eo2GOLB&~u_mq1#J173s@ zJ;RuUp=w58GSX_Jpvx$1HHutDajh}LjxFUzhLAzc(f@-Eom7b_%@$J3bnl>6JYh^L z%bO>jRGe(kw+W(t6`xgxq3e@Cv6R*CyMrUYe)46SzPk#VVw<2bBTw-ly9`~9YSTlc z|25E1mLUDR?(r|P%CL-+x?P@S$}dY#-!utBcx?D%0qP{?qzqLO1t%;$_1*zNr zUP%;4R$|y%cQW7G<6JCxbwjL2)D~K^v12cHcpA2@($oqMd2=jWvar66?vd9!5k@(- zo)9mV7&`Nv*%8%ISrZL$C1tZ`u7savPk?AKn(BZE!rRC=N?q-#h7!8s6Q4aa+S=D7}QJyl}BGNd7^iG0^+lq;Z zL7yhfH?a}$WXRU1nG8&wE%h+Jd85P>a+T@MrP%B(uZBfk6C3n(Ks0LV16H)DY-;Y> z!WlS6q{KK4_vRQ^%;XI5uxcC=!llLicAzbnTTy{q)5Mw$fis2Z)W`5z3F*>Dvoa!G z-V9)On5`-;%tJRis?tP?DTH)Hk}MZ4)qBKW2F&~J zPcO@uf0U`5PAQ(kyzM2y%2`d=tZC4_U6mhGjG zw6aZQGsJU6v+dSgqr=#iYjtxa(>!H;A)C5=YfvdqA*mMfdQ|&nPH3Z#H13-zRN#PY zY6eV>b4988W8IB`NyQ4jZz`^5*~sO;7FXchGSVOOzJDOz6KK=-*uWf4UR5Q^v%xe8 z2OMYv;#p(1TlI4S^}aiHj#~fS)Oo5!=j#R45!LZk;geJg&Le9^lPw#+Ns=_l)Ti8w zu@OS`!OtL!npy_~Z5Ql^!!mf82K|?bx&zC6wCzqG_=_B+13hpwj+Awm zFH8BbEY)KK-Lxj#aNSI4!kUpp zuco3lNOYp}IYlD>q`oaatR%#kdlcGy+cy9Jr*fKJ$l>gq~J;srXp3_#Uu>sXKhzxk~xpL z5508vr_TO9V!wI3>6{wB?){h;5`Jcx#BGeZ4@*I(&}=Y{djP^prwM zS*}!l-WO%2oS*k;5}R^A?^EMiN;73V)d%Zg7BfF}JTF8zC~$ePp_$(WfI-oN%x?n@ zGl{4cT7DOBh+dNJuJbT;l6{9mpmgImZG3A_q$58sDS(Po-oNx!o2Sb1#JFfN&vXxy zaOdGZ%e1C7;rZ$;(^^46MEahJ#OI}^1R6?GV~1r$fJ-N1v`~}D8!|R^<25^wL{E*+ z3;{r$r|%`f?i9!t;~)C+gx`0=DROV0vIrh(O)C-}`qr}HFx_@2skwu}|5U&0OJZQB zXFymW88fa{BJ8cN<

t&X72g^71j6Knb9oZF}F=?S05zTN1;@@W0V)Xz+UsqHSZJ zL*gL5(`;yMmhh3X0Ll}bmpH5X+;{e?tbIBgfrc}k^c-2g(icTzEiD)_1`l5*^;Gyl z&r~iJ@KIC8qEx>I@<~i@x%1^dcL%EbD`g<1Fp7y-M0tRotgmQ}`#wv0o5Y z!n}TghjCxWeX+WtJ~2&5SJ>wvE_#-M{l;VGV9?Y3qE8e5&SI&Dv0UDNOVB6ne73J$ z=v>}sD3t27bFpIta?a?}+}^Kt z((qj1DB@G2UqBqmKfc~4BWXH++!rU+3{y2{FDCb$oYB|CedtZ@voy4_8+}hsR7Lmc zVn*9%3?eey)#17+eZi#~eNp&7#XR;eV`BbgOhg~Q{PQp4$Nh_#2%L4O3wanBF@}n6 z;9Q-+5z}Ij!?_jb|8#61ZZh_w$gu>E#9`|aA2)F%X1bvWu)n)s{RYRO>XlWtY6AzN4j{>o`nG zZ!LLYy_X2{_CU=}CwIU4O1(> z4=fg7V)4rU|Btipfs3-r{(j~!!|;gwb40+L865tl#S9h$s~aF9pzbOqqPy)n*dSW% zs?};P?r)xRK9S|`EQ&H&6Xs5NZGS|w=n)iF3`2)7U z-}~HACg6N zkQpPCg_HRXSF!4Kk7dJ{>ZG?~@G@9kd;PBxzV`bum}>bu^ZvFmoRm7ZjdgBAF!BtQ z6Xx1`Ggaeln99$LVZJ{-#{8OK1!|9P4l!Sj8W5_@dO@*i%vwqnPmsmX6JyRN#~hY& z%M)Yn=f#RA##n0)^Z1x`qAAOpS2~YgVb+thqtSie`5DGqe>Cu zB-YA`;PoEu%^w?DfcC~a=a0D`bI?-v%7c4T+?U9wjIp5y@#&M!2gX$E9PS~9{+aJ- zDflE;C(X|jQ}h#1<4KwO33j>X7-kN6j#VzrPqbh4uS1>5W0vGG)o(qDgfU0~_-7&- zH)YQqX7*UM;|qU2g>npJZ5y*2Ej+Kq07eL`dDLEU&1Ww_cJSQVCQpqji@diiBAAYG zKYoa8R4DjMYT$g6|Mn2fljsyx)*&Wztfec;#hJX8#ZRGQJ6@IRe{-mcF=U1a}q0{cb8_qeQ>Q7QbT~DsZG#wheGW7YV^Aps^ zSUwrm|60skAI0c2BJ{;*befGs*6Xd&yUhy zD$b8uE{w8Dx$eSfyV!Qpp8c26tTw`L-HK1<>fwQF$UtUfEHEkv4qLmd39+WY#OUv7ho%voum349Q%oF+Fx_d z^3tfj!pl%G5FEed;2`yyMr~zx)%*PasoouQxN{v zFG`#tS# z2Hi=s2)DlrDPtkeSjaaP3XFw9W1+}cC^i-b84K|#*jOkv7808|xjgrVl1Jcdlrr~@ z!d^yhlEcM0d}yhYM{(XSPm^az;k%BU9FSdxZwEEqW{RhB7mE#|^v3%dQh3Fuctg`hozpO}zp+dkbt}ZCU<30s$|Och8>=b=Ws>_E z@HK*K5hy!Wn6*6j#!B9{6}mUBtX&_5dm^h>6gi_N)d3%;vf3%$I_ANXA<-~jz)o;% z&GNOmH>!AzD|Gv>tlbc1D3h1!M5U9g|N zqB>z3&Y(!ji(CrIC4`XWYl8y$Q9t<`yAmlYUbu`KKf5<5D!!&gabK-U;OCts-v27T zcJc6wtYH;j&-LDQV<_V*lwoIBbrWCw7S54wR15gURreV!9G%>zr41}^ZEL0cuOi5z z#T(|rg({9SvX1Ut-n{cjFh9>hwXB;`|M->W-Im9%?8)T24pI&54|^&@&E<3wjJN<8 zeGPvT_(AZwr6zD9^t8I-S~X18kx(&$2YAR)SM*mm2D`qenQ7wAVltt-l;v4Ok`uh`-b!j9{) z%VYtx5FaHDh1jYP*^YTy)njemj95i1+AD53$+_B_6I-k55BTuu6IaVLlBCwnW6gnT z=U!3WLo)v?khzDA##YR#2x5XrnrU-E^y;Jy+Gq3qWlGff(+W!DSx+O@C`l`grixzU zK@$h#kP7$m+_0Py3XI5~y8u0)-) zl6*BEJ`;4D%VA%kuW#S8j;3SES5Puy_2VwXq}|YUT_A2*m*a0N zUtJVM(X-Kp2T*D);wc{vJ!Qh}IRevp!)O0tuu(Z20(sY2xIPHo4LbwYc# z>fIL0smm(SL8Br})<~f!gnq(#FhC!Upgu2u;+A6Hdi>u!W5BUa>!=O9??s;q{Ted& zAg4Bj93fLqHNu=ZiNd1iU23ai!sI>j&etxxU!sber*N%U_FvXtdyVY5&bPoYKNbuj z&mMaxX2^Egx&N}mdfC!=+14X6Mc}rxd9`Ux&1x5f+%+|^%v%J~Jk0NxrS>(P+!kirV_C!w$UApjwryz#cu>vUMMWqsG1Q3+ zmPIso#ALEmd~2vpwHPjAA8HSVL1#^{AIp|)m)$oA=u9I41x&ooC%=$el$;C$0qk?X z{?WGr ziipclgwS<_^p$|r!AB;FG3oIXu=wE`fCY&SZeTmZ}lHYc`MYfTjgIXWq&k4aE zr-C41@3#eo{thNZB(H(qg6sr2ok(Erb5otvA&Y>QTicPAv5(a!M=HLv3sfiC+xg7M zCDeqMm)c2TAFmK__}5XY!!5V`qU2$}zm49rbl@+>c+ZC_lIc~xk>WLi16dnoyZM@tr4(%=H36=t zc*XZkbp`=nD8*kVe{1%BgRWXetNe62@%4$ec&uPY^?fEBUmi8 z9dU!?J|k1W(WAiqK*v>MxZrH( z;n6I{(7Mz1>o&SspJ%sh8ewjcQL=sBg8cQr8DXCA0AmLynyHllyH)7J*()j@BZQR1tGoXV)e z{O#j;n*X^>5bm8KxSRk!T-i=wLJEly!=)Ix6#rbpZ5S@uo$pH~c!f|*cu`in_Xaca z>L|r$7n2q6O{=DBnO}MPYHp*=1D%ZKB8Le=O(^T7AsOxD*TvM-?@~bcJzd`^K4Li4!r-( zrJ-*wEuGW(%_V(?ALj%KA$E9}v?_(RzvH4oO->DVA{-otm3%lbx0SzEmaz`<6KE4FP$q2Aa^*_mbfgsTGKgj#)iTC#}r7Cfwgxqt&ELWwrdn;3nUBU?j zLd|hs>|)z}|ITMDlp_5iYEvqSP^Z*^!P#=#6{jw>^6B{qQy8P4*{&EMZ~Q8903sij zJNqv=*r`_MOt((l!yaepaE*joPDU3m6*f(&!;SBoFiWBJNc{}s6$)+J@W^wj;CtnE#N8+J+R zZ+a{@{Ym7!rArFW(cC$JFNfu$i}jy)*jG8#70F=_W*)!jXEUTku;m{f<{$nn_96Uod1Qfx%heTHN|6(D^^OVax# z9mm4_a8IhqE~#rK^#tHz?z@Cu(l3Yf#Ri-1O^gnvqpKj$a#{|FIlpTLtc@x2>A0mZ zeTlk&(IexnkYDoh0>p%#bqRhig^MF2j`OYYd?t>Ju(_FzcJVNxzG}4ENSIF&>cBj< zPz8Z)BolE7>b^J0|iJ!5Ywc}Zi#^v_Sf|E?fzse_kn z?DMpKl+bCK~}v`Y@udM7V(xNqWsUH$DvyMQ#o-5n!mj$a(`)|~hK zzr*txYPbuYgdf9m{cd>9Obx&jb~iku7n#u?!SfM;=i-myx#ojsffpX!TRB6ZX!Eip z0`WZr2wX=w4JQbAxBbI2ww?a@r$R3}W?*ZJRMiha1@<9xrOffW+trVgcDsJmuKTLD zUHyZBb`Rd&u3L6@yQ+5s?UHW$+O>TZX!oyox9h$_+HL+(yZXz%{@xd8xBl*S^;3QA zI-E4t1A>7Ip5ivq3-7-R_XcR#PF!@mvv|b=LfMDH!Do^b$zpKZaQFsB)YGo1$-aH~ zf*Xq8U&QsIiTB%zPepfC@-YFPcn88UK7K<6Q~c(l`bog-B_uCds@^6&Sx20StwMNAHJalg}j7@Hr!$E06`qI|F)`zC_Z%LkaWi>(uk`Lj+>>kYSIF`-PBQ6Ab@rN-W`%)1zGe8JF{JjbMG1Gkw z`0>}}!(XTmf0poz@ZaIrsp=>uVv2YnPj!nkmu;&9+qb~wR6}x6-yt$vk7^{ zYl5vT=QO)5iWbn(S(Q7NNg8-lGo%@TQ+nq11+4^#l4PXh6w(caQ<4K)6UE0Dk|NCf z)_^Rda9_|yWWb6xBW5BoiJ#seRJ?a#LJn7tT}X;YsP1_Gm?fno!wD`J6i9090yi<$ zmoD5*S2jDLt0AOLqAPuix0~)ecf54PxGq4SER*n{6~#q+zNPPi>N5^cioOdR55w4Y zUjWY-pr>G`=EXT?A9Lh_NrHQCk|WWCOX)hVT!>O?RJT*T$m(* zGDA}n0ajYydZ8xRtW74GQfB`J<%AH;ymCRA#1By>C)w(w6#FjN`Fp?h&IZ+9^n-Nt zFBizBshMmU$tc^Jxpe4|nMMNN1W!{99k`39!S%{mrji#uR^*@GHjbZ7@b~HqOf~A5 z%-?qrsxp#_C-e86KJ;B9=p*yeE4%9(Ih0Mjv)*^Ww)t+@^nC}gtAqa2%W-i<0z9>x zFu!g=BgI* z#dkcE^~4>UJxasEd_!6Xl6cUGsPE??a&U%81z-55M}Cg%=@4vgbPm>YH2f&rbSX*6I`KQ6{3!7d z=b+#V#RH^Uki#SSs`ojAtp^!?c50xnIl9IE>dJFuA4W{>>}z+F7I}>F+neLB-TrtS zy`Ix9c5mesXNDySwm9d{5uOn`Ub|C-JS*RP16On27)GxPnWFyrAm*TU5!2~S*wX(? zB#4ls-Jhevm!p*=kdIdOSXi5Zv3cJe?6H`)tn64!8^e+m8eRY$czr8}y;Epm{!G%A z@mEFU(|2BQ7%jqD3)Arq(#Ebd@a`D-(bY{cMxLjEAG1e0eG7la_NF~aQIPXsdnOSJ z@CytEzd>6#Bx~fvK&a3Nzmb@=Nl{hTJjEK`P1ZBcn>Fm5-NT#d;Kkuw+0Fxw^K~h+ zlXZEAJ>{~zLj=bf#bU+Supi0p0fJ=E6LX2AVJRcObyKnLK}d<7FxAian4kif3t?{k zimb*k2G8lq)vyxTA+%p33`tv(n+F=rQ3_?drhubo-Sa zDIp-gyeJsi-$i~;5L_5}GZUh5X8Vrw@pl|-mF4kwRKFG)dGm}5C)1?qrdg6PL2);0 z;M=1nGUKM7C`{vnl8kZxn^74SYeLuqV^6L($ts9u|CCKf5_9`B3*3jp_3t;SO{r{C zSZaoRVy~+Kab{;~GqT0FWEmws1tnaLGF)@;2iUb6u{x&7HKpPHR&tcl>JNwEqFFuX zJk0xGVr49yK@gF#B0~rJ1|q_o@Q{0n2ruukXCL@DNve%8=VU~XG0ey|FH9D=@TAm< z{8cIyVr7pfS*K5p5`$kTIbCdyVygN{GD`5zLHrjU^v(|pRjLbuIUTOAlj5bk6A{{EkCO(5gOyUpx?NRf=racr82I@}8t9Sz6TK`Ju7% z&av|jw%0Ot-kl*_e<)~&0P8URt^J*xcna9uXlZ^PZo+DS5-;?o&PHAHwUPRzbGS>l z@8L!+TqZDQ&Q~{w4h^1now$*krE%vYBpdo^UVB)s8X{}wuJh^5@k2Y$JL}NLYnGSJ+Y*F|+VfRJo+pCWTq&Vd z=pJM_e2s#pLrXT7*YB;2{TUb#Ldw1?2F^tGc>P+QHu6)U>$b=4Jn(ToA^1l!qQnI4 z8XYZ*r*hU&Hhz@rYmefo^F+^%dSU18-7FAxk038<#}FP6XeWxVH*kFFec~SkBcXeh zd?^>>SE(+r+>|P3B*^%#x#V!&vO};s9QUR-fDg?XcP70nTx#aDjb}W?1Hlj;#NHIU z#kP`HEDhH1@-sHC|I-vd+KPAuViBd`6{JrK9a?eTx#GOTa^14@ynC7u>u~wz^@mC` z^>93cJBDN~1sa)ym4uJmo$#w9IU`|D@2t-~-`rgH!p=U^gG~DQ>X-=NiEA7=tqQ4o z8Si=u7uOW=3Khxcp+^J~V3-BzAFQA6M+)9Kq(rKp3?N1ITObAVQ>hCo(gknmB=d7( zYOW*slKA-Lotp3O5RhRHPX@5_$DLYV|2Mnef-F-k4b|{UGMI_(uhuB0t&a>Hns(kf z4Sj#bGUdEVO!}U>PQF|vFJV?4+LrP##)8AZ>WNCxFZ*U(8#fPtn!X)Qk0F*BRk)+5 z2)!Aeg4{+OZ#B=~P)YqpHy}YFJ#0m4MVUoL-b2;E`8UJPuZJBLhvoBO+Yf@G@RT)W z9GY;v!jWHb4zEZNvPu>@^!c#!Q{+5s`Ny#PJAwLt4W~Cm4znICVGe~9`*=8N%Om*Y z@HbsOa{_gtw8SMQ4WH0WLN87_vp{+fsB z9jT=mB5?qD#F9>jo^`QUYaM03?p`MPAC+zw8kQp<(X` z7;!?uO$-t$nA5}S|2&CkcMo$!+ieP~(G^SXL9J1I@lSnB#bl9bgG|~4iP&s1=|G{- zZ;^U=2e$pFWpB;yKM}i0)9{dKxW^LFxqaAn_MnkhP_r4DQ3Q>H5z^+mH+MFiGSt=X zJR%7l`mbT<4h*QwvT4};zXbi8%dUsgQ!yJTdg?cuITmu0HB5{Is@IhbuSe9apHs!s zsB+6**T`n?Ai0lubWf5`RZFPim`K7G#0gX>>nYXoO8*@LFL>Z4Qv9-*ZQQxJczFBv zP31fHh&SXtgw82NMqLo;9o7i{VA?mkcTh||h#;qbbK`v2c+8M=ACTMrz$^ZiCJRz4 zulP+G3lfKN%3lz>YW;Rfm&w63hca(RkWTz7&I~EH$Q}$Se=tETG9RuY{grLdRq^nx zl;v&E`AM=|cc2Pg*f7C%IMRZcq53a^=()o~_W{u*o$_JT(SwBDO!X3<-QpJW6v@Mh zF)L-YBCvCqabcYw&Wj}626}Zx*f6du;u+2`6tTm&_m5|q5UCWuUCwmrZ_TwXmHw)-kA2qYICpYVv?6vFJ za`EEgsYs5^_2#U)g~Fx0Svjm{@oo~=nw~Z8oCViqQ;7o`_bE?tVaS%ATqAFmL7z=W zQSc{{YuQxBZWCAB&N8KL+7<@KCIvo;3MXx-I%g3D5aI^hO_9r_v}m<-bwCk8;}KFm@#&JtI!|kC5#Wty&jNTq@0seyJjWbY5atL9uL+;b1i4caRk7#5 zM#7QOfcXMM5%DugA4ht`Gxl-P5YaP&oRr})*0u@x&|2;cv+y*J@s{zKmGa=EjOUr-BDeOPZ<>5UD4cPBPmkrBHhlFf?N3 zXJlMxI7TNUgA*4#k@E;nuNP-t;;4@*!KjAZu54mSNrv z6K+VrUY(L;)setzQDsSjf}1dc$gP4iIx?2T2l{5xYZHNMlKieo0Gs^jkn^D-hqcn8 z9nzZx71wGsaoPswH1kNsx7Gqeogt>!CWwVbr2u*t|CpI_YO=l0AY>yy%9u@TLQY%Y zBE8izhd#}166{L-`Zn`+jI0Jz9tQ1_nsFoWXf#_ZzG;#)E0>snS>L{-K@q|%_R&Z6 z4BQy%(ig2DL+$UMUD;+wob68Q zfL!&9HuFYIEA+v8rbfnayn)?OeKd6F);Z^`a}M^T<<>ddHi2D0brhb8;ofh_$| z9`?Ol_sKx?uzZIyl@&n%Jyk$x~t4nNtYxA-U~h z*O-qr5WWKQ(!HXgwsX!lAaJ{-k%Ra#LCJWTD0FE5Ip;nk|K76moNAq*SpLZMSSQHRXRqCKYsJgw(jSO{!{dsxm}GFj9wQ+F1M~B@@d}B8dK6gp4VUSh z)5Hyz>74D+z;F>Y1x)<2^nbzS@$_j#iK8NQnV;r{ot&;?+}5tWHO%rmTn5Nx|MXm! zY9i#BTesXbT-x!C>o#!1#o3kk$Bf5&R^gQn$+#MMh6zkDFT9Q6<|d|5H{Cnzm{BH; zOgp1YLc*J>PI!v1L^o<67r^`!H#S7fTml?@8@6&)zecR2bFgy7=iN9mR5ZoSY zc(w9HsrAHr?4K(Q7&paW&C;amUD6jrTs+F8AUH88_9iv-&3ZxtqwV2-x#9WjSd*BC zRX2Lhl!P;?Mp7hs&#qv4Miq~0RA4v=ojhJFuo%5LYNCA|DAk^wTbkz5IWNiqpoOeIG`?QNyMqcatTUNwW{7bVU z7Fa}H1bg-6wVlLrEZOuxc1K#c`4DvTVlwYWkQkKO*DZsKK2eS{&irM?*IRNa6b?aP zX0rLEQV$ylxZR|60E<%YZjY>4h`nlFIHeGrb4?}EN+_imJqrtDh371}@t}C;tcy6! zQ(QdjBH}T57eR&z?7_H=DR&Cvmu#l1X)^YlWaHiqZil(8(FuB3Ar99FC4hZKPGUV7 z8t<}7<_^dBLWkZt>%4H5aG!V1+EN8pB_EwlZ8OZFVO37(c?)kaWrBHN9mxLt44U-n zdpmP{3^Wo1hyO!I&pMBu#o}`GtovR;>aOfmZgI)FYjJ7l|KV_Q=#cBI({cwsuZqcpn_zJ2T>U>N@&qx->dA?ahveqmHF0tx z6p*rt6aWs|WqMj(3UCOOA1Ug-N)_=!*Yt*%)038S^LWb8AJ01fNI?DLS(QRy*q3bp z`#Kt))y6hTsgSI?y861hsIp{f16pcoxT~cGw1gzmQi#d*v8Qa>)E?|cIU65U6Bqv- z!j12}6`_V9l0tkX@+^F^V&JEMjr+gv_KbZCr)bKli+4(wpY+;zxEW981Nr0WuZLuS z6JWxj4774S-CKzIk7NYAdo%r3?;3}3sUfL3vk4{U=tBJLA2pW=`FUz8Kdnp{1mm+x zPw}@Q`8UZ7UM4C6H-CfgnnM)@(K#sEJ-efgNnY3O{-@yiFN8|4R<<>4MGv7xe?A5-oQ{dP1{P zt|@Yb(Kvd1QLy~EN<)c!?ZTZ|TKV9@GBF=_u8ViZm#g!|8ld$M-({w>Hy0m*^SvF5 zAK+)rlb4L=pv$lG9u?*s5f2ku{Cfwh*PsW~r2=O0(zTrN=o3L`&43N2mqT9Ck;`>r%ymxAT6DA*B`wSEcdu z)=;qvA;v-oNIx7pbo_1S-`;kx36|q;yRQ?6%J498qYQp4SuEw0ILolMe(l<*vV@*Z zeO|)0b$KAmadMEWfP(uU_iSEiB5!?6BscHh#C?))yr0E604#{t;3CTr0tM8)TKTfn z>Us|WMB(0YupBGPZhprLa-<%VUd5yZ-8vpXP^F?V7w3>r|!wOd&EHwrR8g&pF#V0*WP4*Sl%^?jz0#u8nyl%Mv zu%7PnYtky)>4t;69z_tb(tTlPiv-Qitd8U3Yy$-vS5(iqcm0ecY~Tei3+&nOj9z+> z*QMC__*!k{9>IMY)>E!a-_3^u4Mok{VqAY$XYeu0MU-O2+j&sPD3-rng<+u-KYJUK zRAC?-o@`?42l2qMdX<)=X&&!g(W5~K1_X+3;2EsE=NJ>o;}-?UcF0dIkOmNpD!j?J z@i{|WE8AeskP^~>6(8D<1(LeV%9jP26YnARtQW;tS@~?Oe5^4mYu@5%gdWcXIh^y_ z#Z2%Zp&@edX-jy_);IX@hn263&3#l%jw^JvmDR65*yEf}n1H^?V=lyUiX?l5uAQjHJ2c0B_!OL5Wim99LClzc-q_)C9Zv13mMqpS+Fv7IOIO%}8$<7%alUtkOuYBb=-=S8yRuns zoy7(CyEbug+M8tpUTa`aIB9nv7EptYMl595Es%vQwk_{N_>HOf2mBR@|BAb}nEvVW zw2;lyU!OA6d&b#&25Um^8U1Vg)JL*Yv*z7+EZne?%@<*sXJyrAWkr?E6J?C&@o@br z4I`-qtJ{%|Ab$5!>92-U<763kJdFzb6jgLJ}S~&X(_BfDJqKTBz)=Ccd$o@z? zNKsl{g5Y;pk$ja*8G7Z6^A*zmD`)ik`Kh_St=aNiHeW~yva(X^;S7_eyT);@r3i4C zs-w{B#O4-^m&FIv8xXiPy&f-G{Zm5&EFe}A!9vxLr(|3M9({=SC@$Vt+yc+5DxgYx zqPgBo8Dh>j83G7%#{DwK@PLS2;cHE74j5jr4->L^p*_wx@A|Lb02ct>o>lz`#G0d! zKs2;npjx6Lkpl#_5fRrze0_hBaC|a1;@XAorC`W$PzwodzoHs=GjmQ6Rv7eR5CSSM zlNe9EXZU?3ltF`!EKS_n#9J03+a=n$ zJ>0aT=;;-=#K=#+ZBMIu-IE}Eh>-2XfgetPaRv;A=RJjmu0I;b!Wg7#n1gib7QZzW z)vXB(Sl%+sV)0Tcr&kCVidgDpQP%Ft7t&ITE9+LuWh=wAH@!q9&IX>mi_nyzxHHZ; z(#NRfLg^#xbfz#;rrP6}U_p z>>ZLkjB6?Hr-K)VW}R`)I^(czuy_Vlf8cWrj0mL~^4ZE;uw~%yxVBGAUY2b7bLEcU zhJp9$UZ~u(O+L5^`=(~z4v}oVFt&2z&OKcZ`2^6<2A!V`0`SiURnPJ#3!n{TPg zLUM?Ykn)M6&{$K|XP%8|A!)H`dB?C324@1!K)K|QD)=-WybHudSdu{I$rh3%PFBy+ zMP{XiXDD%mUL^NYJ5ka+V7~SvB@JX#M4p-h&g90Y=$7 zd9t^hPM^2Mt|Z!;wpZLwPRwGUEyo!*%*C|CPU5u1oe|j*C9c36hajx!l_M0PMiF6k z&T$X@&=MJh51nN9qwUPl_$Q{;nUUjv*6`-#u-~V@o~_9tS|WckIM#{9k<-%W1%apT zjKR7|IG89wFbfP0tIvMmNX!|;la}#}g;jBI5KBcsH~iLsA8WQAzx|C#6Vgb>RE+L< z3wLoE`oj>TDwbR6gOYN*N7IV6gG8A^^f;O_i6|q7?2!~^l87`Qk3EoW)3(ZL!MZ7; zyMh5W*m#i~?ACbDV=SFoGhU+s0ogDUIaQ~(t|eVGf_yBXI~MH3Le$XDf03?xaVL(1 z`(pWhjZ+;5Zv;SX@A*u;TB$~Hi`cJPPlrVz)$JLvf=&Mrt%9{6s8sxGeL)Sl?L zq;Vr#k*JNv@x0vBjX1XGOiD7q{}nP5V7vgKPAz;G9*ZVY>qCpr% z2rz1Axmzs`DQ#svEwNa!d8^DTFcrV>+@agW9UXeGr^{qDunT(5ULhy#urc!gp@=q z6O=}B0ec2L#W5kr;jd9Y)q|VU2v@`&-N~3v*VY;`b{-KBFPhla=v|O^gEiCS={T!( zoOT{M4Ra}rjxFJrW@7iL-JG$dz!<2Q zf8gN~0c?pM$e4yv%;1~TRul1h^^d@Y5sg-JU>%orQN}c`XBvOr380J6#Uj@&kNUT# z7pH|}&11V?318Aia#wsyG{IklKPfGcF4-RP$bz5*Q7S}d&Rbti8up$GD?YX^jB5Iz z>0ic&<;I7JEQKvUQ4PNzq3K;7veI?aQ&ReD>9J`CzSNw&r27Ge7=UP~cbzyoaex^V60%r`c+;hVeOW6p$l{wY4e zevnI3?eiRK)|PHuM+RxbS~&QKHj*qu z)cT!t4sY(#%Je8H9YjVhh|n`V{n&c4w5^X!_0|~^sFRrSk}BPCsB&4*q$+bUx~MXr zzd$IP7f~{gz`_?VqVglk=T*2@?S9-Fp4Q+gmWG!I%cIN>Y#_681K*stT1;A>Iex#J-m_-HCCf-&Haf%yN5FpeN&7f$4o8%W^OH<^v%(r-oo26Y5ULyVb4(gp~)lRy2wk%A#26AOprI{ z3l2uaWsLiYgW*rgN9^)Rjo+V|C`-;KAZNX7_toWnw;lJtGx7n0lC>%+^v$##G1SNb zN5&UWK_UU+ZSk9ffsv7XoOzUK3j{rLxsp%8*l^|z@AZF9Cg9gk8K`SulY$fYaPdi$ zeGnED!2|LXl)OsR%UoUh_%PK-8>bhADuv~&WaVMX9^QTpggWMjQ^^w-Lhej{`F8Tl z?MW|+FHhO|<~Nxw{RDv$#m!TbE=qsy{r0%;+x5xcKJtEh%=hg>eACYegVQ(5KTf&d z+h2$Ej-f2?pHjWMpWQAmE}Ug#1qS6p)$}m;={DxVDU;;7iFt?oiDu5@&zRl&N6QT3 zZLpsiB7aJlQ}|=PW{V87jkUQy_iV8UTpNi9DPd|z)6B_J2(bFGEj-M2rOo{*zVlqA z-tP?e{cqmyQ^RZ{ZMZ{8zOV6qf0p}x1mBCLLfe!u{lzx-Ml#kMk&VC<*(9FuQlk4KNfer*?nCCM8H)$))8*P}xtPDiNkG%3l5m zTOvwbo4bDHJffr!xGzq<-dwWzz{(Znr%WRFf``A8l@>!TTP`HdeuRF`k-hemU1*Eu z#ik|3JKVRY+MI1-f))%H=O71jF(Go9d0kmNIcCNkiIP(|-;e{xT9!P>a}&?=#VM5f z=cgLt5mB0o$fDvcP&8{L@_2c&|=U9l9^ z5XrCT$GI;Yh8iCx`Un3&H>wk6NRNG#kQ|wiaZjFK#4aQ~AV8oN_j<0D zs!6rjR!o%@@(8(+YTSCR8km84t4Rt<&`!Hvk{3ey6epReD~Ke_pGd%Lp(wYGt6nVh zL8y9kDm24;Gkq|s)=nNqlsCfZQgnk;%{CqRh$$fegbe<+1=zrE*?ldc?vp8Kw% z#0rW|awUSdX@NvKA4g|&2~H*8`zjAkdA5=7Cf6)Do~*iuqV0JzDY{D>htK_0F%&(5 zQwjPS0<6)uT{0?;IFpNuhEM9aByl7ar*(x>arsqYR9s2kR4T3FRl`b?ipfH*Ub zqS8yJD1!UtDi)$QA7E0`OKF9OONh)M){+W7_Yyy$MKMP4VFZ>CopK;LAxV^=m5`O< z-n<}mEqa9yuT!4)!gx59OQUbX(QDjP0SMm{^&oNu1oGng_4Y4H=aJ-DPWgS0n z9u+r!1lKz5!_~|_`Mr>k-~wUkTY2{Z$lu_s8<%=;Ea6~xyOQy{A1YplWsWO>a#&09 zR0y2h0Sa=oNI*fI_qbegs`FT1-Ylx~moC>#sves}hkEP>?=$GKL+j2Dnv)aGc*gBY+K#o;vsS!6C?lgtN=qc%7C$EE0@{yqe$a z{44o(KY1D3D2wMSS#hF(AGB_!ej4hZ;zgM)3eSB1+H;rwuk%GxeikWzAhYuY@)Ap4 z_P*I^A}`V0OQ9`{M=QORapnp%r{|)TjG+%+5OGa+2GlUjANo>EntZa-KvvbkMuAtP zg6rTmjGkwnA^*Jn4EYI}Wf_P@#mMvUnQZLbFsN-tV zlcnB8N2{n3QgM~l@q#%EC#>(Z;U=}Q|4wZs{I>q84@(t|`>}@RO6HdUqk#j12+eLG zI$z@NyyB5QPL4jT2_1U4&$$wSP?m@LRJeq6@MLmiKrc$ZFX?ms4Bvw+OZrsbPtxHs z@qOI#N(>_x_c<5$IoLr9zR7elwfGR__o^~tX~Pu-t(ESJs=?b zE0anwS!r7po@v|0$|A1Qv1JK=;xB&CMq=+I?U&_IYZK&HTyIfIHpGtxpZpOz6w&95 z0em(~M4$UJYIC#?KKXuH1bSYxu2f8w?ViO%_96Uk(sU-m3m;7!qk>A9DI`5QoS{iN z&Ro|XmV3X%u3Y>;cYBaZzMr`D1bh!N7=~TAhaPg;!c03!3R8W4^Uwu1m>*mdN7>9B zS4}`q#(d+dVf?}e^R=s{KJfCT%cu)zKbV_%3wTOnZs0B8tdRK>Z*hTgpWtm~;O!dT zxEoO7(vYWdMnoC6i5Xf%wmGh zR<$e!DiBCW6m!gFsD}J!HpOmbx?GKtJ?Wq9*%N)ZCKOihw@)B5XL*Q&+$N^OHQ}j@ zd5x57R5wWy1QBG5&F*4b4UC$U$OFaEcZhSYT}kRTE3=Oz_OQE-3sL6}y?9AdYf6)g zN>jF!-n-ZJEX=EY4!*$uiEDK37kP%{?44%BP8HO`@Co=&;)Z_3tpfE90le;Hzu?MR zh@;TVmVr^-hrsOWKgrWy7GmK)9hp;f^kA{ge+XxL2V8L^d`(T(!Tl1&}Nr&v&&(b zY1!;j{SBuX%oyooOO&869xB}pE-xLEco@tD@`Vn4R|vfUiCpjjr`tx|P{ZGZbJM|% zG*(-(^5bmJecPi+5Eeg0{j$=VW)cULhjI5Lq}GI#s{#a#1kkufBIKTT?~_pXV~v7>p9wWyY6D=B38h$&(F5ELD_4c&(q1ixTcF%HieYOcvHH54lwT zw9OUFyrJpk8QF)@?FTKHF1OpJNe~UL^TSgj4$@1H3%#&FjBY1z(7j$@{T(55nDkFS zwW|E2!_6B)Ljf9n^R9Zx$JrZdmnidNi|xC(ZLDVNhuZ0G;gz^se$9KZa3t@V|x8 z{kjiE{p%jB?f(HrnUxRaq^z0mb@JhU)D8^QKX9^+L@qGbG$bp`8CQcLtKpy%igT~C zr}{Z3v0Q062T|y!%*fTToqt^5ex56@@|ACGNLHFxw+sHghFGqK3*6cUr#|?1qai%@ z=)FzMJtqyXcGzRsSF#N?9j0hQWp;HN@8u9C`lLbG(Z#n%996Wc@ySb?Ba;5;%luOj zM{&7%ZZLf<(SDfY-`P`6<_iaRSrG(agFRb%vK2mMi7PoUdhtoSP+x8D6rBW<-awdi zajj4xILU2;aA-;?cqc&te$rQbe?qB5sG=X}5XGGnNBM#DZ}9SN$e9q5p!nj1ov$iH z=d*8~C=o6b<%!_~?HBu)6{P;bW=*aTT-e1!KVh3&Jo|^@M~Lkmvy?1~)&Vi|Yw`eE z@i|*jyi4j^M39M?ASjB;+L)3aWSUT?t+;f8_zS`|f;o4>@LUI6_)3@uNP}awiop}| z+>X@L*(FgGM!701RU^-c%EP)(<(%L#11BJdRnO~#Wd?EKqUa&5{gkvu__sqTv?>Mc zTis00i6b!0b)IlKPdM0ki}Qs0XO!*4tF2o&94r2IB8gZm;x=MX@ii=YsyiP07IUGa zCrV{`HOUB^A)kc`+bnl4;&r!$D+eOvv$MOE;c`WHSOgWZUJ_=JA>OBC!9|MhZ`)LPS`T3a}R`Pw5+M*%E0Gm&7Ks~)vj<-qW*~!&2Q0zOWuNL(dooc zc2|WrR@c@vN}4z^h2&|3BcIxunuUQDTGnWOfUX&;*Ps~qWr8xng2t)OfD$qls#i9@g`%< z^Q(=qx$EcQe4V3b*x*WEmdYC|Q)_oZ*9i5LD+TJ9m!(;am34JbFMfq@M5I;2)5Wd9 z#oK~cNKTkUVlnQiXw#ELi(C0(CDoX}=N0mpheI4wasCgTyxuv5ws-d7j!?6ZMhIj% zlSg39c%WdB@?;ctWhQ&->)p_d*T35O4DkCrtXPlpZNGh0al04uWT{R4d2ha;;Q7_$ z@aX3@m?V*@3AtBHScK9d+}i-VSQ(k`=){CLb3a)SA>d!=MaY7T zBbTJ!Jd?Yi#0q(*hBLXqbdP+ ze-xBDy(iTqhl+)woXVbdJ`5?lyE{|OBoxGPfvi!?yoPF#YA|$WYAbGc_osGOhC#(L zf5D#ineBY#KA0*dHszcNeOJ&Pilv*m)eZE4bRaH$J30tcN4C43oYp1MGwWXNre~6S zX)jw+lK<)8U8$`2S9fo!d`=kr*z@N~7ld#)hQHzIt=1I57j?bGk5Kr1J7aG&t>dWm-lA8PJW%J*3V$X$3W>_R96Qyw+vt3$Em2FNEHKa=nL)=mFC8B9b?YI4rY~ z!(DcVJI75Y&? zl=HAESQgZ{aIl7Jb2@3$8Y!+1>)j*e=RHO>?4$P7F0%-FTV$ceNb%;mPVC&bJS?ty zlydA0+WqPeVNNnQ4Y~*>n3Qc$L=><2-l5=Gs9ty@9uGgr)OiFwxm?F2G zHxzc87jKCV+mzegb$%rB_QJg({r?(|54%y(edW1LrtXjXz+QXesT+gc-OqKO8#GiW zFX`T9*m`u4p{BdmV;JoIMsO<9Jet#+yEqoK?!K}QOYQlbNU`$Zd-B;~%7?|Y8G3=< zUow9slTsN!LoOG}N~icX`CH#e89i zT?R8i(2~JZn|oTrGZb`WW?P1uj&Ie?fY&CoLt8rd6q;oW1X``q2xu|?(Fo?hcfMTP zhu3;jx4|CoJ&+rN7g$0g%(FcW@iUNSTsH$%^f+*r`%A(I>OepwtxI7336?C6$II;W$M)e1(rqW~Ee-s?C1G%wTCCCTGcIrl<9)F0h~p|m@fQ@q z@L@a$d!JS0In?{Ce`8Cy!?bqSCPj|U%KA0Pos=5?{vf~ zxsUoze4OH~%GR+@TWbE7){6NcfYAFO=^2a)x%H|@01Nmn>!-~wWw)-M7F^2e*8k~# zGS?gSLv)~xVjlaXb=Tw}^=Ga8nExu%U>{w2o$x~^UU?gO1@2u6Uqu{AvQt?IU|b=<5}9BXcFGrbk!6- zH+XkHrRe#4Y?Is+HiyrJ&O%)#gg-FU&EDIJSh^#{bn+evB2i_-F;@h7YcOWxz>%U1 z@>>X#YcPC?rVR3@@ys=qZII97p8q#{-vZavm92krlAMGjwtz^H&`wTxE6zZ)MHuZs z#PCq>1uO`i@eU^zQ15kSbUM>^s<%nBA*iDm6$rjUl&8`neMnU*SevSYy~UYvtgRhO zi?zLNueH*#j>`Yr=Op1#wQBpn)6VZY^Q$pAd!Mz|UVH7e*Iw(}64MHN4&p!4Xe2u) zM<;Rg>I}7`Trt7VGgc~~MB+wzRY=mq<*3Ahj&m5lg0wmH%v>>w5@$&tpEf_u7QS#! zTexUWqe#6E&;Mnh?PySIpL2o|z<-c&IXy%Bf$oy-l_340p!jHKN{KU8v>*Tpi?EqN zRPfIv%arlUk+Dn7mtT?YSgwB@|!Vo_25xCxylmKyE(ivF4s4f#(|MZZRKktzw$ zL}_AWF{o>wVVm(-^yF7hvW|N%1c~lTMCY{@Xi|-R;Q}fuz+};s zt1S15v|;pln}u|5ixDlf%{aYGWh&~Q(H%YYNclZ8(q`;C8St0qY3oUXx1`LgA0z91 z{YuPT!PQ(D8w(iWEH?{3ugke_M)q_}Bq{ z9u|fcjsvzz@_c(iRCiyS3%AkZ?y9CJ>2q)v=+L;);U4`@#AO8F=K$OEXj}8;ppT(eu0Oa;Q@<*E(#C$BfflSH?9ed%_@A@8jb9u(q`OEuL_15W>43& zk0$2-S=fe{G<1LAP|$+p__v+swN5)&zpGuGad)ff;z#FFOczaSI$K-&Q_l3C`R`6s zYr@`_ThAnbwS56l75$Mbrd6651Lcw#6Qh4}c!D1anA*iNCbm{w{K!#ZN^irhOXCCJpx9 z=`Tuw@2U-_$gjJ|ujos&QsW*Nm>{1@XynKejHLsJy$J_i&YtL>{ZQQmMfVu!n|b}q zfSXJb?SEuOZDv5-a|4qDHrLoh&Xgi5D22+X1>z*d*IOm!mWv?Dq+FXwHCh#6nzX*$ zn52g{-6D!?9hfWvAPVx~kwvSH2t_J}TjUKtr}p z4vfKQVm}(y(X;+#rPlmkq(Oc!@QL^hBHAb?#y`zArs1NXLqQr$x@Mk+wLU5{pE+VJQ`ZG3#%=2t3WoQ*UkPH}41k>y%fs|rl4`2jKx4XO&vHenC_c;^}t}JanIimsDM-meJ~FY8>mvaHIyc+ zwJn0OKYOKOpMTpUzEG(x=*KqPVNf1aHr|)X-1G5)u8$A=Y*X#W2O^aN%Gq=FPE$Xu z$!o2aR*k=_=Ys=XeW;lGY3=(5BK-!+nxZ4Q?b=9@mh<&_NqR2mq@?Se1Gpjhodf24 z;vq!7)~s$$M9S1@IBSATaW^Ep{Qv^BnsKHIA~om;;*JSh59EeZop}MeR|DfGr6ODy zpU~+)npz~nS>f)=1GugC@^4}C?x)l-_H9f>XSkIrGGjHKeLTkWx;s&OQ)5#Qe0uKZv;$zb0zPWnMCjf|2# z%>^GcqavUbM-lD&NC+6S=#J&gyt>hWb&?Kbjd-QTV`cXl@U-qon8 zsOfABtEq8>#oIh#a9c>ZibQD)D!fGHkX1Z`1}%QjMasFU({axyO0_M$oo3#I2e5@C z@{stK9I6Rl)^FF?Mp^YeO^A&P|7(nP_)fm76PqSDrXD}$zdGb#xBtUd6u4VE1~d~o zH4&^J`&z2E%l~*+yz0M%+~>l@3(QZf`!L{5(U)xT5i##;)KZo%e+wtFbj4dZBx9Ac znH+g;3Fp^GHJ%im3%JB~pya36?R{SO{fTv}+ib?}$BFi(676f#(!$#=IOW(ywa}jT zL@}QCB;|Np7XQ6rs$%s@+rsV)vyN{Y?rSU29MrUkg|>BCp{-eDEBPBUYr#k@Y%FIP(AK-Q=FIyE{ZJbU9m|)61!kbD>Ji0+D*BbLj=bJm|AHOG+;S=05Rn$zeCn?S#o4;`^!#}74DQ%>5FLQ zBsFId?S6+cyhZ+L?V*@AiP4Jkll`jPStvKGr(XOG?OsQjcfM?TT4+`f5oVjQ(Gj6` z6=_?mVq~@;GL0!}PK-EidSQf3QV_B9%ZCecU%gTwEkp=YHO6hG@SW|+JX4{)Dc)tFZ~kjBi)P9e%MPHTM*pDo4m8w{m5;%k-F#HcANX%S>K4a z>F#987O`~YlNb~KRqZcDgsoH`gk1NGlQnweS~gA`XDg3rl-MFxuCyG!)F^KcX`){W zWN-!`E0G5sbefP&EqgQPL(crsKG>#n+{ql9NV&DbHruV>p9%3i<4EP7I^%t+I#v1U zuhuwKiYB>DbjCKjT*Taipsx*7%m6JON~DcJ1_+zbkugZe6`Q=Ao}j`TdJn$={S{GX zK6RQttx!+2h^fs5mcwt9?fn=L2L9jp7j&>}?`Mqxs`j!_BBc*R>sX-`un&wOgL2_i-}O?eNp`Lb&8iO@{sfIlu}P>-_ZK6 z$}NnTGY-{~RuL6FPV`|!fg~nkT%`8kB^zBGSgv%a;hGM4Qd$s1mZIxFYLHPghWB^G z*WZ;GI##J3Sha7)V+A7RkD?=K=G1^K0fEn0xs6ToD~f4_BXmDb5SWAk_o4w+F+Li8 zIKbo#sK$_Uh4BOUK{Xv8-7y2!B?Brcc{Xamoj0J0B+rHqFb^Q)M?CB_kxytUdy#;xmGRroR)irfimQ>NKncJd2B6AkUCE%rB+YV zz4BIm_<)72HQnDC94^(fYwhf|fg5(af48abZbk4o%Kbk|eeL_kF8`DglabqIVV_AxnEM&LrhByY9i_d?U&ZL( zq>X90Dh6oZT%D2IHH$HFPNQq)!gBTf%V-Pd;!OnB%SM$%$2O|h>%^3uYt(V|J*Ey- zbzD~5&ZSov;@axCT}HP4XH7cynZ%c9Yn}X!iO$JlrJALYLuXJlJlTuX4&m%*1W=@eA(`b)YUl=}b$Vs#)@oSXmKzr`_( z0Rh4>ze zmBghlnHRc*-K=A`;$_K+*k4Z;pRu(=QlYCp-j4J!Q(5e`3+nAwkJq^*y z&hA>qoH%l}qN2#o?NUuMEFyixy@+0n({kM#1|SHd9|cKp^?QOPs1`~Wge6i{^TMDF zO9Ww!hXOSU@`ALC7~&Em*QhMxcCOCBKwfBWe1~2VCCIvj zmvz*jtV@WjjqKKirAGIa`OxS(jM_4}k*!<$d3?!i{M#^d0ENmGB^7pJT4pldJ?p}<99sfc#0_QY@0&=5j|3ir`r3)g~wj!$<)}U7yk_V5w zW@1!YaIxcscSNV&>3rRk{emX4WI(H+PzbA`)ai*0ave?)wEWmyNYtjN!*jd*iTV07 zovRHEv(EU<5@YCNQPNy3k?))+N!;{YV`whBS<7xUcKMTa0(QMv7q@$ zT8Fkz&zNU4hL%Q3b$r{zNJ-o@oiS9$w?zW@!7HGaXwRD>?KC7VXy2rDdQ{b`M(en` zWfCptT0~E!=hB8Pn3`ZYOe`?1W1Vx}qpkNts#W_REpw^#Fmc+}0(x?wTTX!}qK*#; zyeEk|q!&(zK4DIsIO;}}A%CC%*9FXyx!(fwWet9y)}(E9YY^YRP^QgN$ABKfJxI}p zJ~?|S(4G8O5jMh}E{&9d5qOLgMOazxW5oqAfSXH%0B1~VA)OS+93o?&edl_;3=zj* zAHEK(F94LqnLckRtkdQ{mAd45o;m9ZA7dCy!VvQ`Z?Dwppue<%Hq?WIQtcFV)KCsE z2EQib7b(>a8v`wGi$Hj?4z{R3?2Kx4ms1{^nU#cu()VaL0n&kpOI@P`Dst@b=>N$LCi<<>kJ^OW zp}m04{t1$^Re_b^6cfp0XBVmD*_QS3@kQXnG_f=81pE-@K1LX+#FD#$CrJ}sEM9?e za?@0Bnk3N`DDa#?7X%896)b>pm?92QLp~sX&j5jOv2e|HZl{6NsG$dSI^>p!`4W!# zlBj)19gZ)B84r8+Wbx9cv-AB|5u+Do9cK2P&h?r-pKmPmOvnmvwXn^0c4s;52*gPb z>GHZ3gnbktA=gU39H|CO;;4z(OCNGHl zqhK%DvHNsvy_Tz;xg>SWzC_m#+_09O4mz)Xym#Gb^1Ge^M>{FUN zIDo3jxp4S6mj&x|29gl!$svC%B+{f~o3zf<==HPo;O0-X&Ka-MXXiQ#^hdVooR6p6 zzaG8l^f@Z6CQpN<72Rl^^GaRG@aEJn_MLFKxLQp~b!xJFyRFf;t@Y@JFG zcNODx3=wLSJjbn5(2&wp>C{E%C|hY^@z`D6m0|F3zRp>ah7x zjmAeT5_<4aOKBoBTCPpY?$oi(CukA-ZhJ1fGwy^YGTz9&2;UTO3GPKZ+cYyM9mtQl zWWpSDr5!zr>vzO`clmYI?&*1buX#p0MBBA>PtVppvlOjA)tGzs;*0KNRiKvJ2nlkp z?A5-q&D^1unyN4# zB!3@MoCfq8Le+ufcMID-OOfnS+gt#ro$oS$(LHmOi~OSe?(15%r)TLNrK3gS>F`-X z3L4;%{8N{@ezT`%`(Dx$em2kdbapmW)Ah?eJzMYtC^6T1nskTC-jhv`Pmvl>t!CjW z^z_|R7{m%G<1|?L3gtu{SAl(F`j}7kuZoP$B;Y8OZlv|J0wJzha;uos9H_OL2Rf4{ z&!SI=`JG8xr=DwY<6;RS)M7mb^uak}6}isosvpjA(E39nmn+4YV=}t3Q4VHtJyeuq zDhz;HtjsACT}1`OX}VY^M_Xvf%-_s$NTEow;<=C}>8~WKpwtlsF9>ec+t#k+Jv~W# zT9D#q{srM^^+Fsi8Sws%dUj)0UYBl9k52fxnEX6N-2G85SK%g$v|6v{DgfcHWh>_B zKEr=?Y;C-@lkCgznkCU2aJAFMrGHG+%5&K|Y)0L4u~NX9y9SpIo|lEKpJ|LnaqVy?!-KMe@ydx>gy$sb zk*D$LP(1#jcO_}N{Im4AUH%iq=pp%j15IHqP-}D3DByES5_RWsc?R}ht|ViZ|I9J* z518fz-K9H0>z(oXX-PU)GQL6A>e=Yc;!0o1+F2Beb&hk8Eh*aopZcs;iUnUbPlllc z;4)W7?8D9hWE$&gDI^=~I8>U>6;BWwlAt#*5zdn6$}9{(eGqG5>$)55&Jr!_gc~h0 z&eOpZI7`&?7N+GwjzOeBUANofEU~jr3sSgmo)oBLQx&=n>kfN3`McWCoYxG)Ysg|n;eL8kyLvh9gasB9Ngf@$F zz{*h3^%^_dQl#xP`iWLosvYV)JJ(_*x-b#nV?$I{`Id!kO)fT-SnO-3er9oawwVa1(HxB=h%w$AHE^V>S&6_KU2 zulCwxaAQS+Cn)0mqEg~ll)|rwA{6m{k+2C69MBv1cu;HJ1)VI;j%r2HzLH2$d*T-N z50hyGHOj@yB!*pohkBKMNLzmdrmFS_ffo?wB)nif1Vw}w&wdDQ0@)26eVuSpypiVw zX(}<|D|@;O+Ri>>Pot1I zPwfu^{VskSGQMUU`j+z4GuV{QNo?@LU|=XnVZUdN=miG;L=RVf;A23=aFrU_bQ<3C z`QT)~rs4N%8R{soN`~f-L-&eA)xw^}w#_5vVf#&thHtwFZ6o_l_aE-a=OjB;rUPpS z_+*Oa`3Iknk!|PuzHKMAf<}*3^ElVcDwtDH;M;fZ`lkENwcb4)Q-MX-Ia7?JjNs2z z7EI%Z%3LH&2|4EmlDLLTpe0!lGr!#tgq(ykySjpFxuMil#!ybFOUoKY^&+gtH=HT~ zm^InnPgBPX6?WK)8MEQk&xshcO&)a?_Mdv+_Be&?>a(*i!bPQWFl*GnX)?cV%Q{eTA`1FcvxE8aAQU*;vNPN*nI- z@I?c^9enZ9*ALesA7j4l#xT;r7tx<91#}A09?xF%w)g_5gLs)7Q+)p;mMHr*W&=(Rt6*%gUdbXnvVk!vh2F8`&iw&+DE@2|Tfr5?l1}=uhT!_6D!biP6 z9?lRRV57*$@^k1G>}>%J@+Eq~%SrRs!@r@Kr7$F9?I7zQgpuvpUW2(ItNMsoM{$CW zAMovob$Hi7a7ZRLzY!ed=aym};0GMu^15C?8(AkdVkH_-F-2zNoJNF`4cY59?pfk| ze2F0k%sL-O6q9>F&(&K~X`WFM*AWhwN`d;{(qym z4o(N65CX5ovJWTlcKGG#1y9&3im^3?|Bk?6<#gJ`)*h3pl;%gscB?zoYKMPNi!%G> zP8V_XT#Njewd5fHr*SXf5qzulMj4rvM2N%9J-~8^Mi3pxV0z5G;p@!3KX2}>@9{kG zF_-U}y@xFVqw|N_`{Z?C&#;pB=ZL<0!%4io$JqGz@Y#Evpx)j&cau0Hl+qJt#B$|^ zy(cpR0iSPZ@4vkIPipT!zWPsN@Be!ByJPQFfs9y0aoH~#xfd`4;Lcrtet$f|&%jDH z%$++9o+gJ{d;fpV@1r;N=ZL!jr#BJKp)6a97UDz_4?`ULOOzBZtFXqIcd! zg`B*VM#`b_1`^WaerbzVqYzrTx=Fdy< z1PN^ME+3*w7MvqHDLoF&({d4)u6zm0y;J|}Qz<3>@S)%naZ9PUx2x=PbiwF5_tkjq zo1(1DT>X3cL-X(wH zTH@#+cIG-7uXec7C_C2>Y?SKR7S&jbgzBEBclynlB-$dz{Z&~RDh416DfP>%6qC@T zs``hBmZ8r!_BjM9kI50`CSBh1Jl|!@EXLv|GI9;7U`Qnki3BZO*PicreK&cv`HMC@ zG*{u=shO(GfA|Y>T@XJpva)=#(z7q{;>y-cLcoD063BiiRhvPjgp0CsHOTSBu;%Np z8c=?PG-?y1k?fK5+eR(qW(dC?LNm}Jcj-C|DesldM_*rTzR+=qbt)P1@ zc#4Xtzzmomg|4{Z4_40BpQ7ztlSPuN8r#b@sU)V%^%$0{Poa9Mh?ER}i*rTRr>NKK z#Y0?MegSeWc7=^PQ{H(t@%~1Oh6iXu2XAQ2QRp7?fZnHW|IqvK8Me*+wy$b1ZOY14PQF$vY&#} zySDs36mGp_YXX36(^;Er)u+AOHtg7XFM_OxP0j^6o1PuD@UIAAeHub$gNVh&c zg7msDc|}R*+2A~KJq_vC57HA z)X?WkV;aD0rX2k)2wC_Dgly#2j+8U#H4aq>x2dn0r?+rek9yWw_Wn3b10%au%dW|V zPO!B#C2DQC)G-F#A`7nGLR$w!tMYP@pC-Z9s$TCbE{&iKYeZeIw)PxC(ib`7H2>{6 zn2G!vfA;g|KwYdHl|&(0C>6{o>6!e!=B&k!A0u+IIXFh4-Nm)C)uGHpT3h=*X8kxE zWo^R=jh<~tCucgutTJascJ^8HXJoh4c)GN(yFn-82EO=w9*Hacgyu#0eTVPl4p+3a}$+*6^v&w~_B# zN+W*|BNWe%koMsDgtq6RBbt~b5r3{i8)i}LGtcSSZMj|ku{b%84f?87Wc<`X3YJfA zL%Sm@WckfcLLwk;9AOO-vEaZbMw4%WUO8nS(r%|n%YvO}b?olUz$6+S<0V-;9Bmv&~8l4y5Gt$HS-llbdFJ9NYXZ8Mz~4OrN`_7nVBIA(oS;@MS{@%@k6&2Y59umNJl)wMChy1V=4c z(7}O`eXe}$0zXhS3WS@F z;zyZErqu^e1wXO!1tH*v2yuwD9h?(G^eVKw?-5!4!fX&jd6Nx2J=mzG=5Gjcz#V5XeJmB+l=n>=D)O+#u6bc5KQ;N1;a*> zSNsw%jwVCxcJafq{7{1tynC`~TX05Qq%~##G9kO9v(oTk{4W#Y@!`dDP&L?!tfYAD zJj{?>9BhV5F*34}bP%dzpEa`2CWXLk*xB6+q2WZ?9dZ;#K*6Ezf2LR2>X(ll!b)GR zEdO^8!d!qN0JeY&9gc0;TJ)Tpi8pA{I^$8|mIkGtYJ}(+Ev8}c$oYI7buXSJ%l~My zme-+iMD!|JlQtWj!)9p0JK;PLb2rPq;nt1ai20NbebEVqE}6W5*ty5sq9dNs3x+Ky zNup=h!ucC&?0xgd`diF5VHj!-liV+eRTX$P!eiX6xtQ!^;fW0f$K}k3HAA{8%D@cM ziQ)&rZ!GwA@wSKEO-6#oNWd0)MW30|lPt2sDa`vB3LaGzEM2|Hd zC5AKXS^H$Gu$XvktB<)T%%4CIsDtd#0&jChzaN&%B5fS*+A~Fwv&Y%+a%89nxB0<~ z!ykCdaI4S6cGd@;2$NU??^F-#?vv#|tQet(f8PBydWg!N0i$=xS@>#ks4V#MMZ-Nf z`mnReK3W4M06U3}uyK>Yj#YVa$egXa2f$WWv74pZSQk=X^k6!z*y_}C+YF+MU~`ui zvOVbS{phQ8K{7sT1uE@YU4j-JO!0CjvZrvGiu#15pKGEdn)T}i3;@{kDssj}GjlIm z|Lr2$RFPl;ZK%8GuD^)-2Q!|ygZiug+-(_AfAzcFgY{RB@4im`)vDe9fcmRn?!Ke? zE936}tG~KVZP|CM{%Ykju%usGe`WGM_5G{A>T3O`ufO7`#)$6ZrXbW#9iz+hQzSH6x+e;2{s`v|Kfw;Nhh1(h_ts zFF@13z%W-Q{D2r{lRjJ%?hp8rw`rgy=n5Ftzf~7A7T;;-kHrg-VUuVS$7Eg!Y-6ik z>}GQ&A!b*yr(>fSnXNF^)#!@!f0zKK_02#PE-A<+?VX{zvB;kFFR{mK9kNOnt&JTk z>y;Czw<86Sna<kwYiN6`RzBJJDYY}CG={9}}+k@BS4iqMHFdg(>o zD~}L|i&UyrpoC4!t;1@q^A&)dI{D;+ASI(;gg%WYYNA8M>Pt%pO% zIZ(sKI@BvHoa3|qc@_~(RZZN?xR#~Y-2Bg5^oP&PhHA$F0-7Mccyz`P!;^fuy!7JOCmSYOCf2+Sv^{ zwlX=1FGSOETkPx>9X1zftqut}i$|BJWz(a5`HUT|d4Z^9)AQ}qQOlO5pBJbX+E4Pf z*Rxxu%1@+ykdjiQ=eDTQ4D-q8fQ7hrBC51xrV^RM4s`|u@RtyY%FjUZogD}ts~oPw zZ#29_8#0N&#y7h#q8^z+Vx$c;$$_n_M{@7+l4HyRagv4|G&4b_Cz4BVmg8j=d_5ZY z*Sq4gW(b12@RsNk<JxTpuE2-bxG^Bpd!ppn8jhDBDZ(D|1whYTWpxW{Bp6rp=CXC!v zgbg<>y_n*d4K+9X%RmLLx0Xz(tln@+D*km#~Q@1iiZXG&7?G=}&A zJ%#~V>->-OYNc1)NU_J>gZUe3Y2ze@emt{oe@VJGWeJgb%xvfg5i?SjCPC7^6H=0} z)FJDeLu$-)T#bRH)bk*1BUghY#`JL1&ZHv`iK1}$5OH}NMuxb!8hHCBRS6A~21Kxp6MoAWt|fu$rTk?6Q5C(+ZGZwZR^ zQ0YJMb!NfH7*UB4+t=xnjoc=nn=WQHE+;i7G?MBuVru(`I-|%RD?kISr*{llaoI zz_1m=XkR{(@k@jP6qbERX9l{r4>EpBeGvZn4h*=f9^;r^OuOe%r8sdydg%igQwSzS z+uCcVtP3eZH^$T;jOix~cswB@Rb3t6u`YR_7j<16rCyHFvv4&?7)cNRH5pL7Is)P$ z14>T(1_u=RX8~BcM~o*%jvtkCbZc7chZ57Ld|j6g9gt%`h=b&q-gG=cE$X_eFjxr` zub3Vtc*VRa6U9Fq=;aj?M&MiK$v$mY{<25EGLbeBS40tteA4F1LgfxA)9 zDWGc5tYIu5?<^hp*ViA48_cZ{V}ZQ0+oAs)edb>iP}LPdS^rIP=1h@Fd`7n(Yk-BU zC8+A+%aN0`3wGff&VHG08IrrRv$OMCH7E5=x0() z`f?vZBfs=`Y$92DPQ4{8KA1lYO7Rwn4H~#r^U}9_>TZ$ZOonZ$IwDtKhvb$93h9D@ zd;&0U(}Xi~k4*#VJTnEfDFVrlu!eTD6>KS=lp2VfR-YV%9EhRjuz*JKZmbk6zz!I| zNWRYw6wt(J11W@$=^j4*Ec!%x>d!}CC5tH1Q7=_U-zQRWf4SVM0 z1@6EnsL0@T%ScqKh_HeD1%52R7-2)u53g!@X&JUSfnkqgRglFA5g)MSF@s)1hWv#9 zPyWJJ2ZPjPY(<$8pD#aX2Kc!#d>ls7|E`yQVz)gEc<07-85kUgo3Vg#_$mut-fuvE z5P|5hFT}_YiJ49P(8oAkQI#S9kIS-qKbLw`tql1WDPZ(B=e(eI}b2`5&+Ng z2{|L#=S`XnOL*XudR&AM;lFChl6hD!9)p_j?p8F&vuNiH_Zx;TpVrPn9rG@q#BKD_5@3otlrGw_*tNPx7xT)f+uEWPo?dCa> zy#)tjifrBaolB-oR%uD9`?MsL1og;M85}mb@23fG#HK=OPHpSs#I=IBZoEbpufFy; zajmRmoY22_+p@&7E)3)EmL|^QWa2zQcGW}2NpNs)#GfYIgz}8XX}u@E-Nr!`D)X+Lh*bc>GnDxS{j26q?AGvQOA{Z!z<$O$pY|GJ)GJ}$ks0R!J>U)T$9xC_ z3w)+9;b4gUP~OKE_mK&=R4~N7WF1h?gW#}@f!o4wW55OM@LRWIhkZ6w2e;6(jX6p- zWTdKG8#vMq`!)@jxYskp$ZrLE#1fOe|7O@oxskUfZX3}^GPoI7=t=R38~LsnGW9&N zRRIqqcb#9~!Pua|xT&6kU$4R74fJM@gUqb;Sn8lrM9IELcijb!Qg}n_Cb>B`GuAE0 z8mq4>_StG{+5aC~jVo2Jqjui;ILt8eOu|;<`d_cDCb_M{Y&9yRzs6P<7Z6+Rp8XYD z&F8lA3A@8Yf19=%*6z0UCthQXt?p1?#7*LoM$cNx?{Pn2gqd)PRE1&+^vw`#oCf1E zXs-$0(>Ju&@DHI;Bkc8!?0`q{h{09`8fa1Ki_JJc#5M{s3OkgpzRH`gOQyBqvztw8 z_y-nlNAZLF)Fw3;7zciCS9#`kl{N#Esbjyv+>RAO6t4@x7Wz7V8UsI#1O$dVYCZ$O zbYgA`Ue<`YZC&MK4g*F2TA1Gt@<8Txt9Nb_`NA0x_7P<>*4vGNRncCZAGQX0tkfi$@mOyHjA5%qyN9>Fz_%$pTBsgM_bzSr|IAU zsd!%uv|$TNoH^WR3{wPO3~wjodUvrrxlvwnhxuaASP#WTUSBMgw{O0!-`B=X;EPRy z?n8NqFE)|d@2+y)1!iF5F;@^%!5`2_oUwoRIAcmgP{}5C0l)bJUy-3?j^kvS$pceW z+eZ=k@$F|Z{4}ouTd{h9E#AWWB057&`(S);2w#rY5B&t6%#QZn9qre$CHQ0{7<9tN z&p8@<)bRp8{DKd?Ash1H6P@rgil6IX$o&J%_A2kr+^xnCRiO@iBrk%Kb$wnSOV1cN z2`|`7L7XF|yLWKEYJUaiEaiuq&3aie!MlM7rZ7hRWQ#tD$64|CZCbo$iIXw{Z_WVR z!5SUAsd6@@d-kdLJpYtmXn+GOE}9H@okzQW4c`GDgT+BnfmtM9J(WV_Gt{=^@FQn5 z5%H5mXWmOyK88&7Gw*3qrlo4rDYVazx+dhPM+rIV0WyRM43x5L3a!ncmdOp%sJC~h z>>u#?>8{#}-q%S6c4%|2{=Fqf=ed7OAtfCVR(3lOBoJx-y{zkrrk;%Ymb*G6%Ex=T zI`cB#S2-H*N(VASFIyL^CkayaXGJasw}sc#sDdkAT)#!x{g7(Y2R{}ql9c*QN~}q+ zu(e30Fg=Du^cETE<~NOSd33DPg0^CjO1wyn?DdL;>x*nAbZX(8T|aH=8OOiZoZEnB zKOyPpvy}OJzd$aD9dd9iIr0b+U(O%_JzPsukVHCl=Ka)^2+^5dO-foSh9dv?RfCMo z3q77sTXN`;?hCSFvVWN()}9dQ!1AGaU{%X*!reL+ZWAt$r>NlepYWq6vLL@)f>G4# z$vCM3aR#U5HYG1s!8P54PEvHU^(SbfBw009B`L~WpEXexrFX6{uGUC?Q7h*%BF5^+F8FcMmTMI;~3cz z9_MyIR((;#7#(MKKrs226J2}?Q!_cFvmZHMt3?7%Rg=8xht1Gd*IRTOQl&#`HaYfI zH=|F7qq)9347n;6-#OmlKK5Gv%87Qqn+lSXRt0j9BkuA`4o;S!H(-1VTHHnEJxd-w%iO7i=Ki*j*Vl+yc2OYC(vRUAxLQ z9w&usk#cEti;#0!Z@m{UL06rBFyY`1y%mRC%U6su@^nEBKv&fJv|&6f-j?{x&a*)@ z(yPNpA+PULZA}eBAouZ-1#$H>OW$v$Iv1B(L%-3E|kzSCMSpD(pZ=PFe)UUg-O%8wM!<=zV&gW3MWGq z+Rn3q{FwV0T@f|43m3X^g9wP_6Sy5AzQk|{mK?j*uTTs99mCeAzE4Kz%wITG=#`{C zRw4H;wW%>Wb}xtozp-P-MG0wlnSN?wP;efs2c{@;t#L>s&?yM_=pO{x*3sAUvx2mI z&aEcR1ZFUTdK~Yuo4|0)4kKH&(xKKq!ITF(o{!ye)*@MDKt3S42ERv-3gi`EyPALb zZjgn(vt~s1-J@l<=-I9Dy4lHTT4dsJTZ1pi-7zGWcuRaF62IOFlS2S2*DYLt`^j^W z=NIHlFy_;X&ps_(l}2W$(0`Fz1DoFWx2v${`3wELF9P#9^BW5#(J}jSkx(6kG)wd~ zE;9D{m>p^@A(nQ(JurM+>OQ|3e7WBM2pbqPa;Un79Hv)m*&4`)NxU?Iv%2$FgR`!Z zupY z^d-0T67QR<*OLv|>zCaBg?|GZKT}i~uz-z>bq#{A*L`|bNROZ%NTuzgnWZPmtx-7! zTo0AYO|fuEmeDempCu>Vw%pD|S-2S6b|W{{!i}>yO`!#@R|_nh*1|YKDRC4x^)xZ@nPKQ~xL}Q44SQr_WIv#0Yokx!OUD@Z0}>nv9PX$)jNi!ljR4BJo#ix>xbl%xrXMGxm@ga^9zI?l269>?9C^0 z4a+AxyTzMN<{FYu_Cu0SW*MGO_WqXR?B-r}%LR7pLEhcQE9&kR^Z8^;FZN;;#PSc+ z^M|&lKC~UE=MUZ%>Nz5nUk`ddTB^S}=((IPj3kcKK~iE!q(CswAHRyqH}|ERV4lBs zYnbOdkVJw%z=KvvMqr*7*WV2De1{M7oT3s6>w$XCXk}!Krt&JqW1deVD&@gEPvpP8 zKIS>oNdg`tG0$;>#c<4X<~5X*-ZJL-ZY6xQn_-^sSTF?h{ORvD=DGX!G0&e8gms&k z=Z`1>$aWLV^BsUv@L`@W`Tk>`L-n1vhkDLbZ3o>bc=MsOLzC z*;}EYI>x?uoxkU9x+4Fx=R zze40M09K8JO}}m*z77m8K;M8vIqyGVn>Jr8b@}P}a};I;AEPHj`T!;vL83C?EB?^Y zi+Ns$2;DcrJhypqrvQh1oQmg@m`~#ULIWe5jbFxzzOGb<17fF z3y9}9GUTy5V8yjxK>?Ej1#6d%~Uxj1;26*S7)r%oXl48i^03gf6Bc5Y>N|qG} zHOY(2=CNJ^;CWq?0C;ZDkln2Z@EkdQiOBH_?-f`X4tUPwUJs|#2o;IsG3Nev@y_c) zzjJu!Q8&Un{{bV6)3=3p-lzD^;hmGIkMo}EVHI5m@4WwS1n>N1XHSRIQ&l<61#f8t z-ub|G9pGIEo_Xruw-3iV|LkwTJO7gWZYRGJyz`6OiF416#5><%`Ihm{Wm{YxymQx3 zyz@N70~Dds3W3@XmitNI?S+-g%Ovssjo%2~`9xc}$1iW)(o#BrM^8DXCkmp&>Zw7fzHe|ro`ajI`{}s%0u@o+X5A&Ro^8OjT zPpg1>4!_%zE5_%jVx{MOG{K!1fqGt7%cGu?{B4WJGaAIC_IXCQc*6&KeuMi*TpoV{ zH6Y(M?)jurmjcAWKl*yy^STW@S~&OtK_1w1FXmaV*E<>tUwd6gFV};I=>a`QPKXh0 zhl8FYC*;PMXFl9>>&`pHJ&&~UoG{;i-1Fimzt6bmb-(%{XXEH zyJcka`Tp(Wp8xm;S6W?n-os`Lxo>N&XUA+90)s0aWg&ROzS=VYh?C$l8WJ0Oecbb6 zz=IFLJ--Wf=*%GQId;fp*t=aH`21FJGD+SYjMo1$?s?zTp}6NmkurHacm6&xonUlH z_Ee}3_8htPp8Ldv6q`^1GhFY<&G`r5o<|Pigk#nFZsDFk2>>YEWr9@@L!5m}sOJ%w z*u(BJ8N4$C?0q%d;nOn@^yhWs9mth}>V9*~^WQnYMa=Ut-y6*HXtK!y=J`70V+_GO z-vP|?HMEPzJdfClM_gQ;mh(gznR1N%w}N>t=1u+g0`q*(*54-PIc)tfbK||D;JUWn z;m&a<6!ZLhZR?8(KKOU#jtd_1oV$OU5Axg~TxsxV zskgkH+yP^~Ddaganj>EYPyay7b0pjPE?q)Rh-X3fogv%|^PE{Z=s$Td&kgvBtTnzn z4ZbPnx!Z?%j{l>88zM=mbU(R})Snk3VHl+5RxIRV?>^aU6VY!L3 zefNfC`+rVD|{tx!!{#P;2-w*a-o-^MN^SsTAd7cf0x<$x~cg7 zzZ1ah4~8L=W7Lq#ekXY69-8}pM0&OM4D0ny@Xo#cjpO_47y%mot>B$|UID<|x(GxQ zc|iH?U%@+%*>byh=cHfYok#wFknUbHg7iDbJNM8_K$XW5oj~t~$A+Pk8-aIzW%KRg zos)h|Zc}6sPp@%Uk9vZ49{06)=Tch0J6GVm!iRY7UMK1*cl6jCo-@sT#FFIy&Y%4g zQ0s1pcrN3y!;#nS%W(_su2cMdb*KSFID;UnIH3V3?jYXz$D-T9JNL-4Pr~yYc_X~@ z6L*4l?&&*n;4&HiyS{>VzF{-LJD)1jlY3-oLpH@$Z1%tc-xTkh@!+X@`~Q;f{|gbM zVgxLCiODzw^t^kCUBEoA6KUCPw}pA`?f>)3`5!%o&S5}@W1goVNdkXRM=%7O7yCTE zEWt<+e(RqWaGXh37`{(0=V$#IJ;A(a#+e94@9fPy_W3^aaVyy8q@U!2ksn>oKl%&w zqenn10!t`XI$)pAy;JOS4|VTf&Ic4W&nGEr`Nr7iLbsTvk$=66X_{X%51m6iKJ4?+ zn{OBUoODU1=&8&3d;d*;6YTScDQnTUg?&z5O7csOLq2n$1bm6kHsEi6L+o=wKE=l_ z=U>i&SZ;`Y9zm4Mb;BDhWH2JDY(otNh$Y7SwaeuAJb9*%WTX4M`Nd78v8YnoW?UfR z@2waCey%VQTzpbZ!ynl3_~(R9*zvl9;6L36{`naOM0w*-{By>OfBxHV5&v8eQRF`8 z`%jQ~3{Ji!{Bxn>x)(0zCnsYfLHswvKd;0bzs1WQy!hvy!F~2}{9&M`@^l{pL_Um zfuCq}fROzG^_$f!|>n&ea{N`D*Q4-kq-3CsgyG9%!UBtAA)KgSaL9^rm8?} z^Hb+#7aVLD^XO^WG3FD+CDn}X^QMd0Hp}_*{mr)Q0gK7m-~8;QQ6|&H^XD&q^gpIG zo##e11)Mq4|DotyfYaH3=KRHTqVv}}O=l858aRI@0S{6G0j9N@@=-HRzxG^<&F}5U zNg|Un&3@!cRiY$QkIEIBU+~Fm)++-DhxU#CqOwMs`>N)i`zx`X(#w*hR37eQG z&D1m4Gt3tUyRR9p475l+*w!qnoK;4x-x4lB&q)e%bZlgPuqaGnc2{Ben(PZg7mQn= zSdcv5-p*`((iW@=rb1GvlG<|hg7H8c{A>SwyGmZp%+EQ&h*UwD;)K~%*%SSfatv_j zfn${^o}ZKO?~bBr{)rnNV4rtb*of-XSb0LLqr0j0`6{->;Vkhl(k<7sQ4_@7L55Fh zy;%I?*{i}+BA4f~QGgIsQW>cQIbAuGJ=v8cL(jaN=+)atjckM}Fku^djEZH@HpK8( zn%&}vl}`{u87_25{NL529MYV|_2_-~f6=tKXj0wgdB2yWR#s)F`R6oNWpB{vcZpC9 zFERL283B_;xjS^plOCR}cWP{@**iL^&=jh%cFv9<*DHaPBE^)lF56i|zO1ix?$DSE zheH^$sniC?>xIeL~k%*Xi8OC3E+9p;~s&$ARQ z;<-w59{>I0j-JOI=0oJOFPkw}cnZ%v%s&%Y*%MId;uvHhA}i9ojJ*0pGTq3T(}uNs zkVr-~MkR4hUthqbDgMZA-_Es^(M@ zrNhDLxgbVFsie7FP)2}?iJ#P|oS0-@P+Pj4i8mFM*Df$m<|;p@GR!Jza$2TY$N3lb zAc=H-t&LNOO(jsqq6M{%9(mOnChpuFHsl)|cQTLBKJKaykEch%c zatsqd*}9@K{8VEdpG6gnF^mGjb>?UF_e^`@-B~hs05nHh_}P3;74*9j^=}uvo02}; zs-l*DsTvJk>q`2}@$NFeun0zmR!jR;Oy*~W?=F*uMHo3A`USVfy}L|4OK#x;3ha2{ z7?lC4ZyR&IBmg(ljj_0c%AP;pJ_gmryZSTiP0|dBsxNc5D(JBnU`tXa`Uk%^sURmK zHJ7`m0740_AMM|F1mq?C!RHgWan>`AODB7I&=suKI{;KM79NBFg|_gFZ!oeMR; zyAeXQv!NDN9UnibDfOis)ubGe!%F;J*}R~`(vxFaa^c0wkYEh*j0J? zpI>cEZO<_s)>OQyG5;6o#yy&X2qKEIi-PMU=FQdFMUzY=t%sSD!FVrTnf(xJet>jC zUc-G*t&#)uURLaXm^mIL(jO9;e?)$aU#`i{VON#p-+yiOIP$1@EO|&-Ox~(aoBXaD zR)w1?Ymu013Dt*FkF!#>lzoQZi6VZ25G@B^`W$Tx+rIP<*~c6{}j*Dv5!1Z8TzkG zF@&4*P<8cZ%4ykYt-(*I4oi+lh-%X|?p{)j7hJ##p7gxn0z3BDU8nChA0_`T*zMv1 z+qlu~IgP36Jo8iJyIBhJFUj9zGLiw&ABs00AYUk-KF9_hXGiNZAa6*~yorCkViC`9 zZS2O~>nqLAlP87e%{(suVu92@+WZ=MRv>`9s4HY+ z&(oFWgXCKxTKAg+Afi2}Q37)JlW#LTqg41pkJAbMjz|_8jwh@-K+jP~f4w_KOX>BdVuJ%;sUw{ha3~i!%68 zbH&R0mx!tKd-|D2MHEl{hZ}nGE6sM{%`fFxPYhr$5uD53lbKqWlOd}7Q&0h?dT-8l z+MP`$d{`BKe{1z6XO##mD?$zmIb>F1m7$_J)!H58+s;IH=5hm zO_d2_csTWB&McXEDk0{??|#G_q^QH@lk0})FhyuEtH^&Lohuvg_d!;EoW+`MUP!(b z^qWXbIo?zweFkNaPz$&z8_2p(Bxr;LgHP$jFaz*l z7_F$QYD15-(ws_Y>DsWNXTt{1RN&WQ;dS|!&s*=o+B*5O;Bcm(>uh9*ksYJkF)=x< zJ3k{}%Dj|mos)a!*IFS!TaPj^F-96cxs#Dl)jfLFzv7k7qiIP!dJebR&##>&JCRQP zs-#mT$z@SfEKkWZW!Y5f7P_#u++6om|11R-anf1FXGK3xD9YYeX%l6HA=M$g5`?;wcqwx)8fb9UESUx5xy+`7f3qywSnw1 z%?Y{G&Z_E@vflnnhxoKi^)qlj6J2&F8W;Di>^~c-#tMyH(JZl%4OrS=lowyf73_8s zwThpnspf3Erv$4V>H=d1<=_@cR1)h7%Jx}z0VWgy)~gR5mGZo%$W2I%T#C11z)~L3 z?8yt&>ZJN>i)C;I2$6Yj?SZ+ zj#0#|C(GtRE~GEH{~#OE-i0=;yEJ&_?d0~2IFfsx1+9G3~A0XoDn@nU?z1uRKQs-3^cRm(1 zN;M{X&g?~!hYK-A66{=M$DPzcCz%}+@Cx^519&Cm4tDA|o|nFbgqO3Sp&x%FJ2wXQ z(YE`s>OdHmdx&val0muss43(^mANwIZ!9vZD&#acNv9YIHARkT21b^=I$)PkWn(|@ zAUm<}{>>$;SCj@ZgqO(h{tgB@pzTKw3pimy*0KFMmLWJ&5!&ep1VyRCVH*ACRj8wf89yNG!BVleQu%!%PRQBdkgR*PvURzC3w?|}tt^XuP*bhh zU%u|e4P~)oy5_F$IZ$b4h>GD6-LpqOQ6@PoZD{m9lLw%-`7Lq zzZTbp^FHZVbEU-t&5v(nnBwPLv^< zAG9hhQxyE-wd(My7iqVaa*by6J51>-X_Ukih});NPVX$3ot;;ay-oUXp?U*$X$u_{ zdB1L0n9xCj7V{n5p@zGt_GyS>xH#IJWQXRojb>aspK|W=cR5W!8g$KOs#&tR%zl+$ z)Jq*(6y2BGr@@pLJ5+}FnkMB^`dAC(;m<$KIZ3O%~Of4 zRkIo4hs70Xotfbo(KX#i#6>GQ%cJwpT`(LO(2r(j(wYc@u>~fhWA725UJ!4S;(8)r zv*C6$fWhESA>Y+#x-S36jN`O1l6*Z)pxvA)eLr;obFRs+DYLuT!fsX_jFt1<;LDkG zY$47I5H!ZUN8f>a#5RHAqetrA#XVw%_8Zel)!h7SdHZd_lQ;VW)Lbd^d2$! zM%;*W3-^d!*Ze0_lbdK^w@?)V-t_X+^W-0D4IhDT)< z;T|!0oA(|u`_OB|s>{7dCBNFEDJJ+XzZd_r-6J-I2<&$65pze%fU|d#d&H`T+#}Yv zn8$dj!4*Q#v2W)dv6?%&M-0a({5@hdo_oYzbgHKx7AOixqQa7?kped&DAtD%>MhZSdVAR*gc<|JUBT zz%_Mci^C@;A%t+W5RmfnPI539sCGiM6?{yAS_Expkhb_}ol!ItJDq!NYpb2wX--f$ z0ql^d2#B4W)Ksui1+Aj3GXX300Sb!RTAfwV*WBJabHD%nf4|R` zoOAYGd+oK>UVH8LUjGaIh}Hf}{D|ov_W2R3E_u)IN30sUiKYK?KVob8E++P0z>n7~ z-_aKt*=tR%8LuMchOQ|tibQQsv1<` zU*$*a-(lY*>~s9D_z{~0Eihb$4TqcGdvSt`$t0K0oPx`+;oRLnO~1I_MpGT?U>(dP%|hP%DNUZaGs`h23D{C~}tn4b6&t5#}nEDpaPp?`u0IM4N8 zDT|-&OAL$%T!9bw^boHlk}3JmJ&C!ah$k`V+<~Zlj>P^0uVDYxEmyFU`@Itb_j}(^ zPM{H_oDB5Le~lk8{BZqu{D^r! z|KCIZ&+;So*-du&CO=}{qr}HW)<;-B{-^wiwcgr%qS^Qve#AEUJzNBVAtQdoN{Xox zzaOy*ti|9*Z1q3sN37;%KVtrdjrb9}Nq{#w`b6I}I|IIHvPwaY{{w!+{>8p&O8#@- zG+T%tvHxYhY0wR8A)NP@?B*HCZbB=AE-UWPe`+B9DzdaU>i0kIo2LDC&MNx)D|d2N zakDS6tO@@6Vb1*Lu1r@GUP^rT!~6qZl71&mee~Sm$_1KFU;l~t(SxQ8n)&~N-wi9w za1dW&D*M08m)M_)FR|(pE!ZKzUocA=y8NH^C02WbFR_|Rn6Dtd#QxCdORV-aGKm3W znv$pfNnc{GO2+vA_az37tU)FHo&0~~OYHQ2!-ej)ZCAW{@qZxa5;A-eb zr`xyh=k}{lK3_xsVtf5Fe2G2r{}Eqezm{y=jrRKgv@bC#V?Q|CKxbm@_raDZ`+HS4 zI1^L;LuX>R^tr~IL8|uueZIun%m455C6eLWiGgRR8-{=Xsnad+6?h+v@g!ej z%8~y)Ut)vr>`M#|hNJ(j%v=0#Nt6Zb)(!oVf`Eyg>GLH9y_)|TUp@z~FrEeHXam3y z!nhoriGdd(>{R??Ut(dTuK!=`ORUwvBmssIz-S?IE`4W4Y^i}?8Ut$GIq00kTK*JRWj@$bZ%YLon z6GPiyQ?C_z@fP8l1QInSR8`I^J%*{(AoQ6bC``Px%o;bl^u!uLXR=`r`xl zjX;#+4t~Vq3UB8|Y?V6>TwNIo2w4F)VkOC7?0jy-N{05i5z7jP&4#x)5d*(m5^nGz zhQtMYh80?e2AGtkMcS~3UKE!q|y@L-ia3FTt8ce*0wFjfAgyTFu-(joVN}w-- zy~TH!VT~2sY3abF8}S{6e#6jzSZ2HGP3vH=y@0~A*CI*K4F1Qi3_4Ac#!%hVJhDl`s&c~ugU&IY@H~9^#M!#WWF5{9HiUvHQVFK@Y^c$8HM8RpOiXUzi zoBrH2lWrCGM}t#Mi_U2i71{@v4Oies2FWRy(s8+D*=0~ayW|t>`}+@5(?KnDQgY1)rs+ywH8MbbtH+h z{@&=%!g0?pS5~*dsR-|@;Fo%EFPuZ#VtUs7m#U_bOLb{W*;#OCJDHtD`QguwkVv|B zDL8U;FCjE>G38}eiVxqy2H6Ld!v;7eq^!Z7ycF^il9#R=J+M1zX>0P*X2B>VEp=!7 zfN-G_oW*AGXeq0K;)X1>Se?}>_~Ku(Smx*RSK!r^6zyzWgAhs47VDbQ+GPP6hnrVa zHH9wKg%KK^i~7^3k!TD;8qF^g8n-++%!g+Rf_TpX;tBfU!=5E7)?%V0fc93b$_f$x;>u@7B5DehuN8ZjzR#IGo*Z;6`yx z^N9=3_o2KNRy9>u=vGT4|D`|4Yb25#L|(s@6LOO(LHs*IJ2 zMQ4EbN*={yv--J*k7}ziMbQf?a>$tGR}m}J*qj@AHqWhUdZI!%Q=;Xa{dwD{v1gU z#`^XBo>g2%AFI4|>q4dZn`P}Vju76rdDev+N4GJTN3~=c7iR#o^?7zpS!Hz?ciPq` zjl6!+;Pc=dkLL|pN=TV8HOwj1m^_9?gsea}D$J>?fM}uz_k!S?qAGN863r+2)0`;L z97f9LSHAKY=r14bs>u-*xvVpfln?*7?pvGI5azLlqaHl29de(A)ix^JDXZL{EQ6rz zC0ozaLM5`JO>VoXzWt`E=|Z{gN;$E85A>%&DbetKIo7xPB)NT8F4^O|S8+#e0W)~W zRsv%hCuM1{*nccXLwKef4dJEo)=TBhLWb}~x&G`~G=zI>euMdad2OxmcLMf(dFyus z>_oZyI|BAMAJ{fb^Ijm$DNNH%(tK9l`YB1%Rc`*8q-pkn)u2-5fR`G0)=b*M4)hm~ zy}^dX;G?sL(D_$_>|l9oCm_odc9gqM6J&o0|LbO5lFKG)2tppZ4lwUU;Mff9?l!LI7>uWEX& zT(?Xro1Fe-(@;+ADvxEOkC)1(R4N<&^;<U)emFGczn5U`5!)=C2QV!5}6fKBy*k+OL_kj8>(o+fE5<*mge&D?T#H>6SOCK1W^ zXL`|PW2(_;LTj1^oO_jo^ZPTXWeOlA5ztnRj!*v ze4$tRu2M=jMKF0CA_Ikdj{^|V=A)s$MUODl&y$Q$ST^+6t&5}L}HShtd- z^S)6Fr@WFeEw5q*bjsm$g3B;c|7A_oI_6|vI5(txI!|H->=@uO+-Lrxh8tEsed^R8 z;BD#)@H6dMzY1c=v$?r1d^1RTn|j~z7g8e2jo2OnYDB<}G{03tTEwQDGLVFOm*`zp zn?Bt$WkiVceUE3S1(mqXNu?;uq47$UGngvjKK;p><5!x-mBH@(<6??fb|X&xn>DNu zJh(UIGDd)1hXVvKjFR$OL-Hf>C~s_|?lljrYWluRcfJhm!kWYVWjjz3(U)atug|X_ z`!cyxWm0>Q@1ou6s-{oNbf?Ndwrh^`ldV`rl=kB?XpehIIzxeEjo>UcmS=EP)4?*` zQ7O+)`sewBl(Yl$)PF1GnX;=41Yk;_@^{i^c~#T^xOdCsCBe$&)K z3mlUz^cQE#CREit5%l+1Eo|-GnX@V95W_UL#v?@iGWUd+xP* z(NrT5wF8JUpIni#Op1lGv~!ex)FhDP-&#Al9P=;GQ_!)sW*I+d!y8b}z4rTo^ zZ${13pn@PnRMq#);I^Qa=3S}vE6n%QB*xMu+eGLZx?5@|&qWjn*20^gE}Cm*lm!p@ z=-FG_zCnb#deJn1`yDESfsSG+Q^5nIjm`kqlV#A~&Y*@FhPKcpNfcKs0Xb=kb-`f} zCUbD_Fz5*C9^?o2vQ7)Uoh=>Q8;?N?AV_xxzNDXL0h3OJVJ7^!3=ymVD0Bu)x(1Q4 zgL@ywlzTAIS{wX)=ts60zn;gR9!$6fPN(R83mDlq_Q2bd@WyB)3`i2zMBPUKh;~S# zT~Be3-+}f>B!JM~=Fcu0N!$is(oZJRj`(zPj6nJ%+JD5i8)&aZsD(f%azaG21U?A* zx}EWk!M$~FFfRBlj`z`tv{JgaAz6P8fNpEs$t|e^QCIWnsCASsp9jmTdkhI!3DCsG z24K985}3hd2$PF2OZ_kzF=e1H)wQ5GSHu}=^QmRy;0%)clxSRst!)GBLpT2WQDLsHMOlK4Vei%NUeTm1)2T>(cV6#b-zlkvP^7-U zy#l&UFc`dUBf6}wtmUrRh=u`DE1PIc#oSE=iGbb(YlKA4bQf$8m`V%hZTh9Px^p%- zf25>%x>O#K@jZ-Tynm_XHT5h^oB>PawJa;or>_fN+RU%l>VC}=e3ZZa5k9kd`C9HX z8#W$baYH4DZS_?hg)QhfG))^~Tq0DMvY&-0w(uQs) zy z@2Nj6v2~Z&+TQr2X^G98w%SM4t3XwY0gChov2OIIuh_a@0T6G~D>n0})j&PSkcp2Q zu|t0Gd0N>i7MdOs7TB5=*tW(-c)t@Xj(s}M*8MD`_`YeLO+RwA@SLsbIfzWqe=Dw! z{dBIadoDy?Xqsy?n^v;|8Gn!mDxLpNDks5gb3b3Dn}a0^?QP0ze1XPF_?=DvVineb z3@YPE8yHsovsK&^1gt19*yW~RK$;48eI9_Z+!rrPdDO-xP}T&QleI7rYfUmnzP)Ap z2niQlSOPt!jbpSM%d~aT-m4;)W2;tyz{Uh^t-fpJc1EaJ(p0{Ld(hUP+7|7XKlgwQ zhPN(*%xTj`wcKU?QJh&WbDqvPc}BbONCuZ`Yct4Z*2#F4r6dC`4DqyQz}+QGOzE#= zOo*q`Q(5OZp*kHClpn%GeHhw0%+|ncBW)kzZ%VS&hqlBW`B<^;3=@A8k}%spI@VFe z(Cb`G^w7~VMzwv@_SE5O!Mvnt&Ju1gp$zs7!q_X$_N97Hti|eKVoQNfb>%XTGtDzx zrHq7nbIb$iM$^y-s{GpH+3z_W&vr1!Puz?(cS+N4mTVqINIWH%GN?;$i(upZJ6iZ#gtDFvu|7rZRW@LX+X11Xft14EtRqUy6ALR zovh1f4X<3btFl_FE#Bo!usS!nw2;SJ;m$X-Mm8KSoMIwYqMod)U+2>kHyY^Sq59t~ zbH3qWqSua~p;xi7*<&g9=-%ZUXd5(sXrJ>BQRbMltTT#znqoJAbP_c|iJA8*jBH$l^LEBf%U;Xbr}k=_3V=FZx(ZdO2A?@1QN7< zy`=l}VyFS=FD;&jxQ)r-PS)deIlGd>lL!KRcz+t8e9WD7L>Ar->Dlb0pkXs#7tvTl zJZIH)qBSUzk{cAn z?6N=^a8BOgDbdEwz%)L2G)3`36z@HQRx&@ChMxDg)m#J=|M4;jU$2(Z4dkH!_1}o3 zjr28?fXh8@MU$F8tKv6)t#uyLwyJm-!3R?dR2pJfJC_V_vSHDY^KRPHo z0-JpWQ^viDWWeYe(Tum+H9KJUGZUzeHH~uamxTG|!M$lT z@)Tbn{bAdTd;(2YmMT;Y5l)xt#TxP+3Noglci``CoGf*RV_ysV9zHtj4jSmXg9vB7 zt15AOGz=N^HK3glB)5L~V6S_A?@teOeVhKkdHCD#*T%n(|1SLj$k%>FWK{JbrL|*A z9ihTy(VTGBD$uaMZ8x15KahzN&Wqjz83dImVVKHBHk}o>#t#&FMKg<`N*Pv@q>$k% zA5GlUC1qComeSH~6S#LuhZ-W`x6CRuFJ4z~so&&urodrIisF8~1m;VG#>LKhixlkI zn{IWAYf}e#l`9jkL{Kodr9H1Da|Spf_5TrFb~z)te?uNodvcQf`opa%lP*?%`@a!WO{IC)h^&^RdclTcCSpmCJ1b4d$P>SQOTYIL)aE2D$#&y=pL4rZdQnTRc( z*|%x0i|Zx@tFmTd2l@C&e;ye#N_mCN0aZ>$QT%dvTW;E^eT1G8L6__n5z3{Ln}@Ar zp@pSLhY-l{)hT{)U!Cgsq5C(bt+}O7zAXHv6feSS?lnO_dJ`H3{WVe2J7Hp}{<9S& zAyhTZ%S+)Hmd4=}S4JzUBUV-qtY_=iHSY}L{(^*7TuEJ)X7Ur6YRcbqRTzzl5os}8 z66d`{aHeGjU;y5)M}|`Dok!Ecy`}o&E4U%}*-_*@1p^hZqIphA7+Pxn`-=Pv6bzA} zQ*8db=sia+c?;B!{8Lo-FG^c~QQGY65aLR`?p{MCsX@Ry9IJ)yG9>#E+Ruu0z}|4U zm<#5lB&$Q@gXzOdTfwu-(An{P^^2y zJ8vbb9gAZd=zwEJMK)DZBV^c`l!rqd4mDySC=Yi`j8JbG#r`5T?fd+~$HK`rR^4jW^&9rw)U1_s= zG&{5<2+C1Er4C1s1c&<)a0vC{NmZ%it}$yCwQ1Ld@#;zI+V6!tw3d;~p3-f!atLKV zR#M4J7YgimSWxU*VoRmdl;vG6iT23HE*38dTy0wwOASQoWW=5Wrdbc8wf^j3~6 zrq~3yuJs6uD{wY)qaE<&q9ehMl*SHmRt`x_8gwyDS@#j#&_Pj&X;BQHm=lS0WN8R8 z<9?`)!OJnMPKBk|+Q!P^y22AOONU4QooFC~DzwW^u~A;C$+SA>S=g||w)kPHp{c>| zX$qT@l%Z7O!FUj)X2@9h2?5LIZaM>9Q_8*ZOcv%z>EAx1gq*N0{i=>p`^I9>Y+|!= zMRab58|pe0jdJg4qPajnqh70lD>>Zj&ba1K&2p-3r_AION5wG*-^ZIeu8N(g{;oMP zmVxUNMRt6ot3x(QGZ4zf{e+B{m6h2>X2~e1>g*gjtEM2F9X}{;op%~U4p&3;cqo4k z26DMmjl3x*WBOD8X$`T1`H#a{%mG`5$QW9yozKn+E1Vr! zr(xT>_=2fcgM&$9BDKqlv!0_aZ9QTgUz-Hria0!F(JiBV5S@U77KXlos2X(3_b zWpI|iy0z{jt4>qL!?i1QX)Ue0n;K<^?=z8!+qljM^C8rtD_zHo^(nyAv2}=kvNeqY|FpVbqamd8ceg5L{zvB}M4%7NJ1la5#ePh2kW|i-hhGO&~p8gll$4r;@p+ zF<45VfAI_iGGjVbl1jXAW(O^m|AI5jLTH63rbwwGLxw+4`ll(l$cjnJ>VS5Ii2=1` zk{GxOFl)Ey>z{B43E8<}5Y*PiJL=gYE8Lf4vgwfCLTHolSwta4!4$8q-p%gL4W3K0 z1`7C45}kn={DQWPElQ}lv?Tw1V#P#E7Y%bym~sZD_s+#%_go35o;w5b0eceVl0ly| zYA=;K5xj?(E6y~^+kX_dYHm1OB^ai)R!`70T9`PA`x^WohT<3ebE^R z)l2Oi!JG2j65YHdR=FZ7RpCk?S*L?dxjG#>tcMWwaP@k;NlFgs%o*bGiCNeW3*cKo z@O>wGAE#Ue@W0I8=IEYW()8pKD;bqpGZo$x5#E^?r>z*id~FK%C=y$d2948w{&BZ; zr)LWrT)z;rdzkXT8lEb&VMoYtbtMzQo}pILTOHqZT;ZoeN2MaQQ4R!x6&wq_d*C1V z%1f3()sB07T5MjM(-xHWP^LM^{Rq`y_D-a@v?cbmC0277ys&L28(wgj!>wiwwB^&! zK&Rqi%AF(08d`G}@FYW7%aUT>P%dW=oJC!eLZBn89z zvl?wRYY5V6XC_T$cN+oO?-An!$~>NwT^kMR9XCA?INQ#?-Sh zb^cc};Qn|lGtsT5Qhr+8`qSd3pBAU7z2Ar@)l?Q7fcLd8+@-~k$XY;oRe^GZ02oxm zulFJuS|c4eQ^IIQ#l|?))UbMnE{(a1GZsTmkI+oCGrKrlJD-$Ca{}nB4CbIZ~BU;i87Z{VGg6Xw-&dqU)L>bQx7wGwY4=cO9S%_yt*a2;`dwMQ%tIdJ9<-9qj!JcP>!ytQGr@E z7syPY$FpUPGAKY&?`BacrGPsOahuPH3~ynd|A}3svRK0e%VI-B-4E4t>9&MPE`tWp zQDx0(aRzlwsEyu+6WD2LOe%wURX}E`@uX@l+CFaoQAB>(wwYj%+BqnNaq8o+Bmn#X z_2bkX$h|uPri^C7s8i03LJ)T6%)z~WL*h0O<{Jne?stn_ZO&@L+HG-sYMHHcdt??g zQGQVGFNwatDRNICn!&w*8&sL_26L&oiy;d%r(Pvk^Q0k2!&a(cBwYLaH1`)w(J+J` z(vfW&X^R}(Yl}=$0aP?lLYkm~U{aCRq%**eFmADa03wEWsLt*FJanl(oih0K=SYA3 z@zs}|0bMysV_EB6tDvmm#jGTs!YT|54e(`Vi3n=oJ_^WBr(F!jk8F=3dhER}!iBO7FV6Z-Mh(^Tp|1qP4B-2Lsc3vDlGJdH!ZGeAs=ynEAI$V`R)gFk$z0Xtvxl zup$Qt@%|{<)Wbu7*_Nqs_Z*o7)o>&0Nt$Yi4P}#JOJn3U**3MIp3q{h5y3b{r3M`| zFrR)>>@W=YYRB2X7sG5U;AO7V)Yf&xY`G_h3Bh8ko_eH#imUl1ttA^2D425W5%a%< zZB~jJwQIN0`-?MJaD^e*I=Rn^HB)`%s5@1B1OMD7XwbkmncoS>6#^t#>l*`Mx3f(l zXa#SuO&m-~$e<(Bte3$AX3gY18Ro0vQg!v@-5Klm&JD?lshTZgbz!3mXBK#vrx?x5 z=a#*c1~=tKKu_ruqZ+zwJflfU!|UTImo98=RRmZtKxCbzsF@5SCA^OG_*eBTTsUV? z+hjH2hUcyYe~T?Y3^}3nmSSI=%1OfB1(fxKDkKC=kJl1*Wf_{Z?sEp9nHo zeTn+)X6|9UqnZpu-3?;Lv3eH3)SU`L0l_W-!d>Z^vtTDFT`)`TA2D)q77!}0f*-ge z@Py*qplixb`NKcCTI1cnyuzrg8NY|9(6V+oo4~flmpKlGP;H$TnSWzKhKG3WUDn)r zZsY6AR?>7~XE=#xLYs52kq+gLdllcfo5t;Rie=GR{~osjK-Nlch}6AFuARfpK{p9lX$vH7e74|Qf*v4PHaDTS%U z-ecDvQ5UKQcIOwj<`*{$*MY(J}>ZE4q*#w;o zp(-ZEv1ng?^}?!ogw;H(HFyHw54$vvtcKh0*S3U|CB^Y99c`WVFrmw;!MH^~u5Af| zSu=+!8tXUEU_B_asuGRH`Rf;2HI)wMtEJmi%xqJ^L~L8Fnm?C0;$VdLI@~^Q&HJ-8 zuaYby+Z+WGmEiOM(wj0o)r;(m{a(-^te2-_oapQaS?88##q(UOW(b3`jaH-69?5#e(=tKqwlFmQnY8CAyc+R9epptvj@|9PI&T?HCDd;dV3W!xsfJCq(GLHzYKA=BIBQ z!o-;9S}HD`su3gsfF3aFiwWw+ki-Z%(!qo*;w|IDc(^Yl!m0{O&$fmx**hLIX5xrA z{&>`j`~Xl%m?G9D8QBM^I9L$NgWHtf&7H2zoo38?klMI$$ni0mbl$`fnRM;NAu&vB z==k*7Wnh$h*M;}ifTIS~J(5#QD4(yo>ep#2om)?LRfjt=A8l5LIh?hfYD(ZJUPQYLG;IV_879G$37dximP|t96FGsW!S`fT zjVgyT>_r=6X^I@WO0hN~IBs1Wk82Zw^$(cxfihQEGjV~rU%vkQ{q!JD6;qk9JJ8l* zWItFkS=;X$+Zd|>tp&jP%GNmEvlJSOiua9h2X~=oW|1{L@!)hI6w>kRk!;FhFvC2w z2AVp88^Tg$4m#Aj!D2Mdfn^5RWn;<=9o%cmBOsVR&sIf~<>`KT`{^~%2AIkNrXY@* zC)ojQvB$Dl_hxiLJzc1tI>}M5DO5jD4wEW{>aqJA^`=5~8VoW*`I3v!kwswe)?v6S zF*T?#dPo*Duymn{oy6iJ4j+jsoTSFKE$|1Vp+gVI6Xj~t*svrBKmPB1*7&wWdcdL| zp;FeUCh?(c$xr_Ny&sl;ZhdOqR7SO0l|@t9dS|`bS)+~P-%R}hi#?=rS=h>D!K87d zrP+VT&j70%7S==ZjxQ=T-DP#&4YTQN+ZPv~gF$lu?nxeQ!370C`Q7OqF8PrGxBiu9 zg43YcVv^%JAPN}LcD03j+B^=NXX%Y&L#<9sWIW#kv&xUy}IdsS|JlP;iQV@NcMa8RZIsgdbi+002^fcMD@M$T~ z+ryE%A)G1F@?pb+3X6g;1yNs=M|z@%naf0LZN*acxIxE(?Z7v`UX^}+Bt~hz(QZ)LiiIKFee?U!(@aL1QnKV8}L;TF(&v2Lp^XVwK+L5+k!PXBpfeJ1N144v{gg+hSWQfMw zMgfUzSVf+Z^^~!JvahErV)a9=6FtCp^C;=vv{RnB;VSqfVIrB3r6I<}#oC-@mhsw^ zk#xzgsCs&3EbZ1_&(@6EJitIlxdy_r!HDaqPp-DG>bynQnE{Us$cm=g_9|faezUMa zc=9Os$zc@kcB(mv3jR8*Go)GADC8gIKEhyc3(~hQtm2u<4o_JJRt^Sc;YPhjgSerI zgX{Uf7)!(EfUPRk2N8FD%bZX@64Dq_9h2YiW0s79rS!@iZGI2b9auq!fp#(>hL5xj z_REe}Ec((?6IO#oh2@z}$`dnERckCZk4@7l#~aDL?}(`y*gLREmd5(iqGa6q>yw5A z>=?SlT=AI$|=ni+MY*P7TVPr}%>+Dp=O3 zXckTgu}8Vp$g#TtI4)fhhM|8KB9C$_G1Od7<+X)PSV4k65e6RR97H^CLd{vUD|c#G zUC@*v;oYG}TbZNH&P77dQS;}I!HOhYuMaiH{f5ZLRuq+PRx)=ZXLp1A^S^+N@TY~V zN4QrJlio#HXH%dqIf13)g>oi(-a_q5@k-Y5n*J4xze_n2$aNJBB2NU>*#O00mdv1Bxa| zp06mu*G#9f*%d0ZAK@kv`7Eb8Hj|~;)4sLhD61AHyOSyX#cNOsRy{?;SMkEUC4KdH zLTdOyklp**9dHM|xk{WNSHk`Fnu;a!9{1$!y4nu*9%P&Qm}g4MT`XX8#etCZK}5Hh zpnUxx>&~myDoLU0@o4kztF{y{xM(A+ePd=vA}Y5ntgfguabS1dk=E5jYE?(vyC1XZ z5Z>XW9J6RbMXA^juq)MS>xQe4Fe+MBnjF^s+L6}RNJ{>Qe%E7+sSU> zJof=%o??Q_7VzPJTsUErdbbYA)2|W1A4B;199{|V3&ScF%p}l=A=n4msceyfI0b<8 zLzPNUDA4De)PzwndF_hbDNtZR+-594II*B0=>H^My^qwwt+3d>zHCy~LZx3TM|j$H zqE@yMZO?UUx#^gcK(|Ak&1NUuRA+0=UtJpx{RXs4_=I+0jCIkTN9Szkk_K7g9+1`G#&NVYEyiDeQWB1&g#kGHQb@|+ zBWZwya>y8yY=9%1^7L)yaL5LlvSs}OOtQNi*|aHJ4q;MW&25+YxH9&`P)>cMbZ~go zXUa~M5ORd$dQieZkk%5}F_ounDN2TN&@c{^IWm}jC>=Cy%^1)xz)H&<83U~ucl8T9 zsFQQ&4wnud6g69B*{$6{3uh1Ow?2;eiJYNdhfk1!b;G$)sfl0JO_>65)e8bO_`O`*kcYIGnGPrhUhC zVL%e91nLwc&yrE*YockV%xJZ^U{yvPn6qT$CBc+-{e4XJT0O0@psPx`b{k=k z>b@wtcH)a3Xa0c(UIW`Uc<_*FfBA4NpVHb>I%1sg(qV{(0=^^)3l5tvh(L5b4M|g8 zI1Dm}$v6mrsY&+**v|mV1sKh`&x^vpABGY}-Gz0>0X6??sHKv9oC-$$+$oB z$s&`LnOKD|{IL6^2r8+7ofq{cIQR)mL`jFsiZhZ9myQfErjM*x4%5jnj#QzZLT4$e zo@U$VOy``HBXyZO&u7E&9oOD#`pcj&z4h{xsKaYFg^W|gIWnEIhi={^L?3n^!yF~u zis1$wmMo5U&W{zbR64dGDkZGmka)}2a?4T$G*d38%+j#T`^b-#5H6F!a!ixzFzg=S zE*%1$&QKiAR8aYILIuTPZ;yyGogazgk}2 z-kxm51kJC7uX@b;QFwson;v(kXl#-TU-#%cF>JqRY?cdWdf+q@d_mkMxp2D2ybr#- z9inlwT==ZVycfUriNd}f?;hWxov*%e-ycM!fHU?_9V)f;df$+_oRoRuk9H51ybBH< z@rPh45#DVfN)ZGFdTjh!ZXBo3Z=v$bX#G;ky_RBLX4K}l@e%87q?j>`TEB{FYVTpx z?&XxXf^wHr-UC1yF>7Cm-1Z(g3Q-1gT5-mfW!^7E^Ba`#UJov>{7q!p$i(MxnZw(D z(R%^UNI{>K7T)RMR49F5MELa%wb0zdDeya`smJ)MLD~_rlN-Y~HfI>$)i&?DCamw_ zt{sF}z4E7uE8hm6P<96GPzd!s+$9Y4^X~4kyfz5B7gAEoyIRlJau4)X0l{B-xNi{D zefOpOKT^`NWW*)+$4HM*(*vt3u+#k=QCQjI-YkM4LjS1gU(3@UQM5U=P0M>wTYiu9 znb^qF#UX!?&3qJ2ft`mi!J?@n#HLG*zsMNc-U-npvu^vNPT_S^X7Q=eHD@5U*9`g#(t^F}-olHpT zaW5Ca?(3^Cv3HpW%k3c~Phm)p*CFOVN`VE0ZUL-+d%wSk&H6ra?vKsjzCKjCBz-Kb zC*e94Z2CaouQkGim|&Pch3S)p-y|+HIGvAyKdz4FjFl0&&InLkqdg*5Abb5`?Md1T zN!n}QHb|_W*OcD|!O2FfHHsd{&b(2ow^~btai*M!G>+G%&qQ1RYkV$!aPQc#3lE6m zFDzp4Nu(_WPQzTq7R-@AX|>CtZ@!U*g$XnQ>}<+wykvdj48A8&&Uz1bPINk#TdZNZ z>%uM4xi%~XUY?%5+)*#<9S=Jf!z_z2u?-`#<+|q&g1-}ZO_Em}CLz%E^aa5FcA(`+ ziJq$zl`a>9!Rk~~)KmjO!BnMO24!`$b{D z2*Y$P>I*z11cC{L9~=jHAheRza=TIbN!S?It90rw?Cqj4-fX10Z+5ox`}{q zyb)Y@n}ouzlq~^Q32%|mR}bAlqH9Adpk~VYQ>YRINQ#x3@KGPay)IgSyDQz?YCle& zbZfG!SSsTXFB|W3SE{_C&k(r(l&CJM0UeY zNDWP@a7olAAwg^r1=U1%R%~VJR@2-`!VdgO%0$co^<>o52fD)KGpPvq%=a^>ndw~@ z9>BVNMdaoADpj3^TX1^ODMX+O5ZQEIv~Iw0kmDXo_yMuv`|m0EWs|9 zYMAPN03fVR3*;+&fwT}kHh>=g%@62qy=ebbs2|Pd&;0WHT(m!o$)H?5?()l+3B^-cKZr~y^i0pyq)oQnI&$)Er^-Qy#Fgpd5(5#cw;iA(SS z4D$hKZv^Pa9~X_FysGL9r5l8=26}CQw3y;sB=PBNEJmh+|LB93Vp2&%{H$;!9dHwQ z5NxTo@&!wc3|2b;{AP9s5P<6WT3EcjEr3$OFyDDA07nr5RCckua@j4&Q&o0r*UjPf z3uqRgyiRvp)`f9D1eD%Sxx~>Y-N2FXO}A6JO(|rpm2OY*9RPwwh73;^bY6Qeq%1~8^{ zLQ3zK7Z|is{gygXc0;)N%!OMM?8F48FIe9eErG1O-T>grAL#bxz;ULO78FUgoLk#% zSxkyi?iU94L>J0KW#0$_#;6-g55nKNL-?C_2p8@UUI*c~E5Ma^2!Hw3f+hAoHAJZB zcD_N1B%qAQLWocb;h06k4dE*L{M(b{fPHH>vCI{spnz-lft#bG@c#&)TKimJ6#$~L zRl0@)zV4=~L_wuICP`d38bXoQzUfch??@i>Gnai;iuRWUWkR%IV?+i-eOgHL`pGU3?p$?d{bI<{Mz zK*ZGFRHmwQg9G8D&CD3w4a;WT@!hS1yN7)(#CPknAI*>vQ7h836^^#+Of(bphoH)$ z;`AlUo>E0{SGs`ZYE_;<OBv5kP558!ZFM3)ae@=;L!M+7`6Z;lvtO@sb z`TB`qs>*)8t8xX>enZWHgqOP@p|SFF>ehsldoW)<2qp>=*`Z7v6EY)2`$REpsR^xj zt}32li`}aEg?0CJCd2|?A%j~_bd@Nn)?-~t*#F=9Q5USk!}G(gEEznh)+1fQ@%_+( zGXt>o{_}oly~n9%sP)fK9kDK_fjiRWtZ!R;U#xrSrPiJhIF)i8WM1_uk*@f-+&21-4sV<$NPe*() zd6k3^EtD-RJzZfL9}cUafH^0qP;>VqKJ@TCHHd8#wR+4nNl`b#pRH~^B7pr1Lo)(% z-1^^9;IA2Gd|y}7lrYy#1D)d0_hdJ2=_yIa#2{iS7wxn>dZny0kJbj07^Buys?3Z-XQH0Zr z+*DF7Fb54RJWg1690}o7mx{i@?jG{Y&G6Coc&#?l!^$chw*VMa z&%6YO{NSp}t`Xt4G4%%3q8f-#PmjdG`|{hQw~y)aO-@G5?6=HR#2l`$<n0RIq ze#YbHL1!)Vu;)E321H{3ItrKKBYmG8(q|ZcBGHf!?3s%?MYTC$udBQ<6wbP1I0v%^ zpv)@!M+ZO%@Y+Ya6fOharEov*K*|^<+55S_e+YPC8&s4gShowAt)_86BvsXbk=1RK zqPV65Fo=3MFutq%%&&ea?+{7J*$uDaZH3q{p-rJuHu%Dw7T60&!pA0a?{^ZuboCgS zN&~`TjO%Nfbjy7iuD}efZmQpC5p}H=qoE#T9Y7=MkljYJs#TJSDAWY80+j{2OG6#g zm19a9?GlD@Z%9-CK3xfhf=#%05UFRd5kE0Dw&IV8$?6g`i4@QScO}{32l2q`Yvh%b z{{liw2=}K0Q2tu2!pO>etcF0xowG@~KpD=0%ed1gM9@k-HLCyZEaUP0 z=?|d*a+L9FCTKE-EuNrJ#V?-V7>aXk%t)pnDTN6d9yCn(N>COnFQC@5q8f%Ggw zP7pJin}+lwSq~st!AO=~341yNRK>Ty5(LYa{j;oOww46{L!v5~4-PtaGVe(=IeaTeRmbl^2HAgoYXxeKd4i2)LmEQ%$47XetVHBMy)) z$YeA~(!rU6p`-8C*0xo08F0p{l5Z<@q+1MHtCMP1<4J1GAebd7)x=m~%cmn54jo3j zgp(+-9DGYh>?ADRCU1zSNk|&u-$2%vN6IO*DX{0Pd{AOETale;m;xt0Q^K));F=+$ z5sviB+~-7NSsN?>WyMkgbHIJi1*bDIs!X03n~|9Oh&l37Yw!VBdI&zic{_l4@5|Tq z5tmwN45JTlCo#NJ1=-K5GD)P!?B{U&|-^aIqW@ypuRg3 zgq(^A%Kv8Fg5NP$g^p?u26n9@IH8Q06LCYV$yNA|;Av=Ei1g1Ls%rg-R= zz!&uCiuY?rgy~G3+62r%B8208k&8&=%l#vPM)xPMs;$2un#)A@>u3-m%<9Z7)j(-N z5$doAH3@F?|1ttt8DXw6DY5`i2QY5q`I* z?N9E9706t2EFJ>-@lF7$)ts;&#KX;iKGIFXS-s!=B`)Nap4VG|K%md%RC!Cz3zHEw zod4k-B1s?Wl#;?^liwuUOArJaIgq`tVe&@_6EO<%EhdR8J8sF>vL9AJNq*)|G38eX zj*2&CP*gEAKr-*AqJDu`7(wgHVF3c~6N2ONTkbK`o6ILsj)f6-n_m;X^F=ty+sw*f zPT$4K^t_=AFj*apUm4kIx69AChK9Hu|sRH0=za`9>-F2x-my?)Y_>L!jW^KM&kvT z+tC_lf|?l5rNapWt=6v1i2zu(?H5Lq$Cw=vrlqtw@+enu@F~^Zr(%Yl8m&yAOnZ8B z00Mz1 zh8_U-{tbZErx*4Ou*PiprBmwA5%6)T;1b+QjK?KR;YOCjds1>DjB@!fI=~UbVnXVE z9X0ET&fL@TN2rDJv`nK`o|b3S$GV}d-*>I7iNM)+}g;HMeWL!0{oh4jv% zI`PB*qobCpkao}~I9Qk0+FLZJpuKk~RU(7Y(+p+72fYiU7BrvBgovPpgXSt;iY(GE zyl?K1mqxg0%UDl^@v;s9?3CCOtJo}^Fl*DtQQ)2foe;p>tp5IoGtZs-J^?dzM_ zXLoXM-5A8J#cy7fzxz6LOyCvncgur*SRYb8CHTxHY}=pMCvdB=J;RV*LyGUxXJ8LD zvaH0kP0WLquU#P$h6qiI!Ptd)Hu%@DbMdA`WQ~p5G_g#v_&Ak!f zISHY(Z5YePxWob`0q!Bm`VCo}JS&z=q^Pl%r@)<$EcikZx!)p&8t6m%w$<6EVnE+e z%09M}%avdP1@tg}6KTVN#sL)7{Jw&F1Z=3~Bp)tJ>V%t!S|@d`9XqglVkf*bJ3kdB zc6zh&NFtjet_C)kKN8AZUfHrMZm`-l^jX_*e zfR=v+HyU^m;@ngH~DC$OE~ zu{YAkOiBBI33_u7-M)!zxbn*sbX8?b!NuL7jhFlK>>PTFAJy)LUxN*o&4@1 z-*!4I7oasiJG?rxviMZl5-6VbOj0~Y#rCmKCqOlR6!Z7OM)_Y%sh`RT9hPNb+!btR z>}NYbiq^SMElL=Q`@W;hhBE)IV_kjIcO7fTgm?eY(fUJ2v$Ik7wgb%=jxN<~nSt3KkA0uL02num32oZ?yCqvAu$CuY3%u5*o zQOIkHa1itI8g9yKO4=SK$lkb*^B`^*4F?qHUBZQdlInqew+M1BY3);9(y4<FR68+#D2-`>K9+vHL;M0qyS-kl=nMzno3(B9kuvb!nk)fhl@7di$W zQnXO_b#Hc{)c+>#Yl2`nU4KQHngX})!UR|n7^Yq=CH*hdb(nXEDe?Psg!VhJL- z5)1&_kzap3#nFLVg|>^(;lb<;l)6F+%5~XD@boUb&_7VSm1ZkEu?=o^^AqFs}pljvRkl`1g*M%rpKrdCvCbxs~KO^VU4`G0!w#o{x6G-lXHxg~=T)qajayGv-<5 z&r`}0o0C}&Bie<^$>P4;DcC8Uru1|9Y!*fp1y8Qsn_Cz*d3;B1J_>JIaPngk$gI&F zMNw0>(Cz<5O&-;;@S%Bmr*fxwrfiP%ZH6#)xc5M|QBNx|KR6w1+^L1Tf`nlmpltc; z6uEOe^9tMMrZCEOB`A7Z#=N6iV~11wjzvi5@a_`7+5X4J;|k#{A)iuu|0fWi+v9=w z-TtFHxk!uUWy}jk?MxXDGAaa+Qr+!Z$u=fx9r_1{W?I zV`iw2j~>Rrj<{gBo(FF2c{;8z{e_GL_xEt27)^Hi0`URdJLpdN2?cj;A4q~%+3AkT z`Y<@R(5|DnA2AF@^w;;@eg^AD2uA_-HKM|Im<04Fla%QX`)=;Ul342o9C>j2_d$a^ z25#kmqj`v?uMciNy^s4GF~QXewbaowwDKv+egp%~ga{w+bH0t`+SjL-!jC~XqGj#g@4AI(`}<&QByzG|r0kpV6)>#_OoZ;h z8ieq+4--u=HQ#~>65=im!v1SWR_N{67u-HH3PfXdzU!A_dp@*56BZ7z3;Vb_A3?#? z7e#m3U*E@7O93zdqA2^SecW>C+b;%t34R0Ff4Y@y3r1n>--G1>05=VJ`jb5q$$q&% z*;y%+{Xcxj=iee-?lDYoJXOj(HV_YkXP|Qyrb7cU)kjr-qcj~OVLas%SmqrCX8(;Z z`)RlGmV;5i+iJqwgj;yCPu|B7n0{KEy3hTrSfTd!$bitkf3JVA^grHfy#LidwXdOn bTrl~CA20g gesetzt, verhindert den Autostart bei leerer Waage - - Tarieren der Waage bei jedem Start bis +-20g. Sonst Warnung - 2020-07 Andreas Holzhammer | Version 0.2.4 - - SCALE_READS auf 2 setzen? ca. 100ms schneller als 3, schwankt aber um +-1g - - Reihenfolge der Boot-Meldungen optimiert, damit nur relevante Warnungen ausgegeben werden - - Autokorrektur implementiert - - LOGO! und Umlaute (Anregung von Johannes Kuder) - - Stop-Taste verlässt Setup-Untermenüs (Anregung von Johannes Kuder) - - Preferences nur bei Änderung speichern - 2020-07 Andreas Holzhammer | Version 0.2.5 - - Anzeige der vorherigen Werte im Setup - - Kulanzwert für Autokorrektur einstellbar - - Setup aufgeräumt, minimaler Servowinkel einstellbar - 2020-07 Andreas Holzhammer | Version 0.2.6 - - Kalibrierung der Waage verbessert; Messewerte runden; Waage "aufheizen" vor Bootscreen - - Aktiver Piezo-Buzzer (Idee von Johannes Kuder) - 2020-07 Johannes Kuder | Version 0.2.7 - - Zählwerk für abgefüllte Gläser und Gewicht (nur im Automatikbetrieb) - 2020-07 Jeremias Bruker | Version 0.2.8 - - "GlasTyp" in allen Menüs und Automatikmodus integriert - - 5 Gläser können vom User im Menüpunkt "Fuellmenge" in Gewicht und GlasTyp konfiguriert werden - und werden nichtflüchtig gespeichert. So kann sich jeder User seine eigenen üblichen 5 Gläser anlegen - - Stabilisierung des Waagenwerts nach Wunsch (define FEHLERKORREKTUR_WAAGE) - - das Kalibriergewicht kann beim Kalibrierungsvorgang vom User verändert - werden (nicht jeder hat 500g als Eichgewicht) und wird nichtflüchtig gespeichert - - rotierendes Hauptmenü - - Umkehrbarer Servo für linksseitige Quetschhähne :-) - 2020-10 Andreas Holzhammer | Version 0.2.8.1 - - Bugfix: Servo konnte im Manuellen Modus unter Minimum bewegt werden - - Glastoleranz über Variable steuerbar auf +-20g angepasst - 2020-12 Andreas Holzhammer | Version 0.2.9.1 - - Fortschrittsanzeige eingebaut - - angepasst an ESP32Servo aus dem Bibliotheksverwalter - 2021-01 Andreas Motl | Version 0.2.9.1 - - PlatformIO-Support an neue Servo-Bibliothek angepasst - 2021-02 Andreas Holzhammer | Version 0.2.10 - - Korrektur zwischen -90 und +20 anpassbar - - Autokorrektur auch ohne Autostart - - Preferences Flash-schonender implementiert - 2021-07 Andreas Holzhammer | Version 0.2.11 - - Credits-Seite - - Fix für Rotary mit Schrittweite > 1 - 2021-11 Andreas Holzhammer | Version 0.2.12 - - Glastoleranz einstellbar - - Komfortverstellung für Füllmengen (1g/5g/25g Schritte) - 2023-01 Clemens Gruber | Version 0.2.13 - - pin-Anpassungen für Hardware-Version V3 des Heltec "WiFi Kit 32 V3" mit wieder mal geändertem pin-Layout - - default HARDWARE_LEVEL ist nun 3 / Heltec V3 - - Anpassungen für den ESP32 Arduino core Version ≥ 2.x - - Display, U8g2: HW statt SW im constructor (ggf. Probleme mit älteren Heltec-Versionen) - - Rotary: de-bouncing code im isr2 auskommentiert, da sie zu Abstürzen führte - - - This code is in the public domain. - - Hinweise zur Hardware - --------------------- - - bei allen digitalen Eingängen sind interne pull downs aktiviert, keine externen-Widerstände nötig! -*/ - -#include -#include -#include /* aus dem Bibliotheksverwalter */ -#include /* aus dem Bibliotheksverwalter: "HX711 Arduino Library" by Bogdan Necula, Andreas Motl */ -#include /* aus dem Bibliotheksverwalter */ -#include /* aus dem BSP von expressif, wird verfügbar wenn das richtige Board ausgewählt ist */ - -// -// Hier den Code auf die verwendete Hardware einstellen -// -#define HARDWARE_LEVEL 3 // 1 = originales Layout mit Schalter auf Pin 19/22/21 - // 2 = Layout für Heltec V2 mit Schalter auf Pin 23/19/22 - // 3 = Layout für Heltec V3 mit komplett anderer Pinbelegung -#define SERVO_ERWEITERT // definieren, falls die Hardware mit dem alten Programmcode mit Poti aufgebaut wurde oder der Servo zu wenig fährt - // Sonst bleibt der Servo in Stop-Position einige Grad offen! Nach dem Update erst prüfen! -#define ROTARY_SCALE 2 // in welchen Schritten springt unser Rotary Encoder. - // Beispiele: KY-040 = 2, HW-040 = 1, für Poti-Betrieb auf 1 setzen -#define USE_ROTARY // Rotary benutzen -#define USE_ROTARY_SW // Taster des Rotary benutzen -//#define USE_POTI // Poti benutzen -> ACHTUNG, im Normalfall auch USE_ROTARY_SW deaktivieren! -//#define FEHLERKORREKTUR_WAAGE // falls Gewichtssprünge auftreten, können diese hier abgefangen werden - // Achtung, kann den Wägeprozess verlangsamen. Vorher Hardware prüfen. -//#define QUETSCHHAHN_LINKS // Servo invertieren, falls der Quetschhahn von links geöffnet wird. Mindestens ein Exemplar bekannt -// -// Ende Benutzereinstellungen! -// - -// -// Ab hier nur verstellen wenn Du genau weisst, was Du tust! -// -//#define isDebug 4 // serielle debug-Ausgabe aktivieren. Mit > 3 wird jeder Messdurchlauf ausgegeben - // mit 4 zusätzlich u.a. Durchlaufzeiten - // mit 5 zusätzlich rotary debug-Infos - // ACHTUNG: zu viel Serieller Output kann einen ISR-Watchdog Reset auslösen! -//#define POTISCALE // Poti simuliert eine Wägezelle, nur für Testbetrieb! -#define MAXIMALGEWICHT 1000 // Maximales Gewicht - -// Ansteuerung der Waage -#define SCALE_READS 2 // Parameter für hx711 Library. Messwert wird aus der Anzahl gemittelt -#define SCALE_GETUNITS(n) (waage_vorhanden ? round(scale.get_units(n)) : simulate_scale(n) ) - -// Ansteuerung Servo -#ifdef QUETSCHHAHN_LINKS -#define SERVO_WRITE(n) servo.write(180-n) -#else -#define SERVO_WRITE(n) servo.write(n) -#endif - -// Rotary Encoder Taster zieht Pegel auf Low, Start/Stop auf High! -#ifdef USE_ROTARY_SW -#define SELECT_SW outputSW -#define SELECT_PEGEL LOW -#else -#define SELECT_SW button_start_pin -#define SELECT_PEGEL HIGH -#endif - -// Betriebsmodi -#define MODE_SETUP 0 -#define MODE_AUTOMATIK 1 -#define MODE_HANDBETRIEB 2 - -// Buzzer Sounds -#define BUZZER_SHORT 1 -#define BUZZER_LONG 2 -#define BUZZER_SUCCESS 3 -#define BUZZER_ERROR 4 - -// ** Definition der pins -// ---------------------- - -// Heltec Version 3 -// -#if HARDWARE_LEVEL == 3 -// OLED fuer Heltec WiFi Kit 32 (ESP32 onboard OLED) -//U8G2_SSD1306_128X64_NONAME_F_SW_I2C u8g2(U8G2_R0, /* clock=*/ 15, /* data=*/ 4, /* reset=*/ 16); -// für den ESP32 Arduino core Version ≥ 2.x brauchen wir HW I2C, mit SW I2C läuft der code zu langsam -U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ 21, /* clock=*/ 18, /* data=*/ 17); - -// Rotary Encoder -const int outputA = 47; // Clk -const int outputB = 48; // DT -const int outputSW = 26; - -// Servo -const int servo_pin = 33; - -// 3x Schalter Ein 1 - Aus - Ein 2 -const int switch_betrieb_pin = 40; -const int switch_vcc_pin = 41; // <- Vcc -const int switch_setup_pin = 42; -const int vext_ctrl_pin = 36; // Vext control pin - -// Taster -const int button_start_vcc_pin = 7; // <- Vcc -const int button_start_pin = 6; -const int button_stop_vcc_pin = 5; // <- Vcc -const int button_stop_pin = 4; - -// Poti -//const int poti_pin = 39; - -// Wägezelle-IC -const int hx711_sck_pin = 38; -const int hx711_dt_pin = 39; - -// Buzzer - aktiver Piezo -static int buzzer_pin = 2; - - -#elif HARDWARE_LEVEL == 2 -// -// Heltec Version 2 - -// OLED fuer Heltec WiFi Kit 32 (ESP32 onboard OLED) -//U8G2_SSD1306_128X64_NONAME_F_SW_I2C u8g2(U8G2_R0, /* clock=*/ 15, /* data=*/ 4, /* reset=*/ 16); -// für den ESP32 Arduino core Version ≥ 2.x brauchen wir HW I2C, mit SW I2C läuft der code zu langsam -U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ 16, /* clock=*/ 15, /* data=*/ 4); - -// Rotary Encoder -const int outputA = 33; -const int outputB = 26; -const int outputSW = 32; - -// Servo -const int servo_pin = 2; - -// 3x Schalter Ein 1 - Aus - Ein 2 -const int switch_betrieb_pin = 23; -const int switch_vcc_pin = 19; // <- Vcc -const int switch_setup_pin = 22; -const int vext_ctrl_pin = 21; // Vext control pin - -// Taster -const int button_start_vcc_pin = 13; // <- Vcc -const int button_start_pin = 12; -const int button_stop_vcc_pin = 14; // <- Vcc -const int button_stop_pin = 27; - -// Poti -const int poti_pin = 39; - -// Wägezelle-IC -const int hx711_sck_pin = 17; -const int hx711_dt_pin = 5; - -// Buzzer - aktiver Piezo -static int buzzer_pin = 25; - - -#elif HARDWARE_LEVEL == 1 -// -// Heltec Version 1 - -// OLED fuer Heltec WiFi Kit 32 (ESP32 onboard OLED) -U8G2_SSD1306_128X64_NONAME_F_SW_I2C u8g2(U8G2_R0, /* clock=*/ 15, /* data=*/ 4, /* reset=*/ 16); -//U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ 16, /* clock=*/ 15, /* data=*/ 4); // HW I2C crashed den Code - -// Rotary Encoder -const int outputA = 33; -const int outputB = 26; -const int outputSW = 32; - -// Servo -const int servo_pin = 2; - -// 3x Schalter Ein 1 - Aus - Ein 2 -const int switch_betrieb_pin = 19; -const int switch_vcc_pin = 22; // <- Vcc -const int switch_setup_pin = 21; - -// Taster -const int button_start_vcc_pin = 13; // <- Vcc -const int button_start_pin = 12; -const int button_stop_vcc_pin = 14; // <- Vcc -const int button_stop_pin = 27; - -// Poti -const int poti_pin = 39; - -// Wägezelle-IC -const int hx711_sck_pin = 17; -const int hx711_dt_pin = 5; - -// Buzzer - aktiver Piezo -static int buzzer_pin = 25; -#else -#error Hardware Level nicht definiert! Korrektes #define setzen! -#endif - - -Servo servo; -HX711 scale; -Preferences preferences; - -// Datenstrukturen für Rotary Encoder -struct rotary { - int Value; - int Minimum; - int Maximum; - int Step; -}; -#define SW_WINKEL 0 -#define SW_KORREKTUR 1 -#define SW_MENU 2 -struct rotary rotaries[3]; // Werden in setup() initialisiert -int rotary_select = SW_WINKEL; -static boolean rotating = false; // debounce management für Rotary Encoder - -// Füllmengen für 5 verschiedene Gläser -struct glas { - int Gewicht; - int GlasTyp; //JB - int Tara; - int TripCount; //Kud - int Count; //Kud -}; -const char *GlasTypArray[3] = { "DIB", "TOF", "DEE"};//DIB = DeutscherImkerBund-Glas DEE= DeepTwist-Glas TOF= TwistOff-Glas //JB -struct glas glaeser[5] = { - { 125, 0, -9999, 0, 0 }, - { 250, 1, -9999, 0, 0 }, - { 250, 2, -9999, 0, 0 }, - { 500, 1, -9999, 0, 0 }, - { 500, 0, -9999, 0, 0 } - }; - -// Allgemeine Variablen -int i; // allgemeine Zählvariable -int pos; // aktuelle Position des Poti bzw. Rotary -int gewicht; // aktuelles Gewicht -int tara; // Tara für das ausgewählte Glas, für Automatikmodus -int tara_glas; // Tara für das aktuelle Glas, falls Glasgewicht abweicht -long gewicht_leer; // Gewicht der leeren Waage -float faktor; // Skalierungsfaktor für Werte der Waage -int fmenge; // ausgewählte Füllmenge -int fmenge_index; // Index in gläser[] -int korrektur; // Korrekturwert für Abfüllmenge -int autostart; // Vollautomatik ein/aus -int autokorrektur; // Autokorrektur ein/aus -int kulanz_gr; // gewollte Überfüllung im Autokorrekturmodus in Gramm -int winkel; // aktueller Servo-Winkel -int winkel_hard_min = 0; // Hard-Limit für Servo -int winkel_hard_max = 180; // Hard-Limit für Servo -int winkel_min = 0; // konfigurierbar im Setup -int winkel_max = 85; // konfigurierbar im Setup -int winkel_fein = 35; // konfigurierbar im Setup -float fein_dosier_gewicht = 60; // float wegen Berechnung des Schliesswinkels -int servo_aktiv = 0; // Servo aktivieren ja/nein -int kali_gewicht = 500; // frei wählbares Gewicht zum kalibrieren -char ausgabe[30]; // Fontsize 12 = 13 Zeichen maximal in einer Zeile -int modus = -1; // Bei Modus-Wechsel den Servo auf Minimum fahren -int auto_aktiv = 0; // Für Automatikmodus - System ein/aus? -int waage_vorhanden = 0; // HX711 nicht ansprechen, wenn keine Waage angeschlossen ist, sonst Crash -long preferences_chksum; // Checksumme, damit wir nicht sinnlos Prefs schreiben -int buzzermode = 0; // 0 = aus, 1 = ein. TODO: Tastentöne als buzzermode 2? -bool gezaehlt = true; // Kud Zähl-Flag -bool setup_modern = 1; // Setup als rotierendes Menu -int glastoleranz = 20; // Gewicht für autostart darf um +-20g schwanken, insgesamt also 40g! - -// Simuliert die Dauer des Wägeprozess, wenn keine Waage angeschlossen ist. Wirkt sich auf die Blinkfrequenz im Automatikmodus aus. -long simulate_scale(int n) { - long sim_gewicht = 9500; - while (n-- >= 1) { - delay(10); // empirisch ermittelt. n=2: 10, n=3: 40, n=4: 50 - } -#ifdef POTISCALE - sim_gewicht = (map(analogRead(poti_pin), 0, 4095, 0, 700)); -#endif - return sim_gewicht; -} - -#ifdef USE_ROTARY_SW -// Rotary Taster. Der Interrupt kommt nur im Automatikmodus zum Tragen und nur wenn der Servo inaktiv ist. -// Der Taster schaltet in einen von drei Modi, in denen unterschiedliche Werte gezählt werden. -void IRAM_ATTR isr1() { - static unsigned long last_interrupt_time = 0; - unsigned long interrupt_time = millis(); - - if (interrupt_time - last_interrupt_time > 300) { // If interrupts come faster than 300ms, assume it's a bounce and ignore - if ( modus == MODE_AUTOMATIK && servo_aktiv == 0 ) { // nur im Automatik-Modus interessiert uns der Click - rotary_select = (rotary_select + 1) % 3; -#ifdef isDebug - Serial.print("Rotary Button changed to "); - Serial.println(rotary_select); -#endif - } - last_interrupt_time = interrupt_time; - } -} -#endif - -#ifdef USE_ROTARY -// Rotary Encoder. Zählt in eine von drei Datenstrukturen: -// SW_WINKEL = Einstellung des Servo-Winkels -// SW_KORREKTUR = Korrekturfaktor für Füllgewicht -// SW_MENU = Zähler für Menuauswahlen -void IRAM_ATTR isr2() { - static int aState; - static int aLastState = 2; // reale Werte sind 0 und 1 - -// auskommentiert, da vermutlich das delay in der isr-Funktion ein reset ab ESP32 Arduino core Version ≥ 2.x auslöst -// beobachten, ob damit das bouncing ein Problem wird, in rudimentären Tests konnte ich (cg) nichts negatives beobachten -// if ( rotating ) delay (1); // wait a little until the bouncing is done - - aState = digitalRead(outputA); // Reads the "current" state of the outputA - if (aState != aLastState) { - // If the outputB state is different to the outputA state, that means the encoder is rotating clockwise - if (digitalRead(outputB) != aState) { - rotaries[rotary_select].Value -= rotaries[rotary_select].Step; - } else { // counter-clockwise - rotaries[rotary_select].Value += rotaries[rotary_select].Step; - } - rotaries[rotary_select].Value = constrain( rotaries[rotary_select].Value, rotaries[rotary_select].Minimum, rotaries[rotary_select].Maximum ); - rotating = false; -#ifdef isDebug -#if isDebug >= 5 - Serial.print(" Rotary Value changed to "); - Serial.println(getRotariesValue(rotary_select)); -#endif -#endif - } - aLastState = aState; // Updates the previous state of the outputA with the current state -} -#endif - -// -// Skalierung des Rotaries für verschiedene Rotary Encoder oder Simulation über Poti -int getRotariesValue( int rotary_mode ) { -#ifdef USE_ROTARY - return ( (rotaries[rotary_mode].Value - (rotaries[rotary_mode].Value % (rotaries[rotary_mode].Step*ROTARY_SCALE) )) / ROTARY_SCALE ); -#elif defined USE_POTI - int poti_min = (rotaries[rotary_mode].Minimum / ROTARY_SCALE); - int poti_max = (rotaries[rotary_mode].Maximum / ROTARY_SCALE); - if( rotaries[rotary_mode].Step > 0 ) { - return (map(analogRead(poti_pin), 0, 4095, poti_min, poti_max)); - } else { - return (map(analogRead(poti_pin), 0, 4095, poti_max, poti_min)); - } -#else -#error Weder Rotary noch Poti aktiviert! -#endif -} -void setRotariesValue( int rotary_mode, int rotary_value ) { - rotaries[rotary_mode].Value = rotary_value * ROTARY_SCALE; -} -void initRotaries( int rotary_mode, int rotary_value, int rotary_min, int rotary_max, int rotary_step ) { - rotaries[rotary_mode].Value = rotary_value * ROTARY_SCALE; - rotaries[rotary_mode].Minimum = rotary_min * ROTARY_SCALE; - rotaries[rotary_mode].Maximum = rotary_max * ROTARY_SCALE; - rotaries[rotary_mode].Step = rotary_step; - -#ifdef isDebug - Serial.print("initRotaries..."); - Serial.print(" Rotary Mode: "); Serial.print(rotary_mode); - Serial.print(" rotary_value: "); Serial.print(rotary_value); - Serial.print(" Value: "); Serial.print(rotaries[rotary_mode].Value); - Serial.print(" Min: "); Serial.print(rotaries[rotary_mode].Minimum); - Serial.print(" Max: "); Serial.print(rotaries[rotary_mode].Maximum); - Serial.print(" Step: "); Serial.print(rotaries[rotary_mode].Step); - Serial.print(" Scale: "); Serial.println(ROTARY_SCALE); -#endif -} -// Ende Funktionen für den Rotary Encoder -// - - -void getPreferences(void) { - preferences.begin("EEPROM", false); // Parameter aus dem EEPROM lesen - - faktor = preferences.getFloat("faktor", 0.0); // falls das nicht gesetzt ist -> Waage ist nicht kalibriert - pos = preferences.getUInt("pos", 0); - gewicht_leer = preferences.getUInt("gewicht_leer", 0); - korrektur = preferences.getUInt("korrektur", 0); - autostart = preferences.getUInt("autostart", 0); - autokorrektur = preferences.getUInt("autokorrektur", 0); - kulanz_gr = preferences.getUInt("kulanz_gr", 5); - fmenge_index = preferences.getUInt("fmenge_index", 3); - winkel_min = preferences.getUInt("winkel_min", winkel_min); - winkel_max = preferences.getUInt("winkel_max", winkel_max); - winkel_fein = preferences.getUInt("winkel_fein", winkel_fein); - buzzermode = preferences.getUInt("buzzermode", buzzermode); - kali_gewicht = preferences.getUInt("kali_gewicht", kali_gewicht); //JB - setup_modern = preferences.getUInt("setup_modern", setup_modern); - glastoleranz = preferences.getUInt("glastoleranz", glastoleranz); - - preferences_chksum = faktor + pos + gewicht_leer + korrektur + autostart + autokorrektur + fmenge_index + winkel_min + winkel_max + winkel_fein + kulanz_gr + buzzermode + kali_gewicht + setup_modern + glastoleranz; - - i = 0; - int ResetGewichte[] = {125,250,250,500,500,}; - int ResetGlasTyp[] = {0,1,2,1,0,}; - while( i < 5) { - sprintf(ausgabe, "Gewicht%d", i); //JB - glaeser[i].Gewicht = preferences.getInt(ausgabe, ResetGewichte[i]); //JB - preferences_chksum += glaeser[i].Gewicht; //JB - - sprintf(ausgabe, "GlasTyp%d", i); //JB - glaeser[i].GlasTyp = preferences.getInt(ausgabe, ResetGlasTyp[i]); //JB - preferences_chksum += glaeser[i].GlasTyp; //JB - - sprintf(ausgabe, "Tara%d", i); - glaeser[i].Tara= preferences.getInt(ausgabe, -9999); - preferences_chksum += glaeser[i].Tara; - - sprintf(ausgabe, "TripCount%d", i); //Kud - glaeser[i].TripCount = preferences.getInt(ausgabe, 0);//Kud - preferences_chksum += glaeser[i].TripCount; - - sprintf(ausgabe, "Count%d", i); //Kud - glaeser[i].Count = preferences.getInt(ausgabe, 0);//Kud - preferences_chksum += glaeser[i].Count; - i++; - } - - preferences.end(); - -#ifdef isDebug - Serial.println("get Preferences:"); - Serial.print("pos = "); Serial.println(pos); - Serial.print("faktor = "); Serial.println(faktor); - Serial.print("gewicht_leer = "); Serial.println(gewicht_leer); - Serial.print("korrektur = "); Serial.println(korrektur); - Serial.print("autostart = "); Serial.println(autostart); - Serial.print("autokorrektur = ");Serial.println(autokorrektur); - Serial.print("kulanz_gr = "); Serial.println(kulanz_gr); - Serial.print("fmenge_index = "); Serial.println(fmenge_index); - Serial.print("winkel_min = "); Serial.println(winkel_min); - Serial.print("winkel_max = "); Serial.println(winkel_max); - Serial.print("winkel_fein = "); Serial.println(winkel_fein); - Serial.print("buzzermode = "); Serial.println(buzzermode); - Serial.print("kali_gewicht = "); Serial.println(kali_gewicht);//JB - Serial.print("setup_modern = "); Serial.println(setup_modern); - Serial.print("glastoleranz = "); Serial.println(glastoleranz); - - i = 0; - while( i < 5 ) { - sprintf(ausgabe, "Gewicht%d = ", i); - Serial.print(ausgabe); - Serial.println(glaeser[i].Gewicht); - - sprintf(ausgabe, "GlasTyp%d = ", i); - Serial.print(ausgabe); - Serial.println(GlasTypArray[glaeser[i].GlasTyp]); - - sprintf(ausgabe, "Tara%d = ", i); - Serial.print(ausgabe); - Serial.println(glaeser[i].Tara); - - i++; - } - Serial.print("Checksumme:"); - Serial.println(preferences_chksum); -#endif -} - -void setPreferences(void) { - long preferences_newchksum; - int winkel = getRotariesValue(SW_WINKEL); - int i; - - preferences.begin("EEPROM", false); - - // Winkel-Einstellung separat behandeln, ändert sich häufig - if ( winkel != preferences.getUInt("pos", 0) ) { - preferences.putUInt("pos", winkel); -#ifdef isDebug - Serial.print("winkel gespeichert: "); - Serial.println(winkel); -#endif - } - - // Counter separat behandeln, ändert sich häufig - for ( i=0 ; i < 5; i++ ) { - sprintf(ausgabe, "TripCount%d", i); - if ( glaeser[i].TripCount != preferences.getInt(ausgabe, 0) ) - preferences.putInt(ausgabe, glaeser[i].TripCount); - sprintf(ausgabe, "Count%d", i); - if ( glaeser[i].Count != preferences.getInt(ausgabe, 0) ) - preferences.putInt(ausgabe, glaeser[i].Count); -#ifdef isDebug - Serial.print("Counter gespeichert: Index "); - Serial.print(i); - Serial.print(" Trip "); - Serial.print(glaeser[fmenge_index].TripCount); - Serial.print(" Gesamt "); - Serial.println(glaeser[fmenge_index].Count); -#endif - } - - // Den Rest machen wir gesammelt, das ist eher statisch - preferences_newchksum = faktor + gewicht_leer + korrektur + autostart + autokorrektur + - fmenge_index + winkel_min + winkel_max + winkel_fein + kulanz_gr + - buzzermode + kali_gewicht + setup_modern + glastoleranz; - i = 0; - while( i < 5 ) { - preferences_newchksum += glaeser[i].Gewicht;//JB - preferences_newchksum += glaeser[i].GlasTyp;//JB - preferences_newchksum += glaeser[i].Tara; -// preferences_newchksum += glaeser[i].TripCount;//Kud -// preferences_newchksum += glaeser[i].Count;//Kud - i++; - } - - if( preferences_newchksum == preferences_chksum ) { -#ifdef isDebug -// Serial.println("Preferences unverändert"); -#endif - return; - } - preferences_chksum = preferences_newchksum; - -// preferences.begin("EEPROM", false); - preferences.putFloat("faktor", faktor); - preferences.putUInt("gewicht_leer", gewicht_leer); -// preferences.putUInt("pos", winkel); - preferences.putUInt("korrektur", korrektur); - preferences.putUInt("autostart", autostart); - preferences.putUInt("autokorrektur", autokorrektur); - preferences.putUInt("kulanz_gr", kulanz_gr); - preferences.putUInt("winkel_min", winkel_min); - preferences.putUInt("winkel_max", winkel_max); - preferences.putUInt("winkel_fein", winkel_fein); - preferences.putUInt("fmenge_index", fmenge_index); - preferences.putUInt("buzzermode", buzzermode); - preferences.putUInt("kali_gewicht", kali_gewicht);//JB - preferences.putUInt("setup_modern", setup_modern); - preferences.putUInt("glastoleranz", glastoleranz); - - i = 0; - while( i < 5 ) { - sprintf(ausgabe, "Gewicht%d", i); - preferences.putInt(ausgabe, glaeser[i].Gewicht); - sprintf(ausgabe, "GlasTyp%d", i); - preferences.putInt(ausgabe, glaeser[i].GlasTyp); - sprintf(ausgabe, "Tara%d", i); - preferences.putInt(ausgabe, glaeser[i].Tara); -// sprintf(ausgabe, "TripCount%d", i); -// preferences.putInt(ausgabe, glaeser[i].TripCount);//Kud -// sprintf(ausgabe, "Count%d", i); -// preferences.putInt(ausgabe, glaeser[i].Count);//Kud - i++; - } - preferences.end(); - -#ifdef isDebug - Serial.println("Set Preferences:"); - Serial.print("pos = "); Serial.println(winkel); - Serial.print("faktor = "); Serial.println(faktor); - Serial.print("gewicht_leer = "); Serial.println(gewicht_leer); - Serial.print("korrektur = "); Serial.println(korrektur); - Serial.print("autostart = "); Serial.println(autostart); - Serial.print("autokorrektur = ");Serial.println(autokorrektur); - Serial.print("kulanz_gr = "); Serial.println(kulanz_gr); - Serial.print("fmenge_index = "); Serial.println(fmenge_index); - Serial.print("winkel_min = "); Serial.println(winkel_min); - Serial.print("winkel_max = "); Serial.println(winkel_max); - Serial.print("winkel_fein = "); Serial.println(winkel_fein); - Serial.print("buzzermode = "); Serial.println(buzzermode); - Serial.print("kali_gewicht = "); Serial.println(kali_gewicht); //JB - Serial.print("setup_modern = "); Serial.println(setup_modern); - Serial.print("glastoleranz = "); Serial.println(glastoleranz); - - i = 0; - while( i < 5 ) { - sprintf(ausgabe, "Gewicht%d = ", i); - Serial.print(ausgabe); Serial.println(glaeser[i].Gewicht); - sprintf(ausgabe, "GlasTyp%d = ", i); - Serial.print(ausgabe); Serial.println(GlasTypArray[glaeser[i].GlasTyp]); - sprintf(ausgabe, "Tara%d = ", i); - Serial.print(ausgabe); Serial.println(glaeser[i].Tara); - i++; - } -#endif -} - -void setupTripCounter(void) { //Kud - int j; - i = 1; - float TripAbfuellgewicht = 0; - - while (i > 0) { //Erster Screen: Anzahl pro Glasgröße - j = 0; - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - //verlasse Screen - i = 0; - delay(250); - } - - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - while ( j < 5 ) { - u8g2.setCursor(1, 10 + (j * 13)); - sprintf(ausgabe, "%4dg%3s", glaeser[j].Gewicht, GlasTypArray[glaeser[j].GlasTyp]); - u8g2.print(ausgabe); - u8g2.setCursor(50, 10 + (j * 13)); - sprintf(ausgabe, "%5d St.", glaeser[j].TripCount); - u8g2.print(ausgabe); - j++; - } - u8g2.sendBuffer(); - delay(100); - } - - i = 1; - while (i > 0) { //Zweiter Screen: Gewicht pro Glasgröße - j = 0; - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - //verlasse Screen - i = 0; - delay(250); - } - - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - while ( j < 5 ) { - u8g2.setCursor(1, 10 + (j * 13)); - sprintf(ausgabe, "%4dg%3s", glaeser[j].Gewicht,GlasTypArray[glaeser[j].GlasTyp]); - u8g2.print(ausgabe); - u8g2.setCursor(65, 10 + (j * 13)); - // Serial.println(glaeser[j].Gewicht); - // Serial.print("\t"); - // Serial.print(glaeser[j].TripCount); - // Serial.print("\t"); - // Serial.print(glaeser[j].Gewicht * glaeser[j].TripCount / 1000.0); - // Serial.println(); - - sprintf(ausgabe, "%5.1fkg", glaeser[j].Gewicht * glaeser[j].TripCount / 1000.0); - u8g2.print(ausgabe); - j++; - } - u8g2.sendBuffer(); - delay(100); - } - - i = 1; - while (i > 0) { //Dritter Screen: Gesamtgewicht - TripAbfuellgewicht = 0; - j = 0; - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - //verlasse Screen - i = 0; - delay(250); - } - - while ( j < 5) { - TripAbfuellgewicht += glaeser[j].Gewicht * glaeser[j].TripCount / 1000.0; - j++; - } - u8g2.clearBuffer(); - u8g2.setFont(u8g2_font_courB14_tf); - u8g2.setCursor(5, 15); - u8g2.print("Summe Trip:"); - u8g2.setFont(u8g2_font_courB18_tf); - u8g2.setCursor(10, 50); - sprintf(ausgabe, "%5.1fkg", TripAbfuellgewicht); - u8g2.print(ausgabe); - u8g2.sendBuffer(); - delay(100); - } - - i = 1; - while (i > 0) { //Vierter Screen: Zurücksetzen - initRotaries(SW_MENU, 1, 0, 1, -1); - - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - pos = getRotariesValue(SW_MENU); - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - u8g2.setCursor(10, 12); u8g2.print("Reset"); - u8g2.setCursor(10, 28); u8g2.print("Abbrechen"); - - u8g2.setCursor(0, 12 + ((pos) * 16)); - u8g2.print("*"); - u8g2.sendBuffer(); - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - u8g2.setCursor(105, 12 + ((pos) * 16)); - u8g2.print("OK"); - u8g2.sendBuffer(); - if ( pos == 0) { - j = 0; - while ( j < 5 ) { - glaeser[j].TripCount = 0; - j++; - } - setPreferences(); - } - delay(1000); - i = 0; - } - } - } -} - -void setupCounter(void) { //Kud - int j; - i = 1; - float Abfuellgewicht = 0; - - while (i > 0) { //Erster Screen: Anzahl pro Glasgröße - j = 0; - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - //verlasse Screen - i = 0; - delay(250); - } - - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - while ( j < 5 ) { - u8g2.setCursor(1, 10 + (j * 13)); - sprintf(ausgabe, "%4dg%3s", glaeser[j].Gewicht,GlasTypArray[glaeser[j].GlasTyp]); - u8g2.print(ausgabe); - u8g2.setCursor(50, 10 + (j * 13)); - sprintf(ausgabe, "%5d St.", glaeser[j].Count); - u8g2.print(ausgabe); - j++; - } - u8g2.sendBuffer(); - delay(100); - } - - i = 1; - while (i > 0) { //Zweiter Screen: Gewicht pro Glasgröße - j = 0; - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - //verlasse Screen - i = 0; - delay(250); - } - - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - while ( j < 5) { - u8g2.setCursor(1, 10 + (j * 13)); - sprintf(ausgabe, "%4dg%3s", glaeser[j].Gewicht,GlasTypArray[glaeser[j].GlasTyp]); - u8g2.print(ausgabe); - u8g2.setCursor(65, 10 + (j * 13)); - // Serial.println(glaeser[j].Gewicht); - // Serial.print("\t"); - // Serial.print(glaeser[j].Count); - // Serial.print("\t"); - // Serial.print(glaeser[j].Gewicht * glaeser[j].Count / 1000.0); - // Serial.println(); - - sprintf(ausgabe, "%5.1fkg", glaeser[j].Gewicht * glaeser[j].Count / 1000.0); - u8g2.print(ausgabe); - j++; - } - u8g2.sendBuffer(); - delay(100); - } - - i = 1; - while (i > 0) { //Dritter Screen: Gesamtgewicht - Abfuellgewicht = 0; - j = 0; - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - //verlasse Screen - i = 0; - delay(250); - } - - while ( j < 5 ) { - Abfuellgewicht += glaeser[j].Gewicht * glaeser[j].Count / 1000.0; - j++; - } - u8g2.clearBuffer(); - u8g2.setFont(u8g2_font_courB14_tf); - u8g2.setCursor(1, 15); - u8g2.print("Summe:"); - u8g2.setFont(u8g2_font_courB18_tf); - u8g2.setCursor(10, 50); - sprintf(ausgabe, "%5.1fkg", Abfuellgewicht); - u8g2.print(ausgabe); - u8g2.sendBuffer(); - delay(100); - } - - i = 1; - while (i > 0) { //Vierter Screen: Zurücksetzen - initRotaries(SW_MENU, 1, 0, 1, -1); - - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - pos = getRotariesValue(SW_MENU); - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - u8g2.setCursor(10, 12); u8g2.print("Reset"); - u8g2.setCursor(10, 28); u8g2.print("Abbrechen"); - - u8g2.setCursor(0, 12 + ((pos) * 16)); - u8g2.print("*"); - u8g2.sendBuffer(); - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - u8g2.setCursor(105, 12 + ((pos) * 16)); - u8g2.print("OK"); - u8g2.sendBuffer(); - if ( pos == 0) { - j = 0; - while ( j < 5 ) { - glaeser[j].Count = 0; - glaeser[j].TripCount = 0; - j++; - } - setPreferences(); - - } - delay(1000); - i = 0; - } - } - } -} - - -void setupTara(void) { - int j; - tara = 0; - - initRotaries( SW_MENU, fmenge_index, 0, 4, -1 ); // Set Encoder to Menu Mode, four Selections, inverted count - - i = 0; - while ( i == 0 ) { - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - if ( digitalRead(SELECT_SW) == SELECT_PEGEL ) { - tara = (int(SCALE_GETUNITS(10))); - if ( tara > 20 ) { // Gläser müssen mindestens 20g haben - glaeser[getRotariesValue(SW_MENU)].Tara = tara; - } - i++; - } - - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - - j = 0; - while( j < 5 ) { - u8g2.setCursor(3, 10+(j*13)); - if ( glaeser[j].Gewicht < 1000 ) { - sprintf(ausgabe, " %3d-%3s", glaeser[j].Gewicht, GlasTypArray[glaeser[j].GlasTyp]); - } else { - sprintf(ausgabe, " %3s-%3s", "1kg", GlasTypArray[glaeser[j].GlasTyp]); - } - u8g2.print(ausgabe); - u8g2.setCursor(75, 10+(j*13)); - if ( glaeser[j].Tara > 0 ) { - sprintf(ausgabe, " %4dg", glaeser[j].Tara); - u8g2.print(ausgabe); - } else { - u8g2.print(" fehlt"); - } - j++; - } - u8g2.setCursor(0, 10+(getRotariesValue(SW_MENU)*13) ); - u8g2.print("*"); - u8g2.sendBuffer(); - } - delay(2000); -} - - -void setupCalibration(void) { - float gewicht_raw; - - u8g2.clearBuffer(); - u8g2.setFont(u8g2_font_courB12_tf); - u8g2.setCursor(0, 12); u8g2.print("Bitte Waage"); - u8g2.setCursor(0, 28); u8g2.print("leeren"); - u8g2.setCursor(0, 44); u8g2.print("und mit OK"); - u8g2.setCursor(0, 60); u8g2.print("bestätigen"); - u8g2.sendBuffer(); - - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - scale.set_scale(); - scale.tare(10); - delay(500); - i = 0; - } - } - - u8g2.setFont(u8g2_font_courB12_tf); - initRotaries( SW_MENU, kali_gewicht, 100, 9999, 1 ); - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - kali_gewicht = getRotariesValue(SW_MENU); - - int blinktime = (millis()/10) % 5; - u8g2.clearBuffer(); - u8g2.setCursor(0, 12);u8g2.print("Bitte "); - - if (blinktime < 3) { - sprintf(ausgabe, "%dg", kali_gewicht); - } else { - sprintf(ausgabe, " "); - } - u8g2.print(ausgabe); - u8g2.setCursor(0, 28); u8g2.print("aufstellen"); - u8g2.setCursor(0, 44); u8g2.print("und mit OK"); - u8g2.setCursor(0, 60); u8g2.print("bestätigen"); - u8g2.sendBuffer(); - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - u8g2.clearBuffer(); - u8g2.setCursor(0, 12);u8g2.print("Bitte "); - sprintf(ausgabe, "%dg", kali_gewicht); - u8g2.print(ausgabe); - u8g2.setCursor(0, 28); u8g2.print("aufstellen"); - u8g2.setCursor(0, 44); u8g2.print("und mit OK"); - u8g2.setCursor(0, 60); u8g2.print("bestätigen"); - u8g2.sendBuffer(); - gewicht_raw = scale.get_units(10); - faktor = gewicht_raw / kali_gewicht; - scale.set_scale(faktor); - gewicht_leer = scale.get_offset(); // Leergewicht der Waage speichern -#ifdef isDebug - Serial.print("kalibrier_gewicht = "); - Serial.println(kali_gewicht); - Serial.print("gewicht_leer = "); - Serial.println(gewicht_leer); - Serial.print("gewicht_raw = "); - Serial.println(gewicht_raw); - Serial.print(" Faktor = "); - Serial.println(faktor); -#endif - delay(1000); - i = 0; - } - } -} - -void setupKorrektur(void) { - int korrektur_alt = korrektur; - - rotary_select = SW_KORREKTUR; - - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) { - setRotariesValue(SW_KORREKTUR, korrektur_alt); - korrektur = korrektur_alt; - rotary_select = SW_MENU; - return; - } - - korrektur = getRotariesValue(SW_KORREKTUR); - u8g2.setFont(u8g2_font_courB12_tf); - u8g2.clearBuffer(); - u8g2.setCursor(10, 12); - u8g2.print("Korrektur"); - u8g2.setCursor(40, 28); - u8g2.print(korrektur); - - u8g2.setCursor(10, 48); // A.P. - u8g2.print("alter Wert"); // A.P. - u8g2.setCursor(40, 64); // A.P. - u8g2.print(korrektur_alt); // A.P. - - u8g2.sendBuffer(); - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - u8g2.setCursor(100, 28); - u8g2.print("OK"); - u8g2.sendBuffer(); - delay(1000); - i = 0; - } - } - rotary_select = SW_MENU; -} - -void setupServoWinkel(void) { - int menuitem; - int lastmin = winkel_min; - int lastfein = winkel_fein; - int lastmax = winkel_max; - int wert_alt; - bool wert_aendern = false; - bool servo_live = false; - - initRotaries(SW_MENU, 0, 0, 4, -1); - - u8g2.setFont(u8g2_font_courB10_tf); - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) { - winkel_min = lastmin; - winkel_fein = lastfein; - winkel_max = lastmax; - if ( servo_live == true ) SERVO_WRITE(winkel_min); - return; - } - - if ( wert_aendern == false ) { - menuitem = getRotariesValue(SW_MENU); - } else { - switch (menuitem) { - case 0: servo_live = getRotariesValue(SW_MENU); - break; - case 1: winkel_min = getRotariesValue(SW_MENU); - if ( servo_live == true ) SERVO_WRITE(winkel_min); - break; - case 2: winkel_fein = getRotariesValue(SW_MENU); - if ( servo_live == true ) SERVO_WRITE(winkel_fein); - break; - case 3: winkel_max = getRotariesValue(SW_MENU); - if ( servo_live == true ) SERVO_WRITE(winkel_max); - break; - } - } - - u8g2.clearBuffer(); - u8g2.setCursor(10, 23); sprintf(ausgabe,"Minimum %3d", winkel_min); u8g2.print(ausgabe); - u8g2.setCursor(10, 36); sprintf(ausgabe,"Feindos. %3d", winkel_fein); u8g2.print(ausgabe); - u8g2.setCursor(10, 49); sprintf(ausgabe,"Maximum %3d", winkel_max); u8g2.print(ausgabe); - u8g2.setCursor(10, 62); u8g2.print( "Speichern"); - - if ( wert_aendern == false ) { - u8g2.setCursor(10, 10); sprintf(ausgabe,"Livesetup %3s", (servo_live==false?"aus":"ein")); u8g2.print(ausgabe); - u8g2.setCursor( 0, 10+(menuitem*13)); u8g2.print("*"); - } else { - if ( menuitem != 0 ) { - u8g2.setCursor(10, 10); sprintf(ausgabe," vorher: %3d", wert_alt); u8g2.print(ausgabe); - } else { - u8g2.setCursor(10, 10); sprintf(ausgabe,"Livesetup %3s", (servo_live==false?"aus":"ein")); u8g2.print(ausgabe); - } - u8g2.setFont(u8g2_font_open_iconic_arrow_1x_t); - u8g2.drawGlyph(0, 10+(menuitem*13), 0x42); - u8g2.setFont(u8g2_font_courB10_tf); - } - u8g2.sendBuffer(); - - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) - && (menuitem < 4 ) - && (wert_aendern == false) ) { - - // debounce - delay(10); - while( digitalRead(SELECT_SW) == SELECT_PEGEL ) - ; - delay(10); - - switch (menuitem) { - case 0: initRotaries(SW_MENU, servo_live, 0, 1, 1); - break; - case 1: initRotaries(SW_MENU, winkel_min, winkel_hard_min, winkel_fein, 1); - wert_alt = lastmin; - break; - case 2: initRotaries(SW_MENU, winkel_fein, winkel_min, winkel_max, 1); - wert_alt = lastfein; - break; - case 3: initRotaries(SW_MENU, winkel_max, winkel_fein, winkel_hard_max, 1); - wert_alt = lastmax; - break; - } - wert_aendern = true; - } - - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) - && (menuitem < 4 ) - && (wert_aendern == true) ) { - - // debounce - delay(10); - while( digitalRead(SELECT_SW) == SELECT_PEGEL ) - ; - delay(10); - - if ( servo_live == true ) - SERVO_WRITE(winkel_min); - initRotaries(SW_MENU, menuitem, 0, 4, -1); - wert_aendern = false; - } - - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) && (menuitem == 4) ) { - u8g2.setCursor(108, 10+(menuitem*13)); - u8g2.print("OK"); - u8g2.sendBuffer(); - delay(1000); - i = 0; - } - } -} - -void setupAutomatik(void) { - int menuitem; - int lastautostart = autostart; - int lastglastoleranz = glastoleranz; - int lastautokorrektur = autokorrektur; - int lastkulanz = kulanz_gr; - bool wert_aendern = false; - - initRotaries(SW_MENU, 0, 0, 4, -1); - - u8g2.setFont(u8g2_font_courB10_tf); - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) { - autostart = lastautostart; - autokorrektur = lastautokorrektur; - kulanz_gr = lastkulanz; - glastoleranz = lastglastoleranz; - return; - } - - if ( wert_aendern == false ) { - menuitem = getRotariesValue(SW_MENU); -// if ( menuitem == 3 ) -// menuitem = 4; // Eine Zeile Abstand zu "Speichern" - } else { - switch (menuitem) { - case 0: autostart = getRotariesValue(SW_MENU); - break; - case 1: glastoleranz = getRotariesValue(SW_MENU); - break; - case 2: autokorrektur = getRotariesValue(SW_MENU); - break; - case 3: kulanz_gr = getRotariesValue(SW_MENU); - break; - } - } - - // Menu - u8g2.clearBuffer(); - u8g2.setCursor(10, 10); sprintf(ausgabe,"Autostart %3s", (autostart==0?"aus":"ein")); u8g2.print(ausgabe); - u8g2.setCursor(10, 23); sprintf(ausgabe,"Glastol. %c%2dg", 177, glastoleranz); u8g2.print(ausgabe); - u8g2.setCursor(10, 36); sprintf(ausgabe,"Autokorr. %3s", (autokorrektur==0?"aus":"ein")); u8g2.print(ausgabe); - u8g2.setCursor(10, 49); sprintf(ausgabe,"-> Kulanz %2dg", kulanz_gr); u8g2.print(ausgabe); - u8g2.setCursor(10, 62); u8g2.print( "Speichern"); - - // Positionsanzeige im Menu. "*" wenn nicht ausgewählt, Pfeil wenn ausgewählt - if ( wert_aendern == false ) { - u8g2.setCursor(0, 10+(menuitem*13)); u8g2.print("*"); - } else { - u8g2.setFont(u8g2_font_open_iconic_arrow_1x_t); - u8g2.drawGlyph(0, 10+(menuitem*13), 0x42); - u8g2.setFont(u8g2_font_courB10_tf); - } - u8g2.sendBuffer(); - - // Menupunkt zum Ändern ausgewählt - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) - && (menuitem < 4 ) - && (wert_aendern == false) ) { - - // debounce - delay(10); - while( digitalRead(SELECT_SW) == SELECT_PEGEL ) - ; - delay(10); - - switch (menuitem) { - case 0: initRotaries(SW_MENU, autostart, 0, 1, 1); - break; - case 1: initRotaries(SW_MENU, glastoleranz, 0, 99, 1); - break; - case 2: initRotaries(SW_MENU, autokorrektur, 0, 1, 1); - break; - case 3: initRotaries(SW_MENU, kulanz_gr, 0, 99, 1); - break; - } - wert_aendern = true; - } - - // Änderung im Menupunkt übernehmen - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) - && (menuitem < 4 ) - && (wert_aendern == true) ) { - - // debounce - delay(10); - while( digitalRead(SELECT_SW) == SELECT_PEGEL ) - ; - delay(10); - - initRotaries(SW_MENU, menuitem, 0, 4, -1); - wert_aendern = false; - } - - // Menu verlassen - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) && (menuitem == 4) ) { - u8g2.setCursor(108, 10+(menuitem*13)); - u8g2.print("OK"); - u8g2.sendBuffer(); - delay(1000); - i = 0; - } - } -} - -void setupFuellmenge(void) { - int j,k; - int blinktime; - initRotaries(SW_MENU, fmenge_index, 0, 4, -1); - - u8g2.setFont(u8g2_font_courB10_tf); - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - pos = getRotariesValue(SW_MENU); - u8g2.clearBuffer(); - j = 0; - while( j < 5 ) { - u8g2.setCursor(10, 10+(j*13)); - sprintf(ausgabe, "%4dg %3s", glaeser[j].Gewicht, GlasTypArray[glaeser[j].GlasTyp]); - u8g2.print(ausgabe); - j++; - } - u8g2.setCursor(0, 10+(getRotariesValue(SW_MENU)*13)); - u8g2.print("*"); - u8g2.sendBuffer(); - - if ( digitalRead(SELECT_SW) == SELECT_PEGEL ) { // Füllmenge gewählt - delay(500); - -// initRotaries(SW_MENU, glaeser[pos].Gewicht, 30, 1000, 5); - initRotaries(SW_MENU, weight2step( glaeser[pos].Gewicht) , 25, weight2step(MAXIMALGEWICHT), 1); - k = 1; - while (k > 0){ - - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - blinktime = (millis()/10) % 5; -// glaeser[pos].Gewicht = getRotariesValue(SW_MENU); - glaeser[pos].Gewicht = step2weight( getRotariesValue(SW_MENU) ); - u8g2.clearBuffer(); - - j = 0; - while( j < 5 ) { - u8g2.setCursor(10, 10+(j*13)); - if (j == pos){ - if (blinktime < 3) { - sprintf(ausgabe, "%4dg %3s", glaeser[j].Gewicht, GlasTypArray[glaeser[j].GlasTyp]); - } else { - sprintf(ausgabe, "%5s %3s"," ",GlasTypArray[glaeser[j].GlasTyp]); - } - } else { - sprintf(ausgabe, "%4dg %3s", glaeser[j].Gewicht, GlasTypArray[glaeser[j].GlasTyp]); - } - u8g2.print(ausgabe); - j++; - } - u8g2.sendBuffer(); - - if ( digitalRead(SELECT_SW) == SELECT_PEGEL ) { // Gewicht bestätigt - delay(500); - - initRotaries(SW_MENU, glaeser[pos].GlasTyp, 0, 2, 1); - while (k > 0){ - if ((digitalRead(button_stop_pin)) == HIGH) - return; - blinktime = (millis()/10) % 5; - glaeser[pos].GlasTyp = getRotariesValue(SW_MENU); - u8g2.clearBuffer(); - - j = 0; - while( j < 5 ) { - u8g2.setCursor(10, 10+(j*13)); - if (j == pos){ - if (blinktime < 3) { - sprintf(ausgabe, "%4dg %3s", glaeser[j].Gewicht, GlasTypArray[glaeser[j].GlasTyp]); - } else { - sprintf(ausgabe, "%4dg %3s",glaeser[pos].Gewicht," "); - } - } else { - sprintf(ausgabe, "%4dg %3s", glaeser[j].Gewicht, GlasTypArray[glaeser[j].GlasTyp]); - } - u8g2.print(ausgabe); - j++; - } - u8g2.sendBuffer(); - - if ( digitalRead(SELECT_SW) == SELECT_PEGEL ) { //GlasTyp bestätigt - u8g2.clearBuffer(); - j = 0; - while( j < 5 ) { - u8g2.setCursor(10, 10+(j*13)); - sprintf(ausgabe, "%4dg %3s", glaeser[j].Gewicht, GlasTypArray[glaeser[j].GlasTyp]); - u8g2.print(ausgabe); - j++; - } - - u8g2.setCursor(0, 10+(13*pos)); - u8g2.print("*"); - u8g2.sendBuffer(); - delay(1000); - k = 0; //raus - } - } - } - } - fmenge = glaeser[pos].Gewicht; - tara = glaeser[pos].Tara; - fmenge_index = pos; - i = 0; - } - } -} - -void setupParameter(void) { - int menuitem; - int lastbuzzer = buzzermode; - int lastsetup = setup_modern; - bool wert_aendern = false; - - initRotaries(SW_MENU, 0, 0, 2, -1); - - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) { - buzzermode = lastbuzzer; - setup_modern = lastsetup; - return; - } - - if ( wert_aendern == false ) { - menuitem = getRotariesValue(SW_MENU); - if ( menuitem == 2 ) - menuitem = 4; // Eine Zeile Abstand zu "Speichern" - } else { - switch (menuitem) { - case 0: buzzermode = getRotariesValue(SW_MENU); - break; - case 1: setup_modern = getRotariesValue(SW_MENU); - break; - } - } - - // Menu - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - sprintf(ausgabe,"Buzzer %3s", (buzzermode==0?"aus":"ein")); - u8g2.setCursor(10, 10); u8g2.print(ausgabe); - sprintf(ausgabe,"Menu %6s", (setup_modern==0?" Liste":"Scroll")); - u8g2.setCursor(10, 23); u8g2.print(ausgabe); - u8g2.setCursor(10, 62); u8g2.print("Speichern"); - - // Positionsanzeige im Menu. "*" wenn nicht ausgewählt, Pfeil wenn ausgewählt - if ( wert_aendern == false ) { - u8g2.setCursor(0, 10+((menuitem)*13)); u8g2.print("*"); - } else { - u8g2.setCursor(0, 10+((menuitem)*13)); u8g2.print("-"); - } - u8g2.sendBuffer(); - - // Menupunkt zum Ändern ausgewählt - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) - && (menuitem < 2 ) - && (wert_aendern == false) ) { - - // debounce - delay(10); - while( digitalRead(SELECT_SW) == SELECT_PEGEL ) - ; - delay(10); - - switch (menuitem) { - case 0: initRotaries(SW_MENU, buzzermode, 0, 1, 1); - break; - case 1: initRotaries(SW_MENU, setup_modern, 0, 1, 1); - break; - } - wert_aendern = true; - } - - // Änderung im Menupunkt übernehmen - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) - && (menuitem < 2 ) - && (wert_aendern == true) ) { - - // debounce - delay(10); - while( digitalRead(SELECT_SW) == SELECT_PEGEL ) - ; - delay(10); - - initRotaries(SW_MENU, menuitem, 0, 2, -1); - wert_aendern = false; - } - - // Menu verlassen - if ( (digitalRead(SELECT_SW) == SELECT_PEGEL) && (menuitem == 4) ) { - u8g2.setCursor(108, 10+(menuitem*13)); - u8g2.print("OK"); - u8g2.sendBuffer(); - - delay(1000); - i = 0; - } - } -} - -void setupClearPrefs(void) { - initRotaries(SW_MENU, 1, 0, 1, -1); - - i = 1; - while (i > 0) { - if ((digitalRead(button_stop_pin)) == HIGH) - return; - - pos = getRotariesValue(SW_MENU); - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - u8g2.setCursor(10, 12); u8g2.print("Löschen"); - u8g2.setCursor(10, 28); u8g2.print("Zurück!"); - - u8g2.setCursor(0, 12+((pos)*16)); - u8g2.print("*"); - u8g2.sendBuffer(); - - if ((digitalRead(SELECT_SW)) == SELECT_PEGEL) { - u8g2.setCursor(105, 12+((pos)*16)); - u8g2.print("OK"); - u8g2.sendBuffer(); - if ( pos == 0) { - preferences.begin("EEPROM", false); - preferences.clear(); - preferences.end(); - // gelöschte Werte einlesen, sonst bleiben die Variablen erhalten - getPreferences(); - } - delay(1000); - i = 0; - } - } -} - -void processSetup(void) { - if ( setup_modern == 0 ) - processSetupList(); - else - processSetupScroll(); -} - -void processSetupList(void) { - if ( modus != MODE_SETUP ) { - modus = MODE_SETUP; - winkel = winkel_min; // Hahn schliessen - servo_aktiv = 0; // Servo-Betrieb aus - SERVO_WRITE(winkel); - rotary_select = SW_MENU; - initRotaries(SW_MENU, 0, 0, 9, -1); - } - - int menuitem = getRotariesValue(SW_MENU); - - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.clearBuffer(); - if( menuitem < 5 ) { - u8g2.setCursor(10, 10); u8g2.print("Tara"); - u8g2.setCursor(10, 23); u8g2.print("Kalibrieren"); - u8g2.setCursor(10, 36); u8g2.print("Korrektur"); - u8g2.setCursor(10, 49); u8g2.print("Füllmenge"); - u8g2.setCursor(10, 62); u8g2.print("Automatik"); - u8g2.setFont(u8g2_font_open_iconic_arrow_2x_t); - u8g2.drawGlyph(112, 64, 0x40); - } else { - u8g2.setCursor(10, 10); u8g2.print("Servowinkel"); - u8g2.setCursor(10, 23); u8g2.print("Parameter"); - u8g2.setCursor(10, 36); u8g2.print("Zähler");//Kud - u8g2.setCursor(10, 49); u8g2.print("Zähler Trip");//Kud - u8g2.setCursor(10, 62); u8g2.print("Clear Prefs"); - u8g2.setFont(u8g2_font_open_iconic_arrow_2x_t); - u8g2.drawGlyph(112, 16, 0x43); - } - u8g2.setFont(u8g2_font_courB10_tf); - u8g2.setCursor(0, 10 + (((menuitem)%5) * 13)); - u8g2.print("*"); - u8g2.sendBuffer(); - - if ( digitalRead(SELECT_SW) == SELECT_PEGEL ) { - // sollte verhindern, dass ein Tastendruck gleich einen Unterpunkt wählt - delay(250); - while( digitalRead(SELECT_SW) == SELECT_PEGEL ) { - } -#ifdef isDebug - Serial.print("Setup Position: "); - Serial.println(menuitem); -#endif - - int lastpos = menuitem; - if (menuitem == 0) setupTara(); // Tara - if (menuitem == 1) setupCalibration(); // Kalibrieren - if (menuitem == 2) setupKorrektur(); // Korrektur - if (menuitem == 3) setupFuellmenge(); // Füllmenge - if (menuitem == 4) setupAutomatik(); // Autostart/Autokorrektur konfigurieren - if (menuitem == 5) setupServoWinkel(); // Servostellungen Minimum, Maximum und Feindosierung - if (menuitem == 6) setupParameter(); // Sonstige Einstellungen - if (menuitem == 7) setupCounter(); // Kud Zählwerk Trip - if (menuitem == 8) setupTripCounter(); // Kud Zählwerk - setPreferences(); - - if (menuitem == 9) setupClearPrefs(); // EEPROM löschen - initRotaries(SW_MENU, lastpos, 0, 9, -1); // Menu-Parameter könnten verstellt worden sein - } -} -void processSetupScroll(void) { - if ( modus != MODE_SETUP ) { - modus = MODE_SETUP; - winkel = winkel_min; // Hahn schliessen - servo_aktiv = 0; // Servo-Betrieb aus - SERVO_WRITE(winkel); - rotary_select = SW_MENU; - initRotaries(SW_MENU, 124, 0,255, -1); - } - int MenuepunkteAnzahl = 10; - const char *menuepunkte[] = { - " Tarawerte","Kalibrieren"," Korrektur"," Füllmenge"," Automatik"," Servoeinst."," Parameter"," Zählwerk","ZählwerkTrip","Clear Prefs" - }; - int menuitem = getRotariesValue(SW_MENU); - menuitem = menuitem % MenuepunkteAnzahl; - - u8g2.clearBuffer(); - //obere Zeile - int oberpos = menuitem-1; - if (menuitem == 0) - oberpos = (MenuepunkteAnzahl-1); - - u8g2.setFont(u8g2_font_courB08_tf); - u8g2.setCursor(30,12); - u8g2.print(menuepunkte[oberpos]); - - //untere Zeile - int unterpos = menuitem+1; - if (unterpos == MenuepunkteAnzahl) - unterpos=0; - u8g2.setCursor(30,62); - u8g2.print(menuepunkte[unterpos]); - - //Mittelzeile - u8g2.drawLine(1, 20, 120, 20); - u8g2.setFont(u8g2_font_courB12_tf); - u8g2.setCursor(6, 38); - u8g2.print(menuepunkte[menuitem]); - u8g2.drawLine(1, 47, 120, 47); - - u8g2.sendBuffer(); - int lastpos = menuitem; - - if ( digitalRead(SELECT_SW) == SELECT_PEGEL ) { - // sollte verhindern, dass ein Tastendruck gleich einen Unterpunkt wählt - delay(250); - while( digitalRead(SELECT_SW) == SELECT_PEGEL ) {} -#ifdef isDebug - Serial.print("Setup Position: "); - Serial.println(menuitem); -#endif - - int lastpos = menuitem; - if (menuitem == 0) setupTara(); // Tara - if (menuitem == 1) setupCalibration(); // Kalibrieren - if (menuitem == 2) setupKorrektur(); // Korrektur - if (menuitem == 3) setupFuellmenge(); // Füllmenge - if (menuitem == 4) setupAutomatik(); // Autostart/Autokorrektur konfigurieren - if (menuitem == 5) setupServoWinkel(); // Servostellungen Minimum, Maximum und Feindosierung - if (menuitem == 6) setupParameter(); // Sonstige Einstellungen - if (menuitem == 7) setupCounter(); // Kud Zählwerk - if (menuitem == 8) setupTripCounter(); // Kud Zählwerk Trip - setPreferences(); - - if (menuitem == 9) setupClearPrefs(); // EEPROM löschen - initRotaries(SW_MENU,lastpos, 0,255, -1); // Menu-Parameter könnten verstellt worden sein - } -} - -void processAutomatik(void) -{ - int zielgewicht; // Glas + Korrektur - long blinktime; - static int autokorrektur_gr = 0; - int erzwinge_servo_aktiv = 0; - boolean voll = false; //Kud - - static int gewicht_vorher; // Gewicht des vorher gefüllten Glases - static int sammler_num = 5; // Anzahl identischer Messungen für Nachtropfen - - if ( modus != MODE_AUTOMATIK ) { - modus = MODE_AUTOMATIK; - winkel = winkel_min; // Hahn schliessen - servo_aktiv = 0; // Servo-Betrieb aus - SERVO_WRITE(winkel); - auto_aktiv = 0; // automatische Füllung starten - tara_glas = 0; - rotary_select = SW_WINKEL; // Einstellung für Winkel über Rotary - initRotaries(SW_MENU, fmenge_index, 0, 4, 1); - gewicht_vorher = glaeser[fmenge_index].Gewicht + korrektur; -// autokorrektur_gr = 0; - } - - pos = getRotariesValue(SW_WINKEL); - // nur bis winkel_fein regeln, oder über initRotaries lösen? - if ( pos < ((winkel_fein*100)/winkel_max) ) { - pos = ((winkel_fein*100)/winkel_max); - setRotariesValue(SW_WINKEL, pos); - } - -#ifdef USE_ROTARY // TODO: kann das Poti hier überhaupt etwas ändern? - korrektur = getRotariesValue(SW_KORREKTUR); - fmenge_index = getRotariesValue(SW_MENU); -#endif - fmenge = glaeser[fmenge_index].Gewicht; - tara = glaeser[fmenge_index].Tara; - if ( tara <= 0 ) - auto_aktiv = 0; - - // wir starten nur, wenn das Tara für die Füllmenge gesetzt ist! - // Ein erneuter Druck auf Start erzwingt die Aktivierung des Servo - if (((digitalRead(button_start_pin)) == HIGH) && (tara > 0)) { - // debounce - delay(10); - while( digitalRead(button_start_pin) == HIGH ) - ; - delay(10); - - if ( auto_aktiv == 1 ) { - erzwinge_servo_aktiv = 1; -#ifdef isDebug - Serial.println("erzwinge Servo aktiv"); -#endif - } - auto_aktiv = 1; // automatisches Füllen aktivieren - rotary_select = SW_WINKEL; // falls während der Parameter-Änderung auf Start gedrückt wurde - setPreferences(); // falls Parameter über den Rotary verändert wurden - } - - if ((digitalRead(button_stop_pin)) == HIGH) { - winkel = winkel_min; - servo_aktiv = 0; - auto_aktiv = 0; - tara_glas = 0; -// autokorrektur_gr = 0; - } - -// Fehlerkorrektur der Waage, falls Gewicht zu sehr schwankt -#ifdef FEHLERKORREKTUR_WAAGE - int Vergleichsgewicht = (int(SCALE_GETUNITS(SCALE_READS))) - tara; - for (byte j = 0 ; j < 3; j++) { // Anzahl der Wiederholungen, wenn Abweichung zu hoch - gewicht = (int(SCALE_GETUNITS(SCALE_READS))) - tara; - if (abs(gewicht - Vergleichsgewicht) < 50) // Abweichung für Fehlererkennung - break; - delay(100); - } -#else - gewicht = (int(SCALE_GETUNITS(SCALE_READS))) - tara; -#endif - - // Glas entfernt -> Servo schliessen - if (gewicht < -20) { - winkel = winkel_min; - servo_aktiv = 0; - tara_glas = 0; - if ( autostart != 1 ) { // Autostart nicht aktiv - auto_aktiv = 0; - } - } - - // Automatik ein, leeres Glas aufgesetzt, Servo aus -> Glas füllen - if ((auto_aktiv == 1) && (abs(gewicht) <= glastoleranz) && (servo_aktiv == 0)) { - rotary_select = SW_WINKEL; // falls während der Parameter-Änderung ein Glas aufgesetzt wird - u8g2.clearBuffer(); - u8g2.setFont(u8g2_font_courB24_tf); - u8g2.setCursor(15, 43); - u8g2.print("START"); - u8g2.sendBuffer(); - // kurz warten und prüfen ob das Gewicht nicht nur eine zufällige Schwankung war - delay(1500); - gewicht = (int(SCALE_GETUNITS(SCALE_READS))) - tara; - - if ( abs(gewicht) <= glastoleranz ) { - tara_glas = gewicht; -#ifdef isDebug - Serial.print("gewicht: "); Serial.print(gewicht); - Serial.print(" gewicht_vorher: "); Serial.print(gewicht_vorher); - Serial.print(" zielgewicht: "); Serial.print(fmenge + korrektur + tara_glas + autokorrektur_gr); - Serial.print(" kulanz: "); Serial.print(kulanz_gr); - Serial.print(" Autokorrektur: "); Serial.println(autokorrektur_gr); -#endif - servo_aktiv = 1; - sammler_num = 0; - voll = false; //Kud - gezaehlt = false; //Kud - buzzer(BUZZER_SHORT); - } - } - zielgewicht = fmenge + korrektur + tara_glas + autokorrektur_gr; - - // Anpassung des Autokorrektur-Werts - if ( autokorrektur == 1 ) - { - if ( (auto_aktiv == 1) // Automatik ist aktiviert - && (servo_aktiv == 0 ) && (winkel == winkel_min) // Hahn ist geschlossen - && (gewicht >= zielgewicht ) // Glas ist voll - && (sammler_num <= 5) // tropfmenge noch nicht erfasst - ) { - voll = true;//Kud - if ( (gewicht == gewicht_vorher) && (sammler_num < 5) ) { // wir wollen 5x das identische Gewicht sehen - sammler_num++; - } else if ( gewicht != gewicht_vorher ) { // sonst gewichtsänderung nachführen - gewicht_vorher = gewicht; - sammler_num = 0; - } else if ( sammler_num == 5 ) { // gewicht ist 5x identisch, autokorrektur bestimmen - autokorrektur_gr = (fmenge + kulanz_gr + tara_glas) - (gewicht - autokorrektur_gr); - if ( korrektur + autokorrektur_gr > kulanz_gr ) { // Autokorrektur darf nicht überkorrigieren, max Füllmenge plus Kulanz - autokorrektur_gr = kulanz_gr - korrektur; -#ifdef isDebug - Serial.print("Autokorrektur begrenzt auf "); - Serial.println(autokorrektur_gr); -#endif - } - buzzer(BUZZER_SUCCESS); - sammler_num++; // Korrekturwert für diesen Durchlauf erreicht - } - - if ((voll == true) && (gezaehlt == false)) { //Kud - glaeser[fmenge_index].TripCount++; - glaeser[fmenge_index].Count++; -// setPreferences(); // machen wir am Ende - gezaehlt = true; - } -#ifdef isDebug - Serial.print("Nachtropfen:"); - Serial.print(" gewicht: "); Serial.print(gewicht); - Serial.print(" gewicht_vorher: "); Serial.print(gewicht_vorher); - Serial.print(" sammler_num: "); Serial.print(sammler_num); - Serial.print(" Korrektur: "); Serial.println(autokorrektur_gr); - Serial.print(" Zähler Trip: "); Serial.print(glaeser[fmenge_index].TripCount); //Kud - Serial.print(" Zähler: "); Serial.println(glaeser[fmenge_index].Count); //Kud -#endif - } - } - - // Glas ist teilweise gefüllt. Start wird über Start-Taster erzwungen - if ((auto_aktiv == 1) && (gewicht > 5) && (erzwinge_servo_aktiv == 1) ) { - servo_aktiv = 1; - voll = false; //Kud - gezaehlt = false;//Kud - buzzer(BUZZER_SHORT); - } - - if (servo_aktiv == 1) { - winkel = ((winkel_max * pos) / 100); - } - - if ((servo_aktiv == 1) && (( zielgewicht - gewicht ) <= fein_dosier_gewicht)) { - winkel = ( ((winkel_max*pos) / 100) * ((zielgewicht-gewicht) / fein_dosier_gewicht) ); - } - - if ((servo_aktiv == 1) && (winkel <= winkel_fein)) { - winkel = winkel_fein; - } - - // Glas ist voll - if ((servo_aktiv == 1) && (gewicht >= zielgewicht)) { - winkel = winkel_min; - servo_aktiv = 0; - - if (gezaehlt == false) { //Kud - glaeser[fmenge_index].TripCount++; - glaeser[fmenge_index].Count++; -// setPreferences(); machen wir am Ende - gezaehlt = true; - } - if ( autostart != 1 ) // autostart ist nicht aktiv, kein weiterer Start - auto_aktiv = 0; - if ( autokorrektur == 1 ) // autokorrektur, gewicht merken - gewicht_vorher = gewicht; - buzzer(BUZZER_SHORT); - } - - SERVO_WRITE(winkel); - -#ifdef isDebug -#if isDebug >= 4 - Serial.print("Automatik:"); - Serial.print(" Gewicht: "); Serial.print(gewicht); - Serial.print(" Winkel: "); Serial.print(winkel); -// Serial.print(" Dauer "); Serial.print(millis() - scaletime); -// Serial.print(" Füllmenge: "); Serial.print(fmenge); -// Serial.print(" Korrektur: "); Serial.print(korrektur); -// Serial.print(" Tara_glas:"); Serial.print(tara_glas); - Serial.print(" Autokorrektur: "); Serial.print(autokorrektur_gr); - Serial.print(" Zielgewicht "); Serial.print(zielgewicht); -// Serial.print(" Erzwinge Servo: "); Serial.print(erzwinge_servo_aktiv); -// Serial.print(" servo_aktiv "); Serial.print(servo_aktiv); - Serial.print(" auto_aktiv "); Serial.println(auto_aktiv); -#endif -#endif - u8g2.clearBuffer(); - - // Gewicht blinkt, falls unter der definierten Füllmenge - // Korrekturfaktor und Füllmenge blinken, wenn sie über den Rotary verstellt werden - blinktime = (millis()/10) % 5; - - // wenn kein Tara für unser Glas definiert ist, wird kein Gewicht sondern eine Warnung ausgegeben - if ( tara > 0 ) { - // kein Glas aufgestellt - if ( gewicht < -20 ) { - u8g2.setFont(u8g2_font_courB12_tf); - u8g2.setCursor(28, 30); u8g2.print("Bitte Glas"); - u8g2.setCursor(28, 44); u8g2.print("aufstellen"); - } else { - u8g2.setCursor(10, 42); - u8g2.setFont(u8g2_font_courB24_tf); - - if( (autostart == 1) && (auto_aktiv == 1 ) && (servo_aktiv == 0) && (gewicht >= -5) && (gewicht - tara_glas < fmenge) && (blinktime < 2) ) { - sprintf(ausgabe,"%5s", " "); - } else { - sprintf(ausgabe,"%5dg", gewicht - tara_glas); - } - u8g2.print(ausgabe); - } - } else { - u8g2.setCursor(42, 38); - u8g2.setFont(u8g2_font_courB14_tf); - sprintf(ausgabe,"%6s", "no tara!"); - u8g2.print(ausgabe); - } - - // Play/Pause Icon, ob die Automatik aktiv ist - u8g2.setFont(u8g2_font_open_iconic_play_2x_t); - u8g2.drawGlyph(0, 40, (auto_aktiv==1)?0x45:0x44 ); - - u8g2.setFont(u8g2_font_courB12_tf); - // Zeile oben, Öffnungswinkel absolut und Prozent, Anzeige Autostart - u8g2.setCursor(0, 11); - sprintf(ausgabe,"W=%-3d %2s %3d%%", winkel, (autostart==1)?"AS":" ", pos); - u8g2.print(ausgabe); - - u8g2.setFont(u8g2_font_courB10_tf); - // Zeile unten, aktuell zu verstellende Werte blinken. - // Verstellung nur wenn Automatik inaktiv, gesteuert über Interrupt-Funktion - - if(servo_aktiv == 1) { - int progressbar = 128.0*((float)gewicht/(float)zielgewicht); - progressbar = constrain(progressbar,0,128); - - u8g2.drawFrame(0, 50, 128, 14 ); - u8g2.drawBox (0, 50, progressbar, 14 ); - } - else - { - if( autokorrektur == 1 ){ - u8g2.setCursor( 0, 64); - u8g2.print("a"); - u8g2.setCursor(10, 64); - } else { - u8g2.setCursor( 0, 64); - } - - if( rotary_select == SW_KORREKTUR && blinktime < 2 ) { - if (glaeser[fmenge_index].Gewicht > 999){ - sprintf(ausgabe,"k= %s %3s-%3s",(autokorrektur==1)?"":" ", "1kg", GlasTypArray[glaeser[fmenge_index].GlasTyp] ); - } else { - sprintf(ausgabe,"k= %s %3d-%3s",(autokorrektur==1)?"":" ", glaeser[fmenge_index].Gewicht, GlasTypArray[glaeser[fmenge_index].GlasTyp] ); - } - } else if ( rotary_select == SW_MENU && blinktime < 2 ) { - sprintf(ausgabe,"k=%-3d" , korrektur + autokorrektur_gr); - } else { - if (glaeser[fmenge_index].Gewicht > 999){ - sprintf(ausgabe,"k=%-3d%s %3s-%3s", korrektur + autokorrektur_gr, (autokorrektur==1)?"":" ", "1kg", GlasTypArray[glaeser[fmenge_index].GlasTyp] ); - } else { - sprintf(ausgabe,"k=%-3d%s %3d-%3s", korrektur + autokorrektur_gr, (autokorrektur==1)?"":" ", glaeser[fmenge_index].Gewicht, GlasTypArray[glaeser[fmenge_index].GlasTyp] ); - } - } - u8g2.print(ausgabe); - } - - u8g2.sendBuffer(); - - setPreferences(); -} - -void processHandbetrieb(void) -{ - static unsigned long scaletime; - static unsigned long dauer; - - if ( modus != MODE_HANDBETRIEB ) { - modus = MODE_HANDBETRIEB; - winkel = winkel_min; // Hahn schliessen - servo_aktiv = 0; // Servo-Betrieb aus - SERVO_WRITE(winkel); - rotary_select = SW_WINKEL; - tara = 0; - } - - pos = getRotariesValue(SW_WINKEL); - gewicht = SCALE_GETUNITS(SCALE_READS) - tara; - - if ((digitalRead(button_start_pin)) == HIGH) { - servo_aktiv = 1; - } - - if ((digitalRead(button_stop_pin)) == HIGH) { - servo_aktiv = 0; - } - -#ifdef USE_ROTARY_SW - if ( ((digitalRead(outputSW)) == LOW) /*&& (tara == 0) */ ) { // sonst muss der Taster entprellt werden! - tara = SCALE_GETUNITS(SCALE_READS); - } -#endif - - if (servo_aktiv == 1) { - winkel = ((winkel_max * pos) / 100); - } else { - winkel = winkel_min; - } - winkel = constrain(winkel, winkel_min, winkel_max); - SERVO_WRITE(winkel); - -#ifdef isDebug -#if isDebug >= 4 - Serial.print("Handbetrieb:"); - Serial.print(" Gewicht "); Serial.print(gewicht); - Serial.print(" Winkel "); Serial.print(winkel); - Serial.print(" Dauer "); Serial.print(millis() - scaletime); - Serial.print(" servo_aktiv "); Serial.println(servo_aktiv); -#endif -#endif - scaletime = millis(); - // Ausgabe OLED. Dauert ca. 170ms - u8g2.clearBuffer(); - - u8g2.setFont(u8g2_font_courB24_tf); - u8g2.setCursor(10, 42); - sprintf(ausgabe,"%5dg", gewicht); -// sprintf(ausgabe,"%5dg", dauer); - u8g2.print(ausgabe); - - u8g2.setFont(u8g2_font_open_iconic_play_2x_t); - u8g2.drawGlyph(0, 40, (servo_aktiv==1)?0x45:0x44 ); - - u8g2.setFont(u8g2_font_courB12_tf); - u8g2.setCursor(0, 11); - sprintf(ausgabe,"W=%-3d %3d%%", winkel, pos); - u8g2.print(ausgabe); - u8g2.setCursor(0, 64); - sprintf(ausgabe, "Manuell %s", (tara>0?"Tara":" ")); - u8g2.print(ausgabe); - - u8g2.sendBuffer(); - - setPreferences(); -// u8g2.updateDisplayArea(4,2,12,6); // schneller aber ungenaue Displayausgabe. - dauer = millis() - scaletime; -} - -void setup() -{ - // enable internal pull downs for digital inputs - pinMode(button_start_pin, INPUT_PULLDOWN); - pinMode(button_stop_pin, INPUT_PULLDOWN); - pinMode(switch_betrieb_pin, INPUT_PULLDOWN); - pinMode(switch_setup_pin, INPUT_PULLDOWN); -#if HARDWARE_LEVEL == 2 - pinMode(vext_ctrl_pin, INPUT_PULLDOWN); -#endif - - Serial.begin(115200); - while (!Serial) { - } -#ifdef isDebug - Serial.println("Hanimandl Start"); -#endif - -// Rotary -#ifdef USE_ROTARY_SW - pinMode(outputSW, INPUT_PULLUP); - attachInterrupt(outputSW, isr1, FALLING); -#endif -#ifdef USE_ROTARY - pinMode(outputA,INPUT); - pinMode(outputB,INPUT); - attachInterrupt(outputA, isr2, CHANGE); -#endif - -// switch Vcc / GND on normal pins for convenient wiring -// output is 3.3V for VCC - digitalWrite (switch_vcc_pin, HIGH); - digitalWrite (button_start_vcc_pin, HIGH); - digitalWrite (button_stop_vcc_pin, HIGH); - -// pinMode (_GND, OUTPUT); // turn on GND pin first (important!) -// turn on VCC power - pinMode (switch_vcc_pin, OUTPUT); - pinMode (button_start_vcc_pin, OUTPUT); - pinMode (button_stop_vcc_pin, OUTPUT); - -// Buzzer - pinMode(buzzer_pin, OUTPUT); - -// short delay to let chip power up - delay (100); - -// Preferences aus dem EEPROM lesen - getPreferences(); - -// Servo initialisieren und schliessen -#ifdef SERVO_ERWEITERT - servo.attach(servo_pin, 750, 2500); // erweiterte Initialisierung, steuert nicht jeden Servo an -#else - servo.attach(servo_pin, 1000, 2000); // default Werte. Achtung, steuert den Nullpunkt weniger weit aus! -#endif - SERVO_WRITE(winkel_min); - -// Waage erkennen - machen wir vor dem Boot-Screen, dann hat sie 3 Sekunden Zeit zum aufwärmen - scale.begin(hx711_dt_pin, hx711_sck_pin); - if (scale.wait_ready_timeout(1000)) { // Waage angeschlossen? - scale.power_up(); - waage_vorhanden = 1; -#ifdef isDebug - Serial.println("Waage erkannt"); -#endif - } - -// Boot Screen - u8g2.setBusClock(800000); // experimental - u8g2.begin(); - u8g2.enableUTF8Print(); - u8g2.clearBuffer(); - print_logo(); - buzzer(BUZZER_SHORT); - delay(2000); - print_credits(); - delay(4000); - -// Setup der Waage, Skalierungsfaktor setzen - if (waage_vorhanden ==1 ) { // Waage angeschlossen? - if ( faktor == 0 ) { // Vorhanden aber nicht kalibriert - u8g2.clearBuffer(); - u8g2.setFont(u8g2_font_courB18_tf); - u8g2.setCursor( 24, 24); u8g2.print("Nicht"); - u8g2.setCursor( 10, 56); u8g2.print("kalibr."); - u8g2.sendBuffer(); -#ifdef isDebug - Serial.println("Waage nicht kalibriert!"); -#endif - delay(2000); - } else { // Tara und Skalierung setzen - scale.set_scale(faktor); - scale.set_offset(long(gewicht_leer)); -#ifdef isDebug - Serial.println("Waage initialisiert"); -#endif - } - } else { // Keine Waage angeschlossen - u8g2.clearBuffer(); - u8g2.setFont(u8g2_font_courB24_tf); - u8g2.setCursor( 14, 24); u8g2.print("Keine"); - u8g2.setCursor( 6, 56); u8g2.print("Waage!"); - u8g2.sendBuffer(); - buzzer(BUZZER_ERROR); -#ifdef isDebug - Serial.println("Keine Waage!"); -#endif - delay(2000); - } - -// initiale Kalibrierung des Leergewichts wegen Temperaturschwankungen -// Falls mehr als 20g Abweichung steht vermutlich etwas auf der Waage. - if (waage_vorhanden == 1) { - gewicht = SCALE_GETUNITS(SCALE_READS); - if ( (gewicht > -20) && (gewicht < 20) ) { - scale.tare(10); - buzzer(BUZZER_SUCCESS); -#ifdef isDebug - Serial.print("Tara angepasst um: "); - Serial.println(gewicht); -#endif - } else if (faktor != 0) { - u8g2.clearBuffer(); - u8g2.setFont(u8g2_font_courB18_tf); - u8g2.setCursor( 24, 24); u8g2.print("Waage"); - u8g2.setCursor( 10, 56); u8g2.print("leeren!"); - u8g2.sendBuffer(); -#ifdef isDebug - Serial.print("Gewicht auf der Waage: "); - Serial.println(gewicht); -#endif - delay(5000); - - // Neuer Versuch, falls Gewicht entfernt wurde - gewicht = SCALE_GETUNITS(SCALE_READS); - if ( (gewicht > -20) && (gewicht < 20) ) { - scale.tare(10); - buzzer(BUZZER_SUCCESS); -#ifdef isDebug - Serial.print("Tara angepasst um: "); - Serial.println(gewicht); -#endif - } else { // Warnton ausgeben - buzzer(BUZZER_LONG); - } - } - } - -// die drei Datenstrukturen des Rotaries initialisieren - initRotaries(SW_WINKEL, 0, 0, 100, 5 ); // Winkel - initRotaries(SW_KORREKTUR, 0, -90, 20, 1 ); // Korrektur - initRotaries(SW_MENU, 0, 0, 7, 1 ); // Menuauswahlen - -// Parameter aus den Preferences für den Rotary Encoder setzen - setRotariesValue(SW_WINKEL, pos); - setRotariesValue(SW_KORREKTUR, korrektur); - setRotariesValue(SW_MENU, fmenge_index); -} - -void loop() -{ - rotating = true; // debounce Management - - // Setup Menu - if ((digitalRead(switch_setup_pin)) == HIGH) - processSetup(); - - // Automatik-Betrieb - if ((digitalRead(switch_betrieb_pin)) == HIGH) - processAutomatik(); - - // Handbetrieb - if ((digitalRead(switch_betrieb_pin) == LOW) - && (digitalRead(switch_setup_pin) == LOW)) - processHandbetrieb(); -} - -void print_credits() { - u8g2.clearBuffer(); - u8g2.setFont(u8g2_font_helvB08_tf); - u8g2.setCursor(0, 10); u8g2.print("Idee: M. Vasterling"); - u8g2.setCursor(0, 23); u8g2.print("Code: M. Vasterling, M."); - u8g2.setCursor(0, 36); u8g2.print("Wetzel, C. Gruber, A."); - u8g2.setCursor(0, 49); u8g2.print("Holzhammer, M. Junker,"); - u8g2.setCursor(0, 62); u8g2.print("J. Kuder, J. Bruker"); - u8g2.sendBuffer(); -} - -void print_logo() { - const unsigned char logo_biene1[] = { - 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x70, 0x00, 0xC0, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF0, - 0x00, 0xC0, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xE0, 0x01, 0xE0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xC0, 0x01, 0x60, 0x00, 0x00, - 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x01, 0x60, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0xC1, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, - 0x00, 0x00, 0xF8, 0x0F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFC, 0x1F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFE, 0x3F, - 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x1F, 0x7C, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0F, 0x70, 0x00, 0xF0, 0xFF, 0x01, - 0x00, 0x00, 0x00, 0x00, 0x03, 0xE0, 0x80, 0xFF, 0xFF, 0x0F, 0x00, 0xFF, 0xFF, 0x80, 0xF1, 0x47, 0xF0, 0x07, 0x00, 0x3E, 0xE0, 0xFF, 0xFF, 0x07, - 0xF9, 0x07, 0x7E, 0x00, 0x00, 0x78, 0xF0, 0x03, 0xE0, 0x1F, 0xF8, 0x07, 0x1F, 0x00, 0x00, 0x70, 0x3C, 0x00, 0x00, 0xFE, 0x38, 0xC0, 0x03, 0x00, - 0x00, 0xF0, 0x0E, 0x00, 0x00, 0xF8, 0x03, 0xF8, 0x00, 0x00, 0x00, 0xE0, 0x06, 0x00, 0x00, 0xC0, 0x0F, 0x7C, 0x00, 0x00, 0x00, 0xE0, 0x06, 0x00, - 0x00, 0x00, 0x1F, 0x1F, 0x00, 0x00, 0x00, 0x70, 0x03, 0x00, 0x00, 0x00, 0xFC, 0x07, 0x00, 0x00, 0x00, 0x70, 0x03, 0x00, 0x00, 0x00, 0xF0, 0x03, - 0x00, 0x00, 0x00, 0x38, 0x03, 0x00, 0x00, 0x00, 0xE0, 0x01, 0x00, 0x00, 0x00, 0x1C, 0x07, 0x00, 0x00, 0x00, 0xF0, 0xF0, 0x07, 0x00, 0x00, 0x0F, - 0x0F, 0x00, 0x00, 0x78, 0x78, 0xE0, 0x3F, 0x00, 0xC0, 0x07, 0x3E, 0x00, 0x80, 0xFF, 0x3C, 0xC0, 0x7F, 0x00, 0xF0, 0x01, 0xFC, 0x00, 0xE0, 0xFF, - 0x1C, 0x80, 0xFF, 0x01, 0x7E, 0x00, 0xF0, 0xFF, 0xFF, 0x3F, 0x0E, 0x00, 0xFE, 0xFF, 0x0F, 0x00, 0xC0, 0xFF, 0xFF, 0x07, 0x0F, 0x00, 0xC0, 0x1F, - 0x00, 0x00, 0x00, 0xFC, 0x3F, 0x00, 0x07, 0x00, 0x00, 0x3C, 0x00, 0x00, 0x00, 0x80, 0x03, 0x80, 0x03, 0xE0, 0x00, 0x70, 0x00, 0x00, 0x00, 0xC0, - 0x01, 0xC0, 0x03, 0xC0, 0x01, 0xE0, 0x00, 0x00, 0x00, 0xE0, 0x00, 0xE0, 0x81, 0xC3, 0x01, 0xC0, 0x01, 0x00, 0x00, 0x70, 0x00, 0xE0, 0xF1, 0x8F, - 0x03, 0x80, 0x03, 0x00, 0x00, 0x38, 0x00, 0xF0, 0xFC, 0x9F, 0x07, 0x00, 0x07, 0x00, 0x00, 0x1C, 0x00, 0xF8, 0x1C, 0x1C, 0x0F, 0x00, 0x06, 0x00, - 0x00, 0x1C, 0x00, 0xFE, 0x00, 0x00, 0x1F, 0x00, 0x0C, 0x00, 0x00, 0x0E, 0x00, 0xF7, 0x00, 0x00, 0x7F, 0x00, 0x0C, 0x00, 0x00, 0x06, 0x80, 0x73, - 0x00, 0x00, 0xE6, 0x00, 0x0C, 0x00, 0x00, 0x07, 0xE0, 0x71, 0x00, 0x00, 0xC6, 0x03, 0x0C, 0x00, 0x00, 0x07, 0x70, 0x70, 0xF0, 0x0F, 0x86, 0x07, - 0x0C, 0x00, 0x00, 0x03, 0x3C, 0x70, 0xFC, 0x3F, 0x06, 0x1F, 0x0E, 0x00, 0x00, 0x03, 0x1E, 0x70, 0xFE, 0x3F, 0x06, 0xFC, 0x07, 0x00, 0x00, 0x87, - 0x0F, 0x70, 0x1E, 0x38, 0x06, 0xF0, 0x03, 0x00, 0x00, 0xFE, 0x03, 0xF0, 0x00, 0x00, 0x06, 0xC0, 0x00, 0x00, 0x00, 0xFC, 0x00, 0xF0, 0x00, 0x00, - 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xE0, 0x80, 0x03, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xE0, 0xE0, 0x0F, 0x07, 0x00, 0x00, 0x00, - 0x00, 0x00, 0x00, 0xE0, 0xF1, 0x9F, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xC0, 0x3B, 0x9C, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xC0, - 0x07, 0xC0, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x07, 0xE0, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0F, 0xE0, 0x00, 0x00, - 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x1F, 0x70, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3E, 0x78, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, - 0x00, 0x00, 0x7C, 0x38, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF8, 0x1C, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF0, 0x0D, - 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xE0, 0x0F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x07, 0x00, 0x00, 0x00, 0x00, - 0x00, 0x00, 0x00, 0x00, 0x00, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, - 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 - }; - - u8g2.clearBuffer(); - u8g2.drawXBM(0,0,80,64,logo_biene1); - u8g2.setFont(u8g2_font_courB14_tf); - u8g2.setCursor(85, 27); u8g2.print("HANI"); - u8g2.setCursor(75, 43); u8g2.print("MANDL"); - u8g2.setFont(u8g2_font_courB08_tf); - u8g2.setCursor(77, 64); u8g2.print("v.0.2.13"); - u8g2.sendBuffer(); -} - -// Wir nutzen einen aktiven Summer, damit entfällt die tone Library, die sich sowieso mit dem Servo beisst. -void buzzer(byte type) { - if (buzzermode == 1) { - switch (type) { - case BUZZER_SHORT: //short - digitalWrite(buzzer_pin,HIGH); - delay(100); - digitalWrite(buzzer_pin,LOW); - break; - - case BUZZER_LONG: //long - digitalWrite(buzzer_pin,HIGH); - delay(500); - digitalWrite(buzzer_pin,LOW); - break; - - case BUZZER_SUCCESS: //success - digitalWrite(buzzer_pin,HIGH); - delay(100); - digitalWrite(buzzer_pin,LOW); - delay(100); - digitalWrite(buzzer_pin,HIGH); - delay(100); - digitalWrite(buzzer_pin,LOW); - delay(100); - digitalWrite(buzzer_pin,HIGH); - delay(100); - digitalWrite(buzzer_pin,LOW); - break; - - case BUZZER_ERROR: //error - digitalWrite(buzzer_pin,HIGH); - delay(1500); - digitalWrite(buzzer_pin,LOW); - break; - } - } -} - -// Supportfunktionen für stufenweise Gewichtsverstellung -int step2weight( int step ) { - int sum = 0; - - if ( step > 210 ) { sum += (step-210)*1000; step -= (step-210); } - if ( step > 200 ) { sum += (step-200)* 500; step -= (step-200); } - if ( step > 160 ) { sum += (step-160)* 100; step -= (step-160); } - if ( step > 140 ) { sum += (step-140)* 25; step -= (step-140); } - if ( step > 50 ) { sum += (step- 50)* 5; step -= (step- 50); } - sum += step; - - return sum; -} -int weight2step ( int sum ) { - int step = 0; - - if ( sum > 10000 ) { step += (sum-10000)/1000; sum -= ((sum-10000)); } - if ( sum > 5000 ) { step += (sum-5000)/500; sum -= ((sum-5000)); } - if ( sum > 1000 ) { step += (sum-1000)/100; sum -= ((sum-1000)); } - if ( sum > 500 ) { step += (sum-500)/25; sum -= ((sum-500)); } - if ( sum > 50 ) { step += (sum-50)/5; sum -= (sum-50); } - step += sum; - - return step; -} diff --git a/platformio.ini b/platformio.ini deleted file mode 100644 index 1cf40ab..0000000 --- a/platformio.ini +++ /dev/null @@ -1,24 +0,0 @@ -; PlatformIO Project Configuration File -; -; Build options: build flags, source filter -; Upload options: custom upload port, speed and extra flags -; Library options: dependencies, extra library storages -; Advanced options: extra scripting -; -; Please visit documentation for the other options and examples -; https://docs.platformio.org/page/projectconf.html - -[platformio] -src_dir = . - -[env:heltec] -platform = espressif32 -board = heltec_wifi_kit_32 -framework = arduino - -monitor_speed = 115200 - -lib_deps = - HX711@^0.7.4 - U8g2@^2.28.6 - ESP32Servo@^0.9.0 diff --git a/readme.md b/readme.md deleted file mode 100644 index c7d8d09..0000000 --- a/readme.md +++ /dev/null @@ -1,222 +0,0 @@ -![image](https://github.com/ClemensGruber/hani-mandl/workflows/PlatformIO%20CI/badge.svg) -![image](https://img.shields.io/github/v/tag/ClemensGruber/hani-mandl.svg) - -# HaniMandl - -Ein halbautomatischer Honig-Abfüll-Roboter. - -Websites: -- Code, Infos zur Hardware, Fotos und Videos initial publiziert in der Facebook-Gruppe ["Imkerei und Technik. Eigenbau"](https://www.facebook.com/groups/139671009967454) -- Weitere Infos unter: [HaniMandl, halbautomatischer Honig-Abfüllbehälter](https://community.hiveeyes.org/t/side-project-hanimandl-halbautomatischer-honig-abfullbehalter/768) - ---- - -# Anleitung - -## Einstellungen im Arduino-Code - -Das Verhalten des Codes wird über mehrere `#define`-Variablen gesteuert. - -``` -#define HARDWARE_LEVEL 2 - 1 für originales pinout Layout mit Schalter auf Pin 19/22/21 - 2 für neues Layout für "New Heltec Wifi Kit 32" (V2) mit Schalter auf Pin 23/19/22 - -#define SERVO_ERWEITERT - aktivieren, falls ein Automat mit Software 0.1.4 aktualisiert wird und der Servo nicht ganz schliesst - oder der Servo generell nicht weit genug bewegt wird. - Der neue Code verwendet default-Werte für die Ansteuerung des Servos, um mehr Servos anzusprechen. Der - 0.1.4 Code hatte spezielle Werte, bei denen die 0-Stellung niedriger war. - Über dieses Define können die Werte des 0.1.4 Codes aktiviert werden. Alternative: Hardware anpassen - -#define ROTARY_SCALE 2 - Verschiedene Rotary Encoder liefern unterschiedliche Increments pro Stufe. Das kann hier angepasst werden. - Beispiele: KY-040 = 2, HW-040 = 1 - Falls kein Rotary Encoder genutzt wird, sollte das define auf 1 gesetzt werden - -#define USE_ROTARY - aktivieren, wenn ein Rotary Encoder für die Steuerung des Interface genutzt wird. - -#define USE_ROTARY_SW // Taster des Rotary benutzen - aktivieren, wenn der Rotary auch eine Tastfunktion hat. - ACHTUNG: falls ein Poti (siehe unten) genutzt wird, sollte diese Variable deaktiviert werden! - Ausnahme: es wird ein dritter Taster eingebaut. Nicht unterstützt! - -#define USE_POTI // Poti benutzen -> ACHTUNG, im Normalfall auch USE_ROTARY_SW deaktivieren! - aktivieren, wenn ein Poti statt eines Rotary für die Steuerung des Interface genutzt wird - Es wird dringend empfohlen, einen Rotary Encoder zu benutzen! - -#define FEHLERKORREKTUR_WAAGE // falls Gewichtssprünge auftreten, können diese hier abgefangen werden - Achtung, kann den Wägeprozess verlangsamen. Vorher Wägezellen/HX711 prüfen! - -#define QUETSCHHAHN_LINKS - Servo invertieren, falls der Quetschhahn von links geöffnet wird. Mindestens ein Exemplar eines solchen Eimers ist bekannt -``` -Die weiteren defines und Variablen müssen bei einer Standard-Schaltung nicht angepasst werden. - - -## Hardware-Aufbau - -Es wird empfohlen, den Servo erst nach dem ersten Einschalten der Elektronik mit dem Quetschhahn zu verbinden! -Der Servo fährt automatisch in die Nullstellung. Danach kann das Gestänge verbunden werden und über das Servo-Setup -können die Servo-Positionen fein eingestellt werden. - -## Betrieb - -Grundsätzlich: Als Drehregler wird entweder ein Poti oder ein Rotary Encoder eingesetzt. -Bei Benutzung eines Rotary Encoders mit Taster wirkt der Taster aus Auswahl-Taste. -Wird ein Poti oder Rotary Encoder ohne Taster verwendet, wird der grüne Button im Setup als Auswahl -genutzt. Die Funktion "Tara" im Handbetrieb und die direkte Verstellung des Korrekturwerts und -der Füllmenge im Automatikmodus stehen nur bei einem Rotary Encoder mit integriertem Taster zur Verfügung! - - -Setup ------ -In Schalterstellung II (oder I je nachdem wie der 3-fach-Schalter verbaut wurde) könnne verschiedene -Grundeinstellungen vorgenommen werden: - -1. Tara -Für jede Füllmenge bzw. das entsprechende Glas kann ein Leergewicht ("Tara") definiert werden. -Die hinterlegten Tara-Werte werden im Menu angezeigt. -Einstellung: Füllmenge wählen, leeres Glas aufstellen und über die Auswahl-Taste speichern - -2. Kalibieren -Menügeführte Kalibrierung der Wägezelle - -3. Korrektur -Einstellen des Korrekturwerts. Je nach Temperatur und Konsistenz des Honigs bzw. Füllmenge im -Abfüllbehälter wird durch die Trägheit des Systems der eingestellte Wert überschritten. -Der Korrekturwert dient dazu, das anzupassen bzw. ein paar Gramm mehr einzufüllen, um die Richtlinien -zu erfüllen. -Wert über Drehregler einstellen und mit Auswahl bestätigen - -4. Füllmenge -Auswahl der Abfüllmenge - -5. Automatik -Einstellen der beiden Automatiken "Autostart" und "Autokorrektur" sowie des Kulanzwerts für die Autokorrektur. -- Autostart beginnt den Füllvorgang, wenn ein passendes, leeres Glas aufgesetzt wird -- Autokorrektur ermittelt einen automatischen Korrekturwert, um die Gläser bei sinkendem Druck im Behälter - bis zur Füllmenge + Kulanz zu befüllen - -6. Servowinkel -Definition der minimalen und maximalen Öffnungswinkel des Servos sowie des Winkels für die Feindosierung. -Der minimale Öffnungswinkel sollte den Quetschhahn mit minimalem Spiel schliessen. -Der maximale Öffnungswinkel begrenzt den Hub des Servos, um den Servo an die Mechanik anzupassen. -Der Servo bleibt bis zum Erreichen des Zielgewichts (Füllmenge + Korrektur) mindestens bis zum Winkel Feindosierung -geöffnet und schliesst danach vollständig. Sollte je nach Konsistenz angepasst werden. Ein größerer Wert hier -führt zu einer schnelleren Füllung, ein kleinerer Wert zu genaueren Mengen. - -Einstellung: Im Handbetrieb den Servo langsam auf die gewünschte Öffnung fahren. Den Wert unter "W=" dann hier -einstellen. -Über den Punkt "Livesetup" können die Winkel auch direkt aus dem Setup angefahren werden. Vorsicht bei Verwendung -mit einem Poti, oder bei gefülltem Abfüllbehälter! - -7. Clear Pref's -Setzt alle Voreinstellungen (nach Bestätigung) zurück. -Danach muss die Kalibrierung der Waage wiederholt und alle Werte neu gesetzt werden! - -Handbetrieb ------------ -Im Handbetrieb wird der Öffnungswinkel des Servo direkt über den Drehregler bestimmt. Der absolute und -relative Servo-Winkel werden in der oberen Zeile angezeigt. - -Der Servo wird über die grüne Taste aktiviert und über rote Taste deaktivert. Der aktuelle Zustand wird -über das Play/Pause Symbol links angezeigt. - -Das Gewicht wird permanent angezeigt. Über den Auswahl-Taster kann das aktuelle Gewicht als Tara eingestellt -werden, d.h. die Waage springt auf Null und zählt ab dem aktuellen Gewicht. Zurückgestellt wird über einen -Tastendruck bei leerer Waage. - -Der Modus dient zum manuellen Füllen und zum ermitteln der Werte für den maximalen und minimalen Winkel -des Servos für das Setup. - -Automatik ---------- -Der Automatik-Modus hat zwei Betriebsarten, die über das Setup "Autostart" gewählt werden. Der aktive -Autostart wird in der obersten Zeile mit "AS" angezeigt. Ausserdem sind dort der absolute und relative -Öffnungswinkel zu finden. - -Die untere Zeile zeigt die Werte für die Korrektur und die Füllmenge. Eine aktive Autokorrektur ist dort -erkennbar, weil der Korrekturwert dort statt "k=" mit "ak=" angegeben wird. - -Der Automatik-Modus muss über die grüne Taste aktiviert werden. Rot stoppt die Automatik und schliesst -den Servo. -Über den Drehregler kann der Öffnungswinkel des Servos begrenzt werden. - -Autostart nicht aktiv ---------------------- -Wenn der Autostart nicht aktiv ist, dann startet der Servo nur, wenn ein leeres oder teilweise gefülltes -Glas auf der Waage steht. Dieses Glas wird bis zur eingestellten Füllmenge befüllt, dann stoppt das -Programm. - -Eine erneute Befüllung muss wieder mit der grünen Taste aktiviert werden (Halbautomatik). - -**Achtung:** Da auch teilgefüllte Gläser befüllt werden, kann ein abweichendes Gewicht des leeren Glases nicht -berücksichtigt werden! Ein halb volles 125g Glas kann die Befüllung mit 500g auslösen... - -Autostart aktiv ---------------- -Der Autostart-Modus wird ebenfalls über die grüne Taste aktiviert (Play/Pause Symbol). - -Danach startet der Füll-Vorgang automatisch, sobald ein passendes, leeres Glas aufgesetzt wird. Wenn das -gefüllte Glas entnommen wird und ein weiteres Glas aufgesetzt wird, startet der nächste Füll-Vorgang ohne -weitere Bestätigung (Vollautomatik). - -Das Gewicht das Glases wird als Tara für diesen Füllvorgang genutzt, um Schwankungen der leeren Gläser -auszugleichen. - -Ein teilgefülltes Glas wird nicht befüllt! Durch erneutes Drücken der Start-Taste wird die Befüllung erzwungen. - -Wenn kein Füllvorgang aktiv ist (der Hahn also geschlossen ist), kann in beiden Modi über den Auswahl-Taster -direkt der Korrekturwert und die Füllmenge zur Verstellung angewählt werden. Der jeweils zu verstellende -Wert blinkt. - -Autokorrektur -------------- -Die aktive Autokorrektur (Anzeige "ak=" unten links) führt die Füllmenge automatisch mit dem sinkenden Druck -im Abfüllbehälter nach. Das Zielgewicht wird im Automatik-Setup über die Kulanz eingestellt (Füllmenge + Kulanz). - - -## Notizen -- Das Projekt wurde auf dem [Heltec WiFi Kit 32](https://community.hiveeyes.org/t/heltec-wifi-kit-32-esp32-mit-kleinem-oled/1498), einem ESP32 mit OLED-Display entwickelt, sollte jedoch auch auf anderen ESP32 Geräten lauffähig sein. -- Bitte nutzt die neueste Version der HX711 Bibliothek von https://github.com/bogde/HX711, die ältere war nicht ohne weiteres auf einem ESP32 lauffähig. - - -## Firmware bauen - -Just type: -``` -make -``` - -After successfully building it, you will find firmware images at - -- .pio/build/heltec/firmware.bin -- .pio/build/heltec/firmware.elf - - -## Binär-Datei `hani-mandl.bin` - -Die Datei `hani-mandl.bin` wurde mit folgenden Parametern für das Board Heltec ESP32 Arduino > Wifi Kit 32 compiliert: - -``` -#define HARDWARE_LEVEL 2 // 1 = originales Layout mit Schalter auf Pin 19/22/21 - // 2 = Layout für V2 mit Schalter auf Pin 23/19/22 -#define SERVO_ERWEITERT // definieren, falls die Hardware mit dem alten Programmcode mit Poti aufgebaut wurde oder der Servo zu wenig fährt - // Sonst bleibt der Servo in Stop-Position einige Grad offen! Nach dem Update erst prüfen! -#define ROTARY_SCALE 2 // in welchen Schritten springt unser Rotary Encoder. - // Beispiele: KY-040 = 2, HW-040 = 1, für Poti-Betrieb auf 1 setzen -#define USE_ROTARY // Rotary benutzen -#define USE_ROTARY_SW // Taster des Rotary benutzen -``` - -Eine Anleitung zum Flashen der Binär-Datei gibt es unter -http://hanimandl.de/2020/12/23/firmware-binary-flashen/ - - -## Lizenzen - -HaniMandl steht unter den Open Source Initiative (OSI) Lizenzen "GPLv3" -und "CERN-OHL-S". Bei früheren Versionen und einigen aktuellen Derivaten -sind keine Lizenzen definiert. diff --git a/historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl-wiring_corresponding-to-code-v0.1.3.fzz b/upstream/hani-mandl-wiring_corresponding-to-code-v0.1.3.fzz similarity index 100% rename from historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl-wiring_corresponding-to-code-v0.1.3.fzz rename to upstream/hani-mandl-wiring_corresponding-to-code-v0.1.3.fzz diff --git a/historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.0.1.ino b/upstream/hani-mandl_v0.0.1.ino similarity index 100% rename from historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.0.1.ino rename to upstream/hani-mandl_v0.0.1.ino diff --git a/historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.0.2.ino b/upstream/hani-mandl_v0.0.2.ino similarity index 100% rename from historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.0.2.ino rename to upstream/hani-mandl_v0.0.2.ino diff --git a/historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.1.0.ino b/upstream/hani-mandl_v0.1.0.ino similarity index 100% rename from historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.1.0.ino rename to upstream/hani-mandl_v0.1.0.ino diff --git a/historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.1.2.ino b/upstream/hani-mandl_v0.1.2.ino similarity index 100% rename from historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.1.2.ino rename to upstream/hani-mandl_v0.1.2.ino diff --git a/historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.1.3.ino b/upstream/hani-mandl_v0.1.3.ino similarity index 100% rename from historic_copy-fb-group_imkerei-technik-eigenbau/hani-mandl_v0.1.3.ino rename to upstream/hani-mandl_v0.1.3.ino diff --git a/parts-3d-printing/readme.md b/variants/README.md similarity index 100% rename from parts-3d-printing/readme.md rename to variants/README.md diff --git a/parts-3d-printing/variante-1_heilbronn/anlenkstange.stl b/variants/variante-1_heilbronn/anlenkstange.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/anlenkstange.stl rename to variants/variante-1_heilbronn/anlenkstange.stl diff --git a/parts-3d-printing/variante-1_heilbronn/bodenplatte.stl b/variants/variante-1_heilbronn/bodenplatte.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/bodenplatte.stl rename to variants/variante-1_heilbronn/bodenplatte.stl diff --git a/parts-3d-printing/variante-1_heilbronn/distanzplaettchen-oben.stl b/variants/variante-1_heilbronn/distanzplaettchen-oben.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/distanzplaettchen-oben.stl rename to variants/variante-1_heilbronn/distanzplaettchen-oben.stl diff --git a/parts-3d-printing/variante-1_heilbronn/distanzplaettchen-unten.stl b/variants/variante-1_heilbronn/distanzplaettchen-unten.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/distanzplaettchen-unten.stl rename to variants/variante-1_heilbronn/distanzplaettchen-unten.stl diff --git a/parts-3d-printing/variante-1_heilbronn/gehaeuse.stl b/variants/variante-1_heilbronn/gehaeuse.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/gehaeuse.stl rename to variants/variante-1_heilbronn/gehaeuse.stl diff --git a/parts-3d-printing/variante-1_heilbronn/hanimandl-heilbronn-1.jpg b/variants/variante-1_heilbronn/hanimandl-heilbronn-1.jpg similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/hanimandl-heilbronn-1.jpg rename to variants/variante-1_heilbronn/hanimandl-heilbronn-1.jpg diff --git a/parts-3d-printing/variante-1_heilbronn/hanimandl-heilbronn-2.jpg b/variants/variante-1_heilbronn/hanimandl-heilbronn-2.jpg similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/hanimandl-heilbronn-2.jpg rename to variants/variante-1_heilbronn/hanimandl-heilbronn-2.jpg diff --git a/parts-3d-printing/variante-1_heilbronn/hanimandl-heilbronn-3.jpg b/variants/variante-1_heilbronn/hanimandl-heilbronn-3.jpg similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/hanimandl-heilbronn-3.jpg rename to variants/variante-1_heilbronn/hanimandl-heilbronn-3.jpg diff --git a/parts-3d-printing/variante-1_heilbronn/klemmring.stl b/variants/variante-1_heilbronn/klemmring.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/klemmring.stl rename to variants/variante-1_heilbronn/klemmring.stl diff --git a/parts-3d-printing/variante-1_heilbronn/readme.md b/variants/variante-1_heilbronn/readme.md similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/readme.md rename to variants/variante-1_heilbronn/readme.md diff --git a/parts-3d-printing/variante-1_heilbronn/servoarm.stl b/variants/variante-1_heilbronn/servoarm.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/servoarm.stl rename to variants/variante-1_heilbronn/servoarm.stl diff --git a/parts-3d-printing/variante-1_heilbronn/servohalter.stl b/variants/variante-1_heilbronn/servohalter.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/servohalter.stl rename to variants/variante-1_heilbronn/servohalter.stl diff --git a/parts-3d-printing/variante-1_heilbronn/waegeplatte.stl b/variants/variante-1_heilbronn/waegeplatte.stl similarity index 100% rename from parts-3d-printing/variante-1_heilbronn/waegeplatte.stl rename to variants/variante-1_heilbronn/waegeplatte.stl diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.jpg b/variants/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.jpg similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.jpg rename to variants/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.jpg diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.stl b/variants/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.stl rename to variants/variante-2_hamburg/hanimadl-ds3218/hahn/hahn.stl diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hahn/mutter.stl b/variants/variante-2_hamburg/hanimadl-ds3218/hahn/mutter.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hahn/mutter.stl rename to variants/variante-2_hamburg/hanimadl-ds3218/hahn/mutter.stl diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hahn/schieber.stl b/variants/variante-2_hamburg/hanimadl-ds3218/hahn/schieber.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hahn/schieber.stl rename to variants/variante-2_hamburg/hanimadl-ds3218/hahn/schieber.stl diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/halter.stl b/variants/variante-2_hamburg/hanimadl-ds3218/halter.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/halter.stl rename to variants/variante-2_hamburg/hanimadl-ds3218/halter.stl diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hanimadl.jpg b/variants/variante-2_hamburg/hanimadl-ds3218/hanimadl.jpg similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/hanimadl.jpg rename to variants/variante-2_hamburg/hanimadl-ds3218/hanimadl.jpg diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/schelle.stl b/variants/variante-2_hamburg/hanimadl-ds3218/schelle.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/schelle.stl rename to variants/variante-2_hamburg/hanimadl-ds3218/schelle.stl diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/schieberarm.stl b/variants/variante-2_hamburg/hanimadl-ds3218/schieberarm.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/schieberarm.stl rename to variants/variante-2_hamburg/hanimadl-ds3218/schieberarm.stl diff --git a/parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/servoarm.stl b/variants/variante-2_hamburg/hanimadl-ds3218/servoarm.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/hanimadl-ds3218/servoarm.stl rename to variants/variante-2_hamburg/hanimadl-ds3218/servoarm.stl diff --git a/parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.jpg b/variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.jpg similarity index 100% rename from parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.jpg rename to variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.jpg diff --git a/parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.step b/variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.step similarity index 100% rename from parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.step rename to variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.step diff --git a/parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.stl b/variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.stl rename to variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/hahn.stl diff --git "a/parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/k\303\266rper12.stl" "b/variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/k\303\266rper12.stl" similarity index 100% rename from "parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/k\303\266rper12.stl" rename to "variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/k\303\266rper12.stl" diff --git a/parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/schelle.stl b/variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/schelle.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/schelle.stl rename to variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/schelle.stl diff --git a/parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/schieber.stl b/variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/schieber.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/schieber.stl rename to variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/schieber.stl diff --git a/parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/schubkappe.stl b/variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/schubkappe.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/nachzeichnung-kunstoffhahn/schubkappe.stl rename to variants/variante-2_hamburg/nachzeichnung-kunstoffhahn/schubkappe.stl diff --git a/parts-3d-printing/variante-2_hamburg/va-hahn/va-befestigungskappe_1.png b/variants/variante-2_hamburg/va-hahn/va-befestigungskappe_1.png similarity index 100% rename from parts-3d-printing/variante-2_hamburg/va-hahn/va-befestigungskappe_1.png rename to variants/variante-2_hamburg/va-hahn/va-befestigungskappe_1.png diff --git a/parts-3d-printing/variante-2_hamburg/va-hahn/va-befestigungskappe_2.png b/variants/variante-2_hamburg/va-hahn/va-befestigungskappe_2.png similarity index 100% rename from parts-3d-printing/variante-2_hamburg/va-hahn/va-befestigungskappe_2.png rename to variants/variante-2_hamburg/va-hahn/va-befestigungskappe_2.png diff --git a/parts-3d-printing/variante-2_hamburg/va-hahn/va-befestigungskappe_3.png b/variants/variante-2_hamburg/va-hahn/va-befestigungskappe_3.png similarity index 100% rename from parts-3d-printing/variante-2_hamburg/va-hahn/va-befestigungskappe_3.png rename to variants/variante-2_hamburg/va-hahn/va-befestigungskappe_3.png diff --git a/parts-3d-printing/variante-2_hamburg/va-hahn/va-schieber.step b/variants/variante-2_hamburg/va-hahn/va-schieber.step similarity index 100% rename from parts-3d-printing/variante-2_hamburg/va-hahn/va-schieber.step rename to variants/variante-2_hamburg/va-hahn/va-schieber.step diff --git a/parts-3d-printing/variante-2_hamburg/va-hahn/verbindungskappe.stl b/variants/variante-2_hamburg/va-hahn/verbindungskappe.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/va-hahn/verbindungskappe.stl rename to variants/variante-2_hamburg/va-hahn/verbindungskappe.stl diff --git a/parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-hahn.stl b/variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-hahn.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-hahn.stl rename to variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-hahn.stl diff --git a/parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-halter.stl b/variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-halter.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-halter.stl rename to variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-halter.stl diff --git a/parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-modell.jpg b/variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-modell.jpg similarity index 100% rename from parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-modell.jpg rename to variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-modell.jpg diff --git a/parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-mutter.stl b/variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-mutter.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-mutter.stl rename to variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-mutter.stl diff --git a/parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schelle.stl b/variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schelle.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schelle.stl rename to variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schelle.stl diff --git a/parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieber.stl b/variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieber.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieber.stl rename to variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieber.stl diff --git a/parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieberarm.stl b/variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieberarm.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieberarm.stl rename to variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-schieberarm.stl diff --git a/parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-servoarm.stl b/variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-servoarm.stl similarity index 100% rename from parts-3d-printing/variante-2_hamburg/xxs-modell-mit-sg90/xxs-servoarm.stl rename to variants/variante-2_hamburg/xxs-modell-mit-sg90/xxs-servoarm.stl diff --git a/parts-3d-printing/variante-3_woerth/hanimandel-woerth-1.jpg b/variants/variante-3_woerth/hanimandel-woerth-1.jpg similarity index 100% rename from parts-3d-printing/variante-3_woerth/hanimandel-woerth-1.jpg rename to variants/variante-3_woerth/hanimandel-woerth-1.jpg diff --git a/parts-3d-printing/variante-3_woerth/hanimandel-woerth-2.jpg b/variants/variante-3_woerth/hanimandel-woerth-2.jpg similarity index 100% rename from parts-3d-printing/variante-3_woerth/hanimandel-woerth-2.jpg rename to variants/variante-3_woerth/hanimandel-woerth-2.jpg diff --git a/parts-3d-printing/variante-3_woerth/hanimandel-woerth-3.jpg b/variants/variante-3_woerth/hanimandel-woerth-3.jpg similarity index 100% rename from parts-3d-printing/variante-3_woerth/hanimandel-woerth-3.jpg rename to variants/variante-3_woerth/hanimandel-woerth-3.jpg diff --git a/parts-3d-printing/variante-3_woerth/hanimandel-woerth-4.jpg b/variants/variante-3_woerth/hanimandel-woerth-4.jpg similarity index 100% rename from parts-3d-printing/variante-3_woerth/hanimandel-woerth-4.jpg rename to variants/variante-3_woerth/hanimandel-woerth-4.jpg diff --git a/parts-3d-printing/variante-3_woerth/servo-arm-1.stl b/variants/variante-3_woerth/servo-arm-1.stl similarity index 100% rename from parts-3d-printing/variante-3_woerth/servo-arm-1.stl rename to variants/variante-3_woerth/servo-arm-1.stl diff --git a/parts-3d-printing/variante-3_woerth/servo-arm-2.stl b/variants/variante-3_woerth/servo-arm-2.stl similarity index 100% rename from parts-3d-printing/variante-3_woerth/servo-arm-2.stl rename to variants/variante-3_woerth/servo-arm-2.stl diff --git a/parts-3d-printing/variante-3_woerth/servo-halterung-1-oben.stl b/variants/variante-3_woerth/servo-halterung-1-oben.stl similarity index 100% rename from parts-3d-printing/variante-3_woerth/servo-halterung-1-oben.stl rename to variants/variante-3_woerth/servo-halterung-1-oben.stl diff --git a/parts-3d-printing/variante-3_woerth/servo-halterung-2-unten.stl b/variants/variante-3_woerth/servo-halterung-2-unten.stl similarity index 100% rename from parts-3d-printing/variante-3_woerth/servo-halterung-2-unten.stl rename to variants/variante-3_woerth/servo-halterung-2-unten.stl diff --git a/parts-3d-printing/variante-3_woerth/waage-1a-oben-oled1.3.stl b/variants/variante-3_woerth/waage-1a-oben-oled1.3.stl similarity index 100% rename from parts-3d-printing/variante-3_woerth/waage-1a-oben-oled1.3.stl rename to variants/variante-3_woerth/waage-1a-oben-oled1.3.stl diff --git a/parts-3d-printing/variante-3_woerth/waage-1b-oben-oled0.96.stl b/variants/variante-3_woerth/waage-1b-oben-oled0.96.stl similarity index 100% rename from parts-3d-printing/variante-3_woerth/waage-1b-oben-oled0.96.stl rename to variants/variante-3_woerth/waage-1b-oben-oled0.96.stl diff --git a/parts-3d-printing/variante-3_woerth/waage-2-waageplattform.stl b/variants/variante-3_woerth/waage-2-waageplattform.stl similarity index 100% rename from parts-3d-printing/variante-3_woerth/waage-2-waageplattform.stl rename to variants/variante-3_woerth/waage-2-waageplattform.stl diff --git a/parts-3d-printing/variante-3_woerth/waage-3-unten.stl b/variants/variante-3_woerth/waage-3-unten.stl similarity index 100% rename from parts-3d-printing/variante-3_woerth/waage-3-unten.stl rename to variants/variante-3_woerth/waage-3-unten.stl diff --git a/parts-3d-printing/variante-5_dresden/hanimandl-dresden-1.jpg b/variants/variante-5_dresden/hanimandl-dresden-1.jpg similarity index 100% rename from parts-3d-printing/variante-5_dresden/hanimandl-dresden-1.jpg rename to variants/variante-5_dresden/hanimandl-dresden-1.jpg diff --git a/parts-3d-printing/variante-5_dresden/hanimandl-dresden-2.jpg b/variants/variante-5_dresden/hanimandl-dresden-2.jpg similarity index 100% rename from parts-3d-printing/variante-5_dresden/hanimandl-dresden-2.jpg rename to variants/variante-5_dresden/hanimandl-dresden-2.jpg diff --git a/parts-3d-printing/variante-5_dresden/hanimandl-dresden-3.jpg b/variants/variante-5_dresden/hanimandl-dresden-3.jpg similarity index 100% rename from parts-3d-printing/variante-5_dresden/hanimandl-dresden-3.jpg rename to variants/variante-5_dresden/hanimandl-dresden-3.jpg diff --git a/parts-3d-printing/variante-5_dresden/hanimandl-dresden-4.jpg b/variants/variante-5_dresden/hanimandl-dresden-4.jpg similarity index 100% rename from parts-3d-printing/variante-5_dresden/hanimandl-dresden-4.jpg rename to variants/variante-5_dresden/hanimandl-dresden-4.jpg diff --git a/parts-3d-printing/variante-5_dresden/hanimandl-dresden-5.jpg b/variants/variante-5_dresden/hanimandl-dresden-5.jpg similarity index 100% rename from parts-3d-printing/variante-5_dresden/hanimandl-dresden-5.jpg rename to variants/variante-5_dresden/hanimandl-dresden-5.jpg diff --git a/parts-3d-printing/variante-5_dresden/hanimandl-dresden-6.jpg b/variants/variante-5_dresden/hanimandl-dresden-6.jpg similarity index 100% rename from parts-3d-printing/variante-5_dresden/hanimandl-dresden-6.jpg rename to variants/variante-5_dresden/hanimandl-dresden-6.jpg diff --git a/parts-3d-printing/variante-5_dresden/hanimandl-dresden-7.jpg b/variants/variante-5_dresden/hanimandl-dresden-7.jpg similarity index 100% rename from parts-3d-printing/variante-5_dresden/hanimandl-dresden-7.jpg rename to variants/variante-5_dresden/hanimandl-dresden-7.jpg diff --git a/parts-3d-printing/variante-5_dresden/readme.md b/variants/variante-5_dresden/readme.md similarity index 100% rename from parts-3d-printing/variante-5_dresden/readme.md rename to variants/variante-5_dresden/readme.md diff --git a/wiring-fritzing/hani-mandl-wiring_esp32_v0.2_experimental.fzz b/wiring/fritzing/hani-mandl-wiring_esp32_v0.2_experimental.fzz similarity index 100% rename from wiring-fritzing/hani-mandl-wiring_esp32_v0.2_experimental.fzz rename to wiring/fritzing/hani-mandl-wiring_esp32_v0.2_experimental.fzz diff --git a/wiring-fritzing/hani-mandl-wiring_esp32_v0.2_experimental.png b/wiring/fritzing/hani-mandl-wiring_esp32_v0.2_experimental.png similarity index 100% rename from wiring-fritzing/hani-mandl-wiring_esp32_v0.2_experimental.png rename to wiring/fritzing/hani-mandl-wiring_esp32_v0.2_experimental.png diff --git a/wiring-fritzing/hani-mandl-wiring_heltec_v0.5_netzteil.fzz b/wiring/fritzing/hani-mandl-wiring_heltec_v0.5_netzteil.fzz similarity index 100% rename from wiring-fritzing/hani-mandl-wiring_heltec_v0.5_netzteil.fzz rename to wiring/fritzing/hani-mandl-wiring_heltec_v0.5_netzteil.fzz diff --git a/wiring-fritzing/hani-mandl-wiring_heltec_v0.5_netzteil.png b/wiring/fritzing/hani-mandl-wiring_heltec_v0.5_netzteil.png similarity index 100% rename from wiring-fritzing/hani-mandl-wiring_heltec_v0.5_netzteil.png rename to wiring/fritzing/hani-mandl-wiring_heltec_v0.5_netzteil.png diff --git a/wiring-fritzing/hani-mandl-wiring_heltec_v0.5_usb.fzz b/wiring/fritzing/hani-mandl-wiring_heltec_v0.5_usb.fzz similarity index 100% rename from wiring-fritzing/hani-mandl-wiring_heltec_v0.5_usb.fzz rename to wiring/fritzing/hani-mandl-wiring_heltec_v0.5_usb.fzz diff --git a/wiring-fritzing/hani-mandl-wiring_heltec_v0.5_usb.png b/wiring/fritzing/hani-mandl-wiring_heltec_v0.5_usb.png similarity index 100% rename from wiring-fritzing/hani-mandl-wiring_heltec_v0.5_usb.png rename to wiring/fritzing/hani-mandl-wiring_heltec_v0.5_usb.png diff --git a/wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.fzz b/wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.fzz similarity index 100% rename from wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.fzz rename to wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.fzz diff --git a/wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.png b/wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.png similarity index 100% rename from wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.png rename to wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_pot.png diff --git a/wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.fzz b/wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.fzz similarity index 100% rename from wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.fzz rename to wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.fzz diff --git a/wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.jpg b/wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.jpg similarity index 100% rename from wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.jpg rename to wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-and-v2_rotary.jpg diff --git a/wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-only_pot.fzz b/wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-only_pot.fzz similarity index 100% rename from wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-only_pot.fzz rename to wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-only_pot.fzz diff --git a/wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-only_pot.png b/wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-only_pot.png similarity index 100% rename from wiring-fritzing/historic/hani-mandl-wiring_heltec-v1-only_pot.png rename to wiring/fritzing/historic/hani-mandl-wiring_heltec-v1-only_pot.png