From c99d91c8e4d75b04c5668775a48b12e49d0e967c Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <Hieromon@users.noreply.github.com>
Date: Wed, 20 Feb 2019 23:14:31 +0900
Subject: [PATCH] Under the work of v0.9.7 documentation

---
 docs/404.html                 |   22 +-
 docs/acelements.html          |   22 +-
 docs/achandling.html          |  144 ++++-
 docs/acintro.html             |   22 +-
 docs/acjson.html              |   67 +-
 docs/advancedusage.html       |   40 +-
 docs/api.html                 |   77 ++-
 docs/apiaux.html              |  187 +++++-
 docs/apiconfig.html           |   70 ++-
 docs/apielements.html         |  358 +++++++++--
 docs/apiextra.html            |   22 +-
 docs/basicusage.html          |   22 +-
 docs/changelog.html           |   22 +-
 docs/css/paragraph.css        |   12 +-
 docs/datatips.html            | 1076 +++++++++++++++++++++++++++++++++
 docs/faq.html                 |   50 +-
 docs/gettingstarted.html      |   22 +-
 docs/howtoembed.html          |   26 +-
 docs/images/arrow_down.png    |  Bin 0 -> 1176 bytes
 docs/images/aux_fsbrowser.gif |  Bin 164821 -> 248651 bytes
 docs/images/aux_ov.gif        |  Bin 193853 -> 126888 bytes
 docs/images/aux_pattern.gif   |  Bin 0 -> 41374 bytes
 docs/index.html               |   24 +-
 docs/js/gifffer.min.js        |    2 +-
 docs/license.html             |   22 +-
 docs/menu.html                |   26 +-
 docs/menuize.html             |   45 +-
 docs/search/search_index.json |    2 +-
 docs/sitemap.xml              |   47 +-
 docs/sitemap.xml.gz           |  Bin 353 -> 357 bytes
 docs/wojson.html              | 1056 ++++++++++++++++++++++++++++++++
 mkdocs.yml                    |    2 +-
 mkdocs/advancedusage.md       |   10 +-
 mkdocs/menu.md                |    4 +-
 mkdocs/menuize.md             |    4 +-
 35 files changed, 3197 insertions(+), 308 deletions(-)
 create mode 100644 docs/datatips.html
 create mode 100644 docs/images/arrow_down.png
 create mode 100644 docs/images/aux_pattern.gif
 create mode 100644 docs/wojson.html

diff --git a/docs/404.html b/docs/404.html
index de5bc09..4d337d2 100644
--- a/docs/404.html
+++ b/docs/404.html
@@ -71,6 +71,8 @@
     
       <link rel="stylesheet" href="/AutoConnect/css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -572,8 +574,20 @@
 
 
   <li class="md-nav__item">
-    <a href="/AutoConnect/datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="/AutoConnect/datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="/AutoConnect/menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -584,8 +598,8 @@
 
 
   <li class="md-nav__item">
-    <a href="/AutoConnect/menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="/AutoConnect/wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
diff --git a/docs/acelements.html b/docs/acelements.html
index 024c5f6..56c9868 100644
--- a/docs/acelements.html
+++ b/docs/acelements.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -1020,8 +1022,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -1032,8 +1046,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
diff --git a/docs/achandling.html b/docs/achandling.html
index 1b34148..a81cd4b 100644
--- a/docs/achandling.html
+++ b/docs/achandling.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -556,8 +558,8 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#over-typing-with-loadelement-function" title=" Over typing ​​with LoadElement function" class="md-nav__link">
-     Over typing ​​with LoadElement function
+  <a href="#overwrite-the-autoconnectelements" title=" Overwrite the AutoConnectElements" class="md-nav__link">
+     Overwrite the AutoConnectElements
   </a>
   
 </li>
@@ -589,6 +591,13 @@
     <nav class="md-nav">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#scope-lifetime-of-autoconnectaux" title="Scope &amp; Lifetime of AutoConnectAux" class="md-nav__link">
+    Scope &amp; Lifetime of AutoConnectAux
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#the-uri-of-the-custom-web-pages" title="The URI of the custom Web pages" class="md-nav__link">
     The URI of the custom Web pages
@@ -745,8 +754,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -757,8 +778,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -906,8 +927,8 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#over-typing-with-loadelement-function" title=" Over typing ​​with LoadElement function" class="md-nav__link">
-     Over typing ​​with LoadElement function
+  <a href="#overwrite-the-autoconnectelements" title=" Overwrite the AutoConnectElements" class="md-nav__link">
+     Overwrite the AutoConnectElements
   </a>
   
 </li>
@@ -939,6 +960,13 @@
     <nav class="md-nav">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#scope-lifetime-of-autoconnectaux" title="Scope &amp; Lifetime of AutoConnectAux" class="md-nav__link">
+    Scope &amp; Lifetime of AutoConnectAux
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#the-uri-of-the-custom-web-pages" title="The URI of the custom Web pages" class="md-nav__link">
     The URI of the custom Web pages
@@ -1292,7 +1320,7 @@
 <span style="color: #f8f8f2">}</span>
 </pre></div>
 
-<p>The above example handles in the handler for the values of a custom web page. An <a href="api.html#on">AutoConnect::on</a> function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the <a href="https://github.com/Hieromon/PageBuilder#arguments-of-invoked-user-function">PageArgument</a> object.</p>
+<p>The above example handles in the handler for the values of a custom Web page. An <a href="api.html#on">AutoConnect::on</a> function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the <a href="https://github.com/Hieromon/PageBuilder#arguments-of-invoked-user-function">PageArgument</a> object.</p>
 <p>To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the <a href="api.html#where">AutoConnect::where</a> function. The <code>AutoConnect::where</code> function returns a pointer to the AutoConnectAux object of the custom Web page that caused the HTTP request.</p>
 <div class="admonition note">
 <p class="admonition-title">The where() function is available for only AutoConnectAux.</p>
@@ -1414,11 +1442,94 @@ ESP8266WebServer class will parse the query string and rebuilds its arguments wh
 <span style="color: #f8f8f2">portal.begin();</span>
 </pre></div>
 
-<h3 id="over-typing-with-loadelement-function"><i class="fa fa-wpforms"></i> Over typing ​​with LoadElement function<a class="headerlink" href="#over-typing-with-loadelement-function" title="Permanent link">&para;</a></h3>
-<p>The <a href="apiaux.html#loadelement">AutoConnectAux::loadElement</a> function overwrites its value when loading an AutoConnectElement. If the loadElement function wields an element with an input value, the previous value will be lost by the loaded value. If you need to preserve input values ​​even during page transition operations, we recommend that you load parameters only once at an early stage in the <code>setup()</code> of sketches.</p>
-<h3 id="check-data-against-on-submission"><i class="fa fa-check-square"></i> Check data against on submission<a class="headerlink" href="#check-data-against-on-submission" title="Permanent link">&para;</a></h3>
+<h3 id="overwrite-the-autoconnectelements"><i class="fa fa-wpforms"></i> Overwrite the AutoConnectElements<a class="headerlink" href="#overwrite-the-autoconnectelements" title="Permanent link">&para;</a></h3>
+<p>Sketches can update the attributes of AutoConnectElements with two approaches. A one is to assign directly to the attributes of a member variable of its element. The other is to overwrite them with loading the element by <a href="apiaux.html#loadelement">AutoConnectAux::loadElement</a>. </p>
+<p>The elements for attributes described in the JSON document for AutoConnectElements overwrites the member variables of the target AutoConnectElements. However, AutoConnectAux::loadElement keeps the member variables unchanged if there is no element in the JSON document. This overwriting behavior is the same for the <a href="api.html#load">AutoConnect::load</a> function.</p>
+<p>For example, the combination of the sketch and JSON document as follows updates only the style while keeping Captiopn (ie. "Hello, world") as AutoConnectText value.</p>
+<p><i class="fa fa-code"></i> The sketch (part of code)</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">ACText(Caption,</span> <span style="color: #e6db74">&quot;Hello, world&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #a6e22e">helloPage</span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">&quot;/hello&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;Hello&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">true,</span> <span style="color: #f8f8f2">{</span> <span style="color: #f8f8f2">Caption</span> <span style="color: #f8f8f2">});</span>
+<span style="color: #f8f8f2">AutoConnect</span> <span style="color: #f8f8f2">portal;</span>
+
+<span style="color: #f8f8f2">String</span> <span style="color: #a6e22e">onHello</span><span style="color: #f8f8f2">(AutoConnectAux</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">aux,</span> <span style="color: #f8f8f2">PageArgument</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">args)</span> <span style="color: #f8f8f2">{</span>
+  <span style="color: #f8f8f2">aux.loadElement(JSON);</span>
+  <span style="color: #66d9ef">return</span> <span style="color: #f8f8f2">String();</span>
+<span style="color: #f8f8f2">}</span>
+
+<span style="color: #66d9ef">void</span> <span style="color: #a6e22e">setup</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
+  <span style="color: #f8f8f2">helloPage.on(onHello);</span>
+  <span style="color: #f8f8f2">portal.join(helloPage);</span>
+  <span style="color: #f8f8f2">portal.begin();</span>
+<span style="color: #f8f8f2">}</span>
+
+<span style="color: #66d9ef">void</span> <span style="color: #a6e22e">loop</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
+  <span style="color: #f8f8f2">portal.handleClient();</span>
+<span style="color: #f8f8f2">}</span>
+</pre></div>
+
+<p><i class="fab fa-js-square"></i> External JSON document for the above sketch to modify the text style
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">{</span>
+  <span style="color: #f92672">&quot;name&quot;</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Caption&quot;</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;type&quot;</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACText&quot;</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;style&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;text-align:center;font-family:&#39;Avenir&#39;,&#39;Corbel&#39;,&#39;Osaka&#39;;color:Green;&quot;</span>
+<span style="color: #f8f8f2">}</span>
+</pre></div></p>
+<h3 id="check-data-against-on-submission"><i class="far fa-check-square"></i> Check data against on submission<a class="headerlink" href="#check-data-against-on-submission" title="Permanent link">&para;</a></h3>
+<p>By giving a <a href="apielements.html#pattern">pattern</a> to <a href="apielements.html#autoconenctinput">AutoConnectInput</a>, you can find errors in data styles while typing in custom Web pages. The pattern is specified by <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions">regular expression</a>.<sup id="fnref:2"><a class="footnote-ref" href="#fn:2" rel="footnote">2</a></sup> If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. The following example shows the behavior when checking the IP address in the AutoConnectInput field.</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">{</span>
+  <span style="color: #f92672">&quot;title&quot;</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Page-1&quot;</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;uri&quot;</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;/page1&quot;</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;menu&quot;</span> <span style="color: #f8f8f2">:</span> <span style="color: #66d9ef">true</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;element&quot;</span> <span style="color: #f8f8f2">:</span> <span style="color: #f8f8f2">[</span>
+    <span style="color: #f8f8f2">{</span>
+      <span style="color: #f92672">&quot;name&quot;</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Server&quot;</span><span style="color: #f8f8f2">,</span>
+      <span style="color: #f92672">&quot;type&quot;</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACInput&quot;</span><span style="color: #f8f8f2">,</span>
+      <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Server address&quot;</span><span style="color: #f8f8f2">,</span>
+<span style="background-color: #49483e">      <span style="color: #f92672">&quot;pattern&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$&quot;</span>
+</span>    <span style="color: #f8f8f2">}</span>
+  <span style="color: #f8f8f2">]</span>
+<span style="color: #f8f8f2">}</span>
+</pre></div>
+
+<div>
+  <span style="display:block;margin-left:136px;"><img width="32px" height="32xp" src="./images/arrow_down.png"></span>
+  <span style="display:block;width:306px;height:136px;border:1px solid lightgrey;"><img data-gifffer="./images/aux_pattern.gif" data-gifffer-height="134" data-gifffer-width="304" /></span>
+</div>
+
 <h3 id="convert-data-to-actually-type"><i class="fa fa-exchange"></i> Convert data to actually type<a class="headerlink" href="#convert-data-to-actually-type" title="Permanent link">&para;</a></h3>
 <h2 id="transitions-of-the-custom-web-pages">Transitions of the custom Web pages<a class="headerlink" href="#transitions-of-the-custom-web-pages" title="Permanent link">&para;</a></h2>
+<h3 id="scope-lifetime-of-autoconnectaux">Scope &amp; Lifetime of AutoConnectAux<a class="headerlink" href="#scope-lifetime-of-autoconnectaux" title="Permanent link">&para;</a></h3>
+<p>The lifetime of AutoConnectAux and AutoConnectElements must remain in the period when the custom Web page can be manipulated. The implementation of the custom Web page inherits from requestHandler driven from ESP8266WebServer (WebServer for ESP32), so the instance of AutoConnectAux and AutoConnectElements must exist for the duration of effect of handleClient. The following example is incorrect for manipulating custom Web pages. Its AutoConnectAux instance will be destructed at the exit of the setup().</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;ESP8266WiFi.h&gt;</span>
+<span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;ESP8266WebServer.h&gt;</span>
+<span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;AutoConnect.h&gt;</span>
+
+<span style="color: #66d9ef">static</span> <span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">auxPage[]</span> <span style="color: #f8f8f2">PROGMEM</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">R&quot;raw(</span>
+<span style="color: #e6db74">{</span>
+<span style="color: #e6db74">  &quot;title&quot;: &quot;Page-1&quot;,</span>
+<span style="color: #e6db74">  &quot;uri&quot;: &quot;/page1&quot;,</span>
+<span style="color: #e6db74">  &quot;menu&quot;: true,</span>
+<span style="color: #e6db74">  &quot;element&quot;: [</span>
+<span style="color: #e6db74">    { &quot;name&quot;:&quot;Server&quot;, &quot;type&quot;:&quot;ACText&quot;, &quot;label&quot;:&quot;Server address&quot; }</span>
+<span style="color: #e6db74">  ]</span>
+<span style="color: #e6db74">}</span>
+<span style="color: #e6db74">)raw&quot;</span><span style="color: #f8f8f2">;</span>
+
+<span style="color: #f8f8f2">AutoConnect</span>  <span style="color: #f8f8f2">portal;</span>
+
+<span style="color: #66d9ef">void</span> <span style="color: #a6e22e">setup</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
+  <span style="color: #75715e">// This declaration is wrong.</span>
+<span style="background-color: #49483e">  <span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #f8f8f2">aux;</span>
+</span>  <span style="color: #f8f8f2">aux.load(auxPage);</span>
+  <span style="color: #f8f8f2">portal.join(aux);</span>
+  <span style="color: #f8f8f2">portal.begin();</span>
+<span style="color: #f8f8f2">}</span>
+
+<span style="color: #66d9ef">void</span> <span style="color: #a6e22e">loop</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
+  <span style="color: #f8f8f2">portal.handleClient();</span>
+<span style="color: #f8f8f2">}</span>
+</pre></div>
+
 <h3 id="the-uri-of-the-custom-web-pages">The URI of the custom Web pages<a class="headerlink" href="#the-uri-of-the-custom-web-pages" title="Permanent link">&para;</a></h3>
 <p>The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the <em>ESP8266WebServer::on</em>/<em>WebServer::on</em> function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the <a href="apiaux.html#on">AutoConnectAux::on</a> function.</p>
 <p>In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section.</p>
@@ -1446,12 +1557,21 @@ ESP8266WebServer class will parse the query string and rebuilds its arguments wh
 <p class="admonition-title">302 Redirect Alternatives</p>
 <p>To transition from a custom Web page to a sketch owned page, execute the link function of JavaScript with the AutoConnectElement element.</p>
 </div>
+<script>
+  window.onload = function() {
+    Gifffer();
+  };
+</script>
+
 <div class="footnote">
 <hr />
 <ol>
 <li id="fn:1">
 <p>The valid scope of the name is within an AutoConnectAux.&#160;<a class="footnote-backref" href="#fnref:1" rev="footnote" title="Jump back to footnote 1 in the text">&#8617;</a></p>
 </li>
+<li id="fn:2">
+<p>The pattern of AutoConnectInput conforms to javascript specification.&#160;<a class="footnote-backref" href="#fnref:2" rev="footnote" title="Jump back to footnote 2 in the text">&#8617;</a></p>
+</li>
 </ol>
 </div>
                 
diff --git a/docs/acintro.html b/docs/acintro.html
index 006ffda..c1e771e 100644
--- a/docs/acintro.html
+++ b/docs/acintro.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -658,8 +660,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -670,8 +684,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
diff --git a/docs/acjson.html b/docs/acjson.html
index b8bb40e..4b49ffb 100644
--- a/docs/acjson.html
+++ b/docs/acjson.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -115,7 +117,7 @@
     <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
     <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
     
-      <a href="#describe-custom-web-pages-with-json" tabindex="1" class="md-skip">
+      <a href="#json-objects-elements-for-the-custom-web-page" tabindex="1" class="md-skip">
         Skip to content
       </a>
     
@@ -460,13 +462,6 @@
     <label class="md-nav__title" for="__toc">Table of contents</label>
     <ul class="md-nav__list" data-md-scrollfix>
       
-        <li class="md-nav__item">
-  <a href="#describe-custom-web-pages-with-json" title="Describe custom Web pages with JSON" class="md-nav__link">
-    Describe custom Web pages with JSON
-  </a>
-  
-</li>
-      
         <li class="md-nav__item">
   <a href="#json-objects-elements-for-the-custom-web-page" title="JSON objects &amp; elements for the custom Web page" class="md-nav__link">
     JSON objects &amp; elements for the custom Web page
@@ -781,8 +776,8 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
     </a>
   </li>
 
@@ -793,8 +788,20 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -858,13 +865,6 @@
     <label class="md-nav__title" for="__toc">Table of contents</label>
     <ul class="md-nav__list" data-md-scrollfix>
       
-        <li class="md-nav__item">
-  <a href="#describe-custom-web-pages-with-json" title="Describe custom Web pages with JSON" class="md-nav__link">
-    Describe custom Web pages with JSON
-  </a>
-  
-</li>
-      
         <li class="md-nav__item">
   <a href="#json-objects-elements-for-the-custom-web-page" title="JSON objects &amp; elements for the custom Web page" class="md-nav__link">
     JSON objects &amp; elements for the custom Web page
@@ -1049,13 +1049,12 @@
                 
                   <h1>Custom Web pages with JSON</h1>
                 
-                <h2 id="describe-custom-web-pages-with-json">Describe custom Web pages with JSON<a class="headerlink" href="#describe-custom-web-pages-with-json" title="Permanent link">&para;</a></h2>
-<p>You can embed custom Web pages written in <a href="https://www.json.org/index.html"><strong>JSON</strong></a> into AutoConnect without declaring AutoConnectAux &amp; AutoConnectElements in sketches. Custom Web page declaration in JSON can be included in the sketch in advance as the fixed string, or it can be stored in the external file such as SPIFFS for stream loading. You can also load and save AutoConnectElements objects individually.<sup id="fnref:1"><a class="footnote-ref" href="#fn:1" rel="footnote">1</a></sup></p>
+                <p>You can embed custom Web pages written in <a href="https://www.json.org/index.html"><strong>JSON</strong></a> into AutoConnect without declaring AutoConnectAux &amp; AutoConnectElements in sketches. Custom Web page declaration in JSON can be included in the sketch in advance as the fixed string, or it can be stored in the external file such as SPIFFS for stream loading. You can also load and save AutoConnectElements objects individually.<sup id="fnref:1"><a class="footnote-ref" href="#fn:1" rel="footnote">1</a></sup></p>
 <p>By providing the following JSON document to AutoConnect, you can include the custom Web page as the bellow:</p>
 <div style="float:left;width:50%;height:470px;overflow:auto"><img src="./images/ac_json.png"></div>
 
 <p><img style="margin-left:30px;width:40%;height:470px;" src="./images/ac_mqtt_setting.png"></p>
-<p>A JSON document for AutoConnect can also contain declarations of multiple custom web pages. If you fit those multiple pages in one JSON document, sketch processing for loading AutoConnectAux will degenerate further.</p>
+<p>A JSON document for AutoConnect can also contain declarations of multiple custom Web pages. If you fit those multiple pages in one JSON document, sketch processing for loading AutoConnectAux will degenerate further.</p>
 <div class="admonition caution">
 <p class="admonition-title">Need ArduinoJson v5</p>
 <p>To process the AutoConnectAux &amp; AutoConnectElements written in the JSON is you need to install the <a href="https://arduinojson.org/v5/doc/installation/">ArduinoJson version 5</a> library.</p>
@@ -1077,11 +1076,11 @@
 </dl>
 <h4 id="uri"><i class="fa fa-key"></i> <strong>uri</strong><a class="headerlink" href="#uri" title="Permanent link">&para;</a></h4>
 <dl>
-<dd>String of URI path that specifies where to place the custom web page. It needs to be a location from the root path including '<strong>/</strong>'.</dd>
+<dd>String of URI path that specifies where to place the custom Web page. It needs to be a location from the root path including '<strong>/</strong>'.</dd>
 </dl>
 <h4 id="menu"><i class="fa fa-key"></i> <strong>menu</strong><a class="headerlink" href="#menu" title="Permanent link">&para;</a></h4>
 <dl>
-<dd>This is a Boolean value indicating whether to include the custom web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu.</dd>
+<dd>This is a Boolean value indicating whether to include the custom Web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu.</dd>
 </dl>
 <h4 id="element"><i class="fa fa-key"></i> <strong>element</strong><a class="headerlink" href="#element" title="Permanent link">&para;</a></h4>
 <dl>
@@ -1089,7 +1088,7 @@
 </dl>
 <div class="admonition note">
 <p class="admonition-title">Order of elements on a custom Web page</p>
-<p>The order in which AutoConnectElements are placed on a custom web page is the order in the JSON document.</p>
+<p>The order in which AutoConnectElements are placed on a custom Web page is the order in the JSON document.</p>
 </div>
 <h3 id="multiple-custom-web-pages-declaration-in-json-document"><i class="fa fa-copy"></i> Multiple custom Web pages declaration in JSON document<a class="headerlink" href="#multiple-custom-web-pages-declaration-in-json-document" title="Permanent link">&para;</a></h3>
 <p>You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages:</p>
@@ -1145,16 +1144,12 @@
 
 <h3 id="json-object-for-autoconnectelements"><i class="fa fa-caret-right"></i> JSON object for AutoConnectElements<a class="headerlink" href="#json-object-for-autoconnectelements" title="Permanent link">&para;</a></h3>
 <p>AutoConnectElements in JSON description are described as an array in the <code>element</code> with arguments of each <a href="acelements.html#constructor">constructor</a>.</p>
-<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>&quot;element&quot; : [
-  {
-    &quot;name&quot; : name,
-    &quot;type&quot; : type,
-    key_according_to_type : the_value | array_of_value , key_according_to_type : the_value | array_of_value
-  },
-  {
-    the_nect_element
-  }
-]
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>{
+  &quot;name&quot; : name,
+  &quot;type&quot; : type,
+  key_according_to_type : the_value | array_of_value,
+  [ key_according_to_type : the_value | array_of_value ]
+}
 </pre></div>
 
 <h4 id="name"><i class="fa fa-key"></i> <strong>name</strong><a class="headerlink" href="#name" title="Permanent link">&para;</a></h4>
@@ -1377,7 +1372,7 @@ An example of using each function is as follows.
 </pre></div></p>
 <p>AutoConnect passes the given JSON document directly to the <a href="https://arduinojson.org/v5/api/jsonbuffer/parseobject/"><strong>parseObject()</strong></a> function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory.</p>
 <h2 id="saving-json-document">Saving JSON document<a class="headerlink" href="#saving-json-document" title="Permanent link">&para;</a></h2>
-<p>However, AutoConnect does not support saving AutoConnectAux as a whole custom Web page. If you want to persist an AutoConnectElements object, you need to save it as an AutoConenctElement object unit. AutoConnectAux has a <a href="achandling.html#saving-autoconnectelements">function</a> to write multiple elements to the stream in a batch.</p>
+<p>The sketch can persist AutoConnectElements as a JSON document and also uses <a href="achandling.html#saving-autoconnectelements-with-json">this function</a> to save the values ​​entered on the custom Web page. And you can reload the saved JSON document into AutoConnectElements as the field in a custom Web page using the <a href="achandling.html#loading-autoconnectaux-autoconnectelements-with-json">load function</a>. </p>
 <div class="footnote">
 <hr />
 <ol>
diff --git a/docs/advancedusage.html b/docs/advancedusage.html
index b13a0f3..638a626 100644
--- a/docs/advancedusage.html
+++ b/docs/advancedusage.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -445,8 +447,8 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#cast-items-of-your-sketch-own-into-the-autoccnnect-menu" title=" Cast items of your sketch own into the AutocCnnect menu" class="md-nav__link">
-     Cast items of your sketch own into the AutocCnnect menu
+  <a href="#cast-the-legacy-html-pages-as-the-add-on-menu-items" title=" Cast the legacy HTML pages as the add-on menu items" class="md-nav__link">
+     Cast the legacy HTML pages as the add-on menu items
   </a>
   
 </li>
@@ -778,8 +780,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -790,8 +804,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -899,8 +913,8 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#cast-items-of-your-sketch-own-into-the-autoccnnect-menu" title=" Cast items of your sketch own into the AutocCnnect menu" class="md-nav__link">
-     Cast items of your sketch own into the AutocCnnect menu
+  <a href="#cast-the-legacy-html-pages-as-the-add-on-menu-items" title=" Cast the legacy HTML pages as the add-on menu items" class="md-nav__link">
+     Cast the legacy HTML pages as the add-on menu items
   </a>
   
 </li>
@@ -1182,18 +1196,18 @@ Also, if you want to stop AutoConnect completely when the captive portal is time
 <span style="color: #f8f8f2">}</span>
 </pre></div>
 
-<h3 id="cast-items-of-your-sketch-own-into-the-autoccnnect-menu"><i class="fa fa-caret-right"></i> Cast items of your sketch own into the AutocCnnect menu<a class="headerlink" href="#cast-items-of-your-sketch-own-into-the-autoccnnect-menu" title="Permanent link">&para;</a></h3>
-<p>If your sketch is handling your own web page, you can call that page from the <a href="menu.html">AutoConnect menu</a>. Unlike the custom Web pages by <a href="apiaux.html#autoconnectaux">AutoConnectAux</a>, this allows AutoConnect menu to legacy web pages registered by <em>ESP8266WebServer::on</em>/<em>WebServer::on</em> function.</p>
-<p>To implement this with your sketch, use only the <a href="apiaux.html#autoconnectaux">AutoConnectAux</a> constructed with the URI of that page. <a href="acelements.html">AutoConnectElements</a> is not required. The basic procedure for this as follows. </p>
+<h3 id="cast-the-legacy-html-pages-as-the-add-on-menu-items"><i class="fa fa-caret-right"></i> Cast the legacy HTML pages as the add-on menu items<a class="headerlink" href="#cast-the-legacy-html-pages-as-the-add-on-menu-items" title="Permanent link">&para;</a></h3>
+<p>If your sketch handles web pages, you can embed the pages into the AutoConnect menu with keeping the WiFi connection feature. Unlike the custom Web pages by <a href="apiaux.html#autoconnectaux">AutoConnectAux</a>, this allows to legacy web pages registered by <em>ESP8266WebServer::on</em> or <em>WebServer::on</em> function.</p>
+<p>To implement embedding the your sketch web pages, use only the <a href="apiaux.html#autoconnectaux">AutoConnectAux</a> constructed with the URI of that page. <a href="acelements.html">AutoConnectElements</a> is not required. The basic procedure for this as follows:</p>
 <ol>
 <li>Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu.</li>
-<li>Sketch legacy page handlers.</li>
+<li>Sketch the legacy page handlers.</li>
 <li>Register those handler functions to ESP8266WebServer/WebServer with the <strong>on</strong> function.</li>
 <li>Register AutoConnectAux declared with #1 to AutoConnect using <a href="api.html#join">AutoConnect::join</a> function. It serves as a menu item.</li>
 <li><a href="api.html#begin">Begin</a> the portal.</li>
 <li>Performs <a href="api.html#handleClient">AutoConnect::handleClient</a> in the <strong>loop</strong> function.</li>
 </ol>
-<p>For details see the <a href="menuize.html">Constructing menu</a> section of Examples page.</p>
+<p>For details see the <a href="menuize.html">Constructing the menu</a> section of Examples page.</p>
 <h3 id="change-menu-title"><i class="fa fa-caret-right"></i> Change menu title<a class="headerlink" href="#change-menu-title" title="Permanent link">&para;</a></h3>
 <p>Although the default menu title is <strong>AutoConnect</strong>, you can change the title by setting <a href="apiconfig.html#title">AutoConnectConfig::title</a>. To set the menu title properly, you must set before calling <a href="api.html#begin">AutoConnect::begin</a>.</p>
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConnect</span>       <span style="color: #f8f8f2">Portal;</span>
diff --git a/docs/api.html b/docs/api.html
index af75009..b075585 100644
--- a/docs/api.html
+++ b/docs/api.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -767,8 +769,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -779,8 +793,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -1070,7 +1084,7 @@
 <p>The <a href="api.html#handleclient"><strong>handleClient</strong></a> function of AutoConnect can include the response of the URI handler added by the user using the "<em>on</em>" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the <a href="api.html#host"><strong>host</strong></a> function.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">webServer</span>A reference of ESP8266WebServer or WebServer instance.</dd>
+    <dd><span class="apidef">webServer</span><span class="apidesc">A reference of ESP8266WebServer or WebServer instance.</span></dd>
 </dl></p>
 <h2 id="public-member-functions"><i class="fa fa-code"></i> Public member functions<a class="headerlink" href="#public-member-functions" title="Permanent link">&para;</a></h2>
 <h3 id="aux"><i class="fa fa-caret-right"></i> aux<a class="headerlink" href="#aux" title="Permanent link">&para;</a></h3>
@@ -1079,7 +1093,7 @@
 Returns a pointer to AutoConnectAux with the URI specified by <em>uri</em>. If AutoConnectAux with that URI is not bound, it returns <strong>nullptr</strong>.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">uri</span>A string of the URI.</dd>
+    <dd><span class="apidef">uri</span><span class="apidesc">A string of the URI.</span></dd>
     <dt><strong>Return value</strong></dt>
     <dd>A Pointer of the AutoConnectAux instance.</dd>
 </dl></p>
@@ -1095,12 +1109,12 @@ AutoConnect first invokes <em>WiFi.begin</em>. If the <em>ssid</em> and the <em>
 The captive portal will not be started if the connection has been established with first <em>WiFi.begin</em>. If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">ssid</span>SSID to be connected.</dd>
-    <dd><span class="apidef">passphrase</span>Password for connection.</dd>
-    <dd><span class="apidef">timeout</span>A time out value in milliseconds for waiting connection.</dd>
+    <dd><span class="apidef">ssid</span><span class="apidesc">SSID to be connected.</span></dd>
+    <dd><span class="apidef">passphrase</span><span class="apidesc">Password for connection.</span></dd>
+    <dd><span class="apidef">timeout</span><span class="apidesc">A time out value in milliseconds for waiting connection.</span></dd>
     <dt><strong>Return value</strong></dt>
-    <dd><span class="apidef">true</span>Connection established, AutoConnect service started with WIFI_STA mode.</dd>
-    <dd><span class="apidef">false</span>Could not connected, Captive portal started with WIFI_AP_STA mode.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">Connection established, AutoConnect service started with WIFI_STA mode.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">Could not connected, Captive portal started with WIFI_AP_STA mode.</span></dd>
 </dl></p>
 <h3 id="config"><i class="fa fa-caret-right"></i> config<a class="headerlink" href="#config" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">config(AutoConnectConfig</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">config)</span>
@@ -1110,12 +1124,12 @@ The captive portal will not be started if the connection has been established wi
 <p>Set SoftAP's WiFi configuration and static IP configuration. 
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">config</span>Reference to <a href="apiconfig.html"><strong>AutoConnectConfig</strong></a> containing SoftAP's parameters and static IP parameters.</dd>
-    <dd><span class="apidef">ap</span>SSID for SoftAP. The default value is <strong>esp8266ap</strong> for ESP8266, <strong>esp32ap</strong> for ESP32.</dd>
-    <dd><span class="apidef">password</span>Password for SodtAP. The default value is <strong>12345678</strong>.</dd>
+    <dd><span class="apidef">config</span><span class="apidesc">Reference to <a href="apiconfig.html"><strong>AutoConnectConfig</strong></a> containing SoftAP's parameters and static IP parameters.</span></dd>
+    <dd><span class="apidef">ap</span><span class="apidesc">SSID for SoftAP. The default value is <strong>esp8266ap</strong> for ESP8266, <strong>esp32ap</strong> for ESP32.</span></dd>
+    <dd><span class="apidef">password</span><span class="apidesc">Password for SodtAP. The default value is <strong>12345678</strong>.</span></dd>
     <dt><strong>Return value</strong></dt>
-    <dd><span class="apidef">true</span>Successfully configured.</dd>
-    <dd><span class="apidef">false</span>Configuration parameter is invalid, some values out of range.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">Successfully configured.</span></dd>
+    <dd><span class="apidef">false</span><span class="aidesc">Configuration parameter is invalid, some values out of range.</span></dd>
 </dl></p>
 <h3 id="end"><i class="fa fa-caret-right"></i> end<a class="headerlink" href="#end" title="Permanent link">&para;</a></h3>
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">end()</span>
@@ -1141,13 +1155,13 @@ The captive portal will not be started if the connection has been established wi
 <p>The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient.</p>
 </div>
 <h3 id="home"><i class="fa fa-caret-right"></i> home<a class="headerlink" href="#home" title="Permanent link">&para;</a></h3>
-<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">home(String</span> <span style="color: #f8f8f2">uri)</span>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">home(String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">uri)</span>
 </pre></div>
 
 <p>Put a user site's home URI. The URI specified by home is linked from "HOME" in the AutoConnect menu.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">uri</span> A URI string of user site's home path.</dd>
+    <dd><span class="apidef">uri</span><span class="aidesc">A URI string of user site's home path.</span></dd>
 </dl></p>
 <h3 id="host"><i class="fa fa-caret-right"></i> host<a class="headerlink" href="#host" title="Permanent link">&para;</a></h3>
 <ul>
@@ -1185,7 +1199,7 @@ or<br />
 Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">aux</span>Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with <a href="https://en.cppreference.com/w/cpp/language/list_initialization">list initialization</a>.</dd>
+    <dd><span class="apidef">aux</span><span class="apidesc">Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with <a href="https://en.cppreference.com/w/cpp/language/list_initialization">list initialization</a>.</span></dd>
 </dl></p>
 <h3 id="load"><i class="fa fa-caret-right"></i> load<a class="headerlink" href="#load" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">load(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">aux)</span>
@@ -1197,10 +1211,10 @@ Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joi
 Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">aux</span>The input string to be loaded.</dd>
+    <dd><span class="apidef">aux</span><span class="apidesc">The input string to be loaded.</span></dd>
     <dt><strong>Return value</strong></dt>
-    <dd><span class="apidef">true</span>The JSON document as AutoConnectAux successfully loaded.</dd>
-    <dd><span class="apidef">false</span>Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the <a href="https://arduinojson.org/v5/assistant/">ArduinoJson Assistant</a>.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">The JSON document as AutoConnectAux successfully loaded.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the <a href="https://arduinojson.org/v5/assistant/">ArduinoJson Assistant</a>.</span></dd>
 </dl></p>
 <h3 id="on"><i class="fa fa-caret-right"></i> on<a class="headerlink" href="#on" title="Permanent link">&para;</a></h3>
 <dl>
@@ -1209,10 +1223,9 @@ Load JSON document of AutoConnectAux which contains AutoConnectElements. If ther
 <dt>Register the handler function of the AutoConnectAux.</dt>
 <dt><dl class="apidl"></dt>
 <dt><dt><strong>Parameters</strong></dt></dt>
-<dt><dd><span class="apidef">uri</span>A string of the URI assigned to the AutoConnectAux page.</dd></dt>
-<dt><dd><span class="apidef">handler</span>A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration.</dd></dt>
-<dt><dd><span class="apidef"></span><code>String handler(AutoConnectAux&amp;, PageArgument&amp;)</code></dd></dt>
-<dt><dd><span class="apidef">order</span>Specifies when the handler is called with the following enumeration value.</dd></dt>
+<dt><dd><span class="apidef">uri</span><span class="apidesc">A string of the URI assigned to the AutoConnectAux page.</span></dd></dt>
+<dt><dd><span class="apidef">handler</span><span class="apidesc">A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration.<p class=""apidesc"><code>String handler(AutoConnectAux&amp;, PageArgument&amp;)</code></p></span></dd></dt>
+<dt><dd><span class="apidef">order</span><span class="apidesc">Specifies when the handler is called with the following enumeration value.</span></dd></dt>
 <dd>
 <ul>
 <li><strong>AC_EXIT_AHEAD</strong> :
@@ -1244,7 +1257,7 @@ Called even before generating HTML and after generated.</li>
 Register the function which will call from AutoConnect at the start of the captive portal.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">fn</span>Function called at the captive portal start.</dd></p>
+    <dd><span class="apidef">fn</span><span class="apidesc">Function called at the captive portal start.</span></dd></p>
 </dl>
 
 <p>An <em>fn</em> specifies the function called when the captive portal starts. Its prototype declaration is defined as "<em>DetectExit_ft</em>".</p>
@@ -1252,10 +1265,10 @@ Register the function which will call from AutoConnect at the start of the capti
 </pre></div>
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">softapIP</span>An IP address of SoftAP for the captive portal.</dd>
+    <dd><span class="apidef">softapIP</span><span class="apidesc">An IP address of SoftAP for the captive portal.</span></dd>
     <dt><strong>Retuen value</strong></dt>
-    <dd><span class="apidef">true</span>Continues captive portal handling.</dd>
-    <dd><span class="apidef">false</span>Cancel the captive portal. AutoConnect::begin function will return with a false.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">Continues captive portal handling.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">Cancel the captive portal. AutoConnect::begin function will return with a false.</span></dd>
 </dl></p>
 <h3 id="onnotfound"><i class="fa fa-caret-right"></i> onNotFound<a class="headerlink" href="#onnotfound" title="Permanent link">&para;</a></h3>
 <ul>
@@ -1272,12 +1285,12 @@ Register the function which will call from AutoConnect at the start of the capti
 Register the handler function for undefined URL request detected.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">fn</span>A function of the "not found" handler.</dd>
+    <dd><span class="apidef">fn</span><span class="apidesc">A function of the "not found" handler.</span></dd>
 </dl></p>
 <h3 id="where"><i class="fa fa-caret-right"></i> where<a class="headerlink" href="#where" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConenctAux</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">where(</span><span style="color: #66d9ef">void</span><span style="color: #f8f8f2">)</span>
 </pre></div>
-Returns a pointer to the AutoConnectAux object of the custom web page that caused the request to that page. This function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the <strong>on</strong> handler of ESP8266WebServer/ESP32. In other words, this function only returns the last AutoConnecAux page called.
+Returns a pointer to the AutoConnectAux object of the custom Web page that caused the request to that page. This function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the <strong>on</strong> handler of ESP8266WebServer/ESP32. In other words, this function only returns the last AutoConnecAux page called.
 <dl class="apidl">
     <dt><strong>Retuen value</strong></dt>
     <dd>A pointer to the AutoConnectAux that caused the request the page.</dd>
diff --git a/docs/apiaux.html b/docs/apiaux.html
index 9e330ce..aacd7d8 100644
--- a/docs/apiaux.html
+++ b/docs/apiaux.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -719,8 +721,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -731,8 +745,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -931,9 +945,10 @@
 </pre></div>
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">uri</span>URI of this custom Web Page.</dd>
-    <dd><span class="apidef">title</span>Page title of this custom web page. It will appear on the auto connection menu and at the top of that page.</dd>
-    <dd><span class="apidef">addons</span>Reference to AutoConnectElement collection.</dt>
+    <dd><span class="apidef">uri</span><span class="apidesc">URI of this custom Web Page.</span></dd>
+    <dd><span class="apidef">title</span><span class="apidesc">Page title of this custom Web page. It will appear on the auto connection menu and at the top of that page.</span></dd>
+    <dd><span class="apidef">menu</span><span class="apidesc">Specifies whether to display this page on menu.</span></dd>
+    <dd><span class="apidef">addons</span><span class="apidesc">Reference to AutoConnectElement collection.</span></dt>
 </dl></p>
 <h2 id="public-member-functions"><i class="fa fa-code"></i> Public member functions<a class="headerlink" href="#public-member-functions" title="Permanent link">&para;</a></h2>
 <h3 id="add"><i class="fa fa-caret-right"></i> add<a class="headerlink" href="#add" title="Permanent link">&para;</a></h3>
@@ -941,17 +956,42 @@
 </pre></div>
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">add(AutoConnectElementVT</span> <span style="color: #f8f8f2">addons)</span>
 </pre></div>
-Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu.</p>
+Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu.
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">addon</span><span class="apidesc">Reference of AutoConnectElements. Specifies one of the AutoConnectElements classes.</span></dd>
+    <dd><span class="apidef">addons</span><span class="apidesc">An array list of reference of AutoConnectElements. An <a href="https://en.cppreference.com/w/cpp/language/list_initialization">list initialization</a> of the <a href="https://en.cppreference.com/w/cpp/container/vector">std::vector</a> can be used for the addons parameter cause the actual definition of type <strong>AutoConnectElementVT</strong> is <code>std::vector&lt;std::reference_wrapper&lt;AutoConnectElement&gt;&gt;</code>.</span></dd>
+</dl></p>
 <h3 id="getelement"><i class="fa fa-caret-right"></i> getElement<a class="headerlink" href="#getelement" title="Permanent link">&para;</a></h3>
-<p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">template</span><span style="color: #f92672">&lt;</span><span style="color: #66d9ef">typename</span> <span style="color: #f8f8f2">T</span><span style="color: #f92672">&gt;</span> <span style="color: #f8f8f2">T</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">getElement(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">name)</span>
+<p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">T</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">getElement</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">T</span><span style="color: #f92672">&gt;</span><span style="color: #f8f8f2">(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">name)</span>
 </pre></div>
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConnectElement</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">getElement(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">name)</span>
-</pre></div></p>
-<p>Get registered AutoConnectElement as specified name.</p>
+</pre></div>
+Get a registered AutoConnectElement as specified name. If <strong>T</strong> is specified as an actual type of AutoConnectElements, it returns a reference to that instance.
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">T</span><span class="apidesc">Actual type name of AutoConnectElements as <a href="apielements.html#autoconnectbutton">AutoConnectButton</a>, <a href="apielements.html#autoconnectcheckbox">AutoConnectCheckbox</a>, <a href="apielements.html#autoconnectelement">AutoConnectElement</a>, <a href="apielements.html#autoconnectinput">AutoConnectInput</a>, <a href="apielements.html#autoconnectradio">AutoConnectRadio</a>, <a href="apielements.html#autoconnectselect">AutoConnectSelect</a>, <a href="apielements.html#autoconnectsubmit">AutoConnectSubmit</a>, <a href="apielements.html#autoconnecttext">AutoConnectText</a>.</span></dd>
+    <dd><span class="apidef">name</span><span class="apidesc">Name of the AutoConnectElements to be retrieved.</span></dd>
+    <dt><strong>Return value</strong></dt><dd>A reference of the AutoConnectElements. If a type is not specified returns a pointer.</dd>
+</dl></p>
 <h3 id="getelements"><i class="fa fa-caret-right"></i> getElements<a class="headerlink" href="#getelements" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConnectElementVT</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">getElements(</span><span style="color: #66d9ef">void</span><span style="color: #f8f8f2">)</span>
 </pre></div>
-Get vector of reference of all elements.</p>
+Get vector of reference of all elements.
+<dl class="apidl">
+    <dt><strong>Return value</strong></dt>
+    <dd>A reference to std::vector of reference to AutoConnecctElements.</dd>
+</dl></p>
+<p>The getElements returns a reference to std::vector of reference to AutoConnecctElements. This function is provided to handle AutoConnectElemets owned by AutoConnectAux in bulk, and you can use each method of std::vector for a return value.</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #75715e">// An example of getting type and name of all AutoConnectElements registered in AutoConnectAux.</span>
+<span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #f8f8f2">aux;</span>
+<span style="color: #75715e">// some code here...</span>
+<span style="color: #f8f8f2">AutoConnectElementVt</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">elements</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">aux.getElements();</span>
+<span style="color: #66d9ef">for</span> <span style="color: #f8f8f2">(AutoConnectElement</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">elm</span> <span style="color: #f8f8f2">:</span> <span style="color: #f8f8f2">elements)</span> <span style="color: #f8f8f2">{</span>
+    <span style="color: #f8f8f2">Serial.printf(</span><span style="color: #e6db74">&quot;name&lt;%s&gt; as type %d</span><span style="color: #ae81ff">\n</span><span style="color: #e6db74">&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">elm.name.c_str(),</span> <span style="color: #f8f8f2">(</span><span style="color: #66d9ef">int</span><span style="color: #f8f8f2">)elm.typeOf());</span>
+<span style="color: #f8f8f2">}</span>
+</pre></div>
+
 <h3 id="load"><i class="fa fa-caret-right"></i> load<a class="headerlink" href="#load" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">load(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">in)</span>
 </pre></div>
@@ -959,7 +999,24 @@ Get vector of reference of all elements.</p>
 </pre></div>
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">load(Stream</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">in)</span>
 </pre></div>
-Load whole elements to AutoConnectAux Pages.</p>
+Load all AutoConnectElements elements from JSON document into AutoConnectAux as custom Web pages. The JSON document specified by the load function must be the <a href="acjson.html#json-objects-elements-for-the-custom-web-page">document structure</a> of AutoConnectAux. Its JSON document can describe multiple pages as an array.
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">in</span><span class="apidesc">Specifies the JSON document to be load. The load function can input the following objects.</p>
+<ul>
+<li>String : Read-only String</li>
+<li>PROGMEM : Character array contained in the flash</li>
+<li>Stream : An entity that inherits stream class, generally SPIFFS or SD.
+    </span></dd>
+    <dt><strong>Return value</strong></dt>
+    <dd><span class="apidef">true</span><span class="apidesc">JSON document as the custom Web pages successfully loaded.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">JSON document loading failed.</span></dd>
+</dl></li>
+</ul>
+<div class="admonition hint">
+<p class="admonition-title">Load multiple custom Web pages separately</p>
+<p>Multiple custom Web pages can be loaded at once with JSON as an array. But it will consume a lot of memory. By loading a JSON document by page as much as possible, you can reduce memory consumption.</p>
+</div>
 <h3 id="loadelement"><i class="fa fa-caret-right"></i> loadElement<a class="headerlink" href="#loadelement" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">loadElement(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">in,</span> <span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">name</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">String(</span><span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">))</span>
 </pre></div>
@@ -967,11 +1024,46 @@ Load whole elements to AutoConnectAux Pages.</p>
 </pre></div>
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">loadElement(Stream</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">in,</span> <span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">name</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">String(</span><span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">))</span>
 </pre></div>
-Load specified element.</p>
+Load specified element from JSON document into AutoConnectAux. The JSON document specified by the loadElement function must be the <a href="acjson.html#json-object-for-autoconnectelements">AutoConnectElement document structure</a>. When loading from a JSON document that describes multiple elements, its description must be an array syntax.
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">in</span><span class="apidesc">Specifies the JSON document to be load. The load function can input the following objects.</p>
+<ul>
+<li>String : Read-only String</li>
+<li>PROGMEM : Character array contained in the flash</li>
+<li>Stream : An entity that inherits stream class, generally SPIFFS or SD.
+    </span></dd>
+    <dd><span class="apidef">name</span><span class="apidesc">Specifies the name to be load. If the name is not specified, the loadElement function will load all elements contained in the JSON document.</span></dd>
+    <dt><strong>Return value</strong></dt>
+    <dd><span class="apidef">true</span><span class="apidesc">Specified AutoConnectElements successfully loaded.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">JSON document loading failed.</span></dd>
+</dl></li>
+</ul>
+<div class="admonition caution">
+<p class="admonition-title">Maybe it is an array</p>
+<p>Please note that the JSON document that is the input for loadElement is an array syntax of AutoConnectElements when there are multiple elements. For example, the following JSON document has a syntax error:</p>
+<p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">{</span>
+  <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Caption&quot;</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACText&quot;</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Hello, world&quot;</span>
+<span style="color: #f8f8f2">}</span><span style="color: #960050; background-color: #1e0010">,</span>
+<span style="color: #f8f8f2">{</span>
+  <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Server&quot;</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACInput&quot;</span><span style="color: #f8f8f2">,</span>
+  <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Server address&quot;</span>
+<span style="color: #f8f8f2">}</span>
+</pre></div>
+The outermost <code>[</code>, <code>]</code> is missing.</p>
+</div>
 <h3 id="menu"><i class="fa fa-caret-right"></i> menu<a class="headerlink" href="#menu" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">menu(</span><span style="color: #66d9ef">const</span> <span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">post)</span>
 </pre></div>
-Set or reset the display as menu item for this AutoConnectAux.</p>
+Set or reset the display as menu item for this AutoConnectAux. This function programmatically manipulates the menu parameter of the <a href="apiaux.html#autoconnectaux">AutoConenctAux constructor</a>.
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">true</span><span class="apidesc">Show on the menu.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">Hidden on the menu.</span></dd>
+</dl></p>
 <h3 id="on"><i class="fa fa-caret-right"></i> on<a class="headerlink" href="#on" title="Permanent link">&para;</a></h3>
 <dl>
 <dt><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">on(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">AuxHandlerFunctionT</span> <span style="color: #f8f8f2">handler,</span> <span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">AutoConnectExitOrder_t</span> <span style="color: #f8f8f2">order</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">AC_EXIT_AHEAD)</span>
@@ -979,9 +1071,8 @@ Set or reset the display as menu item for this AutoConnectAux.</p>
 <dt>Register the handler function of the AutoConnectAux.</dt>
 <dt><dl class="apidl"></dt>
 <dt><dt><strong>Parameters</strong></dt></dt>
-<dt><dd><span class="apidef">handler</span>A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration.</dd></dt>
-<dt><dd><span class="apidef"></span><code>String handler(AutoConnectAux&amp;, PageArgument&amp;)</code></dd></dt>
-<dt><dd><span class="apidef">order</span>Specifies when the handler is called with the following enumeration value.</dd></dt>
+<dt><dd><span class="apidef">handler</span><span class="apidesc">A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration.<p class="apidesc"><code>String handler(AutoConnectAux&amp;, PageArgument&amp;)</code></p></span></dd></dt>
+<dt><dd><span class="apidef">order</span><span class="apidesc">Specifies when the handler is called with the following enumeration value.</span></dt>
 <dd>
 <ul>
 <li><strong>AC_EXIT_AHEAD</strong> :
@@ -997,7 +1088,7 @@ Called after AutoConnect generates the HTML of the page. You can append to HTML
 <dd>
 <ul>
 <li><strong>AC_EXIT_BOTH</strong> :
-Called even before generating HTML and after generated.</li>
+Called even before generating HTML and after generated.</dd></li>
 </ul>
 </dd>
 </dl>
@@ -1006,20 +1097,70 @@ Called even before generating HTML and after generated.</li>
 <h3 id="release"><i class="fa fa-caret-right"></i> release<a class="headerlink" href="#release" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">release(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">name)</span>
 </pre></div>
-Release a specified AutoConnectElement.</p>
+Release a specified AutoConnectElement from AutoConenctAux. The release function is provided to dynamically change the structure of the custom Web pages with the sketch. By combining the release function and the <a href="apiaux.html#add">add</a> function or the <a href="apiaux.html#loadelement">loadElement</a> function, the sketch can change the style of the custom Web page according to its behavior.
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">name</span><span class="apidesc">Specifies the name of AutoConnectElements to be released.</span></dd>
+    <dt><strong>Return value</strong></dt>
+    <dd><span class="apidef">true</span><span class="apidesc">The AutoConnectElement successfully released.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">The AutoConnectElement can not be released.</span></dd>
+</dl></p>
 <h3 id="saveelement"><i class="fa fa-caret-right"></i> saveElement<a class="headerlink" href="#saveelement" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">size_t</span> <span style="color: #f8f8f2">saveElement(Stream</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">out,</span> <span style="color: #f8f8f2">std</span><span style="color: #f92672">::</span><span style="color: #f8f8f2">vector</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">String</span><span style="color: #f92672">&gt;</span> <span style="color: #66d9ef">const</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">names</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">{})</span>
 </pre></div>
-Write elements of AutoConnectAux to the stream.</p>
+Write elements of AutoConnectAux to the stream. The saveElement function outputs the specified AutoConenctElements as a JSON document using the <a href="https://arduinojson.org/v5/api/jsonobject/prettyprintto/">prettyPrintTo</a> function of the <a href="https://arduinojson.org/">ArduinoJson</a> library.
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">out</span><span class="apidesc">Output stream to be output. SPIFFS, SD also Serial can be specified generally.</span></dd>
+    <dd><span class="apidef">names</span><span class="apidesc">The array of the name of AutoConnectElements to be output. If the names parameter is not specified, all AutoConnectElements registered in AutoConnectAux are output.</span></dd>
+    <dt><strong>Return value</strong></dt>
+    <dd>The number of bytes written.</dd>
+</dl></p>
+<div class="admonition note">
+<p class="admonition-title">The output format is pretty</p>
+<p>The saveElement function outputs a prettified JSON document.</p>
+</div>
 <h3 id="setelementvalue"><i class="fa fa-caret-right"></i> setElementValue<a class="headerlink" href="#setelementvalue" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">setElementValue(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">name,</span> <span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span> <span style="color: #f8f8f2">value)</span>
 </pre></div>
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">setElementValue(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">name,</span> <span style="color: #f8f8f2">std</span><span style="color: #f92672">::</span><span style="color: #f8f8f2">vector</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">String</span><span style="color: #f92672">&gt;</span> <span style="color: #66d9ef">const</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">values)</span>
-</pre></div></p>
+</pre></div>
+Sets the value of the specified AutoConnectElement. If values ​​is specified as a <em>std::vector</em> of String, the element that can set the values is the <a href="apielements.html#autoconnectradio">AutoConnectRadio</a> or the <a href="apielements.html#autoconnectselect">AutoConnectSelect</a>. 
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">name</span><span class="apidesc">Specifies the name of the AutoConnectElements that you want to set the value.</span></dd>
+    <dd><span class="apidef">value</span><span class="apidesc">Specifies the value to be set.</span></dd>
+    <dd><span class="apidef">values</span><span class="apidesc">Specifies a reference of a <em>std::vector</em> of String. It contains the values of the AutoConnectRadio or the AutoConnectSelect.</span></dd>
+    <dt><strong>Return value</strong></dt>
+    <dd><span class="apidef">true</span><span class="apidesc">The value has been set.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">AutoConnectElements with the specified name are not registered. Or the type of the value is not consistent with the specified AutoConnectElements.</span></dd>
+</dl></p>
+<div class="admonition hint">
+<p class="admonition-title">You can directly access the value member variable.</p>
+<p>If you are gripping with the sketch to the AutoConnectElements of the target that sets the value, you can access the value member variable directly. The following sketch code has the same effect.
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #f8f8f2">aux;</span>
+<span style="color: #75715e">// ... Griping the AutoConnectText here.</span>
+<span style="color: #f8f8f2">aux.setElementValue(</span><span style="color: #e6db74">&quot;TEXT_FIELD&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;New value&quot;</span><span style="color: #f8f8f2">);</span>
+</pre></div>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #f8f8f2">aux;</span>
+<span style="color: #75715e">// ... Griping the AutoConnectText here.</span>
+<span style="color: #f8f8f2">AutoConnectText</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">text</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">aux.getElement</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">AutoConnectText</span><span style="color: #f92672">&gt;</span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">&quot;TEXT_FIELD&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">text.value</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">&quot;New value&quot;</span><span style="color: #f8f8f2">;</span>
+</pre></div>
+The difference between the setElementValue and the value access with the <a href="apiaux.html#getelement">getElement</a> is the certainty of the registration state for the element. The <a href="apiaux.html#getelement">getElement</a> returns an empty object if the element is not registered then a sketch assigns the value to it. May occur unexpected results and crashes. You should use the setElementValue if its registration is unsettled.</p>
+</div>
 <h3 id="settitle"><i class="fa fa-caret-right"></i> setTitle<a class="headerlink" href="#settitle" title="Permanent link">&para;</a></h3>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">setTitle(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">title)</span>
 </pre></div>
-Set the title string of the AutoConnectAux page.</p>
+Set the title string of the custom Web page. This title will be displayed as the menu title of the custom Web page.
+<dl class="apidl">
+    <dt><strong>Parameter</strong></dt>
+    <dd><span class="apidef">title</span><span class="apidesc">Title string to be display.</span></dd>
+</dl></p>
+<div class="admonition caution">
+<p class="admonition-title">Not the menu title</p>
+<p>The setTitle function is not set for the AutoConnect menu title. The effect of this function is that custom Web page only. To change the AutoConnect menu title use <a href="apiconfig.html#title">AutoConnectConfig::title</a>.</p>
+</div>
                 
                   
                 
diff --git a/docs/apiconfig.html b/docs/apiconfig.html
index 9a4eb3b..a93012e 100644
--- a/docs/apiconfig.html
+++ b/docs/apiconfig.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -817,8 +819,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -829,8 +843,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -1133,10 +1147,10 @@
 </pre></div>
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">ap</span>SSID for SoftAP. The length should be up to 31. The default value is <strong>esp8266ap</strong> for ESP8266, <strong>esp32ap</strong> for ESP32.</dd>
-    <dd><span class="apidef">password</span>Password for SodtAP. The length should be from 8 to up to 63. The default value is <strong>12345678</strong>.</dd>
-    <dd><span class="apidef">timeout</span>The timeout value of the captive portal in [ms] units. The default value is 0.</dd>
-    <dd><span class="apidef">channel</span>The channel number of WIFi when SoftAP starts. The default values is 1.</dd>
+    <dd><span class="apidef">ap</span><span class="apidesc">SSID for SoftAP. The length should be up to 31. The default value is <strong>esp8266ap</strong> for ESP8266, <strong>esp32ap</strong> for ESP32.</span></dd>
+    <dd><span class="apidef">password</span><span class="apidesc">Password for SodtAP. The length should be from 8 to up to 63. The default value is <strong>12345678</strong>.</span></dd>
+    <dd><span class="apidef">timeout</span><span class="apidesc">The timeout value of the captive portal in [ms] units. The default value is 0.</span></dd>
+    <dd><span class="apidef">channel</span><span class="apidesc">The channel number of WIFi when SoftAP starts. The default values is 1.</span></dd>
 </dl></p>
 <h2 id="public-member-variables"><i class="fa fa-code"></i> Public member variables<a class="headerlink" href="#public-member-variables" title="Permanent link">&para;</a></h2>
 <h3 id="apid"><i class="fa fa-caret-right"></i> apid<a class="headerlink" href="#apid" title="Permanent link">&para;</a></h3>
@@ -1149,7 +1163,7 @@
 <p>Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">IPAddress</span>The default value is <strong>192.168.244.1</strong></dd>
+    <dd><span class="apidef">IPAddress</span><span class="apidesc">The default value is <strong>192.168.244.1</strong></span></dd>
 </dl></p>
 <h3 id="autoreconnect"><i class="fa fa-caret-right"></i> autoReconnect<a class="headerlink" href="#autoreconnect" title="Permanent link">&para;</a></h3>
 <p>Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, <em>AutoConnect::begin()</em> function will attempt to reconnect to a known access point using credentials stored in the EEPROM, even if the connection failed by current SSID.<br />
@@ -1158,8 +1172,8 @@ If the connection fails, starts the captive portal in SoftAP + STA mode.<br />
     <dt><strong>Type</strong></dt>
     <dd>bool</dd>
     <dt><strong>Value</strong></dt>
-    <dd><span class="apidef" style="width:230px;">true</span>Reconnect automatically.</dd>
-    <dd><span class="apidef" style="width:230px;">false</span>Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">Reconnect automatically.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default.</span></dd>
 </dl></p>
 <p>When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied.</p>
 <ul>
@@ -1172,8 +1186,8 @@ If the connection fails, starts the captive portal in SoftAP + STA mode.<br />
     <dt><strong>Type</strong></dt>
     <dd>bool</dd>
     <dt><strong>Value</strong></dt>
-    <dd><span class="apidef" style="width:230px;">true</span>Reset after WiFi disconnected automatically.</dd>
-    <dd><span class="apidef" style="width:230px;">false</span>No reset.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">Reset after WiFi disconnected automatically.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">No reset.</span></dd>
 </dl></p>
 <h3 id="autorise"><i class="fa fa-caret-right"></i> autoRise<a class="headerlink" href="#autorise" title="Permanent link">&para;</a></h3>
 <p>Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first <em>WiFi.begin</em> fails.
@@ -1181,8 +1195,8 @@ If the connection fails, starts the captive portal in SoftAP + STA mode.<br />
     <dt><strong>Type</strong></dt>
     <dd>bool</dd>
     <dt><strong>Value</strong></dt>
-    <dd><span class="apidef" style="width:230px;">true</span>Enable the captive portal. This is the default.</dd>
-    <dd><span class="apidef" style="width:230px;">false</span>Disable the captive portal.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">Enable the captive portal. This is the default.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">Disable the captive portal.</span></dd>
 </dl></p>
 <h3 id="autosave"><i class="fa fa-caret-right"></i> autoSave<a class="headerlink" href="#autosave" title="Permanent link">&para;</a></h3>
 <p>The credential saved automatically at the connection establishment.
@@ -1190,8 +1204,8 @@ If the connection fails, starts the captive portal in SoftAP + STA mode.<br />
     <dt><strong>Type</strong></dt>
     <dd>AC_SAVECREDENTIAL_t</dd>
     <dt><strong>Value</strong></dt>
-    <dd><span class="apidef" style="width:230px;">AC_SAVECREDENTIAL_AUTO</span>The credential saved automatically. This is the default.</dd>
-    <dd><span class="apidef" style="width:230px;">AC_SAVECREDENTIAL_NEVER</span>The credential no saved.</dd>
+    <dd><span class="apidef">AC_SAVECREDENTIAL_AUTO</span><span class="apidesc"></span><span class="apidef">&nbsp;</span><span class="apidesc">The credential saved automatically. This is the default.</span></dd>
+    <dd><span class="apidef">AC_SAVECREDENTIAL_NEVER</span><span class="apidesc"></span><span class="apidef">&nbsp;</span><span class="apidesc">The credential no saved.</span></dd>
 </dl></p>
 <h3 id="booturi"><i class="fa fa-caret-right"></i> bootUri<a class="headerlink" href="#booturi" title="Permanent link">&para;</a></h3>
 <p>Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of <strong>AC_ONBOOTURI_t</strong> indicating either the AutoConnect root path or the user screen home path.
@@ -1199,8 +1213,8 @@ If the connection fails, starts the captive portal in SoftAP + STA mode.<br />
     <dt><strong>Type</strong></dt>
     <dd>AC_ONBOOTURI_t</dd>
     <dt><strong>Value</strong></dt>
-    <dd><span class="apidef" style="width:230px;">AC_ONBOOTURI_ROOT</span>Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h.</dd>
-    <dd><span class="apidef" style="width:230px;">AC_ONBOOTURI_HOME</span>It is redirected to the uri specified by <a href="apiconfig.html#homeuri"><strong>AutoConnectConfig::homeUri</strong></a>.</dd>
+    <dd><span class="apidef">AC_ONBOOTURI_ROOT</span><span class="apidesc"></span><span class="apidef">&nbsp;</span><span class="apidesc">Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h.</span></dd>
+    <dd><span class="apidef">AC_ONBOOTURI_HOME</span><span class="apidesc"></span><span class="apidef">&nbsp;</span><span class="apidesc">It is redirected to the uri specified by <a href="apiconfig.html#homeuri"><strong>AutoConnectConfig::homeUri</strong></a>.</span></dd>
 </dl></p>
 <h3 id="boundaryoffset"><i class="fa fa-caret-right"></i> boundaryOffset<a class="headerlink" href="#boundaryoffset" title="Permanent link">&para;</a></h3>
 <p>Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK)<br />
@@ -1241,7 +1255,7 @@ The default value is 0.
 <p>Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">IPAddress</span>The default value is <strong>192.168.244.1</strong></dd>
+    <dd><span class="apidef">IPAddress</span><span class="apidesc">The default value is <strong>192.168.244.1</strong></span></dd>
 </dl></p>
 <h3 id="hidden"><i class="fa fa-caret-right"></i> hidden<a class="headerlink" href="#hidden" title="Permanent link">&para;</a></h3>
 <p>Sets SoftAP to hidden SSID.
@@ -1249,8 +1263,8 @@ The default value is 0.
     <dt><strong>Type</strong></dt>
     <dd>uint8_t</dd>
     <dt><strong>Value</strong></dt>
-    <dd><span class="apidef" style="width:230px;">0</span>SSID will be appeared. This is the default.</dd>
-    <dd><span class="apidef" style="width:230px;">1</span>SSID will be hidden.</dd>
+    <dd><span class="apidef">0</span><span class="aidesc">SSID will be appeared. This is the default.</span></dd>
+    <dd><span class="apidef">1</span><span class="apidesc">SSID will be hidden.</span></dd>
 </dl></p>
 <h3 id="homeuri"><i class="fa fa-caret-right"></i> homeUri<a class="headerlink" href="#homeuri" title="Permanent link">&para;</a></h3>
 <p>Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is "/".
@@ -1270,20 +1284,20 @@ The default value is 0.
     <dt><strong>Type</strong></dt>
     <dd>bool</dd>
     <dt><strong>Value</strong></dt>
-    <dd><span class="apidef" style="width:230px;">true</span>Start the captive portal with <a href="api.html#begin"><strong>AutoConnect::begin</strong></a>.</dd>
-    <dd><span class="apidef" style="width:230px;">false</span>Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">Start the captive portal with <a href="api.html#begin"><strong>AutoConnect::begin</strong></a>.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default.</span></dd>
 </dl></p>
 <h3 id="netmask"><i class="fa fa-caret-right"></i> netmask<a class="headerlink" href="#netmask" title="Permanent link">&para;</a></h3>
 <p>Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">IPAddress</span>The default value is <strong>255.255.255.0</strong></dd>
+    <dd><span class="apidef">IPAddress</span><span class="apidesc">The default value is <strong>255.255.255.0</strong></span></dd>
 </dl></p>
 <h3 id="portaltimeout"><i class="fa fa-caret-right"></i> portalTimeout<a class="headerlink" href="#portaltimeout" title="Permanent link">&para;</a></h3>
 <p>Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (ie Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">unsigned long</span>Captive portal timeout value. The default value is 0.</dd>
+    <dd><span class="apidef">unsigned long</span><span class="apidesc">Captive portal timeout value. The default value is 0.</span></dd>
 </dl></p>
 <h3 id="psk"><i class="fa fa-caret-right"></i> psk<a class="headerlink" href="#psk" title="Permanent link">&para;</a></h3>
 <p>Sets password for SoftAP. The length should be from 8 to up to 63. The default value is <strong>12345678</strong>.
@@ -1297,8 +1311,8 @@ The default value is 0.
     <dt><strong>Type</strong></dt>
     <dd>bool</dd>
     <dt><strong>Value</strong></dt>
-    <dd><span class="apidef" style="width:230px;">true</span>Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP.</dd>
-    <dd><span class="apidef" style="width:230px;">false</span>When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default.</dd>
+    <dd><span class="apidef">true</span><span class="apidesc">Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP.</span></dd>
+    <dd><span class="apidef">false</span><span class="apidesc">When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default.</span></dd>
 </dl></p>
 <div class="admonition hint">
 <p class="admonition-title">Connection request after timed-out</p>
diff --git a/docs/apielements.html b/docs/apielements.html
index af66727..a79eff4 100644
--- a/docs/apielements.html
+++ b/docs/apielements.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -982,6 +984,101 @@
     AutoConnectSelect
   </a>
   
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#constructor_5" title=" Constructor" class="md-nav__link">
+     Constructor
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#public-member-variables_5" title=" Public member variables" class="md-nav__link">
+     Public member variables
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#name_5" title=" name" class="md-nav__link">
+     name
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#options" title=" options" class="md-nav__link">
+     options
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#label_3" title=" label" class="md-nav__link">
+     label
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#public-member-functions_5" title=" Public member functions" class="md-nav__link">
+     Public member functions
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#typeof_5" title=" typeOf" class="md-nav__link">
+     typeOf
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#add_1" title=" add" class="md-nav__link">
+     add
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#empty_1" title=" empty" class="md-nav__link">
+     empty
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#size" title=" size" class="md-nav__link">
+     size
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#operator_1" title=" operator &#91;&nbsp;&#93;" class="md-nav__link">
+     operator &#91;&nbsp;&#93;
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
         <li class="md-nav__item">
@@ -1063,8 +1160,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -1075,8 +1184,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -1578,6 +1687,101 @@
     AutoConnectSelect
   </a>
   
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#constructor_5" title=" Constructor" class="md-nav__link">
+     Constructor
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#public-member-variables_5" title=" Public member variables" class="md-nav__link">
+     Public member variables
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#name_5" title=" name" class="md-nav__link">
+     name
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#options" title=" options" class="md-nav__link">
+     options
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#label_3" title=" label" class="md-nav__link">
+     label
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#public-member-functions_5" title=" Public member functions" class="md-nav__link">
+     Public member functions
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#typeof_5" title=" typeOf" class="md-nav__link">
+     typeOf
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#add_1" title=" add" class="md-nav__link">
+     add
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#empty_1" title=" empty" class="md-nav__link">
+     empty
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#size" title=" size" class="md-nav__link">
+     size
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#operator_1" title=" operator &#91;&nbsp;&#93;" class="md-nav__link">
+     operator &#91;&nbsp;&#93;
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
         <li class="md-nav__item">
@@ -1619,28 +1823,28 @@
 </pre></div>
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">name</span>The element name.</dd>
-    <dd><span class="apidef">value</span>Value of the element.</dd>
-    <dd><span class="apidef">action</span>Native code of the action script executed when the button is clicked.</dd>
+    <dd><span class="apidef">name</span><span class="apidesc">The element name.</span></dd>
+    <dd><span class="apidef">value</span><span class="apidesc">Value of the element.</span></dd>
+    <dd><span class="apidef">action</span><span class="apidesc">Native code of the action script executed when the button is clicked.</span></dd>
 </dl></p>
 <h3 id="public-member-variables"><i class="fa fa-code"></i> Public member variables<a class="headerlink" href="#public-member-variables" title="Permanent link">&para;</a></h3>
 <h4 id="name"><i class="fa fa-caret-right"></i> name<a class="headerlink" href="#name" title="Permanent link">&para;</a></h4>
 <p>The element name.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="value"><i class="fa fa-caret-right"></i> value<a class="headerlink" href="#value" title="Permanent link">&para;</a></h4>
 <p>Value of the element.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="action"><i class="fa fa-caret-right"></i> action<a class="headerlink" href="#action" title="Permanent link">&para;</a></h4>
 <p>HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script.<sup id="fnref:1"><a class="footnote-ref" href="#fn:1" rel="footnote">1</a></sup>
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h3 id="public-member-functions"><i class="fa fa-code"></i> Public member functions<a class="headerlink" href="#public-member-functions" title="Permanent link">&para;</a></h3>
 <h4 id="typeof"><i class="fa fa-caret-right"></i> typeOf<a class="headerlink" href="#typeof" title="Permanent link">&para;</a></h4>
@@ -1657,35 +1861,35 @@ Returns type of AutoConnectElement.
 </pre></div>
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">name</span>The element name.</dd>
-    <dd><span class="apidef">value</span>Value of the element.</dd>
-    <dd><span class="apidef">label</span>A label string prefixed to the checkbox.</dd>
-    <dd><span class="apidef">check</span>Checked state of the checkbox.</dd>
+    <dd><span class="apidef">name</span><span class="apidesc">The element name.</span></dd>
+    <dd><span class="apidef">value</span><span class="apidesc">Value of the element.</span></dd>
+    <dd><span class="apidef">label</span><span class="apidesc">A label string prefixed to the checkbox.</span></dd>
+    <dd><span class="apidef">check</span><span class="apidesc">Checked state of the checkbox.</span></dd>
 </dl></p>
 <h3 id="public-member-variables_1"><i class="fa fa-code"></i> Public member variables<a class="headerlink" href="#public-member-variables_1" title="Permanent link">&para;</a></h3>
 <h4 id="name_1"><i class="fa fa-caret-right"></i> name<a class="headerlink" href="#name_1" title="Permanent link">&para;</a></h4>
 <p>The element name. 
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="value_1"><i class="fa fa-caret-right"></i> value<a class="headerlink" href="#value_1" title="Permanent link">&para;</a></h4>
 <p>Value of the element. It becomes a value attribute of an HTML <code class="codehilite"><span style="color: #f8f8f2">&lt;</span><span style="color: #f92672">input</span> <span style="color: #a6e22e">type</span><span style="color: #f92672">=</span><span style="color: #e6db74">&quot;checkbox&quot;</span><span style="color: #f8f8f2">&gt;</span></code> tag.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="label"><i class="fa fa-caret-right"></i> label<a class="headerlink" href="#label" title="Permanent link">&para;</a></h4>
 <p>A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <code class="codehilite"><span style="color: #f8f8f2">&lt;</span><span style="color: #f92672">label</span><span style="color: #f8f8f2">&gt;</span></code> tag with an <code>id</code> attribute. The checkbox and the label are connected by the id attribute.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="checked"><i class="fa fa-caret-right"></i> checked<a class="headerlink" href="#checked" title="Permanent link">&para;</a></h4>
 <p>It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">Boolean</span></dd>
+    <dd><span class="apidef">Boolean</span><span class="apidesc"></span></dd>
 </dl></p>
 <h3 id="public-member-functions_1"><i class="fa fa-code"></i> Public member functions<a class="headerlink" href="#public-member-functions_1" title="Permanent link">&para;</a></h3>
 <h4 id="typeof_1"><i class="fa fa-caret-right"></i> typeOf<a class="headerlink" href="#typeof_1" title="Permanent link">&para;</a></h4>
@@ -1702,21 +1906,21 @@ Returns type of AutoConnectElement.
 </pre></div>
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">name</span>The element name.</dd>
-    <dd><span class="apidef">value</span>Value of the element.</dd>
+    <dd><span class="apidef">name</span><span class="apidesc">The element name.</span></dd>
+    <dd><span class="apidef">value</span><span class="apidesc">Value of the element.</span></dd>
 </dl></p>
 <h3 id="public-member-variables_2"><i class="fa fa-code"></i> Public member variables<a class="headerlink" href="#public-member-variables_2" title="Permanent link">&para;</a></h3>
 <h4 id="name_2"><i class="fa fa-caret-right"></i> name<a class="headerlink" href="#name_2" title="Permanent link">&para;</a></h4>
 <p>The element name.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="value_2"><i class="fa fa-caret-right"></i> value<a class="headerlink" href="#value_2" title="Permanent link">&para;</a></h4>
 <p>Value of the element. It is output as HTML as it is as a source for generating HTML code.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h3 id="public-member-functions_2"><i class="fa fa-code"></i> Public member functions<a class="headerlink" href="#public-member-functions_2" title="Permanent link">&para;</a></h3>
 <h4 id="typeof_2"><i class="fa fa-caret-right"></i> typeOf<a class="headerlink" href="#typeof_2" title="Permanent link">&para;</a></h4>
@@ -1733,42 +1937,42 @@ Returns type of AutoConnectElement.
 </pre></div>
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">name</span>The element name.</dd>
-    <dd><span class="apidef">value</span>Value of the element.</dd>
-    <dd><span class="apidef">label</span>Label string.</dd>
-    <dd><span class="apidef">pattern</span>Regular expression string for checking data format.</dd>
-    <dd><span class="apidef">placeholder</span>A placeholder string.</dd>
+    <dd><span class="apidef">name</span><span class="apidesc">The element name.</span></dd>
+    <dd><span class="apidef">value</span><span class="apidesc">Value of the element.</span></dd>
+    <dd><span class="apidef">label</span><span class="apidesc">Label string.</span></dd>
+    <dd><span class="apidef">pattern</span><span class="apidesc">Regular expression string for checking data format.</span></dd>
+    <dd><span class="apidef">placeholder</span><span class="apidesc">A placeholder string.</span></dd>
 </dl></p>
 <h3 id="public-member-variables_3"><i class="fa fa-code"></i> Public member variables<a class="headerlink" href="#public-member-variables_3" title="Permanent link">&para;</a></h3>
 <h4 id="name_3"><i class="fa fa-caret-right"></i> name<a class="headerlink" href="#name_3" title="Permanent link">&para;</a></h4>
 <p>The element name.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="value_3"><i class="fa fa-caret-right"></i> value<a class="headerlink" href="#value_3" title="Permanent link">&para;</a></h4>
 <p>Value of the element. It becomes a value attribute of an HTML <code class="codehilite"><span style="color: #f8f8f2">&lt;</span><span style="color: #f92672">input</span> <span style="color: #a6e22e">type</span><span style="color: #f92672">=</span><span style="color: #e6db74">&quot;text&quot;</span><span style="color: #f8f8f2">&gt;</span></code> tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="label_1"><i class="fa fa-caret-right"></i> label<a class="headerlink" href="#label_1" title="Permanent link">&para;</a></h4>
 <p>A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML <code class="codehilite"><span style="color: #f8f8f2">&lt;</span><span style="color: #f92672">label</span><span style="color: #f8f8f2">&gt;</span></code> tag with an id attribute. The input box and the label are connected by the id attribute.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="pattern"><i class="fa fa-caret-right"></i> pattern<a class="headerlink" href="#pattern" title="Permanent link">&para;</a></h4>
 <p>A pattern specifies a regular expression that the input-box's value is checked against on form submission.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="placeholder"><i class="fa fa-caret-right"></i> placeholder<a class="headerlink" href="#placeholder" title="Permanent link">&para;</a></h4>
 <p>A placeholder is an option string. Specification of a placeholder will generate a <code>placeholder</code> attribute for the input tag.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h3 id="public-member-functions_3"><i class="fa fa-code"></i> Public member functions<a class="headerlink" href="#public-member-functions_3" title="Permanent link">&para;</a></h3>
 <h4 id="typeof_3"><i class="fa fa-caret-right"></i> typeOf<a class="headerlink" href="#typeof_3" title="Permanent link">&para;</a></h4>
@@ -1785,46 +1989,47 @@ Returns type of AutoConnectElement.
 </pre></div>
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">name</span>The element name.</dd>
-    <dd><span class="apidef">values</span>An array of values of the radio buttons. Specifies an <a href="https://en.cppreference.com/w/cpp/container/vector">std::vector</a> object.</dd>
-    <dd><span class="apidef">label</span>Label string.</dd>
-    <dd><span class="apidef">order</span>The direction to arrange the radio buttons.</dd>
-    <dd><span class="apidef">checked</span>An index to be checked in the radio buttons.</dd>
+    <dd><span class="apidef">name</span><span class="apidesc">The element name.</span></dd>
+    <dd><span class="apidef">values</span><span class="apidesc">An array of values of the radio buttons. Specifies an <a href="https://en.cppreference.com/w/cpp/container/vector">std::vector</a> object.</span></dd>
+    <dd><span class="apidef">label</span><span class="apidesc">Label string.</span></dd>
+    <dd><span class="apidef">order</span><span class="apidesc">The direction to arrange the radio buttons.</span></dd>
+    <dd><span class="apidef">checked</span><span class="apidesc">An index to be checked in the radio buttons.</span></dd>
 </dl></p>
 <h3 id="public-member-variables_4"><i class="fa fa-code"></i> Public member variables<a class="headerlink" href="#public-member-variables_4" title="Permanent link">&para;</a></h3>
 <h4 id="name_4"><i class="fa fa-caret-right"></i> name<a class="headerlink" href="#name_4" title="Permanent link">&para;</a></h4>
 <p>The element name.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="values"><i class="fa fa-caret-right"></i> values<a class="headerlink" href="#values" title="Permanent link">&para;</a></h4>
 <p>An array of String type for the radio button options. It is an initialization list can be used. The <code class="codehilite"><span style="color: #f8f8f2">&lt;</span><span style="color: #f92672">input</span> <span style="color: #a6e22e">type</span><span style="color: #f92672">=</span><span style="color: #e6db74">&quot;radio&quot;</span><span style="color: #f8f8f2">&gt;</span></code> tags will be generated from each entry in the values.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">std::vector&lt;String&gt;</span></dd>
+    <dd><span class="apidef">std::vector&lt;String&gt;</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="label_2"><i class="fa fa-caret-right"></i> label<a class="headerlink" href="#label_2" title="Permanent link">&para;</a></h4>
 <p>A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the <a href="#order">order</a>.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">String</span></dd>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
 </dl></p>
 <h4 id="order"><i class="fa fa-caret-right"></i> order<a class="headerlink" href="#order" title="Permanent link">&para;</a></h4>
-<p>Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the <strong><em>order</em></strong>. It is a value of <strong>ACArrange_t</strong> type and accepts one of the following:</p>
-<ul>
-<li><strong><code>AC_Horizontal</code></strong> : Horizontal arrangement.</li>
-<li><strong><code>AC_Vertical</code></strong> : Vertical arrangement.<br />
+<p>Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the <strong><em>order</em></strong>. It is a value of <strong>ACArrange_t</strong> type and accepts one of the following:
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">ACArrange_t</span></dd>
+    <dd><span class="apidef">ACArrange_t</span><span class="apidesc"></p>
+<ul>
+<li><strong><code>AC_Horizontal</code></strong> : Horizontal arrangement.</li>
+<li><strong><code>AC_Vertical</code></strong> : Vertical arrangement.
+    </span></dd>
 </dl></li>
 </ul>
 <h4 id="checked_1"><i class="fa fa-caret-right"></i> checked<a class="headerlink" href="#checked_1" title="Permanent link">&para;</a></h4>
 <p>Specifies the index number (1-based) of the <strong>values</strong> to be checked. If this parameter is not specified neither item is checked.
 <dl class="apidl">
     <dt><strong>Type</strong></dt>
-    <dd><span class="apidef" style="width:230px;">uint8_t</span></dd>
+    <dd><span class="apidef">uint8_t</span><span class="apidesc"></span></dd>
 </dl></p>
 <h3 id="public-member-functions_4"><i class="fa fa-code"></i> Public member functions<a class="headerlink" href="#public-member-functions_4" title="Permanent link">&para;</a></h3>
 <h4 id="typeof_4"><i class="fa fa-caret-right"></i> typeOf<a class="headerlink" href="#typeof_4" title="Permanent link">&para;</a></h4>
@@ -1841,7 +2046,7 @@ Returns type of AutoConnectElement.
 Adds an option for the radio button.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">value</span>An option string to add to the radio button.</dd>
+    <dd><span class="apidef">value</span><span class="apidesc">An option string to add to the radio button.</span></dd>
 </dl></p>
 <h4 id="check"><i class="fa fa-caret-right"></i> check<a class="headerlink" href="#check" title="Permanent link">&para;</a></h4>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">check(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">value)</span>
@@ -1849,7 +2054,7 @@ Adds an option for the radio button.
 Indicates the check of the specified option for the radio buttons. You can use the <strong>check</strong> function for checking dynamically with arbitrary of the radio button.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">value</span>An option string to be checked.</dd>
+    <dd><span class="apidef">value</span><span class="apidesc">An option string to be checked.</span></dd>
 </dl></p>
 <h4 id="empty"><i class="fa fa-caret-right"></i> empty<a class="headerlink" href="#empty" title="Permanent link">&para;</a></h4>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">empty(</span><span style="color: #66d9ef">const</span> <span style="color: #66d9ef">size_t</span> <span style="color: #f8f8f2">reserve</span> <span style="color: #f92672">=</span> <span style="color: #ae81ff">0</span><span style="color: #f8f8f2">)</span>
@@ -1857,7 +2062,7 @@ Indicates the check of the specified option for the radio buttons. You can use t
 Clear the array of option strings that AutoConnectRadio has in values. When a <strong><em>reserve</em></strong> parameter is specified, a vector container of that size is reserved.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">reserve</span>Reserved size of a container for option strings.</dd>
+    <dd><span class="apidef">reserve</span><span class="apidesc">Reserved size of a container for option strings.</span></dd>
 </dl></p>
 <h4 id="operator"><i class="fa fa-caret-right"></i> operator &#91;&nbsp;&#93;<a class="headerlink" href="#operator" title="Permanent link">&para;</a></h4>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #66d9ef">operator</span><span style="color: #f8f8f2">[]</span> <span style="color: #f8f8f2">(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">std</span><span style="color: #f92672">::</span><span style="color: #66d9ef">size_t</span> <span style="color: #f8f8f2">n)</span>
@@ -1865,7 +2070,7 @@ Clear the array of option strings that AutoConnectRadio has in values. When a <s
 Returns the option string of the index specified by <strong><em>n</em></strong>.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
-    <dd><span class="apidef">n</span>Index of values array to return.</dd>
+    <dd><span class="apidef">n</span><span class="apidesc">Index of values array to return.</span></dd>
 </dl></p>
 <h4 id="value_4"><i class="fa fa-caret-right"></i> value<a class="headerlink" href="#value_4" title="Permanent link">&para;</a></h4>
 <p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>  <span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">value(</span><span style="color: #66d9ef">void</span><span style="color: #f8f8f2">)</span> <span style="color: #66d9ef">const</span>
@@ -1876,6 +2081,59 @@ Returns current checked option of the radio buttons.
     <dd>A String of an option current checked. If there is no checked option, a null string returned.</dd>
 </dl></p>
 <h2 id="autoconnectselect">AutoConnectSelect<a class="headerlink" href="#autoconnectselect" title="Permanent link">&para;</a></h2>
+<h3 id="constructor_5"><i class="fa fa-code"></i> Constructor<a class="headerlink" href="#constructor_5" title="Permanent link">&para;</a></h3>
+<p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConnectSelect(</span><span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">name</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">std</span><span style="color: #f92672">::</span><span style="color: #f8f8f2">vector</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">String</span><span style="color: #f92672">&gt;</span> <span style="color: #66d9ef">const</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">options</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">{},</span> <span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">label</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">)</span>
+</pre></div>
+<dl class="apidl">
+    <dt><strong>Parameters</strong></dt>
+    <dd><span class="apidef">name</span><span class="apidesc">The element name.</span></dd>
+    <dd><span class="apidef">options</span><span class="apidesc">An array of options of the select element. Specifies an <a href="https://en.cppreference.com/w/cpp/container/vector">std::vector</a> object.</span></dd>
+    <dd><span class="apidef">label</span><span class="apidesc">Label string.</span></dd>
+</dl></p>
+<h3 id="public-member-variables_5"><i class="fa fa-code"></i> Public member variables<a class="headerlink" href="#public-member-variables_5" title="Permanent link">&para;</a></h3>
+<h4 id="name_5"><i class="fa fa-caret-right"></i> name<a class="headerlink" href="#name_5" title="Permanent link">&para;</a></h4>
+<p>The element name.
+<dl class="apidl">
+    <dt><strong>Type</strong></dt>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
+</dl></p>
+<h4 id="options"><i class="fa fa-caret-right"></i> options<a class="headerlink" href="#options" title="Permanent link">&para;</a></h4>
+<p>An array of String type for the selection options. It is an initialization list can be used. The <code class="codehilite"><span style="color: #f8f8f2">&lt;</span><span style="color: #f92672">option</span> <span style="color: #a6e22e">value</span><span style="color: #f8f8f2">&gt;</span></code> tags will be generated from each entry in the options.
+<dl class="apidl">
+    <dt><strong>Type</strong></dt>
+    <dd><span class="apidef">std::vector&lt;String&gt;</span><span class="apidesc"></span></dd>
+</dl></p>
+<h4 id="label_3"><i class="fa fa-caret-right"></i> label<a class="headerlink" href="#label_3" title="Permanent link">&para;</a></h4>
+<p>A label is an optional string. A label will be arranged in the top of the selection list.
+<dl class="apidl">
+    <dt><strong>Type</strong></dt>
+    <dd><span class="apidef">String</span><span class="apidesc"></span></dd>
+</dl></p>
+<h3 id="public-member-functions_5"><i class="fa fa-code"></i> Public member functions<a class="headerlink" href="#public-member-functions_5" title="Permanent link">&para;</a></h3>
+<h4 id="typeof_5"><i class="fa fa-caret-right"></i> typeOf<a class="headerlink" href="#typeof_5" title="Permanent link">&para;</a></h4>
+<p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">ACElement_t</span> <span style="color: #f8f8f2">typeOf(</span><span style="color: #66d9ef">void</span><span style="color: #f8f8f2">)</span>
+</pre></div>
+Returns type of AutoConnectElement.
+<dl class="apidl">
+    <dt><strong>Return value</strong></dt>
+    <dd>AC_Select</dd>
+</dl></p>
+<h4 id="add_1"><i class="fa fa-caret-right"></i> add<a class="headerlink" href="#add_1" title="Permanent link">&para;</a></h4>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">add(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">option)</span>
+</pre></div>
+
+<h4 id="empty_1"><i class="fa fa-caret-right"></i> empty<a class="headerlink" href="#empty_1" title="Permanent link">&para;</a></h4>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #f8f8f2">empty(</span><span style="color: #66d9ef">const</span> <span style="color: #66d9ef">size_t</span> <span style="color: #f8f8f2">reserve</span> <span style="color: #f92672">=</span> <span style="color: #ae81ff">0</span><span style="color: #f8f8f2">)</span>
+</pre></div>
+
+<h4 id="size"><i class="fa fa-caret-right"></i> size<a class="headerlink" href="#size" title="Permanent link">&para;</a></h4>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">size_t</span> <span style="color: #f8f8f2">size(</span><span style="color: #66d9ef">void</span><span style="color: #f8f8f2">)</span>
+</pre></div>
+
+<h4 id="operator_1"><i class="fa fa-caret-right"></i> operator &#91;&nbsp;&#93;<a class="headerlink" href="#operator_1" title="Permanent link">&para;</a></h4>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&amp;</span> <span style="color: #66d9ef">operator</span><span style="color: #f8f8f2">[]</span> <span style="color: #f8f8f2">(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">std</span><span style="color: #f92672">::</span><span style="color: #66d9ef">size_t</span> <span style="color: #f8f8f2">n)</span>
+</pre></div>
+
 <h2 id="autoconnectsubmit">AutoConnectSubmit<a class="headerlink" href="#autoconnectsubmit" title="Permanent link">&para;</a></h2>
 <h2 id="autoconnecttext">AutoConnectText<a class="headerlink" href="#autoconnecttext" title="Permanent link">&para;</a></h2>
 <div class="footnote">
diff --git a/docs/apiextra.html b/docs/apiextra.html
index 034a0f2..aa9d276 100644
--- a/docs/apiextra.html
+++ b/docs/apiextra.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -616,8 +618,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -628,8 +642,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
diff --git a/docs/basicusage.html b/docs/basicusage.html
index 4ca29fb..f386e03 100644
--- a/docs/basicusage.html
+++ b/docs/basicusage.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -707,8 +709,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -719,8 +733,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
diff --git a/docs/changelog.html b/docs/changelog.html
index 58905ef..2b730c0 100644
--- a/docs/changelog.html
+++ b/docs/changelog.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -578,8 +580,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -590,8 +604,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
diff --git a/docs/css/paragraph.css b/docs/css/paragraph.css
index 2d42d1b..7fe9434 100644
--- a/docs/css/paragraph.css
+++ b/docs/css/paragraph.css
@@ -35,13 +35,19 @@
   color: rgba(102,217,224,1);
 }
 
+.apidl {
+  margin-left: 20px;
+}
+
 .apidef {
-  display: inline-block;
+  display: block;
+  float: left;
   width: 100px;
 }
 
-.apidl {
-  margin-left: 20px;
+.apidesc {
+  display: inline-block;
+  width: calc(100% - 100px);
 }
 
 .ulsty-edit > li:before {
diff --git a/docs/datatips.html b/docs/datatips.html
new file mode 100644
index 0000000..72abd16
--- /dev/null
+++ b/docs/datatips.html
@@ -0,0 +1,1076 @@
+
+
+
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      <meta http-equiv="x-ua-compatible" content="ie=edge">
+      
+        <meta name="description" content="ESP8266/ESP32 WLAN configuration at run time with web interface">
+      
+      
+        <link rel="canonical" href="https://Hieromon.github.io/AutoConnect/datatips.html">
+      
+      
+        <meta name="author" content="Hieromon Ikasamo">
+      
+      
+        <meta name="lang:clipboard.copy" content="Copy to clipboard">
+      
+        <meta name="lang:clipboard.copied" content="Copied to clipboard">
+      
+        <meta name="lang:search.language" content="en">
+      
+        <meta name="lang:search.pipeline.stopwords" content="True">
+      
+        <meta name="lang:search.pipeline.trimmer" content="True">
+      
+        <meta name="lang:search.result.none" content="No matching documents">
+      
+        <meta name="lang:search.result.one" content="1 matching document">
+      
+        <meta name="lang:search.result.other" content="# matching documents">
+      
+        <meta name="lang:search.tokenizer" content="[\s\-]+">
+      
+      <link rel="shortcut icon" href="assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-3.3.0">
+    
+    
+      
+        <title>Tips for data conversion - AutoConnect for ESP8266/ESP32</title>
+      
+    
+    
+      <link rel="stylesheet" href="assets/stylesheets/application.572ca0f0.css">
+      
+        <link rel="stylesheet" href="assets/stylesheets/application-palette.22915126.css">
+      
+      
+        
+        
+        <meta name="theme-color" content="#3f51b5">
+      
+    
+    
+      <script src="assets/javascripts/modernizr.962652e9.js"></script>
+    
+    
+      
+        <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono">
+        <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
+      
+    
+    <link rel="stylesheet" href="assets/fonts/material-icons.css">
+    
+    
+      <link rel="stylesheet" href="css/paragraph.css">
+    
+      <link rel="stylesheet" href="css/extra.css">
+    
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
+    
+      
+        <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
+<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","None")</script>
+      
+    
+    
+  </head>
+  
+    
+    
+    <body dir="ltr" data-md-color-primary="indigo" data-md-color-accent="indigo">
+  
+    <svg class="md-svg">
+      <defs>
+        
+        
+          <svg xmlns="http://www.w3.org/2000/svg" width="416" height="448"
+    viewBox="0 0 416 448" id="__github">
+  <path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19-18.125
+        8.5-18.125-8.5-10.75-19-3.125-20.5 3.125-20.5 10.75-19 18.125-8.5
+        18.125 8.5 10.75 19 3.125 20.5zM320 304q0 10-3.125 20.5t-10.75
+        19-18.125 8.5-18.125-8.5-10.75-19-3.125-20.5 3.125-20.5 10.75-19
+        18.125-8.5 18.125 8.5 10.75 19 3.125 20.5zM360
+        304q0-30-17.25-51t-46.75-21q-10.25 0-48.75 5.25-17.75 2.75-39.25
+        2.75t-39.25-2.75q-38-5.25-48.75-5.25-29.5 0-46.75 21t-17.25 51q0 22 8
+        38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0
+        37.25-1.75t35-7.375 30.5-15 20.25-25.75 8-38.375zM416 260q0 51.75-15.25
+        82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5-41.75
+        1.125q-19.5 0-35.5-0.75t-36.875-3.125-38.125-7.5-34.25-12.875-30.25-20.25-21.5-28.75q-15.5-30.75-15.5-82.75
+        0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25
+        30.875q36.75-8.75 77.25-8.75 37 0 70 8 26.25-20.5
+        46.75-30.25t47.25-9.75q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34
+        99.5z" />
+</svg>
+        
+      </defs>
+    </svg>
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
+    
+      <a href="#convert-autoconnectelements-value-to-actual-data-type" tabindex="1" class="md-skip">
+        Skip to content
+      </a>
+    
+    
+      <header class="md-header" data-md-component="header">
+  <nav class="md-header-nav md-grid">
+    <div class="md-flex">
+      <div class="md-flex__cell md-flex__cell--shrink">
+        <a href="https://Hieromon.github.io/AutoConnect/" title="AutoConnect for ESP8266/ESP32" class="md-header-nav__button md-logo">
+          
+            <img src="images/arduino-logo.svg" width="24" height="24">
+          
+        </a>
+      </div>
+      <div class="md-flex__cell md-flex__cell--shrink">
+        <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
+      </div>
+      <div class="md-flex__cell md-flex__cell--stretch">
+        <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
+          
+            
+              <span class="md-header-nav__topic">
+                AutoConnect for ESP8266/ESP32
+              </span>
+              <span class="md-header-nav__topic">
+                Tips for data conversion
+              </span>
+            
+          
+        </div>
+      </div>
+      <div class="md-flex__cell md-flex__cell--shrink">
+        
+          
+            <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
+            
+<div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
+      <label class="md-icon md-search__icon" for="__search"></label>
+      <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
+        &#xE5CD;
+      </button>
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="result">
+          <div class="md-search-result__meta">
+            Type to start searching
+          </div>
+          <ol class="md-search-result__list"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+          
+        
+      </div>
+      
+        <div class="md-flex__cell md-flex__cell--shrink">
+          <div class="md-header-nav__source">
+            
+
+
+  
+
+
+  <a href="https://github.com/Hieromon/AutoConnect" title="Go to repository" class="md-source" data-md-source="github">
+    
+      <div class="md-source__icon">
+        <svg viewBox="0 0 24 24" width="24" height="24">
+          <use xlink:href="#__github" width="24" height="24"></use>
+        </svg>
+      </div>
+    
+    <div class="md-source__repository">
+      Hieromon/AutoConnect
+    </div>
+  </a>
+
+          </div>
+        </div>
+      
+    </div>
+  </nav>
+</header>
+    
+    <div class="md-container">
+      
+        
+      
+      
+        
+
+  
+
+<nav class="md-tabs md-tabs--active" data-md-component="tabs">
+  <div class="md-tabs__inner md-grid">
+    <ul class="md-tabs__list">
+      
+        
+  <li class="md-tabs__item">
+    
+      <a href="index.html" title="Overview" class="md-tabs__link">
+        Overview
+      </a>
+    
+  </li>
+
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+  
+  
+    <li class="md-tabs__item">
+      
+        <a href="acintro.html" title="Custom Web pages" class="md-tabs__link">
+          Custom Web pages
+        </a>
+      
+    </li>
+  
+
+      
+        
+  
+  
+    <li class="md-tabs__item">
+      
+        <a href="api.html" title="Library APIs" class="md-tabs__link">
+          Library APIs
+        </a>
+      
+    </li>
+  
+
+      
+        
+  
+  
+    <li class="md-tabs__item">
+      
+        <a href="howtoembed.html" title="Examples" class="md-tabs__link md-tabs__link--active">
+          Examples
+        </a>
+      
+    </li>
+  
+
+      
+        
+      
+        
+      
+        
+      
+    </ul>
+  </div>
+</nav>
+      
+      <main class="md-main">
+        <div class="md-main__inner md-grid" data-md-component="container">
+          
+            
+              <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    <nav class="md-nav md-nav--primary" data-md-level="0">
+  <label class="md-nav__title md-nav__title--site" for="__drawer">
+    <a href="https://Hieromon.github.io/AutoConnect/" title="AutoConnect for ESP8266/ESP32" class="md-nav__button md-logo">
+      
+        <img src="images/arduino-logo.svg" width="48" height="48">
+      
+    </a>
+    AutoConnect for ESP8266/ESP32
+  </label>
+  
+    <div class="md-nav__source">
+      
+
+
+  
+
+
+  <a href="https://github.com/Hieromon/AutoConnect" title="Go to repository" class="md-source" data-md-source="github">
+    
+      <div class="md-source__icon">
+        <svg viewBox="0 0 24 24" width="24" height="24">
+          <use xlink:href="#__github" width="24" height="24"></use>
+        </svg>
+      </div>
+    
+    <div class="md-source__repository">
+      Hieromon/AutoConnect
+    </div>
+  </a>
+
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="index.html" title="Overview" class="md-nav__link">
+      Overview
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="gettingstarted.html" title="Getting started" class="md-nav__link">
+      Getting started
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="menu.html" title="AutoConnect menu" class="md-nav__link">
+      AutoConnect menu
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="basicusage.html" title="Basic usage" class="md-nav__link">
+      Basic usage
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="advancedusage.html" title="Advanced usage" class="md-nav__link">
+      Advanced usage
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item md-nav__item--nested">
+    
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6">
+    
+    <label class="md-nav__link" for="nav-6">
+      Custom Web pages
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-6">
+        Custom Web pages
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+        
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="acintro.html" title="Custom Web pages with AutoConnect" class="md-nav__link">
+      Custom Web pages with AutoConnect
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="acelements.html" title="AutoConnectElements" class="md-nav__link">
+      AutoConnectElements
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="acjson.html" title="Custom Web pages with JSON" class="md-nav__link">
+      Custom Web pages with JSON
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="achandling.html" title="Handling the custom Web pages" class="md-nav__link">
+      Handling the custom Web pages
+    </a>
+  </li>
+
+        
+      </ul>
+    </nav>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item md-nav__item--nested">
+    
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7">
+    
+    <label class="md-nav__link" for="nav-7">
+      Library APIs
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-7">
+        Library APIs
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+        
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="api.html" title="AutoConnect API" class="md-nav__link">
+      AutoConnect API
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="apiaux.html" title="AutoConnectAux API" class="md-nav__link">
+      AutoConnectAux API
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="apiconfig.html" title="AutoConnectConfig API" class="md-nav__link">
+      AutoConnectConfig API
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="apielements.html" title="AutoConnectElements API" class="md-nav__link">
+      AutoConnectElements API
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="apiextra.html" title="Something extra" class="md-nav__link">
+      Something extra
+    </a>
+  </li>
+
+        
+      </ul>
+    </nav>
+  </li>
+
+    
+      
+      
+      
+
+  
+
+
+  <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-8" type="checkbox" id="nav-8" checked>
+    
+    <label class="md-nav__link" for="nav-8">
+      Examples
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-8">
+        Examples
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+        
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="howtoembed.html" title="How to embed" class="md-nav__link">
+      How to embed
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+  
+
+
+  <li class="md-nav__item md-nav__item--active">
+    
+    <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
+    
+    
+      <label class="md-nav__link md-nav__link--active" for="__toc">
+        Tips for data conversion
+      </label>
+    
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link md-nav__link--active">
+      Tips for data conversion
+    </a>
+    
+      
+<nav class="md-nav md-nav--secondary">
+  
+  
+  
+    <label class="md-nav__title" for="__toc">Table of contents</label>
+    <ul class="md-nav__list" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#convert-autoconnectelements-value-to-actual-data-type" title="Convert AutoConnectElements value to actual data type" class="md-nav__link">
+    Convert AutoConnectElements value to actual data type
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#integer" title=" Integer" class="md-nav__link">
+     Integer
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#float" title=" Float" class="md-nav__link">
+     Float
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#date-time" title=" Date &amp; Time" class="md-nav__link">
+     Date &amp; Time
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#ip-adderss" title=" IP adderss" class="md-nav__link">
+     IP adderss
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#validation-for-the-value" title="Validation for the value" class="md-nav__link">
+    Validation for the value
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#url" title=" URL" class="md-nav__link">
+     URL
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#dns-hostname" title=" DNS hostname" class="md-nav__link">
+     DNS hostname
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#email-address-1" title=" email address 1" class="md-nav__link">
+     email address 1
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#ip-address" title=" IP Address" class="md-nav__link">
+     IP Address
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#date-as-mmddyyyy-2" title=" Date as MM/DD/YYYY 2" class="md-nav__link">
+     Date as MM/DD/YYYY 2
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+      
+      
+      
+      
+    </ul>
+  
+</nav>
+    
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
+    </a>
+  </li>
+
+        
+      </ul>
+    </nav>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="faq.html" title="FAQ" class="md-nav__link">
+      FAQ
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="changelog.html" title="Change log" class="md-nav__link">
+      Change log
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="license.html" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+<nav class="md-nav md-nav--secondary">
+  
+  
+  
+    <label class="md-nav__title" for="__toc">Table of contents</label>
+    <ul class="md-nav__list" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#convert-autoconnectelements-value-to-actual-data-type" title="Convert AutoConnectElements value to actual data type" class="md-nav__link">
+    Convert AutoConnectElements value to actual data type
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#integer" title=" Integer" class="md-nav__link">
+     Integer
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#float" title=" Float" class="md-nav__link">
+     Float
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#date-time" title=" Date &amp; Time" class="md-nav__link">
+     Date &amp; Time
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#ip-adderss" title=" IP adderss" class="md-nav__link">
+     IP adderss
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#validation-for-the-value" title="Validation for the value" class="md-nav__link">
+    Validation for the value
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#url" title=" URL" class="md-nav__link">
+     URL
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#dns-hostname" title=" DNS hostname" class="md-nav__link">
+     DNS hostname
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#email-address-1" title=" email address 1" class="md-nav__link">
+     email address 1
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#ip-address" title=" IP Address" class="md-nav__link">
+     IP Address
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#date-as-mmddyyyy-2" title=" Date as MM/DD/YYYY 2" class="md-nav__link">
+     Date as MM/DD/YYYY 2
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+      
+      
+      
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          <div class="md-content">
+            <article class="md-content__inner md-typeset">
+              
+                
+                
+                  <h1>Tips for data conversion</h1>
+                
+                <h2 id="convert-autoconnectelements-value-to-actual-data-type">Convert AutoConnectElements value to actual data type<a class="headerlink" href="#convert-autoconnectelements-value-to-actual-data-type" title="Permanent link">&para;</a></h2>
+<p>The value of the AutoConnectElements field of the custom Web pages consists of String type for all. Sketches will need to convert them to the actual data type. And then if the data type required for processing in the sketch is not a String type, it is necessary to convert to String type when storing to the AutoConenctElements value.</p>
+<p>AutoConnect library does not provide the data conversion utility, and its function depends on Arduino language functions or functions of the type class. However, commonly used data conversion methods are generally similar.</p>
+<p>Here, represent examples the typical method for the data type conversion for the AutoConnectElements value of custom Web pages.</p>
+<h3 id="integer"><i class="fa fa-exchange"></i> Integer<a class="headerlink" href="#integer" title="Permanent link">&para;</a></h3>
+<p>Use <a href="https://www.arduino.cc/reference/en/language/variables/conversion/intcast/">int()</a> or <a href="https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/toint/">toInt() of String</a>.</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">input</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">aux.getElement</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&gt;</span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">&quot;INPUT&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #66d9ef">int</span> <span style="color: #f8f8f2">value</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">input.value.toInt();</span>
+</pre></div>
+
+<h3 id="float"><i class="fa fa-exchange"></i> Float<a class="headerlink" href="#float" title="Permanent link">&para;</a></h3>
+<p>Use <a href="https://www.arduino.cc/reference/en/language/variables/conversion/floatcast/">float()</a> or <a href="https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/tofloat/">toFloat() of String</a>.</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">input</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">aux.getElement</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&gt;</span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">&quot;INPUT&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #66d9ef">float</span> <span style="color: #f8f8f2">value</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">input.value.toFloat();</span>
+</pre></div>
+
+<h3 id="date-time"><i class="fa fa-exchange"></i> Date &amp; Time<a class="headerlink" href="#date-time" title="Permanent link">&para;</a></h3>
+<p>The easiest way is to use the <a href="https://www.pjrc.com/teensy/td_libs_Time.html">Arduino Time Library</a>. Sketches must accommodate differences in date and time formats depending on the time zone. You can absorb the difference in DateTime format by using <code>sscanf</code> function.<sup id="fnref:1"><a class="footnote-ref" href="#fn:1" rel="footnote">1</a></sup></p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;TimeLib.h&gt;</span>
+
+<span style="color: #66d9ef">time_t</span> <span style="color: #f8f8f2">tm;</span>
+<span style="color: #66d9ef">int</span> <span style="color: #f8f8f2">Year,</span> <span style="color: #f8f8f2">Month,</span> <span style="color: #f8f8f2">Day,</span> <span style="color: #f8f8f2">Hour,</span> <span style="color: #f8f8f2">Minute,</span> <span style="color: #f8f8f2">Second;</span>
+
+<span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">input</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">aux.getElement</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&gt;</span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">&quot;INPUT&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">sscanf(input.value.c_str(),</span> <span style="color: #e6db74">&quot;%d-%d-%d %d:%d:%d&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f92672">&amp;</span><span style="color: #f8f8f2">Year,</span> <span style="color: #f92672">&amp;</span><span style="color: #f8f8f2">Month,</span> <span style="color: #f92672">&amp;</span><span style="color: #f8f8f2">Day,</span> <span style="color: #f92672">&amp;</span><span style="color: #f8f8f2">Hour,</span> <span style="color: #f92672">&amp;</span><span style="color: #f8f8f2">Minute,</span> <span style="color: #f92672">&amp;</span><span style="color: #f8f8f2">Second);</span>
+<span style="color: #f8f8f2">tm.Year</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">CalendarYrToTm(Year);</span>
+<span style="color: #f8f8f2">tm.Month</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">Month;</span>
+<span style="color: #f8f8f2">tm.Day</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">Day;</span>
+<span style="color: #f8f8f2">tm.Hour</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">Hour;</span>
+<span style="color: #f8f8f2">tm.Minute</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">Minute;</span>
+<span style="color: #f8f8f2">tm.Second</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">Second;</span>
+</pre></div>
+
+<h3 id="ip-adderss"><i class="fa fa-exchange"></i> IP adderss<a class="headerlink" href="#ip-adderss" title="Permanent link">&para;</a></h3>
+<p>To convert a String to an IP address, use <strong>IPAddress::fromString</strong>. To stringize an instance of an IP address, use <strong>IPAddress::toString</strong>.</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">IPAddress</span> <span style="color: #f8f8f2">ip;</span>
+<span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&amp;</span> <span style="color: #f8f8f2">input</span> <span style="color: #f8f8f2">aux.getElement</span><span style="color: #f92672">&lt;</span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&gt;</span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">&quot;INPUT&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ip.fromString(input.value);</span>
+<span style="color: #f8f8f2">input.value</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">ip.toString();</span>
+</pre></div>
+
+<h2 id="validation-for-the-value">Validation for the value<a class="headerlink" href="#validation-for-the-value" title="Permanent link">&para;</a></h2>
+<p>In order for data to be correctly converted from a string, the input data must be consistent with the format. How to implement strict validation in sketches depends on various perspectives and the power of tiny devices is not enough to implement a complete lexical analysis. But you can reduce the burden for data verification using the <strong>pattern</strong> of AutoConnectInput.</p>
+<p>By giving a <a href="achandling.html#check-data-against-on-submission"><strong>pattern</strong></a> to <a href="apielements.html#pattern">AutoConnectInput</a>, you can find errors in data styles while typing in custom Web pages. The pattern is specified by <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions"><strong>regular expression</strong></a>. If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. Refer to <a href="achandling.html#check-data-against-on-submission">Handling the custom Web pages</a> section.</p>
+<div class="admonition caution">
+<p class="admonition-title">Regular Expressions for JavaScript</p>
+<p>Regular expressions specified in the AutoConnectInput pattern conforms to the <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions">JavaScript specification</a>.</p>
+</div>
+<p>Here, represent examples the typical regular expression for the input validation.</p>
+<h3 id="url"><i class="far fa-check-square"></i> URL<a class="headerlink" href="#url" title="Permanent link">&para;</a></h3>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>^\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$
+</pre></div>
+
+<h3 id="dns-hostname"><i class="far fa-check-square"></i> DNS hostname<a class="headerlink" href="#dns-hostname" title="Permanent link">&para;</a></h3>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\-]*[A-Za-z0-9])$
+</pre></div>
+
+<h3 id="email-address-1"><i class="far fa-check-square"></i> email address <sup id="fnref2:1"><a class="footnote-ref" href="#fn:1" rel="footnote">1</a></sup><a class="headerlink" href="#email-address-1" title="Permanent link">&para;</a></h3>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>^[a-zA-Z0-9.!#$%&amp;&#39;*+\/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$
+</pre></div>
+
+<h3 id="ip-address"><i class="far fa-check-square"></i> IP Address<a class="headerlink" href="#ip-address" title="Permanent link">&para;</a></h3>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$
+</pre></div>
+
+<h3 id="date-as-mmddyyyy-2"><i class="far fa-check-square"></i> Date as MM/DD/YYYY <sup id="fnref:2"><a class="footnote-ref" href="#fn:2" rel="footnote">2</a></sup><a class="headerlink" href="#date-as-mmddyyyy-2" title="Permanent link">&para;</a></h3>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>^(0[1-9]|1[012])[- \/.](0[1-9]|[12][0-9]|3[01])[- \/.](19|20)\d\d$
+</pre></div>
+
+<div class="admonition caution">
+<p class="admonition-title">Contain with backquote</p>
+<p>If that regular expression contains a backquote it must be escaped by backquote duplication.</p>
+</div>
+<div class="footnote">
+<hr />
+<ol>
+<li id="fn:1">
+<p>This regular expression does not fully support the format of the e-mail address requested in <a href="https://tools.ietf.org/html/rfc5322">RFC5322</a>.&#160;<a class="footnote-backref" href="#fnref:1" rev="footnote" title="Jump back to footnote 1 in the text">&#8617;</a><a class="footnote-backref" href="#fnref2:1" rev="footnote" title="Jump back to footnote 1 in the text">&#8617;</a></p>
+</li>
+<li id="fn:2">
+<p>This regular expression does not consider semantic constraints. It is not possible to detect errors that do not exist as actual dates.&#160;<a class="footnote-backref" href="#fnref:2" rev="footnote" title="Jump back to footnote 2 in the text">&#8617;</a></p>
+</li>
+</ol>
+</div>
+                
+                  
+                
+              
+              
+                
+
+
+              
+            </article>
+          </div>
+        </div>
+      </main>
+      
+        
+<footer class="md-footer">
+  
+    <div class="md-footer-nav">
+      <nav class="md-footer-nav__inner md-grid">
+        
+          <a href="howtoembed.html" title="How to embed" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
+            </div>
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  Previous
+                </span>
+                How to embed
+              </span>
+            </div>
+          </a>
+        
+        
+          <a href="menuize.html" title="Constucting the menu" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  Next
+                </span>
+                Constucting the menu
+              </span>
+            </div>
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
+            </div>
+          </a>
+        
+      </nav>
+    </div>
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-footer-copyright">
+        
+          <div class="md-footer-copyright__highlight">
+            Copyright &copy; 2018-2019 Hieromon Ikasamo
+          </div>
+        
+        powered by
+        <a href="https://www.mkdocs.org">MkDocs</a>
+        and
+        <a href="https://squidfunk.github.io/mkdocs-material/">
+          Material for MkDocs</a>
+      </div>
+      
+        
+  <div class="md-footer-social">
+    <link rel="stylesheet" href="assets/fonts/font-awesome.css">
+    
+      <a href="https://github.com/Hieromon" class="md-footer-social__link fa fa-github"></a>
+    
+      <a href="https://twitter.com/hieromon" class="md-footer-social__link fa fa-twitter"></a>
+    
+  </div>
+
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    
+      <script src="assets/javascripts/application.a353778b.js"></script>
+      
+      <script>app.initialize({version:"1.0.4",url:{base:"."}})</script>
+      
+        <script src="js/gifffer.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/docs/faq.html b/docs/faq.html
index 266e643..17893c4 100644
--- a/docs/faq.html
+++ b/docs/faq.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -578,8 +580,8 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
     </a>
   </li>
 
@@ -590,8 +592,20 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -761,8 +775,8 @@
 </li>
       
         <li class="md-nav__item">
-  <a href="#i-can-not-see-the-custom-web-page" title=" I can not see the custom web page." class="md-nav__link">
-     I can not see the custom web page.
+  <a href="#i-cannot-see-the-custom-web-page" title=" I cannot see the custom Web page." class="md-nav__link">
+     I cannot see the custom Web page.
   </a>
   
 </li>
@@ -1013,8 +1027,8 @@
 </li>
       
         <li class="md-nav__item">
-  <a href="#i-can-not-see-the-custom-web-page" title=" I can not see the custom web page." class="md-nav__link">
-     I can not see the custom web page.
+  <a href="#i-cannot-see-the-custom-web-page" title=" I cannot see the custom Web page." class="md-nav__link">
+     I cannot see the custom Web page.
   </a>
   
 </li>
@@ -1300,8 +1314,8 @@ wdt reset
 <p>It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed.</p>
 <h2 id="i-cannot-complete-to-wi-fi-login-from-smartphone"><i class="fa fa-question-circle"></i> I cannot complete to Wi-Fi login from smartphone.<a class="headerlink" href="#i-cannot-complete-to-wi-fi-login-from-smartphone" title="Permanent link">&para;</a></h2>
 <p>Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu.</p>
-<h2 id="i-can-not-see-the-custom-web-page"><i class="fa fa-question-circle"></i> I can not see the custom web page.<a class="headerlink" href="#i-can-not-see-the-custom-web-page" title="Permanent link">&para;</a></h2>
-<p>JSON parse error</p>
+<h2 id="i-cannot-see-the-custom-web-page"><i class="fa fa-question-circle"></i> I cannot see the custom Web page.<a class="headerlink" href="#i-cannot-see-the-custom-web-page" title="Permanent link">&para;</a></h2>
+<p>If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the <a href="faq.html#3-turn-on-the-debug-log-options">AC_DEBUG</a> and rerun. If you take the message of JSON syntax error, the <a href="https://arduinojson.org/v5/assistant/">Json Assistant</a> helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect. </p>
 <h2 id="autoconnect-behaves-not-stable-with-my-sketch-yet"><i class="fa fa-question-circle"></i> AutoConnect behaves not stable with my sketch yet.<a class="headerlink" href="#autoconnect-behaves-not-stable-with-my-sketch-yet" title="Permanent link">&para;</a></h2>
 <p>If AutoConnect behavior is not stable with your sketch, you can try the following measures.</p>
 <h3 id="1-change-wifi-channel">1. Change WiFi channel<a class="headerlink" href="#1-change-wifi-channel" title="Permanent link">&para;</a></h3>
@@ -1328,7 +1342,17 @@ wdt reset
 </pre></div>
 
 <h3 id="4-reports-the-issue-to-autoconnect-repository-on-github">4. Reports the issue to AutoConnect repository on Github<a class="headerlink" href="#4-reports-the-issue-to-autoconnect-repository-on-github" title="Permanent link">&para;</a></h3>
-<p>If you can not solve AutoConnect problems please report to <a href="https://github.com/Hieromon/AutoConnect/issues">Issues</a>. And please make your question comprehensively, not a statement. Include all relevant information.</p>
+<p>If you can not solve AutoConnect problems please report to <a href="https://github.com/Hieromon/AutoConnect/issues">Issues</a>. And please make your question comprehensively, not a statement. Include all relevant information as follows.</p>
+<ul>
+<li>Hardware module</li>
+<li>Arduino core Version (including the upstream tag ID.)</li>
+<li>Operating System which you use</li>
+<li>lwIP variant</li>
+<li>Problem description</li>
+<li>If you have a STACK DUMP decoded result with formatted by the code block tag</li>
+<li>The sketch code with formatted by the code block tag</li>
+<li>Debug messages output</li>
+</ul>
 <div class="footnote">
 <hr />
 <ol>
@@ -1360,7 +1384,7 @@ wdt reset
     <div class="md-footer-nav">
       <nav class="md-footer-nav__inner md-grid">
         
-          <a href="menuize.html" title="Constucting menu" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
+          <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
             <div class="md-flex__cell md-flex__cell--shrink">
               <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
             </div>
@@ -1369,7 +1393,7 @@ wdt reset
                 <span class="md-footer-nav__direction">
                   Previous
                 </span>
-                Constucting menu
+                Custom Web pages w/o JSON
               </span>
             </div>
           </a>
diff --git a/docs/gettingstarted.html b/docs/gettingstarted.html
index 89a9be3..3f954d3 100644
--- a/docs/gettingstarted.html
+++ b/docs/gettingstarted.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -646,8 +648,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -658,8 +672,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
diff --git a/docs/howtoembed.html b/docs/howtoembed.html
index 63ddd5b..2eaf079 100644
--- a/docs/howtoembed.html
+++ b/docs/howtoembed.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -711,8 +713,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -723,8 +737,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -1046,13 +1060,13 @@
           </a>
         
         
-          <a href="menuize.html" title="Constucting menu" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
+          <a href="datatips.html" title="Tips for data conversion" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
             <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
               <span class="md-flex__ellipsis">
                 <span class="md-footer-nav__direction">
                   Next
                 </span>
-                Constucting menu
+                Tips for data conversion
               </span>
             </div>
             <div class="md-flex__cell md-flex__cell--shrink">
diff --git a/docs/images/arrow_down.png b/docs/images/arrow_down.png
new file mode 100644
index 0000000000000000000000000000000000000000..c6d30a56ed7713f5f8cfb26200137b456b6ac417
GIT binary patch
literal 1176
zcmV;J1ZVq+P)<h;3K|Lk000e1NJLTq002M$002M;1^@s6s%dfF00006VoOIv0RI60
z0RN!9r;`8x010qNS#tmY3ljhU3ljkVnw%H_00cNmL_t(|+U?rEYvX1B#_{KQCCkPH
zszL^HWKeMIdN}9}fp+MiA-J-e;fBBkdT@mXdeEVNMfV%ip>SJ!(4mF9*h@fbA;Wbj
zq&NWwI^5vW9C&bkSZ@cvHo5$iZ0U_I)jK*C()Z&y(X00*G>>|{UNcSe3CT48O8^iA
z!5+z9f*^R_Znyu^c|C^ClX;%!n5OwH$yEUN09XJ((js{efL*OtcRQWVTV2;=YW@Xy
z3}78V>D=pc0BR&{DP<49_qr}f=sJ<>y0#GF%S+-XgJg;1<CT?_5AGa5u~>A*-}xKH
zl3^ImodXa;*d%ZK%8@jM5cZt|NbAS|GJp&q1IPd}fD9l5$N(~c3?Ku@05X6KAOpw%
zGJp)=|1~Z=rEN4C3nb@*Ah1cE42Q$F$H&KA-}n3PQ<&?zbCzW}>It(cggBH^_FAph
z-<JZou4@*H#rq^bmr~XY!*HaO1Jg9ShGF=g=l$Mpx4Z8{yytli$xleS034D9DP>m(
zvAepu+V1!JfBL?E`VK%Ym%9((I{=@NoCjb7I3;-qV437A&+~rLy?7aQ)a&({5Mmv`
z7bG1ir47JT9lan3YWaNr8Gt_~e*;|CEm)TIHOYq<t=`zcXpsWIJjrDMPe?xXJny44
z$LDgnZ`8Fet7{*B$Tol_k`ILt8?NgXCIFUYIRMti;g=1P4$1YjBAkg|C+S@CR-5En
zKA$g70E7?^aLuCS8H7?A5zfX(=vbZrsPBBJaTcM`Xq0a|zR_qbM2VmL|5xje0vPSk
zkWvn&K-g$Do2A=|Z#J7Hwd5WtUP^fy1i|hE;OOXRhvZI_lanlAwBg~=Z6K&~J_4{2
zC0>o!CnqO669C`$d&A-IM*zDK5f(^3)r~NYSLa@ec=&D*1e@F2+yA_CD?AtsUP>u9
zqat9mwM84kx%gVtcq!%PU@-XY!d$@j{T_f9X-0@69>5FLdT}zewYBvotq5_&tH!Hm
zgK0!aD*nppaGDU3jKB7IKpGH|jt6eoDcb3D`jtxM0Kh=qU(ZLlfO&Pypi-$EsJqRt
zLf)u6uU4x^Nypy^a2`Q@vi39x0H`KhVF21BKb<CCO8ExBvoP_Y0L~%gNY*gg+8Pz1
z0N_E$WBO`p9ywl0`7_BM!o-IL7$cO+<*pE74uBICLEWx~J*ITSl=jMaDdlFX)j9}!
zT%_INdwY9_i;If~hG7(@KnVR_l5^9>M}1-ydAt1n{(f%;gxJR{@lye$31QawsR7b}
z5J&t>0Jn({SNzNXw}B96d@KMu5#o-I4L}D%67jJDB#DqzeCz;8AS4-|2tb?&NyjG!
z5C?*e_(TC_LC_VSIKVUrI^(qfL_yFUuMOZ51RJBx83py@LjYYV<*z#9p&nCd9rb#>
qW*ElDYHjgD_42>!(|@gd2g-j14z@r#Gj(|Y0000<MNUMnLSTZ2Ul%R_

literal 0
HcmV?d00001

diff --git a/docs/images/aux_fsbrowser.gif b/docs/images/aux_fsbrowser.gif
index 30129930bda7834b5a1e18006d728d1c16fec017..c8b4c64c97c58cad716fcc1edf9392fb83a9107a 100644
GIT binary patch
literal 248651
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%0D7@b$tWeWcPk{zM`(NyMNHu)qDTo
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
Q=HT$y=*c}7N6?-B3kx9dI{*Lx

literal 164821
zcmeFZbx>T<*DXln!Gn8nx8Uv`AcSBcxH|-bTQ?5Df_rec0Kq+Yf<x12aJq4AycvGq
zysCNgYNl%D{r#=#x_x@}z5AZtb<VD?efQcbYRaNw7CwL+<Qt^_&j0}a$Eg4S3N|(_
zH8n9C8wD2^BR4k(_kY04%gfKtFCZWwEG#T4Dk>%>CLt~+DIqE?DIz5)A@yI7mX;Ql
zmS$8{W&H4g*1(#?<}0P8E2EW_q`JDCqN1F<yxf05L0&;sLh&Q7vWm2V{D0x)O-)f$
zUyaM<!<)zt_&JvNKizQ#f-%NJv0q+)Lb3mb;Y>#2&Bx+xBoiFuyuPR-y6mPp?c&^R
zVqdIf=`EH^&o*{V3$#dywMt3xNl%Z>$jHdd%+1d)DlW+^t_&z_{Z!gRU)qab(uLJL
zh&nxoys`>_!2svyn1@GFYcQ|HqmtF5zU>3>#^&1k`r7*1+S<y$)%nepk=?bS?e(#p
zEy(uP#@5#M3wCyPpit=H;o;GL0d{z}cW|%^gS{LNUYO(m3nwQhr>Cc9|Aq7O^NWj%
z%gf8Ft1CDh{`mNa_<zU$^xf^#6a4AF@&CsIFMj<$Pk$NE-=U%sBT*o6{bzaqXHOtu
zB9Q1`QL8o-^oL;*aTt#_6#kAPU{udl{aG~hja<NSb@XTPNFtp=EVWu=iCWZKohsw8
z#?n6-d{*PRYE5MmIij8it7A>&Q$J+G4!FpR6K9H5Q#ee<n=9wawTspB)PGeiR2w!q
zu8seyHmFwYjiq_lQnS=#KUZb)S%_<;)qQ(B?_F!1QLFdm!P=kJdb2v;XDnKcwua3n
z&_hw>K-<slk$5tNe2w<T-9K^6R%LOv4SN&c<-XBsQeN22=3TSweI80WTx_uFwGC{f
zw_0lRq^ja?`{laU>}1#V^dRE4fcmZMy0FwSO@6xg-49x+wzKfKN~eFOP|*b@3_L^$
z1jY0*zkaISvo*Ne();?Ld&Q)-Inb9&KTCpju($X5`RV7PsazbueghOf8kLH_8KE-#
z!Rd%D^22K_)dfm{xJ_LWOmDUg;A;{{VN}3O6fqHoVcRfZ;zQ{hJzY$O?KnZOC?km;
z&{vz}?J{&bQI~B29Unsyf)Ps^YFCo1XHjACQ3}DvoFJ|<Se$A&PR`_k!akxK&P}-x
zNut*+N<soGsocwUu2S2TO*`X5kCtq4*v|tx`&oX+zQ`K%RethYkDw5bV9EFGsZ<QJ
z)E(2#i)N_W4;&LCp%2zr^64Xg&F`3+g_FIA;hRaTH1wvTtm>euvgegrE+S{vkE6O7
zEbj2eoaI*$dA9hBc`T=Y>>=LG=KUc+uOV~3=9ln08)gdmMh1!mjzOy?NRdCM2}|r4
zN`ZP|8xtwHG-iGz?>*mo(!}=;E}FAp&eN{*o_0&D8N5-(?h8aEM(^2rM|GXV25a31
z3^Pi$U@ZJ2rigI{CA2<bjNENXcGZij+yzUKw|xq+a_23cUhn9CVx&6OM7-03L<Qp~
zj_>Q}{<XNA5Zw=K>b91ZDDM$E47~i|hv{-zyYchL#S`PrnB8BMw*a2M5%LaK3o82+
z;iSkzOZFoY=-gjN4N|x=##GTdEB`7p2$huIt4XoV|5>)US@YcwYDHAn@2$`#`ft}N
zV)>!Eip;XJ4Aspkvvi@f1>t<ETK&qY6tS84rcP)P8300qSXiw`hG*u`kS(jfRgGNj
z;5hVH9bxI2C-#_keK>Agkyc7@zYj7YY2IIl)m!fHj1bpyO4alWh&*|OS$73-QKYew
zbe%&MdnA}X<L`(;(E)CfvAt#5$|s|q>`56qg`(&wtjPD`b4e0jPsfGXiPEPg4?MZI
zOH`|O4H?py$8;J5Iofl%KE!*fTI>r7<4?}zEnCNl0lAlyx0r(cEAf+|!<=-b9oChc
zOiErTpOYS$t{S~3j@W7b=AYayw*GkHj%*<^hbu-mkV&7)A+WFL2ZpU!F!kcuMN>D=
zdD4HzFS&;$Ar+iUxBVv6t75;QOzjMA<70ViFMm%#SP*&DllqAl&t9XLaxruG`1&N~
zIR}|)fvr!h=zG+6MxAYIGDXi{_Fp&$<|z#uFd`_hK|x8yG-MP}$9Eb=N}*e_z}8WG
z9>PTCPRoxaWcjSu4RTN{d}2e)D)e@3o0#x04ui3A{kqxsr!XrQ;QqMLG9g}OAnjEV
zxU0O7%knp2dQfu2DEsO~rYkCPF_V~@6)jPgK2xE2*;%Bc(PcKInT4wwt;^Z}GRJMy
z#<b#<mb+_87ByG7_|Pk|`3V~=*XVM|eYN*~`AzD5i0X3b8yLDb7%l&CXJ2ZDJt+`f
zumEBGO=6cHO+fUjkRTqafT3O<seV;Nt_hWRJN_X`hd8hAutHVHpG@<9sE8pRs^XS8
zn~*HX!{!20bWokP9lt8#Rr(`u5gVC*e^oAf4O0&hi724FuCO14eU6RQEx{v+?Q^Qq
zO><1o8&JaiI9jFOI<8k+RVZlAjH}<N4sNWn;IrbcHtMAWw{$GLb<jIBDsJ!j4Y{uK
zov1dgty=84zpe+aVVR-4gA7onH-t&mSd#sL^fI;lOp33ue#bFUjJeyGIZ<OP@@Hw%
zAKp|DAM=5bXn8gp-dv$s>u8X(G?U$oUlWh0b+&uAvb?O%T31{1!BQt|9lX)fr>Ev-
z!oQk*OUfby1mFZ$FK@Smw{x+(el6@Igc16*_t)}xMRc018{IIs*K+EZCa;nu0a1DT
zc<fVF)>0b`+QwaY?fzh+Z1!yQ@B(>o&Z<ps_ZGV!y4^yKsgUuL%sa1aT>UO{Rsq{g
zeNesA(7Eajq>to%k9vH;&kx3gzUHXc@pV9<z|Ft22F#=<Zn3Ys{$be}HV4tUyffzu
z#dF>mrh@i?f-X#Muoi#QZ}7z`OalmR(ot#7kfH)sx5)*wT2=RCF%RBZ;jLz(C<n`7
z*5q!}bY`GZ_g#2=kF%n2BSWW$${}96pCP9g_@PjXy5pK|07MgksPvfpUw01)1wGsU
zsMKA?rv+M5{mz;eqPr}-{JhH<CfdO?3VQ9!hkU@YJRa`aj3IwyOsnEI?zw&uKSAxt
zlXEv>A>3F5z)d-m4-IPYYQo^>3ulDfV=6>9g>Oq(U?=)c-aZ|Nqfx`usC=gwH$bny
z$|92!cVZNne({^hSx>#~SO)9!_^CC3XsJQ7M(NG9-;hEHd<`*_8?Ffi8@4IqWKk3h
z;h5_tPF_tp9ehw=_LmJCR@MhhCuKJbUnF<xjRH&sq@VRZ$L2mnk6;BzpP$%<%jZkF
zNk)ilcSfz1tD7-~I3B1C0Wduw2>CQC3As`?bw6|C%tGZZ7YyfJHUBp(f<7)JR?_)&
z{Cb*V4X#{|0Zcdyc%WLpC=(fsKOr>uE#ASHB-k!c03aZy-&NA*NmA3^=8I}aG0os#
zY>%_K49z=2Qx-$t`fE(?E4w6)=`kNa9fp_rG>#7EOAsNj=8n1>_gD7BC|k9_la$<L
z6!pdD1A^#lmQWm9{p&9OxVZ7IpisL@V)D_!=)cPD->v)fu4%a^MD-mo?E}$o*S$Xe
zS^7OvcY^8P7lz}We?mjv_Sypo_<D(S<hU-m`u0sAPG2`ltX<dkUH86a`RY!L>s?1{
z;BEi&rxD(YpP(khkDUj?tg|HHt|2M93pFd*3u<83-ONj1Fq6LA>FM70>LDy=jbP>l
z%3xkdBjZ>6nB_A-^@{RPLUJE3b5@x~q2}}0i3~(GblU-Yw6p}!EBpV6v^gjT(j&PM
zRiIE8xV3uwxrsQyy#1C`+*55G?#i7d_#D*AoW%%ip=Bs*U?3Gzn2+)o<>^qmj6f<N
z-~nvQR^|pMH)DjN9D0W-$)dhy17eFhphY_ok^!Aq!r6q8(S`x>8BVboR%b1)Y#CPi
zizrkCku-dflt^LxY;F@#9vn9|82cznvSC)D4)5E(x@7>xz<z#_p=tUioNZy=s$YaL
z!-O!A5yFvS=3taiNEmW7K!!YggT$&{&t!__OHW#mYo;%<VWe_{Gi4G0RmIgk(u2$#
z@F&V&(mg<`0Fc~*;<Rr=T7g1t9+0dYNhyL#>JD&M`6B5a8%G{i+~(IG9TD7SC)4W8
zMrQkvZpWtL^m;KwAli>lG(M}<nT#*;M=N2W!OM>cm4x_8(V^}LN9MOVcZ)dedAsY8
zn@sKjDEY$P-v%(sM$_@dQ;47{Bmr(Szsa`QPTD(9?+3a;tpTD53ey2f)1hP;C<;i(
zWbWTA(0#}X5(&wWN9@fM%HzB<zfsY}7ubKNt3;V^3jmY5i6_M)x5aC!#B`82od_Y2
zdq$Gc+ha_~Bbl>Mz#<8q_5cCVNQyqdG&I&*)Zfq7sTCY6u8k_z@QrdhhRQtPwOEu$
zTY$x0q_41VfkAL}Tb$6STW*^#>6jNASt67zk;WZBk^v;sP7+lK|9cb9CyFZHkSZpd
zKxdv{GX}7_^*}7T$?Um&6iGxc3lQTA+p|rKZjat!@wfPt6tfqJQt2xoiYm1c04oQ?
z*#V>ozMMgQ`9y6(F@nLvX{|nAXw}kF(Blb3d?d}&o1@bmvr=8uLO3i!wwaCjVWBK4
zR>Dg$Y~@yrnJ8k0ZuAu>R%|xys;N^W@r<h9T2y_CqElPIvGGx<^%U9V2v(qai`kQq
zU47fP`b>b?nAey{dYxEUr)U^u0iZw1AIm<%jon|_F#ZPwg%p_K4-2I)@cn_|e4J){
z7VT;sofg@i8Qbn0LlKxz>6@gMl)?_Iut(L1$)b||ie_My+~S;>X$~jJf88FY8<jt$
zT9i_jPu7=z@+kq0{6`9#6|0I*W}BHJY3|dj+~GY7KG82<9RTFh`R--DhAp|tu-tA)
zNGn@xr@=Q_4ljaF>B~zQFg;5xI5J~YYW%At<FRbUm_h=PFn9FuP7!~1hg3d@@4G6$
zhZtW(yYbC}32vDUCl+%5r^Non#QV|2jEuxrOL4|`1xi>^$Q9*?Z~Fl!cP`|8Sx#kz
zuwfLMgS=7S(pF_xhW78`XAy54Dov|g&8s5%F*93X$y+v`ILkxcC<jRrL<YtbvzHfJ
z-6JbvB8#O5(9)HdmnG`?csa9Xu!#Dozlv>V4bxc4*X{@~kMh`q2Z{SQ9Qy@G5TrVe
z0?a7`W9-wYrfUQ$$^{_+hc;(x^&ef7Vd4eAv*98%M`sHMp9YLfPhq#G)*|%9nAO;7
z+qN=GHsBg%*z9<u3~2@WQUuioikN$0wL@0YZKCK|mOMdRj&SxLEZYh3{3yd(ly|jy
z6k&^1SxZ=Dt5`k-*@SIsRUNRBmVFmVIzKX`aR2DE-%AMR&a5N~BxHpo6og;(YajPl
z?bV_;xgWh_Fj@mBk^s&70p!}>|E1TDlev>Gd2;xgKC{}4E&3*s`C*dT?L}B$j3(ra
z1g{#FUAG6&Z`4uR)#Z<tajHc)566r0H5H1cL}n%Q+9eL(1P}QHe&`H*BF#d+vyzXE
zpu5Y?&PXUBkJE3hc$X6jgf{=V4cRyN756O|>Saok^h=2##CRo{?>@fSJNJ#KherjF
z4a0IwxXiOGm|z4DYv)Q^kf?_Km6$w*_RzT%8bU1!LV0k1CF&p&UApTXs_|g#kL|iE
z;=1eY3e*33yyq+s9r5e)*AUV04XjS9D&wy$fd~Xe2S$5BT26~XOZq=jyKlZuWFuab
ziy#_<9+kc?zQaIfyBGu|3KuJ|sItpD+8>EEN)#CCB#OF|@qKPLP`dTITt=K6tMgSg
z%3r74LwFbW>&8wYE1^g$*nW_8MzHaXg)TVcc+baXui0POPJOt)TtEAhfjvErEn%Qt
zD7qcYE^~+7R<yikbk`ygZ125SRy6Er5Zym%Yj2_)vPPaEab#1P<Fn(_kA-0k`&Gx$
zHb4cm_ZP9pDYGXsw)Y*ezlPdhk#)Id+3$>42nzdJvGyw|Td%a*&~yD>iR>>GcJvtT
z7k74f${3Wcv1*~H%KB{bpyUEUbEbfsB9O{L_mnJz_N_(8%yDn>L_}QN#GUtqa#zaD
zmWMz8Yqz++wmgAaG74Ln=8XAw84F>IMi`Ht_?o>g8)F7LRd89PuUecsjiSI!gCCu`
z(mi|AJoy2mqETa=U1Ryqqg`?BY0<_S!*=U7e;0lc<?Web33rH{{gj-sey?o&KGHTh
z)95{E!Lr803Tek^obeCliGP1h{vGu-Faw~ulZ4uUBVz#R*(CcrFEO~qiP021aOyU9
z>b`60(RnH}!^&c13R!9zwR`Fl<}_N~G*<UCPJD!LdN3}{458G_O`z$xoDo6N3}yGs
z>**QV+R2kZ0E5&llgTVg&@5XXVwR(OmZ|$2*V8N?%^V-@6u-%waL}CS+N@ajoaEXZ
z+fy-_Nz6M{R7I0{<)C>*Zq#0435~URt*3cyngt!H1znQ`{h$TIyal7~1>>~^)29Ww
zr{uS?sPagtG8-uNPbhNkU<Vph+jy{a!@QZ);#ZSJ@1RBByhZ=+MQ<8#amQx`cX0Cv
ziqtfUv^FH%1rlWfk)m4+e1as=EG0`VrJ5`m952>;hbXv1M&9{En1p`QMBOe!!Dv8f
zQAU03j`W&tS!Dx~{<Pdcv(hNFk{ZACzIDl?4Mn0MTv8kL3wKm_kXQH9H$`^<2Eigm
zABy5uQl;j~<kRXj&Dt#DX}+a)DYSM~xo@d?BwA7yRiR)tryHe^Vf{5<Q<cm5T;BRY
z_xe%y;)0YZC<sziJ0CX+NhwR*cv{(%Ti-KT7n@#3qTN82-q3zpPbc};+=`+gi+ZgI
zN!eSw<6eI_MnMFvKWlD~=WkN-tfBXOmft{;l|_{-*kCwW*$VP<EL%130SpDL4i>Fq
z^sQ1!Zws1kC$DWbTyMsSg5Y^Qg;L9<LCclh%Po7$!ofSL`8yddlW&0=<F$}z6Nvo;
zB))b>KX})$Zb5W?#|d{)`V7S!Z_#`bZ11x3DR|F5fA_OihON||<MEzjH(1sjY@5I5
z9lS5tvnNl0iU?fa4@T_EX@k8I_QOq~NOk+bd}t64G;$r9K)VrL2aTD8CYr+1@z%cc
zz(TZO8SAio)1|CB*f%`XFa)eD_`sCrpokV)l5kLmIPk1JD4K*dm>#xhEi~4_nu8C!
z)(=OL50iTid!&zA@s477jt29O>RgXf)(^%JNA;6Oz=We|)8jOr<D8QtaL;ji!f~+H
z@ha_!_sMaw>A_a;iMrNFAl?ad{Y0(qq{j8+MEaBx@AOFP^frGJUUz)Aek#y&dU0}!
zEVG6rbB6wY11;nX>)-mT-ZQ-SXBt`=)rjLq#2M-P72J?>$~P+%z2~%ME3bR^iF!{+
zo)PCP&k&lB3yvR)?7bH}?-#kBFZibx-pX7G_wE#BFP(8;Fov9pJYS;GUNFAD0N`IK
z|DzKMxl(^Vl$W`Z?!8j~ai!gRr6Y5#Vs@>Me`WaNTBP^dSmx67`I`3)+_Lw=+6>Mb
z0=IuYckG2z{e!!PoV&ld!I!!D+I!|5a)a^X#$V<v@ZSvraRdBu8Y**pWqKQVdJ_HP
z7TR+g$9t0Se7j0}m+W?&YIZjre3w~&l-+wbxPF&^dRXx0zDxSP#O<&w<h~*QzN+^~
z^WP=&zkBql`$o5eX0wO<;D@#lSV!-}BI2It`Kl-6q+8}O-t=+U3_AMb(YNREFGA*|
zulHc!`ElXoaXw@Z9P(tC|FrD3yZZ0xl=i8K_F<#<_@5a<I2Zx_vA<P+xYLW6szaQa
zogTkAI+c0;VfH){{CvxMfB)|Y>F0KzY$zHotzxG3rhFtWjdVEqhb_fe5^mGM%n#eY
z$%F1?kzX|yt0caS#C(;kv#Xvi7moD0?Zci%wvfyEVAe<0$?x<^$y|PoyV_~IRws(t
zx-gwG%{-$cm?x833R?`G(7o=Vew|5ounD=)&U}G>edAv&{bQpRmo;_b2O|50ChobO
zp&WzL^|CMY-;WhqPsTd~ao;HCiWZsmg<_O*)fiq_j|Who;BsBPwa!eF3PGSBUtbs(
z%4p<BQ;A(Uf@|#(%EXyQ@!$LkDqyKvzII*jrWn9e?^MC3m2!O^U0b^G*qZ>^!7Uy~
zUo#GWx6)fTet<7bSz*SwhL0pL%(z*}jGH{&53WaC-F^tiz<;AuQ*8Ictk?8rc=w@q
zs_qER*w9yZ|IMxE<^PhCEXtd3KK7dds(MNESDt+GxFUfQj6V<qf0-`Js!t>zMHSyF
z#dT51i*D6)YV}>|mi!$4Cz;BjxMbgi+e+ku%0C)vNW8^Nmw>ue#UMc3I7ZyfxK+YX
zUec&eZ=Exv#w~JHhsn@`DxmSUpPJzh_mtptCpp-<NmJxsxPX?}ehH#UOX74;;Jwt%
zPSbmtXH-FLIgC7_k)M1Df*+K~Y??o)yonIhQDZG_)_KP}B=}KNWVd-P(c?-`_k#-a
zFWrytm4x*4-aZgC=$S<b>3^~-{iUz@`InG^iO=pY12fK{YXgfY<`zRM1zfnHO@>X&
zC(9HsVIzm~Qg2=R>LKCJF0D3t9P+(rBF0}vm|KlKr<4q)@E2`bO?>`Eh?x5Am$sS)
zoDPYY1>NknnuR>0iJF5jSlZ0P@Rda^BFJppETY~-idx37mbF=a;~f^YiWk{yvr3df
z7u!jiV{W%jd9N&HlQ!3#{yD=evK^9cRn~5sW07}fo9DB4r>`A=Ko_?!d^6!^U!1t!
z4mFyoC~_$O5xMM8R$SKMSY1Ed0jq4Pqr|mn-7`997-8u=s_5rgIW$fy`-P>j9x374
zzUeByUA8|g;igbU0CwrVuKR5L;{@^G*0YFc*L~BR*&HiR8zt#6MvwovRmM6Zc`1*V
zAs7SFf&9Kikv*ONG9grN?5@fq^YnGn$)*#324f&}c8H3V$!E=H-{fYV)3w8AGm3S`
zt00gq8YdYHk;6&M^f8?kvLz3j;fNkV_<Ro=kq$6fvfTng7e#?z)Z8*svE;yZy+Joi
z<waPX3n9J150$dbxU_iMJ&9+<H^$G%qLnZ`w+~lMX2^)`@{S~30O*zO#tmT<+g{cb
zqf5g;$ut=|2hu>;8&nHSnYO+p-B1jxq)Zg0HhEHH<dDo)X3vtLlDo{HuZ^7+C0L^s
zcr6VPOuEQ&gGl@&_tR0l&1til1`<jWCrDQ2`2=?May#*^_>B@sL~8O8GGAxDnV}Yw
zsbRh%l71UujAKQ)5Iwkm+!s1U^n)l*o8WEI``DmpOVV@uB#u;k0ef95Ix@po2Xdi-
z*0-4`DD9&>jo<av=gjaxgbImF0PMNyO`->&^c$d7NZe&EsgyjLc<O9wxne21nraU*
zF~23A#xA={MU-Ls?Dw5->lfbI66*JfA-=0N%ua~bK`C*!sDMDLH>#iB+0I&koK!(f
zqrL-*JOb(WL?{9@Vw^3zA5z<liLZpm+N|*SKImpDh%dBjc~^O+S<^9LnZ-<cSItHG
zRoIEsz}k&XlQ7~AnVA#S2w7Ioyiug=q)DpY-?7VK)4km!klK@tu>4rKlB##KA)0iM
zMZ|WWvUQB*uOzAS{)29Vg1TOZPI}eXIP0&>gVd1OG!A++zXAvK8+PfxfwLJ;L{L1B
z3K{MM;=*Wo2dy;6C^T_FCfPoDp|s`5J$91fpR>^OTM?bVNr|}=ROP(5v+oNu<nZj2
zoQxJ?!R({;;ctTsN&a?#C9%HLdSuEQ_+cT4Ezz$s1eh=>WE~0ksYwJpyPYhjmi1Ld
zNtm=XnJnihdqPVJaGWMMxA2%N&*J-wX*a7xl{m(f)JSXfnz?M(us*bjYt+T2g=zBU
zK>i-^XKh?n<ES-?7U@ivly+Cs4EY!giwhTh*W=O~Du65xxQ3c^Biq_zPHunKYA$$m
zD%QaM+)_tcc99D6p5yqu$5534)H8LR!0y21Ic<$4<n=k{kg->v3*Xp<I1yE^UO4LW
z#9A_|Da4ps;1T#ucA7BNSIA5q{H*x`bPs2i+{6@s*WP*^6SHwyEV+^oOkD4qJ!2TX
ze&&C*cgcR2*@jMf1j-zhtckLDv_RYq%_Tj4tBFhFv?B1lY?oSlBZs4EN$=)Cr;T)o
zUJV@qWRT#!kMu|_#j(L|BK?h<a+vz7%SQByyaB{)ACqQafDI-AqQb2B%lmAEKa*q1
zGi_xrt=hhF1si<yRmi{YvXee+A16(5`hg||74a1_@MRG!eCBGCWfh-^99~MqKSozK
zSf0(OyDDO5G0^Z?o^u6$tt~rq&~XyC&SmkcJbe6Ts@acIAL&(NgX{FMe0rg2*sD%K
zv-<P?^5U<An)-;R1Cwfw>V|{s1}og7Gmg)Yp>(~*JWc0Qexv0%7I>B1RW*A-|H?mf
zpSIqKqc-o)tNY3#%~m$9UlFZ2t9Ld&oolr&1~7Hpk9|Hp*WIUq)&0)TJS*LIQtqME
za)!vPz5`FV?vWyo4w&!T24L}mu?EI=BQ3teLcv^dZmZjG{^^a#NqZ#ss_!tr<b0L9
zYSVtL?(#<Y{k557Rro2+CotkS>DA+zA5y)yQl>r?A^o+8%w%82?QfeSQW)jS6AsPO
zyV<NB&q{?gsDTQ_tO9CzY3~M_{?tcY)t5|g-^P0(U%)F>KCklMz+-R!`<1nDZ+zd4
zL(iywY{<G-8SfL!&PM{WqUh6!oqwt=6WCUja9tcSKFRDyv?kIAAS5?Ed+X~zH`Ei#
zYj1%X-7C5Ge8NH=hXA5bLS!*Grpl%hO||UtK^R~>AHwhg6negg9P<qTk9$8#yIBfE
zq5-fZlZQ%8*R!mk4e#H7g>H3<bm=t}@DJt9B@=n@`B1{+z&GhDfBzngBDbL7-^PcY
zSv{mZ8xce`(x;|3_wzIP-rX`kE{$%V9=j86Z>pb8`a?j(x1oTmP?Bkh+qurN0GV5X
z&Y|C3U6(*^^WMg967ASMuOYyPhb|F603K8d&le;N0^x0h@<KxKR6B9m`iXP_M8=(H
z8hsnsl55xiT!KDgLn#qhA3lzpFhxI!q8y>N98q&;7bEB?ps(k%BnELmWmi8nm&~Q7
zWKLKL898ErR~7Ux3`DSjw6lV=HP^ZQFfdOAdfg_oB+$*fgS7fbf@c+JzF4w)MQU;-
z6vwa!4?4iB+fBA1&ugr(n<CXp1?pHqdL;?KZRq^T+0!2Y;v(;xe2~JslI20_7ydaw
zXx$4Tk|omU#@PV!4=TJ|TS^7OgGz%L0oPQ0#F(HzD{|^b{X*@7*Af6t>OSrQNqq9(
z?=>XOsX(Tw-DGS-A8~qg0~Pfjd)WSVu%n8PQb`INb@6P3;?jX$Ys=_`D-v#Wsq7%*
zLV*HTK%%oy6=T5CAyAX4k0^SG5;)8a0TQ(Jet8UaI08CJDt{Clbkyx7=~E`c0enGR
zArnUrVb22vn0m>5ht#c8-W`SVOoxgbNoh&`_NDG~(3JqJBCj%b6O00>oR!pe<lgD_
zM+U0mMyvWT^{YIFdN|9$sd@-?UzVt9yz@Z9;6S48aE3&00g)X3G%_zAh}&=s@=*rf
ziBxE<#v=;CF8GaeB#B3$!qbO@Bdd-_Aj{ncEVk~YwpJ0}LBfX&6ZZkDSAj*6fR|bV
z`CQo_#$z~;P##gmB?SO4<|xQGMJ#+UOk)((rO3lKNOFdJy%HK4INm`0PBm36gh{63
zQq>?=F(Oro<mw$9MWdfdnnx9c-GIbnF4G|RvQ<<XbH;`O0r>WRbLZ6%wi@EP#3L^=
zc-RK|8>{Vf_IJzyE1QAb(BX#_AXVJN!yn-KAK>O6mBBe>BIDl=b4V3eq5Z2PJg8a<
z)Pq6uND4S0z8VQOYbpCdneIT1p4`EQIZa|dxq(2{UF%71S%r^}y)2TNG>=;EaHb}y
z-tXXma7U4F8i2%XviKWF0rSYj#LDolF7Ckh^Tt_uUxzz!Kvd1ZiKF3X<FSs*iFIAI
z@uRNBzk{#&#<=Y#-tPdnxRmR|M<zSF!GD24IG_+`tybedLArn7bCOJPUE4=mN#RO&
zN8PK&O5%d=@!EQcTqg0{JIUj^(7V+}aK<8X6={bC%B;20tPw*5eL#}GK-|9)*f`Qm
zO3J7%VrboBEF|h_g9DA!>T`nw2S<`mkAHBU#*B8fdx=%Jkv_a0>hgXZ7oY|Z>wO@t
zRX9wYAc>w?$ms=dPpXDbF{cfw1y1-m&-aIGO1Wq<Ow3LTOy^u_DJiKc?@Cr)eE{r)
zVz&X8OJ)goLOJzh8P`-3B~^L3Dfnn43GFAaN8gKU%m{S%;|&3E3)FFfRR28=PdaIC
zRZrF`c6l>NtGUbs4JzykD(-~Mh;&b$eO8>k)DU->Qd*cdFrMUA1<-L%sVe<dt5rtM
z>zu98>|C99$s2Ti(*GRv5w~HCxK9BItslUwjHEcnh0rxHV5Ts<?kCWe@uvY%?))W!
zjD$`sgh^?b*=SWNzLQfLR~7<yUi}rv(SKZ-voRT~lr(%r^2fy(kffwYnE9t8R{{rB
zE8AMf`>Btg3sOdG5dSni_*eB}MV?CIBg|=u`grL**Ka~EEv`YNFI;oglImQ<nnSCq
zd71#+jZYy#dJC)K=u!|e>p#Sh5y!56Jig^?r;pr*Gxd4X57cvhHHOU!DrPi*PcB-x
z&=C#Eo+c%A6E3+BR8^3*qKd8>_w;1<(bzht{DVM$TsOGIWumlu$?$lDcQn))&G=18
zPruY85!av!@i;MbeqO+cM0R#aX=pfT)jD+<@daQQWTFV^>^>q^Y^+x1&6QlB8f@g0
zk{Rs&`RBdx^%8l7$$W}Qqo;&Y>NLqHaICoR=ZeyJK+oo91@rmILy2x2!^sMh#kHZX
zSxKc$1%<{#rDdAV!@))8U6Z+##ofU5QKhx#In!TrN<zlJ<#2{|R)1R%|65O67v(ZZ
z5i_Ak?d-dhpve7zdeqsiAiMnzr0t^n^Otn<$4<ar?@#Or#vK^|xa)?>oV(lfm&Aa^
zuXQHW&Z>uh&(|BT!QIW5GR(*3ELR(KoaO|k0~A~qxTOCcr81syiDyZ=Efq(~b1fFX
zNje#i?c+*Q*QNaZma;~)s;@-G7)iubhv<<$-)#D3NvTX`s3(y*w8aJ9;@;chflsY+
zo8lYx@W3s1I;HrPw*{5AArJCz^|wVLt%Pi?wy3s6Tec;Jw<W>bQhVEi`VyyYnjc7Z
z<XCp(g?AK`cQEv<6>WFqT7b%tJF1a87->7|E!JvfJMX|dntMB1@SXSQHVVT?xMz5R
zZ+AcP?0(d@;a1z#^R}UL*qzx7eMOE*Bsz@Jup280d<6{!93dM8@0#z$>+|%R(PI8h
z-JO|1Him~1V~$&`BU_~Jfuna(%4~?B$V7d+&MeWdWcNTDyTqA$U(n+n^LJgqw$9)^
z5G2&z){cm2-?t9Ov&Ys|-_9N(9qpaIALNQ}SX<*MjbtrtZagd>I&I|bZ5OO>k2u@6
z>e)5sfzqraM+@&ov_M;<cfWz{!K2W4xcw9qnn>y}gbDjD?9jsoOVM|TbA_gP!@5*q
z8R;+-2Uu1MtUel+19m7Kh2_Cvxlq^-Qpaq}gF@khIJSdgeaBeUgHmtDgbG-Bx?@H3
zL1oLqP{lzt_<*W#xgBy)?;Tx+eppF*_%ryRQTVV_`LJ2~;Fs-Tq4!}c0@jv(m{)e#
z(F5xoKFk6ib_c_H;D>4GM}5+;ewL%}!biUm&_Vs9c-y1l9_UEqQAGOD*xvqli?iSG
z(O;JRiM=BS_z_}?bZ?sU*ns7D)^vAH*+qBqU}5hN?0wuDc?=;vS}HppXgOX{K3WAI
z5A7YVdmsHnKN%%G*(^KS5<dB(e6j;R+O<8I^gh`~KZd5C%#@uR2p=B~pUi_#j%|<Y
z%CJu1E@wQi&f)e8!fu#yr&n4jC$?^^pH6Sq6K~T`9}7<JO%or6-A<-YpTG$SxZ57m
z8PZKWfc4D6`xHgxHHv||qt+SvA_02T*>uv`tLHeZ)-%80GaOz5oPGDPvority9+#=
z*Uzr$0$)DjofE6TaP7Wa8=jLzIgn+XKbM_TlATeFoFgxu)2O%;CIa5zCzF$T{Gz*H
z7=h8MATCa{FPM4vS$sT_A}`p=;~2{?${Q{?PrtD*Uc6R0=SfWB!ti{xdGXfm3!TU%
z#_LN#jDz&`!B|^QDizPKc=lfsJjI?bKw5heJ_(UvPpSROUDaKg{ZQGdbFtoiH{q*w
z`&|)?J*DS!-l(f%!%H=l1OC>pGksSY`&g%Ef4tGJwaKo%!N?N(SHHE1IP|ae?5^Db
zAJf9F4MoyYQm&0!uayh0KQCUJuzoSUxi)*BYK#H5U=_1qg<Jg-wNioGl#ANf!R^Sh
z^&PGq%HfU}#OMQX=S8^7KHT*N?uK#WPImK!^~OWw##80ytHF(z-Ho@;jY})sH{-?+
zkw|101rK;nsrLIOXi79-|0cwTA_U_WG(rkuy$wqw4cjMf-lUB5X^W~yj(S7&OU~Ez
z!>#6d&cJu7<1F%lncJ?n`LVpdL8qy3f8sd@nz7AWV)?t&k=!IQKgSpvRzhagw|*+^
z`6sZvw2;!=#k)<=U1kR9*%D{{Y=N~$Dn@7l+>d?Z!+mMUk7`1HyAKQ^_Z2weZ%W)!
zY59u?{3{>Ci|b^HDyPz`>ir7b8Q8>Qp&uHj+KX6L7?jnE-*OalT9GRy2gorzd=Ke*
z+yu-ryajZWP>hxwY%;ySXXUE$b8=+SH7cEP;O4S=)XipgS$=SYm1W+Rb*rZ$4msFS
z?zsvI$|D@heHwrI8C3*yRQ$>COWv<$z<!b@=gOz#PUf%qU{sZRe?Qv$P%_S*Gr+!P
z_v8Q*rQE7oeC9w!sR*OvOpfM-+&9hP*KcHh-yNvgeB-|;QqPL@G_B4LM1E9!%{!l6
z+Z-FbZbts3&UI15ee~Wp*(?k?TQ#utNYPk#I>NAq%yXwxecAeOg%Qo}flkO(!K9QG
zidBB)06n80j3#8&sj)w27>=V9@i>B>TPdnCC=FM%?a9VU;igdc%}$R1_&I+zq`vy7
z@#c-uee>q`WY)yDTqe@Fg!^o>CF<X`D)|X@N-3=Jb!r{2IlxtVaXd;0{|1f4VjQ_-
zZYMa`a<ik94)>>@`=B<AVM%KSAJ@q?ZSReF7=i6-o&voV$m*7FYcMKDI$m6eb7wTE
zm7~s?ViNKzTg3C^=+1d%>P>kUyUV?x<6InblWV+}(*dOMpEaq=gYe0!jl$uu=n(GN
z#y}K?+424DdF^0^fX~NHkt^t|+hsn_m)NYM<yOx{S8B1_(a)VJyl#8#*H;INo;8y_
z_}-Vhy;1dUUR{rm(0`YwQ|nRz9}C{nfzT*b>4M<wY_s|p;<t2^4|gK;5gmZGe9DjZ
zZS+wzt`*88^s%B0G0fS%46$ssQ2KA&RUhc%-fnpp#tAL^GA1BkGntHuQunuvpCpjQ
zn7%6^vzL5V<7l@IQRTm5O8u~mZjPg8<j0);$+4X|!^HoNInyFmj3vt^+m9vNp{kuF
z$Hjk%AkB4Lj5W_|*^f2f@1UJE!(DneT_F%loUJf|(x0v9>%ACZ0j}RCloCUEqp*@x
zTMCDwEXNM^^1S7CHZ=m5PbfINNwNdjeA-4~mE~nv4wV%H+RT+N%c-io{h))hJ}(qY
ztvJa370N3bXZIs?ngVrX3`%?VnnotyhW;kTKG~X|BOV)oSLyJ3?zYX?>b?4Y+gA#h
zlzbr6PF1c#5QbRuA08q~_XfpIsko$*j^m3yxz=qgNj^kBY6j;)nowK;N~gGW65zM$
z4&5mssd)nmp@wr(e}}j`L1>q%Xf6Ps!t+eNpS`;4q6|YOd>8vheYGExQRC0x;E8P?
z0R48apl+1bSNj5w`Utxj575*lIH$P?^C-{<%Od}#<aKJACO%zl8l?Ivc}#ek>|Tq3
zbGgx9qgCB4ykaSTTrtm>`ZuhR(Oveqh4{0i2nKba<~cgAY=`?WP05<@RtzJerQypZ
z_f41B)I<GRNGH|ph8|U&=zgBSgztc^T~~h(m3f2fB#B)Ep!IKXw;Y5r4p(7GH8-ej
zzx|Mw2Wl`JS3g4Ui}dw?GMrDiIv7JrkWlH(8sg_{=R2A1^6n9u^U?Bm8s}rx$-t`-
z`b5c_z4@FF=_2sw7@q0xBZoZ8&5=Of&ie}qvA*@9UYTd#s@~wANxuNaS?czo#S7SF
zdbLhy+Mj7f&7T?A<iwudJN}ek0H~E#g%5G)HFGS~3XAr?PCnBpZ~|a`tQa6^Y|t?p
z(0ygaroabEKojnw$MekmO`2O}EB#1M5XLr0Pxv!hS(1S;rDBko|7VO=AOmqR+Yr0X
zOmw*icA9>{5VyzAZ^n|KR~kN`x5+=_Y$X{f=PHJU8h^&S1~O7_vyF(&{!H-hVx+yS
z7!k6RMKOF#spz0n<#8@dGA3YRAc|4tRz=Vu6SQG7F|v=T=`<#%cQLUDRE}wSG^XS~
zGO;PJkAFx`P6@HrrR!`!<1Q&kGlC4zlVqtXi#MjWbTRXIR{k-$Xw2xD-(^?0=Eq6}
zA}53+p)$|`urdp>CY^2HQr(T3=`>}7yI6#qDkt8f6B!o8B8h%Hi}>PApS2;$D&8OS
z*QK#3?<9~_a$9W7H5)sN;4GAkj!ugQ()0t7$|{S(F%2SYPPro1Gw*4LXxnHizzbqi
zWK^FH>*3=0tZi@HaTY<W+FVTg#HQ-0HY5A#3fpKDs;p2oo7UJ|nnYb$tllw=VxL;f
z)6K5sDXyJ~#aSreQlS;bF<)q!f+&BR^iJVMZN8NMS7nJ{mGPjOR=LivD*aj}-TJD9
zT90d_PsbdFzs2Y4V}I4yny`PGssjI#7OZs+;xyibf!k(()q!)XO)jepjJLe%gP*Ed
zAFv?(gz3ql++3Eg10aL^@cM5qT-L|;kWn3YZAvYd?S%i*UyqjRoMSHg+WV#H<n+p7
zZf?gg|K<5caA~y*x3j|iGGtc2sHv9Q728oa<f5e&{+HVw%~6+{ptWsSipS%VSJf_m
zYx`sn&(~tkHJDCo2e_NZyQzBZ*rT;`{fWo-_h*yhgMzL-DPI4X92Dy4*6x!a-oS0n
ze|NL3J(ofUU8^L*_q#r(2&tq#@i5K}@2ysochG)3Z-N%YJz3uzHDCBohk0CJ!2r2?
z3BQo`Ca$L;%4{58^f#=Iukt{XcdD$hAyiu=4<4;gf(>pDV_OtA$u%tAWbvN46ZMVn
z`c<KzgfQcY8st-?+bvL1im}!7P(=SbZT{4|acfmtv2lH#($DADJDi>rsjfm_GJZQx
zvwv&<Ys%7;HP<z^QkC_`*|jO{AC4W{AHPYpx~9CaxP8fe->Ja-pFf_vwq&s>2g7*;
z!|~(o0i6CbeJ;(#U$9}SbKbM5k+r3~6U!P-l)rLM1RZ2>9j9ac=X1Tj#C>!*Pz=*T
z9}T+xVnY!63A+~Dg6I*d^Q=8Ix$Ic%K?pU3aUWR_bwY-vg&R|9k8GZoD~JMwn~S-R
zsRMya;2z<YrrKi{&(4+gy_OGQbSHGT1sHqq{<gV1SK12Sg=BP^_ScecX_&~@4oqLt
zrzWu1)pI}Cw9dm`(x=keWBF3rK2<hcXUj$R8?T=C2mWcg%jygA;3c*t^!lHDv7(-~
zPk4tKinNmu<y(ir>Nh6idQMlcI{h(Uj)1`(n8et=Taz!!!5Iwvnz*`$!t-m2ruw2l
zg&eB5SUr=-vsB0_)u!g=Z~Oz#>kog>0Zx6#f)(d=%@40bW8Uh;URrR&x3wli-T;TO
z1n=6apyMJbMCXdc3cO9i>*T8l_v)$Xr_RHm8oyHs>km)v>&P#X4>H>V^@7_Wfu8gD
z@^o}smb<Z!Js0UOnNorJy9v*p%lv0ar~>c(OiIsHnT*tdnA<#&@6T%!RK{OAybnur
zJ@A%ZsT0rohZQQl@5a&03?a`Cigg>A5mQd5owB3c13Gt~&85%2z1i5FTc{vx3uf$(
zc{=>z`LK#FdcEnW`?AuoP3fMMMm{}yYRNoqVdP1*%T5NHenso{dY;8U)yx~&P4f5z
zBCA0{;OZOQnHksgiE1t&F|3VHYyg}=WU74tIyy2gx(gw5vQactE!k&30Ggq>35hv6
z?FJbF^QDZL4zuS6A`6>Ij1J9L4xM2`qqG1^C&qZx3|W5zb&n2L|KGoBb4&ysfpQ)J
z9{oZsojiqw#d#iKi{5Kti$y7V;?O)|txbqtAxSn3;e{FL-Va=FdK6cBHP9wntcAw+
zLNc9I@}ffgY>W3lEvSO&slf%5`J2?Vh1BbtMsEvgU5VbnHxn%A>F)EWXcy>|E$C?(
z7>37igo+qRv9?uXn6wy}iy~5V8CYzKSfmG;U5i+Q8B)J8uq80C)2h*=GjNm@vG3(_
zv=ni!N3-=5aZNIO9c18MXW;Qx{w&GB3%4xf!sJ6Q=EGxrOIrMvmXV*On4gDHK)4to
zAk8SKTr8-?D5PI3WXdRPTP*C#DB@i#63i$XSuC2sD3)F<md_|&RxDn}DA7_Z(ZeV?
zTr4@sC<QK-T4$8rE0#WClz|t^AQ)xQOJwnw<VZ{8Xqn_$O5}N%6og9@q?r_zOBA)3
zl=MrKOqrBzOO#!iRJ==6f|*n!OH>n>)Y41T@|o1jO4RF^-nEpx>tWIuF434|(gc@i
zt}|)vm1vzXy@!{)M=)ul@4goY;i`eOX-h>r0C-~n9bsnSDgbrdAn``h$7oc_3eZQ}
zQUQGst{8~21cX;AM?%1ity`*}U;4HRgjZ{WXTfaLQ_7bO_&mvs&BtuKj@S)NVm8@I
zBHAc5TaGf?OL|G2lR$TI+jq@a%A8R5a7+6?@|EF=m04=BSdRioc9N{6ZSlUN+jz6+
zk=q)WqS-gfn)#R6)s=qI8PYvSa>y^kE8Y88V~h98)-J);L4U}e(#B30!wp{MhG20=
zFL%eYb06$~!=@lI+;6j`ZJU5<onC6<y(go=>ZM=qWy<PpTkh@3>f>GR6U^$%Apb^@
zRYcm(Q<{}>n#H${HK3(DpocX8Ih4+K+cTMkgt!ckzRYgmrGBJ51i|Xffb8eEZ9lu~
za>5E^sR-4wV>Sda@v)IeLPHT@RA0BLj&_Z*<(#zGqV!pbqWirN!E9k#0192ZFm?Gb
zefjV@xtOYoaJXGWI&0+Kex&|BrE&k)IuOxO1yQsdvtWNh0x13j`eH6oT<*Kke!Nb3
zf;cFN!-2R9DnrelC=UC|4@eMZPgI7b8p%;<%TX8tNOS=S-j%5Xc5xnz2FZH{k)@PL
z%+5M2DTI|?2q-xhj8e7#n~q#eEHpXRK4BJ?nrxr1?!c@8$~WDQSBFvF+K1yg#-MW~
z*U1rY$c0zQh37*<${hS0D^$74aX<8{4uXOi*izEjQ&<k7m8;^n*oZJ;$t{ivq_D!q
zgTg9Mm45}1q}&f__H<;2G&od-%aJOaJu`uw!oCU-;=v(04!|1%xadbD7agSOI2A@#
zBql=}SYVZt2Wir<hS>gJ%N4{)a`{+?4Ib=X9rguAAR@*7Amr*c56-xB#!s~N&9Q^c
z*%d81tOd!Ov5tpD;|DFlP6-FFHhz1exc)?s>VzuJa7uO(RZy4~>yHaqi#n_tfl}bj
z6>Z7dwC5y#a#+~|?aPJ^$U6=bI@h=!HR!Vs3UiDk$PFQW52XVd^kI3k&Qv>GiIa!l
zz*PZ}HKX~AV_FVGfkzGLPSHgN!^4iPwl&kpHASYNMlD!udgV8Ld6H&OSiXJn7JGL-
zR{){QO#1drLUkTLdvx;g5Amw-VaHn1iK@S}M_G8BzrkGKBKz^i>a0D7MqxSPaM(hJ
zb3pd-Qo?pFf@`FxDjjZLtOM)3;7%@r#_Bt)pgXjc9jt+CW26s??vG<kYZ6TRDKXg#
zl3kWq>cqY6qtxrt?zu<wdBTi9e|f4Bu-Mad4mTT5Mmu=U&`$#x>P~};&uDosyjjml
z-9%XGFQs|Ccz7>e8L#wtFVs)3Y>Tg5dCx4};HFm8Ov6-t{m!ZNclo^cW%c)Uybmq)
z4?Vn(!}X7oyiefzr$*j87G-KwRHPT7CIAD8^*=(*2;@K{5~QdX_2!FQc4TDq7=gG(
zAVwg^2>9;Q4jgg3gh0G-@MFm6_0IGQ{lY<}cc(^{cBYr6rgwLyM@Oc2AtOs8|6!&f
zFBTxv$B1Ld$TS49dwqR9H8MRlGJ5^O93Q_ZMR(wE2;}(o_V)UCiGPBB>V<{xLUvxr
zQONZ4@$u3z{P^zfZU?dpd9lB9d~<X2GL@J6Pfbt1XnL=AmUdpI@p6PrPfagDc6N7;
zcSlC1cXpQkBRc(W{I>`Gw><D7R7S!4Uxdmu>PVu1g8xORO#HSOMd>@+$CrnTgf=l`
z-2V|Oe=Ls16Y@N0&fEZiVzC%-AfL|BXNt+ls7EV^p=cOn0fefu3{WI$Z6aNAaRDS{
zbTkeI0$Ke&02<M#aGR(;Qp6AYHAELC*mC6;`D?=sqql&_Mn_H_%s)sCz-}b}(24?(
zLO8Vr(L)JLk85d^bVisDhztZ^1`5c!7`0Z~0KOAByPsvbS&|kAF!;W^0fGy$@{PET
zz~N|=@}Hg4)bBX=Vr%{CCJp_$L${F*{L^LWM0CrgEv<~{Hb(5bu&og#LS6Gn*OWZe
zP8CRlfb+WH);I5ao@!h#Jvr4wc*xzZP_8~%12ORE%)>re(htw+-@lsvjX??}_>E-^
zP&N7Tm8N{zE0jCpgA-UY!|dz#bBsP@-(RG3NZEx-Id%jc-c;Wt&ieX|i(*(Tb)2&H
zilZp>T2{U^?HVvCXaDs57oiYKLJ?d3y_60Klk1l(W(pvwAM>^SS%w8J9grE*4B6Hq
zn7)dsBsjAWZ3jqgB$$~yDaT3^?0{84^BJvcq)2;qtqci=?v_a}E%!K@I)%Mfttj94
zZr3brru()+NB`&2qGRoc*wy?_p^b7qwMjM#fcw1-2%YKn)vmg=e2d;@Oy-!Qe%co`
zF<E1`Pd0}-J|FH_D((SUS=tQQ91H2MOU~o~=oRioQ8<RnY&xpDl!j%YV+)HYEU7AM
zhE8{0pEMFIt4})EO8=a6o}p8mc3m0mxOU&tdb#yHf{A5i|3}zG`k%t?O9Xs)cz9`K
zaEm}ZAP`6AcZdi03H)XFfVjIrAnqREr?=<-p|2kh=cn+Kql@eR)aSylPmhjH;phMP
z_%gaUf3a|WdVX|zi?};K|4+k%lcUoY6DLPU4|f;W4-e;eFZ|ufi=mhJ4!^j4xO?fA
za1MXCy}P)-zkhgP5D(|4r!N8e`W$}y0KdM2BOdOq;iu>4M<?*R>+{o-(~I-di<i5e
z!{O)fi~p@%_TLx%w+H@j9{7I>y8v;d%>Si71Zy^wfUaaL<t6MMK>)+!|LG4w{K=zC
zGY5;7ATye70GLDc35mw&dq3!#vY(N=_FGl}8k0YseZQ_;#1B3v9b;{COJsmK8nrAR
zz&R||3{4xNrhhycYs_9I<@B~6t%iui9Mj30A*>Gj7OM@LZa)f(N>s68=2ydHrqP^m
znQ99NMEFu}(w75rm~B(*4t1%K4MUmm#qNa!zU?<^!>B<hHhkqY#G>bEJ8R#n`Z!9u
zt*@y0Q*ds>gd$gy&#%ZGg%ERE8V?A^0h3Z-LN>E_!l-P}5N{&1faq95R2;ePXA+zj
zM-wr2Z$9Tpt`7fwnni2a00zdQ`)<f0vq$feSPYr$<|0V~-R1DbAxP;VGXNj6k7XoY
zsY(@^8J{9PZ!Ttf5Ea7Byody4!A@CXnc2<@n@K1bZeHM}C^r~}ti7bG?|1!4p?#wS
z1tZ;0Ue_S<5(CEBG*UxM<fOh2IB{p>NEFco{pbO&UNX@7!PCrU#Cy<9HQ5Uhiciw$
zsx(R={q4q{j_KrUSxA;q`ha7-{S@~`dV>Fhy|;jh<7?A>8+Sr*2+|?A1rprSxCBdZ
z4Fq=yZo%E%Ex0=k0fM``h2Sntqd}U}`OnNfBj0>;@49Q9JNKNg)^1jJ)vm6pP1n1g
zdiQ>Qy9Z5xpL@rI53$5p#sV{i%*Eq`m+mX;yhWnwdty^^%Y@{TJ$0N*rnxu{0V&@M
z54{=$4Da~RkH$vEr+iBZpB0vf6OkGklT{n2xKk2sd=4{X5`PC8l`5K$`C$VI4SX>L
zZNZ>I`a;=R`R41O(oeQKS0MB)$(uPXkEo{j#)YDCcA5REqtoxijaX-GN5k*W+QpY5
z&N|+p;Nkrhbzj1Nb^lZB!lN!c4E~!R;y*t8qXqttX@S2LbrBI{{vDNv;FbR$D$h{D
z3(5RHRG#+$1pVPme&x?&X&erR1to8c<x_=;5FcCOOU81r-0>-v2}&l4#FNN{hMg?B
zzey?K>oIe0DirG*m2C@LS<IK1_C-4{zOkCA{^afN9MNE)9ie_iQ{j<B_cL5HZ#jyk
z4x(OVf%Bq$X#VwjpWiud^l^iuR)sM}h>5OB{Z1?ClL#dnciG-V>PDFww!`cB`24Bi
z<o8#VYv6j7Upt;^S4+{g{M5<qOZJw(;=Nr>*%FzLdz0Lovni4rrnkLflzbk&ipK+b
zgQ%+Yqdm9n&h}?Kg{nK+J+sfYMxOEi=<vM0zG%il|7V?s`zK=j;TXjrhH#F)`8(y!
z=$rpocw00DGtxyOz@U)+cOLB^i<);DIU=&ryr3_v-12msy#Hlk;o=t*0l`sTQh&f*
zaBi2JxY!42F<ligv(IAIc4F3U;^qP3Dxngxk+PD>DiXN{lI51tb@nnp0;I>26zB7G
zS1ZgnYi)O1-64G;mqQV^qcNA0X{Xb9zs9Qu`&-+)d&)XSqFd&_G;CPbZCf|)ySASN
z_T2^#{*D;AkDGkRUVJQFd#KrZY&m@FIC<=WJPuzzPTxE%z{~H)jq8Wq%ZHP{%JI#^
z(d|FK|ED$Zzo(b?f64{C+?`$ghFn~qUtGeeT<6dWIL>QlcXw-ReSdrYd~X19Ja!71
zIyqlDyI4QJ-nhEmyuV+6d|Z2cT>YzTJw6^hJe=J>T*KA!KQC~N``7Y+A65mA`G3Fi
ze^~*(`+rvFKd%3mHGkuv|FY?CoX+3b^tX-<ul_f_|DV41?`-;iS^*w0#Q*){@qfzk
z`b($%=NvCgO1XxTzr*obs5a>NR~)aArpkZfcx4dxB)xaLIBZu9=?CG+)nIqC>?=Hf
zf%4jV={;%8Ga{!~0gWSWcAxx6D^xoOOVC97GR~*{SX(Z8CQDcb3Mc{%gPBs0iQ*h+
zBv9#e`OZkumoGkHeS|deD0mqjZn<mxqO6J)v!+62nmK=w-z<vrf&I6rZkwm-Jaz^Q
zQm8-a4x~h^d{Kb6+jeuK*!9{gKg)BouVXId84|j8C|$~=sHm+!9s-$xw(h1clG~+n
z2C5n#NJ5m<_*@*G-rWE=kpc7i{r&l*mO+&Mej31#=e_!r#I&S9cSsWbr!Q{L4L^z9
zJ(u`IJ&Q0H5|IKh%pk-fZdo^f;-4Id8doU(Oe(Z&VjL%f$+hn9am9=0`E^^}$c8hW
z$4HD!IgW%%YBE?k`lTiy11N%x3^WsJ;ON46Dda$l`_cf^=P#O>n+p7nQ&5~7EC4hn
zz;!~^LY1}O{e_~<2N*OWmydlx?G@aqZ~d-B86n#+++D-G!>}k#|0OwRk2fq20}(m(
zX@ic|PDh3>A2lRjdOI*x@8uvJ$>-!gYA?kN03{~poir};2cEzrLtQcC%EI(;?J`6Y
z56MQ)sSik1B~ymfzNbS6fVvwvVc?6<N1a|`MGtbI@h}wOMD(Mg4xaCO4{e*wrH()f
z$6>whRdHh4=V)NBC>=^4(oN!8kjR?MFB4=@(p(#LJmyJ)M>Ril`^lvU5}@R^?+Hpv
zp}aE6N#1~dD@wBy!~x?q#fKuzbv4!uM6KABN-_fE7xk!YY_V=L%X2AiB+SHi=;VC0
zB;ofy<VUu=_bK&}BW#2`Vq~fgXT2%*@0IOk=!Iiv6uz#~lL*!EzJz(s@Vg#?NP!zW
z!v^AQX=Y|I3QgTue(J}fFYYBT2e;;iL;90kD|lwe<sGQJCzs}a5gt<^TTH$tk9sQ>
z#zM7}ie_OzKY%jSalQSr^CV@J^pihhOU%7q-%jF$=ZToSuH$bMEo2Lqv8wl|_oCxk
zg87+l&xKm1B6WOTnX7$P_;p6)qE-0CKQvSS;wx6-gUd@$o>%c={fft>qrz7``{D25
zSICwl6dAVlrHbdL7Wo?qIUN#szxDhL<}B9c7(?<keimuNET`yTkW`+RqI``l)UfsZ
zcLBz}Uz0dVTEvh-RVnRdm=YJ0Z(lXx85etd3nZBs%ODVN?s~x{Uu?*_B&TN!7a*z`
zi0dPBqEWS3b0%?)me)wPEi-jV`hx=qs#Q>y-OHSi{SwKc&|u{c=ooU53IXPHVlTr3
zLrWaKQS8YK2rQpRyN!OMx)~f0xjT>X#V!D%$qtH<Lt{hb3us7&2Bid`aj}sFv<$LC
za@x@N)X@TZ-k~8yk2myRIJ%!p$qs)^hbETD7yiZZYK11%L>97|$&P3*LzBUyh3u|c
z?_Z6+#C1e3;s}u){Y-w5Iw)WCCS_>URNx|QGO~!PSa$3$j@PIu_ZASH*X<%>9lMxs
zKz7_Q{UUQ;zF1&kXxydsA`24vhvPNjv8<Bq598~7iQYBgb9a#gz$pQt$xZr`U*@7K
zl!%cGPX-J8;dqruFvxufIebe>I#wdZJ3JNbarq61Qz|1ZHyxjTS-_}JDyK0#o!oj^
z$l-jDxGpo3zI<84H&&|XIz00i#|wwq(v*2NAI|ZTQ7HSEGCW&!7*wJdRi;`jH&>>8
zRi?y^59fHzRe4;Me+pvO9DsAY(yuBc2wAijhT$Bqq%uqIa@{?-h1O-RDi=7%>qbta
zEguz+U(?S3EhB3fy$ewfeGIoOh2-5VP%z@Byz$09Qm;Ny&60z);cvMRQe}ji0HWi}
zTLJYSbsT6J3S))@EL#1WlJ%u&FxKZRBg<u<lN&NxPOPjrv{zl`8d@Z6Oek11_s~Ua
zh!88y&+CvdW(`o-IS8y@31;o+=eJDgb(wkt7xzzzTLo$=^rOEc_T#&ve1Uc$BSx$p
zS1z<ZJFZI8Z$Rv2cEzZPI>Tfxpd_O}Xc@b=bk4IX8uw8LyPu0*fxrI(oEcy&DOB3U
zVXhAE^StK=;29t^Xm_$NeixiPr3=J^kLCb0&0JMIyM4d%Tw|~nkRI(Oxur#Tp)Sa~
zYwIFoO-~u4*_TYz9YOuw@D~P26N{~WJf+ny3b0H0%n+`@bE|c%ca!|GKESW8xu0Q*
ze5FLDk&b8?tJr5IjT_Kom~(lvA;BK+>jdr^YGaOHN9>}52(}LXW)GnA&6YlyrV7(N
z-95A|vYs?=YoC>eMR>BVyrJ@q|0lvA$qfE+OW2#BMmY(Vy`VOqY==+`Ycswa@Kl@$
zhY_bj5W+JT3=gUL(i@tUaZ`lJsD5WcT{dmu>f^x}ZjQ|Jm3@(grt-bQI<tW`UBkB|
zpo;m+q6lPZrK7^u{zmK2B%30%jOE@OefILKcC-26^cJNmXKY)xecfiyg*0~Fd<X0^
zF@o<k9c#=E2!sbFN&>I9uU#4nZDu*n`j*YACM_`(wruP9d)DW%Y_uLt+bEV7@%O$|
zuoPHDK5JdfxrSE52=op<za{?_(@|D&?`?oFbH6ZIMb&~qr5Z4Cziz635&GQ92+x%t
z%huK@?pv107_nCW0C7{ZVWg4IkCm;K-LrxEZw9XtbVuZ<-VDb?&52W|te{UgCZj1{
zq<`@+8)awrKFZJ>kV<KrYCjLiInuLFXl~oL<@<thuZMlPK9y^F;y!bK8T~2c?DFc3
zt5TF5;0MK)K4l|{8>>Z%*~GcPGv&4sm`cVM*hTI$VSS<3chebb%?0n;4>jH`%+|xM
zYF?Kg87bW_e{#NVnrJ^w3BUh&54*{FCkP2q^5VeyaXYBwqvToruq*gUbl_{pW$_QP
zU6rT1)@G6GW*D{STeqkC^=ChB2b5sYjHicvr5|?-6R_*=Pmhq89}jy<Pj@R%u-l0r
zu$ze|*!|NJfYcX}&lg$K7uC%dJ=GTz?2EnVi+k&fN9u>q=SQgNN9^WDn(9Xm_M=$z
zqq_A2lKRu|`O|9p)4TaIrus93{aN95rCWav(ttO70bH5^JZ=GesR07u0HMVIkrH1Q
z5Yl@*A5p%*eUd;WNB~0#QotOIsR1xgO?Qn1d7sWlfFsb&7b$<oTVg#>Zt<%qI+E<Z
zx0Ys*v<#BbZ4gZf5+TG}z<}geN|1#)sum-H{jIm?WU$s^u*|-<utA_@$yd=-WShYt
zVtXW*6ltK&euzIEf;nGM0C$L=xu5sGcals9A4iA;04XIkNCgte0SPnh3{GZ5%I6Ea
z2?^x0NAbBu=Hm#IG)JvnM6w?YlqE&B2Zt4hh7+a+=`;E`qWct(>T7cZ{V)%U+4t5M
zj3^Ba7LE<nazm*$NByc1Y3ds>of>LR8tJ1MIx6EA&Zrqb7*%&0+PWCEt`WQ@6E$!f
z1qlh1m<&Eo4HB0L*BuNSVhq{f(>&UbCO{8z4Gpu<j7rrE9bxoAc8@|hh&c-h%)X7h
z<O^Q|hb5K73=PJTlg1gRhP@yQa><L^aE;C#3@2TRjkygeCym1hi<;4lRszJ+k-_{H
z86(#QqeRyci%BEU_!Dv&!-dEaju%2u^FwAxBWn2)n%tuJ!oqyf6EXKA<{9G=OCuj;
zB88PhSKX3+rNk<h`goH@l9NUIE+XY8MH;t+>J9nIhw9R{#K|%y>6RcW;UVjjMjyGw
zTBN0T$VP9Op}m<*_8?1DObgk)3GsJN)eB2`xfC6`lp6gzHI^(bo<A*7D=pbQEj2AI
zy(KMkDJ}bVS}s|7K7V?FR(g?p`c|>`YIAy7aeBq?^t`?F8vYC}hKvUH3<A>(a7%_~
zVMg2U3~wUuPX5f?y^LP>Of!?r!In&e!pza%nL0a}ll)osbeXg6S&npBi?EigercO5
zQ&WotomF?$);<H{c_AeF>=bEBsbIIyJQl7gjvO~8r5eU0{Z3o5*?v2Y@+2lPDFzSD
z=4>twr1YO(YZxbW=^ZX*%)4uoU)!mr<Vg1Ejqf-L8fbYC=UrGhxAxiNHzN{RI&2o^
zEx3eYm1$gIWaHf#;~%O>0-S)wu8}WwA~~I3q?5c(|MY^yz#TzTHTFx%LT=YpZpKay
zo3<)Zio54VUU1(RCm!n_HEVK9D>Eqsbn=3=Fc)U>AO?>DAvFhCOJhA|YxzSPZsx*B
z$-*c)BrW?wa8ka+VWFIw1G0csM%<_5rd)wTGa6UDkEjK9%mu_n`LJY$Vvw2xSGW-?
zxot+F4tmO`Iv3l$zL*xKk~6a6U=LNh-J+SPLJ@e1H$~HVS+fsS$2Qzh&l2vua84^L
z1%{M-2-S4sDIMW1{kp7UXPT|F@Xc3FdwHp>(}Us%c}1@_S&w$bpnykmdc|nE%D{3(
z*ImWra@n*%Ww3VT{9)l@dL>(H<!XA)+Fj);S=DBE*0y%lY*_kXYt`{`)#+UoguEIm
zP<^RgeeF?wn_hj_TK%wG4ZEubyr@AGtU=bPc>_+Kqzk{k4P*v{zWZIRbr4s99%M@D
zW7d+GN*cB;9j(f!8EFwYUlJ_3AEoLRq3@QUKbQp54vyD^MT?sQW!=Jj&_mwJ#y(q#
zGrCP;BlA(ctrZ5>>@&s-tcT~ICp<1A;jV|Wy^lOLkJ2U!VPgte-B0;06D6Aw>2%QW
zNE*lvL=yQPp!&U*;vhw%CejeAM$#VT%}T-+T7yJrFi}hWT1rzAI3CLaO=hye4;<!e
zQ43w9(Hdz+`rc%#6Rw8kqvhH3Z87neMl%5hlJ`-_r}6-Q&nV;ma4oA;<NF3gmU^p^
z#2we@@bc6stK^s$Egmd&MT7PBGEIEBHA<k?C+2!ymbe{_FozNFAYZUcL@RT7pzTP4
z007B#5edJhHNZ2j3Crh|jt?DHqtReWp<u8UR^1lt=KH(FHV3V?ohxtDH!XL|VUAY7
z*6&HA-;)$Izq7Y|&-H9y{~mz;9Wk9TMR_F#;2HMj#gD5(ltpli4mf6#u{p&p`Tl#y
z{);-)j84q9PVCiA+=os)iY|PiE<)WdVy`aJ%)h+Et6fwNT|n%#z3{3@{_ZYbI>yXy
z=C*ED>+T<O-5eA>Z-jc>ce+P-d-yVYv@ksdR(nL+y1Cmbtgm_`uzMRcdSzC7MB94a
zXZFhIdMZ-%ajy2_u9s^u_wi%*sb#8Zvi7N3_vutr=n3^nXOb8S^?!Ki^9rKVjqGQ|
z?lZOSw|(d>WA3%;>vt3ykfQL^i5&3I?S)y6=K4GgFk=r)E(`=7_xMHTYh(^GS`V%r
z49e*a$jc9zu@1S6x`$>Cq_XxztoCL`4h2^L^Hzu09){4~T3UyYhsjCEhf|m}cSmp!
z<hbfbI=k+x^?}=v8AlDK8i7XYFGs|X9zwehv}nJ#0m~jn+=MK>4?iOi=jbx1RWaxY
zLPkBNh6OK%yO#%<ghp&f-Q`1a1!J{`+qBwQN8OrOL%HchI!Bl(OmK6x_JruZB%?6F
zfuI6L(R9vY3+1z!Lr-MpHX)Ydl9petKjB<kQLUitC23>wSboU0#C&54IUf1C38=@`
z>^|-@adn_fMsil4qN(hDfjU~U0|SVG5EymGS>$!F@(q$dPD_cQojeS>-4%?QgpAcY
zMjWa#r8`oRd=^yy%spv5E;>HmH73&JmhNi6dIHFiLpf?2kJvFZ()DQIHtSv0zhFhu
z!<k@~pAf-A0`Sc6D(kWdjliWI77engg2B|DH49s=*YG!$9gikvyXUTs(eo&EQs(kD
zTHV1~DxVFGtZ5^h^Ymip@?3Ssug6C=wK&=48QZkUDd%qFCzvVcnB>h9vZms3W<<1y
zo*#ZgOfNbzRcqJKW4(4VZ8h~=M%iWh6p*E<YPmSf`e~R5Me>bh^2t<g@mN^YD5dve
zqA(qU-pmj@$Rv07RgPxEvh3aa4Oxqp-6$uMbZty|X1_IR)@Rv0a!-?{tT46P=ouLN
zU|S$5ThpWP*i<mO9bLV!q0Rg`-G#HvcCs|6_lr~bCm_XwhpnvI#&!{V7E!Ob6m{j9
ztKC=OvgS(nu>dV9fiL2F6p@c!D(X75!J3rg&I65F$;2om#YF{&+LYO7Ao3Lq)UrEn
zO*;~}HD-O~QG*|-564NLqiDV3U7<2{cwICDHC>}iF}EA|B-cF4JMR^JWjwAvt~92L
z&okFR|3!$QaC52Dg6ESmuDP|G6&mgs8s_8&ZqG7S$4)lgFCmj3mu*u?KDW<(mJs<2
zrE?AC)e@-kYHXi`9bniS;%sva7kV~N@)fy!_HfIST>RRRol9<^car@Xwh5Kpa+B{)
z*7rvAKA5-cNyp91Tsvs{eUKZSkuP%CpmkV;n^BT|SkZD=G42gVc`cG0)hT*6=pRkH
z9)VB2UalT>z>Yepj=M#Ud-ad|eU1mSkB2*sN7s(WVaJnHC#hjI3FV>0oh`{LiIko#
zb}#B<*rT&#8@<6N))>BXf(;feHFlw`^CK<Jq_J~?^}b6X;aK&VVW(TLh=#$_8;y43
zqr}^Y#-CSV$gD_II+29#ap&w2gCiZ`-@zG6L4B!bFYh7FD>NBy$%^JFZY8ypSRsqi
zamq|SyuV>#bYG(s2U~jF>VBA?$J|2dbkfjd&!bi#sJc<&2X)WM;@-MPpX;}9VsyU1
z2rbZTS7J%bGjAVui@aQeFyy4E+=pUKG|aHHXagGv0SVhBN$0Q@I*eFL&p6#2Xpl^-
zCwf?3W9-q<59s$aGr?2*l@s-tt7M%{>tDg=whfB1F-Va&#yPbXF)ed2D9=P1jqF9U
zRWfPL<;Y0Q&Q*)br;cB@HP-0yl212EXLXD*otq1nA?0ayudf0ozDHEoJPyXUX52WA
z#J-wnVtBgyde+nnhIq@~<~+NiXz6Hp7RlEc!littS{f($BT?v6%CJs6I@TGIT{~(#
zLL}_0-Ld7~@d=W}e~~}&dlM~I3h>bMzLx3UauA#ddVRvd2g5Z_-F_FakL&l84SOT=
zhy{k7zI(d-^mP68={D!-?#I)^uO}G%S-?<g{qJzRq@pQ>eH!*b1%vPD6tX4K{&2k5
z^g05`RQ@lH*PddwuuU}Wfy%yezGM`Y<R6Y#I*5`Zh+OSZwM?z@jkAZ^KXJUS(uj^V
z>rBS7)tHI@;&`>H-K(GKwmPTuH^Mny`W@`&*C-U49J;vyaE{l*mEGt5C`tmohd&%I
zj#nD}nQ2gy6ft#H82^EL-#!s(U2cK+D@@BddW0R0sA(mf>2mIvEa7yqq16HnaBlqc
zfH{_)*jIi2)tm62DIa4{+o8@*I|UiVUX+4`cqa^=D;*61T##>>S{=!gdNK|PBCUck
z&tLJ`Ew3;93e}&kKbie)_azIb;eh>IJovY!<5>e`mH1ivb=5^x@SHx<v%-y%@9dzY
z(~B4pG;a9VXhah}w#sfxIQSn!L3@I44O@t*_Z5^t%%AA}vLOcb;wy;MBgMl6^QoM5
zZ6}h_a%}{{YqGimLT`B}J~fbwsrR>|ah;$5YiD%<lTvq`EQRy-Q~~9*piR?UI)(jv
zl7u&Qg(y8+uv*E4$jA>ORIa(3QY<R<3ZuX&IsA##-Cl=g%3&{MI_}qbc;6{X1`&D$
zW#tbh<~0jIlk$>;G{IAYEN8uGRE-~hydm)>5MjQhokS$EiNK#?L=$G2UXw9uXrGpo
zP?Nw)(dlYh@DYrkp(}sEt;Mt?PB<+q+@8R5xac{yR3o3nG`x^b5XFU7Nr>3sNbQ{{
z3$^WQWR<`PVp6mFlKXMkLocbR2eDo=S=7Vi`v>%o-W(({97j>aZ)^<(=9?FfjfaN4
ze|vH1PGhpy{;ahPx+y#$C+0PJef9{Ij&n_|nT`|pocO$-X%wTKSi;s)!e>U`DE-A#
zQlXbJ9>%CRW*5iBrpFL82QFI}KISWQDkiuE;l$DY77%rv8(W(krf3zONtGlX5>QZa
zAN?qu&txd@-Pf&9RTxQOOtswF<{g6tnAf7n^jn?9MmiQJR-;y-c46n3dg-TyVUar-
zkQT9fFN<h|<FERFa0}bkZ{{oZ&(Bp=P8zem<?*yvB7QetPX6XKF(p6qaLSmEe6KNG
zKmKvsBn4@KYYKz6MH(h2Jw9R@*ZSLOC#9L$eK#kBYCPy$afipjRFjD32~od~=h=@R
zL++3Pv`=2piHS9@%Y_hq@9SUhetO^T4XF9toh^*|Jly2Se}z4nVap)%fe?u&ebFQg
z5Me}M5Gv24-?KmiWI8@kOm#Q}y4L`e8!U?JGWi$BOOj6vKY22cLBbGI4bJgunhbg!
zXozjXCr&;;8O+;ji0cd%r@EdDd58QNFNjZqhIlGeT7m}Axs!!0)eoH+NQ{DvA2<P&
zKqEG%5v@v<e5>q$fqH;Ike~??#8V1KVtQqfZI36k4iG@W*doW7mij!z8TlhkOl%k|
zC2%Jdjmq?j_}Mg)C~;tTVT(WLE>s5la6Qs=5&;#zREFYV3fo40f)*<ui9~1`+mMx(
zo{m43hxko=I>k5X;oCkQpV|nP*ewD*Svd+BhZyrjKWt3dSRQRhpeQNba|4*K99uUu
zKIx$l3yLm<G1-}-sM^I|Tr#SJ8IL~Qw$6r<KW3!;F?Drz6WN|)i0AN4#4jf}41cIk
zy$GMSGt(Ha23^suNhNi}Y5O&sGBPP^eY*Dk4iLoxjcnT?>xVTxbzIAszl%fS&rycg
z4hD)L^l$QSj`JBfHRafeX>*Z=_K0yd2dR4F5z&GQ2ql*lUD@rkAYP$7I!jVfE*C%!
zB6`j-(4>wJ*EilIW4w~mak^a9T!mu<Z2jUHj3NiFj>`i!&Q@7Wyp2dY;S$yRmKmoe
zE<XhBGO_(znaFO{{1Nwk0u5gUze@uQVdrmli|I<qr>dwL=tr;58DX)Z_=%;2sz>5B
z%j%-jP6dSKTSWMtlL6$!nfh!75*Mwp0oO^W^#$8+pALE}@wd~peUGSf_D4#u*YgB4
zw~VJ2)wDnJ1UNtL)1=7FDY18zJteZy9ARo9=Fe8(wiK)M$&8rYapfnD8kskiObOnd
z7iTC8I*1->W59R{d$Wq(X~?cvC12)<&7GR$jVz=?=V>VPDtQG3`x>ri8qz5$B_h60
z9^pz<c4+x4y$oAA@h6OU@03b^bSRTHo#Ma0Q}ON{v!0AxLKPqBjsRJkB=VQ(oZWUA
zGAp@0%`(t8>Jx;|4!&AFpGhLkX!nCK@^$^>liEv=UyDMSCt&nN;EtRzpf6dN9!aw%
zN^;_{+D(f-^~i?->pl+2bU_{Svbgvvr!vCI6-kq-x6Pv#<p~2LYC-JM(GZGSX)7ip
z(e$fm@gUlSgf>&2=A|*a;4hgwLS_OBOXIHnU;g5F-7HOfMRm$W5jGbiS)L4$a>^%a
zH<#jFo_d)^1)zJReo|PT_Ab3F<hDtXw_BdEJGd;Cj7nCHS)Mgwx++y0OH!>~o>Q~9
zDmTGN(wtbHAB?!HbdEaIJzHL=IK8S4!Z|X?VL&5!tFjhM)A~VLZtn2tnRj}Rb-wb-
z%s|;>$yjqif6#!`H?p;JF(>Kk$P7Mq%oLl7%7YEqBI8Ov&!^+g2KL29Qwu$rF<Vd|
zZ`Ka(r=t$1=XC~LDj7<qVTVnN5Vi{bF&okGdGbzf1$!G3PeD|yXX}A;8Jm1wyi^0^
zU*5nh!+TaXg=gjm^^!8?*&gJm&G=B{*w5dmJj|?^W<pdI*{SG;wr+>{niCWpsfix8
zE5gRDa|<1qxrW|S#_&(>5jJ|2dd>0NG~Bx+QA-rc30XxgPkd#kGuF|Y)BNRB8Pa}T
zM3Hr3*POPpA##&ll6C6(F6`%dG`t5t>(u*3a20{tt?5}dq=)BW<7<{%-&y*3)Q_vJ
zm+y|GHP)ah175q_KitP%*Di9<y!R#Fc}%Ck)-H>sy${uXc+5AiT~&v8XDl$Sw)a!L
z3<*@U9r66V#M@Bm-`GyfouM~YJcY8`;1Chg@`;z3pmSE(`-NJY_P(IUccskYGpi8|
zOZM{!6%k?4JWa_ruCq|nY=-j+@imea=ewfUC#=*~?!Qcb<#0wbM*XDrtoQ!`y+UI<
zu_}Ie!FckjeV3+kr~LJp_z!?8hcQhj`CHH|5{P|E$TOTC?V<2Pc;}-|d#M=Pj_13P
z_ph*1g|EunapgOnQT)(?{#Xy_B2DZfE9fF`=z7uHMKRk&x!px|*+q@q4J7P-N!v}s
z)%~hhXegsiL#3New~^kdTP2{Iu>yRW2kT}T6>RD0?#$?Bn{8mf6nl@<!;#p)N!#<p
z+4FWahfB5R-mr%!lllgMtm-HuUkAgf6d`wzOphR877ybd5KiZYQ=G~Zw~tGW7nbS}
zE?mIHMw?Yo?q{LGlL8_koq8sf*tism6Qa`WYV;fmq*xBaX*@{3n-a^rXtiS@&Kij`
zGU}BR!gon)d>a;}V-aWF(nB7a@q#m+?mQ8BD%DM#JaG}h;{}-Lc?|cGxaMfWpab{I
z{Y34C^!zvka=b9yxW2#_t(ND#D;#{0M*_dy2qm5in6@P*zHPL&i0>JSW=(zJzaf=W
zLdN9ado$P%{4HfB0ZtN^5{QhQgZqnqeBgE?BzTF3LBior8k*^kjGvbFBJZsvOJs_n
zP-;J!^w-FNXnqQ<F9csR()5>PrsA68HRI!Y2UJE|9E=5$XonJY<Dy#zRKz8O<&$66
zN?zykQ4gjSGi9V&ON2$HjO51@*2@^vK2ze9b`~8_(;1lXd#*U!53!Gp#~6|wrItR9
zt6SlBkm$Gb>`NK#iR%Pwunfilp1pGdkWb-TA!9nf?Zx*S4DF>T%;o3vqV6ew|6P~5
ztwFB6?R~}N`%j)dokBTXw4>*oqdgDVy{e-phNJ!R)SZFy^ogTGUfshD@=U#>qZHh<
zm!lKNW0QnqQ?z5#Tw^m5W3XA(u{q<hd8e_3z_G=|F<PAhE$zBSOPWW|I{#eZ)i%(b
zW0_dDu&BptzHknu^ml>@g*M$8P0#|i=`kb6N}@|4f%tDI^@UEB#Z>lwdinWVx}5Xf
z^*_5y@GdG0!^eL@L2Pn}M9M`X_==kx6CkW_ftK(5ClxMeX(=HLl!FCIVv1(*Z0nx&
zR0*6)!=;zl^+XvU8FISh;o{r;{GT)RG+;!V&m8;y3}TpwjP-!jbfw*f0$6-K3HFDc
zkCO)yqPRk@e#+POlh=#(Ows{r%4y0CX=nu*>*)X=K6BE?<}35Oo!Vin*ZZh+X#7J-
z8+XsM01t-?`*F$(6E>9@Un8`sgoiWvj#*LQt+F$7HQ~+}Y7(op06POp1KCed8@{5f
z2NV4HnXPjg^6-W$qyA?r-CH#g1rJu*%4#O@QtYd@HkcpWrWMGKgkRl?K;&Onm5K1_
zC|1#oLz!!pXp}{wO7H`Ub<&l^W{S2)7{GV=!}&#g3e~dhZ#U``FooY-=qLg8*yyn;
zygWpOwu%^47&rwOA780GZ?FD9COVHayM*0fKs5jE)%<74d1JMC6O(yU=XtZBdGjPV
zC}`fYQGLcse%veDdTxGaW8O9@XAF7aHQ|B-QI8|{!W)SNC&?aXlLc<41y|=Dx1<HW
zf(4Jq_qn|q8nF9$?=kF5@p4v(towFaGO4DDxZL};EHxnvTNPX?gfweGaQW;)vM>0W
zadCT46Fk!!nTGSxPwrD*^atx`#+Gz)()XjCEv|2uVu$47Jd<Czk<F(rQ4R$deOYo^
z;nHS(ejW=jY>_2dif2EUoU!L|+gLJ?kWFU8E!)aKAdB5l?tj(QGiN}8V=-J<Ky6M)
z@XEd=2_xHjh(B;^Xn%b<u@c*tGG=|SKjg*AFjH%$ZqiR*u=@kGvsX-uq4XjjjyYlL
zMkr1JQLKgN%9y71#(LZy9{<!ne`bUD4mer|p+EL$<mTmIn<V)ZNG51C1)NA4)E7T8
zCmo*k9u_==P}J8vtrcbN9{tl-M~N^hSw-${zyIk#Mu~HXSTwCnJnVpRWrb}O#;=RT
z6rKJd<E6VEGSgb_RA1jgtSnMSCg%`S-fEpQ4`!HtCDB?qH_vP#<*sHtzwDY@q&5~<
zi#e|qj0{{QN>)7}?emM7;aEz>&>zy&>Q%$fEc8YGpnFaFiMST`buFMzIQ!5|U)Jas
z($rG0NoMs-v|ileop+?q)j~u20wz5*X1~FG`#O&PDDJhv0P+T2wEQXE#`~Fd0;xzs
zb;BNm4PxR*l3>Hm*bTDX2=XSwcJMsq?grKM1~uv?ka+VY{U#01<}0a9TJ=pj)6WRQ
zFgC=jE|K)Yd;Cgb!nYdQ1sgMOABRN;<QVXDzuh7hb2t|225ky&Z7wrs%|g}WXmBqG
z=wD4nb%ryrVQ~UH{RJ(jmuN~jx_!r?<=jZ3Oo*Vw^pEU@g+ZGtTs$>R<jil?D^N^o
z7~=C8;tO25ODn@)(N!8NM03baa~x#m1A{6Ay$hJWt5T%;bFkD%QBHs@w<@MZDA%XN
z@)aXLm*QP8JvJ0o9u}$-tBPWF@w_M(5~g2&-vPv{eXT93joZK_QlcLey;7i}t6ze5
zq#$;>BXLMa@@+?vt)w@+UY8P1p#^<tDwi?c)pFSp4A|9I=bXdu>gqN<r>&re4VT(N
zcbh-6Nw-$=y`9__s=~7_R`=PJTB{gHSF>vRW`g?7=9J#Rl+6Ij{?ew}O{#X+SaB_k
zEzoq^?9KLv<yZ13BEc?-%p>1U0?ljgwy{hq-v}5DBGxJ@Rt0;^@@p&0h?vK&(NQM6
zDyC6RK%Hdu{5CdhhPP#O-m8LLKgTrvhSGCuetExGK%v=kQ#HP$T#@GW^kLQYVKwSe
z4IJV{e*}kk)x#lP(ZUqthKesXns7A;g01chk6Mx=TAQr8V~^TQsoQps8X-qNL?Swg
zkL!TP-MfwLQpZsDqdwR|zl$}N`tjg=c2Ci9Wz8`>3pP4${W;@!JemqNj%rhicQRGP
zJ;-xHBy}?DvN30RLh5p|P_(g_eDb2`WO+Vfy8i@xfBZ9fq!@B?ICZkVmb^x9Yu9$N
zh1$5Se%eHOx;q}W7kmmaJUyT~K5Vk>=|4SIJf7Y;6?F)Q5TBjXpFw%fE~L&b)z7X>
z&#qn0Zi3I?5U<}wXLn6!_x)!N^JkB{XRzzDCsYW41OkV6A@V|yq#?)}5EL^Asw)I7
z1cIId!6=5nAzoMm5bOmA&K?B!2J#H;9FOGuIm0<V?>T|=Iibcmk=Z%1D;(l=PMUH~
zR(ww0d=7_rQNSTyd*@U)=hSFWAPMv(1C)jr`bru~t1$<qGlSB*LK#A!j44p2VkmPn
zlw|<Qx&UR{gR<X1U!z@ckX&#wT)g4Ecq@IurE$S+cERI%!5ebHmvX^he1S00Eimu}
zODRlf?+e;%jNIOA5fUfF>M&7Wr>CM*agED+#Y;)o%irvm(kV{Aqc3HfFR#_ZWWHZ2
zD4ivt+bQi`DnDJyli0y&UMjp-gM3$NN>{o%&Z-PoAAVhEkX)&wooW?3Yf57%Ok8PH
zU+Pz1H6dLq+g%zqUw-DjmVLT1{&D&4<`iV+qCIeBj&?0beeDbQ|IBFxw^{u$Tm9v<
z`iITx&+zGgEdM=P;BSrj{~Jy#CKq(PKV$wGRa}lCVt>uV`;nHZ-c$kQ8M?d#o}uqp
z7>f^P<=}c}U%nt4UrA_!FCxAWT8(B|uKz>|7ZW=p2dAHJH6kuB71AgwS&hiJPm!T+
z)>lb5mEM@T-aQwF$>GZ;7>BTc;)$||;(H+;ghN3yxh}`YFj`?wrb4mO3BmxN0$0as
z2$^&X^nSci&+QW3{T`@i-jNDASwT|srco}tVhO?{(Y{nQY&<ZEuxH6GlJQ`&ufiUs
zj}_tsBVZt#zCh#9>9>r)M&92SO7X*~^NWIsFmP;1Y~m2f^FgAn_*`~-Y9k7TVQgDF
z-g}6e_COIyBr3jG0H&ccH>ra<H$x{bP`6VYm)mQO+UdvAfU1QAnaPyJw4qd<`VD9D
zszmW`>7U3rkvrt3IQhgcoO#zf{d6)NcJp+8BLJ48$@LS}zKk{oe~TslAVuj-jkuH)
z`X%pb&JRFqK!`-chYCV{B~jz2@5dbrN}{%JSqS8FF`tgPm*r890VqnxeX?U7&`qZm
zGu!>TkfjEP{9Y02TBCPDL=_ceEtaC5=*aNXy9{0Q^zUR_euX;`6D7q5Cb^^+(C(J1
zA$dueY)3>rpET7cu?8XLyvjyiO8qP#w`;8VvF>UcU|mWyS0Ob-M3<4xv#@0>{8PqK
zMN<k72_1zr)<2q@9b_SEj!TzN>7}=<q2nfu=kGS@ZlbQAU#eQ!xL<@d-E!D;R3&-b
z!BX9NK5kX5e6?0?Cy(&YQ~{-bLlt;>dRkv!clhG`^fZ$-^R(X{-WKXS{q!`Q?c8?o
z6w-e1G?Tmk^yH8|;}F`B^(Fl2=^*P%?$bd>$e)kS4qxC~4?@1=hJ0~u3(a--62AX5
z6A~Ie{WP<?y9@ULw1tLmY;0tOc1%AVv>hBwXXox8bimzRAz#8nvUA~cgSQ>b?Ck8o
zN4q<OhC5_;z$XX~Y44bx$%RiA4xcDID?9hU$IbbVv-sb$1^#2u6%To-Icn~J==<-c
zKmRQn6cYaG4^^PfM2?h8_s{g_yZz6otl`t2zcogW#6mWgnS8qg@1%%eZX{i&LB^AP
zCzsj@I+!Y<c}WVa;WAc<K%${Q=Wn!}D%VT$K`{XN0?@GWz&qMNR1^f9hSo}Z(5X&6
z02AF_)VWiy1AvVM!UnO2pqis#DFc8dlgQduy7R+xuU8}RIlzUiX;6O>8=^s*8b_PO
zTC8<_w$2;NrQr&ML{cnJcMwwTR(f!R0bjs63h)(9^!%oO8>%M5-oxsqZ4Dt97te5$
z_bM+B1I9&tplxk59ECxcJNnxN5_!ZTxaiB}5QuyA=~ZsIP?t}{le=k`db=J+xB3}E
zQikLZX9>u;S~!SEn{XZt<Zkrns_%930cG8sq>p3;b(gYHEKKGxWmU~5N*$o9f>WZ0
zjOK!xA3)kiqKSkT-j^mvnvIt0actwfA~_bu_sQpmbBW|DtE2POS5AD*!o)BwO})^T
z%7rb2cSVH8_V~H6fDkDdajMI+*jNO6`*ucMgWfn|1}pT-l-$_Y!{AqDC^ZMW2*DNu
zKkb5i$mrc=(iawW{fI1#P~L#)00?+(r6g!|lsw6wLz%8Mjg#^5(g95J9JxC7A2ckB
z-Wg>HXc+*R<#JQ?PB1<OyktvHma!r#{3b*0zkO5<L@7`Boa5(o=-<B<UZF9gZdEBY
ztY2=Uy<~f2qx3Hk6%BrC{2S{kJgk*hR6RZI^zA&IFSc$!JuS3UZTD9#K%c;i(5Ib&
z^QWis{++&x*7BC6rzdD%#lRDE3EZ;OS5Z}70pAJ*S5$#31{PWd$}3vIEv@HIJMdt*
z{j{?Hg`Pu~wx6Ke{R5Ymmwhcu3oWhS#ijE8rR|*oaQ^_@aCLos4G*W~Ev<e11K^5Q
zIN)Ugx&wC_{qK1L|KqCuo3+4yjHo>!lm>$UQ0>3vv>+;T<_8S^0S4$EIP_vB!+`;r
zvT;GO>3m-fXGuFZ5fRAokFohX{U-BdJU<31Z<<SE5RhWC9TL(8A|c26sA3v`kddhK
z<bKMk9Vu6#A)~u>0{oUMP~?^ICfCcBF;Q2mD6w*VeThGyjrOfLb7%r=dAS&mG<*>O
z@BHY&hhosV3XdiAM0?Sbt^OF2Oqudd8>B?tc7MIjWJ`oL)jly198j+z1}S!p?Td6a
z|21qE5>0C-SFLcYLn=Pu2S>;7CML{r0bk_M)$ssFdV3+`!|G6K*eiPF^>dS@@2`_X
z9()6)s-6qAX+#0o&ylZ~b|<V6SOBXp4U)2z8a{Ak`e6zcldGsD?W}tOywKErHY#29
zRqx!@r#vbg0Qw&|z06g8dOj4Uz+)VW+Sgf0JfJB#jro*^H+Sy3MoJc~q1#=Y8I^jS
zniECH$rwpaocog5XLX{T=KQZpZ<dGxCv0SN+<D1kzsU%m(syBDXrde2dVkpKL?hep
zR}XKy+F3EP$`0=IMuMi&L~!e?`=*(bbLeTz@9^j)>v%BGx`npSEyQrB`}%7m;sHd{
zU2G=P4TCU1sRoFQ{iFrR_Vgf3g3DrJopC<_Ce3_-`IKP(z`KD$b!QK!b?KmV6nqWA
zDRlfGs-3cO>9*<KQd6ohZG)OR-0w;ClTr~MYNyq$h#Tik%T)jf2>&`IfCxABrXq&G
zg(9;Fe8yJTAKujVcE$PyoO5-24ZDNxU&CO~{q5`HZRj0rAO5;Nxr4#BkKrr!xA);(
zmb>Ha6L`IknmYUY&|~<{+wcl^``ah`+uQc3#i{|x(ESrQSS7LooK)9N$0N*a;QYqQ
zFTA{&&n|H91X9vDY@1xfV;jJzVqDfeQqeQ&m{t;7{r#hVQgmhO*5L``$InckUHj%%
zh8BKqZ}01brgK^QEBhww9G?x$uUaP+?(grzPwVaudb|&XD`7Yx3x47wOTXYam*J&f
z*T*N&{r&6fll|k9?PKURyfzfhZutY?g2!;^-8K9&{+r#||2Uoh)hz&zr3in|)SGCY
z2M=99@$i4b05CGSG{n~Zl@b`vJaD8N%Yety)ggj{v20KP+|<jpGm$Toz^pe+*f~|C
z{7o)PuCZ*cTvU1z_&m4#f0}x$Xw4%#hnsA4h|RW!v)(teU^Tm4NL7AluKv}*eThjW
ze_6fJV~W9|pGi==HK0fKKKmHI&ZH;ttrhVBUq}po%A+ln!g9XRb427tj@nn3tJ5_`
zyiV9ivWK&8KbA~xv{oGd>ckKeIqyaZUqSQ;44o3RhV0epdB!>f0Aq+L)w!Ml+650z
zSOj1V>!Ofg>}OT&<r8g>R*`tZvES^^H<7omZpoUTm5WP;lMTK^2r&9h#JA{Ud}82_
zQyK=!^}}lo%GIK~jqM3|ZfZUkNMO1DQjLP<b|X}oU%fMov8ZG-ocXiNW`tzg;ASKj
z@j6W;A0pAF5C3(^R`kkm#sWo9u-ZmYC{8J@f}~3!FaVJ+bvs_QqrvFw(@V2nUlsL(
z9a(}7l3z9#bFRNq%;S->-L`RzsXX!unapISKbTRvEOYbjWs~D*tU5F^4P=IT5o<rU
zkpiZy*b0&#mPiyAHfdWah**}2XL-+WYoxf8O%@%vGh2%0_VXW>0unvQ%8H?dWkxW+
zT4rY5Y8sc6ifqe1wMy^8M&hbYRF>nKUSg}`+ClpA<GN9vqhok1WjSe>Rku26Tr@2|
zX<BtTI%!@HW;q3KCtIDi?8E2RY&~v*!&e~vEO6%4ywzFz?QZ#5$HVo}*$)63E2I;d
z#2V6t&QJmA#^ybS^x#Rep7#=JSfBTinpK?lQ@9?V4*)}0p@Xz3*3cow;tJ?6Yx6O5
zgkym9Vw7va`eKZ4ui|1{=;ruh0))nPIVnM6b2%l$P<c5m&wFw?qb$vKHLI#&b2X=F
zR(UnA>w0pvU=YG~y=a_bbG>9<TzS20-F$MrVn4ukv+A^9bMw<}ukr@A=5=#&^UD{F
z{dPT&#1{VlW2m~_jO0DN-HMfF|Gk~4Vf%Y0)vW6GZl>$$@4eg*_PhOp6x+LllH#hn
z!;0q9yQ7)`_WR?81>5@*@LtvZY1_@|{aGj4>jy|LiQU8bAVc*7bd>k(;bKzy_2cEN
zhTY@UqFMFh^{VUH<IQ@=YuN2}iXH6telgs#aol_cyN3+CetNiEuzPyE-K&0rJ=~nZ
zhmd0D0?=eS5y>IG=<>OUB!iu(0uVpE$XsLwnJ!Fih(GCQE-LR}7p?~+0EnH3E-llI
zpAHFRl+VM|80;p7!@fBp^RUfiddQa{!F;26xUPdeRCkaN7zjHbFGQx7hWtEKMm`@u
zWw4iC;5<w@GM}(mrjJ?sJX~`$pSXFjkKN-u!T|dl>3~fCoAmQYbNO%N3xoYUt>;np
zk^k>Zz0ibQ>_SHA|I*YuG@^e8P3gq`Pffk0tq7VI>5HR9Jk3L6wjTd%>c#MX8H&yS
z?@YZjWGHyPK;sM8XtBu6(1cIx7xa&Sw0D1*dbzj(;JpFdKc?QqEF`>r8wwDBf@3`o
z$^}AZ51)#ba>^@B^Tp>o9LLmMM<AVJl-=S-K%vO}26-qMur&f;(gL#SB@e{aFjXRl
z8;qJiz{4xh4~^BJ<h5ic0S5?x-r!V1Ce!&LtV{&~=nH^*O%YPb)ex+c0D457AHD(*
zvh|YyICua_mSNvyF~3SS?*r8cj|@zEgAxm2D{ab2<UF4B61>ShC4MQDjIzcOW=W8$
zTDnRjsyaXxTnb>W@k8dzEx}r3G3CDZ9T5Q_nEWg;b5AEn<5NTML$T3S$VeY7GA)12
z4fDnGS6-Uao~=RyRtlkgukBvrsxQ^*M8J!k2lLF=@6(<d`qg}>{^*N7R#~c=K(397
z&I@*=EJNm6pB}Q!MQ4{}chvNJF<BH0u1Knq(HNe&=FtGO&86D)-F>X(0k!lCTiBm#
z>yIIJ)sSZ)`to|{O_n*8xk-XPC=CBx{0L}UlC=67_f5B44A{;SWhJteQTrP)rQ_Dw
z!pP!Ie@8#Lg`|?nNyT~wQRAkyxrII8yWrNH$5s2b@R`xn3(YGR*KCUZMK56;1ZECk
zFIw)g!gIV8bczk6WVSN@sPu&~ZM9)PJ&<#s)h`y_#cl@^XjD!nV9~?5DJh68IG7;U
z5cqz!B|gjYW5mkOZ>9zq;&hz|^njgW7@$_S{XpaUomyQw_k?T*3juql-ie4oW9aUM
z!pZQbb^+pXo3)b+>fs&Nbdv0}QwyO0FV0kTzHAO3vl7Wi#g97H#qxzmf=rK^%1^0t
zoIkm$T*r=P!L6U$ae1o0DsURU(3$Pc)&%{VZYp%RCXN3~lQL;q!8K{u{<U{np=(ke
zqnas$oF=2X8RL5`_vHMgjcqz^q4{5%E{VB|>)R_^yB;auoD*_9QwwHR*MDyB&8=-N
zZ|=Ay=Pmr&GO=}>hy1p4_4G<BnEko&B|dw2Y}_F>Yw7&=!ur<w-r>~BuaLZo)vev_
z!(;QX<hiwt73iH`W{G25mQ#Gr>eilfLhjd$qSfuavBg#E$h499mF3OdwVi*6$N$x0
z?f;PD{TG^)d=}sz@UJx~0tcS~(0Aky5HL{|1PDrlYtlfAbwEJkUz)VRyboD0VY~vk
z9xz=jOF;Thnw0oCC}>&KH>A?Qgr-xjsbZ;Kyhp_QB_MdY+5C?tCD~jlAVAgxzi6uZ
z^}}}x`V&JG<kzK)#G*gS$GDmK9NE~dqM>$YB=z;jes@t{|1p8L5mX9yK=U+AWLCbY
z`i7&06s-YWpn?B!YR#9UYtMT+Q~;01k5z>>H?0kJY5>r86@0NL8HdIQ1WA3_U#w3_
zq%sKfCGBp6MNsF&eMdsz?N0bK0eg7^z(KAt|L_Xs==$~|W0zeNfPsm~;hOG)e0ZY|
zU`7XmQ0j>Gfu5l_z>Ppcb+Dg5jVj~I&(B;K^#jR+`8tCTEAVJSsETe^{fHSu#R8c7
zWmY{OMV0*l^s5Y8(KYQPpO9aUf&!w2i22jq5p{F3<K+A4^-#0fmbMeaWu<>we*9Q!
zqBqSH(&elZ%unL@Ll~HqYTh42VH4t)wws}Wk+N)T)@@;?*6q9taCN=5P_>KWhGgdi
zV$SIp;$v&?=QI3FUeFJJ!(1xUoCWm7LQ^bblF`nZpVK&tYCI?*dFf29qS($rR9c}3
zpBWvNIOjy*D*QNmSgGQ${k*E}`tYdwADZ+Zn)Ls7n)DB7CLsZH_}^+$IB3R{z-dpS
z7%)rL>RcqBp(<-;u<HKCow+v~2<c)FzholxNRP}xMPQUdW+wTXe4GK`*aLN@DZBAF
zWjxbk;D05j6xuzLfzQb}G_Exsj42^XeL^qE#5^9PpP2Cyr&NLn^LbQs<hN6yQh6-I
zj}gNSMT~H&45u7kY`SV8i*tz_wcKoA2SG82&f=qrrAn%RTAo5>$vbZkl^l`YLYe@J
zk6#2-v(%jnXdW$83(03nlZlGOoYB?AuV>4u5(@+$nU&g?)f=L(s-A1H3{Ja$%ugpM
zbZtEPgy5;tihl|8xLPvwOxH}{Y08nQw-l%KR2o*_spSjU7a=)XtTS+N%t_KUf5p2T
zj`A-YdW1jy8-MhVE<y+#iU&{2!SibHOjU1hFFdma$I`E@t-%!$?0hr;PR*-btM~~U
zIEM{{^RCvyA$rj;*jm8wc?Bmgyaw!NJze<dDhvjJ!RR>aA;Zy08QBonIXvmLT3bIe
zH*ewSva`2mWNly5&;<KA>J<=DF?`O#E39W~nUVX=KP*a4RjUEq+S%L3CoTiengwu1
zSJbY-A@sjCHv5N0I(z%G3yMNx;^E!SBV!YJMWyh55-9WnGF(42G&DayFCwd0@$<a6
zqPik{6arg={H%v-FzCglv$r1vat`^q200%!wswG=pI6jIODU@_F0ZQT8zrP=4vvhv
zc>8T^Z3Toyt-{U&IP3F@O9zJGR|MY$mYAM3H8aQXmY+vdx~>Vl@^h_ka9G2@_~PQS
zr+;v@HhN@yVimSFFuVrm>*W`hI(dB+kx|qzFe$01{y#)H{O@s@f2)7vUxD_>kvl&a
zi6H=m|0O4<V!A!}FF85c1UeZ6RyBA|uD*C8hsFw?lXKc1%LM(&$u*S13F+U&gqNpE
z=gKwfnUjVat>nu94Szs;){@ow(zz&Be?WVtQ;rILzz~fl`-{V$_bRrt_~>|{U@Uy5
zUp=7&)tB!HB@KwIur$=<Tk3WKBSR1|{6HbPZ7Jdr>X}-MILK@d{#0YFjVse!LBLc5
zsmAS^sxL?Lm^!;rogYZ6*Wmi+*R<s)fAm%Q3;V6fZyBsvNTQf2EN;lLAMaW&&(_&s
z$;8jW$Rh;Qc!7Q=!fp3A*oNikk^Zl+ko7xie&GE0@inOZz!!uLvi1exD_zd7eZ_8F
zcmZGo0;LS3gun&?q*4qEs1z<>KO7Te)8G)=c+$BbvLf(GFx|4fgn>~a;}$9dw0JX$
z{8}9eQ5hN4KZs|OaXY-G)(=F)P73bF#6;!aPN?WIl{7G34CzE;I1ZUHR(5gMvXDm(
z?sY$?%`G(4FOt<ZRRK<-xGYcYXC_$Aw~$!dcQ#NUs*bkM*}9;nF9dKr26w*bo?_b1
zH-3(pVEq<su#yw0uATgiBTK!fz+C&VR4uh*8`Vt9t7yNtgr4Z|ee}!!!QOdCMY*Qg
zzQ|EUM3RUgf*^wAB8f##f`CW{Ns=XpA_zs!Ip>^n&QRo>m7GDcfFPMF@28&bIX&Gy
zJu^Lbt$TaUTJ=XsK`rYO-*3OacRzcB$aIiVIZt+#3LDVlw9D*ycT0FbT@q><t@qQG
zc4n;aO841$>y{5{+3v-6a4~+-9ib!Nt(w+VEKY4O*kux#Q=9uzyMD=0A`Xr&WVYHa
z*)=!)(!zM~4zTH1=mIvKQmu>qT?=&tlCew$<(6658;l1<WeQ(?c7J1Xw>?FFV{+u`
zgTFDk*9&65m|Q1i=`SW%^oz+cE&X6}Hc2)=nOymcTR)iGNYW1`C-Ztt7GQFta<2d;
z$Eh3)FuBYkJAlb8l=tbzzPImwn+h<w^qe7p$=Q$tOioxGU~<x*?ExmY)_f*Mroj@1
zsU=Aeheg6KcZ`biC=DWwhwcLbx$`X6esY_7BnS#X1FQ}5sxZM#Fne0(R@m!hkTd}Y
z=<>6yp+MwT78(`rN_wVi<(46boZwDjr9KK)TgPJ69vkZ+FNlD<O<@^Tlm$f`PlTWY
z62Q(ZhpO^Owi!Z{m(B|!gtfrW3ByJqpjP3f^EGCSkUB_fWhdyoF!ezbl7dyPRhlqN
z3zRF~{1xYwL$@CJk@h(6e4B{vi5~152+lnqY3WpToOE{H!~HG()&~^0=JG@CwitAC
zm!REw42Ir%cz&48peYPZb(3#S2kw5YCwcQuT@^;lBTFQ^t^d(7mIy96izk__4%(MZ
z!Sk;cFbek!Oiz_gQY5n{LK=i`66eln>2BG<m~vBRy5Sb_fz9EX&bSL{D;|2d&v!I9
zL7_P0QO2;h3dibB|7IthS~)G!RBu!5jE_M<4i-`gCw#fgEzqLxhcTZjxSA)HRbEaj
zt)GUEvdztF-5C<lL4%rVBzB})Vi!sDNE};Iz*FK`5aB2c!;b|8vuW%Ddj8T)Ml!yN
zbc~3kd0h&$ZOMC2nEm|+Xc(^QdR|Xj(lKkiyK&>9sgrdX<>;6abYr>|XFnnq_gl8|
zk&$paN~K>HdN$^RFiD<_QZK^8ObWp%*$|QAP(GyXBea?@ADpTZ99pkTX@xv-OR+Bz
zAg^>xCagAd*=Nal!Um^uq#%oSIol%&9U?T7SMMtnLhf|xVmzqjks_a<eWwTq-!PH1
z$`G~nWKUmS6mKRhI8K?Zq~y;8qp!xZ1@EsJiDO;7<k3BV)zRb;#FB`9Dvrt)6W;2e
z!1+{wy8Vh~VvDG_|4m~!eh#Xmo^ntB-Ta7?B1U!~Xiti*y5gkxfeoX^W&msb_({oK
z8wRbj1h&SblhT$WMs2KJ`ZmJTvV}25T@pst4z|;Br`J#QA4_xeDV$csSwA%ZUl9&j
zpH_knpBjM~XUDW^s&bN_n!LW6{#0RKUh)C?MMsZuu5G-g#;uvj{Hy@D$ye95Br{ri
zUQMnLIuv(5-&c(+oG%B83^jlv!@?&E+Z9y}lNgWfE7kkHSjYM<B1*otGcFE<*EYHE
zJ##`B%$!8jH19uWa#<^!y&%MhrTZ|72$AY=x10#q4rci9c0;LqrNmB%Nk;00V@C+`
zRX#{8O$n=rtvbRc#n?-RR2{WT*C0F#UvycLVP5%a5<Lz}QRCtz!E@BvFxRK5tVpdR
z#Uono0P2$aK5sSTNg|<UDx%WQvnA_>R9UiaXjw|?^(t=p-_7Ce{<_A@4|$q#-ebqf
z%CT@xsMO646-76|%&t?=u;zf529_a1wpH|=z8x%j)49&^cC(fHS$M(wNy;m&iuy7s
z$4=g;l*k1NWu^iBUe>2<$&9dpxYhW?K2MGtkMj&bvINnn{%q;T<m+$Q>;}Jm(@f&g
zkV?={@pWyor271HTSj=W{o&%*Sl`PrJ0wSh^pGW~spiD?8{V!LA9D)tnQq04?89$N
z=VJ&5@kt1%1#wa2Fbhiv&m+`48#t&qeGx46tFaxoN83-wv6V)jHxBHsS%@Rlo3Kgr
zeVoiWYdgGW-;X4kpR{~!UWu`IaNumdg8)yWGFuMbZCoCH&fT6_c<BAQcI9R(b0<y7
zg8%ELM&ed(D0|7*uhva#8wl=R<OJhUcxCMboj7CLYs#wV$|gf*w~Jw2W}BqwrVWcs
zo?+vh<K&*AO@YUUL!RbbX?L32g<m*L2bFw_WNqH2apwIfOm~t`LjGCljC-<@@~GG*
zd0p%KWnWiGcR^&buE7hw@{W?zy6omJ3$ncPQ}k!`559b{FC|_))>5rGZr-9Wgsr3A
zk-OzNh$?#SEb}p7RW&ncD!><KE!N>(xS+rhb9_^Y{HEmC?G#us-b;!bB&7OhX(-Xo
z8oRQoPFEN{iSCTem@h&d`><Rcw_LLKsdze{uxY#022!Jj#Or^&(>k+AfqcLYy_mHT
zIku*wNTmI+!hf@DQn=Ig;cX<hxFmS#Vzl&>`Z0ksRNBe6%GB@_e4!&eZZ)@5`r(}K
z2|_wkfMw=Rf$zkKD}G^XxaXOpBCXu;lxl6RslYpE@tWdhk4)pF+wLYrSl{AMSrNnN
z4py&Zs2+4z@dLK)2ZAl`@3{)!KS?ecx|5KqkxeUJ(LCot7u_Whge$uc(tA*!b2E0j
zXmq~&>gyP!OyF%O&rU47Myz+u=|MC7VrN6(7BT2(!_zL-gP+7(;oL@1#an38K?N$O
zT<0y3>#ap9t4-=-3--~6I%q<D<YRqIB<#$leU!0$(awCVvGwhYEDfN(?Bc#oe)cZY
zzNT1y%~8G{+}>U)en=&#pI@AJpo&lMv_inSA1$$e#Fnj_iod&^e_Y)Y=UV?K68<UJ
zY{_;0nSTD+D*n0j{`u#Ah0}h;b$+FOe&s5DmGpkq*nYLszV&&&jZoia72j5R-!^RD
zAQBihT+#YA`Y3Tg4ORfTip<5QyYIV$Mru9kx=AM_f{($v<qko{kDwJ(^2Op#*i=d%
zRf30&UJP`+P^%US^LqK{o7^jCNU91sea;&NbdlKDP>q=2L6smBl^0FK5<Yk2&@T9p
zqyeM8+G!4Mp1INydY;{WVaL#r6<;woeKTx1l%d$L6mGYkQyr0R!w|HW((B<_M#1}4
zyyx`KAG{G^VnButNQ7<~h1NNs-1!(xOXQTHEK~K^rM1%J9-a6YePDt_<h)0eRDIOT
znJC$dC^@od1)gX{)o3NhXqEVAwfbm{nP{zxXl=3>U7i?y)ffZE7^C<YllmC5nHckn
z7)!EPYo1tJ)mVGSSSS#*S0C##!@f)kv*?uS$_jE(bxaVEq@RiL@i+HV4Y#h3Yxf21
zc!r@q;@RMi4XoGp5RYe5jqCOk!pxFSiHb9;k5i<LTU?K`s*j@=dzsG@X=j{}-W`uo
z9UB-goN<xh?H}~g$MYVKYju9C8xM4th%^!>DP1}0Lw(ZVOw#a0(kNN-I8X9N)#ORX
z<mve2*~|Lm`I+R!i{xdplvSRTb=8y&$CRxZ`xnb-=%Xq77b%BisYg7i-&9ji9aGQa
zQ!ndNuV+$`7pWlfG*sR+bTz;-jrQUYmD>`8Kbv;*GL3*dosc)3NG+Y%DV;PSoxCBP
zVm6)fGM$P%;~{Uxqn&i_LsYghG|aM$r?VN%ml-VNnQXk79BP?dPMO>ZnY;~|{Ii(?
zmzfaqEFs>k=M89VqbT>~KvE4^FK4r4FSF#xvlV!=fp&N$r)-skY_*1LjoECi%WQ4(
z9NqqG30{zaQ;tzWj!8p~*=&yaWsW6zt~GD2ty-?VQ!X?i*Qp`bWj5EfKliU~IaoiB
zKmZB=?EityKY##!?f*Bowt+2reo5Kv`~t9B1{^!U*0-~_&(;M7kO3AxL3Mp2U{?=p
z)Fl*@f!#jPX*4)83T*gKPtQbODIOdiDyVBWw{=)Ke%RUFTUuFZY=!S19ImXcU0hy%
z+25aET#8Fh;}?GkB-8f|4g>vkz^=ZjwQcS5=j?(a9TW4__0Ni0y1>5u>(P;aSmd{p
zlc0#0n55K<+yWD8`}VFLV2i%7xpn;Q+tkdgfrSlV{+XPf1>BOKre_wHR{)=6M^A5J
zdS+cy%a{Fw@Yn=k1HZMs<K`3K?icv&+euDgNi)3N*~91L^z`H8)XLiW$oPc1zOk#f
ze_nBEKzP*5+`O)-g^uxiMlOC<ej)$Rh$ozU6}9z&5z%jr%(RW)YZ;mX5Wy1aQrp-J
zkP8P_5B>L608{wj?Z?C|@M&uLy`3Wi2k%qxa{yid*a8aktZ!~LvxOFwS8BX7-uv<e
zAPdPE*=)~+({l2PE2_d`;zuVw>YG^tXv4_T&Nny=pbSYFSpeo>=6Ugq7xH;yvmB5p
z?VSKj(K0lNicebqyir(MA@owdZ*V9jGbc4Gx2UY5prjmt8rnwh0TvS)9ru`xyRx=^
zWNe~$V93KiNYB)Qo}C8}JHw;nbZp!J<EXB0)HAaHD9qT$Pg({hHqLJU8hiWy<fr%t
zM<6Cqq-p=omV^IavgN29G5kOPCZa}mKWsUX_BW(!id5tEMhY|s?Db}AEZ3ag8GkLF
zZ-ge!zN-V5F10>a9)GiayKJSy{fb#JsIFWu+=G?P-ftP+j)sjX)@vo?3CE*@cG8~%
zqdLU0HCfO>HH($N$a_jHNn~)ZJE%7m!i37IfFg7?yl3R9N4r6l_gRWq(Ba<F77syN
zX%ZM9+!V}9SqO_q0v#GU@{m-P(#UGfGhAJ%g+SDw&>dg)5M{Xw-+k_em;}0ZXVMX9
z(stBw>q8WU@I%nD$YZQFZ4@-TWkYfY%o8{W&l5c_T~Z0?(G$aB=AguSKoRu-^q5#b
z9g_>YGa2<|5EUFFLj@IXpsWFcgJiF%7ci+oFhRjPurMmY`@PyI_@F@+@1WuA8gfB)
z$heUCn>4mr2p)?ij1&u-1$JB2Y-`q((iI5z#I1h}V|>RP^-!?ioy9#61cP)yC_!>4
z#PzoyL2kEQP{VKq3D#5a?-O{TVc5$awhO{<=%Zm_a>CJL@q<QtAW9O32J$ek+k!Mf
zo$^?udZRkH^vH5fqFo^~I>j~y)Ef{<#xZJ+$DjvAEO3wqz6dpjWEQB48gvNQ2dty&
zgfT}R-fqL9&<I0M29@=`PnE)kv=O)2QMH2zaI?CxK^$q47z`{r_itEYfBYPxp9R5q
zn)wi;tra8;0>ROQsbCmr*jCgSA{4hp(U>f4Da0yiMbaU)7?<(4r1l^Q#@L!H-gzLo
z=}pKqYFJwom}~4k*%Le-xp!}(EVJHI&4Yk{y2B#5RIs1ms0*k_`xzR@YqnH@iG!f)
zwul@Y6-@|V+Z}{rm|WetEpHazg&_(Ty-h^)2!d&qfqf)sXramm!v6*dBSPKMkn6{3
zFx*6r83)1hAp6N>C?E(3g7z4D$iP-Gks@KM+4*U46gptbssHRkb%;xDkn~j)Un@$%
z@1DlJx)c#7fD+80URdVNTHNu1J){FI^QPS3hcg*qph!X^pGCnuAUBN;C9xL^nzA6g
z_#haFf+`)O548N%6N8sj-xHG*b@W|B1dZLrd9)!j&Sr||aQ{}eCzMxIH}bHEkg!`T
zjF=O98FjzmmLhZnbDIowrC-&rO(%%cKDlVlfpPyv7B1=5QZr!&(*Y~UWrap+B89j*
z|IHT@HN15ALpDb5k2_RLk#mAiw9!Fc+Lo>45||p?-23YxRNwjhKp00}52o{_k-|<y
znH07a?t2g%y3sgHI-NFe%T4Fo{Z#ToDlG1ZU2Pn7l@3Z`RzlgmhmSdWu}na)L^2Vc
zra<biAUNN>Q;Xmx8ovWvhfHQjFUm9;<Q<2c5A*dh4)!((KPc>;nBWSgl{z+2wnUUd
z@{>1(Cecq6<b}Ky*{lwvdog9<-Lv09BA<CJbm6jfwANdhueJ*c&JvU--eyH-GD7=`
z9_D+SUWVG#XbR0kJNe;5{qP`>e#de2#Aj-cf-sF!KxG6;9@r20UGtXcu{>UY$~L3u
zI~23g2~lF@A<?90f)C88xZ%;uSoqU15GW4lEh<$kk|AMbM>I@AWjT}>*{RLqJDx6m
zvp4RppuseD_`N%d57`;0FsN<U{bsKVP~+f4H}c@E9(BvAW2o>d>qzV!CT1cuolVrK
zUKsy;KB~gu;OZePpL{P}-pQyP16{k=Ma(KyWIF-kCrO%2$sUQD4<YBEqo-jhbj2Bi
zxIB>xdvW{3QM4{JlRk{!9ltL*g0~k>3kyV7^q$JogpS1u_ijp!g$zU!`z{LvZPRWS
zohL2D0-p^=dkEL-9?y2Q4x`!Bpf15gQJ{!dMuQORV-~7-9HX;%h;!Ibu|kB9Nyn%U
ztfW%)-vy{ruZ|2l**{5MV1T@ko-H$*q)ullHu0XB`B-vVEyRQTqAP|sH|r5o<I-0A
z-l1?t_cE#$?j30ADLv1A_pI(c8MAflJ@o~)vwC@XX4_onJKG9p4J_r%_O*e8U#!m>
zX}&T;dv=L8BhH#;IG;I9&1s%goHei5J#*PqUtAhLYY7W~=6dF=guFbXSw$RtKzq7;
zL0AVrc+TQ6Rk)0iTHAJ$@|hRS^#aaoXd`jUp&fhC%C>b~#|VPOFP3rj_Ji6^Iy&Zn
z*ZA{yE1|W_u2%1h`IJr7yq;$o!8vl<liOx3s03ol6F4#`aHHvZZ*Gr=lxKhlS+t{Y
z;Atq&8T6N2Mf%XU37sE$yeqZ!$HxMt1%9iCVa`|e+l`eXg@~5*(DjA*s2X+p$je^v
zYwm&QM_E&recWw%s6ymJ!q6nN<5Pz2_GMe4^mgvC*NM`P>V;&Wl0GNES|1*_@Z!jg
z2{L##tNbu}rb4g*9fC1m))UWKy<et5z7I*@bH%JmeP2|gFhDlEZCwpfMAV>HIZavM
zRSQ0uU}w4~otm(3E9#?8E>Ge$bn`tVyv_HW(yq#MV~E{*s$k>QzWSL5dbi4%psZXp
z4+rVl+^d=m4LrA;`on$LBcg{?Ij>9>u*l9JX~`fS<*PmuX-KSe&KKx+9`?&c&TO}0
zaa)Hu(b(=mR0$Z$AO%0HB4jm$LFNGI@f9?jLe`7KX}54go1aC+s%v96msxxhwEiG-
zv`#psk?k2A<)#V@hcXQoHU(Y!x?d+2h4;nq!SZ}i%C{t1s5PwCX?fn@qU(;UMLgg2
zq@_}F>2}ek2R9_ONw#LRxGCISU5-aoSv_0^DU$ovd3}bsDyfxui#zB3oGM9gUE~KV
zt_RB~(W<DE_hgMV13&By)HnzQJf&U?cbdvI;HyWIJrv)4GZokbEpA4L;ixW57Ao-+
zydSix1XHm4ieHNq@d>KY+#QV&zeuTHd~v!}w~*kQtfg1tV2kEFVpz-Go&S;_J6r1{
zB}ZyM{Cg}ZUls=l9ejLa?fMbT`{0S(meoq+gVirKshx}8k^UXeT<=D<UNZ^2xYQ{^
zo{ZEX_TAo}ti4USm~i7hZFMs}D*fJb*!n&As~ZSP3dHTh<YAawBtYCgv>b*{PXfg4
zw_~^w(u>|!aW}PcCxsFNar^Ja+$oLJh)6v$Q9T}Ulh8mt$aOuQ#N7qr_LaYSut3#Q
zxja*8J-Jkr7~(vyYCZY4+yu@&QAoXnBw!*cURY2si9DE8o!5<NFIjANIa2RCDxQjU
z9NbXv4MBI#ZmWlFMw#ENNo}o)eLtveS&_EgU$qB$8uD7{n<YMWVTvU~!}?(8=R>UH
zWK2THCH^>k%28C@=ZOPHlD)6Sm@Cp*!jB33sBuapxW*6FT{YU5;Fg0}2-vUD-XC?$
z$7hRZ$JgOuE`?E)30U9k(8oSk+@<BVwM>=12e(Yz<U9Xq{}dzdTht#a)-0FN%#D5D
z-HLVM^sy@jtCXq`AWlI&;(;0O0!Mr;>ZjT3!Nzs;W(l!DryW-6-IQGt1U+>D{pYU+
z>F-&_24--pjGw<TRSb?Gh3u-3fvbX}?S-Ey`x#2u3T^~iiI~+%Jbs!h5!V}xk?R|!
zM79g{?a%gY5_U+5wQS7^G3;g+FtAaqwYA}POf(?CKMNku_Gtz?B%_Dh_Ja0q`yqN6
zB(WeAGtRS6e-b_4NF$jfBV?FH9aoTnG5fc0aT)@v^{|dpPI#_!h>~$aFO%b4|67uQ
zca;2>{O(GUMM~#;uEgDzx`^VCh(<(sD_sx*6o9E5pa5F(7tuptZ(Y^scdBmsjxloi
zG3zVQW@Ll_1pvjwSThg<6rj^87TWg;pa6omV_oA7bjaciP~yDmojy3m@#@3{s9Jc=
z#Jz2c3u9pP=ZR;hj*l^xjE;}rK8Z^r^Gv*m*97ABabmLLHL@HN-h?L<kiAWrNl55Q
zDBHeM!IOCMF7bg%VjYiuWBuJYoW$0dgtq*I4#$Kp)r1~~1QBI|TKgc$au7H_=5$LE
zw~y!!L(GJv^)Zr*XzC(*#xZ=DN6=b{l~dKYS=ox$-x3R!!aZX|%AwrPstk~iB?fBK
zGf+h@-zeP&+%V=GBeM6o6qUEr!gBcze9ToQlQmRRZ#bm-8ako*8slKSzw^Y(v)3Xn
zJ59AOt$i{$huXw9)=bLBfrvL`RLQ@GJDS`i8Xwnum?xB|FSwQ~gD!yVk%?9O5okah
zYSEYWVJqpOp-UWXhJk%1wszKQoXF&!OtZc;QLHRgtaMNMbWW$NH~kKIvFR<3ll>%u
zmTiI(Cg0PlnIIV=ZZueMsb%xO4gi78muoT<>yyyOl5)8SmS3}WsziyIWVIT;u%R_5
zvyZx0kce!KhnA}54cX=SHFyU!<nf0mrQ+l#G33Wf=EoT4NBZZ7<>v?Y<p*r%`{ERM
zF%-B<7PuN0IQths^9$_y3aqyao=fG0?8H^>cvPqrM$P2ascF_W6ei>swgeD2lNT*Z
z6pe8fbxRSH&1Ur`6b)<@mE#nRnj}n^#Ez>K7djSC?<CA6#LmtZS6vh@J0-4N#t!Wi
z4fJQPs+BbLmGFd@7&7FdmnYv1NAYOLJK2sP*9rFSPrD|+{k<VkpupO9LsGZq9mcLx
zkzXD%ftk6_RMhZ&+F3+nLg@_<<kpngRDAg^aakQhDWoS0*HEuk%uZ^vye2+*fBMBU
z5@dygK{kp=dEI5QcutB|Z!rHvGCg17NqmF@I7G-F^n&mGS$~<P)H?(jHM3;)SgpCV
zvk8WA)l`CCww3TvUxfgJf%2TQK&I^;oiX@c{$@ha;ZBKxbB$4AjY(sT*<6kJRgLAn
zT5G;qTlHFd=UQlDty5#I%UrGNRW0mZod;i?mwKI#bDdve9S{&5G*=gLRTp-zK7y}4
zDzHwA)Y|#6;VExjWt@dNxvl$L{c}~Qd|_?IoF%HD(eucR4YGz~ObfpCBtGd{idfS|
zXgLv2qYYz2LTo*zT7x5FgEO>3PQ5CJ&!RcdyaKNY3cO_CJ7C(>cGZBDmMVa})12f?
zz<kD8ARS(LyC(Wx%PL>Xx_ZlobIVp@%T8m<-dxN6Rm<VM)+4^wZ|be5&aLN(t(T3h
z*K@68k4Qlja8!Ocx&|E61&*EcpUB#$Xn)Ax{z#*p&ZYggto`|R=Ih_G_Bk{<xLkf@
z?ejKu@B>-<*BuawP9gqI5sgkUmrjYKPN}BOm-C&n*PU_{T?+hNiW*%?E?p`~U208T
z8uMLR*In8a-MakU`WoE^F5O1gZKIg*bS3!BFpx1tkM$nhv<WW7)dNlH!O-Zzb?I@s
z?m@x^d+v{Qqga-q$eF{EdZAByQAWE>U3y%LdLx3mgD6ZoiQ(b=eF^;C(fHOVX%zJ|
zr14FCS$kc{d!YMYD^P%-^7(#MmwwRo!@_I*5{&^h`~i@QWs%uH6Mk2&OCQRpStWi?
zv&Nu&Q1JU}Yuqxz=bmKU*Mp-JL*x8IA2o(1U52KUhGv_F=I4hNuZNZ?hFAHA*ENPW
zT!y!jhIg8V_vVN9uZIsQMvnMLzG;k{x{RDBja)X3T+fdnuSY=lM^T@TqHB&~ei+40
z9>r}Q#a|e`i5MlgKSua`j7W2g_`?`!@)&vZ7{$UEC1Q-~{`kY^<Bv4Q={}6pCnLw7
zG><=B7(aj78{hPfpn?#+9)wb4;#<^=y*#doKT$Q`YjzIGH<R%k^x=C<YHr)hJ~W}b
zH_^HG5i;b{Ip6yTf|^cY^m5_ja1&wJ^@Im&PGt8dB8N}X$)Dchf9fHH_ehu-Bl@_-
zC%N8F8s29?LqV|&GB&wEeVL~hTm<5E`eZA^Z;j|zU%2fMG*w<SrK8k4P{f;xKjrzp
z-~0KXFGYWO5?^c*C@vl3aAPKXs7r3BU$3E`_tYVj>7xo_Mjii?H~)--OP_n~U~ch8
ztKwO&<_QhN1Y=@90jwXwG$%TF8=5>@6WmqAG!J?`2`{n{dOk-Y%<@iiejNFH;iKll
z<cEdn<b~Phh53brMa07L{l(Sii|d+;8y^<8k{5TH7xxwx_YsSS_m_^IFMZQoI{mP8
zp1gF~ymY;=ghVWXD3?(MmeIAAF<qCjQ<iaCmhl&tZz7ioC|3vtR*1A#h+S7mQ&z}Z
zRwx!%D3L2vl&cQ~Rv&4t(z&kEr>s6{S$(>=%8XoPp<H7VSmV%I;|duK)W$|HTjO6`
z6F{y(DA$Dq)<v||#a!1VQr4wf)?Y5J%Ocn1C_gI*e3miC4uoUcYlGBUK5Hy~)<S;P
zrrgjK*wEM7FmT;4O4%@J*)Ut&Fh_1!Qf^ugZ`i{zi7c@&!Zw{+Hl17+H(imNFv=|t
zfh{ksEg#n{zm%<jmaU-0tq|l^80B`LD;AM93O4)GxRmXLmTe$tKLxp+M!5q7?PqE2
z<hbqtLHh+QJ4K5-K+t}^`Su9gE)cX|<GNdyvfI$I+qC$%vi4K<{*pZt0roSl-?8W4
zd(T8<UjvL8pppQB?dcyJ8XW_mulP^Q3?NlCJwpJL0$AGB+i!R8i<+JhCqzuw!~%e|
z02T#6EWo70W8wjX43KFqK`{UZ1Mn3<umA%F;48p)GxG|5na6aD&EFcm2SDuZmoM7J
z=Ko1v_{X>XaRvUTuE0NF&#1j=<(WNy9tjP{Cz9g^nxTK%?~@qhy3o<FpGedZjG+ys
z{u&9T_QK%C;IJGG^FYNE{W%h9(g{*QQ;~q(5%j=Dxv3Q<hqCE)S7`!Z&q@Z9MGs{0
zHRM){Juy)&nPIT%V!(cn_R8go7#)Wg8${1?o4O5-PP~Yl^0J<787+?8RA7`^L^+9^
z#Y{lEzG{0ySlnX&noMwOEKhGBMKi)use_5|nfW!hwbCry6Ys%G?)~`&)q@Suvf6{g
z&CyIem&WSdsWQx-7*UqCT)=*2h<qT^0KCuP*2HUjEB4J{KZ;KSsjXa}r7q8pW4qH@
zTY-T*O!{RQI<e8RJ2qY3vIjob*0Lvo82u0Xz0ry{sX^X~4~6~KiZ7K9{i@%i7^Br+
zBcV@gwpIgKy6M+~I3|tOg1I+<X;A*tt+h}HCc}D|2(j^cxCCAPdc;ev?e$1GF^11k
zib}?xqg4#@KgVd;Z-0)}_F>qF(~mLUh&Rf~-$*d4+1^OB>}J?ZvYj;EOondcZ>G4M
zZf~Z-FrRFtc@djzrTftpY-I#-?QCU+i9OlQic&J!&W<xE*v?6^-`UPh^Let9mlb2O
zlb@GUuv1V}v$Io(EbD%<TU0e^vRhoYQLy`m{r>-%kx;j9HJ|?&3H@`=>)#&<eeK5p
zX#?f_sps{t?Dv1_c~zAq%F;%oVS)YXc|A@!kNa&T^sjqfad<s$SVGV-{C@Pjjs>WF
z%lLaeuiFx$aCa<z7>Fe}|D~bSU-!Hg$oWeB>Uq6eAdLb4n8SOLFZXXfuPQ?Yf9iSF
zzEKGDyegGr{>di)GX{td&?&lqN2hQ=L;;;LF*y~RlnTg@$(dQ;ARIV~22Q>K6S}#*
zQ~%HiAYK4T0$9$0qgg<h0IFnWegQZq2F}!foeBd-u)mIe7Z#V2(zAdAVBlmLIPnD(
zN^oQh>vJLC>{&&}0OlJAs3E{j51i}*2hTByDe)=k|5JCNKi=n$EASs*fq$S=a9^hX
zg-&@ul=SC5dJ0k$6c2PfgWqiO_tBn8Xur<xxbq11(<cAgA0-1*PW#SgI~JiCFSNfJ
zI3wrHzR8q8;59@*jtbKR`smez6y7WjN|v>wCld2Zd>8<tD_Z4!Q6btyaLhz9mOaD(
za7JDtA55phii!fd9r(a>aqwc@eI!lz0SvB96-b;R=%6*!aMJlP<9-xzF9>xH4Y0{C
zHnW)EyW?mOV5Cv8AFTD-h<}hLM+tIQ+$4V`+uZOr{~>0moV?{zoqUsGU`+7f%@ZGd
zF7TtE5O)5Hv%?QkC)#ZrUbuM8;(jBot%D$PFYP<nw-^rH-LUDP5olbJhY%5ZdO)W<
z2)9K2L#O-^UGe`zbOi@F)Zkw_y5g^NiUNZ>4kqO9_R#}6rSzvxdF7mthEB8$L&5wz
zef0mPQ`F>d$}OYbr-%KmKKj4ZDaNzzcpPac=-B_JQ-15C|Mxm&N73yG>_;E{FP-wU
zkKRb8@K+!GNwH<{uRi)=PO9H0Z~c%ju;0m--&_0`IQani0!S7>i!g%u2Zl!hodFo%
z0RJ6eD+4@wfLH<idVp#H6b#_G1AJ}3_+D0ik%wOp;Ijh^fPnE0peulbthl`D7h{oB
zR0S9dSV#i!^aX@P0+u>E7npZYDBy8xY43n{bOGaX+dI1=uM`1m8!-B}u(X_*p7o2y
z0O|+uzLiu|0R}WaG3o01CIt=cSE`z?RJ9Z|bliOdBjXbJM5O`y9)O1a<J;9Aul{ib
zet!l2k$l0I6G9Vt$j9;LDZc`ZnL`*3`b~-y2uv4a;8*fi<z_Dkg_#PH221xyf8z2}
zzD(p2y61pkFrW5&!mJ?gpYlc9Eg~%eWyLd{7iN9~kS}w!nrO?UAdpuZg)mdz4bTty
z0+YA4M1f(wb-zzw7FGr>Tk8p<Vch$Q3JSc1r$*&B3MpO(<jYkwD+&Z36PxN>g|PuZ
zCp@=$Q)KRS<D-N4gVKhsKtS@A=c_##XD_UIc5Q-Grl$JiO?)>92u_9Rfy1UEyfmEb
z?1>FhLq0u+qqgBur8E}4y`|oc3A%q1jot%};rngxc=r|s+yhR5=?;T~xH)Q;+_7CT
zqHZcahsj|Ihihwl5GhUHkt3C}^AzI1kM^)9_Mv|$1<7ZLA`rV_=k7vNvy~ynm<EI6
z+~k45a9WxH%tCbIHo6FT6nyOu%<@O_*1tyb7R8j-hC~nV?AH+JU?$~RZ;!y`*H9RK
z78RCcuMqiBnBU8+ha`QyV!TJ;VL@4s9!vH~sU1bc4QA1S`}$;^{>PHH{z|?q<L7es
z04WE5!YqBm_6^6$he5f2#w;uU4zpZJ-}?vyVawzRk^D&B`j$=*{5LVnC!-r?awxY+
zm$T?)@}-pf$7344W&dr=!gE&;gPy<xl@tg*_&f6DH_URkkU9;5O2`7MNH{6_8}eoL
zqy#!tsCCvq)v{<;go<6HjU_$ZPJUYECsU+LGBDlEds-eATm(${&Gf4QQ+`8x@6b^H
zz2Nctli&dkmAHi^0arUP6EObq(=VCv`}@Kl&;Pgr|B_eW9|)eC6cBBga0n&m?*vaD
z3kU^tpUm2e43_;{)M(}UU>uH{&z@ve-dLtYq!dv=SpInKkEqd|V_G>6*?g0Q{%Xcg
zMIg8n5NlAR8YSD6@`KmR0aLAcAEawb7E0Lhh+sV5e#AQ2V3NM9JA^fZaPjE}>kO6w
z!6R*EMp~}h??nsn8r2QyW*0sn)`{G7zCQbPVM*d?wtGvV-T)V#{l@N0osGpC(|a}h
zOK``G{rgRIR*88SgfE7h>cwKyNszXCO$~N_R4=rehnpME4wgFrUh}G@>Ed{6qVVlV
zOY_y);o3mztJW68)%o%662NQzI9K{3YV`kus8K3SmX7~&)Tqt>NYp6NZA%c!^gk3l
zgyC2a2;^6^q9ib$0z?b_fDXUz!9cVS>mci|$M2v2`HTPYOaF}@`STm{4X}yzvAybL
zQ|)Hg?P53WV0UWc@NeOWYU0Rh;4H1<tgqpOS9A4MagA1TeXQV`D(9Lm=b9<!nl0y=
z10H36`6%U@1s)|_Q+Zqy8C;{u;Nf`iPz-o565JmS?hOV5=}29E;7%WKhX)w$0&cbe
z*S`Z-tAfj4f=eLaVt#NDFSrm4&gTT@ae#B!!C7qJbXIT@D>#-F9Ki|>WCi=Ng1uS6
zK;n`IE7+YK?8XXqW&_)Dg5R@o>#}jbVdoZM=LWNLKV##4!p2L_%JZ0&n}Lm&iIbm;
zTR=$Qg{+8>y0n<~D@pw~GA3&BRys<KCYo-RdN6B4cRN!LsHLZiotK-lkEgqzpP#?K
ze?UM$U|?WSP*8Aia7ai<XlQ6ySXg*?xL0trxksXkO)^A1iA^ew5fV+$6G_JvPRkKa
z%N9w?7EQ|<OUoKh%bNJ}NjNQQC@otkEk__NS12twl=gW9txz<bbRwN%`s23+^rlr$
z-8-0q`dOn!IMOFM3g=i$7X>O;-ZX5OweLFi9C!|V4ITX!J${-oeOWMnU9yNMUA(GV
zI&WM#ZCyX@+&=H#z3ACF>)ZY|w0SVLzVmTyb8>xiZgXe-;ArRMeDC~f>+<^Z6=LHW
zv5i3NArM~?h!X_j3~_ydxVl7KTp>=c5Z|s5N7sn2*NB7b>pjHf7UFCLakhv!SwI}m
zA&#aHN1qT!<A|eS#Ni;~U;uH@kNDDu_|l8m?MCc$BDUHQ8?A`X&4|@{#BvQ{u^O>Z
ziCCyW%>R0nU(c0Z%@kcs=A2HXo{S|OkHj61#(x`21n$9jKjXdyJu<xRKQh`Mgz!cN
z$lrkmt2c9Eym-zBWttBL<NZ1A`)3&q;O(IPD$=f}KqnK&jX_5-BS-Z_`_oMmJ|Vfx
zUPp85-=Kq>s@N0Dy&MVt9^99~3D$-$fTGL0bxN-Yl28jC@i3-+>4RhnV2`I~1*%n-
zY5>tf1GN^fixi6~(KS9DNR&Q$E8pnTN%h2gmxUN+8YWwUx&$X(9IUV0Z1TdmgO8Y@
zS`Dwp{l-CBsHW~7b)z97he>LCuFhtcGO5~9aJ=zVV3YSne;ZI#GrYkinpT8*tie-g
z&-6gTj}T80&v5N&{#%Sw<lXs4_y-V$wu0ND(Wa`SArJ5>42cyJ`TI}}6C*i_)T-@F
z_UM*j3@DGo+#7I6B6L4}?7)=lyDdV&qtC4j;Wowjc9)?6T~v-!;x0s*bKOrcOn0|R
zP>yj_&aa;Z%bQ+~k&N(Tu=<7MnoRITlIU_Mgc+T}1LujpmPFS1!%_Q-xN12s47rK{
zT`SdIB|=NN2r-n}^T)TSFcen<-4O8be)g$H)H*1G#TRdwO753qsnyCItD)o<eUf?M
z45^v~zgg#2dSM|qt`X)(rv@<+A!bmB7C;e|6Ti3)9}~mVe7yk~xof!|kD+o#VD)~7
za1nx|DIDy$Zg+?N8FJKLUm9gWPH<EY<C?}OG~hIWUb~m-4rv&lH+nwAhKxo=@YDPm
zaSj$|;F664uX1o9hWll-F3|@42s;CA7Ae1E+huSu)|V_(!OAeBRWl5V-Q6a%RcbSo
zUO&1t4?6jXzzVeZ%Fp`u`qcf^3T|A_gEfolXC0S^UW1&bIH*UN1`*>1DEA59fS%sb
zWE`Oqz_m5t48Gf``yOLZiK&@o*Ps+~f!X&=%I2;xof*c1&VF_W)m|3CGAT2;G1Q>~
zQ=uE#r=Q{%h#}(1=*DZZR31K21_M<qq{ma)D2zoG=!-=fQ+OYgVSJK;JYo4}BxRNz
zXw)BUi!iQVt{}};%j0xS#eMPzY|*UNh?_#K5p2^zS6xOHmm3E5^7k<I%Y@C}79|MV
zywwVu6`N?2R@dZ;A+TxEb`E<|yQKjMc=3$+-fZyH@Kjh>?E7^INpn}Z11rPfue(p|
zhmAS!-OBm`fqg#;w$f0F9AR$?h$8Pu-D8dz(3;yvyvF8onp;PAfBHcIV@y{$I{y1!
z{-|wYQ+SX<q>~ZKy5li^{VH<}r`hbi-V+W_yg~E;Dw=lUvz8us>-s+UmTlDMCll#-
zCmpvG5<8#KRglxC>k_*0rhUcK#e3#1`BHF3ybo6n4s8~tmY+!Cy3}D%{D?|kPl(Mp
zxf<;Hjamw6S3jUiJPm)?F5(gxKxN)5PN1;fE<C6v?hU0QG|zfz9_OD5;YRNQYUu?T
zJ;aW1E#u+MTU6VmDgy~R1O(}!equqHQejXkS|BF@Bfaz4mhf$B5nXRF<4n<~UHMOy
z=pNpw_u)nwg&pwk=@m4-arW@w7q}||<e%t?H?R|M_kWF~jmMqQjfgIW9Yy86{48On
z5E-9$6kQgS{nSu$;6LH*IF26;%HhcUZ$O7X#eM&^x8vVI2TYEz15+F;T)9xg-d)oX
zNBvyVRf0f5Kkhx}ZkktYiJ@E}Br9Rv<@)kWInf`p8jKkP4cG-Ew!S&@-}M0&TQ=q1
zo4KhgT{NOP{g9h7=1T;DkX1GX8>1|#<neA+Et|kkqaT@SC47Y*5%)$D7G<K6nV@KQ
z5!bpz=W(xkt6^E=`F!GZwfK_tGW<#Xk(WM~*jm@9&<;Tx*UMbx=sD9o45d<Q&P;Ng
zz1OMLDkLR#WnZQC)HLG=253ce`9FUgIO?AoH_FO2{j$v75}};@a56Kw7<o_mKHg;R
zVzi+<U$LxLKc@u434YTjZ1xu2kNc|h%v|2Pm4j-tLt9*$O~vZM`d<~N_D>34yfM?0
zzML%KU9S{LEHr3yR^ObirY>RWVJ2T)$Q+xLLXS7K;k%>0MY&!3F+0(2&10eYNp17&
zXN6Y*cbBB!_%~tds90Hy-BM-=B8lnPf&_`pUhHhtVqCnp#dxTkx8qP+dLn4wc(r)y
zq5Np=^Ls~zO*E}@2+e)O7L%62G)Nr^p7}hh%<__DQi-H<%Deb2&)}Q6;hHS|l7q^d
zgX-foBsqOsLPAljGYi8fJc`eEf?s$lq@19aQBdxMt`V++9BvK-%rPTJf@*YASXC>0
zPoC-2d(|dilDuh;D~YMyBkOz@70_~Q8PZFkUxfRppys*lqmb(&Vbif8rII-a)m^ox
zu2DUNCeq#)*HR#x*_80EFS*Cth95&NKjz6+7bp+yC^cSwDhsJDGL+d>o4cH>8?OEl
z_pNnxIR(F2Q|2qPr+e>ex>vTQB6eucfbVK%G^C~~SLTa}`qk|8a7|6^&=+&(tGVTy
zwRJr*`__q9^INjD0<2Ho=9bwNV9WbK3O;GQFqK%~cD$)YsPHc5k#dhIvwrl>hfTS)
zMp_=(FEa588aV!{fuwZj<%F(>k=jn9s4+YGx4|Dvq~6#k=9so3w=X~Q+0?Cvl+;N?
z1#OlR<UZ!S`QF-}rrZte<Z)=7--%~Em8zxjIqJA5;2=w#a<{69y2mIQab1>t=TR#)
zR)b*5Jqv$FwGzcpCRpapw-@FdnX;Qir%xWAMBn0BWOgH+Oy>-%vT+!x;M_O&B|Z(j
z5e#Q$x*7>>Nf=Sk6gs$%)Ae25+R=`C(XtfUP9tkeeT%bP{q1~LptEi{xM-hf%4`NN
z<Dh=x%V%#U9<7Iz(B^`Z!{j9<t#<RnrW(iNVA;YBf9fz_YIDx;SUz_qysesudFoRn
zJMkuy!*uBSN%!|hN0ASDKC^$n7!7Utmir2^qyGJJdZgvF7CD00cm960e5>`m=N0lO
z@%#1GtJce@5#(v(cf?_6>-FZV@0WAmk>?|=$g`2}$SYtkP6|^vGiNZ=3KgR&88x5q
zHD*_G>8#M1a<F<~$WCDNA+lEaqKgwl<*CVu-4z}F36%vJrpH6*YqK{@?%(dp+QG&h
ztQw-<3SimX_^Od<!##d@mru}$JCA^u)Zm7v!E*NNXcBkn&&qPO+&HnC4sRS=yS%pS
z49}~%g^k=rxAZi%iNq_6vpy+EO?nxgsWZmBEd_gj+Vm)-HG)1idR1%1_R0IkijU!;
z9h#LEo-#;Z0{APbyon)5sNq(hCbq=(?FIYXRq+Y+(m|5->PkWlrO&-Bw)_m2^_>hf
z9O_^)4v)qCXlg%uyPuG=VfkA^Rjqt9+U$Iyr#&!ORmr#&92B0)fQ<_tYZ?*+Bw|>=
zxD<nEVGVVGP1Aub=Yeq2pmy${PL-f;Xi#rlP=8&};B?UNdC(|n@HlrckRLP&4W5n*
zo~;X>pAKF;4_+n>S>+B{R|(mGhHUx0MptpR!@kqF3_J5R#*DqAK@$2f8cHu8dg|cL
z&=nG4ZvmUUL%HQfa;Ai-tVepPW@(^@cpN$cH+W^Irmv#)%rEq~HU!G<bzh7kGCQ0w
zGxWq)=UNQh_}IClmWP&%kxJ5yKj$`09?Y8qdCQ?Lg5-iFKUUxH%$d7SjhMlW@SGfT
z%1<m)U64oRIhmUQHwR;#`W<5DSJih2ZJ;-5m003K{)uRzSl5f#0FUr?5@Y}KkWOy*
z9C>#R9GIUf!RxxX?^AJI50xGmE58Q^`NeBUR0fDkhGCYg1S`kCn2x{Ervbv$O2P?k
z^oxs|)X8^@%b9VIF^DS25A=&yPCreE>(fZckEn8t!(#P76^u9HR)RSu^~NXl|Gj7-
z<ll@Iici_8PuY`{dC_ByX@%!_78rb?Ojn!ug&umw5Olz!f6%QaqZ)*$*YloI@8M3<
z=Z3<$(`;*OugHS%ogy$yf^L&XVoIemVx*$lW8zAslBrQX&QZU=6G%F9t6WrD7=v-}
zQ_6oPT1Z4KOUx-tA|dOyXrY9c*L8HAzJ?XA^=L#D&PlTE>G5AhJGrR5GZahM&&`%k
zAXr(J&tt>yJ4{5skhuD+RY|YtJH@usm6Kg>$s6rwO8-tM+7I7eJq*XqV_OK>d-lfF
zHz$JyUlWvvrDJkHlI@M_*Yr6-$uRetB-_cvF>i)|xtlho!A)MuDruT+mH<b7BR^9$
z@#%IB@=Z<?=R1P<g7ChAmy_9KcDkBA1^ABnRZp^8NQ{~E)Z<R#3of&|or-{o!v2P$
z!P%nW%c4>8;&I;Mk7~t}PQ}v+#j_2?^RvZ^m&MEEC9Aw8>uMz%P9<9jB|8lzd$T3`
zmnDbfrANG_-_%M^ol4IWN-rBquV;Zmm{QQaGE}}YboDY!=Q8ZXGTg>8{JFB5S7ikE
z$_e?(iPX!9oy$oR%gGzdDdx&4uga<JRXpUYc%)uI=UhRbSn;H>;_2M`3g)W{mV1?K
ze3cyPm0Zr1+=-REjg|a!l>%3lkb6}^d{rXqRbtLn5{Xq(ja4t_s${RK<nC1~@Kr0S
zS1UPJtK4(5E34L+tJb=z*1lJx%U7eXUh_BS3a#!D{5baj{Z>~=jp6{bOZ#$I2XKkW
z0?le1wQFu8$HvwHMKd!Y839EjgGI|<LS~LRtn1u>FD|cf>e+FcdvRF!a7w@C(6KS@
z`odv7STr(|-BlOAeC#&z<zJGE|M8*zwXXocTxcYqptQ6$PwYESG<wU@JA8i^=WH_H
zTdvoIMfi~WP~unX`i}x&S}`nwp9R1<z`2KU_u$Vs=U;UeKhHh>#9aPVu?A#00p}jS
zt5~Zv`Y})Q!{}l8vtq4ep%MC%x%@DCpy5%ztSi$=M@OgEdI}e6$G{~3k&XiSNBCGb
zO-rQV5O?1&+6NS2RL2_=mV9pZq~z4b6M1^2Z<+}zR&m20E2orAm+vhZ8oy9lCWGkq
zMKQHv4mX+UcB4wYin$5oF04oAc9;(@6k2-S379}LO4e{bJJxJ{a4idJwBFfTd;7+M
z<=W(ECU#)yRkW)hVzS<l(hXhc^Afc4gME_u!F%OpPs!(4npQP9utZpmKjwdLo@RSh
zRtyuTO+peAh>J$&?4yymjjsLA&(p;H8XNrmGRFn-<y1CUJi6qpTTPw4T-^HP2K;fh
zy(-b5YU^_G=xgeaS64ZebGYO+IhFLeB;+`i^f=`;-3GsQ06(SNzBv17VlXFl_Upg)
ze}+Fk-M{J;0G7E2BC!8>nG?mnP08^W%Un0+&Hww$92zRU76n{L2ooD0L{J71Y{UDp
z%<;i~EptSFf0>K<(=sRam&+W=uVoJX-<CPTfRNuUa{~X>We($?Ugoypz%n=U+cI|x
z{pY|C=oRqG1{{9<5Msaz1*kB<T+3CzTDgJ@2A&^{55~wMSDKK><G~{&msn!uk8fBF
z9z8~`jDH<X<PvLIL?SC!j{jAEW&ikG|EsRRKQN&D5MsX@Z2s9B{^!AF$;ux>>_^w_
zk6w*`UWiq5Q^A&6Q7B0j!<IoH6ntXrC~fUhy-GA(0&R(D7C{tj@)wH~Tu1BP(RjL(
zgY_KBBiJ}sc5>&ItC(&Wi7CN%PnOXmP`+^nseCn>g%_V<P*5G~tbwRRmXpu9x0gp#
zXPKv|z_8KgWbvhaTi&*9v^cvfvEgQZg#)xgx9-L3+KV&MF+AH+jVAl^bI<<P5a%QF
zskP^^OEBIW;u_`!81RG-1*&5I++efzZv{U>Ak-fV5ePViPeAnrRv}?wVc;Yk@bNo1
zICy$`{;&Ey{Nuy^FTVo7LWK4om2UrY3(@Q&$dA(PpF6_4rtT%$9X|?wfP%w6?FcJC
zt3OJ&f9?n;@2CB={{Pw$t^fr;K*3=ht8PmOjWm$3PyrMivK#so0jKbQ^*@mEc|7~}
zMBeK{t)bbn?a4AAVL?XyXm=Jkg<q7p;yM7V|9H83&UIhcdL{8x04E%%Y2XBxbeX^Y
zWOtf@Z%NC+*|u?_8Tn#Fwxwz1tJ_$q(lZ3}Ro%owV(P1<1LupfgIlf-9=IUBgT}L$
zG|*C%sN5aDDr>;-F;$k``?IGg-SKegV_lc1u}PiDgs^mcZ}|98zbDWlRdHKT#Rl1+
zTN^&qS#(!UcBb-~rgE!}#(o>T|7JQP2$d50z=?J>FC$pO1p9&c>Q`<W+mH36S#At1
zP~EpQPvX~O*0znbBXI;I)1hxDRq29MRt<sF1t()F-KV%J6uyd+3@f3d<@uXF=3;TA
ze)K6k`YEQwvzkeQ5%rrHnj4dk(@B`~7Sl{-H>uNP1R9L&BiS4uXB|owWT$79sE~#x
z<}_r*mv7T&B_Y!kOmg!Lb5sioBn=o6V{f&q<(Fjc8$K?pL!I6&aZw^Ks35iG&I&Io
zkt)dP!abv|aOs}bj8a%E_>$|-^*A%`)A*)IAxj3iNp0I?0ci$D%s^V=N8HWKrt^)f
zndZyWT?^yym`}^zUEc&sw_WcB0j1jm*_Isy_pU8FiLUspx=06{t-2`+8?1V$b}y`Y
zAI))F_tB$4t^1!Q)>;p+ygjoX<hTd68RGtKZ!^rlRs$6L^qks^iWG9$j!A^t+m63<
zuCbkvdwXj8QE^V`<WsXwF{jyUi!UeInr=+??Rv2{)TRw`pOeg*6b{+X8MNLwo3<W7
z*e%#w1Un!XRSt$6KDmCsZ@26LmVvHFJ_tE)J4^{kSq*y5xWC%{X^vz)>MY1{;|5<m
zbyHaW)voWg>ab%qZ;R5pPN$T!Q+Hw|vZ3?1oR2T@*&OA@`c=5Ib9MRm6zjvlcxHZ+
z?zL>E#&|oY>);d;;>*fY`8jCS$gP(yr}r&Jp6~I|eSbc_82ZZUVnaB{^%B2yM4)}Y
z^;P4wea|a5`00{GInr`-#H|H+mD-ISR|6s}Q^Dj<>miZ=V+Js}-<-dLPUFXiyEEjW
zmPmyuQ`1&xT;_>?NrnA}tGz9nz~mwSii<*C`%zh$_lzSo{yVOYjJ`6T-g@er?`wq9
zw#$5xKqfSS9am=(PPtzL&qKlwH6jTN<^Gk94~e|Fx~w%1SYsoSY@y0s6t_2DY3{`m
zb&$qy-Nyy_-nmaUMMHWr$RKEX9h)U**Tv0j>A+Eua^E+Tk0T@}#F>AX6pbuFkWfK&
z8f~zv(?Mc=EZnJoV70CW`W(W=<`>KVmX5}tS4L_m^2Y8X`c`hK^XT!Y+@!ZpFzEW<
zu;oOTDB?fW^A}ayABoZJe8+5u1JODik3~Z_s5f93Y$d3Sixs9rjrK3pV>@OZcG=L%
zs?Rr4n9!Mu(&iGa8N#(^mz*3l;4bBnHHmqhu<2sJ8(%N`uI5hs!BYc%Z=P4$lM}IL
z$n|#ucJ(8am&~k)s&^1$o>9)pt+avqV6v|q*?6o+iGi##Ku6M8(VM7HF9v!tCLWm{
ztFIZv7{)M;2C0ae!_=Eh3+brQ%+YMGvXWW18Q!T$C4`LUq;=*$wrh|~F&NK{MK_`G
zc9O^-9M5wX*`bU!5zpx!%Qy9ULY7S~R$xC?@TPNzs2W$aglnu&8l91_OHHKW=2#I#
z#Prsu2H~33(PB=oUHs3u!VNW}B~LncaZc2PT0%xksnE@^Fd7Bhbw|sHMV?~ZWvmlu
zz|5iXeu_i8n>Suh6iku5XGyvX89o{+_utDiaG<4wTJ==!F%p>EJ{$c+I9i=6jNE!B
z3|2dWpSsn4ertYGJ9l*w<Jubi)^Z7~ae5d0p@;LWbx-a50cWi9$dHz8DtKY-jWTo!
zp=obXyD(#SX1DZQ6UqZ#9E^^&-qh4^x?Q{2Uaf3-fKYe2;96?>RO?!8r|PO%_jc|S
z?DM^A_`@dGG7=-s2TNAgeXd5kmR6<hmN}(S8?la{Qk*XdQm;}mQD^;KRmZI0ww~Zi
z5yIn~HVlrh{%<JAWzysHmu7EM(Dbd&H`SSe&9#H$>(*x1&)uJ&T7?Po>X+PA<$BRF
z7oK0YKKW?I^i_*?r0Si|__Fc+%33nfS26E0?RYrVPnTom?-;;?FF4-is38+%pa$91
zGeZ{4`bnSpH$Qxu8FmOUPC04X9Qrmh;)c{u!{IU#B1wqytx?Ok+icWRMCKhFGMIUT
z#8_O}DVu?IE}N#oSk@syY5dCeT;S=B`dHn^bTPYv??sK>(MIDhJ?&N%n@!ZP#3t7(
zIlb*Zm};HPPIaT(mw6|@)ZN9H;^H_hk4`4hzcVx==vi|s{)36hgy?KSWsPRp5WD$3
z`MC@X2aTp+cI&CZd0C>f*^j|8_E%#ITOq1VI$Q@apAz4lQKmF54gDYX-ZQAF{(bii
zffONz&_OAohid2@L$4}L2)zeH)JPXW1F3@2qy$g|L_k34O$0)Zh!~NkqS8S{1w{l)
zo|E76-{+it&e{9besyN{ntRr)7nzmGnq;lqpYL_u*O!#L6Ymwd4WIBxYo`+@7T;RM
z<7y;U>>IP*f3!6mQ-Jqj)Eo=dO3)8fvb3_iCRR$?eh}F2xMTb@{=AkDYkuhTurIaM
zG+#5@=yCYF3ng|7>&sUz{l>%3-##|6QQL4ZLDk%?e1B`x&LDa6(!+D*G7}%_oF7dW
zWyRI0^=>$K>QA>9#YbJZUEm+FH@72}5T5Oy6>hNi>cXWT)it;0&%O_T)6Px^9`g@O
z{AX>UHy|-+Ln`np|N6U;cZq?JD|GV4kEOJt{Q`q`vzdXonP&4#onB>MiZ(8<AL_r<
zdi=`D9k2M+Qi)`bY<3p$XUfJ*z%REu=BFDQai46Ye%s6hl-5&!Zyis)e184im!7Y2
zUwey_Xa9Nkb>RK(c4u1(Ug@8yXLfG8MoB3{$NQ&V^1JRGEo=LW2sl3VHaq%<$UlE=
zsaIP@=Kk(W^<QBYU460f&#6D3bgurIzDoXjYWMGtH&<9c19uM+BY%$t{u7bRg^lFi
z3<PZ^LkuGiL4)}0FCP|<<VOVw?MH~vf<8b}1elk_<|8B`rDUPOQm7P}t_XR$l`=g-
zB{EpCHbpHdLW353l$LS~nyQ73(CP9vGK?^ZJZ2^yah&F0Kua|d{det(>oDiPsX7m5
z7yF-1h0~*a{rYulYl~wp-rnW}in8zByT^$osjaPj{`@%(hkNtp&Bn&Y;^JakTicf}
zU%q|&#z_aMuC9Ln{{8au^5@T=r>3SJJb1v7BR4iSaxzTs+_{sKl+@SPS5#E=>eZ{}
z=H}Ja)vBth%F4=5pFVNkmP)0jrKPQ`thBbaK79D_<HwI2$54NN|Mc|qqeqVz3`SR1
zS72aZX=&;F{Cr(qT~kxj?c28}Cnq^-*%vQfq^72}w6sJ<MsmE*969a6!UAV*i<6Vn
zg$oz_{rzv<x)mH8Twh;5Ffh>B*?INq)o0J1B_}73j*fDKw;dfFb8~YQ6%{=_Ju@>i
zH*ek~kx0eG#l5|~1qB7s(a~jPW%>E}r%#_wNlEGM?&b`OdHwn|N3J_KIN09a&SWy*
zzI_`XAMfMi!_o7OjEry^J5^QHnwlCvKfk+o?|%63Aulg)ZEfx8)29gu31eepEEbC+
z@8yVmIX0-Fp&^d!H#Rob*Vp&u%a<HiczSwzVPWC<^XJ#s*BcrdIIeJx>D$uMl1`^{
z8pq3*FNcPPo;r1k6RScX5GE!jIFexsh2rY!T3%kxxsv~T`(M8ToK8gyEpFfR@7h%W
zfboB?T`j?R#C85JWRi}@{AcY-`CJv|iJ)S31}BRB)_)-rl`Gd6|AkC!5iUzLyfn*}
zRlg%ItkeGW>^T0XQ}GgTAu#^4b`_`x;BpdGKUDp1ry^QS;S~{NaE#4d3q4_3Xx37>
zGYGBI!JuysQ!)fFWrUnC3~WIjz!Db^l|LjZF5&jr<?iZ8wx%7MfC;s8KBBF<i{Jt{
z<d!OXA$Gf(<ewe}SVxN&e-MVqH*h)?NLJ7w5hAyY9Eg?V&s$+-D_;drz;S96g7tgp
z+ZJ#B_3YGi1(6R#WD#-mivt6ta2wv#4=%*f3<H~xq+pAGC^V#$VLADz2Av83;3EZw
z_(G$XMnEMOmC|_p?JF!rBo+$?r2&3O9)PRM00|<94o-)MRk>27j3zKQ4_#SAFI?A!
zQvnEt95fIlMc@pMii_Kp2WjKCEfgeOFhF7V)lC9KhK6TCtwcX?LEy~tFz8A=XBM3E
z3l{{R7CL7T6lBi;0%2VMAn<$#nj++ccHu_e_~SAr<=R%Bj^uU#Fc1>DOHi1KZteis
zXm^{$Yo{<ch)~9IF%D@ah%+UXr}033SM)GZ2rjuvIBZ0!uy$5LT3X%U%z`r(0fuNd
zrGeeVo4A1RRlp!vEGTUN=JcoBqEr;7U?UBS+_pNb7=$M`i5U_s4k6Jj0DU3h(>ZI+
za>AgnAZ;52mvBKo1c9BA>F}eb>D;_3!z>bCV$;AN%w-q@f@`eGK7<1Puq?oy3QIhK
zV!JtMLdQG?ctoJETyB2J-EE*GuQeAp#5yU*Lcl>G7j*RKtsq+w=%(vA{suuzdV}s*
z218hulw;9mx_~E&*)*gLKwk*H9R<p6=3pjM{f>?vwuheBWd*mnT7qTscRtVhT|Q&M
zeVB)fXI{n`kidN;{{h!)+}#Iph;VEU1}M|DZNV+H@Rq@b0>m$l!j(}kMkFJ4HMqr0
zP^_QS!-ob)%W#z@Zn49zQ4~b}S6QO-$(b#q8_<;01a7ZwE#_wJonDgU{m!yq5dSgF
z-##ZM&i($}wej%xmqXEL6B{Lx!k_J7v21|UW92&lz7SM@k7U2yvA?_1R&6xkd_?2l
zy@kZD9FsD!|I&}uq6_R!ALm;3udU1=#_#R1WB>fwoxAYQ-~EmM*DN@$lIIXU`*NTV
z6ogX81A$Ed5D#X6*JnFje4-p|!2JJuc7hM_cVR%9!F(D?K|IQ}gGXL(Qw%36;EBv3
z>GL^cwuW;METk3#b!1WPoht>4n4I7T0h$JE5T=hH$xX7ZVJ9j@JDD~zmRd9oUAe<O
z_M_S*JJ-W>-vhdaMpq;W2ng-2<i`Kpq#TnI1tV}w%J#N`iz)wQQtso@{g#)RqM-P%
zNx4O%aClWw@8F4B2}ds+ZI80~!1Q>;(F;2(sQF6#s~3Ljv!>3CarFE3t%%{5p&9Y&
zY0#1HbY=<@?d?4gX8gUl)2|v;dWaLn{xW}RSV6Dx$+Ppe+NF1Qs}094nd9|iN>`n0
zjC;dR`aI;AlzH4ubR?c9zZNq6&h}6+{`%zkl~IK|k9TV@kYCUJr*4*WOv<W<>rRo4
z^UDEmH>{LPCTVWFl|R~0wgz=4Z^Z20eYcCUxAQrXo3~rV)Kzix`sGy6vU{&RPQ^K*
z#Ibm4xB5<-%E?4WhuhzFYu3UdF=>v|WxS^=ZBBgrno>7iop9s+$s19c*{U;jlkhsv
zXR7A+>t-It@YM$#u19yP&bC~EG~iC0wUEg0Xn!Q46q#D@CnY%7%~6~tq^bpcubb`t
zHq&tBZ#|Y<4cjQ#(d1*M9`c}We#Ei8IV)Z@Oul~liCaf)VXwN2PQ7<oOh>EXU-if{
zs;^%RwzXA<t3<hHPR+CwR&k<8HS9yxe6u)Fq~e??QWZ`Vsd-yx-)R({n91Tqk(Q5|
zJv@H1-tP)0igYhUGj2uY?T5bBN3)+%-mSi`KF5f)zWe(HH>4KuJg@U{h1s!Whx&Iv
z$~aM^r#VriZ(biviFNGtevSTKANb~5XMgwKV}wg;i(LP7Fu<ak=|X-BARX~;_?7J#
zdG+88x30k#y=cn)`lZ8xokP;In!Z+lT(|PX3zf{9)!Z9GJX*R&=6STPcONWETy7cF
zUsuSAjh+_xZdhT$-Z2PQUkw9yGh1{ceRKU><#debc2~52RH}!6aP1y<iq|f@dw)%1
ztnF!ltrmUg@v_#<S0gy{SoZbQhIOUZ?q@5HwQu#8tQ&pmnoRi8ocCS*q|x_FrdQap
zNkEOw*5z)N!@IRSfoE$5I<J}3E4%sf8fVnpA5D2D=vJpWY@XPtdRf+YsMgB=rt8gQ
zrE2pZK0h0x0;?a*2w&1`P?Y=RZB;efQT^#&>}N&4??(WA>+wyoX3@T4muJT)@h!f+
z(Wec5Pd`_RZ?iHxcgpMX%em3G4z=EM4vD{CyvN0L37CDcEb?V-uwx$`JpN+Z`DXHK
zS?uE_)35q-zR!M|$M!vW{1yH4&C`G0#W0#pw^hab#vxZ@28$o#6$~CT`Nd*}ubN(z
z_A(t4>%2G`@%W;6;^Pq+uZv9fDbpCiBGX~zpZIZu$1$+Z$Aia;@DnnovEVt=0Rsd4
zB;;`{;OFE1<8v2SUrpkEiJJA<C0>}C>xtXd?|pnq?80=vN&FX2vmUR`^RqQQ@tX;~
z-GN@`=d(=`mJ7|gB7UBGo!FDG(9zp*q3GN~ph@EFtXX@a!MS&KJ&CNn-qx#g(Tm4S
zlEy{NTd0ZA%VIrA!}@(q*<#VF{}^BD^E7WP>O8yt_0gxm%!uzXpxywJuLlpJ9_<<_
zntgmFm)zOW*H{<W>l1Lt^EJ2rUW;Ak=ckW;4=kJi3^g;`R(|!nN%VbFzf524&Bi}&
zI{gQ=SIl?49&CQN@NM6J<Vwgr_JzOL*#6&bZ1epK8tk1<KKtvPy1!oDIpf*dpSKp#
zzt?Jfb#(Oj-ye-pY?;efzkfYm_m8soUxO=L^B$mi|4%=!G{+JgMhJ@q1YV{d+}=aT
zFaRN*_TDY+_`S6C_%w0D)6)BC-*gF!V`(Pg=^sSW<>t>S%%`G~+>bE>RJ+m%v+1*9
zL>)5ms~%C;FjC(z)p*~{0u^XFPo#K~Y?;Z&p{Z6~ZYQvT_H<HfC+XQwl5#kCUxe&d
zd)cEl1#9RQ*cIs0MIP9=5(Z7jB~j!JDN&I^!PpRg!;}k~ft*ZIT`lTSGL_4dnt&2Y
zPIA3!AH)eH#fwlGVl=i8nFi6Pkv3DW&(oHE(sJyt<QZPuD54bBk_zb87&uyY4Gj*;
z;O)3pjLN{QUu%iTIBc6ySet<$XVh<GAVxE8qB4QunL@UiIke2b!<nMhnKw2we=1y;
z0ADBBUzY%7)>5xa;;yGMuW$3*kXgT;fV%N1?1miW+AX^1{3ed08g_nhV^tyRV)gZV
zc3G*otTJkr?7gi1(X6*T*}CglgSOejxa?6%HnTc=d^CGvJ$n+I!&1tbvdx*s<;+rY
z=BsmFkLE0_=ez^wE-K|N+vcv~a@Q%jo7K4=M{~E<bH9M|ww3a}+2-xy^7bfs`_*~B
zM)Urx=dr=;n*imTK)ahf5jVlqo6wq@ykj?E8#m#Qe1vkopk2OjM7}6BU%V#&$XLGQ
zM!qzp0I6IcXIG#QQJ_REK-CnejuohH6lg*U(aMF|c7?hTh5FP&!<s_lu|m_0LUTwF
zM!Cq+uE;u~$d+1UUsL2bR^+@<bP_^$QKq}u(LEyQo>V%vhVC;)_uHTcK#GHui$m;+
z!y<}t)Z)mR;;6CW=#Ap@kP^IdNsL`dTtrC%wIr#gBzdePWuxQ@q?Djsnr>H0iYTQ}
zOKCNw8Dpi_H%hZ0w{nzk<=NfJkGNGxy+yCNRWf$#mfekWsO&j~+q2fU71wT6P;cL5
zLvBY!-e#@de$G=isZf?PdOO0tOy%C~hc#tQ5oKYtvN4`JoQI;zXjyy2oz9IiU;8_^
zD0d!j-07>i<Ho$B0V*GjC}%2{JJ^>$q?EtfD1TE^Zp$q1vaYzXcVlt?48rm1(Wt9}
zuZf~jPO`tkWgLm}N1T*Zaf*-9Rem{Y_~6u3(~tSMOVwS~8^5acD@`W@XOxj<lI(c=
z5ss5&`gHEDfOyqCQq}#4D&E>EgM_;P=sh5_>gz_;?XY`^w)eg%-vcx6K@F>{Kc@I(
zTn%_l2>(Uk#FD-+sAeZt3vX77(yOB!Q-^hH{Fv1|(3+#QHBzXWgpaf<ziM*DYqQfG
zuaSIei?FG*kCc?;^cyAV)JL_qX*G)bwdlzE+T!;!Gw#h%?;CC2H>tf(8^51iU7Po)
zy3(h%$}y!}mGr=obYHc$Ue%%1I4u8TdgDh@H!r#QS4}&wL;n$v&SYXwGI^wg+#6Lh
zP!buRTvr=aH|awg;w6poQf5>sPmF7x`k24rz4~&TG?(o7-?V0yoL){nj57^^iz7Ru
za@ySg_1^A(pW%OBf&ZUg0Vo8(1(k#%|IfLCaDciQ;1Ix=EB9Yy_uqT;|NG<rp~YYC
zslMU3vGEf#i!qzi13sa>XYkz#Nu5_xJBVrBR7%fvT2EHy<D9JCn>oD&d3{AU`{@OY
zlA?iI^ugQ3gJmT{<)uRvw}<ZC9;m(5UtikWP}2L5lagNC^MKxczo?_8u%V*h?yZ8-
zlAHNAIpnIOq=ZA^I2e$_**MUTgT*-Xj{^)jMDhOp`y4dKp@kf#$ANgQZ5*h^VRD@v
zot<s%-A!$M4b8)KjZdrVr>gJIS5?2edv~p(Vyo=-?%m40n(94{k*=d-x1;lGN7qKj
zqjz0BGd+D{ef<nh^$hg4jr2D%`yM{&eZcH(7<*hl+Fdu=eSf5@cDS=<xT9vIjZ?ME
zmWGLz#^-G<td6#q-R;wl+F$mxvwGW~_jf!W=zKoZ%^H66VuVvYQzO08!;HC+fw?C`
z^G}B6o(#{7kFmy|OpHH$Ht}?F;wkId`1JE9bF8s>7W37MCkw3cch4u@vnJk7KYcqr
z{$`drKmX+A>#^qxBjay}neT?imPeTDV^2Oj8UOV3+2={t7HjJB)XT3gr@zn6{g`|8
zWA@e8>DOy>uiw9Z^Y+#2H}kJv&CS1>o15q0&FSfxm($ZPXQrp-r>EY|OfAk$ExmfV
z{CZ~f_59kx{QAP1^>>S_ON%Q@?^l=JudlpY-FUyY`EF(F{qonvm7V3)?<;HHSJ%I-
zfBd-dX><M4hyUz9e%Ro!*N>c_=uiLF7AF*%vwi;h<;(Wh|5h9{{C{uTU%u{q`Lgr*
z%lEC%Kej&q-1>a*dF%I=FTcNh{q=SG;Oox**Y7{R?tb6?w{~`SzyH|fBt`#c|DXD?
z`(tl+Z|}#?pFj40?(OgI?H}y@<kWu-esZF&e;pkB{>7<ZzkmJy^M`|=|7RNq*-342
zkX?{P8c)0-_J1Td|BuQ^ullkr2ifI~WEAJ`HLe}M%=o`_nEy|e6Y6=c^3BOX*~svx
z`0G=tTK^)u|B{<4PE{%YqpR`c+Z%e)2hkU$FKY@V!u|hCZth<hIFP3>%MI0P(Fhdr
ziP(Jjueji0iPte~Vdj6t1(%w+#}uU|e(@!(_u<}e>V<Y@2lQTDD*0PKw-x6S`{2T8
zsPK85arlnkX#EMDfUR)`k-O7AdYXUod6k*R-rAd@pofG9C4H*b>o>mn&1jD~3N+yv
zST<LEI7-r5Yal<B_z*>xvw0wz>b_g|sxFqV^tNj?vq0PQ?~I_cAyd7|UN*3;lBQkX
zB?wd7Au0T~_y)1`$`Qw>11ty{$J((JS0ObI$|bgifMvqF@Ju-d^Tn7{Xe|beex}|w
zF1~M6J}ANH+IG}PU}}v@MN9)1)j~<KW0r2cEljz17||~C!DH54S@gVxf>Z+S;;2Ms
zP~^Yy4b`^g6HTC)aic1j6ufPjET)mCH6|O8)SMxfK<Bz62Y(zxQ44GPW@9XH`{I~f
z@I-UEL`=#6l`ps<#8&d+M8$+<BO{1;Spi&Uf3I15f86-ycr#Fq9ljg<uH@hN2HD%f
z$`1uJd}L*kY?+^$hDD#&KO9x6-)foAS98@ay}0jU{Qi%;tLgpqh_W-Vzbm|Ee4v+i
zxj)dqKR4LfvhvYcR}afJt0J4!bAQ6VVMPo+;=9hhas8;P*(Z$1DUAoFx{H?gja>M<
zWJNZ&h7eXxq_)FcD<JJJT-<@^Pt)Hr<eJspPN~(4e;ZN5<!h-8{BHZ^Xc&tYo{&ny
zB-dzXwtWJi8LXWQ+4k)h6X=X-xw^~ye^+eO-%k&Y8!OZRS_mikTH)wD-C;+*Jyyka
z511@>8;hwvXeZt<oNJl%YV^C7_D>_JtfbYEnE0gF%UnC`cau?CBu9nM<1E$2VR@={
zSUCzJeSIQrMXa4AOObuBYawGrMh!U*!1wF6C4*{_RCL_%Pzb5H3t%N~`qCiO^qJHo
zq&tu$0G4h~df{jsH0?&?YhFBQCzGnXdrBsSXGL$G&*<Tf8ev>(O*MlQYm4SnS?Q8E
zdF3KAOW$!0A{BatYho*<=E9b`kEGqK6_Z|JCmx*iB0@t06^Mdm*5aY5DUl#?+(?Gc
z^fK&0)0kunE?YQh01=*JB^!V@HwwEE5eMKtuP>6R-L%X{-nJBn{@_1yDGe69I3yt)
zY;Lt+0Y{~fd13ns5Z$}{4>>FwCQx_Eh;f#^Ge0fShgSWS&m~Sav?8sq0*sOzZBp&0
zE4M1r;d^NUp>;NgXU1&&WY5aUv_fQ{GdZ651F-K=_QsnzdXOeLUw;zRY!U(49pQ}G
z3A5L_VxdJDwvu>OYcmVSnL-ZR2f+_P_EZNos3}B|Z&>@@ruCfXq-u%XeM&d$v?gSD
z$Zx6E>v2i2^!u$9xz<CF4nbUQa>Mdb1Q*uoS34p)oRlMaFlPL1UR_?eBD;NSNX}Ci
zRv~aAB39c!>#?YGaC6A%&rkSS=G8_vRneZ-Ce*nW<vI~PE0fuftXQxI*eWTFKbGz-
zyN%2;noieGO#-Pouk&i@hDt571>UIj4YZ!tmA_tBHzF4hd^;HMzyiD`p?16j{xye6
z&`7FET5sY79@3Tk`vRN2b+_3QuO9gf;fwZk<qO|#5}_s`(89yK;`pqh(IX?GY=HCW
zACn>vd#p%oS3Y#rN=zJJls>*nFq)}^nQvu_`2|x;xI)X@O(mrnh)nl{ti<*%tIU`x
zn0VJq*ux|XUe6czk|zcb!G@f)H9SQuNfs0pPZq-lQ_QDPa0Y%vYMo$d#$|=wy(XB!
zVCZ-<2lz}ghp3WG**3de{6kGcH)7&U&9{REnpxcF^=)2rsHnv_Ch+FTHmJ$=QfMRo
zmbCF3swZ;^7Dr<biThzFK7Nquan&qQK#?SkHI@>0!wTY^+dFlxPC^r9-GB>+it!A=
zgRxN2Ui5tvgd<_y^)<A!8zEQHh)5qV(e^2adM0sM#A_2JBqO0;iql{L`{{g>EQr}H
z3wQ=}NJ_B%gx0N$*0{R0YCkS+^Gi$kW|y;)=HaNzsn<n9_R}}cZ}Os1a?;`UT++-S
zii=3@m9V%FfgQ1|6PM~lLr_+-Zas3wIca2uJzlMi<{O%N@kCMmMcZX9h~dZmF<g3~
zdKB-f+|dIjfANS6<&U|7$-xs_rBTrZF+-H^!T96+Z|_U4uW4Q`zF@#^p^rs}%H2Ge
zh%|R+YvGn)n!g2d(&GS{VwPy58l@XT*KGPkmmRSItGOS7=noQzPm`a(OwYv;G-WE8
zHcnNT_3hY_1ARWZrdQ7fB$Z?`jC5@_omI!fD!2|WmASsTk+-yHHHPG=<Lf^svJ9vh
zd`CZF46{1dzJ2&)DGvH9H6r)hetROp;%TL3<+R(k*7<KfZle;dk(I#F`I2V2a71at
zgUEHuG6~hmU|mt(D9R<NAZTdLbomgyt@R`qNooQ3QosG&Nis<P7wU)YmmOfRmzF6d
z>DlF)=q+l8UF8E~MzYTz{?ivfW^k>fiI8TjZVWd&*{JEmhtPu0O%Fhqbv@p9oGWW%
z`zla_%lG0lW294)4Itlpm-#-4bAmkW8vpFU`8Q1L&YC#Qr`|91E?*qr-^Z>||LB`a
z?jmc00F{Q@_t%b}{v;ehYm%y~6@7rK6gpi+YZ#Hg7C8S<JFAW++=T?C`%J3|iokl)
zKEe=iZmRo_Z1ns<9}a(DNmr@u?C|Q6R;a8=7pLl!pMwRFf5(VT`Gq4{m<ao{gKc!R
z#N93!ANycvFr{K)hUoS6et7n!4;j{H-+7-cv(a8WoQu09e>(emnAPrrJx%zHY;|zB
zm1tqE`LSW$subwiSuXTTw0eMeMPaX!_6qryQv}+`P#&6^toiT~6rXIb^NuYKvl;eD
z46o!KeMmu9_`l>r8&TWNHhW*nsxd8d_P+8rR%W;UocL?4%`xE@skg(whXOsp$pE9*
zqWqx<SPH;O&DJ)cmH%~x*0Lzy-p(oi4L~~@!bHRB%e8hB;j6Au&eoc19?&HhKDSnQ
zz;|bj@4Pc(22}v4-aTk2!)ro-kMA332Xi`mB>nQ3j44W_bcQ#<1<DA5=xKY`$te!4
zDm+N=(8OSE_brXr9H@68Ss<*8JW0C-7Sp71kp<+NC!Rz>5(%)mmkL)zWHaz86g!^<
zc?hZCf-D^#5)Wy_LxQ$>|5U?bTZ}Zi3?|V$U%?mDt2mREA?!~xZm}WfG?3~`LGj$A
zD>P-!s})t60y73te6pCY1D0i$5#fyZvO&v~CSJ!H|GiNJFwQ5nDd|Vh@kiX;C-O8B
z2jivUkg32Rm=;V=n`pBODr-SylzTo4mkw%8h-d;jwOc)#;m!U@MGRdMm9-7yxiLE*
z-hzp<Nj$c-=wL1?I53xzOhFq>A)e*vJsLys-ONfE)f5VLOj$oAVkc18mIA++)&KL-
z3Ra+P>_}3=jnNQZ9~Yk2D8rHPw9IY(W(F^QDD8+4yu}m6CwM|X4BCu|hPt`M<wVtw
z^3Dz*-;beq)?8O3_@juPQc%^@Ao%Li+1DNLy)ZWXU78P?!Mh>O2Mvc#h@N~_p=J2(
zMCSI1fNiaz9BpV<)TbJIn1FPJ%{d^{NC@fzc%s&d=048w1$%qM$%*u>0PgB3#^WIm
zgYcq}KK9|rAG+XDMK81ORudPY57CMXv0!~vUIr0jO7n?%LLz?y)*~*qg1oHB+OcR@
zoC`E{QL;%MOb)`*Ko**e)BZ7r$Eu<2WQcyP!rOuLxN?Pd1h_!nX;<4LAoM~3k&@LK
z;qI+gwaEPid|_oq294lzd#PfhTbPOn*wt342l!9L2hzNfVz*5Og5u+UNHc0xR2Zm3
z>!5vkb-N##cTl-r?FmhCYMVuYdF-1=F$xBU2S>N7%vP7iR{CppcrtQIRR{^&T;P!>
z5R~<`Co2hi2(=LhqaeJ`q1w!P2lXketPxmnIx?(c?vDTN9dJo`pb{VRg>UC>wo9eX
z^_d&+w5#5ConCl3yp41cT-JcOUq0%3OmZCY8^O1S5_ndWeN?NGH%hi@8)D^>!@qO*
zkAjr&rt}F1UCGE}I>h*01mt`~8e-X~!Y!dp>8!JY3-6Phqjc99q1?Pxm+gqO2LxBt
zU2QlbIzu;lqZ|fUbCf1}R|;wel|(<-c9Ri;neIxh87h00X!q^8Tp!V5x$=R3Ae)gc
z;i@tks<N$%+`4GK?O7Q6@{CtjD8%@5K)#V;Nu+0qc=~&S307FBjd)sJu-M1J#Q&hc
zL#{Ba8&Rs{ZP<b+{(jMDk6%p8JL(MdzPIx20)?a|l-rWFYM8GqwlK!UC}S-)Hl!{&
ziFEfPpfFzXlz8ZzPJQE%m{eZD;c}243-@Lo!Ctd&#3+Y#s>rQ^z7C)cuY$%A;E?aY
zJA(WuVZJgUezh?3S&y`4hoH9m(2fJ?E)^8*r7c1!xMb6|9eo`~@V}7Q=x=BayLd@0
zNXpteC?h8%>VWr@qQiqJ@57@>nuNq#D4PRbn8u=L20F=MnirkZ6yDU7)ZKtgD^F_U
z9nldu8<t%8lYOH%uMyGApRjoBif*#PQLX+(z$>i#RbhJ~DI#7UIS?W6+t6vlCGx2O
zGJiNCecj=^TibzQ8!Wd%NXy~c=;ii&RmwUdSwEB(W`*DtXx?yWyVxq^2D3u)R5pPu
z&@}jK#17JVcsKeEg=i@sC4<$CkJa0(jXEi>{`qIL?cJL%JLC*2VHe0(pLOuADZ_bN
zoGf<px5lDAAoc!m!Q8%`Xh)oU+jgd&#T&I^1)MoeS&Xj}=BpdEUQmpBU3le>0Bo<~
z#B2iGGpa*Ko6mL|qJ!i~Kk@+99P@3Dw~<>ha1pSl<h5T7{iP)Jca{jSJ7&FaiYkJu
z{^adtw_0Xk%t9k$*h;WoV*F?+IRP1q{Q=57?W;n(?=@r65QLo`LIkZCy+?vW7I_2i
zK5|&&Rj^cQ(}@{pDg44cq#rHs_$}az=1yaYy^4rCMvWub`Tc$wcS`xXTM^uYr!U*y
z2uFw)F9fQ7W2ARlkj22sjNnE@Myj&j={d;yN^CvqaVCV6hzM33ggkm>q{I!gp9+rX
zK0e|4=<X|ECgb{KyH$=dBr}4aHdlIbStWo-yXw^lQkPXylPycME4yosG8vK1g&CC!
z>J?=9`tsisfR7{L1O@)zP4F$m5sonM8R2M32fSJqzFV$&-DY$PlQJE`|13w7z0rjJ
zgcy6~a^%if<N%?<Ji_$*yyGq->)j^e{%|FH5iPzH8N%n_w;&Mtw8z=iokv7U8l~zz
z)b#Qqcp2%;wg87R>Lz3{lhZ&75)zW5qFxJok!ziThn|=TXxs+I71UGRpb0G4tK~8D
zz&V+--F_M8+C4Du1*GXuYm|zCs3%A>IhQvOnQs;{z;>O69D{@03BIYmOMK_oPT!PV
ziEUrEDxDDM`UD8!8b^hI>7R`1(Q<<>kN2vL`8s3*F~*Zr)5{2matwHOit}wh-f9Xt
z=E8Rj51|m~vE{(ufB3`8p%?s|0+HZMw6dFPpG0TVNWFY01DIjMme;RrNbV--DTrv(
z6dVPyXfN}Pp`>sO#B$T4VMRI^?>^E)^r*#i{>V#SWK@<jwr6koGc7R-7MehA^L^fN
zBv>&9B8a0Oq*)yTasy9jMj%=WLLr<v-x-3C^8%{BCHoX-ZQnnE+$efz?Dtf1o%eZH
zf@UnrjnrL^x@|73+MKLXtR3VmriP6JgG0cYF8(CTfxL)@SF^MXCCdzkzwKv%(-Q`c
zF_pu4Bf{F{MdxITrCwK=sRwMqUH~uf4Z+vTVZ>XSKY5P*KrnY1uRmJwe_A~H18{T;
zpxG2WI*uO`KGItL;$GxdvNYsKW%C<B-lN644uYyB&)H+geh0zV@kigY?nUk#t{ND<
z9uME2%G$}%Y?M0l4}yQ@+u^mTBM7eS!Jo{vq+<`g-h3jA-TREV?I-E6*U{etq$K8k
zj@N!=3psH1ie2n&Z{pR!Ll0s37S5yvBH))cl}%9w0L7D8MdO({z)S%6*^cC(TE(U-
zG!uY|%hB+?srSL<WX2-U$Qpw1a&w5$N-c*41wG(@8_=Whm=Ln^SrL_hu@1mPKM<s;
z3kdY3Q_C+NDIetisL?e%1CCuB{&_phb`fyI&Hce5CSnm-w+*DO0q(z46n+5Aq?yJp
zo{j|)_CH;p6})f3nQ1Ts`H?_Ht)4zFz?ZrRVxOx5E?<JE<^bPfz2~i{ZbMLexy`5F
zK_vMG{gcW<W)_J6Re86SAjAvRMPTOku=Y3kFAE4%s8_^Tzu<k+1$&cK_ZJ=kYlkl~
z(ifHZU>{+X*Bb$ks3Q=qDHAEB8Raai(3k*C^z{cW*MA-jT0H_TokTcKTLGpaYM6la
zdl2=?Yng+*VcVc&2K2sVFa=`*cY*rEL0*5+tC+$wzJZdEPrvYh%hmEoQ!z<^N1-`z
z3t=#g4Js0cFTO_X<plnYzpXa3T(+;GIP6&=7(B!L2-kYe`+i$|d4x4p?tSLHc<@`1
zo%Tm3vOJ<9-~z{DJq1Kx3-k=MU8!P6gn!z8I`u@*-Q77%CR>=#nmack3i@H)HYMoX
zGMDa>?D^+aP!!#Rj0Csi;WJCT8$q296QSlj)|RnwDgpL7H#$aM8rF<DIrN>cLhC}<
z&Cf@B4!DpH5qwedQm<W=b}u@k?x^o<8DP65<E9is1YtVbg(Dwh<5<i1nZ^|pYqTI=
zz@WdMo63i4aty}vMg(Me@xmQT8QNEpLyXjWcln-tc!bL}A0Byc9SCIo<P<k-ryG$P
zq^R-j_>Um$gh1a=>E1{T1K9oETcY%Kx^)DAuUQWDQe{1G@ja7!sBq=`<1@oc^}{&K
zrPz_U()1bgIOP-68NZDf7j{1C^m`a8%%5!w$*&0{En7di1FVkmNC^RJ%)|}pwbTXT
z8obz>fwHhW?5(Q;0b78}9`03KmGI`aaGpN6e7oAm7X9ItBTJV7ON4-4+>)fEbywpn
zqvWmG&!LGqZ_P;}8lDQ+ugfEz?TC`!dtZ_0%RA!aOtG^oj)fZjeIyC@b>|YX%)<i9
z4Ex*&vpWtw*!rB?J{bhPv$*FLW}eLx+pZmTo)%%_o5P`NYvq;4+5=ST+Tr48&mH)z
z_U^OO8nM)z2M^je-*h(D4|jjdo3wa*`k}S4OGhOAg=f%+s(-}pr-3Bg_~wV#(KAMn
ze;yC}gySY9>meUd>^GgF^h(?b#XDAK(eLO%_tHcXZs?28PeMjemBif-1~!e$?936z
zGbffuZpheui7Cu=^=0q>xwI1~VHJ~~>sn=hp-X3gF`f54<CM&fr$5(9Yy0UtJ_(~Q
zjbd>xEYJ+kf{PZm9K|}LPq!x&u03cdFZ#JK#0K8Gd@v|&PRS)+_gXK%n@yCix|?G@
z5mRnpGka7XW+Z99!MDHelBQ#9>P|T>w%WyA{KYc=ZXXVCa|ot2%4`%h9(75B1>wF|
z>O(y616f<lT2S^oM`2YXm71!S@f#g<*?iYF)TnZ~rW;QqdJ{Qx9mHoO4-48w+=Y3L
z>kfl#m*22I7MOUVS42cYRPOQ<CHLi|f+k#6vyS=5PK$`=cb~{I(sr_F#7?4HThLo*
zYnZm*cBQC@X$(O`3x1lX!jrLRWolP&e=AFCG6_U+b&6;39YdTZow8x=rnh4F>&7y5
z9y7l11^q(aEx?FW=uRHz231c84>Hx^HlYp{xl0YJ9ljUB(={Jm7>mDe4T;*Zl#iJU
z@AOaXKe1jEhRX##I;NH$d8{Ckmns1F&rmE&8|)USh-b?_Neg0I*A{vT!<B=J2M>*=
z1^d0~s3iJ2K1sWwRk=}_#`}nQ3pefmL^2lfi&7A0dBp%%9Qw$C=FP61dzxwdTf;ES
zlP&St)Mn88Q)A=oL4&9#L943JNBjVHEI(xFuEdz|p`l}pAoS|};5zB(aKV0B&BwQ4
z+<XtP!%@}CMC>JyORr>P^@o9|rDWgBc^PZ<SW#EXr#mXG%2~ob>SvFQA?wNN@DXVB
z+CA?>5g&*lABJuXOjd-751qYMBjF`1v0gtAVQaR&Mtijk35n~d)j{!HL=KCHdRJwc
z_zg5J?xjSx6rz2)tzgEczieSzeg_SmUidpEtgp6L?`4}9>UMGhm}|3{zdY|ZmBk}k
zRB!7L1U?LzG_0(6k;H}N8F%|~N=J!(zrg(WKK)^3?XR2UNq9EX9Bv20Fh>H-*uMZ2
zLlluS0PD8eM39E*b}*bM==xEYsi}S~gwJZz?bH_z`XL<x&%0Smt_RV!wjc77EMaAy
zOF(lN$~3WrJAC#cMO1wdL@_*_0OvtjiD!xktqQ4qfe<Z5WKTTAirxc;XP*LDsX;Cl
z{!YFNIYvrTqjXK;C-7jS29)Rce!8p&vo5wk)+cy=?!Ma$)!a-?DzMq^j&N=RkwoOj
zL5X5FJ;63r43G-iO2)IT?y!EI|I(3)&MqC(;);6dSNET&s;}CgOmHLa#9;nIujZHP
zC1kxF+~6(Eg!bVuRH%dTN&Ormil;#I8r4E_9gyL@D)T-`LcNGR1&iJN7P3_i84!#a
z_wVCTxM~5_@Yc?WXN9JSYS|et3*@E!2~Bx*9cMNrAc#L%CHIdw)Qq5FeyZc8oL(tN
zz}DOGTWXr7twn~KsI2j^{TpYWEe;vykLtSUZSf67`UHu4=34P^i>uL&25ntq`RuM;
zYRB84CoGP4%^dcqHzduBH?ckzbDt;hQkP)4db#C0M>qB@&8oCZaEr}yAt)ZT{8?C&
zAr9T>I;_XP4AQ!lCZNH@qIqAam~V4crrM{u^<pH#F}hNjsA0Fj9iYCnf>f`>knGd|
zZ`Grh4RGwF3ZaSU%leK?YbC}vwT>xC)H*cm&+P0Pupghu%Z7hE%W{m$t$FuY1f1H1
z^p;Z)78@S)^E_ZF&B;>Dg*!Mj+vZ@>&TRAC1AfJ*5w&eJI6N9G{*Q4UpKwLLNxp?d
z?<H0U-$#OF0|6elNPN=)B+C6*YHvj4$|aQ+zgJy>#V$TL{m8NMop5?fD)Y1V+iUkQ
z+l!EXyjsv^P_b6Q8Q7S%6))mo1jk}gmhX>9A_QwZJ}kK{LAkZ3-ZWhSPO0BMn5dfA
z_P0`ZaUBn8OnMiE@+8PghG0hjIu?w?ZBxmRkIoIkvS18_i(l;*Sb}m>$qE)Jk{~WE
zu5AMj<>DUjRmqj~3#MhjxN}O9K}c^dBHL!(>*DmUL7Aa)nAmQxFN~L4{tF&#+JJpD
zMXu`HE*~yZ@Ai+p<y)ZZErgPJHGaeSTS5Eda7`zJfXZ7o+AVLwwToU&tkxBysN2Q@
z8O{QOrm_DqWEH88aa93Gy*%2GJ-UU&_%_gH(=^gj=!jFfxTSCF*=#wH*DtcmVhd%>
z&N$wb$Zuh2ntgK3ygqGpWG^RN$NmieC0(l{Jh@;S{m+EdT5j1@LmO*Vv$H-zHMnY)
zrGU1ECbnh>+Jdq{WVrBZM5c)kB7i7BGf1{PgwNJq?;0T}!*#w~xDsKl-L(jFF}yqb
z9-Qb@sFNx22T6L7OA(mQ&2ncO9u~2*x8uiH$jNWrg;wud@ShCk)?^ajwF1Zjw*+`J
z2_bKOuq?F)d-0Ue5B%mqYFiiqXgoB;$OoM+z($fb#0R))p-INKmbg74hv(YqWCU>F
zqQ^D{QEdns3fGKvc)qZ1P&9S#)dG&RWvTK7(PpCl;_xl8x0@pOB~;jGlK<8FM+>oo
z3NZpdPWs7-(Kkt&2^ZrYzE4>&FCS2E!*E*w$VZ*=V<IsxuBl-|4|y?oW`D|F^NV}?
zh3{**Xop6|@rh-p+vUR|2?GfZXbZuDq|2HLvYR~y(hGWtDXZD=OHaJ6EcNG*xzP_c
z$|7L0Guw~XY-BcE#o57pzR*Dpo?spqL#dB9Yi*TdDl(mh*}S*se{IHJT@RsO0qgsA
zqb9Nv+5^)LIc<^@rn3&ku~L6N--yw|mw%H6q>1;_ZM4|Z`~J=$hv<fEkwU_s5v%uq
z{Hy;Q%v``tP`@oKCp(z^@y|WO@lqw{LT(vo-|)s(NjK5Rsc7)@H}O#uXfpkHnmr~n
z2!f?Q$Yl0s+CwaU_hT`P%p_<)1}M}8LyDxB=ICXjDe1w7E)gVdyrQPs^SD$%!pk85
zzkWKZ_c(*gV$n2n6YN;~sQoEu=MAX4M+b=_yVAKV=F_CRiZ8_i;tfH;2ufcmIK&X-
zhNQ&O*`OOVs+<$?G?ZdSAfIM(do=+}H!V4?S8Kzx!?pBedn>O<0dEG!GC&Gq5L26}
zDm-NOF7k0CSw4Tz+Yp37b{=O~nqtYiFp4#RfwL!RH9$<6+(MY4!!(dJlNjVeoShdV
zKOq{R(~d0=gD^bS1dw$k*zFGifudv45UjYBvo%zRK{P{YKghHw+UyP7=RP{|u(gNM
zsne%e&f{E5b?yQtcIjXMq%bHD0_8E~>!4oll3=B;A;}t>W-jwU4RH{r9Gq>$1+gcc
z#&h!%$ku4CSVWp2i(twmn$2@xvgg*fCz+usx-LXhdy?Qh0nQ|5unj@(Nni~CNCr*T
zNV2uqPLs&#^oFL#x^(y&(vsuI2nNBri-5Nu!$%UW@peft3fzTwnrVGD1SV8VHM1w_
z6F_=cqA86mm^3E91aMA`i{v&H=bEs$!=kyu>0|m$0Bo(|M$gEN9CKL&`Qw{zdt=(F
zFVG=}^tIG@*cTY4K*m5x5lk+3GzdALE{OtWAj#4Q9_c17jZH4;eWC=O(j-JZLqD!(
zn5K_RLm;@yIQ9~IqPK?w0)G?>a2A{=nr;$w0bKe>i?+G}>3uHQuF*ywk~DyXq=Tq`
zxbbwbS1e$_nTLO#sEg+E%CT{480+@~vH9^tGX}vJX6LEKrH3b4W4R9lxb)_^FYW^L
z5oy*KyHLQSF5rYWX@rR8LNJI#7gKK2@dEq)m88)dT@x1%frX%ug6qZBto{tb*m|_W
zL@dR7-e^De&_Vq*usX^MI#8Gd4JD9A@-gd=kCQN`NG_)!Xvjq@HF<uR=pvCx1MP=l
zybPhCSn8io&vEnCptsZ=R~M4YaA6SDl<*w<0P{8M+LQ^|6@Odn>3~$enGDb187Rpu
zhZ125x^-sIJj2S{g{6-`SueI>31b(wEsdjx<(_iu%TbT-gE%*i^E_mUeeMthPcX_=
zP8TE^PsRm7ya+FR=xjUAD#77-;@LbmFMA#@>`^S9I}|~6^03apyM;Dci|BF*m0PRz
zDp}j}7^{z5Y$I6XU*fu4^)NI|4?edA?r@hUn!;3KB=IoQ(yPe^mZ~hj4{~9pAGL-C
z@{Fz=9St!Z4f7kt%yUVi(~$rZ_ibBGccOj{NRLK_qfa9Y(-0WD7~M2%Ejg}@CQApq
zZ<k8~KyFF)GW%RdTx@Y|)boFA!;xHq_B?L!+-17dQw!Ys3}R?JccwE@9}6ll<!W!T
zx84VsVrH=W)?S1$GkZ@g(vdvytYCOJOmQxLo+xBECxD&R!;)8F6g>=2fuEfq(;*a{
zMq;BKtq<S(AViXwPp@8p*5*6b`2p*P9UoK;9ATwJeByGaJw0&ZfxCcVc;avhk)J_;
z8FHC+J=Luh_a-T7K+`cy0~tEm6`FoSE&Vvl@nJr;dzTJp5=<Fb#5}=zlVBD(bDbA_
zdxV>H9R!P{@EfM-q0^o(aNi)14>Jg6<x~9g-iXCn4(1mux4M3U$AG~NgFdm|e{HY{
zSk-+^L^vBXO~JQ0AJ3<+0kjxBe9`~p)wi^bXtB5lZ6Ae?_Pj+t{_%#9DmGDCv=iq@
zLZ1rQ1Rn?)R}Rs_0FVTGN}N47{z?C#s(x?!slrWA(zd}!_(Fw{-wQP}wmVJP&W0wr
zJK)d+-f0Cl^njh`!6A=rL-y0c0Hou9bQ&UEhLPsR8amFjazl_M&}7qm%J~NB$tFq^
zoiuaqtzy#KleD*-Vd*bMy8Whsh>tdHpLm?{fQH}iwm<VI1*LcNq`M)ou8UmqbS}+u
z+VNU0WRMwg*jC<<iWIj$H{Je*?|p!H;0`FTK__tcu-R5`chzt^e9b5m@c8~4^003@
zv@f0a3%NrcBxwlBCp(j%q*x^IXwt;l=%*n}E(^RfX1lBH6M2Lfbf`Lr@4N|5mMOzV
z>g*=yh<X2>8pU7!6y3#-1TZGiFol>?Lc^F0C?q_|tvHgs>~rLf4}ttcxIqPX4Y$b1
zgtCCC&oej4oJEuX<npJPrD9aC+x($vGg{5%x96E;=S{LB3pD@6BG`jB-q6ye$<hMA
z6M=ONP;K!L9`T`p!Vy-cNy9$$6GzBo(H&3MI5PS{ExO93z>jPsW#j#HD9n)Tjsj!o
z6r#Az@zd7YZDEOiuYKl;$J5Aq`(SH42+QOSMUJKhy^AX6No0@$nkY`2WM=^GV>{_2
z7O1ozzOKGfyxHrHhwGV}B<46WICr&Apayr7HLFo#(kMX(h(wZQHm6U;0}2+nOD2f0
za_Ws}?mw^*&fQJVh3JEifYZoPhbg*j+M9dNh<b~&nSk`;+a4}}^yG3dMjUhx!}CZt
z%?B}}3+2LYkD211ApAhs@(5C-zr!Z!pBb`ZSJ36!NB&)lPC+J8aexsgoNuYQ#!{Zv
z<;B`ReI2pXPPO$s>8!?-r>^B`NSCL@_pm}tZUIA*?t_!2NSg%Q8#APH$2rejU9P-1
zg3~AwUONl7=gCBaq*&>gd8*7}dKeviv7Bbc0>tS;yn=iWqtkQ=W7YsJYb>$8keBn*
zXl;TN_oa)zqn<~Z4)ySC+dRJixc6}%FvkAOYSU6d?eq-*NS02)H5~dJ4SrR1Em=29
z-;fJ|(ZIf?StHWcTA*ynghLG`TdPRFWY^Fl=rU1!nTT30FkBYW6<5TC0B>AV#<in5
zmZu)JNemZH<3gSBp@xN_#vR5c0fVORR?OKec<3rZeAUu?)jA;TSlp@$Dck{U<y9MI
zbkE(IPI1QI-buH;D<#j$QjX7ax#PzpvT%-cTy6($#5X!Z0d#&3hp*;3^>_5*L%Uep
zh<Mz_rPPh2vW;Xm<?>`i_UcBe4K!crf}N8iKd{0b$s9`kaDSMmxcZDz(+48s%n{a^
zvaI=Qx9!VCqbfB|RO)gb#vkvU_kH9^tQmE`U;XhyQ`D^H7PPUg%$^crPZ>(R_N#+7
zdL?=}Cwjb$edy`>4%ul-i5f#%T)GssSW<huXnvs(35fxKCavpTvSNBlEiTF3Q+*FT
z$D#x*@;EUmdUH@Wgk^#d*cD1rFr_W)fr1Um-T)qp#n5p)AQ%P2nL|PVJm;Lj@h*dC
zgGcYUN$qZJGJUk@a-ixw*|8=)fZ-UPVt51zk{3@8dYSp>1XYrmCIJP?Z*sXIcmzN6
ztf9c^Z-U&KAVav_N~dwoP;0GLs7ezFMN4<Iqcy;IgyEzki)l!NlM4!%z)W*r<hrQ`
z)WH1k-cR$!JSF_)mI9=E&!@@a!P3YT--s^dJJ&X+)9F35KZg~OfVjEIG}-xdA{)`O
zqx2I$WQrEj(K!x(`4+kbq-Jh@%Ro{JnElD~;LDrfM9e;SU!vVhmN!->zz(YG6|0~4
zU2)46D@1u`0>RL~W41$OHo55M21|3v8U&_$4#k}ioynvqFOpQ7NUG(Wy5vL$p|2*{
zKeaJ+`kYZ7=QI{~f?v`9)9%`Qdf;OEskwCD^1U{m9%%$6EXXWfINg_?2th(D@I3Gr
zJSURURg!?pbYN=@DNg)nnL%rnb(?+BZsvA;kk}q^v)3eZzT*$~-}8ZzO=&oFC-)@g
z83cAr7bwZ(3MvNU_l;EO>8kW}2Yd?iJxK%W*70?xd`|lkI-Q+9mg1=M^ZDG;-W$^l
zJ2;zoEty3+XGrs3<ayEGJ*B4auagRC+Sj`f>%@Y_Z`y{?!DeFCOScEZ5bsKNIx-h|
zPHcitut16B>B;jvCz;?A80u~6U!SL=F(wAGcC?EAT}OjoA(&)077z&l$r;+)1qR7)
z_6Pp;xZFi@SOlLa2X1@?t1OaLYUA4b+1^g$RBoD7XPH3$`XX|W1i6RJ5G3=8kVdW>
zB4)Vla=dNr&mHK5@~LR(W#q&*om$Yn1Ti`@r5nzxjOtN6kw!n4sX{hR{I>PsyE3cX
zk}9YXwTqgnaug7Zj>4<3&KO)-)m42C)vERBjQPy|_(KhQuRqKv$EM*!YfbQ6%ehZ`
z8Vg;vb`l>9SBu=clYf5u{OM<-wR~j?i(VjxULMX6)A7W@s0de|E<=-reeLy$l7Y$-
zJqJ3QtV*GAIW@k<wX)Z`18+W@zr%g<OF}}uuCMH)v%f#Sid}r@W>B_@5pY^ZzPj^b
zyy$nqJrJu9*?CJbwz@;PAi9V7xuxy?o)Rj*#r0y5lTf2$H^Qg8Q0-;AQ+KlWnU<%#
z)lOeD<6o1re3ifZPd$@)GOfd7;v+mHNj&_>hL_)O0y(TM2#k4qa+{$$qUnJRxh6bt
zA}x#C10PZ;Tw)!UBhu}h=cHJqYw<)gAG;Hh$^PSiF;K`E8*F1>BdLIeZx|*i<oSwx
zhaj%*0(i8_|7h`1Ov3GKgxyo@M}%KFYe@@x*vpOxmpaF|7&tpmSqphJJ;5nE#{naR
zj?ca#rJM*0AsNFXEwTjol#Ean4)LCAoFz7GJ|rC4VpEapcx1Zbrcbg8@t%>3vsR?+
z$CsK5TdhwL$_??(rsgMfGA%zejlVogA2&Yh?Q<)gh%6Ian^bs}vw=xtJTzX@9lQl(
zs$V6<@TxG=@)~s9rL9joz4EKfOzO_Ld06?KcjYtnmn`G+M1)f5*(i%kMNfraLq7mi
zJ_2N6_C5eEUV-XpEdgY8<PK4wHAj%iwkXB6Jf-_p4h1WE?8@0_mR7m*cZ+0qC?IM~
zFL_$@;11O8Y*z{m8;J&23D`-`m<Sr(rMWdJD&l@B79xxovdV_uk6U93l<q~ky8T7a
z1cZg+PkWlG-S9p$IWc%~%wJLdyz9sLo0CRAZoO1C*{i)dd0tg2Zc?Y|Z`&zjrQ(*4
zQ|GR(`JwLq0sN>jJ#+WOv9~d24~^`JcZ~F!gx{4uR<i4M>R9VDK@!PkAM>K`c#1IT
za5<0LxQrjbjThyVp69H+dP{DirDh^%T-`|Ecio!@%Hf(QpG{-oOCE7h*Ja3Uw;`Ed
z($<HOcXx5uGT;`nAQ6RG9U?0KtOeT@t^=_6#;5`ef)F~;sUcXRgn&KrDq?m>W|fC)
zEB*f<>CD5S{Qmzx`)(Fy#$Yg(>@t>Qt(mc_7(%u*BZMTCN>YunuZ=9(su^TSX%r=?
zW^5q|sZ^>Vl_XJkt9<nHy?+1Pf85t~pL1XLxz9PT^E{99e1TsT-ud=jF|BzZUa?2u
zV5#o&Y$-4<USRh;6I^k!+cC|}5r`81PFV#U!Kw|@@PEx%_@bVa?VM>`9i5K_5mJ>Y
zBDl@?W&NF^6!x@)SVu2@LjLlQq}FqwN@?69+Z1)BvJ1hx24D5B@48Z?qvTn!*Xsng
zMI=mdM7(}{Xy*mT)VZpy&i%bQ=?UGh<Mu1sX!IIIc*#%CiO&q3A`^I&qS&w$MX%CS
zOYE&Hd&8#WU-dcaBm&ic4?niNKLgP*YfklupOP;f|G0%dlJ}nlS3Y^Vdei&NtPsw6
zm9}jei*&F0a!e8eW&AqT7F&zlA#^~`3SdseF{f8$JJ1e#>EuXSX8ZRr^#hfxZmb#d
zkA;S!pSZgcrLU#@I&xPr?J<eUdEx>2wW}zOVLa)t9`rI}m!B0v4{#(WMW}_Ul;KG}
z7HNq_gTU#pFNm}fq^mVe%Srj_TRJ)O9KnIOJM^lDTJP1pajbJ?3C}m{96_EY9^G{~
zyKwVo3tgoxOyPFr`ZMKaY#pB|)OXQmi$C#r*ZhW^ph0J%g%?uKr>bgcx-&MLtQX(@
zEG@SADlzZEj@Tq8{1a4Kb)Vbl%d+@dOVx|D*~#Vg8k>CH=T0%j34#XTr*)MNRtS4O
z6L)M4tg%zh-G0K03LmT9Na#4rtgJ53v~$2a1E6+iIvZmq1~dN-cUrHLt>8&oxKo)<
zYSEMFzTKUWSbT<|4IszghbPw<=b-r~5N$_o)%C6KOdcnom>g0go<F31nUL9+`a<`8
zLxd&g7smB_)5&Q^2*+HIyhSDjAB^i!_7JA~M{-Csgo`m-kn!rM5WI<}LnD65^m*#2
zfTi>4FW-!ph0YPH*~2CgUbzFE20NB1Bg|1L^wjiut=kk(<W~`JOFgqixecJXS(a^|
zDv_gcQX-!|fe}iDWV{p7DiM4>>E%aHIyH9x!E2<8<Z#lurZB^g(yC8$B|e&&n=}g3
z=)LN*Sof2j<~}R6NnPur67MXqWzBhK;=5Fr$DQpNT+3^LFC_3gFVu;4Xs<Q?J?2Qa
z&Omwl0Iw5<vg<RL2u!x8fpDkBn++cla_zJ`bzch|NrK=sTpC^@XN#$u1~J=s@DO^d
zRa#CmOKoue;HkQ{SB-YVuyCFP*k~nH8^D0}v}u6Fr6n}#A~H%XOuew4uTU#E;J!2U
zTxZ%XY|j0(-9uBvyL~@BEeG-lmjpxrm_`0_Cj+Cc365>!!E_$L6~csa2m2&8^)_;G
z30hU~27XCj>g=wGDlhmw6QSF+4>!i>S7X+j;fhpi8R&6hn)M~8@PtIA;|VEhUtQt$
z9Ryrr_x^4MVfILUNzrkL7RAFc+HOu`D&$<RbsY^Pe%?w-Sg6V_=}X(JC-sJF=TNGH
z$Tta9SeHR5;r%L0t5eK3@#zA-XF&C0Co}i+ItdRMQ0w%?tdm0D8?~X0L6gcDyEaW+
zEFxVc6!<0(e`-p~PEmmc<#5_S5XE{Y#EZqa*nKe8PWjBX)?2vDxG8y)Noas7{ibp5
z51dEtXA9gY!qbY6;j$k;3>yBycL5O#c#h<BLY6B}3+c8BK5*)bEu42}R7o!x7CZ@b
z3=@)dBM((@z23^V0ST?D>(Ud<`}$hr4zG;%Vb&5BQZ8vG>P<!=%5wdOjtQ#Z8e`JN
zVQw^B777KKI4JckK!YR_vfZkq{4LJ1YnT*x*A--N0gnvbdAB{NE%wA+bk6M{07P#F
zfUsjPdS(b895P8pt_YLmwOQcS$YqNJ&bRv}5ihHNPy=4)2VrXUpsRF?b%Y3dK;epM
z@6By16<Rr=VWvu^8QG~>u9{(1G~$UpeHOX56%Os*{`bb;spFsiD?T;>zz<O_>46Ha
zXZ-t1?&<^SC9%k~44YgK4e!uYIot?j>Jw9F+9@;vAGpn7;6~-&dwKW#pYccDJfHx%
z0zLu5)Q2$NtapG7Xi}{ukT#}EtCaPHC^ear;MOE^9ofqOK6Z_Puk6Gx@s@TuzT3<B
z#=+=gq>Q8w-jxo{kxU$fCAXnxZ^SXd7q$E^y@(2tH`;MUPD=E~n=bJ5c{n@~2>r^C
z10?GMt}GzAZii%n5Rm?wqdg_L01xeFTv=*WSMkfOtxQ*mPP4;&@E{g|1y_EPoMvZI
z$=@}eSv^*d1Y$Hr-t}GBCEk6~8}(HFEvn<c|Lp@{W$Hv3P)F9)-~dsUnK%l6kEQG=
zNTHST&DjvWZWXOiRBCA_W{pvY2-+hN(N-mxI6U}*5L`+_U8AAfIi?aJW>mJ`I0nY8
zFur1#W{_n4%uaF)P_Yu%FX(E0p;^npJd;vQj;84YfHc8*EFhogEh0r+ei5bN6vw?K
zlPKncuroYdq~o@7584{w_ZUxqP-A@!WED8Ld<IG#&`>pSieCWGO0VE6KQKMq)meE5
zQlZuum*l5a9{4H^?=a8QCrt4^C(9}_ZFsM1l{dnHP}xbYc~R7@ty{(a2NVM2g+NW2
zxgO28tkV$GX%fRUTLaMq4$#YCJ&Znmd^)$N+OMXoD6-oakn4=dHm#MR?#R%+GR#XE
zGqM{uS51b1aO5s9ROCJCeq@)kIJ{<$7>pa|(UQ7d5$j!;o&9(p5h+w;X9KWL)WD^J
z<kqAcEk>K;;UPeqYa&|Hr>ol2eu!PZtKHO>lOClk+#CSMiE#TIsK$!uajlIk(eboO
zp<AV>-wN}#pb+g##}`svbh>@MJKFbwZHW$Ml_}79N16?QEE@8d;M>imjB9IZ`bDq=
z;NvyKw={_LsvzoTs(x@lJXIq&5t`dys-HPj<#^>5^$EKKLnDIOm%)5$w+V!A5tqLq
zp&gqh)3m`f@t6B~L)Uz&ED}Z?E5S5`!}>dQTs)V?<IC6XGh3+f)P$I>CDY@E4BCq<
zi1j<Lz(Qi6StURH0{<K;Wrw?4+xpJZD0v6>SZS(V_=yueB~H>^#FXV!Pz@<rp8_m}
z4m_}Xh7)(WTJtQ)AtCY@s(}V=l}BEfz$CrE#X+dCFDDL3P2zxvXsK}wkN_DB)1Q<;
zSXi5C79_WDkZ0ttWjVm2S@a)&3Ls1~u)>c<YplI%AVMUQ+<^PL^UD#}4=W7hLCv%(
zQ)RvS^SA{bKGo5=h!qk6Q6$#duetgE<dMVhdJ6zkiAZmdM}{z6mLw}{00q8A5wFN)
zP3k`iz)^tMX^H+YfF=Xre6ID*NGLD0OqX~gkO7l0foNUpcjas_Hrn1Q`V44C$dC-{
z<AJ(#{?aUDJu2Gi1~M&TUecV<^V7Je`nr=1aTj(|BUo5#9yg$_)}szlWyPf&qCnk1
z(5*3i_c@oi$Zs`1y4$MIKAKSLwsJ5r-!|;=sW@=r&L{dwU)HnuZ27B_@;X{~1d9!{
zoa5^(G{#V{#Cu&a?S?6W8TGYJ^}d7I22S=e3BN7H!M}6R2b9T>#&ksH&OUkI^DIx9
znQy~0oG$@Oz@%xG<<3r>NRaMaCvl;3M=*b@cTCEvfXwUcooirMf~9QI&pD7wRHs8t
zUn7)d51AD@yNJF^@QlE!Kb7@8ub6ssJN#L@V!#)7O10y`cuLK%X8$b|^yQhJ+bip;
zgC1dT+rQs^e<QN07RS|o=YifeduZABi&0<RnuZe@xp^^Q&ZOJpJ*dZM70_w0SxC6?
zHAXtA<}~HKdF8=(k9r5^xXn)%zvDEFWr?*jw}Owq?=(s+_?rI7s6Kf17WHHK=;qit
zPsgT>y^Xmk#gP(_?Sswt)1D}=%)dL;1m?w(cU@WRRld8C;Q42_kzFl|<7F%X*`}tf
zC_9)#Qp|!)Y_%Qj=Ze9pDP~lNkv7P7nrTh}8(E~Vx(7UrLVuY#A8*&+^I)?zvCDXR
zV^->7cBE)6b?RDytdc-LTfR+#ye5sM*0KTEGB%z<N?70w6IM64#~PrvKGvzG&9^S)
zfs^P))6(CXj+Tt%P4Nyxf8fM$u%5M~`{m7j{zf~UUw)eh;{Zcf)Vj5(DW8);^4dVG
zw$!+Yzq5g<76yRDNghK}JX0N1hQXRO8#OJ!e>t8So5+gqBRVGA#(&&8O5cY!)}y}q
z9`V{_2|!@HIa1K6i&?~m0kyT0wZfPtJdmqus$nS)7AaA-NKs}iG6(Zm+90FpVmOr#
z?e2tE@<!r-JJW7#5~tdCbZbi>%qC+c#eGYtG@JO#9y<?u62W+3tR~yU8jvhp>(+PG
z{&C`G2<@hk?M?csfR8-v?`^V01a8sj9y*b7cKERIGt_!V?YORk?!P}K07Wf>Req;j
ziq^!maU{@YI>tmmuyjoA>|MYp9;@-6GhzpP2Bl$t#ZePO<X8Emvn=fznO+R@;VeJP
zr_=Hx!V(iQ%>PwWx+uJA>UI5yiel4xf`c|@(bo3Ti!&faVaj)Q=lHEi;=-<xIJ50f
zP{t}y{cqidg(>esT59YLw>>qChi!Jn?Kz$eYI_jwA6_tbdC51xhz0;!Pc^Y-VvV|5
zu!I}58PyNW&5J*8dHfKB861wpF7FiSke~AZE3oiZp-lE(*}Q#O&$J2VvBmcXek4Tk
z#G80OhXChut=Bi*_ODjB+f=(-y*s)k-J?4@2D9F??Ydl}kFUqY<p>{L8Y9%;tgnCg
z;}h|ZPx`PDa$QbUx+GrD01F*9^!jsyj+?coitNhvnrHOzS)0jSVOb!%sJ<=7`!Z5p
z1B&~y;#k?&U3F#NtmB>9Ys^1%x5FMMBJnp?5spWV71_aVB{6OnliW}_$g<LY<`Q9h
zYgV+O@QFk@#@y9kS0qQu(|;a%^l)#$-$VE;R0HO5Lyfzqoi3{lmG$Cy{M#RLh)(s1
zp6u4~rlo<KkSFSx9c>i!t<(dz_0TPjmiyCAM*7cji0Q@L0I%yi?sx3ym<x8D*zwSg
z{b+56M8H4z@np=7eRFJQk!tzlcsIvXjQ)D=&i-IW=NLzqBu7{A;1QD>Dd&5SIy^sv
zOB=@TvbQ^#by8(_b?Y7z=*hp`haav+Kz7>gfcxqG@E|{Fo>RYVg>GqC-oYR=tig3>
zI(K|r-B+`pP#JmNM5~u<^>7CLXf?;zhG$QqZK0+Py$sHney(@`oM3w@2*AQaI!9_-
zJ(tS*;}ZsWZLWe;H(}~{rR$C&*Ihf4b=VGzRo0x!wrtO|qp%(?^q+nB_Nx8aM)cOZ
zD{VF{|HYB(#t{b$`;S+fI7@h-Cc&}?<m)-uj6Npv7IDULr<^Gz#~jjG-RLp*aHaN}
zlTCYJ@A`M9L{!LXAh_xm2R7h$Le{C#$>mre&dBW#gdaGRxUc@6(@aCfe~?YsWLj=?
z!{z8}O|y`vfQn<a<UY^}<*pv&3fugC5Z%USY*=nn`@JVU)&CjS7pAz~JuQL^noyb+
zVmCifbiZL6`*6qn!(XTIW1BvIzMl!R6VYz|)U?}(F8=en>)B^JYqlnYVE((;RPoKW
zN5TEZ+sy}^=ci-W3hM8bT>Q1Bw&57%?v)Wcumjb8cP+BRc4@_G(8NWeokEyC-0~{v
zLXFnT$%Ua`YkhF$gdXB4`hQ0|>_!i!cj@{sHMJg;^alNd*afE$1038o6Ig8yTQQG)
zj*N`Lo$9pAP1jgvORXp3GEVZ=GZF+Dr-T`a^&^|aBb(Tr+AXd+ab5O{tgZ2#=F5B)
zE=xBUe3s}Mn&mwXcCwj$G7*`)60?$?V40bT$SOr-*Jm1ycyA7t%8z9kFLu83Wa;<=
z?OHNs{vos;pbK^;O?^wf{qLBCSO1|xm)M-S*p#fp7yHYsB=*h7^Br#HPy4sfrJLHa
zDmwZ%r4C-1i~P15Revtcwx!QgFPrCk@R#ksk$va(_pP~Z#K0)N`HbW03kNeE*ps)*
zGog#}U-x!#tH)fItz^!^Cq=96(IMEBMdV%kohe)Az;+2>h5#In@!No5aiecjFdChS
z&C1S2E;tQlxNya3tZltuzsq@bW;)UO!nCW_?Fd5Ir@4R~QQECh-+KDJEz6g&Lw_9R
zis;_SeV1lW4Fu5GTLHVkpjjgAk}v{Uxd=bdedh8*S#-^OiEi+0i{;PHFLrBrn%Jo(
z{r9!d<c`@kjYVG*bSw8tx;5+gNy;_PfD3l~qMnzw`vg?4oTaaxX8x!6HwN}&y>2+3
z*4yJ;6LY>%?(|F5)U>*nmwnY)dOINBn$33CjwKsdSDZNX_U>WuY%{bkKgjsX18P|w
zs(5ct!_v`{_)M|!wuqRKQ43-|)gfUp(B|8;x8_y;TIm*pzI!Rt5bNwOfLAx1x!3Zd
zrU95HlZZJhvtL!1_02&X{2%QL+K41=G(5qTUv8A7A&>wI7Ni81ZA>Up=|ZNqe2`J@
zbg5@HL$A~#x_>_eGr<8D*ad$TrdTjCdm#SuN?e>mbV2xeg%#KCVmzJxSs0ot&Y(^R
zc6#@3asp{*G7?rN6=kU^Zm1nqnN@A+16o(%yU+e<P*ZCWq@mULrB{n)MyZ+^n%Tn|
z0$Tl1;pHevbH)RbA8r2zc@R0BLmB{d6*vz>);tXITL>%BV1Jz~#5A~tj=CoHPZnV0
zCM<GX*vy_n$pyw#iE6i-W{%NWMi1gR7Ue7lmnUcxJlWg`hge2?fguW^$$dbD!PnJb
zy!^VUl!RNUpDn3LsL$??YPhjtDGR=Jr-tD=LKaCc`2Vmxjem|HGCPh-)He5(IpySz
z=IwbO6<(G`DY_u~`DXX@Nd4u2xt*}eycM?$t>f#Zwc4qqmyrX>S|F%jYG&E1sT|Xx
zHc{ccDxY%3#rpt}kx59UYGos%>#OqJqZ?{3XS)lOc3Nj%-Nyh<E5%kP))I3q<jcYe
z@7crgTt{Sg+3uv7$@7fFQMVG~A+CG*Zhk3@lXq|a&B2Lyg*4)&jp(^l^X%)%3|fg9
zR5080B=-J1<M%v#k%a__!dmE4C12Zi?aon)aP0*yjUAKCwVb2y-x{Bt<P){lTUJlQ
zR9Y62)74VldJ*gvfKz7Bo%+YJn_ixKm-8wi;h7%>uvxC~bUi+$s7L$xPKy^|zec_#
z%0xxfou|f<)dBs?jO`~Ve1vM7K%vg|m(K*^O-||6Q_Qo&m2j;%G4rs=F8#yhGl{Ff
zHEP7j>E-_>JyqYzj6PegXM&K^>;L=x-<|hiVWwBdpE|3Q^D-Wt;MT>&r*NJu_HACW
zsECPS1#T#wN81V{nG@e=E0Vr#Ag|o@JV9!Ub-#WK&+>qFmy$0k%Qo^t-VQ+u>NPDx
z$3lwU75P!VlE>fFZVL5??3BM>579kw#6d4|inc6q+-$=|9-7uv*j2jTy`g?)>4j)1
zl+HkP@>>e@!vs|4K_^QiZq}ygP=$FtO~Qx>dK}QDu$ZvRtc}gGpI_8!FMEy4mZm8I
zI@4$x9wt?^G=0Pog%X)#Nj)uX?@kTHb~<)bgBYprdO=|~!&S$|G)rf?6IB!^(K9bV
z8s?6o8e>=r*W(10@1|%onJnG&)kuS#BDI+X?ISt`dHSx&*+D$`6=kNj7Jz^LY5Zqq
z<q}+d6-GQ)>ZGxqMTHYHtQ1-t?Q1xdt{z;)3SQ^t^9pHPcdmlhaCde5;(!jN8F{g^
z&hSTns(Y{$^{W1ph0bT5Y3xx{MP``XyMPUKlrOw5gRCpgh#)Qr9|LZm{_Ip?y*(!S
ziF}1*mu^VETr`qpIUD-Q`s^@0w<$hVIsEGmuJZ1JHBYj-im)~NV$GR^E|q^)2)iWZ
zY`UhS8fnZ`YGszU9kN90rdRG1B{mn9PT?HzwEsmb6ov?!FBIV$>|#Y*s`2_t&uQs&
z52;UTTb*J=nX}f>$*dqB2cwLm&x}Kc5us~Rwe3$bZB7h>11L_qkMODbVH(8pEz8ts
zRJS$z<?So|`w?@cY3|kKucN=h@Z}XfyE1lH#s-HLbo8ZzSGcLhJWV`{CV#g@kV2(D
zSJSHQW%lxNtT~$u@Av~Z4>HnCEIP^emLZh&F)oVD<Hva#2Og}r4c)xPxDyn21<cS;
zWhY_7`3E--jB<UR=5KZLkWVAGNiM{^{_O7Wt!;y6p=xA2__<OhEl~_M(~nV~Ds_HD
z74uC8lRfv<JKHHY^G%X86j9iebCO|1?HVg_J1u>Kt%d$6(Zz4Ef|g}7J6v9*z^dwj
zxQG?F7Q-_!koK4y?Hr=y`Q&P&!+gvv7xF8qyWNfhKNJB(oT7+A%`I;osx-|Bh2Vo!
zZtU_<UBP5-aSWByzvT>(F9_&f)%rUQv#YAgZ*hhUtiN%FoUi=+)~Xs&qnCD^o8kKg
zVXW6lyD%cCwWzh0i|!OCzqr1hz9oN6M7izy*a*Tz9St*9>emaPyjVmgjMSjU+TNS5
z<6j2kzCeU;;G~=U(kw#!o?gBD)MON%s)U%l{q5@0sTw!%Jj3H?(QWEyi^tZ_l0D*U
zY&{cScID#_0ekBxEHnN>A!9~(1knsNS7oQ^`bbqjF)N}2z6EMY{O<5*aGT3?sC(+G
zu}_v2xU=FkHGs7C=;fz#eFr{lk3SFlfc~)hFl^gW!!w&*-Mb<CmeJ*t40v6sR6kJ&
zrj5_jX8S-%suHBWkH+Jlt6<w{G~&-2#YcZ$bXv5~@(hT?-p`i5U85%+9h>}26xBZ!
z+)O%JwpF{oM|`UAqR+a|dD?L;cV9zS%AJCYvYZCfE5An^IwQP!AUI!g>d+sQg#=Y1
zK1VkSC8_KWwYWn(pJ!y91Z&Aed>@(k1EpOkn2DeJ9p&}6YwX&I?8fjz2VL);c47Yy
z%v_Ux6_Sw0&?g07P#W#eZ_FRRtzt7z?z*4sGLcBGvwW;{pYmLZPm8^D@9FXRV<MHk
zUp-Eq9C4|k%#gd=-+rGKu&waRVtV?P+}dODt6hPJBa7*bP=)FQ1H=4~Z{L>=f8%<d
zW^sb>h^8Zp*1V)Yep?^CKKX9MbGxSgO~3Q!Iv%ZgUHL25eD*)-;aTkujqm1R{W&M8
zXP39{{(6^^miE8*g!Q89SJs~n+PbwaEENoP!U0YH{{5|6IxBg2hqmk<x(=WNcg+0V
z#!?-11ZvRF_C5<)@^niW;@9NX&rX7vohrj~TI-WM#Aj9P0p)8_f}=odR#ach44&gE
zcW~8ZQWXfFhUo;(NdIYeQeyF~to@prd{vH!T%`$Wbox4<hA_Zuw-}_yvPy2{>&H&w
z+@(<$Sf>+d_(*5eKVi*vkYNkoumfbIEF$nkgf{~UF+k%nzVXDAf{e9!rgQVQNwQvz
z;x?et8i)=_p<}?N#1vC1*bL7ld2qn)U@{+w<4n?GyEpVae<Kc#twmX(k?~v{*_2$f
zKAGtH6j40A-oim-Yph%Ht-2emic+lCIU|=f;**5Lvm9771MSL1XX_wB2*e}_@s8}3
ze4YJ!t!<yHx6OB9|I|PS;*<f?G)OlS17Q+VnTS-lUmD{Uhh;F$G7EFCnRZ}J(~6S8
zp};+UQn@!Yf``O$Lg?&FBl}4qRH4fR$I+3u1z%;?Cr2!F1pH&5WzSwXPPx;vP|BUe
zcpCAjZ0V&AoX>;tIB^MpE>^BanvDFv8;Nnro@)>`B#n*f!K6209*DfuHhFKp>b-f>
zZp%&be&GyFrio*k&rYbXPnvIVc<8uP&PGCFaB!|PNP?N1S*QQ{C<7w63Xbi8Ebt(X
z0RPlYk7q^Gs|CF!ae;Gn2PICyF)6`RY4Gq>t;BB2K<wvhW^U0<l%|0-$57}EmI`Ht
zmOaaNWhvT7fhROJzth;fwTkC0)`-tnp!V^10wvjTPlhgZ6y>{S%M9$R)W#!GLZPC?
zWUc|TP){mvrdKdlZ+5I+{^%raVp9HuhC&3QXkrpIF`3;bl5auqEvwQmL@L@0sKx0O
z<aenaoisnjeKI9g;E5EXbpI!Be(k3R`i=~DnTw8L%)5rF2!)kKOa&{hyqOzHD66#O
z%G(TFY)M9GdtAhZ$|rJ*UG){Hv@NPKc^fIJeR5s7lxBg0k5d6^shO4a8-qo1mQ8fU
z2Dx~ZaS?HYFerq|G!V|o@NHtNaCZQdON@C&WVtL`hHeotri{3S^^8kG4oXv>QAbm$
zlF1{YZPl-4heRpriI6Rk$P>Vl>oOFp0a@#^dMC?jOh4}pGNbQnrF*=*2ap&e!q_nl
zo}@4jT;JrEX?&o1`+taA*Q!2I8Ak;^y%e!~v(J7VHkoSf)}o_LJEnr|6x}LPFK#Mt
z8zZX3g=KP;hX?fA7l^JJO6_djO0HIVy@~}>aUvNt%T=(_P_Y22ZfoB8%H#)tiw0eA
zdkQ<W&Lg%+Y?BIH0Zi5lI461?jgNhzwwWv6#=Q8aMWu$PXjg<<8DYP8#=OfTz8KSr
za3LlF;G^A$*aCn?D=b^)`sdptY-pwhw;-u6(|wCdy}a+gAMSPG%CRzdTdwxtsQ(KS
z<2_ZrDxm)fmjhj<cKWg&P<+>Cu|d*et)D}PM6Dscc&$}Wc-Qg08IX5(Xzoq3!COGU
z*R3I2KmoYV!0#_Y3g;9T(gNN1;7_;I#x<0#fg0jBgchlaGha<FR4aSdqfdn0KBc;n
zObr!J)^qJ^rD`mZ5{Kze<*3Rwl$ejSgyAq%079iojrFo&#rNyli~WEVTDe%~GXDOp
z%~9DReNfK$D8zm}f`JEpn-e%6u&h#^6A~zshRQ(24zBV5NU?+8l+=i!yadh(D6;|v
z6)4}wWy&@xmJ$R&Vl0qIm6F3ayVWKM9b8Jf266&Oyv0F%1mZSUzg#J3K|)#KZCT*p
zjA#U^SAb?goW3c<h@kKvLuu)bnn5F5y1d?7yTckpI`2SIMIZvb4&T{<t_0y-r4Pp=
z$Ul35YPv@g0mOFbeL!*vRYFLdM9<+59ui^paIg=Bm_P}^Zjv1{Nt*&9n+o7m?!7RY
zJUPspu8oF;!7tDb-DapJa5nDyc1*@vckAK#axZzRnc=D@ATH5Nwf{JfH%HbX?@iUd
zm=b0e^%fUtk{umFUqGJmP<yc!!g~isUIXu~VLNwv3BGa^fZ!iU2<bZZ3Wn(Yctt0I
z{g8(l;9w;Zg#jMaPeMRk#~cDCJeH_*cfoIQyvH?FjC%-2B?Q+`hYA5CflzVo#BKo~
zJy~%xB9-U?)ZhRi_+<TGGXKm?YDJ@jeGq*Grheg7{VQhv_|Bf}7a@zjwH+d#Z9q42
zSbe$c<IzohmyhqOOW4<wpcS3pAAKkM#qscOK($+woQqoAef9F~%&mkeW%7nC6*J{J
zC}pWM^v>tuxf;^r)w4w&c<&iSXKDF#Yq*xVjR{v_Y3#xE!pfrc8F_hR-ihQ)YG!r<
z&?4xU^0>L85m&vwPd<^U;!%KV(@^nOvKXm1f8Cd7_F8@_GJm$OoTXs|S33K1=pn$Z
zd?&Yn0J6ENVAdd$&z><OMHf&93T+HZ(;F^Oc`7;@ivIEP6UXdrHMSg=7Wp+8L?By_
za#4cU@;c0m3H=wTfYQ{gQZs3(pdtQZ=*5pN0Q1LN!+^xI%u=Ug@|%57#ArujDe&xZ
zhgVT9=ZZzdD8&<#@R-Tsuy}c$NmR%fYGeJvn3Z4ox>*&V3Yev3rYP3XP&!g!r<>yz
zrifTxsb)~66HV-PJ~vZ#uG7EQb(S_NMa+sQJlU7^h&KlZ+SXQ2Y0qCpoO^>Po+n;2
z2sxB8H_@Ws$IMT?J&<n${55YK_C43_nU}_L_}LNQKniuf?b_}aOT#%q8Rbh&aKCWU
z@p~Ng8hOOo<m-9j+5;&yf%()_M$T7d!1wl>H@Ec9_2fc-uGPcD%@+NcazicUA%qI%
z;l~gCZ#4h?(OgjUqcrE8^4}n16}NxwlS{3)pLvV3CO@|XwkY{D{}X<tE4Jn>pQud!
z5%{)MuJ}hLaM`2cj{WI7$M3tlRe(HIC@WIxLs3?_lxkN+icZ$*)Sx)8sPlkN*EK8#
zHB?_R)jaN~&1g^)*;?f)8Z*+fr-ODJ;G#Vy*Z+qRXqQXzR0%$If%Hds?-7$ioFoNK
z;zOnQXr|H(P0b%j!B#2F0V%UVN*oD(kcZ2D3;eTT$Rxsd2r<(f%Gf5Xw*=oQAr)~+
z<&z|$28EbR@|z^RWD=sK8y$o~1X7}<_)c!eJ=h&)#$Bz@o@XK)eu@+##QAff-Auxu
z3^OA^2TResWUL<-<3ro9WW&rbC^Hh^Lz=2YNDc<pJz@|z5;TW4fa~nq$0d-Zm`)z%
zGk`KJLH_{^928-SL=S&+D04gvPjsI<5lXkU84c3@xuRZV`}i4$)G0&H%Qi}uK9XTR
z3-Q4WLZ6U?T?h5~@<zHQ(U?gzZ<6$o3hTAQbPI8*SD(r;3B*bCXBnxg^8fa6|45*G
zDYjEcl1T8~94YI^(7n&MRT)Zv2~uyM)~w2_I?q>WsvzjweQAl7sTFOHl1ZZ!_z_KV
z+bylBWJ1UUaEhr^E+U_`S9A2czhz22c#@l<@xNISKJ)hY1E=O37vxjJ8?Wv^s7S`P
z*i(5T5>ZMGOeV4ID61UR=*dURe`zZsQi!x`#~Nv963-LidMk0|Qc^URf{}K8J588P
zCIw47lewg5Db+uj6fGhNxT>>BSUgDW#k)|>X<`l&pA8_6zUlo-Q<KohvwyMc*Cwzu
z`|+<rva8n1BNIS>;OIdqHd^%XBZEp6K5SgW4oIL90A-GYnP*TQ(x^i;irs|lw+v4P
zQkED>(IQ-2(!de%z@D=qt3!K@aw)MIO6l#-{#Cx;myGcSJV#Gr0+}yUq|j9!rjvmU
zNycHT$U_W*p9B*q#Z1Yt4`omHF@HQ|5I)PEK9YUo0w^on$O8;Qw-DpUBxGKG>&tul
zg~qo_`flp{>eM@6(wWrJWUOW;$<a^gA?HoNl|a`Z<0w1Lk~2~V&5o_1?b3H1ckaU*
z|Mx~klRPv@rFH)9`m6p>Lv2(_ofRp~YN$O-{_`>U?*nxWnBBUjKsrPSZC4exf16ZE
zx9u2zGyx15C*3FJ3Qb#W-oI0!Cu>kIJR}FM^#C<5mzhmcDR!%Jy%$-Hfjw?qz1+rg
zFwz6%+L@q6-!6<bee8OfMz~?fgTSS$FE9DGE(}jP92hCJrhC0H_irqg9{#{9D^&O)
z9NwnSC;imSD5$J<lS`}k)$G^C*(mWr_Ljz%H-hgc{tsn&-Cxw5oBQVHm$EkpMmr5a
zCz?E8oICbs%zGM&5l4{rDYeug&YQspIxC}k+=mQua>!R3OZ{If+JyS`WW!(h8o|jQ
z>jl4-DyY`<zIryZb}7pGyy}wm0rBfg)+;lZ6YM90-`C^!5v2&Q!(iD5>2Ism3-iTQ
ziQjr{&SCA_m%i@%htRZi-_hK9=uvOiubaNcjW>skZ1%%`OZ_;g^}n@7^|$s63<}Tr
z_6n-*M!YP``shTttSX=5ajd(rkiivurz`3wOlGTwWNJ98%XvqNsKhMoB1*Ou4<0iu
z6=y1O6HL?9bgIU)?OV!-xr$>?UH9i%zK<LZj6VLQ*i2$28`xzP{lZ--!otDDruDja
z(7_>S*B;-K_K)3-zKwf5JL?eJAAZr&#{7xVqe0D_e7m#I!EK+Dc9ZOvIm_n_m&CWv
zgFjSO@1!p#ITV1Gld2<Z{#ktaeEDCg!ZYF7re6ovFTp-V)icx2Dm=TqlC=B0^=B*g
z*KKnhik>!4#}qv5mWOY98lAC;^DxR&9-FBt{^{0m{q(JB%#}%5{}=1OZBe*=-_{ha
zgS*JKMrKcIY-SQ*-+#&3FI+O8WyY7^zJBq|ON36~xuX8P{#3qp5d*TfSb=V$_Y0>s
zCnF5)IBOl3;q5X~0CKxY>&j5g?&G?ku!E+L71PC2yYDaloZMq)(qo~ZUUG`-q25)>
zMeq>WUas`dZM4S@11+N{zIuOerpuC9)#EO+5s2xaS)Mf0P}*neV*CYS4mUIC@b)&O
zBhD-g(}}w*Y#9aAV&;vri@P+8l)muV2V~9bbK!4ejrRsTidh7kPV$%ig8c%P_Hgc!
z%t{YQ!p2<8uYPSALU&4KY4m+@D+All$i9H+`vBGZ)aeV0ol4Sf`@7(y73ps#ny-65
zQA($>)K#&V{TG#*<~|K%4D?MxvyP1!ryr?*CJLMu)WJ?s!#aj{8a9=h_8Lwti!#l~
zt%10s67-L2iFfp??;UN-9ho)wFrt+a414`DTS>Y)aC~Jbz-5r^5OY_{|3liB>+HFE
z@O^BoShE;?hB!J{yu=<KH9S@mscA^>2(6-ob&SI8IzrFo{AHaDC2Y4H^u)9xz;t@N
z2z8G~$U$@&hBjxiIwT|$y>7z}+4}XsBB@J`e?~IhJlzkmaJG@R0pSyw=u?xJFix7{
zxEIW<r4v1B2Km=1+?IlL%Y+d^GkMJjcxgB7W?Zr+c@h;q&cwC?^8WfSLi^WTPX|+T
z^2b4Bb)cJTh#OormUaG=*Szz=j*)G1G|h?YRXP6mo~S%Ka&>F+Cu&Hhmg>K@Vw1~A
zL8?)W2F}fu{*+JYDNQr)g_T&`a5Id3<9^v7O2AB>^;~8boB4$2zpTvmfGPQzqozn<
z-C1f+vs{=H-EO|toLyoFQS)%tlbQH$ILA0`?FVK}da5;KE$#;fkAMxsA1f<MeZ?qm
zrdGw|V)ggGF~l4xT94>v5e%)mLPL+VIMj4UUFWEGb^>$#^s1CB2m1lOtNg&Cnvir(
zxkjkzvmz+C_}*OI_PgFCy8&GI-PQ0t13LDi87JI+b~4Vm6aHXHL>m2@9z0x&$^L$b
zazd=4E_j8pC4vt3S-BXhO{45MrmEROJq5*)Y}+vq=4Kn15(vU<6X$KsN5eRNlU~zh
zy9kV3s@3aRV>PHAoB#8OJj)%vk?U#a#~d<@@4M_P(6Bc;1AWm%RHIvTp?@VOYufZ_
zYTx=5%0=j(;YGuoC^3YP8&yZAnCWy`GDe?5RU3+ft@M1PUkLO<73ir!o9l5+>}&f~
z4g2Wp>w2!EQPqC)R@&wlMhs5YTxZXW+<u(BQj$${F1<kTZE}^ToQWKY+=qTU9(pyX
zuCxc=P2MJk+$Mi2ym9#4-|<^kDMTK<Fi56(k&~OOCOOn}>~ECn0gOo4@N~fEF*w(F
z+sXSATf)K~Y4*~3z^U(yZ=Sk))ityabnV59Z0$#;Mzh_oXkTT8zMX`t{*qdyiWk{c
zO;vg^WhsQUj)8{R5zO-UYNe#3;gy44=<lda)LixlCeJJ9@RFrvD?8on){EkQfl#LW
z30@t8)bQ+O7h6=h<5*yDvHR6kT9?o$%{Zwz!gZ73N~YK^cIOA&#WsU?qkM9<B!oV@
z{!(k3-5cxiS16EDXxFn1Yl6%MOsc*M#l@l5Ab8|9XXo!Hx(ytnTr+MDk4^ZT2{kNA
z9@2w@xwB(eJaU&mS-%ayNc%<&%bT+~b8t#yf{LM9Xy&#Ase8`14R^0ssAEJBWq@$Z
zxac<a?HHfLJJDm{PdKl?qv7Nk|5P*3gDZYURZ30uPA(<W*+9)XYM-7i{k`4SXP_Bv
zLdC0U_s*N`+EIE=*4gUclTA<g_FT*EYcaD_#ir){Q7LTfvEiJN4|Ba?@WrY-sr*cb
z69A0Sh1L@yOjFc(p8flnGe<_7I}~epSo}}cv8LM03NcF;eJC<DI=Rv`Rk{vMij&G>
zjp1fKO{Uo#HzQ0zPujvE>;a(zwO0m8yB~TO#!XXAJqFu0w+nh;;hiC5o^Lv#0p<EL
z_mj;T#pq#8@@eSXbZe*Vmz~&Fp~H^oNhng)(b~TmG2nYPeWFMTO=Px(C3L-U>IRA3
zT2Mdj!1ry{yEV@?_Mm&k0q<ASud|NyXkbU$QffY8D4*{gdKj1asX@}pYH-pBPJwr8
zcaZa1-KpKlDtFQII`McI<xZ%o_bN~L{lUQT^SeFGh@BYC?Ojwo`SZbEHAioV4V2oV
z()}q$*kh4S4!5n2n_s74j=8ob3`%~|@lJ#$y4<I)3%{ki_S&r<mFcAX5$1MPPGXm{
zz+V>^pxXpo?4M@WvqKy7YU;=BSZ~N*_j@4oK2h!KeNgEygACHn)U2DUFr_~S36&a;
zWL%j;@RtR*r6eu!etMVc&%No}gty3S(@c#J4ua5ftU{{)Kdn>YLaQ&29koL>yM#Qf
z0Nc#o@F``4@-Xm4=+ogdo7tWb!*HAKbG{=OeIY_R47$Nn+s}xyUF7xYVpRMQTn>D(
zYU{qmz4m4S|7$(|&{=DCQL$@<nk0jU^Y-uO;*u6Ld_@5v8mW$vM*g=@$g8AnR%C;#
zq%Q#2-DHwiTbj2X(epo&UnI$;G}TX<w)JSrm#gXP2P0j-ZbG*e2gT@R9ILl~$0s`o
z!crVFPWNS4d6WOYt7G1)jI_wiP^o>O1bUvBkuj5beuf%_$SQQr@?&E1TS9uF<gYTl
zk!GC76hH>R?lG0?=io&QELJ9GgV0^zk^U}Vu?*~Uwp_j}JHQL~lZ|^W+_plOdoRW<
z$mFI0s9pfNQ=9ly0H336dTfQ>aDWy|u-_!XEFe0INBS((-P4SFO2`}3BhGVh3u3ty
zvE1DR{E7_wH!gpfo$os$H_s;hrJY}N&Hp<r_l`q)EkSM_k-JDcAF!C$hCnwnFtx6#
zj~2k^#Lyr-WUME4FB4<FunzC0A#MW@$#Lj&0Ms5Xu8x7a%`T{;VXE+mIy$(PhN%M}
zg4meO1^8_mqK1y*Ex;KY)|m_NzcS=L9y(8my(>eu39;K>Bi_@CE)OFvFMuv{@IMxi
zS7c}}eee|?<RKduz>w=&Kz7Lx^^)Q)9_oq!>b8Io2%vWsunz&qe1=@X0`i;yBNo7=
zVt5uFlK?<Bis9dcFew0?Da4%2LS#y?rU9h1dsx+BSR?!5$tbK219uvLmI~lQp%_)p
z#VlE=6p#KahLZ(|G-N)k8SN=S`!bNe9HcM9`6nCdE5qKWLw9qK<uqc4xV#|&U%1XI
zZ)`vp36byU$k%L=j|^KWM9wpy<3e<~M6QBU$r6<|@epD$RvdTnQWm_4jdPG-Z`0*Q
zCov2<IG7G*(KGYLNz6Fxwgs@c4D9TOVlGg|0Ep^1g*pxj3xITrp~<c&XZDq^0<bk5
z%wvFOt<iOKh&>%`1wbgEP;GJOJUr|L9hN5paCqo_9M}mNB4Pm)&O_gcOMopR3j`43
zKZpPsz)k=e6F?shR~Zjfxyr!#GQ<@gO1P0!6OSz5ptma{A1@%C;x-U$M3fAcH4GCA
zVcxT-g8;OS5T+Z4ufZesa4`u2*e3kO31f_oq-;GF0E*@zV1%+P0sIsmBo@GQ=+-&{
zlCK2mL5F%SKyK+1U$dcDfm|US=^;e3jvzhQ(C1P3c{Vhwy}svEdG0J=o(_F2K>G;M
zPu-w*t)X6c!OKiIRsuUnFOS04jYs00*_f|FmtiKxqZMiofW*~j1Q8(TXb>kMlqrS=
z3&2in-Jf*1DYh;l8a3~Rvd1H~NWfPG;5rF7kcMEe!5<V*RzmO=0K@^0NM@tzcxXd0
zD2xuv7lZN^poVN1M~28_Z+t<~UGc`>7gRqCzCx=R6F~kbBOeIB=V>)22I7DPL_H66
znN#A%gWMH^rv&Se00DG659KVx!X{CwGN5NWOc?+=%>%~LK$`?GWdS1J3{?d{xf>9x
z`(e}#8#-Zg1_yYW0n!iybr>Y97)9p6PmAHo98e~01GYw}3a?@Dmaq}IGl3O_G^nrm
z7TgQzDMorSkh^KnVhL2l!M~<KchfQULYGs~NN!NYfHm~KxCO?9a%`dHcxZ_PxtosM
zy>T@p_KJb0@n}k1iy947cnlxNzy=LpvCz!gPe9bfY0aO)FLNMgwaJlX5GOtI%5aGv
z5XE009g5ok`-xvUkYypX4p06$4AdQl?cstdj*@x+kfI<`T_b540O?t0llWrjUXA-L
z6{I@{Nz22q(>xMIALq=#JU@~(#KwFhZ{#S<9$U;}X=K-A3hL{#uOm1!R_B|oa$08|
zbT#I5tSUaD<aYVzirMI1nqUZ#H%h@mOGw{jdMg~<O3vm{f6|m|{%5O)vyu7B!*Z{O
z_brY;ddoXMFUw!SpO*_JwU3j)uSv^n0o+;(^&5VU2j&a2LYOG401RJ%F%Q5{zZTH+
zFLX05=ww|m=)bTTS!m`~Xqi=L(_gp^S;TTHa?UDh6Bh0KT7(4@d%G3;Wfcc1mF!b0
z*&k4HpseKJ>ypDt7mxj}jcCVainUJ<%kNJtedc;8?H+8M7lrMWmEPjPTLp;IW$-51
z?ZfhD({HHL9L(D?_yD7vb)>xEUippR<;`x`N_+*Zvf{o{ehC}d*k684siK5~ob<1F
zEk>4$(KEFEqFF$ib?HbZyyA6PmZT?s;?f7D%O4wdeAd69wlmY08O#%cx8ot$KXB+Q
zV71{2R&r$>DFnF-S566$?LzL95N{wNMvExdL>t-!&7ev<x=Jq*Z<ttZqFikrSiRMt
z26MmK{!ca2rp5_{aw)HYPu8B|!L<ayEFmmPfY6l%1}BpCQ_Gs;5K(M&6doOy4OENE
zyP4BW;Q&?GAl>1bBkeH%<hsOxy0eMvc-|~v;2zRjg3i2FUsNu4=2{)<(#Y<O0aJvm
zlprrkkUnCx&q9MJ5g&`kMAJa6cnnky9V3Kk13=oR@z-as?fvM(V>I4Dk%N^tdMSi@
z9UO$e-W7QLaW=R=5&PuL^=HaAo(JA|6^MD=e&gMr8<RFopAwtCwl{tM)3j)Fb2;(m
z@AjMjGpGR=iVGNG!f7$`zF6+Bm|)vXI^B!~3@{8qO!UTk1EYAi44&MA1JUX{I1K<g
zC4^xYF1E@xdSYE82b2JKY^nl^62O%WTio8>*%bu!RB2882Jj7PEf*ql-n8yhxwF5~
zr9v{o{rj423%&9H*|2^HuXX6n%0f$m;Tu>oLYo7+S<%c_K_3(VPYGaA;@enGTV{|}
zjv+bkZ`%>=dy>DTlAL>7(Y<`hy~`D(lMN@X8g^`*dInp(A87i1PxAeCLt@8Y(zkb{
zuMbFBc#yg<4a@5o_&cE<ob|uGSr<z&Io%&Z3NYPzL}A>keO?b>Qfxm5H#=Ma15RH5
ziMf=3fBp^d=6-g_BJQIh@rM{U%aD67L%bJ~?zQEREpra@F@HIzNy)?8Vb~^ixy5GO
zi_BMIjue(9C<qe#<zT|8xHmH!$K!K-Mfr0G+<)VbR>Zg&eC{7TVy6r|&6D^hV=KaO
zuW6qqXQtQR0kDh(^i%)x{M)&=$1sW$AA_o-d^(DIdw|8oEeD`@Y+Nm)GYHV3u5>{w
z;DT=11w(yAod8_L`H~Pjb6eP<;?}k0RH5~~Li+%@JOHLJAN?NCohLxM-7DJlyU5GB
z_#q8!5{+J5sD42!-Z@e15mOS`P|_8L4&Y(KtkEX<aH9fP<}mDa8N7KIHn0HHV55uf
zjeeNCBn#O5?$idZ3Kyc$u1{e1&OT-VD-xoSw|5~cg^xXX4W6{Vy|MV<YZbndihWPM
zpNmGy<^hF)(EDs0_d+TE)Ww(m*t|=yM*4tE|8kJ`Wpg@OD1?F^lK!b7`tgwL^>y%^
z<Qk0o<nQY%|CEFlbRjfRcn^($onLr{ha`)k<{R_&nvh^4;;}`F?(hc-&@ZnLcf?K5
zkAu49Ran|n<5@(25F5Z?Zyylb2%g#uRBuDou-t1bP^hj2#5u|PZ!*}C>#$o4(C$AM
zPu|0xjsqDQ6Vdxf1r0D24sg>jMkns#>EV;Uz<S>Wh_|q=f=&9q4VihpwW8;$V4(gl
z9a+w3m}elp=?}lF-Khlp@JmKS13-SttIgsi$PB>hf7iCkH*OzZ43a(HXNtDvfc1XE
zEd*p@6uvw9`s#zRfr0Bos2ii#pyw9Afpiox>vxUdLUQSSzo$3eucMl#+?(<kFb)S6
z54dS82IbS?p@&3a_K?-to9{Vd`GeK+70?2XI5tm=G87+`!{rOW`NLIp_{l{8=u8gq
zkPsL}LsNM0EDq@KFp$QBQ)oNW559eN3#KIm_P)J+ng-GU+^^d8#w(~I=6(luxTOb)
zFEns#0A0%jr`CYN3(dm)&nIG64&83a*`b#@ujlIqBXIBP`YInS-|~dUDmra3NAL>8
z!M4&Y+gJ^06Xe}`$LFVCKi7SBfSKa{H-IQ=P_xZc4sTaz7`?(A5?wzK7QOq5;Ffk)
z#&Vs#YktCIbNM3&%(0u~O)o(+se;gugO?2gF@3&Q)&pmBmPA;Q(Af4v?+fI3UAv}m
zX+Gu{$Z^k=L!Xp1bY7XULT_Jqs;RT|di05{`7=$$H%n1t4Zb%c-o07=R`uxYn)Q~P
z%mc%_UgUus1O0^FD=qbf5#2z&N8)0W1Meq(ADcm30+yNXcp?a89Wyufb6hdf;sKE8
zIfjAt>5&&V4}5t4;9#g-#KGSqr|Ks{d-G-h@_KBu%_|Mp)M#f<{a`>8eDKU?+k$rC
z*&fI=s)l>e0t;h4HrxWc`*y(r??5zd8LZU*tT>U|j=V_-ieK#cFYIp@Q7hYZr2YbD
z?1+n6aYZbQacA{oZ&k!1^Ril@&r!GQQ-6U1ua@<``EAq#+@J17x5pYBs>hI>?#5lj
z=RJd#g=u}4+b3&vPab7Psh{jEIyST%w)XM7dFzhn@^HOoox<S0=9-HhoBKaqh^2q6
zDcnSUknZ8Cb^QBd_MLjqXP4TzovKH*zeXTKnr3>-4HNHu&Sq`;`UwS}z1OMiw!e7U
zOgE()`}~rPsHQM@qAV=SkR4t;vd`(z(uExnz9#~1wk<UjE}fl)C`2^2zO0kaDeF-R
z-u~vQvgQ4ICxVY2zg3ud$n<-<r@J1vO5q^=p0n3M?RyY~+XF97zE=MS2+asu8Y|lE
zhI$Z&)M@I|_CF|lp!w#ER>@eu@w7vM``%NR$c3DB!vN6arp>2(LoXB`Cu>CR@C*1*
zxaY*{H-pYQYTxdqosg&=IbI&F3?G|(4LreVxLW2PZ}ymaiQg2id+O(<O}dw6ldsNP
z85c#>B^14WT+g9ey&;`QLczcK)y=zI+J2TSr*ZZ88<(=UT%FUGZk#f!RonCMNVxib
zPSoe{mtofrAwmI2R?*d$dqXcI9BbGkADfu9`;zemH)k{xkAk1~$Gd4$>{31UlN_V7
zoXY&ITxKd6jMpMKd#DUrNt@G$7Tx$L-CykcGcNr6Gi%SV^L{@gVXJ3;`c>!oN}Lh#
z{(i3=lpH<kH_17^LBI>_A1ZC5?g>5eF_jZM^1s>jMB4QCGKTB#9%C=ik<Udmi!W5N
zW0+K{0Kf8~y5!p@u4*$q*?Oiqqv5-hk|kDCqY5$|C7QTiiK5K=S9O2@gnx#249zqX
z8%|ewT}bfV#3$WYIW(!r$ERx16fj!=o^r97Y0A!mWV<k)n$1V1=^HpoD{_*`1UTU$
zI4H(M=RsArgBrddU7=eO7fnkx+bPJjo1To6ig^fmZhkxP2PBK#r5x4_Q+_GniQ~Ye
zSKNGie_m3ULzcc{a~hS$(x{URk$LrLK{3f&$KrTqF9GP*`bm&7ZJ+WuZQB;Hi1+{4
zdkd&Ix;5Xs8|iLbgF_k;T!LGykq|5iL~sc1Bsc^jjW;gAwQ&gUngmF2cTXC3f;-Ju
z@B7ZVGjrz5nYnl7es|q-U)El%RlB;YtDe>M@87fQ+5a7=<;SQ|1`)e>MJDRSs;p=x
zLZs8Cg!QJAZ9+K&oAN!-gf-w$>DA$>3bJb7oo*)gR>MW8;xY}k;HpwKLlW|2@B#$A
z2<rW#tbl2IIUsKlOF<%aCUvM6s9p5Jn3OD}1eZlo?$kaWMuagU^Av1n2$8{|B)7LB
z?T~{$MuW-o(s7w0I#s3&adzi+7_DItSjef@TPZ`D`>S4L<_<y3Fjg4iM2-Yl@SX{S
zU>ZhH-qwlomoH?+<v`EF?v;AIFa^;tY00rE0+kB(`<a0VUtH5jsPBY{X}aE{ZVy==
zA|WWXEX?xR$uZdM;yV*3DhU_4GE5G7!C9&$H=B$bOtrbgd8p<iIimJF@l%d`IkuKA
z=B>Ag!6GsHItX7j$|zQ+iOu#-WWaOvp^!U;Rd(ufl(MPSRQcCJndQ%u9%JgqQb#f^
zKg@Q{_8EtyZdP%fYXv+pnggvc7jc%MU?)uEVeTQJobkPh&nTiM3lkQ~6x0iadK|>k
zc1Q~199W(_pN`hLuq$!S+%#W^)s{YzSI`;ob|d8>B9k)IACK^5r)wv2JHTN@gM7EL
zyvgO^#>}bT(y$u4UgRTe^(Q9K`@2x-PooRenRMPHh~1Evl9{eG-OMa{6d_`Z%_MDF
zP@K9N()Y@@XmCX#qdjF_cQF!lC%OT=<dFe7@Eg@IrSI2l(wlxX)4G>}u=;{1fATlU
z$hX^fnT5%{@0(qa`S)6WlP;Ff*&!{#eWeCr37Lby%4JCE{2W9SF}G8`8<RBGmhnou
z&1pE?qJu>X;+DBL_OrS-lfo2OS_T_*@Z@OrEbaJ{B^wQGCCJJKe!SD2UgW%?)fH<u
zI;$u2@}!zIdGa|V;#Rl+-9lET=lh-Es=&x3HEwwB&Op=6LBR(~8HNStlw3Hh#9Z0!
zPX6+yY*U~+eCE_2E<|Nm0ACPB)1CWrf;d}2?%!{+`I0n87_b?Gad1fc8@hvU-euUR
z;@xKb81UQ&*Kf@_-&j4qSy7I`x@<wr7leCK=vSbQBPX=1_9^BSE|%D46(okbMe{uP
zh+0VyM=Ot&gp|&UV8R}lky<(JF4&A878r3i8idC#c)SxrV#BvRhnH#o?U%PhD<3dO
zGZe#fdx{*#wqy?X)sD{Wh~R7Cw()ChYI4=%Fe1V7t)JlQC-*vN$f#!M+%pXxfFFT^
z<r}BLrK=#ukxOga&WA+zKofk*tRa~7bwZULt^8PWPN@7d^4q1&qB*Q#MUlzu>`h!D
zyq}@L^?11F`%RV<-r`KY-q7#vPemUI^;&bR;4wCRgFZGS7DK{u0lxu84E@t|sR8hY
zp(&f;P}E(JBpHW2KI0h9Bq{aqw6%TH*f<8P?N&r%?FLL^6oB_rQSZkG?trd6!a#^e
za5#kP81CzPeQW#}$!tX~!+;p@((z?vO>UQiHY$3zelWz#$z9|zcEItCH`(07YaSck
z8I<#NN@f&Xj-6cg7u~`Bv_c0EjOF_ao5NGVV+aOQb=SA+l6eT+FFSG(5EBqJ>-AM+
zlNhlfRm5$Y0=hf0>t#@?$~j#22}H%f0jn{HHCIb0fWRH+MUC+TmRY@Cb@lz>H6Opb
z6M=UPanovRW@HI2q|spCs+<U@o3&3W7d)Eo)2MWCWo-knd<2;d&*}uv`3_HJhu>pF
zV4_T*OS6=#WI;+iL{J9iSQ_z8(62s-duA^1)hZTWr6b`LC@y58xsXscI)Z|g-n*Ev
zI7P9U*B<&nJJ}i&^UgiyaV-R~6X&Ds|Expysbs(|x&QZ4-e-ysz+zJy%>h_!mQxD2
z=0hG#`l*!qx&_iYs!=<3;Pq3s#GOVy+wrnkk4>ecbF20C(28d#XXViHwsya!+38IW
z_XcdG;H#l81#zyi;qZ4*Ku>%Cv#;v|III{Pmku&dc!1X$H55%tS&ye=$o{|qsTYBF
zhd5hj5Jvz*L-96NKfNwoCjP~DUpusvsa2W>2Fy?QO*Pr;{)yLhOkKGn@|j>IVE>80
zcs;AduMrFjS-WN^^*w<omUjZ*aLu0=8~;^{m_5mwtQ^MWiNSGHO>lhMo+0_rJ^7(<
zB!1jF57a71T!}yVBg$DYs1m1;X(PW;HZWx^A#E+`i)<k7o?v5!NVOxcpEJ?`#O|>f
z`EtOUf1(2pi`Sj`D5n(tpw9R8n-&EbSW1JR70B;CP#7ucw}=wBB)C54m|?2}CtP4U
z_NecwOYWhsy8{>F=Si6p3RoQ~CU?RId5UQ@`9K?r$<_Q}QE;<7i1L7+er*RkH-xPe
zd_5k_8jpW}kpLlo&6HbSs|D|=Od#u20P6tG4KBayrCv-E-tr<m!Y!O7CO+gyd~$Me
z<LN+ZophRYLW7EO3M7HJq##yv6-m0&D5mU7f%vKuf&T`VMU!0oyL79;1XRhMsz{X*
z0rGyf3WmdEZjJ<oXfvrc;ThbKe<i7e?gT%B`!SyQFwx-{tNN!+GhnQ6DL`IrPPlWp
zcivACxa4K)c4g}u3x83;yTy<?mk%X3^wEJetjeKqrhG_2UJxgIz#Y*o!uOqf>uus*
zmdJ-WS}hrB&>MoHPYo$;)C3OnD2+?ojpL)jFL(x=i{8%!eBcYJWJr{-;`7Lp*%x7K
zn5R#ZK?O#`qU8dsh3}(mdE3evzpe!~tP}VV2iVuD<)jBxPeL3E`^P#IS)0K!?)M|)
zsUL7hN0~-b_SDgnWAS24mEwGrR%P)VGdm?erINUpt`c;mY$l|BPbMQ$mbdqNQ3_I?
z^5N^o-8@UWn!?qFGi(NB!eo6}gVA?jJf87>&hhv%aC}FYw^b<<V24T+iM~6K%JFW9
zt5x7K5Wl|>a$9t89HY!w`|%ocx9VgxLX@u3wzul0XpOH*U6x7%livX-m4eP|x8nX<
zVOGvC!k12!#xY%X9;uc0HIg@zzuV^)gIC?h9(j9QO#Xd^+g^NKMWLej_mutNYA8UP
zuEV@roIxIzA+Jln+6Ld^9%?c`$7+rYkJI&P3qBe#4H`}M9edl$j_Rd1gHBaGni+Y-
zk9mX^`P7aj?gQLJVK`oQCAlf+?x!d|)@@<eS0;0{_aTJ^kg5ePdBUkq7^`oCF$a%L
z631gvtd7EQH(J2Vl794DkFZ=gMwXgTcv)Vurh5>p=N7MWo<D+5-PDZaP?YfKg5cP<
zKQ1zWzIS50_K5|Cm}cq8`?nuKmw{mY4x+nijZf9Qj0b#s)L@4MCdkRQ#DTo@N#{pN
zO^FO1g8sO@_t6v#P`G-OJ}EVcuX=6trK+q7tdo|#(^{~T{!wR)ZD(AF5=(Z&lgq&(
zsv#Kf)2=e6oA_OPCQmtwiU(vQ%KUB+P2g@al=mg1vMt5FG!!^u#UFBq962KQn>ih7
zr?GcCba(29@7U>#V}@f#yrV}0%WpoX5Pq&9Gg1@MU02xM;QL%@s}_pGqJl5gd=vlL
z)JU-!<cZm++*2Y=W-wjwh*GPH1V)SkiJ$9)>=yFY9SA-;rQ{c6yZMwY?hFK0eKEt#
z;>)F>>HDDFC3LW{g5Odj(|yd+3`Yt1XtHu_s<C%wruWBzM&JHphr@115-%rxKj#;Z
zUG4hZLN!0|dr`To{=CrG_e1a808?~4PH~T78t}TG$IdnY7HE>TF)pP7rCweG6QkIC
z^Cp5re=JQ*WUNknbMHTrA-|F%S8FYe%*GI=>QM;Hjn?+}!kXV65QsS-tq}oOQLGU?
zmVmk_bQ(0`vi8wmsM`*etk=;+PipLooY@%Yzc(HIxYJKht(!LwLis76pW2v}rB@A2
zw$U4---)k(LN{Is(H4HfO=<$2&~l?T5osg7_})I!nD7e5yJ)LG<BW_u46GX>$f@#w
zcV{6ge~v+Ea*n5XLAiLzy7;NP02C$QNW~y9dy{n`nLDfF@s8>%t$4Y$IfE0UyJNKX
zvcI#^tK7$}d`w<R&&>8wva+B3M*H(oN|e}s15Q|3fbo{EL4+^D*;poIUX_E^ER^!b
zHbKJhgQRa#DGO3*8)H8U`y}FX%Q6{EC!s0>F`Reg6?To~So`(D=!nci$*|@H<X@Jf
zWahLxKIZqL#Ayn0eM~B!7NnxkDS0N;dLL=Sj9weiP=BU!09I)|F<B^wEM`1eb}TMH
z6|;&6a<L1G<&{)U2|s*KEju{(7-MuDGXEy*+PzuD{8kI!lSM0nB^f8sQ*lvwr;#d^
zn(&V-dkL%t!MTHuF`AF(**UK1`WwGVwUkyL<FAdmyjV)y@Jo{GWME(3U3yH~#5uLW
zeh2fDSP|C&fiiz@ZZK)ArGsM)F-a7sr!*j~R3my>-SO#5tnIcn)t4vG0UF)!t0^E}
zr)_#?1r*X$SmFi)x!nY?q+m*(VkN{zDc{1Gdjm7Hf;h5}6<=Jn_Q$U8CZ8E|D?2`2
zqbOZXgxsEix|b=>PgyKZ`4P6*2+ciXJ)sR3wFxDy48vMJqgj)W@SC2k@$q3*>#erE
zU8Bh)sv2*m2HevvwnFs1&r0bKqgIA<Rz}#hRK}n7TSx;(ToOfJ140OjeLTAx<v{#h
zJ51Ja*~&Sddph=Gi9%?bJ8@ln|3+%e`3OxfXe2{1pk9Wt%7`(0mY}m-5H&)Outm`3
zQIv{KN<rB~8?KC52c6^)qAy={Bh+Q$@mpB^Un*wb<&Flv&oAL}rqsg_PW<1T*h{Zp
za9a+trcmuLtwzGh3IfU>pnu3PQ%-{feaeMAOYDV}ht;wEckG|~O0p0>!===P66^_m
zEqjK`DBO)VWQc<AINmD6+v!H?k$6D(^9FB_em8MJ@`E1a1CHpZ>wu@|J$W|SPhZ_V
z8?_8^hZU+r*t}F7vy@$Ya&&!M&;e)r5=fIzL2`*(jp<C*kn?FD3cB)-{^Hu?P9fH~
znl{Q%O9GOP42P~BqhLRmy`BUP$4t6M+FaQdhQ-<_DP=@FeG0xcG0vR?uvH#=mY`pt
zEal{F@SF8M60XDfzPx4K^~f9JABRA18SfM2WnomlZghX~fZboc$?=v_(|M!MAnHzq
z3ND?KPqPRFblXdmoD;MAc){7u#{6JlLW?+zp#jSmWG4_**!DacgGk+R&5`cUnQ*oG
z5WXqkc0g@YT)&<c@0V%~Ji&xiYZQ2B<+>WYj_xq2i&y;S2ud3bygVW>twnsD>PbZh
zn3qcCI^sJ-1iT}MX7)0?5!CT@XLQvHaPKH2s;sR7mJofi?@}7zvNPa55nzbmbAmx!
zEeq;}#RVO!+|ef!)6lq|(BMqQH>gwhCii;n0MRRVkDY-O$()QscR`QSHjg(Z9Sk0;
ziC>jZdng0ibON#iJkr|>lV9_7*t?$}ow$%IrXtjT?2+#EtpwHj;;(?O&67By?fnpe
ztAvRSA9pzlh97c7%jNrfI>?>b?igc8uvP=#Z|cMMCUNtqpMJ5%UGKyNkLa@(0SgCY
z4g{9|a`1zQh;ivZZEXEw*nu=*E2Coc@+ABUJbxs!^mpsUrC7al$5LDqri|z9M`Y<w
zYKc3Udnt}Vx(=mIGq1}l;%dT#79lM1O(3TxP;3kGj-`)i1lkaRoxhKT)gzz3z@^f{
zH_3aqIe9r<a(VL9=T|<<!wtsiagYh}{lY`66Mq_2?W{e96LZDh4)dp4t=A#f{Bg^U
z1c7IwjB8dZj8tn|CTEjxmiM(s+p~T%mbbM{*v*`%2pXa@e%=upc-tmQm>Umg{Ym7@
z4{v)WGR)}E>POVo1iALJEL0rWb^by({NZb!+r@guY*w8Q{d8+PcnC}xq-4V8rI1V3
z;bnI@k8WnX@%|wVwbpP^^U32N5VKY=MOHyK2q;P?@>t9I^fK<)XcReoV~s^oGO9W&
zR&Y+piZu_#SE-3lK#5){MhrwW%j3&i?-_!OTw{{N-1jg_3(HQHVr)Z|QiB|H0e9ZW
z8Y=o$`6g1?PSt8S-468=HJe==44oEWxf3Xhk(z7LTGgVn_G2MosFM1Alf2WBO5o9<
znC;%kwe7R-41UjU7fxDC;Q5P|Kh*nD+Llb<k^dmR$!D~8NzD9K76p!bGhQr(0un@l
zBD+2FbWntrzC(>Ony(BG%Rz`Q)O}q+5}{0%6G4drJSZ#r9o_jVA40DWjD^U?>6M4G
zr#Q=wT$9r`3YD$cDa8-a!DH<a#WYfPLm6ua!GMLsj(^mEn2#3&ORa+}l-Uv<4-3Q?
zsj_$_kasiCFQ)fE4O5!Dpzb%{czd!S;Y2K@d2`Cq?r>RiDEsCb<Rh~wS^*|r<^}bn
zuYKqZ<!mbVGGi4Df-zP*3@E@j<LzHO;v6xSC9twYLKy??LBTNVn~r7#sB$BoPuZzW
zc??>k95jr@@ev)Fk>zDxcBX7YU?^jj%nCtU(-Kd9Y4VO2!z;tmb_R}GZy85T)@T@{
z?51N2D@~IzHlKhE(`;O|98nsOKIqZZR?94JiT0ss)h+o<JZh{eVi)3ZOKy+PA@eIP
z;{-93{pLLK4uMJ4fWvio)Q_eE3I%%w$PL@F&-q@U7tK)4!m`g~yf^kfm)fh9b<!u8
z+!896gcAwv%hDN1%oHY9^xfW{sp!9t%Un4?bCuzz{DF8k*hfrcB$S<0EsBUEWwpF}
zK+`0pYE0K@w(2wKB-)Qmw5Qxzfw4|5>}HA{Tc=pm;(XPN)3AQcto{wjU>ZG16ITT)
z*C>@xO=q^iK(`yIwe!IuVS|liZPS5wQ}iZkm*PxPPy4>!l<VQ^>&U45N#s(YB1ZRO
zKWe$40{g>bIkN{8M8RW6A@6e_jS(G*793Q%73VzM2|QJ+AmWg$OKsfier@-in-VPK
zLvA)4Ts>v`ve{QmRq>q(=h(sb#*>AQulM*w?dQIc0q(Zndunk7+?!Md9Ul1A@p(NC
zTiXBm_3G$em{pWW#NC??fmf`8UWK>Y`50E4pt3t&U*S-EUdv`89eWzO894OzYBQO)
zpf4K}D}jn-3sr`oACI09OlGcywtj#*gUb&tD?|9S$)2WjVvf{qj^N2nV1+A8`VDyV
zxBEMSfy#PpR7tDfIc0@{o+h(hE3j<kH5LlinPH>t1b?H&8bLS-TFA}OeoRN?M4e4I
zG}u_cAx8#>D01gJC17%B1dj~%n7MKNe6{^Pj&Q_>gLzv0RUedZFU;a?I;mY5p3wvj
zkwdh}%^xVgCw#2*Xf0V5{I$*}-onutOzhVQPFq*N%@BzRS&~<3gbLe&VG&JuH+cvG
z*()PMMbMd?(n?(~aYW)<m~v?P)jLdR9BGEMazx>C#OAUhi9?cpq6JpHHpU`JQ!^YA
z4Qsuxy+xAenK-4o^B;NRt9h;Kao)Zb)#utGlDg=bduPL{e{^s^^=!ssey_9t15UIJ
zmY7S1=&ZtvK{TCklunj*eITGK*ql6t>j5+8V309&21zg1!>hW%Fz=Dn>m=Mt(^#pY
zs0>jr&PUuTr!_;dEzxgog>paAl^9N(r*@L)<$gk2Gn|Su`szLjkNRivkqkC5n}?5h
zp7~Ud<jBTYJPGA_@ko61ld+4TW-pKCLe*%ocMR)G5*w{{<+0+#!$R#x1v&*?W7P_W
zMfP@|^i~o_>Zhvm+<R@*j=RQF&kjqZND2*YlqXu+4oXpW`Np(KLv7O4SrMVOikvEw
zVLC_U^u2}Vyj_!hj}I!)@A51kHVh0Uil^s2vXjy5o<i0iRk3`|v#n#8o?73puD!->
z=ce*v_DnpriKJM`Q$;U_^tg6iwb=26^~^G5Ox?g?nse^P(27o6?r87!Np<&yeuD9F
zgXm$g`^Ser_NGJ|SIySmj2F}$)obRihu%_}Q~B98dHm&GO38bv#GhEU?XMsjo)1t}
zbugp*E7;>wb)p`_0D+Tc-QZH+m~{*xV{{80OQOHT<_M7|9h#Z6tY1OZIN$r^d)=e5
zpf|VcX?RDz3s&<4TM$2?2dZQx`^q$IdKQ+>PTKq4l|`J^EwFitbtrECjEqZ;<hZR}
zs2t|#maA&ELwVXIQC%L}%d2jTl<F~N5lQH_T^7ld>a{iyNt)hVmiQ*s=a?#zvQSv%
zY|Yy5@k1o-d~@YKuJnL6i)cEL-KyLT>A@fa(M-mo)!Y3x4Eh2u5g-ujDIS;_1OoBl
zf`~ykL2yujaIf&z)|Q-{TvJoi($Z2*P0i8K(e(86^768wp<#G<`043sQBhH6XXl$Y
zZ`9S**Vor)W@d(mhZh$Y&(F_$dwXYRXIEBM*4EY*78ZhogZK9K=H})$H#g7D&USWo
zc6WC#FE2AQGxPHD8XFr?DAdHn#PRX*>gwvq$Vh&E{`~y>;o)IhTU%vi<=EJmt*!0;
z{(fIy-{|P*!NEaRR@TdxFE=(eCMPGIot-~_{`~Xj&%(k&Utiygi;IMWgocKO`uci1
zJG-f=sUJUnoSd8_CMH%@Rek&R4Y<xf|Ne}?-;V$c3%Z+3X9+?!`@pDp^xVl?Nr+)E
zTSdC2RwNES0XfJXfg|S!Lue_2al8W{ICO&K@RkQS_)OO&)pjufAUZNq5G(>NLjWcr
zW;?Mr^e2E3QNsq{>GQ22cx=xj1}YIqFo;dBN^Jq|O~S-ixLRtMjg!p=;i6MVWIku*
z$I&8rifO`4L->`~3W8;k_}6h6D>s1Jeo_X4gKT(h*+M(8+H<@fUbz`DIs7pSjF#~R
z!JtTUt}~Mk=359u)Eqp31d1qTDT^>%_9470Lx#4~&DG3Mh$Mw$;9h<>_>c~mA;KHX
zLLrKy);IG8?ECUtn7$yoWfr7Bigk|5mjMN?%13#+sol#P|NQPs$2G*=`;sVRW#i}d
ziGYAk<Ss28gbR(PBl5;4myw0&SukjE<SBraEl!<vpH#AAm{p0nN}sB6Sz!>5<(MOI
zNEO8f4App3+z>>ARfax~Nrct3EJ#@F^<8P~5wY4l(uM{&H4ikAAVOkI<kOqPrGQ)1
zP*dDXvuxi8Z{jzo0cBz)=WlrQzJX~-(<mh`D0Q+nha9;cvI&ou`gx)ZiNNBFbEeS2
z3y9oX5Ey?!3W*oR6$<yp8!r;|#@(Df(3WM-u}9k9lFyd&QRcQskl{;>BP~hvMk%rk
zA7E~{#VDxZMm@=Cjm>3d_LpwTn@~ysL-vXSff|^=gtTI)AKVt!#6eB|n_hyTz!!+`
z87K~i9E<}BXl-o;wC(SIr~cggX9WIHBLEWz;lh{{OVNMmWk+fHw*c}R%E^jl8LfdJ
zVe6TWvds2yxLgpEQh8SAN3Lg|^g7G4yO4k5Rsw$i0Xq0c4b-34^=AbBegys-ZzX`-
z0c`*KANS|pKO^vu8iD`DTM5Wbfz0wBHBf(E*Pjvi`w{pr-AeYrvHv+&!eX(1|Fizw
z`)36Hfg=E{TL%93a;0E8k-y|htPs542WD@BL_vJNg~JV;h!YSfA`u}X;V&ZLDJuC&
zT*^#BT0`=-oYdXh()Wd>5du;Oe#!g168Ct-?{SOW<r2NiA$*5jNc#6C#V#cAztqGz
zmBqRA#dzIB`4dHiyM={&{<96RR{5vaEiBY2BGf8=t5}{dOoPYCoJ-e*Q~5o|J%4tw
zV0Ph9cA>D}TM)ZYAiEIoAJ`0M7m8pPiewjxVi$^L7m8&UN?;d4vkT?03w>f2Dq<HZ
zVHYZ87b^R$374~rl(UOgu-~m>e^A5zxSrjxiQT@H-MfoDu$Migk3DLDJ!ym;J;t6r
z$zC|kUNZa7t$2pL2x!wlKS#k7XZ{3d{y2Bu7;nz79J<~zF(x3!H7(MhI9#nJ^x@}F
znU;_{tszqFA(9<o5?v7zJuwn}@e%{c5<_T-(QJu{0*R>-iRse6Zc`<aQzcT9#nR(N
zcgKokMvD|jik}RZXbqJb50t+etZ*KzdNWx4ZnWNKvN2@lOT^En$oX%fORd3cZNVEI
z!CRf7+nu4my2AcwJKbTwxA5Jbh`rv(z22yU{@BC8#G~Pqlach(v8=O+{PU^e^Xbxy
znX-$S@{5^@i`mMHpEVZ?4HwH_FV??bZnj-+cV7PLzWmj5`K#~pSO4YC;N{N9<?h(!
z!PMpP?8V94`N`7x>Dt-(*4f4W*~Q`M<;ltA>EY$s&gI4S<>kiZ<<jLP=Hhbp;&STZ
za^n1Q^z?G@__Fu#vTN_MWB0QCFRf$eqI3JSd*h&Y<yYUrdOv1)V0ONLdaiE@(>*oc
zF}2h(wf1#-t6^rRX7;db`Y><eFm>c0e(2!iz(GX+esJ#|s%Ou?dlzWHz^uxD;^z6Q
zfrjolL6fdzrHY*1BuS_Bna+yb{xpOSA+vI2-e9KUM;`sI%KYJ6wM^v{<*HAk1zHu>
zvt3mM<0XdQf|ymR3nwcqhd=3eR~Jp!*e`UYB+&#)F}UxqXB(+DAqYH1UVKv_naTs>
z*Vt#O7nPY<_uQjLtI(Txs}V36^xYZW{?Y#qpECcLzC`pf-Zc@|p8CWRoEVcQ#19sj
zE&K?648k4^@ALSpY!0Hwg8RKF<qr5_#Vyg+N_gy>%@##duO}zOHmXBC&$r^g&|@>o
z6drw)VRH*$71*6Y`@S7b#P4|g!DxHxC&7=EALrXHe%PI*I2qT0rewqxy=j{mbZiA9
zbH1c0>nrY8qlVmLjyCkh=cjuF$7!BRq@R8+M<VbMob%XaRB)lwL1pAwC_lauIE)*g
zU*@q`0${y#Z&DPJV2Xd~-fK8?QJ#t*VyI}B2qmak^buB<jEE7NG)r+G8yM)0hB+uk
z+#kJ(i$L)^F3^Rk%=l>9l*GV|h4)EBe+c4{KUWYpr!31fDQM-6U||=pW)S^AT!|5}
z7LV<Acs^vx9;<x@WwLS?x)J1HBmiNS@tl!kv9{E>(aQndoYO>#UJOAUv02(~2)dtY
zJ{|F+ZzVZMBq3ZRk#Z*{k9;bJK##Z}plU4<cx)-g9!*!;o)9@k&6*t(8#|txVU$Q~
znn}DmV_bAsfiTNa+<yVlnsK6ute=;|4aJ!h3l-alHCzyZ6Rr>;NAG-GMXbIMA^Q06
zo{rt)^EbI4EvAN=iV(<7r(O%?um+vFQPU7}AJ(C!*D{qFJ`3*VY_?qz?u4Q&f*&WT
z(yqg--q_374<K?Y9v;;Seyg9W`RGSZ64@_JyKs%cGnFPfIZ-7zehvW^xT_XY9D}|g
z<_BARBKlz@(}rO0Ecu~JTi6h^o*k9`NGym>UO^lx0Nd*qpXEHjep|LxiVSiu;$23V
zG=44~aUop%B_n*LD~p6qkJ2Vc4kbDgP{Pi0@|y>GD$<uo-3n%V=TeScNmsI#KENWw
z)Ivn@L?$t~bI(FI*B%#1l7!J#x)b;%)xkqO=d}&L;E;GdNq2uRJX1lT(z8FC)9!4y
zE>ZL)!n%X@dDY8GPyI)hs9)Aqh|=2vUUz%&>1y;1r$zQ;nm_r_ruscAf%{}@zJ9kp
zv99`4%Z+>@<(G9<v;IkkMrdrzYq%66V*|~{l7&$dYcOT21T_TC(2+}s!Hml4t=x}S
z<3VER;c|TnxOz<x3w^d1Cxk0CP{J%N?-r)U#Oz!4cjOqcf=&ryIYtFuNHyPvF7o?#
zI^;?MiREwd8L8l)TH?t0St%oEN#ZF8CloDM^mV2%C`8_gXt)1k+tC7lB)4v<U7#rZ
z1woj*6sNKr^&2)>mU0=Nq);QF{#7=|JUO2iOq@YapDSG}n26%#FeT983l+?3tqhIf
zWpI?w9GmeiyR*j4NXaL2FG5k!F}ls#9J647=hq>h>KjSbVn9fA8gW;P@7AzlTkuo4
zVn=!fy*ibdmpH@h)_f*$QlHvS#{}<tle1p`BuY~r<Q$$Q14$U(NaKAX%ZPQhkeDXU
zeJY+w--FsuURBMN9`EdPt=~`C3CX>)qSWs(wV!%|?a94&+}Z#BY(EV|l81mQ4|p>i
zpka^lWNEtw{G|`l$wTwxIh6;4bPh7;dh-+{x(35M4l>~+`HByfhoTY>vbY}QD{FQQ
z#nvBW3x?*aS||@E{&*(l&T1&H#ZLH2wTFvMIt``cgh<l4iAZ~@s?J!BPUC20*{W^(
zjsXdGf`{{{t$1W;vYzEAS8)?j`bl|k<~HyvCTXRh?)C-X{eW8vu@q7<B{nOqEvZ@s
zosOtwgTrx8Z&<$<YtzSO$G1_x5W34utZinFURJAe4u8R<ozHRo!>T}e(3!Okw{cuC
zTaUw0hgzR3)zqn_Sc#cSVSeKNIQT)V>bN?V*wW>A3^#D~S@xs2n`*i^2{O4Akh1Qt
zwS>(LMy?f<>LC`Myb7-_AQd`yi=KED)Hc<RmCz+8I#Mmnc!b7S%;*$=z7)jUTr3wt
z>g)&#8Q3DY4?lIdbhwhS>3O5vid}-XHTOS_9+lISULC5ugBpi-?p1$@eZ=%$*9KxT
zW8(PWTFD2M*2K=XW7ZLpVks@RpZROF(ifw)*4Lqiltd>2o<gNhKA+#xSbK2K;;@~k
z2NMFCkjs@E4PFTIGzwOn`10;l!0XEIrLWAx`l!`kDBase9AuKLQ0yyjk|<5j%~-~}
zE}!mi$Lg{iOBS##PriQNILqd9-1DYa5PPl_EVIG$%8LH|M((<&9>=r~{R|ALpCvPW
zNJ#HJiVTbUdWRzGi<l@;;?~=q3!@x@sp?&AXLN<te2w(0uEykw2&d_v=wcolX2OcJ
zb74za6+Dm1k$9x+;#>(^-E-$wLz7jHP*AwdSWC1>Fu^9>D+<jT$mwo;{4?uk3%;Fg
z*aX|3^)sg97BXR0)fKsqwybr}rzZNUt803<UU{BRV@PXi+aGN^CY{f$KCY=B@7;E7
zIG^1Kt7%+$^vh%V{KrXO&6nfeU+>S)e}c$ro1l+(ycsVruqU-Gw0%4Nw`cOCs&^im
zj@fu43d^3$9Yku~u=82jly+Scd5E3hHCK^S^N7*dD`zfVl=!B3V>Np-!;064qo#3*
zkhVHfsYhv6ro`>TQWiES)XHZ<Z-nx_Mivo^#V_o#=jUE>he<~ChscXDeZT5w&ji--
zjx|?6X(g@MGw3a>RzW<AvysE+(X65=8-^?H_rc8eWn_5G8oZ?wUct8YWY<O-y0~X9
zy`3&T<t$vhs!vNxb$huec`M|rfDV1`{reWHtM^m(T5GVcOEa1KOsYKF*!#(oX~)MT
zZ`sQn-8ub`drwqXKtJ&+Wa`VaCo2~3gbP-DPOERn)Zks!x(U^;XC;j<#jrR`(>9oV
z<$u3pAzrr^{CEcyo=?B4mRO6%)`(6&F;KatDb|)wW*0`a_$%h6<l*)A(T5dZxwb!i
zy;ym2bvAv4J?a07J?_84o?l&o=#V&)NIWeh#2pEXM-tW|i6@YxCrENSFG@)-YAr7s
zcQ3klFNRuRMvNEBi5HyCo6Yh=%dRmYhogiMgfh;)g~n4R-IF-i$xuS{!<c>T@rwtL
zyU%ciOqYz|7NnmCBo>^EWh}MkpL%cOYku{5#^r7=t!XZpqfN<SuwP})p3DBw^{tkc
zqk4_y(6g61_&!9rPEBHNBR)>bv4&4L3~VN7m0e$s-0+ub*I?w}+;ebWd3d*d^ttsI
z?K>{egBrtk907dp_tYe>W0Ncb>dehChXEf}jo+wiL*-F0H=nQvx`iudo?13xS^)wp
z?>8O>K6bxH*@klT_h-xTPwmjd*$Hq_uy)Y$5wa8$$V0`8nc3D_xn%kk#0Osq`8_>;
zaag6FVQJ4!7s$Elm!mFCE*CsK?~Jz`@VQpBy@OwJ^tRN;_cv-oXC^{_oP=WN!saEz
z7PZ2b-NRPn!`5rVHYdWiPr`QS!uKS@546IM+`~`e!_R8NFDAmVC*dIa2pp*hz%~c+
zCIV(f)gDi)vSd=Uf^4aFWRP(q&U2!sr=ZP8O2j|6k8z90wJxQ#qqdBMmOIv&y@j`t
z1m(P?qKo8N6PsGX>KUV~%yL4n)hRcKn}$<qx@r1+ii;%RGGf)_q>ZD!-4;=VGL~+O
zqEs}WA!lff7x@AYKm;ONINlb*LVpa?-q-LKuR{uJMcq1;+!HdKu5x^)5d%H(orz#o
zRg6}iy#0DjUpv#|&NFG(gb0tixVMvW?@!~9^zpzthQ8YI{%_(@3GqR7@gbA(VW;sC
z^a)W?3DMdKv2POM6A}{Z5|SqqQcn}m^obdh)I_I|1;_g4=451bULtu$AG2d`Oh%X-
zC%z2yDq6Ep_DPH}ON37(ZdOS?fF$vs(pSH5y+xl~^~S3x(AJqlr_;)-h}-u5T5>_Y
zS2ux&yh6$i>_lRGm2HQ13jJ!*GD4>@6Qz3Um7V{twv)C#5alD5xI>?|CzW=fop$sl
z?Ia=XtS;?hG7Wp024X<tNTcy|&=3zaED=puk0zc%lb)f;8PX}G)2V?<&|G(umNzW!
zNd!h7pShEYZdkLrr>DAy^qWP`C}x<@xDD2X^6>bx1f_n|3ZP?C6{=4c@nCkVvX+?g
z;t3L2n#^Q6$<*Zr$#x}5S;x-0WR0ED7l8C=$8WcQGp^}mYj|X9C1&f?XX{O68=Peu
zGUOOb=a}l`n0w?{Cgxbz=h#l=ygJLVXUKJw&UMzwb=C1=q<3Ffu{awxW0K3pjn9qc
z)WqgjTZp;7zr&r3$CdZSn%2FI-*u35iax1n#PZ9H&@T~jB(7v1r=nIeU*yz!wwRd<
z$Hw;8#ZKWcZy#&5`02P(fUG)&P@Kp&^`CmwU*4ZIPML~M3-VzLc<J00^QpdoB0e`K
zF8G@ZNqU5ZX`N-RH8NzX;On8jr>oU>LN9OWXx4q7IDf|+!c+$CA`hJxvI-_Hlm$zB
zg>Lo5n^VQxXT>`VC415(2RbE39wjG<C1>>|7gHtJvl0+vDbDRuJl#@=XDKYHl(3<c
zc)FDIyp)`=jPiCFwQd=WXBk~m8AC%E({vfjc^RCsob7h`P2F-1&vLG$a-N2AzG=^L
zf%9@f#tPxv6{5No;+_?fNfpu!6?dj9?wwa47%OFOSIX;FDtJ~ZCRHjoRH{x_K0dEh
zW2}05yXv`am4;`PR#KHtLzUiimBD$HA!D`i?P^oqYIDzO%cN@ShHBgC>R0F0_KY=-
zw`-hrYg|2R+>>fN8fxAWA;I9^M_@DnYjj`)#t-K$=o%>C>gtM>SIEK1<?3oUW%z3K
zb5JA7W$5Z^DAlEL?JD5&+SM?6_3FwYb=U#*CB-S|>S`^;34OKpCE&MB7Y8R`?^=Kp
zI>5=L5ruYe3R=Ay4nPF~6?bfW!b4ZXHv~i*Q9&uFFGE*rjcaQ|spwVUy-q;^sp!VF
zVV}T|$>|w3e&M-=1qW1+L+Y1{%gcbzUxtR!?|l4O`Giwa(f`0>XMbMW|M3U_BQXD_
z)I${Eyb3~RwEm0XOSvFDp>MbkB7ZOSpv)#D=l^X4=9vi*nHVqvb4mdT4kp60RBWPJ
zLPF((d5Y+o*nG*A?kdMOA=U=-SXt@drPQXwLAY#8AgL<r!2<o5_xOegBnV1OUc00N
zhv0)rD(j2v5!<>IAVQeEj7yXL7Z5QKf*2tX0I|d;QUk&B2Jm!j^v1eIZ|Mb73f5-x
zCG2_A+Fk3gLp$0{lo4SJ_?wQcC%X#4(R4(J7C+pwg+%{gLrEVDKKuqrSoOSjBSedH
z<)U%^RVj5XDY?<S#9?|m0alcDO~=-xE0lm5-E-<{AF{!Fdjcuy;7fM+@&>x#PBS*>
z>Wz7`#%F!O7L8xv7~Kb*LU{<6lDmG_bg0Lmh&LveZU%3+)bTNvG_ADLkY(l=*+9k1
zxS1F4Lp4Bp&q(t0@u04d3?JH7S}k1ipjK^Vx>P9IW7Ezh=|OLx<jeQRLX)%~_#Dj!
zKL}B3Wk&~UYw4rvipCef_cN$X?J1KZKmiI^ns`^ThzPK~{bw#c!|#zaoHnq7ICR9V
zuG$+G_@!&hV1KLj+1GyW={epgCXP?&d0n$I!56M&2Z6~O^J$^w%;K@eDDERI(^yLK
zL=cy%AX?X6UDG<}zDbI-wjrEH86B^`b*k<I=TFp7w7HgTqR8-maiioqe$q$dw0F+y
z-fcgE3N?o{Z0r=e3<~UYCSPsvKLO+YF{TX#vHS}~9U2)01kK3IVrZn?w`}xlntO_i
zMe)dJaezfi%cxV@x1qAYuOp*I0p-4C?nW-@LnGgO%>sv7(w$t=ea$S4%z(Y$oXjko
z%mR(ffcFBM<xVc{Z2TgCs1}cWOKJI591xh|;_mB`{<S5&c%;0zEHI^|{06^>({BfK
zum952KQ#Q>)#Ju3(TbWnr+~m4x5R85U7ga>jRMkr0|Nh#-*kVTz&~&V{+6OL>$&gz
z8%2G~n)yEz)hw9q4@F%FBK=)aBk_X(MK%3RQ9*xER6L6RSW%IGD5~LKDXQ9ksHg(J
zD=H4d-%?axKv8l0{{uy(llgZQ_5SaQO8HlcYP8e*pHozq|6WDS`ir8HBGLboipuft
zDXQRqucDFw_XohJF<>_^KKQrk8={T?d0vStJpKb#3o-iuqyE9A0E+@p`Uj~35DS1S
z0I?q&gG6f<0D=XWwh*)Mp?^Q2CP*}6(hBHztSy|J1c<Z{vlW&R6gIgJ;A=K!->P*B
zU|IlT3;TNj2L2s)(Ez&whzo%3P->8v2>`~!*{!vrul>bd`HHDL6E$)IkoY&^bqY#J
z1+dlyfL?%jQ-+7LF$*cF!>hvp<*p@Q_5)IfQ-B%gsV+lnUs67=HKqnNrhWnFHyg7B
z0I;ZI&(+#+<L97+e&8I?DF6Vk4TnuGWKT{OPHz2y$Jvuxji1o~S_2>r;Bi<+&xh8n
z!v2L6R1m<-04*nA7Q%qn41ZbujQ)+Bffs)s27vq@SZe+sximmg&3aH2=)YBt{7;N(
z(n=>{TDhb6&*jMMZ8U;<e|bu1)z<T0d`hTNQ#{)MJSCj%t||HX6^Tp4qFP&OlujdV
zDv4tK?&rfsthkM7M*EXRQ|aW9vm)_2(d@kUR2gjNTOo}1N$nGyn)`1N8sxNORy6k)
zvzrR^>TX)Kg%M#NGhdX`!V9#+9e~LhzgF}EXrD79rCWyMRJ6DvJ(S~?W74s~<2;`|
z><Nk~GQuO?y_2E1C6B!R<m!{(K>GFWns;h70h=oD_C#um%@z9hQLP$3y;Wl#rg*KZ
z$LfQo-?XK8VTJPMo{^@;8GJ~7#N}m7vnuh^pNnU7&IDLYd=@%m6oE%;?ChWJ#J#LI
z64Vl^Fk?bx;EL}Co}o((Q-rkMu(_TEO|ljIV$o!+z+tuYL`7L@GLlL|bK0|x)e;n@
z8EdtiV40J@oM>CUwwz?&#=Vm4JZ80$;=Y`}lKS>&Z6yr};aNrd(payiqc}dTW`u~Z
zuVyN3<E>=~hKR0Z@WbQ>vi-epegmQXdDio?Vy)Nn^Kw3|e=4kAUoXIxw()EfR*qS3
z6xA+&+9+;3THh#Xg79vZey6e7EbHJX*evf6-`K1eP~hFF9H}O3s+uq_*s7j!-Po$Z
z`15YpF2>qy*RAFhY}apAZ)`X0wDJCGJQ%b2_4#DE;MbRnqm5r*K~TP(COlf(on{zk
z;Z6&&#OBU7@`rr8->EficU$Q!3U}L>+%|XH;Q@Sm9XI1__d2<93-`MCYBu+}1>5=d
zdql@=_j@H*3itc&9B=OTBcS{T1M;+X2ZM^7MF&Hw5?cquY7hAjN1kii9gb>Q6djJ~
zxosVe8wT(nO_;{n9Zg#179CC5)@&V3+qd%{&p40U9nZS26dhxKyglAJ{)vPNoM3!u
zU!BaMIEzo_LnO9O79t)BoGwOdzB*lsw<tbcPIlWqT|oy3oULZXy*gXV%Pl@zFRa-<
z+bC@pINz)se|5f9yHb3<-FUox{;LUk>tg3S?dyx(4$hK`y&j2Q7yAPbZ(SaYXuiHY
zoUkalJeqO)b$N^lxP?7gjC+keUCjl?fHrG>Vb6EkZ(Us+jK99RJXtBZ!d@Kz0>-C_
z(IBW|6Ar@;5~hmAq3vjbNbh)&hoJE|6`KilcD(6&&=84^W>SwGA2@M3?4e={W#W!6
zmufnpW=9K6{f?htNIJ2F;x~q=9e>H5bW*pDZ!Bj!0ayfJ#~+~ho$W^iNKrL|GOpu0
zhxBfsT1W<Uu3{@sq6~D13Q1Gb(JJ7v8*E6NN!PB}CY-n%q70KG&2VcIuip)|56NVV
zM7FMU?uNPdWU_p<^b?zM2uBiU(J(iG@hly{Hzkp9e2_m6;&o)i;yf-Lrd5eW7@rEm
z#!7)fvcUI1W*u3$YUqwTl$c08Uj$C&1QMsV97L>zB+yd=3sjebI0du#9IQH?7e~cZ
z9vI_3SL>1~#>6yJH{og!fK6$T@i=f(5;crBV+5Mu>r58QlhcRbnY}pOXm)&Ray&2>
zU`cK&!@-}gZ1$8g9>0Twgu}kiSYe-N6-#X{@T?Q5&f^G<pD`A3Si`+$$r`B(&lZ0a
zsO;taEckFH19y3?)%6}amc%^|G-cIC0SBQI8gJ6?O}0X*;UpV{*}{W@Di%+lf?3RD
zsSDR|s11#9h+1z*q>MiZd*zUz7h<VoLa!Eo^fZ{MH;?8Pj~WE#5=>ayjK>gxuT@T&
zNXgFrln8{+l!qafrSs-ZSs%0$r_Lu!u~dvZ>qBQyWij7fSNM?s-0V|j>XU0oNwc~q
zP9CGF*pUK?RC^zTPtQ^uVodq@*B)1UJLL9mtjRGBXuj4sir~m&*9%=&(ZELK|B&a<
z_^i|k-9$&|m^PCsV!TbHKjM%`uG^951*?{`Tq}O<%eQ}%@iA4U*e9DyZpj24%>dbv
z%vwJlCA$P<^82VvtX>m^wOYp`@uvKx#Z8AL4~1EQ@EUUVd|be!cIZ`QIZdb;+n{vE
zo3Z`+t}4!_+?W~pAdy6!P;*wV+XmNa(NHOTyH|`J-DNyf$@u<DE^cee#@oViX{v(k
zuLB2v3e@BqT$t+N7QDpEi^Y>~lEI-?^KDCwYnZ)ja}&1{V`%N3-^g?m`gZ4OI54Sq
z!6jQ^c2$3==%gJHYZCsEc9D%SAw*8$M`T>jB0tBe`=hY($TZtK+`6aj&jkz+zt7tR
z{XTE^5AYKQ1&C>x&+eV2YMG1G&d=`6r%s)<)S8PWjf!dIz6W-#j#jLm4egy(Bmpnm
zdEdP=JJlklVJfC!CjQi5s5@6&QB6!;zhw`2&3wh`e9PYa?COq~R?E=pPDN5n%hb-$
z>gdqkPQ~g@>TmCz|9=E0{=CfpTOt5}AFmb)^!LFJM#H1}ufdOi@_#@0;Zxs~bVqu5
z`H<l#0@Yb?Z~SN~8aN!(1o~It2l*ZRs0j^zAk%*XKj^;#KjA>40`1_Fh`)dz$?xFD
zN{x(Q_>Ka=Z~b@h+W`aMM+<;oGnAU;H}JFe`X}&n^VwvAx9dP~{tfss|6A~rL>lA&
zEAYdaVJ7#6GW<38je*@j{{#Gp{s2GPzX5)9|26QV{0;o5{s6z{GKk+F%}|5D|Dre+
zs4NFEUknBV*c1RR1c2cHU}6CH3;^?>e*OBjy}b=&#DMw0|1DqUKhN{e2>ee)08qdG
zOlA51*5cR(aU_uT;@+%m5WMxW9@%}?Yhz#f!^i&$VxYQPD%UQ`di;P(+i=M%j@~A9
zMo>hxpPbhd^104gW(cHK^E^c--Ez2;-`l)5O3bRWlG#EdL<(3<ppknxtjO`WZ{`bk
zT6K@7VDnu6B^w7Hle9y0N%;N7bNBNlOfwPo#&)mZ`ToXTR^68gC%1om@y`vXeR8kP
zW@%+`|4w7-JLB<@OPZgK2fgE3Z%#&Y(;m+)ja)aM3su1Q;=9t$z9Zrpg+C@Uh=1u_
z^g?mYZAWavz#p-@@+{!Gj(>VETQ$nir8WgM|6bV9a?XHSLy-+7b+2tcR3u>q6Nc!c
z$?{d1qGgMep>M~y-fDqmMBi0D$c)jJ<^CA;kdR>UBipt{=3D(&o!Q<7@1+(VeY@0*
zPnHp;HM9_QlvqizYcov>(|KjdnP$sS8=2}!GMW3(K>$d5BNTYnvZ6Jt*RtcyKdt2?
zyRNV0{x_t(8a7-1BJE{k)rmwus5@q<W#SG3(%u{k0pINhSuFM$`O^Yuoq4J4c+(%<
z`Jb@{occ{_Bz%i?UTmsB+DkjRlg^o6qmx1wcT>QZHX)Cp4&<%<TiVMs-pcmhm-asU
z$Q0GG6WdWX3KAhanliTv$x*R*Niy5^qP!R5Z#=F44Ey8F*ZgB=(+~8=KYeMpW7|2h
zi^P8JKBjiJW}=#^nftG%y(PXZK-zojf!6DVuf3<@i{&PrH}=bT!_F7iIKqLnw_*Ep
z$`BEXq7&oyzn=DvnZKp!L60YEmaJMn@qwGhHA{YLqzJO{?K;P-KBsGGaVULD4XoJx
zchX*lUDV%5dv$h$wD3Zl$~#(Z=Irdhn6R#?O|<@&_R@&_pb>JtEBZ&;%e11{E<N=}
z+I!s5e(!Aex3m`yRqBvs*o#1^W&!?L9SYKWkr5$TH^Wg}+mH65yaUtNRZyLe2|3=-
zQe|>JRO)(~xEGzLn$4rx*`-mx7gHLN&1a$1tuwV3TicT@;MUn~aJCoMM4TfSpwwf`
zupi%{nj;+7*<&ufpD+-TBbuw!Ypt`NIMI_MUenq8%40tXL!2wwuGHt4`2TNl?9@Sy
zWN-dsx31yTvx8g&$tSe{<&g}A!#u@DpPq7ZBXgt=^VLE>J<nAh{iJjFNvqddg9r)a
zy&&@~f`Z??ugU@MD`R#f7y{C$tOvZWLV5M5nvijwfYDU%hCV@)M%>zA36iAHh(-<6
zKzLM&>MZ~fCrz|Tj}-<VZkTYYXn&KhHj4qguWoe<_j<UNC+kmIJWQGx_!Lr^M^b3@
zEOu&)C$_9ORJ2G}Ggx?Xil(UY?j&G-H8ztNQqyD?{#u1*X8z2qmQAGCam#xqf?u<)
z7k|<zlyNp3|1ZyCe}8iDPt`2|KLNH)Vd0U}S67<=E^T#(mCamT0d4DQrXsCtYqKkT
zx-1gt>)g63LwBczS9GE)($L+V=*Td1ciC^7>0#j&Wxx^2(#yirr>|zx!qd~jBg@LV
zH?L*@&!)7pna-`PvY8oRLM>nmwK-E!RyI>s7CF5&19&`@b!~N)b*FXBgoUSfc2$)9
zcJTDFu8PgBimR=e&YAAcvh?Y#?y|1#G;~F0S31CR0QODKR7_uOm7&xBr+zR0eDR+V
z_^Sx~t!J@t<sA?LFf#d<)h#&iGF;z|-;GSx%6ti9f1h6z>8q3|>A>QSK(cwma2=l#
z!z=S1KnMld4y~HKT2t^ylTV}!{fBX{dAHrPcJKlR5#XV&p+U`fWh8w5*AVHs+SPX(
z-s1<;n0OQEaI-WCRttb2FKG|1A!(cX$gYXIqtGS-&lB{(g(<p&wm!g`Q9$A+;WM0V
zaK(|$+f)XDChap|n<rmQ7Za939t>1w7*=x#oPefoY%CPf%IT`=?>1S5q|;|TLL_AD
z;84N_T)Qe2HiC)qYEP1nUI$nBe8kFfB5t(KlUy^9JRuP&-(UWaMAdFkedJzexWZFY
zWca=nhe<L5L2T;vLd!v0iW5Z2tOv&>=0c6WbdJCuPj(nluN--h|0tK<ue!H2*?%^B
z`8p^z;V{vh<P!&DkoY1-Mlbcvk&)ibpqx2NM&m^mP>WYphN;|{sEiKF4_f2*Qp#iF
zUQz6=O|U!a(OxhL+oo|tlADMnsP2&%YZyz$fk}jUXpS~gS-tuv>SR`H`NMd=8OZZF
z0Vg94-`ggt=L83F2~iR`&Kzd@Tci5X2+{;SZN%r?ajSfM<y`ANF(jv2EPX86=nlA+
z1ww0UkK=hxuQRAa*;ex@Uf=5rJB`8Xst4B!@QbUG6FH@G&CMdij@k0?^yr&OnCaA-
z2&Kh?7L@KYJos4XqW(hNm3Q0J+kMb4X3W628Cq1i7~Al)ayh4<IDDge<JE)JFTAhS
zcl&I9ss3~A3;bWyz5v<<h+cbp#}*cQh{d)~Y+;X<`WKI|Ta#EU(08;o(Q&vq0CWR=
z69Y^A?URcGll=orivu0)14|R_lkLCt3`_t=m>Af?ZcVfgOiU~R-g*7)1O4qCfSw-$
zoxi8Si$_Nj6I*~6-r?3{KhSlwG_eTubW98kY;8?$9c=-oev1=J6TtBow*bQf;8cLm
z?;jWdRQhmnauGNU;Qz!x|G?zL;?m;QQhWQr;^O3A-9dkD{uzP)d<6cM-ZHBqLEyix
zCS(%&=h~O-K-zz*eL?+J`%)Q?0eb}zvJp>c??MJMX=#}{@~Btwp|qZqifU}DASN}c
z=XBB{AO#3M4;wi`qX~>p)gfLhsR8m!vz)~?!p4lJtLP}SFgikD|8i?y0a!Pv6!{tC
z;h%^0lJjLUqB_r7d%-u^K{F^Wh{QpHVQ)ncb~-irX5dIFTl<}a*Tytx5jJ;~W8_#m
zVX6+_=8-QxgRHJ?jPfb(a!}Em;yx`8e(wd)x<@PmF7Z6~p0SA@9Mf*uNMwr55^Ed*
z9Wn?o+2nz~gLjMDYOX)|a#{Fl--%cGg8<#@1Ka~`QzVoWZs?<J%-S}r@&B>+)=_c1
zTl#O~t|52`?(XjHfrQ`?w1FUjkf6b#8+UhY+}&M*LkJSwonS$m+xeb3GiT;^@0?lp
zpF8)gY~IDH>Mpvw-c{6kdhh*yo;$S3UKGMT++K7GI7OomA72zLy85#Py|SBAOEUQw
z^An{D-mRXH5|ElBmu8LI@`)@=<gBaPFc(a3re&A1lNUnrreWzr?e<$*`P6E+)gYPB
z=Om#;F$I(WRMvW5)Ht|kI5a%qS<*W!N?%J<6L_n4U#LoG^S>nLAZ_`Q>+>e3k4rJU
z_+o<&d0~LmHkhk9y<7;uq`IMflaPK4B9CJ#SIW&ayxlfQm}<X)Xz5fhe77xs75XEy
zm2a)+jnX(H37pfNr5`fg4cfM{g>=K4b#U^qtxm!RB_T;eM?K3!t<SG+=^=M;DJh!N
zsm$LJ@$%24;E*9sxgnUki;P-|+oZaM{=?tCBQV4(EbH3cy6UM$n!zfyj0Im|m0DyH
zSfy5f%c1>-!qu_kVU9rZZ<#_;*fsedP28~C;vWpf|NOu7&yoLPGw^?R+l7Zy{EOH3
zA2Jso#s6=-K60Ae-@HB*0JF)67ZbjfY6_gyL7f|qg?gHVH#OoSH$)>xhJg@qk%wL?
zQy@;BJXI6;s(`OLbX1tn`fa%cmX?=37mIeK`U~S1cJYvJH9-3wxzssUt!C?_63c~#
z;#aNK%M|?v-%qu=9e!0D-3!<*wSnF!V|yl_SPTN~#QE+M&Nic6>O-y4gt)i6QL4G?
zF{`=PBEuDEC|JK&S~f))#d$N{xQ<MMXRgOZQ(QH>S_DjtAuU@U+9wQH42_7GUvGTX
zHsQZ@FH$)UIwcP+Kl;&nd*L-zYVuSqa{udSxi`zvSp4x`5CQ(L$^sRD<Tno)9`F$^
z0X_sqv4Gt&VB<fC7JohRkGuc4{a=p!r%(NLJQvp}m*@bydMkrbEtPE%#m7`~uNbl*
z5J{*XQKaYd=+Dn%oSsG7;zwCL3pK(I)WQFv`RtP{fs;Iuy&SQ%9GRIMm97H!D@Ad2
zC0SKvMHOWg<-dlKlCpw=qMV$ZtgI{y>HN2lmXVSEXCWmeB`GN-E+Hu@CN3l*%E`@3
zOV30?4)aSVLB)E8K|q21f)9sE4UgUem(CfN&XthGm0HAuNzGqU&&$Z($H6VYD<~o;
zGBG4RGcv6pDiac)U7V3uR8UY*R9IN__b4tZEG^2bhGeuBMfMg2j1+vDEU=#`u$wJ%
z_+IY1SmU+W5U|u4z0i|7-3J-!sqOD>?CNamXzytMPourHwY|QztGsm((mGnvK2qO3
z(%%1dbbRXD+}z^Q((=m6%IfOM>e}ks@3FSNzP7OeTST(~BUZ!eL$Hd`?k<cz4Fgv1
z9UN>Q9>Q4Ft4Bvaj*gc88nBIxqoduUqeB?y^?yyk%3J?O>>VF(A0KZVAFmuAubrH%
zpPX!-oa~&O9Kh;duz(f9{!73zD1QqWcJprm)BFD(ux}@@fZZ>6{yXf37Z9>J@DF@X
znoqp1t3dx9b|c*?wu3-dHvPZBZs?UoOp9B3{2jaTyP>YshOB&S^0MOJ8tQKBSK7TX
zSd2%1^N@{kL@Y6yYqq~8^Ry<gM%Gw0x=4pnsI}DX&p@<GjmKK*55HHLheYbzjHfL%
zxg4&HwSGPkN&qfhtF^f~u4xE)LcKnzkL*t738X)}8tXiqueDnpZ@<45_|^^$dnrND
zroHWjc1o3Jdw_mz^62Jn@vZst{w7a5<Zd7f*3N{?xaNz94qVZGd=6RjN2dT8n`zuu
z_Xj?!=>CTOt}f)82dT8>IL@Wtm9h720+3qiUThm#g0*39BaCx^ktW<hwtgdAa0g@_
zv0Kci=ke+`CP#Z`R1(>cTseVO*Dro5=k;|4<90k@!CpMsl|}J(qT#3g?Ifdf2z9bW
zqF!M#jxwD^$a&EGT&!lf={sGy7Bsp9x1HPQgpDS=i7a2J-d5lR((i^k3g(>zFm{Vv
z4p^R)DOLOvGVN<S@#m-@^<%E}=$*bQc}#=onEX5ie5HfHGj~B55L9}j+m^D-wh2C{
ze1s`7&_(<?%xnW$1UJi}%KWJMXx8TF<wbQbRm~(t>HE4P)<uT;8SZ;f?a`}4w)*&k
zE1E!cOZ}5*Pt4m)=A7~GOrALuBnRn-p$J9VX+8P}6$Tc9mF?M?IqMz|*9WteJ@nxW
z)!n>DPMm5b8&&DuPB&-$*x$h)dgofIKlDATe8uHSmels42~;eUFIcCq%g{jyy{};2
zsYp2;eI@7R;K>ojvjI|W@F?n$)mAEFQDit){;J$c{jRuJP&jMGVstVH>zVj8@AM1D
z_De!L-bY@NSCz`h(_f-L91`k#Mw~a<YTYoFv3zH$Z9ig5sf0HFI%#n(6stTe&JffH
za+(6IDzGwz3yj~)6!3Q#FW5!nb1>nHo86X1imZItjgV0f-m-{0&)nt;A7^3m1LO$p
zIT|QetZF2(d=C2TqRa91eUV7jqzKAOL9aTUo7bxy^cA9Cyeg<hemB&OEJlI2n=cQ+
z)E3MWoy=mF$YGlgzoxVu#TIgpG}{^d!ed6RC%!6uskA|E<}UnIy2ujZ5ilfh#_AG#
zX1pE0+|4RGBr<<ah?=nzv;k|VqeNVd3mq1l)GkApTh#j5^;QYjf8C%LMM1H9xIQW%
zM{phaWfMGKc=VS9ef2Zv0VW*qf!k5BUa&)O<Kj<TCn(}2$(e^dX9;<vpCYExg=BXh
zy}vY$g_GH0Cb66*F&M0g*iVph!^|Me6=>XN_B=(fpVeO)CCb$7zK%GUzJW75+c&4l
zqNrx^xsxS}o9xM2g761|VM}jTe1Io%A8vaHzNl|PYoKlwgq#Z;J*s#iDmAR^;jd#0
zvB2a;>sM(xi7hynU1YvxR?+7UEX=2+=Nney){I4}xRgDRZ4OdxIKeBv3?$dKk`VcX
z{`RPaYFzUwUMgrEF@V5|3L{wno$cJR&Dnys=oU}BIOo~?s1?7pWR8OAGu+36KnmS&
zA)Ftn?H4Sh*y>Z%_++<JkA7GQbdrp#Cu61AK(%+hHo$71uYr-=7OL>|X6(JMF0zTM
z=@|(Bj@{UkdAudyQ@qT@QzMfXlA5{`+mQ)u)hr1IO~z{VrKT$WJ9dMu0HQq$m`UxZ
z!?CC;rWYpdRS_HTHMDsKR#l!AYrnw%U0FyPnJpAfDCT}1LYk@krf8$CBx#LF(t9Mm
zMzjWEN(bU&llrT&0ED?}Op(6fD}z-Qf=YGV7v9u*@s+)Ut-QY;`Q8C@)$qkSGFf7t
z?;)M5atSgpI%ZBA5WcRCjwrJ*fA(An=4YD>t1Jk7T^RS!skM!kwdA;8m`<Im%~4a=
zux^~6gSl!{i9y2@%vF{a7q1&$rLZ}C{<^ecCg0eBRpAtJPqc>rt7%B>M3>@Y{EqOi
z=E;bPk3}lW2l~J0mAHDf&PJ9`Jl@i>+*Y^^s;qzm8{78ODm{>#SFT!qwY%AKc<rjJ
z+Ke=I+>CK-oRqFY?}#)W9xHuOSTg|6Zn{t@z<$q0*N_b?y0Igx0!iT4(F|^Sj;>IH
z1xD8~Yx8?48=Qh<RL!0uoB9|lPQluvX1^+$`Z?K8!^~C9Psf`E1d$ITTt>|UPnrfL
zgSVmrRJXRVnuiqW7h~c^Elk;(hcz>&<MLFuA5@!1bc4qeYDX>O-Zy_W#U4)TRow{>
z7aFx*gM;EsYFb^`HjNQ31g3ryMHiIW8hy<!%Ya-HEOgO@g-|R@byS8cD&vlAD=tGt
zzi!Q^?T=@(1NQ<o0#}Bo88>3Qu8>a3CO}tsIB~KLvWpq2PP8?n6nP0D8?(}WhWJg9
zU$$^!4Osx<F&^;gO48KGLjFDlAMxi^x?i~+4$(d3hxfeIXw+c&O223QJFZbv(fc}N
zTXW#K`a1WreF4h+iIlnPv?#V{2Ooo(4Jc<blJv2B797>Qu}jN$wP=kdsRd-4hOA}H
zUH2K0`G`!!+MnJ>_6T}&Cl#)3E-#KhJc+E7e)-(}qQgPGOn){xxvAwTVn56}b-jY$
zEeeV^h9HOGIUfYN%;$ri`V;ivBQ*a?hhvM@a7z6_t>Db~@BmIETiQjnX{<NMbjem|
z-jjFao{r1hD&T2{k*PeQ^VqK_wA&AaI)vx!U{~s3)1k2=*L-j0Ms-|!pOu6sXr|&C
zySDw9?2E_`4%T1I8cipkqBvJBR@T}t#Jayc-TNVM+`v8SIC~Nk-MBBk>ECVq8Tpp0
zpGL!KNSmS~v9m3Vq0*h*y5nO1QFPC8^ma;H@3N4H<3QVSbGkNjxYWnn%ZS4hGShLb
z-6?ibUU9!{-Ttd%SNJU8>1zF%$<ctsmxZ`WuR5O2TRR`|%VqY*{lWITxgwG4TBy&j
zV;7Utm8UPOy&PY<;yND!BqZ*zDxp^l9gip0q7R!-H@7n;=VYA{VDri+)1RGB9_Ky)
zRMTq#-$OcIWJWp|d4s;j7ZYfSbmP0V?TfE#il^(hD(6RhLk=TvFi!bV>{${K`@ci-
zr-hi(xcSRk`ZJ^Av(EdI{q*MqS}_R*%+dz%-<a|x2S_&rh=ODVZvyb~0;S!o#dQNm
zWC9iEah00_F{T35lW{ePgHX7FUc1>UxCQl?1?k_o7&W=y{tDXb4>D2=)&~Z^1qHu`
z1iu;zR^JO&K@Cx443Sd|kp_lHfI>teAwokT{Cgohs31;85St>183=+hfIzem5Y-Tf
zVh==y3MOU*KUW0f1Hm{TFeU_yHUviA10$e@0vJOd6+-W<Lw|*YUKWM^91K0#4Lw8&
z+hYjZRtVd$4qFWg`%x6OFc>zs8#aRyKFJV1rVu`29X=Qm-d7afJs94x8{Uc%(Zmo@
zuMkmV9Z?w)QC1XDJQz{98v%35%VvnoP>4*mj!X)Pj4z6e8H|kFjSNGH0x?7dDMa~O
zNBM+Ac@;&u4@Q03jdDSWc4COOSBSQ?j<ybowkV2zHyCZa8*P9RqstKUMj=MaIz}TT
zMzttLX)s29H%1aAR-7SLHYvzV(f6HO?514o(?IOyPV6BvG)~YumbuuMS1%6BElv>4
zkEuEC2VETNZX8Q-oHWS`$pt4dy?8m-cxYk#a(_IPLcIE|pO#Ppb#lCpyQZd%t-*qg
zk&=yx67ZdkwK<x#<${&9o|TQB`<s*mMo@wSiIN?Ol?$4c>w@LyeRq43B=)8xFOmQl
zd4m@<$-i0BJ;gEvYzfx040HGJ(@PdsOpZ<wjBx)LC6wYopORc`k<^?b4@t>v4$2@&
zRTWIlzYQ#OPt{6JEzt`qTS(PKO|4?GtQ1N!2BxJmr8VhMC!krj7k{j`N$W)O>=sJv
zUHI6KmNrOYH@uMg)yA`>Iql|WIt;kcOq4Ng<2MgY$<UumFR{r$+07_I%WP}R_>qFY
zHEh0r>$&5e$xxjsh@92)J@Z5l|6IxZm!21lzu`EX1;?0~pOVE%pFPx=1zkvjkvDu(
zveAW;v6Ry=@3Lc<au}quS*>!u66Fx2rjU)K0Z3DcL(QlTyhs;wvTSl^ZgVn)a_@_B
z(}r`W-sUpur*aGDLG<$YTT%s6^D3J2L`l;mLNnPzQ#jGh<dnU|N%I?v^B;%vuZ8mC
z-1Eul3%)1iD=QZe2Nx__7f6-BJXH#!_Y0N>3nZ8e@vREi6beN{3$X_ZH;W2|4hk{p
zi*`_o_?3%LgNyd9i+D<k5O<1>28$TcAy9aE$SDJa-WEcSTo_agIS+xnIDp*I6<?tg
zlPMS91Qp-x=4;p%6O<HRB9&awl_U>B{FO>hgGx+?ifMC7P=F;q`y~f-r8y|2UP`6r
zz|s%k()`_G{E^aUkWvS<GMW8S9ObeShB7^H8409JXSl4~x(o}wTw}jXTd7>ard%Cd
zUdvF9K2lBxDOX0T5T>t?Q>sw0sgMR&us|xrhb!ojD(UDd#dj)1lq&UYDh0un0+33+
z;mYgnN@lbwXQnC!r7E$#a+J_2rM@ajV3pZk6(((UFj}>VVzs<gwI!t5dZ^lFui6f^
z#-6dpQL*L&u*L;c;|i(yJOr(A->dONt@UQC^--+#1J(wBYJ(uPAw#v`z1lF;x(LR)
zD8;%MU|k%jE&)=PG*p+eSC@ubpTSt4rC6T>tj`107eMNZhU$y=>Pt}@${8Cf6&tF7
z4Yi<#dPqa#P($-xLn~@yJ7Z&~Vq-V3u@}_X4{016Y8>8c{EFH%#@IBW*fa%fngKO^
zgEV~~YFgN9T0(7JW^7(nY+eU8Z-Sb)A<er(&HH=Jho~*bj4h{%EkA)R7oe6aNXxIG
zmfO9Sd(_rP#?~jrRydnh1aK=-aVyGjE82c523i{yQyY#_8=g(uGjQAU;x?k;Hj@1|
zGPL#=Ozkg~+Nm~e+G)V;bj4LraJ3SooeiyngQ<f{se@;@{b9d7-ljupxWsIrLvg=j
z4XIO&sT0Gt6E(E+WlqPvT<0rr$JKDB98Fhqapy0)F6_`QVyQ0l-Y&Gwu3WUP6SQvV
zZl|G5w=uZew7A=BxZ7gC+X}4*$kb!2)bpOHdsnGj-Kyu~aL=dx9(3|vZqZ&|!(M)`
zUcvNU;fF+)sb2AiUP<ykY0*Ae!#;VhKE?Dt<+eW6AARZ%eVXL`TB7|@s(G)y`gPO$
z_1pRlfAkwa^qc<Z)gd3SFdVS*8UUsb*kbl$;r(S~1NWDa&F@6lhu?`VSR!h4bhM|Z
zM_*t6Uo7YO=XCzez(1V<SfcB{ZK3rd&i+q{t{0y$qiYKOmgv%R_Ek&$8((%;4o=eh
zFTU)nSV<)E-+Wo^LZz(VeA$Cx2<*$&^2i&ixe6Fx*8a}*H(%B|QSCQhHp*^wBtzx%
zyB{rX7bESZjg=<VUQg&0s(hU5y`V5s_0cA-@%~5}6?rswSfY!J#e8K{D0gQ(Tju2h
zYs*LAbfLDne0htj#ax9sO)y*QwaH?G%VvLh>o0?qj(|KQ_BJ=&je$5jxr(;i*E{2R
zGFY%>qWXJtwZH0wBwIgMv2?;#j*@<9yDi?HD78-g((ajiy!v&Q#HYhM_3HG{C&j1p
zDem!+AzKj+8<;JRL;*3CLu22gl*JNfT$jdE2j)mUH-^Ac=MKPkAr#7}W+3cH#aw^-
zOrU8fGy0HO7_=QV?+f=h&?JI?B*Z-O<aj90LmUb;j+PEpu!vcC0k-(0%&un?r!J3T
z89%0`Wa+G9tY?_0k349Z)b5RD<zN=6XOLnw5NwqSb04&_b?DI3Pj?QMx6a5|2Jc#V
zoVe>{eNjgSX2)PD1I>deQgw4fDF%Rf0b=O;Cb8;^ZwnH4f@}(1?ML<vGr!#FKyn-8
zY>RC&LJ#yxDui`Pp%uYMc4bCm%7;1)E2(cPT6FsDD)-zG%bYr~4_{Xg)G)lSX`%XB
z_G(-lW3^^_gwVcT+$fCAd)A>ewP9rk(V^+aRiy&BnMtPIa&T_#(3)P2;i!B*j<MEy
zt*_(QL3{j_!|w)qnA{2PBkR<SiX6^qhQi_Xsu!CF;?(CarCKdZXo9)kM|zm>VGzq3
zlRJn!N;PSSo+i+Fgg9}u#(<?$RCAQuWzTsGIK^5!&T%nXGr@#lUo%Pb46A191x<PN
zG!c(l^$ecOan&q_c0|=TBy+Z^xhLnb%I~-S_LcJ&u~?N0$GPPdi@P;y6-(<q$K^kk
zrX$LiziqIULsurw$I4cR;T_7>dhxN#*4wEoN;ew0)k`<4rB6z>O0^<OwhPSIOLnrH
z$BTDU{2hw-;$pFj_akyEAO|5e>X1Xfo|B>@&*{jbW7iG#q7%pS@xoIZc*nvsb9|h_
zpGMS`1?O+MH3}|XNuTCls%S;!U&)zq<X=lTPvrd)@^{R;;fck`yJgF*%)Mi%(a620
z>N(AMAe*ktc_i9+S|1ZkD|iZgdWQFO$B+mRAM&LmrG)Fw>q2ry^26|_3?<!@JlCx9
z*NIv4<88{tFpFj;C)Y$Z+UmwpwhVlddKaz?>@lyd3K}s(!(7Pid7O=w=SZijbB6TV
z3|ECfp_^2=wRC+{&W9oL7L@pLH(k`+cnkt<8U&78eGKCkp%>k`ktM)>*ALZUC;HUH
zQaAlv)1~27ZArv4dp&$LT)~dCd1RYSy+YGdA)mcM30G?eDRQ`?knd?IpIHq`QA|av
z>~DGypwUWEPg94BYS4yk4Jl|@#BO%y$1vL{g@34tBV(auw9FkojptU%BDWmUDprmK
z*CenD6@0Q7rq$`uvTSIx{AygR!gsA@*!)l+3AA}(CeD=H!&~?<o{7!^8k;iiXO)n?
zpkl*32)q0X*{f~H9UPR>8ZYUqyU<iVc!1N(d5aupN$5Y8#Ab{+?=r3{(YyP{W;Q^(
zcT<iQl)UxBvJx+gQUQ00ek}vp_SB5jcz0|;q_H_p&U=(pwxprsO1Zvuj4hn03K5Io
zyw8`6K-pA==;@gJpWHU&uSOUWI${cv{r0mAN90ou!U}EbinE<;<ujBAih?%wiT#8*
zbNpi<AZ}Ztm=WSacI9H7kIcQ<ce2I8p(Uzy%<t+*nab#6N}pep;B_lARb$7LeUUmW
z7)6(@_XsZ+`&e4IRwC29(O;2~dx-hdgS)*ax-$FR4g-#bs3%gnik_Es6!%`LKQ*+P
z_#-P8m4Vc7VQ39@-TQIQR>`rN&|1XH_qgs%qcNcCH`&LlHW<nJ>E${)<>k-?y9C`u
zmVr;!jmLTpJ`GFRSD%2LZ2C@7{6F%af3_L4*LTip_yOVjY&%h||FM#Px$MnnyYI*P
zpE?_st6V?7Uu83Jo8VumOZaTRYj5DO+OX18|JmWR+`#LUf3@w~XUAX1249{UR=ch~
zJ3X-(`r-(z^*wj{fZ|~2|FUsyh|kR#r@}ChLtuUMjhhS6iD9rr<NBnl+sBveMj#D=
zjoAb@R|W^8P?N@u`Fgic92G|4jslxMzPWuCI5CR!Y1~}9a&wblH;#@H*xGvT?ylfq
z9Glg+wa4e~p;2KRUn#JC^v2!u?TK+>XXEyntGky8yGindz|LiYySKH22{d)Jap$Jq
z{flFTN&2b4?!z~CpZsz*MJt0+5roMJ_|e)-fu3D@bdO0ACf*8wx1>D7*(B&oavqJ~
zKAN=fG=3{@Aww<@!`5R4Z~wA_xm`-@^Vv-H4yahJ$re9X_**F~H)$kv7z+{(C|7@1
z@s{yWf3xO$$BJbY9P-h-iTB_6W%;qg?BAzxEzLJxC)5-O+B1uL&QB$p*CMzdn_7$L
zE?-|YYUm!bCVGagS6nq+xjBe8EJf{SUbQSW*-LkN#{6=yXnQAiT6jqod8PibgHFgv
z`9$Q~le$GWPxF}?1^FzRgmT{@v6G*K*UU2x<$<5NACyeUXUJYE4?%*sovFWwPSc$#
zjo>VNP~`s+&!MnAjMsjiF>A;mfU+}+lHtNQ;FTy*xjlaM<H8xMy+N+=cuFPhqZV>|
zvWCRYbR5Z*rA~W_w$IMDyyhz#tM+YEoYwh4_3N6n$0MMIXZG8k>xS0HW2dOrAG_+m
zT9zJ9+$LIAevSX?xPLtL#c5kxuZZp@gPwsj+BS$LZU#i4KOH$lw-_{TM+~6n$rEjB
z&+-2sMEl0Z2Fy55Q&aPwDx5zD{F#A&u^IRy+W(05KcfAQX#XSH|A_WKqWzC(|No0<
zhqc|o7!}IO%Ku_|?9b`^nSp;g1Aj#OAJP6twEq$9e?<Eq(f&uY{}Ju~OGUc~OvwDT
z4(#vkF|c)`ur)WZMO6P(;ruz^&kX#F&A=bg{ztU`5$%6O`ybK%N3{PD?SDl3|5DM8
z^&1O~1i%3}!+n4cfys4PTRTj#Lm&{C9)q>YtgfzZZf?TXwZoRV!&m^Y1@W+z@t2pE
zFh;<SA3tDedDsen7!d%527vJj4-O9E;^Ol2^I>2_7$E=v@NPanhW%>x2F#@?A2)j+
z&!zo-2(|?PD5uTM9UrI79mBQ?cc8G$etLR(Vq#)KLPC6ed}?ay@$p<RKm!ULNK*#<
z{s|t~DTM9rKnH>|GBT2ql3-Ybl$4a@<mAQ0#oXLn7%U+RW;UIfnVp@Tlan(vG!#4l
zg}qOq24El<umgnxGzy`xmnhsBfI<s3Gys5L4L~qJDRpXh7oeErQMa3_1UqSs=D9T3
zbDs5k0EL9v!$Z&CA2n^O#yt&IeNadQ1jGI$<*?Cfx6Y%^1CW;1JifJc)a30A@SZ(5
z*s1l{+pG6Zo15I(f$j`^J31QJfgUt?DJ!RWM|;B_N>Bi7ZH;?19s(4Tr;`<v6aj~a
zvx=~f0()bP!h?g^qoZ%rdwYorfZeGiuZDx&-6;)##?H>9d(GAWbSFg#;N5iOQM(fy
ztT8Y!@GqvB|35z+m}vjcj-Bti$#{_m&SZRjV`<^ulNaCQgS*I{qj7%t2REd@^|T|B
zyfTddkt(b-5d+Z1Y2@Hpg#x7ur}7lzn1A=Q&jcuz36>Od0RbQ}1@y-_3p9c#v2yVj
zDh<DT+GoVkowQ9ciRCJpixFODf2SAWvQqmuH>BF~TmFi-a;^vj<94-$YlG1=Dw*k3
z<z`Kvawr>Gl6Or<vSq?39%r4`qg<Y?TDB$C{f0LP)EQox%hKv6IkmIkf^`?VV2<MN
zZ(Y=ziM_4LM0iimVDN@4whlxUxy)xm{^fXDrI)8`y)bx#Mn~K2#okP*$wWu{{jaml
zuUQ(M9gp`n7l*48ot=M&HxL5X{7~s(@CHo&y|n;bdB*iX0v+Ib5U~{`M;iX)-g*dS
zFyjV@HW9c1W-Nqkg#I1guo=!fcS8*j+<|OHieB$+MoA(wZAHrx+HA!r(id;Vs`Bq|
z#c5JANyfj{vDr@0wfYO*;Jy`a9L%%>gEzq3kPQ97e|JL?F1GqNHzX^e-88X1r|!Sp
zkdTBgIlKPd4GEIxjm=z~A2dg@pC3nfxAz+hZIhQ|mTH4zf3m-WgO&f=4XNa=7XbCc
z^0h6ko4b?AsGTc0EUg?aIjk&R87VB*`P9`NBTkw9+YPC;45td7U$SOg$F3Yl@r&jZ
z8XZst(D+Kr?zn04n)$aS5_5jz^BCX!Y6a|=uHSA*9PKi)_um2MD=;@CnVWejMbh`t
zd8jmjzBE1PWN1B@^niuaPJ-Q~LzpE}8GAGZ?j$EF6S*C2n>;#P_ir~O?h)y|!|wq4
zN|+mx^x2I+Cer5ohu)W4n35C7BA8s!Todm<er+d&St60$gQ|uEJ4^>+Xo=AJ;Qw+%
z(nDCU!BQ7|I|q2{0&_!>Jlpe|5d0K<fwBfA{~Uv(@L;}Ry?a~_Rik=DCRuPtiF94;
zg$Gx)ir3f$qM?S&I(<X%G3c2<q|7wO#kBbChGa((*g>jC#jl58x^lY@L8;!H5%DL7
zZ$+HMiyfpC={Q3@hS&6zBQ?Z3k1Wh%f7nfW?kb}Ym%#pTo>FRj6D2TFzPTvnBk7N7
zL;TRa0f_zq*C_C^w0v7|1GoFP8<O~)psaxradHNq@9kk;lstjctdBT$dC}xqH;og~
z)yKrz-t{350B82$M*-gDM|FkEnJmPmko53CHg`Nj6Uve<5E}oOO;c%lBq6GFP<N>V
zip5goYe~Pq+>k!zpyyr%3#Q9|VGYm07{m=?+p7wKGS9~}K#BNB$nAUq#FXeoM2*k*
zCl!PqatN$%Qnqi@I1xZ*n75ipqN+awBuifW^0ne2na4J!04?FW=li2K{dPmzBr9f&
zxk;f5a}LZS@5>GrZQ%k5lWs)zB*|uB;l6WeP1&B-_2;{WM0^RiK!WI!|DeT*bw})@
zM#oc<tN`muIxis;FLau7m3b<p8_9tnG(;9_e_^5D?ZYQ6pG8)r(~&i0kFbt%Be3ti
zWWfT-(te8iOxBdbjIpCgv3;I2>1D}QI-fd(xt3Br8^C-)3DQHpaF;vp+87$@8_vLw
zn7)s};OrXzWR{KjJjI{j$MCq#+=q|m&}MqEeI;b~liG|`M9NvGx-PSlDtmHG+Njj#
zJlB&rTyF^KbEuHoBJDsb_G1y%HRqI%8D%yQo=$41isn@;r@|_ab&uw4ZNME61s_zb
zYOSoDa?+LfiJVN;j(LX9w;M||Vjp|9Q2G@iH*jDSkES${CinnYBo%R>#)8W4HGp2i
zC)Y<wO7({Gn!{n!E^VSrVZbltOm`~n2S$gff7Jm9<r%2da98<l^EseM$8`j-rvJ9t
zLkh!s&(6?YQ(nd++*i>%Z3q>OyU))Qn~pOZ0R<h<fqq@{nQi4wG($?e@iq1*MMSH1
zVMQLDKu={Xv|rTUgA%0KX*Zrhb0VFce1F3mn(FPb&q5R7Cixq?upF=v<*Tw^Jg-K>
zq=L(yYkETw{kbFW$T2`=dHK4~G5#l;Yoo!^y8knE7DnIS@P_lq&q(ZtUjaRKE7vWb
zkzCCxJ$J)ajE6sWT+*?n>1O*v?|yXxt~oHKzb3(*33Q>Vb7CBPTtgIb>uR^H3V2zz
z%2(e7ARey@7D!(w#1&*iXyOb}P~9M$RqCTvuMY7H+8`)x>H*sNAy}zyk}f3=up}mi
zJC1Hrq$R71oK#1<sHWm#+z#<Te=?9f_|l8q4r_km4lL;RXEeAS!O`W+C<(V@)o30v
zJgG@~=S5Fl)&&n#uZ5<5fA9AkcU{{l@*;P1bVvC6!kBArZN~ADmC*g|MB4O4=B+9s
z_wN2ANWCt1lXhB8<ZdcDvMzy?ZC}~oZaR4muYhN4U)^(2Jq=n1QBXVJJRX*ZsMnXg
z9Xrrzz57-b=?ZrGc%Zd(H`f%5pKP0PXncS7U1ISnQX1>Xj7(&vXYR5(Y3xXYK}4a?
zp`otGsK|OIb#Z?DI;R}V7if3Cw5C2&pYY<uIn7h`$Mtpd_puX>2(rcF$i}wq%M*`@
z`;{APt(J?i(=QjmRVcP#Cmj2k|JSrNWR06<yo$46pR{%CsGB+}_Mf3I(>4evnku;}
zenu{(Zc^Yh*FulW9b(cRrYI$vN9Z!n6I#8d*nFBtF9<GDmeSSvI-AD@1`adsAJm1O
znkV}SE_2AdRpcaErWw@E3q;ygm3&%elL)Sg4VD$(bhgZ0Enk*<8htl<YMC#lxUNon
zacC*gy4bvO{I2rx`2DF6tf$?fc_!mTuk(K9qT*M<Mf<73lgL^K`%U*#+gb3c(8e>L
zi+-LjJCQyQUuigQ6SO<d89GIG<SK5*JlifZzYFfkIR2c9Gu|kaXz$go^a!f$xI*?3
zJ3?Z=U$}3*Zg}ao=%R76d;vY{cxvAW;CL8#)_D^xA$|_CquVy<xE-Gmz08}q-PeA)
znCtA=tA$oRPP=s8L!QKM-f}>Hwst)1M2X$aXxv}bK3$*qbe=4!JKVm_f}S-zJswv)
zg>QB|eZBSp0N=w4`gZB~A~${bndEyI?28Gq!@lu-+31T;>;Qu|<bCoZ7IeO`b|jns
z@`Bj^C9xB!p#PA(AHCoQ#$^979e-9`8}=Lj7{UN<kTZ*JK)-x|AOtAf6abnF5La{&
zAP#Is4wOZ;m2nGvM(j^l6bP3LgE#oW;0@$MKCf?_wB3TztpfFLM0MtaW(R^y-RR8(
zgEf<atcIL{$-&V&!S8{#b~nMCL?O<}KnL9rMTHPI#z57k5H?827f_%#F^C8S6gUKg
z2D^bAokK#2>B8qh8t0(sdD>V(u!R695!DZz47Sn&r|&r=-+=RXz`2UF`MROf&Y=)g
z+LESF@#)Zt8%J6OyE@&l2Dh-L<gk`xTMFW^yuC0v)bLcsa23VyPGI;TC_HyAaO5VS
z^(K6hIAU5bVpf-i%sFB{IbyLX;>Uc%%1y)?aU`Br#FlR4j$7m&qup3j_~DS>aZ}Lg
zyv-<a)Hf@pFVxKbxlFzdQBnBJH-d}_(hSg>s6aEu2e)V+{%AzK=wKcCW_Z@p9+v6z
zXxs(n9()D@y%;RY7`en4(&iYf1zJ@;+FgJ4Q7!gqtyubf)_G^zl^!+@A*hgMZY&EJ
zz^G>d<2Ufz0IOugWw~Re{kcfAIS6Ukq=n*t;d6@N3n6y#7sVTv(bB3X&?tc8(KO@b
zbP{yj6D%5d5U(WV;Nzuoc~#=L6=~Qk^b%RLc?v9bMR|1CpVMlCX>5uUah($7bdo-~
zCvgr43sLjEmeG^;7x2&H^W?#O^UWYoFWFE=a7O#JBZAI8ZGy%uP1tZUhEwv7S9os&
z<&wZDDGNz(mo%Zhf+JUgn$LvRHguADMT=xa;qipszY&aVruNnf(@5%7Ac)j#3bwlF
z4kw6oE{K?dX}ZnRG7(scK8TvWQyT=QXCj!}e4|mc5Sz~vE2ZORg32kD>51d>N}U8C
zo$;ipa!IVZOWfv3Jn%?E1Jd9v6p?sSB{td7XERk0x#JV0R*S_6`iQ{`dUq+}WV2ES
zN>*cX;tc&XyB}FqWYyo(%4y5W@W*TC=gD#P$%tRdWL_GU$togSa*oL=v+^YYOmlGW
zq~m3u6I}_=A4nT+$&r%Anh|he-z62g>h96TX@iww2^2nV5fY?oh%zg9&MJJV%ZZ=K
zk^g8o7^KLJ20$<1`5~PvvzX_C$da)2f|XP$wNFWbG?wuVC-vg%&f09HeC4iv)hPnC
zYsCDmW`ggRDy_3Borqf4ysCM(IgCN7BfKJ`uTyMW3MXH`f=0em$_P@c%2%uHRa-$U
z6y{M!kyEx3E|iRYb%LmYxTbMATbN2Gk=UZ~$g4qNS@cDz5IwJmE<uxfEe_K{K>WP;
z2=NuZ+$-IZ+zckRszr6OZ?6cD%qb<cgw3>$Ny^sD3i<A6bf3TB<$LpM)?ip!TO8@N
z6yIx+*w^wwCEJMcw0C7Aw%S!2SwypXKS;Ip``^qQlrjNyYAj!0=;;WC>Tm<t?Y`;M
zB+w+f>bWN9jWJ97(tqpoT-RSt*B<=3tGMW8m9EO7E+Ud%Y*3cSbmfik+m!nBbW1f{
zmbck-`fw^%-pT+-0Z++uuCi_YVl;#J&A6F<qee@kdk?4rQ)x}}wvlL0{QJD3v3f&*
zg-HBN{8T*+2SzPQSB;{t(eOpBBw1Y~DgCb?ldU%<(=~OfcE)FN44P#1NNaU+I`ul9
z^-70y`26plt}Hn&>P^W^^$8g)3>wfW8*<;7+LoFcEzz;<n32j`aPTyK{Q6EAnZYfs
z5!tlSeyQ=xedC9(bW*_<e8^2mpPE3P=AQTT;Y&@}*-hE+EMgCvf?Da`(OYQ@G$1uJ
zr;}M)V=!cswdh^HTX@q_m}Z$$O6SiHw3)L;6>1GRZ>egva+7Ch@NBJ7Y3(2bT7PPN
zpV+D*AC=4>HGsh|l-A}@(>8i<G+`Hznix52&^`zCY~N`DPho_bG_{98+E?sC*T_1G
z1v|FBhVFQFR3>*Eu!QBzcZlwOI=gQ_73rkv@3>a+Sx)Pe4e7kb2<t=b>S65aQtavg
zc2$GADj;2@LtT))t^(BVT*mG!#qM-qcM7OG5z-wu)E&Lo9f8^t%GeX4*b@ls@dNdI
zf%JF|^|<ZzxT5wtGxj<v_Pz)9+JJhkAid^8y{3D;MyP%IjD2qv`(6Y4UV-}5A$`h2
zeF}ShvZ(!1jQ!$@{UX4AK~O&*q@R1JpJT6|6?K4#ae!WNfCf155;Q;t86X}Sc)mA)
zk2;9MIEbk@hz1-)1`Q%W1_48ZkGq4=JCvbohM{wXp;POjqmZHfqM@C^q0QZ)HI(6H
zhT%np;qTVNvmwJ%MZ@ER!(VrYhfqfP8Af^(MmnuW+CoN}i$)p-M{0LRs!+a`Gkh&k
z_*!KBH9zEQPSMxQ!LMn%Uz1Tr6BtHg6-J}1N5ex#!9}CNgQEevqrNC(-V9?N3S*zG
z$J};1FT%!L2FILs#~e|{?HI;w6~?Wt$E`xf&5Op(2FFcy$Bj`Y3>YT#6(-(VPw0e9
zXctXr4NiC#jh!7%s54A{L76;OnN$v$^s}BkNOPFKpTvDJh2L)5KGZp8H{}nS0zsz8
z#-=V0r--noso17_xu@v8rx`P#(@fNntjp8vkJFqlX1K*>c#US3A=82xGs0q1w974G
zSf3=kJEhcuWz=Tj-J>vyqdLDvp{LB|pAR*i$5i;YoNvawbcaF0=*-Y)g~03rx7<cX
zacm^Rhuk7%%(MoNH2NuAy0_eR_6f>LbL0r=*dpBiLW!O>iLbpCJerf<GkvGz)%3Ob
zu5g~>?~+_iQt{bhK6yV`?~x|<8%=?GEu^_9)}^KkA!8VvtUxK;ewCg&1{g<}7vs*5
zeIxcgPD~;$!yZ9gWibPQn|)6LM?g!kL6WcWE)zd6lLGNu@H1&t;W9C^LM+lGI*(jo
zSp~k2D&{k}BC|3kTT5Ed6nF}iJoazZ)(Nt<h!7#I0-d|O3=f5sM|rtLr3h6%vs86#
zkzycef}lUdpINPKyV!X|rFK&#f_Yh%THXG6aldlS;$wcookns=@kw9tsG4x|qI%B3
ztCy}T66d9K{i;37i_8hjgLhiXBif?}h2te<Q;Toz+BNr?;~e@cEE0IE`n6_+DyzJ!
z@k%Qx#w%~`D)aa@ED366@-}JGmhH`Js_g52^w;p5)F@yWa^KH?$gRH#s^{q4(h;f8
zf26m;XvoAcdjoCAGZ<#zZ*pz@Zcft_a1Wy+nI(mpo2m=Pc<xwa4y!h_sD0XQFK8)k
z-L|Y~?Ph7SzqW#^j77DU?)H^#$wfE>d<hOx-wRpk1Y?KHw9Z6A_oBaqVS0C<+kZ@0
z@w{r?yG-0q9j8rV|CojCmA<mCjDH|*eb6g#kk3vRr``dnaH(|gD(N@?3LMt4cQkxC
z+)g`eiR@@wIXt{S>^kYV7dh%MJ{q7n8p=HCWA7X_rmc2xnacF)fga7UyL=z_`Zj*F
zaN@iS^;*h2TCH&2WcOZoINEk_-tX`khaSn)oKT^h&VN4XWj}pkeY&J@+7)>U{eH0i
z^>n4^v>p5Gxx(2x!&!^N8D7!ZR>)c7_!$<;&)wa#I`*Gv);|vvewIf5L>l}_*>rRw
z?m+qSoI(TY4?St8!|@^2IAB_JWRvirIX&UXa^#6}<nwV9kZ=_8aboCf7kTL@vFac-
z;UKf>EB3NouG2~3sZGhzLCwTL!_iM=qU{xq!<(oemeu{YmG%Z%_C`_mCNG1vv)bNO
z`s-EhTXNXjJcU?y?%7SecYF%8&)WN70&?-$bJg%QcWiUd3h>m3^7irdc^T#RWEWKF
z``KhKWYsS0WjI)3FG3=m%keniDKf^#E~zsxZsIs$H8RD-Hp?eGjpHPvGct!GD9U8E
zXd<#$Vz$&I=$PVskmA0k@~F<_e$3dX$??9W^S(LDr(>0-^3<l6BdTCEydNj3{N?Ph
zkN?+}r<pOIw!zBqDIc3}jyB(M0%oGZ7b=4%R%eza0+t-Z*H?o#Uv}+EbnTmT9r|<~
zXLX%+cKuxKswLjP_IbK7p?Ut|p?lz|{^SV&C%Go+kAOrVo2<Dm9gOutJdpU+hHU6_
zHsikJSDW&YFW|^8iM6&AW9if~WmB{)rJ`AkIs!?wcT`hf7|ivhXz!|LiqWlHlDyv2
z%#{;DmrQ-VuT`j)As$5f=HPY7n{wm+)HjDZ6-Mn}kka@l|H4j712O@um;e<35RL^t
z<bRktMuZ0-A;V!4VZEdwWo2b%<YZ-K`+Kmnv2(C<adC0~=iuSt;pOG!<KyG!=Mxm*
z6B6VX77`E^5)={=68?LL{1u|2qGJCL;{Om5e}%Y&gqWnHh>VP&yga{x0*|sXuZjwv
zs;Yppvaphpn1X`1oSdYL3=Agyw~+jM{B8FiA=EG=H4IDr9|N}gdq^rs38>1jYs)hk
zsnJ_$Q#-t+{P>p4Q<unB?^&=RL73_DSPQ}=D}qehXAno+s*iXr?zjVfxU*oqACY(~
z(RdrNc>9UCC#krXnYcGOxW967FADHZtDhY=5^Og<U#KH&t0ygLd;xB!G3aMj=w}lf
z=HMRX`upJKhM~UyUyXmne*c&4|KSU=42Upv%h0wfQMag3Rclcf>(FEy(!`m)1ly4W
zJCTDvk%7I)!h=Yn!-!&|2;$@MlalaKQ*kpg@N#o;3JS1GO0X&_Fl%Zs>+3O^n=x8j
ze~-2{jP`bnjt=y$F7&=Ww4ouC(NW~dN#vOsq`5i7#YKdb6@-lq_{~lD?QQs-9k{(c
zxWhxZ<72p!6Ts;y0A`^2xAF5Q05;Cge~-&c!1XoY*Dt`$4dCt$aDNYYcmO;;{+|Qx
z@e%&<5$W*}_2B{g;eqJkf%g7h`2POQ-JQ$bUG)8Z&BH_2!^7m`<0=#it6UWQci8D4
zL)CeMf5%P_Ffe8%8<OB}OC@1z(|hI0f|U~yElJz-aIG{lh5SzHz}mSJ**LD!`QW}_
zELvHWX#!y<+i$6_<+$HyJqN#~6;1Gp@OWM(S!g``$<nVUc(PnzDz{Jn)q8EohvN;g
zQUT`0cI`|rzE&6HP$EOm!id(J%{f2s-bim2{?n}xW#eR2ICxpqXAT?`<@(<^F?yo)
zk|o2PgTc=O6;Q^RJ=dRor`B~E6YaS`om12WoxL|ho>-!ht@<=}Tl>>rSvT7z4hiie
zA(cEaQ8@KI1{te5^yMIHTdhkxe~V}EvIh?;-jQQ#2u@<7W1pD)dv~54B+V_Vs-zTD
zIQqhPx$|u+ZKvK023_~vgv1}tCvrp4_$=?UgUQK9at2WOZ-Ty=c(BpWzh!<*Nc{3p
z@A?D7yz6H_rgD{AumkP5E75ECgdy`NKB|vosMbSMCQkZo-Be_HRneJ5PEL>klnJq)
zJt($AH$4et%1U&a%E?a1aXA@CdE~0&zJX}w*(q{__7Fc^Fm=iE`IHwWa6OnjAWhm3
zbKe_yRHL4CBp?s&NKQ_Fb@W!O8vUm^Or^+b|9oxA7$h?JT;D#-G*WQ#TMaz9I5ii%
zH_r-%==8T@pp26H1*z5Y`|C-c&5G%g+&4<16O_1{{ZO1D{d#Qq3U>3YhQXZvXyd}I
z?;Th8ETx^(Bf4~A%}leG)rbf7`fWI9-GkAx#vA>$S)6tjY`P;j;jNp$6{R|eEKvFr
z`%*OQlMoqZBgZj1dBUN+_d-o9btVq&K}862l8UuW_O(eiw|cchpq$;sk;fX?B2P%;
z27t#H#YU0-u$QxDrp}Sgg^Wy`YzLp_2>bvSZ!Rf9k46M~w}(#iK+c=@ge+P$F!*X@
zwcyP{bU&$c{!cgznlqLVVtP}1;}43!VE@$AZbHNFWypn<a|6P6!Ne#Gm|5MZETR@M
z*fOKR&^`i#He7saR<UbLj<TwrFON#g$fWeNO2|d_@jpMs13_nyH2Q}ny0{$Yn*l<w
zE9;3PQs)PG2VM4q{#qaYBP4W|aIWUV%*=&VAH{H7b7IFdU;iV0+TDIKW8C2_E3>T!
z=`8EE?)x020AHzrIVpPjly~kA$fP!IxIM&n5U%r18o}}65Gp|=2G?&g*YFs!=F!2V
z)DNvSD7LD4`_|W|Swdviu=_!vg6LCxp_Zmd*zBAyvVa>EVwyApc^{?!<K@9;XTe@;
zM#4<~Wp;+<rRAlq1g@=ZRzx~Xsq?xjQ3;_aw<m<;OUN&lBAZDzMl^$h2P8>c+F?y7
z#XO)h`I5pxjuPHxjl5{hiXDge$Uy8oIfuQ<FEwSH=T;<lvW*fx<rO9T*o;5wVjpsL
z&`)m)-Zi~wT$YVDp@FLCIE|dq61Z*I5tU@-<H1RTtnPmB)PU^OvZU$=@JWzylO*YQ
zbnwrsvk>qW35Mi1<m;<^dBz*S%ddl3-v}a<yhJf`W~=-(v6+2{hLXv%=!=&qs}i&j
zOi8D!cmx99`P0n%lPXHWxzH&X5<oUFb)yG1t74)YF{NId4k<kBgH!rs{3z;iN4iMR
zqy1IMMzj0sb%e)sIrdhUBqe#*T+4wrf@X*}H<ei7rU(}<8>m?O)z}L>zQ#}|8N$dt
zI6yEZB5{)>V$GT)E?`0r6%l6<75_!RhcHPJnjf88MZuQ|VG^mdE90PFtmt(om;{QZ
zQ5A!{LwzS$ddZgJ+9iEFH)r-QiMu;R6Ec&oERcbcai~9<WysdTQ~O+|8EU%}a-gia
z>xh)-ZMP$k$FQidtsPWu5>3uRDoI^^1QO@Mv^`c{K5XwLr*rEm<yUoO#M_(lZ>`~@
zKB4AQdk<qY2`NSz5u|S%rM&a~-oraT<N7qBhPu(*8>Yk+^M*GG_bIg-2X!>l>;`bw
z!=nuW&~qxzM-fK~Dr{Ox<pM-YvDlfB#VM*&UJ}Ql!ly{#)kT@p@<F$h{A`738!ijP
zF!cB}WXUjX@UhvC_cg+719I?x#nDP0sHTi47s2C#9i0&P);WXMhtRcB{VeW2$`W=1
z6KfrNeR-yYYj1Pv>-t34eu_pfwpU+&tYiysZeSt&_PWH*-Tv!)YfVGGeC;;+I3|Ek
zo+{tajBfCY<rmLcT3I!x5a==HP(5z>;hf(zTA#)1wxsFNJtioXd^BiG1P>lAYGZkM
zX)wE7r^gU-v(_e<jBkBjdO?3>h#@`p=HSpTeEApBK*SD{lFi7gLheY1S^}4ZqaQq`
z0A=+ZtEfi$$#BcJN@f5!Y=QTx7+(Z2XdSGQ!PXn11-fSM-g7~v0SryQB0gaL7*RL=
zUcbs0VPh<C@#6L_z7ywtsJ|`Y^5jRLFb?m9RZkqdXS3xyHp5aa^%kN+2O57Ix2{mL
z`7T~G-8O=XDuG1f!#MCS5*$=}`FCKpaGX0Np4Y-)M-PiIhwzG22h3UnX2U2)J9z6a
zT|VyHF9Bp@HhjoCY1H1*tVX2pyg(|%ANhHhMGBk`Y~0pK=gb|-+WRUKctL~O>u6#b
zJer=8vtF!M#ot)Jn_A|CRxZ9KWsDxd+(;bn%9}D=&kn{g1&kWpy!`-Q#NcisiO7bX
zl=IPC2DRqhzzi9J0EZ-8XXH8p%WM5q5EJu{g)UCVzN!Iet)_6(H!NAT4`cKKZ{#s&
z$LcZP)GINh*;&rH&A}Jt(@`N<u^FaX3m~kFLk?@XDaJ5lc@_!H1<xazYnst%SMSjW
zc^;1K_hd0QQRlm8c|VZ{zT_~<){zuwj(N2Ia6hRn?%<!`l7YycWZ;G4Ple?=q&d+-
zPKq2Z*w?k^;_z;BTa<RDUkDB9_9CN9+?tYj7$ncnO%4^lY(8}z!hC@9o1>JgFguZ5
z@K%To*}S1OP%BnePVOdJIScxwwxTi+d>mGK{);V8krlN2V?%ZFbAQge*uzq68NEqi
z8b6Tx3-npw^KD^SuB=zRZHD9w5${!PM$SsL#9Wb}ZTaoi-2vnNv7|a(KXIUea#bxS
z`%yL?hEuXvWuLv19G>3?S`3Jta*+k<v{s00Fz}eiQDdI-dHKU{_#p;wKJWQS5}Z$3
zM)lH)2cdn6q%($MtXh8%UX&OB-&su-%l|C+r;p^Pml*I=ti77hx6ekU$a&#kaPNx4
zHOaGU`+jvM9yasUd}r4*!@h&}lCX)wl<MUr{!13cm%Lp5E8WZ*gBGs>0@iX#X3Qw4
zt4K?#*?;Exm|Wpg>H1^!aN|q|9U=R=)cB9*s7X^3YE%<3aFghC6E(RIL8OU_a`8XC
zW3VSCb_N9-=g<VaL#VBXx5X!vI%gpdrjGtV0!^|YiCFiqO?qa_6%wt>z$8tSB+Kj@
zL*wNKN(Si#yJ@R!gQ9@U0e(a=ibSPmWEOZNAx)r22q-Cmpym}B<_F47X}mhrXFAj(
z4N1=%6v^6d@N0-)@V+LfrK0U}3(sPp-Fxe!B!yp371nhV2H(xltP?Tk_79Z{MP8Nw
z?iImESmomT5Ml2W-%eBH(R}0%gp|Aq{zNe9Qa9@RkO_eT++9=D!+aF1W&t3Hh8K!P
z6pB809gUh2jZPAMKmdnv8;wg6gX<oRuNOn;9s_lQdkH{Bo{XWmjiDror51{%)r+Nf
zk7Z1WWp0jTU5I7BjpZbP#&HY9!D<#X!!i6Ral*}Uq6=~2w{emr@zNx*f<p1~?(vE#
z@ygBds!DO>w*aGDWE@if?iw;y9?}avWb#<#7q>`S+zFb)R3?-0u$qOHdm@k|o*WI%
zYBI(~6B#)g+58sCuoy`TEkPduXA6M)Ae3kcNctp{U?Y?aD_8{UCCk|WG;fhShLa+0
zll1hEKQ1KL_$GxGBkQ^+r#7dgFQka*#p|ObMJOeBqNO08CB@kQKH8)t?x$4TrdE-p
zQKlpp=^^LcCOhe+6*s3QyQicurFD^{_qZpL7bBVDrg#^py1FMN3#B^ir6J=c_X=gq
z>Sfp}CFtx^X+!lA-lilNEF_q?r<mDfZ0Tk0pvBd>XC5?X9xcS}FJzvPWStkso(g4M
zyJubNW!*GqJ=kR4Eo1>mv%7Ay;PtbSOHvR$ve8?zEmN{#%xPTVcx=)f0{t8zp&Y{0
z9MZ*D;+7nWyBq<uTx#K5riC0@k6c3AT*j7MoRVDDyIkb|E4~v!?CPR0I-~t5qcnP>
z`H7=C3ZXW-qdt0`J^G_UTAe{Uq(&N?MS7%4`kG0)q)xh-P5Pu#N|;ePrB-T|ReGgb
zx|CVErCw^3UHYYB`jcTgre>;>WqPJ+I+JO-rf%wzZThBiTB37Wr(9~MczTp^nx}kf
z0DIb}c>1S+TBrVkI;e75sD|pMh?=Nsx~Pn5rjGikVj8KE>ZO!gsakrem};e(x~Wpy
zsh;Yjpc<-5I;x~<q^5eRLYk_o>Z7dMsyh0ruzI7iI;%5UtG4>0xSFdgx~sf;qQ3g8
zBO0v23ZleXtR8x-$f}{rx~wVctdH8P&>ErAI;|~gt%h2y*s7q~x~(zlt$o_9;2NOf
zI<7Tpu7QfKc3Q6LdY|mtuJie>@EV`;I<M_nulBm0_?oXk%CC*;uV=ci0BfBBJFwJQ
zum(Gv2%E4-%CMH|uv@yY5DS|UJF%`=u@>8z7@M(B%CVp7u}`|OAd8qIyQCspvT1p;
zC`+6xi~g!DJESW6vP~JYGJB^ryQ4IFvq*`PUa6fr%c5(!m&y6FC_0y1shmVxv`D+O
zNjsuOOPNheqCv}-&l$BM%Cq5VwZ^KoK+Cng>a{4EvtWy+V@sl*aJFchwrab!Y}>YO
z`?hc!w{knTbX&J}d$)L-w|cv`eA~Bv`?r7_xPm*lgj=|Vd$@?3xQe^DjN7=5`?!!B
zxsp4%lv}x$d%2jKxthDVoZGpc`?;VSx}rO}q+7bCd%CEbx~jXntlPS-`?|0jyRtjG
zv|GEjd%L)sySlr(yxY6J`@6s!yuv%Y#9O?^d%Vb-yvn=0%-g)q`@GN_z0y0q)LXsQ
z{(HUHo4wk*z1-Wq-uu1a8@}Q@zT{iJ=6k;Ao4)G1zU<q+?)$#*8^7{9zw}$b_Itnh
zo4@+Izx><3{`<cG9KZrRzyw^t27JH>oWKgazzp2L4*b9n9KjMi!4zD<7JR`NoWUBr
z!5rMd9t^w07{Vev!X#Y6CVavuoWd%+!YtgvF6@RG0gWg;hb~ORFMPu|oQXP?6kCWO
zO%Wo}xD=Gw5Ocwcf{}ofafw_u6+w)OcG49{T!|v`iYGC|Ief*K)h<wk6hDz7HZTj|
z;0tQ>jIuExAFwh`hm1239AjgK`SF1U(J{~f4NH|1J{1Bk0w8TMO!z?>m@xzXD}XF?
zhXQk4$5FExc`Si=Y!<XQ5vdo*eT>C9j3K?y4%FZSq2VK<2#2W$#=dYVYZx1L;S{JL
z7`R{#?a&U@-~*O*8JdiTQ@jGnu*wf;#by!$p3IE7Gsh$FT44eW?SKrm1_I9z%qB1k
z;-CyPLMM6g#L@8qw*U^ez-|Ju%h1rvF$c`T+!Vwd%&?({j65PVY{SC`&C*QGlH9^b
z5CYH84c%}H*@iXq0)(kIfuFG@VB8D+H_r-EU&C?6Tg)*iFbmya3>$zl*P=3DBhU2W
zB;e5&HE~BP00PEv$sYh4ItW6ioXYx~Hh}XC&j51+vChSO$!u{8<<R~P#_$=Mwj~MO
z87y;u>|w{gkjmw73oJktA05)KMbeh+11Fu*#-JVQ@g6VG6vuMZhS3&b^BOv)Y&G2u
zH=Wbze8W}(#=kHP&tOr$01mx?%I(k#V*|#i+z!z20mtmsu;T;OkjmgN3xH?>w*c0v
z%*wO}#>Wr>EC9y9(AH+XGF|=E?O+bK;5)O7$uH2=vk=v(tPCu`)~g&}R`LP)Y{&$$
z(;{8X>>Lf#&<i2(0ngA31q}k8Jka3K*QpE*A;2edoebNS8XFMJIIYtn0MePADVyEd
zpB>r-{TaaQ*0W&Rt84-w01e_m3op>xuiYao5ZlsB)m81n9sbh`muw7g%@&n>$rNx5
zZ@mJu01ZAs0bq;_xa`#<z}C+YFx)*0BQV#!Kyej~$#L-lcnu$5OxPFT-XM_OK5zl+
z4FbqO%P64O7+?(3-~$&u1CVXk(Ba))9aq&{+dO^Q?EDPGaLKcP4ZP3|$3WR$Eduv_
z3;AshpPbz0;Mz*aMzRgvmo4G9P0|*Q;Tq22c<c<f@I}wC%BFn`6wnLZZQ>}d7$~sf
zO&r}Jd>cMM4aaZ+`TQ(CJ_`gQ+lKQ2RYeTX-~ss@0<!%q`Md$p@C+M3+{bXqWpW$!
zz1LnHQ%Q~t9`NMO(&c0B19$Y~9}wrKfk`$6Gx-eR{+Z(9JuTt101muh49`Fd9PZ(s
zozH4c4am?IWwXN^!vaKZ5SabvARXv~Ug#VySXE^U*Z|ie@YTHF)#%dHGkqPCZsaQ*
z9nowHM+DLy5bE7M<kCDZb6wUL?$!Hk(pT~f$dKg6pd2F*=Vd+vXP(bp1MC~{<l(XA
z7!c=k{?;H6=T)+YTDa#P?dL5H(h*<`-5||)jp!gw>W{7D7Q<yPA?eRe+qP}#&(Q7P
zehYY=9c*3JQ_TVxP|U=z0S1KbJE88gt?DZbILA=dHhl~GecdY{+aG`oVJ%P>?gRO}
z>p<P>zfKLk@EamP?DJjU4ldR&pzO?E?#S@|>?UmjPY&RhT<ws4CzYM;?Y`~LfB|4U
z^WmP);|}t`e(qGv+$#?A6F$-sPV?Yk^Wbm{9x&I>ppUj7&E%Kw?J)EG-t&?E^8%m3
zNKOsLKmk>R*BHR;3op$c01d`)0n!uSS-$0I-3!1D0+|%wWlrBmPfnE`@=Ct!Z+$I_
z9_PLB<RL)aK%Ijwb89{F@x3e*l`iuiAOgd13*+A5IA8ZWKUz-x7Ah{yo<ix`F7zP1
z_>KSg8{i8T?c9Ye>%3qNz2I7=zQf!h+nIm$CmbEVK-g3W+L!#~@5AuWaLFT{>%MT_
z)sWu)E$ztg)<jR{;4;t!9p<GS^40!;40t~a0Rs)IJOZ;X;$ZyN)=$_T0Ei1N*@HsR
zy>QU1lK3M%0&}b!TY~1tK-ytE?!IssY>f=Rq1>zz9ZCPr9}vkA9`om){s8epAd6Yx
zj(zZD?$!k#)D(iaWv&;6V+vQih?tCpk|`ZKDq-Q_R<~OpUU2l7QsqjPEnU8Z8B^v=
znjS$ytL9^d5+y4V-tq-*)(ni`Zkg~=tzEln%W@X<#ezlBr9x4#0D-J(Gip9;Jel$Y
z2`+O>pMvxC!bZ|$A9^h{>x0D%5n9`U6DD*82xv={O|6y_NlLL~;kNVjH6;=e&z^}G
zY!d}EXef~Iv{5jb38*Nbs{UnrG2=$UHhdj6hYJZ<kBl8dPN`&a<;zMkgWDX!uDQIo
z3PJ;cw3<*BqfvHzVj8t-)-|0!haO!zOR+0Z%m6Evg$WkccPe>-LhXwYAV7o=VS=c5
zp5#M-5V6q)iVYYpL@)+zMC2*pMSKWuy_0N10fiBI5efqkMmQ-s6y8H`gq>zE0X-Iw
zm=6WT2%BMq4>tHfgp*Wq?J@qsLSls#Rzr@$6>JFa1tex*kH8C&c)^4foBQa6|3H+G
z$0<sL&7<meY*9xWXoOIN5m*TCIvh<f!G<Z3jLpXnKL~O<FTVscOyqdtk<2HQVC~H8
zkYJNdG}T0|&DD~_{-qfTE`W+OBQdn$O*F@x55ZYhn1RKxl#uh!Gu?dR%s*EW%LYj=
zTM3B~DBDjZM|s>7PB;%$luVWomDEZhhrCq36G7$FOhn~u)XYs;9hFa0#l$sNU3U!&
zrbdyo;TCezA-0$OPW`o|CtmPnn^`v0^i<~>m9{?=97EwaUR|QLCE2jmwx(pi>~>po
z&wXx5f!1ZWU3cGw_uUmns1Jh;Lbxhkedi4hN`3zYSYH+%#Mj?|4@UUkfkP-bVTT`v
zIAVz>rug6)Z1~^;3O44rV~;-uIb@I{Ai3lSL`Hezl2c~6Wt2^JIcAwzhIwY2Z^k)i
zop<K>;|o6iFd%55hbFpcqmM>9X{DEDx@o7MhB|7gr>44UtFOj7Ypu8Dx@)h$20LuA
z$0oaMv(H95ZMD~CyKSLqfhK~Wb=anza%eGt?xmVBAOdNYl16T~2PeF6!w)aJnRWsX
zx*1#ysM7#ie#!e9T67?$abXbWymQY#2YqO`<<>zO9r89^=m?;}J7~Wj4?T9-XQ$ok
z(NRCW^wWbDW^>-#@x6B8hbO-HqHot7cg>6L-FWAphraXM4R9QCzUhWta>@;8K6>xJ
z2cK-kmwH_9yCFYJ7`+!4Jbd@xhd+M#=cm7Z`|rm;fBpC8zkmP#2VejNI6wjx(0~U-
zU;_RXxIhLr(18zxU<4&NK?+vTf)~VK1~s@r4tCIk9|U0tML0qdme7PJL}3b5xIz}T
z(1kCAVGLzBLmJl5hBw4v4t2Og9`?|OKLlbBg*Zea7SV`DL}C(^xI`v4(TPulVict~
zMJiU&idV#97PYuVE_Tt2Uj$<q#W+SXmeGu7L}MD&xJEX%(T#6}V;to;M>^Kgj(5ak
z9`(3KKK9X%e*|P81vyAU7SfQ1L}VfrxkyGf(vgpZWF#dyNlI4Il9$9}CN;T9PIl6h
zp9EznML9}RmeQ1`L}e;fxk^^H(v`1-Wh`YmOIp^_mbb)ZE_Jy}UiQ+LzvLe-0RGoL
zVA3vm)hlN0B4@p1DwA)_Z078ixy)$B?wHxDX6S^;zHD~Wo8JUyIK>$~Pn6S~=R{{Z
z)wxb~w$q*Ogl9bEIZt}l)1LRlXFm10Pk#2(pZ^4CKm|Hbf)>=E2SsQ?6}nJ{Hq@aH
zg=j=2I#G&N)S?%~Xht=<QI2-hqaOunNJTnQl9tq@Cq-#WRk~7^w$!CBg=tJ>I#Zg~
z)TTGZX-;*zQ=azJr#}U1P=z{Fq88PtM@4E<mAX`>Hr1(5g=$o#I#sGx)v8y;YF4$n
zRjzi`t6v3cSj9S4vX<4XXGLpT)w));w$-g~g=<{pI#;^Z)vkBNYhLxb{#U;C)vtdA
zY+waDSi%<8u!lu#Vimhs#x~ZmkA-YxB|BNlR@SnY#cXCZyIIb<6kVSMZD>V1TGE!*
zw5LUFYE`>h*0$DM<ucN^kRvVGy4JS0#cghLyQoPi%2t<&6^1Bvs6<sux5q_pa+T{P
zB~a)+=TXm$JOrQ+sAoPP@IVL#<XrQJ;6=t=Zg|BzUgd(s19+%Idh2k953FDdc2I8}
z@W7=zs5cKUV8I8_t6njP09xb)aDWB8+GTYiy<FJ92DnfMJ8VG<cDO?XE+7W^f?xya
z<-(KRTL%PVpbYZO)PO}iViKQ=F?X<o7EB-z6o3E^4u<dsMt}kS6l+1h94^p@#lWEa
zqPGj!DRGd6Jmlv*VFm`qLkJ25BNeUS!FSkz2x#2k5cv2(cesNGzO#Y_mth6rB666;
zOyp%zxC~Vy4+uhpf+tJ(!(|wO2z=~b2!~)!FIX@hOaSIF_u0<@E^{5={DLv4x4{pN
zZy7{1f;qqU4t8!7p5?peKUdn)<25ppL4e;7TmTO#Zu7k~WCKRmp$k{e@|L^&<x98P
z)w(?~ho6Lk^MV?}9$-PA#3E-Lqd><zzVVO2`)Xnr8?*&JaDqL3Xb3|lJ2N=1tXZ((
z4!@bw#>RHGMQh&urZ>eXaCEki!-D#z_r5)j?~ebgZFc^*J6FxEka-p)qYN2JEG^FN
zcH<2nEV<j?|0Wlyti+;O8HrTGT~wPM1#pHp+$B`tR&A9<+hIH0;{O%`4v11Qj(6PS
z9|w8JMLu$pm)ztR(?O?uwsMxY+~qHadCX-#bDH<;XS;ZS0~j#Q&f#3=Jm*}_cMf#K
z>6`(6TT1YV&bFa9<9ge`=F-=u1Isn;nNnvPEw<4*VK5HsYoo<AcGq=ce*J7(=epO;
zjy9^d&gpAk+uN}RceNoMcyz~m-u1qBzW3ele+PWv1wVMg7vAuPM||QHzj($s-tmuT
z;?N;KwJQj`RF}tm<~6^0&UfDPp9g*DML&Adm;T=Lr$>G2Rlj=Hw_fvDxWbHPFnik9
z-uAc0eeQL?d*1in_rC{z@P$8o;uqie$47qhmA`!3mqF;0kDBv;4*jR)yaCjQngbdj
z`TBAJ`$?0$0m|+D?=KAxcgO>W%dfOgXCeLMU%%1vV23Oi;QjGGTDR2;fBef|{ryLp
z`vbtE5x@a7zyn0U1XREUWWWY=zz2lD2$aAHq`(Tazzf8{4Aejf48H|zvJV8o5EQ`?
zB*79i!4pKm6jZ?#WWg46!54(V7?i;oq`?|IK`gM20@1-8<iQ^F!5;*|AQZwOB*G#z
z!Xre&BvisBWWpwN!Y72nDD*)x(7p~l{y-|+J_gjj>tnzM*gi0bgD{K(GdRGZ0|PX0
zfCfCnG-N<93_~((KnGX@FmOOHfWtPtLj!bxFi1l=d;kSB12Lq-4J5=uG{i$h#6(oY
zMP$TAbi_x5#7LCHNu<O|w8TqvB`Zw85AXmFNU%=?#ZVN*Q6$AuG{sXy#Z*+qRb<6h
zbj4SM#aNWZS)|2Uw8c@Z5Kp|tUF5}H^u=EU#$Xi2VI)RSjD_c0z+;>~1w_ULG`gUP
z1y>*%T38BffPnHFI%;eOX?z=NJiura8VGO&2|z$_3>pa-2e{zI{xe6(afLsG0Bnc_
z0BlEEct>cwNBnC?32=pLG=O$EjK6k#09TO4cx;{Z)5fJ}op@Y|dBntrgvf}L$cd!L
zinPd!#K?@)$c^O4j`YZn1j&#T$tns603rSrO<`nZAa`kWXdqK#a%E+1RBuOVW&k^t
C)1t=!

diff --git a/docs/images/aux_ov.gif b/docs/images/aux_ov.gif
index f371da90f6506005c0335c747e40ade8644a5aac..e7377a0293984f46b98a174531c98e93239dadfc 100644
GIT binary patch
literal 126888
zcmeFZ1yEd1o9I0=3@#a5g9QR15QyM}3{J2R0>NPj?iSqL-3FK7k^sSF7&N%MLvRc3
z4441D_wL=h@^01ccfYM$wOu_`J*S_R=`&Bu^Zd?{dN0Yxujd3z1zi9DQ=Bhm`1xj}
zq*@HjGpsy3e3E=(3gfeW))oGktgc&XXqss2?&%)s8l34IneQE&ADf<^nf)s)%*`z=
zEG#Z8{$5<%T3O!yy}G%+zOk{fv$=V&y?wa5_vhfx!NK9-;nDH&$;s*I**}EKi;JtP
z>zkXK+uPf_|C<4YLjA4!e@y&at^K<K4+a0e%tP+q5%`Z~{ryJ&!*%|hYX8+b|J93s
z8_EAz*5B#Cf3n(tx8{E)@X-H<z;FcykN^Mx_J<GPFP#8jp#UD(G}7f+t$tX<Y+Bvr
z+3i7)Co*Z$6*-+@6tB(ZyDPr^ilP?_rFmbO+Y`t7saUJ0GOsU*OTRbm{m=Y?R6hHi
z`JSHzLzz%NoX0X%g(Kgj<Jh!&t4u|(NONS;WvYuOO4NRuE%a8GO#Ohhhd!3ADV_Og
zGNup#WBh_%VDr0|BRQL+qt^apXF;~&yC%XL4fn;?#ldoW@FtmOFmJ{0UsB|P7I^iQ
z>lv}sN{IgYlm31@UN>5K0p_iM9N7|`yQ8YM@lyT1?^^;4doy+RoTU+mH3v&bk0aqN
z!8+TSc6_pTgH2zLef!pP)Sy`cKr|LMl0qGTKPTEGE=n2x)mOj=MD_Fvr{b<bn*?u`
z8nS|ma6ofJ&w#=1ys-%}xUzI4;wYBsL~hQEK{yO+wK3RqS@hAsOW*~K$Vex*Hjn|&
zKop3T289GL!(o6R{H)DBAo}o>HwMC45eXy`g#p6R<d2aNSR#r5FfFO`GE^AEKa7d~
zW|`27Pic$Ziku*xL5tdvH5%hRnRpK8k;iZz=c6jMVc=zQu(v;2x(yP<NJ~N&2}-a*
zqQzwm0|M~qqjk_+m81(enW9Yr(V_yE8!^iReAt;z!ppLl&c&FmK!)fZB-Dw@rT{}Y
z;};T}#0ZDQ?n7XrT7oIr;qPFK`0^Ye3O^Pb2*k%@9S*`w^JWU$^eCqdo}*lT9$4JK
z264m9T7H5?m4?;IghgWWB#aS`M1~oJDza9fPbX*t@%+6(VVKT}qUd0)=d?+qJT@k1
z+dQ%W@KbuOA2lqr!=*qbs5+ZjL5dS?xEhfS5_2bAtrfI<&DiFME;MYN669%<fw?pg
zWZ=Zir>+<ZrXS|4{C&KOn>ZxdSP%-&skMxxe?80@D-$`F&iS<5MD!P?TwCV1EgmQ+
zKy|Q>87NP-Y+ltKdrkhOkjMbk&Xys~5dO3Vz6w0OQUbM0esL+{B*<d<<{efkr<nCR
z)|>siWi}p1kZHR#2+g3u0){F|sFAn#m;t45hAntfzKO*m!Dosi{@h*F@_~+w`|C2<
z^bV93Qtk~E7T7r{2E7$>jA2qH$e#tvx0Pd9`>|%vj|3|6&N=VC%@rxR*M8+8hS?23
zgCGm4ID>fID@VeO=O=&vlz28AuOP1wy~S$bvKJ0wz-CIUCi;p@M$B*fq%d4t9E&`w
z)PYuF(x|P?R~8I;EO1hj<YP2o9>`V&641RFN)w|UrK)XO;r^rh16wVY9zcrUZ>ofj
zgr9+l=$7BhI<lAn(8k1sY-YATA=D<*DZHQh2myc)XXuR_w36f{OzNGl?gA7>kL77*
z4PGHe!&hcRGle;!X5uC>-ffm-Rg?goUQsoW4Fmf~%S|h6X^)6rhu~EG@WA4mA}u>@
z<k8y+wR|>2`e+zH_^iYOA3DbLR6>$-5yu)6=3P?Cok9F2%R`Uq5qQnH65S*$0-^>0
zm8wXBTVsHZ$?@Lj@JwiRlspwAnNv86(`P;=9E`+W?49m}^y1kCnhwfz8!)G>m1^eD
z1e0VZ$%OTX3M%GeH`RS=Q~q9=P^Ub=Vc*j?xL28k^zY~Nd*9!V_Y>Z|*7q{5N3Ndz
z<caTIQk2zXzgg^B^5Y)p99t)_seUA7c@2w)7v#$wVxh$BJdJ@D>*LsPl71LoAhh{@
z$aVH4;}X?hAbim?<avFP3BWgj3YN#%DjB>}Z32KOAi$V)Q)5guV-Y^+NT|kX4#hyB
zByaCXr0eN7di)}3DVfpOl+#>RiDzAJz9@$7m4Y|TqBfq|coUUN<*f8SlO;4sjeQdj
zW>#Yb5fzN(e96tDS^+fsza9^vJS!p=VN)((BQ8=pE9R(R`&=7JRAzTp^5lq3?bi-r
zMeJEA<;&+9Q?uk5=YeH5q#+u=Wu_MD68Ibjb`_o!Od%xCzV{xLz?ff6wQf|G2j)Hh
z@^;k+%mf2^%a>Y_&BcHpCU>Bsw}I_@^+>JrO0;Q<=Yowf0CzF~NE!(if;}HW1y*6V
zqL7Mr-OBH&n1K1DNC4P-2FL_J`(CYR@bV2&lL{0~keKZwt`Z1W4uHno?G3`PQD0EV
zN^CX6w;+sVAqo!8=ivY-IK2jp<xEB`^&gnj?1sIEEj!^sfbvtyzCpdFO?ajjE+22E
z6GF4%cdGH+K63e>v(syVX1o!@MGAi6%dL>eLqGKTxkUj-03xA0khgz@!0ob~o}eOF
zN^X@X^|FIip(2z&&BvEORff493FJe{TT}Ui`35T@9oRtx?A{Fp1ACD{a%+s#SKZPI
zm9a_vYflBQdK4oo;|t^r^z+U-hp4e9Bn#O7z;e-`2n$dH87wm^3yoq6fO6z)(@Bs+
zHf5;*MEd&U&<{TYQte;r1}XW1vFNLzwBDdmS>u$$nugVmW0EL4-}?g#5R}Z@hym?E
zASIdj&_0^Dc{5jzWf)iO*_XC7favRAU>Z2`>j1U47#ck=jUexnc)1zi(h-dq?)~Y?
zZgyOl3@!A<d(5X?#sO&nG-AM^j8OFU!p3ARb~!ZjvHALQr<7+5m$nY~Lf&8gbWUVi
zat9LI06!HNfV{|%V6q&5l`f2#0e+BKk_teF+@ypWtt%>)`*5`ga3xCYV?gQu(BIT_
za@aZmX!;HV1<$L{upA`>vbKk=KM$1Qn<K6&y~o;8ILWb)0MxNuGyyAe6a=fb-jDDx
zGt?NQys(HygPx?!-BwKmoP#oOK_t%0Ys3^UaJZJ$aN)3Nbg42c((>K!R_>e>HfMlh
z4swFrv^7lr6VQt^yZ#-=mYRG4DUg*pTI$^%2EpsV^yd9)UB?xQ;Kun)VJGR$rZ&cl
zeQ<|WO2O_rc;E%+<ZmU=PU0*Bp6Gc`D@y&NTL<V?rACAYW}2S~08@5zPuYGy{pyA~
zu^Fsy=BGcJynM{HMdn=}_X@i&aFUVbu=Y3qE9~}nSc5LQjR#JT4#1`SPc1jz@3y~4
z8jq`IjOO|A=iMvdxXdD>r`6dqF~}(85ulD2Tlj-G3U&!+$vbpD7uNeQI2UE#0Ul33
z^;5n(2y%u2ah9P9r45`oGxwJwN65^neUkPcI*ensI*;{?L5i+^B3|c7-k0Pg1H2A$
zFR^i8<`{*LL}tK#65&&r`q(B-0Sg5s7GNidq=?0fe#Lc&mykS5^Zpm5k;MCWUy_gH
z0J1C+CVFQ^LeMy=Ev2414!!5@gb%jJdxR(-rZ-8kpN2aNNuq-@BhaX3!;gRvR3quD
z@WdQ<1<D-FNN@-&k0p`i^Wl1ljnC&sPw4QY#uxje+dYO%_zHxe1K{@Q8H<TD7Q_ru
z4#X)3yssl#uJw7R2fT42D%uRfKQaPA15hf{f%pt8qoQ<zqhGD;01ya}5u)r;srAyw
zN}!I231+I#Lr5R(`79ey7U)6f1FA`))=*(VQ)0m*RJQpd!2|%Uauc^3dp;9!{DDbW
zTS&wTQwJ^^LVT=%hi)Z$Do?$&3eW`5Ut-f7!ibSTEa(erm@c6qgf2Q_wk~3RI%4rM
zV)+tC9__iJ7P&zYnO&e6X$Y%#1kxZQ+7rzgje(nLQRkPyJ0o*)n<$bCvy00p0A=)j
zop%+`A4}vt<1qXFCkFIvcCi2eg$=;1RuS)W*l;%47m-lsz!>cn>$E8|U0wi|qV>p>
z84e6cvrX#A3m{%51y9F5qeR7-_yk)RMPsf&6ByZjUIp1!Dl(NTu8+&tJ|Tvfm`C#w
z4FqYpI6G<uxh?YmOelyHg2Qkt{JWgPc|sysD%l1^qtTDJ7{)k{MC5rywEZs$o9iIQ
zhNh^RFb*FpKsi9Mkgm|drx>1qzYVbM;K#Iymm+ikEn8|BnH$tWa><BuDF8h=5YsCS
z=l2lStR$H)Ag8uCaUW1_UC5J|s9Q`z@l8#)V4{{_jdT~tGYUXHpL$dXYq6aaIhcH_
zHjvR4B+HkCWedtKBC0Yq*KrA}>G7FzjKh2_FE&HM2nlBN0WxkTxhMMF+oixRDNdy%
zliL6UkaYedBQz9!IPFL0&>0d6n6vT}yp1#s!-u&zHba|&d`(^bM`EfNFbR8^p83%D
zGB0IgCYqr<^R|e?e#O72o-j}i{ysZxi627P?cbX1AtMrM=#)U@<7dlHjyr6IB?am>
zrNP??$RveRjkw|_k<*#@AeLP}7Ri=uQ&^fN5gTW^GJr@6P1!XvK5tPP7~2Bb2-it{
z?QKCyEHc!gBz%{~kq#!lH9!_Nh{U$H`-&L|ko)YKf@ax}q*k{`B?T|W^|b(b9cJDY
zKUEykqAoz=Nv$t8UpC-EUAaE%qW~2HSN^6UNO;=TD#W$eP}Wk0iqa&nxRckbCNCi0
zm>Y)%HIr{DyQy609Oy$uBtk{;6#BKvFxH|cHLSPLMS$=p7KolpD&;y=V#F#9voOKT
z(yy2Ba6}lL%LE6>D9K394Dl)8E>66DSki%5(Le$)Xtp)ob|tqGhbW?#8FZ{DW}m5W
zWCRb$YiUr;!*LtQVdIztuD3D!DVJg}fTmN*W*f@pXUi6^%a*CWud;#qCxO3Rzi*{{
z-)Z>1H~anI`ui?U<|D#f{?|M>`6U?05(GW)cJ>GA`Uilz93)r{)-1<xE5}ML$7w9b
zn=2={DTm-zU`Z8+vL;*=)8Q_&_w~|<2w)TVg1FX;sBzN<1S<7OOP}_sC#6(M2B0e0
zck`HUD%I92U%An|(fny4Q^Ge_`MmMx#Mhs~Zb<^vRV&~s@zmfr+bT`NDw(hZvAL@L
zjw(f2DkZ_{jE~iy`+VQJg|cQzYNu8ss;VDV0E>w}u4l6m0&0>7b6tp(iL+q+H5q2l
z)4%LO7?F%Pin=JhGJDzD54(`Fw#R>}713>g9cF-wZ9r&aUHDvG<V{^Pb$zU0eY|FU
zqFX&YwLYb>K5ec(W4Hb~5kkFFb5;qUv;olD00~baRP;Xt2|?dPNeH4z%FIcqLlyTw
z0nffXgM4h10yav&Y?NMU6erAOSq45Hw$~X0(gLzKw;Ke2O;QX^QX)-aD4%LD5JWxP
zM9>cWLZ1KF&WL)sS)39?gVfMz2cotaXv&*+L_jpd!095w!#VNoFofwS;&`t4;5l(&
zO^Z}5aDoS${xEXK2SkG2%<j_+Y6Yr-wT?!L(R`Rg+G&?wS8y^!)bHX_zyN;Y5JIje
zek7nV3aLSJA`ywFyJRt9A<Rqdz%e~~3nJpi#v}^^O}PnS3hzc^Y<Gu7LRK#2Lmxog
zVH^}h2R)9Xy?vheEalOJ_Ba)<-MFG<g`{7uVnqiL;c(Ixi6|x`2n*1d^og$JN#)e|
z<AUc8Wk9c9AsF>xV&Tk3g8BljND*`<VrYk?`*XWqfUj~ZYL1Zcr7Z}T8=Kl2aC)S8
z#!x`W#WnWQq(&x={iQMj8g}~fnTi%DE(@43T79kr=uakcMq|Yk6G2x5(VK@H1c(-B
zab~*_IfjcOh7~2)`{2Y<W7FI)_Erv&ZjfDf$Zab+VH;yK%dap%Y!i_fH@380PbcLQ
zB7TTXA(Fv|SHhiZQt1;~b}t#Smub1z;kKR1Cz%1{Rn6X7b6vWB5vPAbB>Y<1lDf0E
zl>rhh;ZpkJxyUD{Zv$`(2)#GJ)Vw#_oygz@NH(100)nl#K6PmWZUJjoZfhAoD!i^#
zaKoe9m+PTLGGaw{vL69Q+MXPT1973CF>%p%MJTo*(e|NGn>)NNcmZ2*69YN~XhcJF
zlg*ZNT#9Mm%{&Yod8OZ*GbY%I^a!Jn^ccrv9hBLJ6D^Dn#EdJJ$;rK)z&suQoc{A=
z>clsd3EcqD92V&PwTjY!Y?TRp_Nx{FmC1VXFpr)9#<JYFwmz2K39a=>rbB+4LN?yY
z1p6=CKhoqZB4nNAdC<!PK9jsW8UfhsKbh@U@mr8_ev8cx3L?pweqYJCZ=Y^pIi(pe
z75SL1@EQ<?KUL9Kl@Xy*RhU5s0ck$tAc*GVQK~^}o-7)eco#fT$5Ex(JV)a;hiI-r
zKAuk?oau-l>GGJb5uERhfH-bAL^4B2P)YuGH8%IE&N(vV{R{J$BB`nNc2NnIPqWOh
zkw7LJyF=d0-3kYsWgyL=+V4BHY`D3-<Kl=BFcKYvey(<wKiTuPc5xqf%+NIYJYT>`
zZ@>{qwyZh)`D?PI)o|cT__o@kK^r_P)2`Xi4Fe09XKEk<^C)hBb&6wDr$;WP={rZz
znpDd7+GS_Qhs~}jllRh@BM^Jodgd|VeOV3A(~kLC{|QQe>n&ig+Tq=~-4pVNCj}aK
zR=_#gmCI&_$UFegAP_D3H>Bb>Oz<&sT?-TmbP)uS+W?P#C2IbP#XZn0+SSbLS)$1T
z*ko9c5SU^Q0|kvYt!1*js#j1nv_#Q~8an<<63q)9F9_FcL1pWqgbQ;4v=aV{Tdvvb
z(TFWl!EJ?stwe?DsElnJhV3*R;tbSwX2o_6f+SmKhs$=S@PMcov4bnO^BpnoPP?o8
zcDIUlyWDeEbY!Q&il}LE_tIz=xwu^~ya)fd*Co8wma&%~xz`^_+=AMhS=$>W*tvQd
zH=VIRi`buE++RfPzv7>q5I$JbIoR+#*vdHAK^*KY9vq+!4r%`!3;#LQ`E&01=Q88Z
zHR8|h;vW?14}k6v^zIO>dx+t6h?RMW({hNnbVzW22%$S7dUr&kdqn1SM3H$!)pA6$
zbVPf9L{E3j`0kiV7j^v9>zFn3n62fQed+kc{V^Ba$*XrKZ*)(1yiWKsPXt;{gqBW(
z?@yp~r=ssp#g~ZD4~@|kPw`@Ww-futTLAgafDBcC&_|d=6hPVw23~eK$pL6`0^pY?
z;7b>Sdzby&6H>)<vrMakg%hckbA!xNv3KX&JWtp~&)=q<;33b5`sp&HriA`Lb?=S8
zHeYNTaq*{|SpRXcvxfNTUI^=+>%D_0eK?Q#a304ANw{|rZn=#1f<#4~zVm8`(!JFB
z@Jqz{(kt-=c;#Z7Y*_Teh4hke_Wi2ZpDP>AYtcvW`g<3jh2zSln;N=PHBP|p@9Ppe
zY3s}@;TAvys^SU+J!`W)m+=b92x^_MhFC9M&Me(6-rp_Lp;q6a)^t%DUZ|~1)Xu}5
zT0$M%qYmlrkKf&&>fWDw-Ct(jU$@-fF5RQ<?*S{a%TQl*d|Gk1;)-Y>{$pW(ijS+}
zp`;u-9q^C8B_kid^#oHYtx3l+%V&ruE3L~Ua%dy`DL-w<rEps=b|in=RLFSifdW%0
zZz<+TM9@m4C~qs}%clzmP^s)F7ps)%bf&26e*UiA?1@hOc~7m<a3Dh>_4B?)jpYI&
zfLirHtHEJ^u`^Zmj}F4)4uwvmb_i<=z^9W;Q#<<774i68AdUL5L2m+wZdaQ6iP2#C
zTQ3yGV~taj(LDJ~$#jh~v&k~;mcYlF=N7ZomP=jfnip1!%^vp{v|5)otDO;aQW;uT
zb{hlf?}BKxufOh0l<EG;(7tgzSZMabq|>=|K3*Tll*-h(b3NZ*XbGazMY&&}?Jxbx
z)V=q7@I~BXazTNZOyy9tN8(%}=;Q|FBA9gkT%y=4x#gm`oE=<Z_`GZ7VvpW|Uy2h-
zF;$2Ye-M8uL8@v{AwjO||5B3DIJZKQ+PdSV)MKZ$3Mo1-@GEJCAf`&`CsE?B-ZLi|
zRK91)^nWGutRS~i=J}6~SF#+nYn8H`E#TL3FMl!plzTlS{#u@U%HXFw?~?y(1^&(4
zh@T3Ae>z@&czdz-^TWG)@Eb)DOy(*@u}2bbK1z@qR(+JB3wWdSo+YnJNtUzo%_n)@
z^{P)F-l20Vf0SabR{r!sf?GvJ)v#JcRX2e9v$}C!^=D1%PHt6gr}b)8T`zPVHN7C_
z8a4eW2_ALBB*PkY<IDga4by_W8V&OwojjVBwd*yS)-C9~TDBZ`Sb)Dw@t6;Wng>%n
zE3g}24-9&+&)?tQi#djtEuSneFWcHXY&D18-;a%EIE>!kr;pt?ZQt8wj0H7sr`u<3
zJ&2BF*#;x-?;pN~HU&G_+GjNdhu&`^((ND8p}~!VTlZr@!HA~dEODo>t6P*-R8Ek+
zgMEI3j7LoR@b9kebKBh7xUQLyrs0f{wV>e8^k78a?!|+<>cO$qv^^HoF!;5gA*5*t
z7MHIZo39sN5Z*E-;}NS9lWzzwOCKAnTs^H=Iayg*39`>}ENW`n-p(9d@87#{EknL{
zj~>0>-n!q`j?R;EjaCoO&K}=P8CVX=$Qs>7j6QVCKGeCSMKdxxZD_TrIdp%2-!89y
zG$S;sZ6cw2F1dfn=39+JVbl8h`hz1QwsTrFG(E9rp{Y4*bSx{V8DX1|75{5iKe0$H
zEW`arTNq*_vUNPFZPKH>{ovr>&!0b1u2I_2xe49#@7-g<5Ti04(OF{~`iaHiEu%3V
z)2V|i>0{eL8DkF~yP)PV+uVAmVnlTNRA7Do!!7ym@Lw_l53VR6*1vQ`v0sXGM*=Bc
z6CfF&P=W}m0C%|b-&|2C?7&yw;v*j?RCRQV=KX^!ioNh7Mo72@3}-s_WmsUipyOYz
zsG`<zF#*~U09ME_Aq$9kJNW6hu?JUFN=Knc;ml92F&If-P1#%lT4GlE+=y6owe`u4
zLkb~SyXtk*!DG2gBS{M5sM}z|b#|QAfG4tv@T1-dVyX$XfDrWKwV^CR0<6^_EV)O9
z8nY0Yj*g+>a(&!4_B@CEuZ>N+7w;%J;*-(jvexCBxMtrW12Q=VwXE?U8JPm^?Rcb4
zb}cb;3mK(YjiT+pqfpTy%|g@R=KiCt-$uHqvtdH1nLkbr)gdp%Ex6rCIPdQH48gy2
zFM2SSef066ARm+U6*^x?tUn<Rp1?WGpF$X{B1Lbq+=(x`013k5gZ>Kiq0EOzOH#4N
z#9)brM1RC_GU)IN<$KXFD(8@v2(sZ`XU!F%i$}K0Iet|}i++N?y%wh^`D{I2`LpSI
zf|^m$dZL!&_IeU5@Yx33AklOq*(AScBgLX-dn47R>)B@7*GbdObmxtt%?$VR?afSY
z47RN-e=@VJ?BJ)xTRGu8J6qqPCE2!f<3F2i=fRDNxAW5+ceV?%0@-#7a}&*WiVE|K
zcZy4Ec6Lfo<y~yMrB#z=yJdA7#k=2|&UbcyATgfrm3NSt?^Sd^E!nH==h@x+IV|~n
zziRxm`F{1ZQOSPIyyNbE?Q-DrgSxdu^Mm@W{E~x)y_(&F#>1}Xf0|Aw&HprCZj}5%
z+@A0LX#rreA0olz7Kg1^ETxBSc)WXu?GP#UqYe^Pi=$2o<I<xp8mGOZU-Uuj$K6ax
z7RNoT1*ONm?6rHxeO$lTPx{|XS)2^;ZI+%43SI1-3_&qDPKU+GEl)?JS;|gF<#_i`
z#}uVF&c>BhEzc&@jLXg@wVd|PreHxF=hFsBmgh4j1sohei`xD3Ih$V`7xQ1IEH4(E
ze=ne+$SuDD^#I<OFD{q;$*nF|f?2*_u7>k2f=FN7E?lm~t6E*H$2GQM`of(Kt~RsC
z7e&`F1Ff#N3pp3jHvQ?Ap`ap`NN-RDS|k+Be~F+DOvXOU4=lx87T9aY^hAOYQ&xie
zg>>E`z+tf=ArKxI20a~C1-PvvlL(xTI-l!a?p2FHTG4!|hoMJJEM6`b0E|e$DP_|#
zk_6qL9C?IG!PRv#fs4FVR(y*!{KLz@nf9O*^X)t(mlxtmCUB6YWse!@f<8?9r!Bhm
zsXx@K-Y*MKFolT&`{9%5x8xOmA+VwcaKeBA?(wqTqLTjrU$WDJNucduEhHuiyN=-=
zgz2+0Z~&r#(k(v?7Di)*I&HiLp@%yoC<qQfAJhO~WkqjvQK*|QF5QJMCW0)*8m;@2
zE`SN@!!r6Js2ewpbY`n-9UJ1hDdtU}QP;Rg$r<_mxi8&>nt1C-OauuY5?vG^NoF+^
zI*Ciqgk2zd&8OsS6b_)e2@({LDff2n&;uCrwrp{Ghe*34Z$X!Dg}=l)69d}lAH%x=
zP=J%GmJd-Gz@LC`#f8OycAbqsQ+7u&&UDX!`rWg-xq%9&wK%$cr4Yc|s+TtVH{bq%
z_+>RGiEJc<ykAtz_<*5G;q6RM=wH{r=N=si9dAU^S~&IY+;Ih0XN*54HZ~TcP#O-o
z4)-Q(aA|Ml|ClDDrO&^8*?WN=<#VQQ{Ay}i5|0SthhDgNCf*I*=BNb7Ni$v{SOd`$
zD+7nd=tWvgo6)H%(?aDK1z4oyPQ0yR?F{lR$$m-hjVOS)s<nY?vvnznm|sWaG8LS9
z$2%!W1=DY~l#=)+@-?b$J~R)i)b>sw4XgRJ@k>-%dTA<BRNM_X6rh0ry;~`N*sV|i
zC;&n73W^V)h{A`Dh!*6-&P82A6P}#X+SWcYI+~H0sj8;o=H|Jwx~i<A?&#>;jA&8U
z&}u;<yMA?NW#?>dZ@apB1_p+Bd3irjG{4u@ot@o1JUj~ui_+3F7nhd%`Uk${<}I(R
z%+1dyr=+Q>X*xT*E-Wr~c6C`<S?A{E`}+DN!QuS_gPB>`-95eY3yWXBI;N#(Y;10h
zj*VGc+fGhRE32rcq^8-~Ikb0luKxbr+SaD7q2cK0G&nTe+t)WfG1<}CRa{a!F*${7
zZF6#R9v&GfE&JZs)NE(xxVFCT>l^T2vJC!rqyJBg0M;4+8%!Y`4MTs}!;@&S+Ay?2
zun3iGq-}!;e4jIdOhgpL!J#w|GYVvmPZtO)nn{G!U<DAtr7zk4@i3r26$>4vHjP%$
zk553?G0w#R42NUVp!h<vvT)-FeMmaEL`B4buW4k43y}an0NWQ(p7fIqQ1UZY46fx*
zPq3;j^mQNrdmjywm!w8@BBJ_Z0U`<taOp!oNm^kXneyxk$zeFb17tvG@7+#hsVAV;
zO>Zyv2>p?BU~&~q8X&<);gdz!24N)KqRr+*f?Elw^dbE=qWhwhstK1?(ze)bxb0}5
ze^C5?Acp?8;>&+{(02s|#g-Q2=;&x$Tf4ftMsjjWc6QFgxgjtx*wxizdwbi<%L|D_
zuCA^k5G~HmZpzAP9v&W<nVIS7nQm?#zkYSAsy@sNPKAX<>gt+nYwJ@F3ak8CRaIkh
za%yvP)7jZ2H8riLr}u%n%gV~Ova<5^^&J}<OHa>uI1_YscG=l|9T^!>S6A=o=uAmT
z>+9?L`qjbO+NPwW6b^^~{{7p@$*Hxqt*q?3udjbsSJ&d=;=@$%a99}{8eUpjo|u?)
zbad?RAIQzk%gf83pPz4QYinw19vB$>f8y`=-<|xg8Ud_D0NTSb#Rdof;9#+7Ngw`d
z^~0lhA#SIi6%hoG!xLKd&JOe=#9)o_9s&3;2@^~z@&Uf}B|XxEumgW?hybxk2r97c
z+eEQApU`J<{WkOocqKzbFYUV~#sDVnKprYWLj%aUzVIE=145I8DMy`6f%$|Xn9g6=
zeaVc_fG;?tg^pe^1QF74y-?}SVe$<|3xT-<{g=@nQ3&3;C;Ny7ka1$NlVndCVgx*5
zYrzvO_cltB!uAAvxBG<QQ}B9sR{*{f1fsd(m3n{dgc1lbvEhAm2sl_0B;dJx4EYC@
zr+OIO2g^ht$Q?im_{%c!Up3nQ-R^&nz<>D&U@8BrmWlriB+K<b*H*!YANQbWf6=(F
zKtaqedH+ciVty(7zv4q$fJgAHgovnusHm!_sEVkltf-2xsD+S-m$+D<yqK4Tn6<lv
zS)i0ogp_28s&s*oWTmZmle<_~uxN9LY)P<Iq_4Y%Q?8`#Pce^X@vt`0$bN;?Nu9za
z!yjwrKet?v$AR5fp}p6UgSSazx7pLTMT>W3%Xj6gcQu=L&3kv9CwD#PcY~LABiDBm
z7q`=wxAWI`t2cM+w|5)2cbhkNTi16xm$&<;5Ao*U<o}5KCpUkKyNBoNTYJkZYxDC9
z4-5TZe@{;rvbXi;U_<gmrR(eu>%|J|wQAeFX4j(*|MUK+%dynU`J$`e)fZbW#|OQC
zjz<qqW)Dv{k53LxPL57akI&A}F8-qIuWoK0K>NSN%iG(dySuHsyQRCk>ASn}ySvf5
zyOF!QvAes8ySw?jyOq1U?Yq0fySwwdyZ<l2{D*n+!CLuu!oMr<Q1;)F`Ip!K<&}SI
z`tM}@P3E5p{L}Qm%>BnY|J|$yfqz-mKP&#P%KT%g2NNLXzhVOX&nVj8X!N470>y8C
zhej{f{>ubd`#__o%hrBhXnZ6KYv0Ig?Zo<YtK{$P+oNM){1?jo229#yhx=eZ4)T*A
zev8n8s{u|{hTM6da4dsT$+{UuN^}MqjDjCKJHqC^d_?CNAi~X^zIl4+4Wc*L+h?3M
z0aN9F3^Eu<a~W9BQH1&VW#?GV6P^vecv0^C)j~ZQMf>4<)4nqY!&g}2m%Ey+px+@6
zUK7eex17zsT4tZJSEh)0e5mN71kzIwk2cnHyD>Tr3CPYZLIfQRygjij!W7IPfq_P<
z=&R=zAcC%s_Bc2L5BCdkASO7O0u;(nsip{i0j^M`)>c+kw87muLJtDXoKrepr>kh_
zqHW~`8G`Yhv!R$z`RM%;w`-_krWR@;;Jl)zbn$E;pa$*Zc!~|UApw)GMb=78KJ=64
zIYzW7t)xMW!FwAt9yKhI)(ov^EEXTRlw?@+0lq<-PUth}ZyQfi`uS`E?3n;`G-<A6
zQzqJAd|Kr<03Ty%g5_t0Ik9YTFrPb>8W8oQkhcI@`sJkSi#ceE#jao_WD<M2F1r=_
zT(01E)`yhPWvKc!znBRaSRzG=wze6aF>NEF=Tx&&0ff6Y@guFQgB@XY;F#yLR#xtU
z(ctb89zb~;L2goQW9+86dMtw)jn^*s`$C^S#?S?C*}+S8@`>Z?;hZxff6L6?MN@`2
zOpW<W!{0r!!#Q?ZiqLpp6s1l3^?}<*dv?F4aagz-BE!ykY;cSC{-*-SoOP;kU$;q~
zadwedvhbfseA>6saf!`=^4VrYRHq`JO0+)qsp&uYlwQId&OY9&ByeiwMAei$ikEH4
z3Xk_3a1@byK0O~xSjb{8s-n5Cf&%lD(-h8ekO?8D1&GJlXEccReM#WOcaGCGkMQ_M
z6FYm-NFDU;c|~1z2NE2|$;PcaY@PT_2d9tHE{EzE@OVTNf_SU8C2<MrW^I2Y?}Zcm
zUTECZxg$Ronf<8Mkm(Utb`qcc=nZZAgz!z?)`DjvE26wa>g7SKy)OOI^0RSka$f?Q
zT-|iEsD!a*DzI>Dy%Ia5-1pJr)}KzJOHGcN;H?E6O&DHHzN+`mTPxFrpXmc|<x+Kt
z=W6XaQ{^VrETMTHJU#=-&Iu}0{TF_`BW9Efjb~xUx|9%%aE<?7*Gatu1%M%pqgD|A
zXY#=EPdM!97x4HD*p(3or9J8kxN&@rF4X-Q8X8sD8`N6tZsUq!JG(@Np7J71fqr&o
z+S&*!g_EX4P)j+29MPROA!i+g37!W?(m&-S4T{h=%edN$uY3BG$(+Lt`=moPB{&2i
zZW%3#7N4I=Lb?;okOC29I`n0x*}#KQ#E1xi8Q%sMx|^iYfHFI}U+;Cs#`-@FXMgrx
z?yb3iL)CAQ!|qoq4aW)P;d$)F@B1`nj}z<q^Ikah^yyq5Cn53jxq{yJf1x^ocgy9!
zO6uu15;#d74$ps6@P5Ed<0NIeKcA=N7|bfZlDdpn!1wF@pk2yI+Ll~_z*NuRKcmr)
zQ2uSi@L@2^<zF;<Arw<)*q7=w3roIGl)QI1P~bEh5>Y75BJ)6_ljO+5+9-RWf&ZLF
zmoJi0?Hx^QIL+gVD3UXl8B0M_;Tcc2(~cv@GOkYxp!mg#K{DexRA+_K^2JI?z2o@;
zXGMw;#mWUTDg`@V$<zjlKR=iNzq_85!0=1de#uN$rks_U$d_nL^-k6_oR!%)Jb%6^
zGu1GA_T71)MCYP+3UPh*!yCU8hABJUMs;2uEMNMCyl=Wo;JhL_qSSyzcBWV3yb?Z8
zYQ)<&Gw6E$GYh}WL`rscH08XiP`=DewQqK^;k>&14pmxC2A!L&^yc1rKVrrQC~xmy
z0oAT^nEMM(J@<#!Mw3ojdb!O_Ir@NJ!7VMx57Va`KG&=Fao7j%YA#oXH#)z0VMiCH
zz3Z9ZG<|95Fi@g#>bX%{wH`%gQo^#W<itrs(TYw60IqOdnBFoFShmD1-Mz@F-_5r4
zx&Y~7xi8mcCI11r;x65MHwIHt9O``c*2A|}Yi&E40!2R8Cb{Kp#YIliuyLVZA3XaB
z+W3>3wY&Hnu!r-aixUSg9CmIt+3ZG`_|@NnipYGq3wHzQBR{rue|+AepmRuC&a5-G
z^}ZS9d#IQ39F0{MDxlVNWLZtW&K#%Cr!v`wO7M|2*h4w>y7``1N6c&X5pCAA3A{)$
z@2BJYfvHIo{i??O_BY;#S_GAvb<D3mLjWfKh{Ds>kVj%#FMjZKd=T?V(bZaS|LWSV
zvG_G%2~TfBCuKB+_Vim4?mRK>RY&Gzsq;lC5WF-q5#sp9H%oR)^x~3>h@d(#6Ju5G
zlg8*G>5E7f_q`P;Z&$U1NI~`7-jK~jJugMIQ}qDI<PqPb6^7L}2fST9-I_Mn{EF;v
z&E|6UP=SOEhaWF-*M_jv5RlJy4FM+y`chQWRFSoKUHhhbPsp1Z79DD2n=J#KG#AmO
ztm^0vtccy5-frZxyXU<&cerm@D4gVOMQv)&xJs#gsDI1d9dff{Fh%+ME#xxyqS93H
z3Gd|CByp`?#^PsPn(5*|`Vw_-^DtiC$@o0SU*9y%CrGr{AT0cbyYdE71@nz9@|9WE
zknMXS^<}R`V*3y|8hhS`B{hPd?Jg)I(wo~F9x~UV6@_(fy0^dM%C6imEbZRiQ0^&l
zUNx9gFJlZRuG}Tqc(tT$-@Uk8A~NC`7b`WG<snB96^eHGrRU&y8E*=*)T}ckd{Ov7
zG0Fep!ugrz6(lWrlJ4GS`v|u@1`~B&H`ILKG<36ggStRILL3HtxLu{bzwG{iI8GY6
z-4MLL8jeDo7JRtd(Y(K&9zvYgqK57c-0p9dAHBQqgQAX8?{Bw0v|LXOq0Src?+&9{
zZZ|*NU(em6E{9rB7en``n+F1g!W+cr4Oa8UaQ4Q6d*jr3<4t=LTzW$&e2DmbNYs4D
zoP8+ZK2&u+G}At`mp=3qzKndnOlrPQoqbv1zHD{A?9;w4E`7Nu{9f_-y;1YyarWbb
z`w7(f2~GP6U;05Q{6+cv#j$)~Hb52|Pbs+nfs;R*qCbb4%acSj5hQvbuQsuy=Sipk
z#xLM|Rt!q0rd&5VJv2a(&s$0w_(9qeRtM1P_Ec~VWb4*k{{=i$dbkp30SD6A1g#gK
zGeN*GieOs`u*zW|%5KX`mLhmfDv%QCFU1<Tu8Lljr)y5(;tCIbtQIVS3~@2>)Pe%v
z*Z^Iz0yz}}NNhqyph4+sz~aJ?y9ehN6m3lvo$W9<J=nh<?yq7KBy;X>CK;A}8CqWG
z1ET;L1$$<y1^ILXy9)z`Ogz)J0y-(ea!tZ~`NHZ7U5qHg>)>H*<>7(d!4ri(G18jJ
ztihC7LAHG1)zXnW@PIgqi1lDEg>H18;3yc}zce`XTV0@wbELm&)MJx?XOdxVg+cR$
zk>S!2TeZ<5kZ`bRRIW*AO<h!pbY%8r6n0Mt@s$rna<p4;z#&oW=4K@7GUl8-D2OkN
z0y}0A3l&0o6~PwbL(~)QTo<W<1^iLxU()T*8xqT_9(Ozyi4O^;*p3r^7SlozBUBU_
zEFDka9BvdGyHgi<C+#^1M^ixt_f039z{8cUJZ&#S7+fN?q(iKvL#x#^Kk_FMum*Ut
z#(tg&#?Jz6=>=|LMG;^pd0r*0!aZS%K&-2zK>kGUZqFcRcsPHehfA#CG(46+IbJ<E
z(IpxFVA!osPMb;2xJu5VOv&L-$yHCucS$KsPARTWDc$y5y+|piOs(Wktx`{|aY?O9
zPHm`9ZJJ3%T%{r@)7tpcI@Hs;T++Ie(|YUE`e)J_W{mud^#+qw*Q+h6xuL3sCY7jK
z7{oxc)JG>K$SEp69f6sS6=*o-qWbg9R?X4a9+S%Rv%M+V*QgqUKk5#}KKg4jZW~vW
zwn-Td0s7Zxwu5!_>F1fh>&@2l>@sQqXfpO1fm!DmAj<O0rm4(~b2~r^w-VCf-KGWH
z$dYPSTinU^vYz~LvFjVD%r-`}dLDO*9nOl{Y_-?+*cUpakQ_osExcK41t(jqP)kBd
z5DSj`a7X}|%s2Me_B=QuWV0r3WirYqHAQzcNo~+1uH9Z1=Q?rQb7N9rUFeWse0}HY
z^z1nAGQgOV&0VuM&w<+>>q7I1jQ#mDCr2DA7D>zTNqaTEg2t(QD*@Fw#~f6LUbZSS
zozU2jGq6B^M_WB5iz~(aDS4s#Yg3!hfM3<7q+M32#reD3rjzxKK}Uu08pZjp#f2%w
z#SO)!v&G-9i_57>Dg{caG)ih*OX^Ze8X8KPW*;0|DM+f)Hi6O(jnXdH((aVf-iFft
z+0w!5(qXEyQGv2?jj~DCvcJ*je5?T<l4I751GM<!C$1Bio`tJkCYoK9Sq4Y$utcsr
zOWa6GN^$mI<I_b_L>Q1I2TDhc&jxPSg{e3vEjxQQONSBFN3RLQnyV$g;s5ceFhrd{
zvam3e#wM)5Bz9aTBr(`ibLNK;Rw93oze`=X-}~^utt<=5m=RV~<+_tU!Nv~>=gL3D
zaenX7#-)EwvOPQ*8$+7vN&Gw_S1p)|8Z4w4%*CIS-W~Qz)}OlG6ZSrkKRW3{SeY<&
zRatQ5NocshO`LCi<qOSfjJYZ?wdxqBAeVYL?{4MPPK+>a!tQ3I_6?j9w}$Fj=r(4I
z@pQF@a}aMTkgNpsRkMt?zI?gZGeElPk!Gzqyeh!d)734I*e#9*3iMP%f3h4pyAwlf
z{$n@j2S0YSK*)pS5BBFjs-<hhw(1>S>W}%#i=UTeT$ZomR4-8_5*Ag3%X$*rB+_e!
zE7bv#O#<@Zz{Ba9=bGgX!9|~NIYG}tKv(`$eIaI)6|^YI`uUXR*~aGix#q>2=4EQc
zsvu%b6S3ij*h)q0G$Quq5C=DiL)m16K+CCS%eh<2WopZHW6SMa3+ko?K!XGcAs-y*
z816`{G*u<mjEVDnel|5dDi6|0%@|`n($e(4uJrSObpK6BS|h4430QSNVSJ)~=26~C
zy=!i#wqspkF=1=MHPQ#YeK5#S<rfev@J+9v5DNtQ?STGa79f_C@9dg4hpv}-u4%Pd
zRAg9$UrVo$ulp)dhux@cwDX(LMkbS@3wyZ*Kwmdg)gtmK`)Q9mtA&BUY|heE&NO;3
zXK6cTFP)iCHrs86@}8AP9gECnK~{osNv%CfhQ~<W5%_f@x60|)VZ8w#8Ehxe;8m8B
zw`8tVpvNjVCS7zoo?{PP6P2|jkpC&WYWJ^5qaL^gRfbS!|4S=x*39hBUEd~(Lawb9
zie1MYP4Ud^=`jto0`sd>v!;Tye`9pe*V2*|Yj;$Cp`F#T>Zd9o>!-ogvu~ohpUF9X
zpGUIXR>%xfu5lE`ffXC4(>wMFvE**4xZE*oV|{jczvE8W-zT)k{1LNAlWgeNz3mjc
zU6-wYLTG3@O+y@`d*aLh>Z&EpGN>XsC|_Xx7HT7tXutq-8wvV47&xH9mj8No0Pkr#
zOrU_YS?`H}mG*MGP@4T6yGB!~#r!R*Gn!}k?eZW7z8;qR*H=Pzy1(cU>>i$Jg<(9F
zsj3BaT_D}rk+-VGLL3<8p(E6Rh0E;vuDwW)QlQ49iE$#Vwc4SWg&pv%h$^D*<-TDE
zFSO~Y))uyhorc75V0(M`B<g(|<7Rt#zDa=DWIU!*o>9l-Mz7GGgL$ZiU47wB+OQx`
zC!2<zU%tVv!|)WlQz#2sI7`5Qgw`i~57~j%QA+)#>>`XVs~lbv;<T(*!7sR9X7EFM
ze>w&%Vt>tda&|~VmM+YGznd+8JXiU4u1b5Z#$&E7eXgN-u4!QoaX05i*wXfPzC(Nd
z0Y&dlpYLs+f8fps@8*XeFN~tzE{tn0OfDqjhBt@`ez9l_fVi1NX_gN?Z_070v{h@x
zH1$4pt+1Jia->+)lnr=+8|a}1&o>X2p$^iPZOZOh+?0>P)O?WnsnipaR{|?gYo@bt
zR<4Wbaa(dPSxV6iLWCtNX_iBTSDJ8Zx+y|wk<0ZIx?XCUNNL@w?i#xH30qP|1>LI!
zvK1OL;ny-zgoBChf^{j|(f8@$+>3ROJ>wgLV<?`*9GEnGDTy6v4APPgI%TWehldWs
z!|56uwRcxDOe-y1mOdd?gfq}sdo-z@N5V`StV?1swwrncH-=a%aruKaoWIMM{7&Bg
zo>}yB6Ms{5Ze5o)7}Y8n@Oxl$M6F7xK586y>o_7_4{MPV;YswpIx{3zkRXWWU|rF(
z4oy(cx@4VHCwvWO<4w<+`QT=4V|>N)MJk;|V%qI+;cYih&zJS9K8QMS(dxV1)f(EJ
z#P12+&P%#C{_fN%Y8gLf)8qW5yW_1YD32rLQ1N245rzuUcBV^MwCiZNzy#XwPCdK1
z=D!PGqzGiJ=Xq`uaiKrf+5T!0O_*943lIC?vNomdcOdK&c6Gqty+|g#d>ZN3LhEy$
z@o&-SUdX$Dn?@hfIH}gzl1F78m|BYp6;nYo%llK)2MWeICs~cGo(xgRa=7F)cj*af
z+skw@?+<ci4n8UUmdMQRf@jgbVSIvTdl&%Q`k2jPk!f3&%9CcknwA+;dMuTh`J{O2
zb#W%`g7(_g>1<KQ^n6BBV1MSBmekg1yJO!FH~K^#`lDj~^o=}cj#T4$G}TA;D&*rN
z!{;Gv*(Y)?qdxfz_-DHxjqd{U{{()eu{ph0u{U5D&0yBzZ7#5Rq)ivisDhjx=rm+`
zbc$5((Y(`c4!Clby2RTkl*gpvxX!^UKDYBYej^3SeUy{W-j#f&TP$S3i=UI3sY6G9
zDI}#ubeFmkSi}~tpN87khIpI|aBIG@riyJk5zEZHn$#TM>!l9r8*x`x37q)qYC?jq
ztzmO1Y5eO``YpnxzhH?bf(I3cmq|BZE)m+V5|p)OJ@V#PI=~hkori<S3MK|uWWXfC
zA$;}qZ#4SzhLLjUH%ULR*lFQ(fNwZIsg*K=iw}Bh1T`j^kjcmYMWesoOo+mg?JW!;
zMDI$(6<})`<@z$}&qe;7BsAJ|>>E}!i8fa`E>^U{Ggo;&l})u|4SK+t%ZlNLP(~j+
z*irT`ngogj8E$DOL(y7;zi4zmF3Fl{&(GswiiPS`ffE8GVW%(D8YHMCCzYmODEX;|
zW}qZ`$?^kz9?9Yo;MuPH>ZhNJG~idX)<xid)>)X#Yt<hAi$<4As$Ic}U{N4-5pxhF
z2&j<QkY#upG)C}ExW(-;!~T8^sqdNk{OL&svp#65r&%y;l0lDdvN6r&!vgh1&I66!
zB0j`%qJuP}&(Qkq{f&COU6Pj!!=0ccaz_*T?C|@p^%HFT*gx5AX)^4s7;gm1-VL8W
z`M*J<=dxn`A2d4Z|4$nIC5PfSh#i)1*dvZlC&k3e76ckRKefj+cuS_YW(=R8qam?o
z*qxq`E|NS!i}-FxJnyhzL0;n0stxcZUuAb%aMeti8nElUON8<KcomAleJ_9cDR6S_
z;Vm5GgY?Vvvv<%{UVd+He`j)f3jK&@Px)3uei>HHo6iMY6uaaFI1M<yJ#doeV!K4b
zlAnA2qz|Y^Wi7Aq;GQOJnw@$43?+O~t|o8lK+sm|Q36TAg;b$e8*x`7rcDa`j9h;c
z3d1S%eIHcQg1e|I#W0@wtbW$GK2qaLt<NHFaL{^}n|#fjrK_c_b;c}=Bk_d*tZny2
z<7%_hAmwb`#epVnl!PVuPCADtd@lQa;i}=V>^WSsb_o%`U$;M=vYxzsb`6UdA*=JP
zBK~uJ%;S+Lut+=|Nqou1x-4y?Fg8(WinJtX{4-QvC-imM{2<k8oLQUJSzvdf`8dYu
zg_(h=NZ0H|3Z-L>J2##1+u&5wVb2Tqlf@g4kH79cT^^p1y|aJWjiS5lKyR8-|Kl1x
zt9gss0XJQ1(;JcCYC*g=o4D0EFgH(9s!}$Z*uulnc9meMrBevS>JMI9=F>Gop96@Y
zAAE;Ivlm_+BGH6p+)92DFGiDpKi-a#7k1a0Iu8&T+_thje|S&Dn*vc@TkpW+w(P~P
z1uct~13sByWLTmXZ8XXw9;(VPh`Cx}zg~nDiNXAo&Twm->0wZXAALtSA0jag8RY7g
z)mw8`YGlde^*UaEcNt#vs@T?k_jS(V*DeH}Nx0>g{?80&fmJW5inT(*XF)nOsXW_1
zaG2=z?pH6%`Zx~c#Y^eYk3X0Fk%)-BnOj(9E9dOh##i>RSU(=7D8nGJwUn99qdr4*
zwad`r=z6A6Jm!A?(wSjM|KrznD!r{2X73fX%MEl!LSJ!a0*@mk!HYYGXT3(%mGDh*
zV}Xf!1;?7P^gsT_LhJk=TqnmeE;@{b&+0#To{weTgH5350*bz5<5`#zCZePb!ymJI
zvL6MQh%*a(4E;QwL*8j3$=&cV(sBG79lEKsgn&|P;&?8LgsF^5gHmG6cphhfshpv}
zSPKMQyq}W5=9T!T@cE#8&k=c3|C8u6lu^Me=Fksb#l-teSUfapDUx=tIfjG5x~JJl
z6>YzA^u6^$uCxBp_y*-P`e6R7dS4L|fBd#nC@+3?*k{Mz@FbzFB8h+^602bpL*))w
z2=^n7FNQdEFeDND7GG8jLG=l7PRiodx$Ox1O<`Q`P#Mt7j?Fek)VZ2a!DegW`jnb*
zqAu?h=sH+0J(Mi)O=4lBgQbb-=y*rGBhx-Zl%e_@q@Cxi+9RUO!kB2h>a?Tgl})dT
zQtHeEBJrgKGd>R)?$|Pp>eJK#8H3chQV5r1b+P5JeBQ45j_+i{ri8WYM5E4m%~bQB
z0BiSkLEY=gDa1vmwdYx*F6w-$<sRL}8+}hLkZc->DQV+N+62Skoo;;;XyeZ;q=%zA
z-A3MJ6Ug19N8mKwPKRL|EY?}`c<@7q)950fDz+Zc(5Ur>&{1l}(|Xhl`atWpFLX_g
zl7m`sMElxol337!$3%Xp6L0c&xKn@I8ABO#%GW4JonnxR`cdm@T53JJzw~D|i(j;!
znde=#9cW87R#K7qB<mPuoKBa1TK*?52rV{nb7m~v`tVXm!dLW*k#;v|j87khuM7OJ
zb8${w59Oc#wdx`tj)l-f8*J+B(S9*>F!wq*K($wng-@I45Spkd`d)ljeS}Woh+DtO
z>~rnx#E(FSQp30A53gdGtnG66?$B(mb1^&Bg5g*m@YX^Me|q|tq+?}5vxO1w+{{p*
zV^!W;OEcBE*{Lqan(AgtE2qYMO2R+RkCn6om@pczUPU@IgR*Z>Hr&s7s)xn!ND_N1
z4aT>-SZyDFi{EC%s0ym+4K9@>Z>*dw(YM4gNkJpR$UCE_oW+w$oh2_!F=u|T%SwVX
z62rn+*axvWFkd-BFkEsmDO#O04D=T>wJ?PU{uHXy`A*)K=0a;{>gwOVm^tyEv{N9&
zmD@P<F;!uyB@~Hv@7Dg<jhd{=Qo*;pZ?<2}y)9sMlCjGwne4$~VrY#BH!ik2jpWgu
zFX^mv<kvZ~`_%kH=K`mVo*sRhkLf_a7H2UPSNof}@`kZj!@!4cr$y9KyV(mes;7~2
zTXHM~uUZC|IN2OhF&&wz{|9?-6%|*%ZTsRDq;PlF;8le?1P>v>0)d3!A-KD{OW_*a
z-GjTkI|TROR8D<st-aUU`<#8wzW28Cc4zC%2D6G69;h+KfAn8}kFmD|wOs%;NRcgp
zoCepa77U=0o0PeLL14-E7LtW4)@ra>XWn(c2ywfPceD#yTH2H%@%do!(~@M^TG!8x
zhPPPl&Gl9ZnWaxGAKP&PR1t~LmgLt*wUiyam%o44OMY5QKE3M__qs~nc>X2t{W$m2
z>$Y*@<viH?c~9Is0dEC*H{cEZ{nHzIxAEr>Y9|~4%;wsOz~6}|(}|?niTVWs0T<ka
zlKIo-yk^7T_2;jYr1IM;f#+owjH99F&35-AWe=mGA5K#G!i0OokK&N*I+YdNm2Fv!
zfL8Ux!W^O|MO;6{jCVv%q0C4o(N&R?BiNINGMVf>C1HBm<%2-ndsw4AO+=AThNI0G
zYY$}r7?a)j@;JxUe)^1Ghu)3OAQg`*#buvY3gGvOLm-<>m2agD%}Hf7V*)_@*heM9
zr|8{a{}1yarg0MAKU4ithiI&%>d<9lD)e|+^x&H%;XO;1z$5BS`{9SAp=t_nl@^ND
z6(j+YxsiIMMCy?qBZytn83~F6KQamEN!1ypVJ{MEmC0~mlHimTay@ruKJ?I@)FJt$
zYADNi>GoRtN@G#<bJ6)KoX`o67UY5JUFdRBdHSe7$~i2_DjiEqv$B-yNUcwGnws-~
zmFeG=rHBx8p_moCBB7DQXVk4ru{i1BDkbF~m8<7rB*7$aG@{85?Gq+o^jM}vg(~-o
zO{eqBQtskr;l%o2yA*KFGFR9#{iH3hIg<HWM@Oj6gl}0duh;1}Js3$*6m>HgLogJ}
zFcil>6fZNBpgELiJe1@xlpOFzFz07V{!nV&P+IR$`s`4~?oj5<P!`f~Ho<TX!*K3L
zHW$8_xHR-19~I~5OP5x_PPN#luU<F!0DthdhDmV@+6?a;DBjaGU1x{mE{Wz3R{T0Z
zn==FqH^H^1iC~eG*5Bm$FLM0YM7KB+K8z0o01$1`fCuiZ?CDX+aK07zSPhF|m?UV)
zd?DpXphL3esO90w1K(eGQAHsb6P@54^^QdK;U>BeKg;4QVGPzu&SFReG)e+o0y_(y
z5u3IWi;z;RLjVU|aH5!(O|xT$K$H(atYzfF%acM82WTVaY}I)q8F|<TQe2I7MMJx7
zXOkg85+n_sD%ZJ<XrZcg`6GKX<B5K)n-rYQd9Cfd=o?bPdjv5pVPlOEBeRb&!=+fK
zZK?s%B(q0hxH>}difxl8;1o-&rp?w60LFrhFLYEf%x}E?1ipF@04Y)nBZ+~BA3He~
zPJ9$`2#-oo3bPLfAg&E(4o^<nPyDzK2?~!n_6b3I5t<xU?wIx2a^bpBX1xH6ukvAI
zRExwNqhBaYhU!kP*0AE)fY1)niN1xo&_^H5Oky-ok`YcU*FwbtC!_4b&`-J*fAJ4<
z?oD(3o_>uy!%aBD!#Kk$FvBN1!~cFp;Ojfq&>>*p3@C91{9{I_enz-&Mr3YAbZ<uN
z_l!8QrfMiHyMMiRDCsUbiBK461(_5jQju^=Jpx7=!@D1^yD67*$a6_q6cV%XVPG4C
z_BKhW-|(rd5Y^`tl8P2$JToG~PU5vL;>c!F9PTj1K7OfkhF`9bre<<IM>>IHQf2}c
z)r_vT99}XIB~KhtbSx36UkzDW>Q@9}lX6WQ<2)s{9)>XH<Kj&BG6=wfTK<LkMv{!a
zR7#Nn^7=S!=7E7auDhgIvlBNTe^SoYmCt!Qlj5Tf1X@g-PfKB+BI`z|<xMwVl9Cj8
zpYis&+eIK%jjh@~g@zoF0>h53oHiXUt`Oh`am>iEi=EqVP6g~1`UNKGW8?&`5vvLH
z`$lR9rfBQ+(N`Fu5yutkU!{CYAmRTK;zXM3d&(SFKf7k6K&7-4g#1G-fN?oitKNvT
zf)x!XB->t>vdvZcek#Kn1Ck=T=uA2<saPHT-WM857o|VP-y`qhsFPX!A=GxTp?B`H
zhK_PxmSqm5NSK76y=LqhbGAP9dp?C7T0JolCKvOiiss~Pblsm1eV^SF3R99GIeDe+
zy<wOVOs{6iwwFdkX}(Xbj{jbrKwg_9T$^HCdo?YvHY2+>+gI=NFNP90I7Ha)n*v-g
z1GhW_H<*DN_-_(q;Qqg;zxM371^->lyg(K{5F0<3Lje3*K!`_Bh)+;RKu}0fPzWR_
z1O^HT2?_}d3P}lo<pscR1ccrQ3dw<lrG>?0L?vX!r4%Klm8E1<q-B+5<(1?WmENen
zQF<$<_CZSHqu6^xAuVH&j;Vm2#cKmw4nqevBWJcRu58Bc|IhT*ox{YF?W_C0i~W-i
zhmJqz`#?^$U{0kFPK6Loxlj(-FfN&J4%tX{`4~2(B-XcCOj<=udeuyZ&5WO07|q%k
zt$#8)bThj4GJ5qh`VTUO3^PWIGRBPkL(yZ5Fhz|qMvlUsGlvheh7Pia_H%{yNQKmV
zh{&}LkMs?7j|s8P2>DzXqEj96wjortB}}m+LZLTWdN596I8l5wS$sTIdMZPHCR=GP
zPi>*#{ZfhEa`~6lYKxURn~i4ot#<$I&d}|i*sb2gjoy@%-t3v);)&ksvEGKE-j;!$
zj^3WGo}TWWzkU7e?rH7nsr%Ve*49(d(wo!Vo7L2t-qZ_e>Q8DON^BX4ZygJ7oe5}N
z@M&H4YFqc}*z)e&_3hpd>OY7cIZmBE%bL5$UA!t-yeM8gFJHc>Ub|{syXf3J@7=i=
z*t;0nIT_phHMzDux3;;ox(>4fto_@yzP7r#wzR!Azq>ZGzczKeHhj7^aIxNdxz%^I
zH+XY6dV4Z?dp7_3V*Tdw@cQcF`Wi<6y}G=<KEJs+{e63ScX#&iaQgUo@$_)@^zi%n
z{^|Md`3ZJ^e13lV*WE+d79wo-P3eEP`<CF6ztjIOBvw`@k+^>&u^!qn{)5DdpFfuQ
zHxeuV-bC)-ci(!a3jW%C)4gK-i^M8q9GgD``6r3hw5RA>TtMJ_qs<nR<llDRKFtL^
zq%u@&{Cu0SNvTXyxn8LX$8MlpSG6<n703Ila<iT4AcQZxezdt(X)K!uMq<@9K9~uF
zkyyXs)*rXRNUYZPErQE2-p>zw$vfLAdhM)i@Jy#!)*f4QYd)=JvsQ5_rDG+ImJ1bz
zktF6?mckqgaN`cpjaFkGl6LzpdIU5<wMO^5JwIdQn9;1_U-W#x+$T0X#hhm}-(hh!
z?0(jFia0?gRd5=$#}R?1e~#sWW;5f$^^+uzv&tmE!O>3~2&%fhYp0F$yiY;VAz2pq
ztk2ajNw>*=cCtY2{a}ou!PAPqgCi8HDU%b3`(pHwjlqp2!ZzRVD_t0?-z=rJh53L2
zeV4Yg5@)Su-j1AFs+7EY4w{Zp9Hyuab}Cg+Fm{@9AnA{Uck|#SIk_lQAKq5RLsZcn
zLV|S=<MV?-HUg(cy7f_v)aT4y+M8gZ(m`ebTqMVlnou4GP~D{<;1W}`C5IkeGCNH1
zD7ug+AB7isMZp~P1BsKjMEouSKVO2NLw+}%c**>iyvNlCDeDmI8`ByDEZu{W?bzTP
z+vgPN;}{z%q)uL7)cs-f<%Kg2<3=w2S<WtY-C*;1aeReDaNV7OQ2FiAdS&Ma2CEG6
zv8haZ#{1(5P$ov5RsIIv@No(vXEQkiFugj$b{zqb+l~EOXq=ug05{V!)5}ARRg%TX
zAZsj4zGf(&jNGQ_DCU_q;0A+VzUgMYszTfngTb_e^i+6Hu4nV{j7R*;f;$_nFoLH6
zp&ob4x-LomMl>Vg!d@D|-JLb?PBZRGG!4)T;}HeQH!P*04D5);1CRzn@pQl4NDPLR
z|AvO%!AHhUu9+iIO&pRQs-+C`avpRdO6ns}`&eki%tm}41Js-^KYt&-ml}S^`-Ajo
zyoU5}zrTru!@#|r^rZ6EWUQC#>7;H!^(mR;bjn~JQS|Vtb~I`8q+4b`s6lcteW^t%
z3dfjdr&~G;l-r}GW<c3Wo*(R=%%K)@S0Rnmdb*pufq6!}<o=}w^)-~ghmn5+)HBDY
z>D{eLJnMBs@|v<J2Z$HV)W3_fPK)HRWskOL6^{$5V)rRVG?=*uiqj26yR<jcNW%F<
zytg^=ddQ=ZymkJ03(xI?%#aO_<JXDAYwTM;q+pF<7Sq)==B?ts{uH(#xXWYZ4MjDN
z5l?lHqzsyLlkYV`CnIR{tE&p+(nQ1j<R2^g5~9L~L;_Hv3AQ=q2F2uU-Kpkt5C1L;
zGQ`(g$B>fnNmRF`lle>>Tm+aUEJN}*A|=QRiD7L)p_e*IlcWgYr493=k&VyXVR4Qs
zVVw2}lGc!f+pN;$D6~B60#w}G${oE?3uTnh9Rq}xHtC=0BOoqPJ(vN+b5ZEEW>zHE
z<*0_&z7T*7yI+6!-Qlhvg?`184yIw^*-4+0ZeLapPUsB5e;@Kegp6cBq<~zB>8;<w
zY8IuT6UIY;(Px?+x^ae_TKq^26~<P2_8;1XZ1pTkt&1ATlR#WP6Qz)1sQsdQzb#MO
zTXyxCqv(1jFs8+CW-;>J58nNfrK)nnIf!q25!ZI=@f0*ahTx-RIrvvPG9mGCv`mM8
z=FcO`nH2q#T_}TD-%WOP7{sVPYa62}3P<qeJ&Gnl{qz<~K!7jlMK+Px@KiCG$uQ_n
zLjLU~PzogFKx1au-+b1^>R5uIRltTuQQ#yS-2s4o@*jF5@Mj}XnhED#mguJ8WgKe$
z5<*jq@e690Z(-_7EUYdyAotgrJo#NIaaj5ZUTJXz?Zb~il@n9!v=4nkPSp{fqhFZQ
z@VaCgxI=TwOy2M&kKh%&PQ&6<Xxb*6m=EN%#{K8+TO<@Vu~AxCUcPN;8Y{PU9$8s`
zylw2ns;~)GTHPkQYZ_FkuuC3U-50uRo{X$;C{$WI(!Fb09IJ53aF5h>xoh3Ts&pAp
zTE9xYYdcV>bXyo%ziqi|zlf~#_@%V*xUAK&ppFW>9oc|B-u>M23BW>8HZ*#6{+Sme
zEr8v&@rI-O=gy+9FXgBq2H$;mn)*fHUnEv)P$x=Mm9OaENvuz@$ha}Mh6p$iT$ZTn
z2vg-9GJ9>xTeILO=g}RiCx}7+MRm-|+c0p`m%-DjUOG3cC~73qp*IG+34xdx^lA^o
z+WovSwWE7n?hhlP>orkn9GKi`52I$Pwa`>oD;&=QdTN`f+Vo!{rk|+%#~(nb0FO;X
z>D?Xz4<~<rhAvZTOvLdd!`{s3%?J_1t?{G_KJcxTnGAdCgmaKR%l)Vs=y(ZL-ldmr
zpT|_<4m_S!;UFeejV4u^I#(f9R{&l+@K9bx&AVmH3eNeZ{CyeKZ~U5G5!Xy(=V5VB
zwV@{7(^4InN+Dwtl(9#FAzs<Cm{j0UkUVy3?f$f~iS1mowi<1h_OyDS>MVYeZv6@S
z%UYaEBdZ-}s8oV5LBv@wqlZm|7sPKW@}!Xw1NXv<U={BHJ23mH>&W$9Z!*%u*+b6r
z%uc3t6Bp<LSZ_b{`m;ic`K$4#G`_0sI|&iA0UKc3lfF%$@akS<eq;Nb%3mbbeSv7T
zpPpcga3wvw7eQy1lT*8(*A!bcuZ6~w$8QRRUk=p=TqXWPJ&g&gr@P_);U$69(2P9)
zLCidY9DHD20bw9eL<l4*0v3}K5m%CsQjwO?lz*coBdaGP{aI4nOhU{?T-Zq*>>)1b
zEhgwMEEpsz7%d_Q0RuBYz)UbOT@;w10L<0`6`O;q?7>Z5;Lc#7!8oDO6!D2H>4_Zq
z$$X8;0^RW+dV_h|-Pt<LnFd9vR;kI(k%_*6aY0@&p-z$E)?pEr!4by(VFq5oA3cKf
zTm!V7{ogzKy>sx@u=jau=c8)pqh#Z)@ZDR~(o4|7i`U$X+sup8)RX<I2it!XtFgzw
z$eq>rKkADc%O@9R9Y<y@M<xv?CPimPad$>>4@NN$MiDPYAzwydFrz>OBYzYle+;8Q
z0;6y$lWabVS}~hWCFj>VZu=Hq&kjDHpL~8@`~ls(!M$9e18fn)?9roa@ndXB6Rc^|
z%vp1cc?*m`78whc81okybLN>c=a|xGSyE?MlczWmCb<(P1QRAjQ>J7yrj>JMH4EnT
zN*4^v7mX^HjH{NuRxg=WFPc>^TGlRqt6#BcT(xUjb8OjgZQpk9-1F-G<=uPe(|6?C
zf9%(P;s?9;9r^bi2K4?4?A{IT+6w)-7TLZS-8>!FIG)%rn%Xd&T|ZFJ&|A{jTi(=L
z)!bXt(p%Ts+tAk2_+P1`uc2$CesH07a<6v&yk_a9dgZQW^`U0%p>F-5dGr3~*6+dH
ztI6$?h3);7jjdH!90sgDUR~H;ncQFOIhm`um?^lK$+?-%zMac|SSo#7sd!qedERV%
z*=>6{?0z}ve>od|xfp%99DBZ=e!5wD_`PxWd;j;%39Mj-*?F$6Vc{8n<!8VO=*yd%
z^WVQ=1@y_o!|~(e;q&v!^Yg{?%kSssf4BPl6|3>L>wor`z@GdUIGKNVN#L!_yZ@eS
zFpmaHHh2>)sbRMoSN+dqgRXdxD3Q+Xx!iab(>s(yv)aEW8`Puoo0fVXI`C&Kzh#;F
z@wa4yM5ej;b|@p?RekaMDE%3jm&EDYQk-1e%kl5qUrS8iV95p}jbHWSgr;9Cf8Xt{
zb%fxv8(?PJ3{w1o{;*TN;vSWWZPagC3``6R`=r4bPn?ojOM*!P48WJJxAaYroDZ?0
zzm*^18UTbpp9jdwUACELvm8>M@BFDTa`Chot@NIOls3HZyx*mm1#ep)_BUM~5Q;)y
z@Wprt4sBkup^d)fxDvpaM$ZJJh(fndsIpR5Vm;maRsLAn4~cIE0M=c4WE0TLr#iLN
z8S{NjH#~kXC6jnj1tyN-&OSKf2F_F&QM^KpL&XhT0%^xsBe@yUh7cKq(8}A6&E+VX
zHOruxcOc_$njkIVs(nYsx}Fe#v3AnGBaGQ%n*WLD@k2yH@BSj?9D=Cghw#P^GvVNe
zU`*@`!{tZ}Qnv&k#UvL!DizuDEk^2|MD0h(@9CsVd<>Wj>$Xh&kc9|J<Xaqes<{{$
zeJb7EJQFxWIpY{<UhsbGo7^Gt_<h<t9N@<=VixIfSGW8yIl(Whamgh|#Xq2Mqt!>Y
zI}ix~U9B9^I2yvs&`ObCi!6&gP)1M(zmHA2S1(e7;d7uliB=>8ffbz{PL6Jg-478g
zMFuQ#+<Ikx4$m#;zASXZEZ9Z_uWURMVs32Ap?nd@AZ>k3+R!%V{=MU=!e|x5sSGDU
z-+#&$)A=XBKecQKjP|9<9cyLE>d#_!kI<j8Zk8yQ`rSeC?TeOgz6q*s<}JBQ3PC*Z
z>#P8V*mAheUMx{PtVA!l4}KEY%OU`ut){_qaj91_byIL**VhvG(I2lQ;>05P`o8I`
z#yWmpy1!HhfA0MphIo396N;##$5616TEu{X-2RLs0Gwf_mG+9Ux`Ikf_?hk&eNcS_
zCc`0}t;``9-KwBI8%TevGkp~RnztY{8Qz1KRy4B?%Jh%#YYMRAQuH(G-$k2iwFr)^
zBE&dPp*$R@pu{uJUWFYXj5!_oog0)NO%xbTlJ}>m3(q>e6Fc~n28?$7^~a;a^?;^v
zx3rk8w0-}q5pnX(G16M*sq_xHrq@FoUnulkhAq_7m_>riLu!D%GI5?lXCV5cgQw@5
zY>fMcctKx>Wlp901|kuhb+SZvc@c5T=G^0lf>sB@DnI16X;16P2oJ3JUbj6MQ0@Yr
zDAx#`xt>943ljj53g<gEKCQFmr0fOKNSc}vILu1fn6ueJcPJv5c!jA*l&)kvSR_I1
z>Y%X~P#|mB7l&C5&EX*M<1{9|oC1Pu0B?Nd-4T2#j#mX4W-_9z;bO>_u&)ZU_D-qQ
zc2=CZA-umItb^fvR@bm=$OpE#KNqg#;hzJ`A}QJ4hSzNWVcV9L44MMPT+uF@>}O`C
zC|Kv^l1>-((-2}INlm^Ps~w)>15NXI7Pf67kT(DoRaGq9kJENjL4)O(rE)Lfkq1<~
zyzl6cBxK@N#C11)xJHZPR`5{KTMVm^J=s3)AQ-du@Vxr%v4wI2PtCoA4CmaXWZ=y4
z8T1|%jyfz4`GQo6e+L;Z2pj=#lO5fynvC@d(^t11`f<3bI~Nms$s`%;Z65QhZE2XX
z0lWaAg@eNVc;koxUIq9{@=mGmT1n?hdPEggRaf?ZjY*f&B&D?LBiBGM%+E|^fb$?A
zMc%(=3E1uvAMVN`*T1Aw<o$ATGtY34m?wFRkDR(s40BctBa84U;JS5Tv!tM)+*5=k
zXWuY+1kFYf_3lWtbZV{#6w`bQ!vt-!fFbn<Kj?Y^3so~&1i3ITNg%72LI|x-Kg>(=
z1I;Vfh2wcq;4d$URLvI_nX!XPKbV)K*nh-`_Cs~d7`r3C43U(mU=75x^jjt#VYt3v
zZ8oK`mD3eYgV20=jtZv%5HBs(?39D!Ev%m2IYNG3N}xA@lv{5cA<r*2a7!&oSv$k(
zX*x!PK>=7jt%ScT=L4&!x#ZH>|Ei~HXWJ{B8uemM?Cx3@esj4DywbmnyKCzcc<r{p
zuJ^m<u06%^wa2eC?T6{R4ww4ZUU%UiUaszbs@}ZzL5&cA$G`6+;^p=uekMcayYC9K
z<qlwOBSwFB-)&jV9RzG6#InEdQM}|1k^e}58-L%+%fl0<wTeerd*4TB%M)RWiAy?j
z-~XzbC(79hKzV&X0C#aIfuKzr_KZ$;PE!(iC0GJP81|JA3yaYL|1@h(pq0|Fs|xCh
zaA5&|PfDFg%v)XEZDANmuw#HGwJU>Zt2arAkobPYDeUu#FEI9y%#rF|E9jGs;cU4m
z8VCF`{*GqlrHUQ?UBrkE?CwW?BdGyLNW#fL|IRt~GBRDCxvA{7#4OV%LqhOHm~)|-
zNh~uumG4KnQD@Xpk8OSUBn77w{voV_<B#n{%rvXlos|}hD)_@Au4CWg|7JepLi1b9
z1I-%+JUW5GLysfKJxI57+}^KB^i;!C(WTy`;ml6IM?YL>R&Ga7a`yD(d-M?bY19Xi
zTzUqo{clSHll4E!F!wA97e`6oI@fNsF>S#uo0%0j#!ZPF=^wlM?wa30YIKiv=+M^?
z!Js?=L)7ojQXq2RMh_GmsqU>rx=Dh2*LhxW>hG?%#cJr%C@pp!VtNfCP;*-2IxEhd
zTfv{HlAa2pRiI0*+nN<@&iIsjO4pUPiSL|Igg?HoJF+^3gVWrLuW_028nD=<+Ql6c
zY5Xo6^+SJB!*nE_af&IMkjli4aPE$sbI->;Io+FP%FOJh(&yM~OJK3|+0j=QL$N)$
z)&+FCbL+~NCYFg1my&1fE40G}t`gz7t_&;i%Eh8fesiU`r*x+tg;~`XP?^@DdE>&^
zCXYv(N&%*{OS${|$V{O$qxFlR`p@Sb(WuS-r>6c6p2yd8PDh<HE``z$Cl<*s(>v1k
zhlRka5YqNlE$FwG+39sA@?Ebx>8F>=cTLax!Q78C6Pv$lsk_d+#eH{Pd&ABA{J-ZV
zL6kGjWWpaR^cb|KNW!xtH+JW5B5*~dy3TQVO>2UV@GUxlYwVZ5RYQOzgrI`hndj~I
zt!oRz1qan4;|k(He#yY~els#;tFs<nszz26T+jSqfZl;ey=j1f8Ll@_X^K{?82G&s
zNU`n9pr8$Ka{wrQwg3PrDuS&sQG=kiX1EB!A|e9}t3=LbLAFuO?gsDO$O%}!4Z6tY
z1%;wX*aK~diCKDVun-2U_y<B6oaIZA0#YEhve&^G2YB|{Ku4Cad<6}0emjg<XVkX=
zT+?Be3bg)2;iSGHv1WAR4Iy5+;pkI=3c!%F1|}U@+BfnMSUiEdwoX2cj)cx()u=(g
z8yxdcggX}l^-UuQc>-$doOh=j6hk<d1|!OtBC(ihx97u_8_nZFq6m%rwIC|K+hR=H
zks=HcJqjLXi|k2-tP+dvDgDv>)zN?y9XxPs?E6@vlvuLnSc;`ss)tw_(l|PB9D`0A
zlWQDHN*r5r9LG`|*FzjPEZKk;9M7*4FX$Q%N{JV0ju%;q7kh}8AWe`0C&=g|$hjsc
zq$DUdCnzr^sJa@07rB9&&LKvqz{NPtqR0~3C~owikPwoO4{@7=CS1S7a+xBCcG+cI
zFel++dU&Y6Eopp=^LT1to5Gc_X^Jx({D$fra>_z+)E};>K-<j+xp@n53E`|P@Hh=J
zF*=03!3wp|se;-5AjqTJH-+LZ;GziL;trx+Y&sy}TnUmVC3eqG`s$LLlJ{UuRuxTF
z=#p(7+1~l8#peI)B^iH!0fJt&$6yXuVa~f|ET&{E7dL0DE@iAgWNeaVZi6#-bu#x|
zGY?WSkD4=2mNL&mGlyd^PqMKO)U$3~v+h%}9-FhCm$IM_S#V_82twINy4fgh*=VWR
z7%kbD%h{+U*e5nPcM>=Rx;aE{IV7n$WGy)q%Q;k!IW%OsbV9idy17hlxh$!<Y%RGQ
z7P)xCINW4;yh3^Wx_N?bd7#uhp_V+6<vg*+JPERVDWQBB-F!K>d<Bbqc=&%J)nFVM
zSjX-O|F851bw-}Aj69BvJVA^+5sW-xj66P!Jc|F$hG6CavhV<5_kVx#pT1$>0sbe!
z-ta#^`A@&~-};dk#Q1Mw6%ZDbkd=6&BCo2Ur13%Zy|(%Xowr)L|1Sk|EB%W!wDta%
zdZ(lJL0e1rgNETdRbzEUGiBND@{&#xB5uM$o*=M~0ML&g7{Ch*<N*fp0E2mep*+BN
z9$*>|Fp~$E!3#{`1;+CMWBGxR0zjCHFboU|69q*|fMR7p$qL}Sci=KTaGepj$pqYH
z3F@!~b-IAMJwZJ_z+Qh~Um&nQ7~CH!)E_E508<!vARIUt0UC@14Ml@T;=rRxLgOhy
zQ&~cDKZF*F!HZ?!@nY$&LbZlMz0v}c>>sv?`JO@fVa^4~pMDf6<TQz7cJZh6bEm>G
z@Wwb&C)m@cSbxm3lq|E9udr3D@>Q+L)^2=k+H~vO4eI?B(X*S-xsm#FCAWR9tZlry
zb*Qdwps~HbsiUv8Yp8E{YIJI0VrF?_W@%z(adKv1YGw|`=USK^-kfYcm?%CS&pIDZ
zznn<Bp3Zq#Dt}t3eq5`2*l2j%Zh1QBdOqrXJ{fp98~S^H{&F?(ay|8UJNNLg{P4K`
z@U##6D0z9gdwF^M*JCSKoBi<ea{c^r_V^4V2Or)(9p5}1Uq2pQJse%!!*p<VyLWuO
zeRQ>Tc(rzTJ#%<FbolV|;JN+arStHm_xQR0<ay}ydGhpe@$??nv5WuLCt%3?i~r0b
z<PC<zlk@#Ei%>+n29`xAs1~*b`bQRFMkuUf&lPgT{tEy*Q^*soxOR`YI9^O1Ul8!O
zEJFQisyPAGWbJsCM!&!44|)-%wjW4=;{!V7;Pt;c_VeH-pljqSLgLDeo)G-k$RFR0
zHra?^6pocP)$EP1ktW{=kW_6YRUc@4vFGvSnkGOWEpd+GYO=_pGUU?6n6+w8l^1d%
z*138=%#OaB_rw_|t8-A*o&u8iAk;FMqo!w{)>&>lV*PWB^J)R~HbNX)shoI5-fla}
zF-=zZaT`vzyw#QM+83^PYbQIW!y}v8>D1bmS&m2CVHYAI6adsws*R9V@n1#Km~uOn
zHCD77J7HG0FaH{><NXJIkjObZVJ?<u!<@-Lj)u#=(>_gkaNQ2z%MuxcNXShAbo4mL
z3a0bx)5mdmUmeS`Ga0`UMpAC4YKw>o)RipGe)mzbNAg-SaY~<6o%OCxFbX&_C>RrO
zK$U<YGWg6h375Y}ZvxDQuuj@=!9t4kS6rk3nWzUtg;~gqHY4^s9{!k)b?6wX{K1%Y
z1`dQMLxj%Y0AB3Z<jC>4VXrC}7|nBh-=QadAiFd5(mO+6ON5?>lCB9@W601(VjYrD
zIy_?Wuflk*k7M*5QHW(#z1YTzRjqD2Xp%)V82UiJ#TLsSNn(MlIOU<f#@q-&!`tGt
zR1y_@P7SI18D+Y9#T?~bw>~-Lzu7*vVylovl2B{<eo8rEY8fRhIR)>b-h1-dbYbV3
zoIzg2OL5gBh_0$w{Xi0q>=8G4A}j#Y9FDkda<X#C)kM4r$={JtP)|Iji#RVwV9bv8
zkHARa1*LdQZcF3jJ?*<~&~$TwG61uNK+)ldy6GKmPIdov86iN(p=V4DFc6bKcZ$&Y
z#8w+}28W~HX*g^wd$;alV#$MzR9n(#amW?<-p~FGGzTcWQ@e=Oo@*zG;|`)|Fe`Bb
zRZufPfo>>)1!I(N_f3EG*!~f@{qZ?;`{7rX{Rg6he1GfNWrA3s>Z%ct!?{FzTqIAz
zPf1^$^Q1b*Rhl2)p>j<p_vq`z>mKMfNc5e~I$bOE?DM`##(TE|heKY^!@{hx^@`Ti
zN4L>l?@9M_q$vt9>0b+D6>A&pQI!(*jl-S}ZqySk*FMtJFAb-YUn7>6^9JFcd43+C
zspvcCQID|6bRcsT`XX1WzP?WsLmrOsyzpN`4m73UB8=fmtICqfEc}_{qx`O&MyJUu
z9{0m!AU;ZSG7u%U%kgF0w=P_F2F*{{Du(Ghv`{MKs0Oi%+`7u8$DJCXQ8N>XEFb{M
z_cOY0O}R}(kKPVk@{qPm?6A2sHY&PG$hNZpLQSRfM?WKimz_qOMJozxzCm}qul!xU
zoM96@>3Bnsj(aR_8MI;w{%L{qNKtHscl@-@{9ltOTuO{FwsU2JLSn>KL*o$Nq@1wb
z$XU%Qn!eT~3bN_VvE`Q*#5tY|3NfjpZ<z3_B=|I2A{$daWn-ydO42OC&?j>nAS{-x
z1c*w==VaRhIVdamx83!Bx7mh=WqOp3g9@Ypo0!ywvTdKGD{V>a5*-fZULSnPa-Zyr
zM>L-V-Ojy!PRC0UaG*v>Zu(&uJB0ZHZIKODf72N*3a4CamBBx$9_a9JmE26LL=QxW
zP;+JS!FByYF?U0e(`BhOiIyc8`Xyc4Hu?iHX(xwqeW|&}6=KV_0smyS7{hS9KOz{p
zmb-;I1w$zkK5b3Xn=bp)Vjw;0vLr)vN{i^$4NYR&R`Q8tx^We)$GL4H6AD5B*tI(w
zu~>?0la|TGEKk)g;+<t@HC9yvf0E~HwghI(E61iFRTQk*%)t`0?k#^Vk!4mj$$i{&
zi7PI^T&W={J8p-YF|ZxJi~$`+e-P}gqT0eV@{raXfYBciean2Q;<d}Nv0)v1nTaqR
zWGHN}Hb<rWwfsnI^Q>%j;(J)fjz6Ru#X`_vky380q^(z?jojF|RBkgcucyxG)HF!=
z);2hGWmo7<aO8)TO&06~?1S;E#d=uB&W?Lx?F%~r`!3bS4m$x$ZrfLR?L1Yweyfq(
zeinIdv&FvgIGogRJNDY-vUCH=oAeWkb)gE+v5Alz(}|*5H2^5vL_rMc!j8K5O2e^*
zK_ApjG=5>gUABc?8`wjIZL1~0v5f}|>}685RaY<DCYlK7<BF<QGUV7HGY#k$9Osd>
zDchkE4;T=`u95QL*rg*57?e}xjf?-d%lJt}HzZ*&KPEQnNng%p5pT7gWMDT7q?44Q
zgxWx*!N|VBM7<_40DXZ$^`Q~XBd^ELTxLJEu?XjnN|sFXKKe=uGIJC1_}40@r{h>r
zZsMz9o6Z<aMShfEmeb9An`jRy`t&iBi14cRzG91-lTxkFC7)NH8^XO~_J~+GJ|Oa~
zk6(8Yd+xZqHrumi7rOZ1*cnfjl<dDxwe=ty(-B7*>2FSE?k3u%EMMWQUCos1=IA{A
z`^aakf@JA2)We!EMpdO%V&ajpUUi`STr-FG>#tcCsAFQKXQ7hm<8*_)<IJcE$TnC-
zsYVWBSL5m9R!1-F<Fs8{z838~b1M5CdK<AfO6R^4Jv(gVFf*-UYWVAE5rz1Z`=j)c
ztH#rJ-MBjmD1*U?rXfA?Fl&P(#y6|ivZ-1ag#tZ1-PTt0aeH_Zh7q&vq2aBqd%f#T
z-rTz9qhH-Mri^qu&8s6cxjCtwpbicv{ihIj*L@NraMJCXt>#M9_IyRngg>@J<m=#_
zR}Y|NS%Vvo0B%Z6K|ap;IZN$Vt4IF*kFr<g-#lkR*1_NB#@Rd0yx>@=FRYhWhg8pg
zl6M^3HMHh0`<oQ}My0BZ5|KnAK55;dWcp;F23dLc<Ey*pw!?n&uH^##`0KZOV($b?
zQz+f@(hTNXllDp;pp7B!PuH9C!g3;LgNs=+i=Wg)w{{Bl<OYP(o9|t79q)VJ__t}(
zcw_{Bg#L8o3a^BX^t_ZiI0zQQy*s*{N5W6!&adf{pZRE^O>339_cNb*Zh!s^ysq>{
zzyA3L`_>z-$PfmAK>6T<!eR&mKtSt#FpECH01&r?zIZI3U;v0SM_-a60~i3}SE3iy
z;%7<{zbyejh9(0V7e7W5KQ=Rc7y#lt(T{u4=rzcH=)J#Sh}TA<KWmV`NRb{40CC6Y
zFGb=bqaA?c5}@GXqu3OHu^6Db=%Y>&2ml3Yf_y)?1QJ04bs@eV7XvBo0}bzeg+W1Y
zw1Z3r1I!>nYB1IVOQ7|A(0h_#yO2N!GhB^Ei`Tx?OU?q)$t(_ecD?e%*IL0qrXVOP
zEvRi4CuIT8ItX|WV|CKw>8D^iRuCNI65<TPZ7Xzqjcc=)XPHvynCK$jmK>Toh?jXU
z#N%fkCFe=XZxMeN=1b%iHysk+NRgr7R^b<3bpIu!N$%~P%Raq;+q^qYFI%+s_r5!!
zNfW>iZNL?iW$Ar50N1*Q#LhtKduE8Km1(#}vTLsv>r|7g@|W;=65Pd*Z?syhCG%e1
z(lVsMfY=5Lg<rILAiJbw`9l}|u7ltnmguIdsA&XBgr#qpcg*Ya)Ee>8wRa%T#puqa
zP`tO1ex^=$DA9X-(HOR2XrZwg2evO4?s%>M)rN4Ky2!u*u~`)NEv-mc?1$6-B0aWi
z7`0X$=H=Hg62S?1*ETcI=~f)iJ2!7BN1tBnhbAv-R<Vwdcoa!5SCX)Gcnhjt35vtu
zDO+)kWTwO>_7DPdhQkD;EgvgpSa@HOig^;wZ8Xl?B#RVI$@?S-ZnB*@se?{(m~FC)
ztC3Z6a=?#duO(t1QV98casb#c$Q9DT4+&c$idceJUP59X2w?yS`Xoq_YZ4?S<yAvU
zx;bm&LkjbLN^Wx!fllfl+0-I1c}{aGdqHZ2c`^(D;R*vl3?&!3riGiQwXi~90Eobp
zw9aDja&USVb9z5murDQ@qdI-G7!TI8li+4do8!*vWC-7;Eka#W2AeY)Z8O$gBbP}t
zRpB#tmjJM){Z(w{5!hg7DN{<)to6#mw~)BlCp6}b*)B<v6>WTOaaP2aShuaLEcEO?
zMDzZ|@M}Q_5{GD`cuZ+#2Y{Q$;sOkiL7A156l|WY=47pC8mc>BcN*+MNe~*%=R$Hs
z%|iCA9QB*oo#oPpR0=XdDqYmA0rv-39m1N+bL9LGWX~g=oes{sba5NFPUPwN_Vt6k
zh?@(md{+5<h*WBd42FvaBHfZ!R^7FQ(xXe{KtAh$Xt|)tI}6xLVY<uIo5}g+c<}~D
z&W4XD)(<h30a=l6@^uS;)CcD!4JJ4O3T=nK^$~eNzY3-BwYcb6<QdS}iC~Cm*+uv~
z7SN_<BmFYJ{ZRB^4)G{5dtA(=m=nqla*+F#{~b^W?h}F)06zCw=jd4yU6~bb#^q$C
zqVT14YycPlqFJ%Dm8`V=sN^R`R@ZW7Pf2E<Tjqdb<`7xt$Wg{vOU6W4#*}Wx3|q$B
zWBS5y`ci88ibeXGQ2GW&`qpyVPD$FHTiP$hv_rDA<D=BmmeljG)JwL!TDQ_2t;$=s
z^aqR7rxMER;gYqbO6$u?<giMFR~fK4!kLsR49g5y9N`ja72ufgs`)EtEDm~cX{s)(
zVl&<Wq*CUw8lSd?jJ+BIK0fK*{LCz7h8UW_QCdao&Pb`}tXpVZAYaqgQr$FNZDnfx
zZn^e0sJ5e|c(un%G>n@THGJV0yDnW_XGyL17h!E7#{@z8cdzVK*~`?)-K9(mCs44y
zrq=hi)K8!!M46iQ?T0QfHS{YspwZXX{3_&q^IfFW@)=ymlm?i)r_%~!(Rd2xIBa}1
z%vORT-m_D`_*jKs8U>3Z#6N6mLT?V1tdd@Cifhe;#SxyRG^UbgrK~ioJv3(vC*=ya
zH0ib!C^c(_wd9qym<+dMAGZWyv}UlkrVKY1=#|!$HaEBzwz@aBmqNN)bAGZn_b5RI
z$RR_=$s?`FW8ujYddXAl$umz$bI{VH1<Rx*_N0~LgthSa4ZXN6_Sl`3=)JV4UzU-F
zPvOVmVfBJ>2wKkBCGWJzDF-&$uHU#%px7VevE7-oqszB7DS_xyT+5QBgNgI8wE%SC
zMT13v)S%+VRy<5|Pw#g)32c!mg|YN^?gGxS=(t_-dR2%Y3j<$?GcUv#w{%uJTT+j7
zxya-wm}2_rS-qySxcB>!9@G?c-!TbrQ7+8;uAAVp+s)7nnsct@CC?K)v8o7mqUr8&
zJm{I7r*_QF<46yuObsz=E-pi?`_<6vG}9ZtSU1GnXLrz}5N<)+7~N>%#m(Vr&fJ8g
z+e9bQKb+&VRM0@L+~FDO1g*@bux4)bJaN{u0(>qF`8~qsjM@3a!qaSE!0b850@JL0
zGKOvRE9HunTzWMUW<%iWph@9?F5S@b)4=mQ&INbBXRGJpR%iNXU#6DhLjQn~6$S57
zZ-cWNDgTgFQNN*Fp)jjBRdSzF=r{FcddC&F&nJWV9-i&J9Yt0^)k2p_7!-hDfFa!B
zJU+*NrOu~lBsKU4KsV&<sR}ha$K5u5Q?Jc(tJD5yfN@mYqiFn>$V78#<pV{^*-6uB
zTIiqEo|m>Jc+oyY(Q4$3epIY#bd{l3YgJe;BRE*K_?}g`89~I~f=ES!$gzSb*8-`_
z18F@2=~V(5DFc~Lp#iMz0ql_hocaN;IRkiJ{Q1WG1v31B-~7R%{=!)PqHBKQ<$jW$
ze$py_vh5QJ8MBI5qAc#>3JWF|t#;G>qVVanDr52CAGnZ5tx!iB6g=mGM#J7(cD?v^
zjh+lCt+}9LbbH4QcsO<I#dVuz%pdr3x)c=34Vy}|VbcAYdul7zIV=qMNI{|1_hQrc
z?ljS1&C`-{!i#7~Wu@P~ebLQw!69e?4|ULQHOwh|-rRGpaIr}53M*MTK0{?GaSSwT
zwv_k?EPamg%9t=5i_y{VpT`4wdNyW_E$>~kp%UlKVXj=~trYz`{b4MqbMsaE#oy=;
zGk>Q)c&;sGtSz^%!M3i~U)DA$*SAI2clFozJ=eERUv;YEbWN_Gy{unQZd{3O+~{xI
zdT!ijY&^DaJg;p)UpC;VHW9=&kqkEB4R9`LaBiwLG1oV-p_>4zEj+O;0)s6guPu_y
zEwYX+iuElj=oSstHl5fuB^S=+B=+ehHe1Iw$NDxGbeo%MhgWQe-(W}3YX_9MBh;}Y
zvc4k*-I1W$l^Wk+G1!&!+EvKhRqWVRUf)%P?y6JmX^8D<8ti@W+SAV5)9u*%xW4xv
zr@DXn8m|5})%`o)^w+_mzKI1aUTb-Et+%)L`uZBiq>oQYFRrM9@oRerhpw-096Wru
zg(bgO+9+sf!B$&fXxqofCryLTJ9~Ru+dHEZlQVPkvTB;PuAc2(J?9q}ODn6VXJ-$O
zkJmRhKT68HgTmT=c73t3nO|JKy}i5n{ky8J;q3fkc79=dcW-EPJSHjS{{DVpX&I7{
zeQ<cRy1tQHSaNxFB_gkUd~)*5(Y0@ISVPZnV{5DRXJ<rQ($>yyT25Yf-@wY+dRcXC
zO+(Y<%<TTJ1C#Ie)%A@jSvg^`30g*9lhU(VIyx=voPwib{X-)+wzfgi3YPZHN5?0z
z$*Da9gL=m1bBjy$&8<b{m6A$teM7=OTYOK?&DS@vRMgbj-P`Zz?zM68h)#rDTwW%o
zWtLP_dj^KAZ*IBx_@ADg>wGpTD6N342ASD74v$ShGIHXQ)57BtzdO4JN5=lXy{)LJ
zPfX1?I5?P^na#>C+}zqWvak+~iFfw$n_F0{ZET*Ho=Hf}$jJQxO8~gJxydUk85$az
zpP!die?Kxl5gZv45tpd^L2qewwWhH-AtgODI<CF5TU1`f(Ck}KWK3ggds$UY|IkQj
zWsQ}C%ize^_~f)-XoRb8KtOnuh`dU4Qc7J@OL9h5Wo>;|Z$Av^{QqBn{|o%@_ptaZ
zR{uHG{d=s}Kc~9sZ)#yvU6B3J>d-%?x|E7_f8WFU`&9S;$n-rO#KlMWSY>lLoI^>-
z$k7BxF9AnDogiVT=$Ek4g9V(t7?JSpBO^coK+tl6(0)Q*Fz#&_4}&lf$Y`iCVgk^F
zH4&Ps7HNEpLjghrXg*(hcgZuW(9mq85Ht`F5ki<=u15fAln8a|w4I2-VdbCXZ}6mi
zUTq-J7O~J|_nvR|ghG!Ku66@982No){n?R&!#${Ame%|O?=Fc>jZijdtLf=-Dd^~n
zWWvV)kD|gGFiC>MF(^wciNQUoEs26;2nUC2BA6rL=rNfL$DUw^C@G;?wIykSX*f&{
zqww|O5F)8}Vg_Iest022sv{xuHe@47f{q5iz>AR?`;wd@8_F|#lH7Dg!D|9~m=Wuf
zQXJsAW!}(B88V?z0?jvR;A{eEq$P1PS=0lGO+uCes>hO2J~Ck@yz#(!Lo;Zdg6<RO
zNq7bOh$Vp7eu4ADvpA6Oa^W_G!`75kXJ8rCK_NrX2_;R^@#F6$#-NNvHZj`FK~tpw
zE&EG=%K&h%pn@0)1z#j|wHY%JGI+>Q)Fo^Jv3YJ$I#EQB0EjY@Xf$v%6W|=*nh%TG
zTc4a2Xncu88hnW1W^&a}>zAyBgG#Xt>AJAqZvr}hAViYGp&3g^1YyDF`(}7&#MK3S
zViuuAmegwlAe*QtSL5R%<ahQ-a3O6{1mI1(9R#LqTXZ204>8AJ;1j4L!rcocSiq4*
zumF&Ro&^R{{|Zfz90Fg!jd1l~9*)8>B>OQSr5FZSAkd~G5FmER`r;r2rhiv3WZ*$G
zQE=dq#fQjVb`y!P62W1SV<u#~14@U=%L$e45HJbh-cI&0_+ze1e`9FlmZYx~5-eo2
z)~1E7GYJ)}TOeo9!ePrx#B88eH;_rty!qMgpnxkw6-*V~O)I|(G0kjN7E`C`Bt<F)
zE=bgBC<ww$4K;R-p?n4S;99YasUIQZT5^mK#8dH{nVnSxq2YUcjG<=fyzo0gq5T7r
zho~7m?4`<6!@$d8%U3BiX9kvMb%+3@3ZyB6t!nH(o5$O>U={YXcC~|o-)~`o)$OlX
z@}IBB1YYVsy;alyJtxc~X|ef>So^D*)d_o=N5=pwvKx*E%2FqT+$F{J9=7L~R+^x?
zWQn!rXn3TX5rlnWpGU@Bult_C4ws$RKIjpKC_Qhmn7Dm$Wo&rpXu9AT1<O9$;%Grj
z<8_V=27<6si}{le;f`n)dse<yc^(UIpfL9a5^x&=ZtW?g)FIvB9&DO<S4zdIviK;-
zJ{XR?Xde*_8>g{$(T*N-mJHQ<{EFle5vn_J5Y)5$vz5QXg{(|rbW;fyO!&W@H9XuT
zfn#JsLeQ6@knHXCuduBSr$<LlZbM>9fyjZ-a5o_(BtA-jfG>r|R4WlN{gG3XK?pff
zjwkjtr$~ml{-h~Ys!27HVsAZzS92uD`YYb4(gec+$fl4q8vA|m;yG~vzL-ey5=foN
zsBgw`m*ji}R}E2hvcIq)8X~HLx`6_V?<>6s>D}uGF<Rk$nV9I|-=Y}-%b*kr=m~us
za3D)y6XrevKDw-LQP*2R5(EQ5cn)}(k*p&>Vk8A0_~7EM6qG7B^3TX)2{8jA@DkBV
zi~Rx&9TwcLLf)FFRzX%zB~`VMB+{t}QHZ`WzhcXXhnqHh=X(&U2DzN^_X<_;ZNY_m
zPm-Yehd(BNJQQA+MgbR1Gc>BD7sMT^PD#B)V~iky&IyS`6Qc3OmdZww7V4D{noTA(
z?=nWQl>$g)YY<HOpi_u0g@4xcrQRg;mt`#BMx91wUo->~Hc3Qc(B-qdbmAfN_ySC7
z{dly0|2LSv{~vq}jU#JkZvP8kgTaoNMDav^NFrzp4xjF;W4i8II@#iSWL<y2`QCSF
zI^&HWByfnBEEfo>NEGmQ3v@_9i{4atMg=lxc!*7#ey&Aus23MqBs_41XjQ?!Z40lZ
zkU9}4)DcE!)qYmQN_ryaenK%el){P`4|*HyyZP~;R~f0(T`7C^m8zwb@Q3Pkeh6!d
z08O9bzKx$`8SbVs$!7vSAHbzBDdz-7_qiue9HP$`%ANa^^D$m%0`k>5Puk=N8<!D8
z=Yu#q^XndROtm<34nekeyX{&Xu?}#Qdna=^qrdB~Q-{lhC<^a~K=k~Q3|Q%cDy}Ms
zhDe#za0sX&1wGVJ_8F*#CZWjMU%V<p^3Sb|hssDyapi6h*ghUm0GD|hoYG<iK&JY6
z*u#|#^$6TC@I$+)Qa=hV^C0O*p)8N%e{gx=4Za;<&A%S4TfeNXe<Axl8oI!D>-by!
z8BQIT4UYlWg@|eMmBuvav%B@JTz;gL%DHYIYt-+AYR^MmX5ocI1BFUNY;)$h1-Mrv
zc1=BnOrQb1b<!Ni%w_>IwH@;LcS*l%u{O=p1$?F;NfWiuC5khjbMOKkRVSiPZIHlI
zDorWAeG#o!?4P)20bGsi(V}msnG>!9lB=%hs9`N(@5(mgxxkstjJ+84uA$0FO)DSQ
zOjAGYdj5g0iMr0X^bFSf$>GHxrWIky0l%~-^}+3|K;Y&Ci+LX<$5~RW!Y5eog?XUk
z$z(?PO5*sXM*C0eCaT(fH#zhoM6GR`c;dca7<w5K-L}gNv!m!iuOJg``@o5Zad+r-
zHctD2yxQY*8uX?}t^G)A;&Hwe`nxK+{lrx5X?f*en7&k3XC@8ui|bCNymFtLy|O+%
zuRqOUp@Pgd6#Vz_bG9z@mzb2jepW*NJXs(Pb&<e3-Z!+FxLN+})HrWnb=3Mv(HiBr
zbp7fM<pL_U(mn*@8+?crB?ZcUx}{$L<<g3&48Y~`c&Y;(i;|o!k$L)v#Xt++@3oAM
zwcJYu0Z5Is0Zh)gK@Lv8tSxWFv}?S%nfdNa-H8`L#BqOxE0&s=u6%GDX7YXvChd{*
zL%g(L?)RuA_Oa&k(Vq4@Gx3*ow#4kR<wN!4^Y_31CCF9aPPk}4@WGrF!aCFdI2<tj
zy5NmB$VrAo!As(<Vd_N&F;hx*I&}{83$n;2vSDlrzzy-z4+(1d<q=8mR4Ms=j@VAN
zD6rlByDbq_Sdjlhvav$4JG2Yv^%+6TnvRl(#A2OE>dhU~AhECg6*V_eP`h);S|dUF
zV(6R8&}>jxzIIrFOIQ&ktfVQdY%#0?M(rgDuK|VEX@@tsgu~FhEluHVi{Tyj;hiKA
z-JpnG?TCJth(Soia8tzSV#N4;#3V`NG$?X*k*F8dn|J{q!$&@^$;*M5z#1)#kR(tT
zH!4Hh7gz2ZG?;JQNiy}y<A#{R1%aY(pIFkxgQ-9>*VgIb&Ye)ftWwU`m4!4eC;-2Z
zD%iwF6%y04Wg|^&gKHACrseB&Yk|Y;SchW1#qy1um9&oO8xC_U6!aO9hD->=0$~w!
zmop@1Cgpqs7fb@R;$n{LxQix|{}y}ynQOp){x<G4*cuq`%%%`_aA33);)^&*g3}mB
zwI9#e9F%(>%3ti2F7;jHja}`0ASo-KDk&9>D_sLooT*C`eG@HFGcEE!tdePr`(mQy
zpu;D@uki9_?}pqL(5&?2Li>S!YWMz@_i-Hbp$zi=!v&#pE|8EENLVujHqwoHfW(ld
z{CAnYOQ{tP|Hkw+*IghnCeDH9V~#i;@FcbM>(ch^WX0`y2tRN!*Dd6+BBmN@mKh0-
z=myg+pqjcJI0|W*O`1DlLv0*bQOxK<9pKC%9WH4EU!pjhWYkSEi8a!9mcAjze2xtv
zy=Y)X0%Y+IX12397v9>TR|}y?#NQ8vADadfFx#nto#SYo30X5AbP}hVGwy!{1vq&k
z6KA)Y#Y^=@_d5%b9R(2EWs-bOFwjo>4|`b4xm=IA|E)c&)O^L3d}RwgLlO&{hMZ}m
zEJzmu%?*ng>KBawKnpATDoa8us^<}k{e^t?DxKi_kPOtzNQ@$Y@P}k0MT=MRFa|gL
z|KRREqnhsXb>aULLI_0+Jyb()iZtnHr~+~;iqZt7389Bxg(L(By>~>KbP*BhNI<$G
zpmb5eLc1;4C>A`w8D`&mX76YA%sgj5=Q-!F{);!f%383J_2Ig{7rm8z&rGUY7+Ewo
zMqN#qP#d0&EZf8Adg>x7dD^NJ^D3j`B?~^GOx`#nc!MbG6xf7QpKDn5p#N%RI)jNY
zPepZSs48<_(ClvIDOV4#6%2ugu#sMK<7AAIAtZ-#b1Migt3~&_US0~#Bo@?WGNt}L
z64+=G1`94`ZX_%E*Ddhk-;ShiSmV8`YuznN^yb4Pa!cL~WjpQWTn$EZZ$zB$DDDXh
z$aL2o(zx-gAPjANSthsYYF<F8yD!qAG#gp+#ytihPY9_j`8^@5K?CxjT~iWudo)z}
z!seDD#wTdymPGz7gW+5E6MP3W!k#Py3GJBj!o45KM4RMA^D>ogCe*HU+?wWVJWw6x
zo#!o-yI1^a$J==JcKJq8_9$_4yViFGGnLSAYSn9CFuHRa`e4J^9h>hdlaM_U^lP@l
z^l9_y@6BfXch70wJ%918MfhE-!n-z|cWs~Ez4ZOAJ%5X%W{dO17MJiAd|``wXN%|4
z7VnFkL)P{MefGwTH$r!%mU0t)!{gNSN*otbb*d@{+gfKvBh6K-0z0m-$dnY7`GnY%
zL>Fk@&w(Xq-Wi;4GY`sE9=wU##;;nmkAxIvNG0$~)CF491&7DqZ)>f1iW%xC9_{c?
z3@^>A%lz5aE*s~{Tyj%Xv$LbEb-gOb>t(|!RLA^CY;H>{OtbMfd}+_c&WJkCJ{yI3
z*RG*Gqc*PS)Y;LdF%Ru~-&_9fO<(?=Pn!SmrZ0`Di^j4@WBoxx3-q#U^>W(wa!2%H
zihB9FdIc7Hg?{v61^Ps^`owJeBqI8xiuz=_`VKGl$^Gb)7r3veb>AT!MI}ILMfWwj
z?rSaHKmOxBP5|5m>esjJH;m{vD(W}s>Nj2NKmDWMtiGR`h6*)9F%kx>iUw@D25c7x
zF8vs=7Z`NZ8g#ZDbcq<m7Y(|14SFsPdjA-7vqgpCV6j9fC}Jq2Xeg{}C}MFa^2d-5
zQDB&?HB7M`j*S?m77ZtK4JR!Qrz8!>f(!2Fp)A{xoQRRUqLG5Gk)p+s;vXX=0;6SG
zqZPKJl@X)WMWeM{qxGJn$`ywj1s*hMJ!rOl&=T>Wt>{5V*MqLb2lswFpb0$e(|Xu%
z`*1Mg;h@0&U>yU%2C$>W1<Xz5&pTTGs=56&xaprZ2igYM4QLynHh^zH-T=4(Y6Ip5
z{B0lHfU^N@1MCJA4$v9EH=u36+yJ%hd)mId0f+<g2EYxl8=yAeZvfeVqyc;b!nRLs
z#TAtRzJRj<G21t{eP=s))&g)G&^*9&0NH@B0bT==24oDV8n88hV}Q|sssU01C<izW
zFdE=5AZbIR4}qisMgy1z+z$vIz%;;U0Mqs*4FDjJH=t+0(15A|?*gO-Bn?>HZ<e+I
z_kg5@5-EVcwzjr_qybL@m<C`CI2({O|FB2^Yg^mf0M`7&BLVRNWP3FE81PzYWespP
zz<mJL0I%(9+vwP%5F!OA8DO{HEH46NQ^pzWgBy@HM-LxW-IIXbu2)p%UMqRCx(ehi
zBd;*8xD=Qh@VD11D+9wLx~6CMA?_-LYVYQil$kU9;9*2`98frba)9Q5QUaHwre*-3
z13H(ImD|>JPv?{wo)FN}*WW)hqG@mnU>#t(vZ@*@hbtZ3Jw5mPEiO9)wF5)M|97a}
zUzr<pnu2{L3b9bo%ql2(B2J%zR^vp`$dm!D+AI{xOssDpQ_8$n%g7!_M9Mmi{$Xwc
z!@@)`E~VvMt$w@gp(GYTlQ%}g6X0;ew?%w+-khrabNBJCtbW~rmqa%EXeon4*_%1`
zHuAdh&=J#+cT7QGM=Rv>LNbg@f}`Z%_%<^$7+nwj0fan6BM^sRXy(J_WJ3sc#PcQ=
zMIpbAwnA<)DWUt)4{^dd(M}9-oq+?Ui2M?pfvnl1SDwh(KV70f=0um~U@){4Jr9!_
z#vdbyyuK4weyWENHCeE3rGSz!)rC_rF$ec#jk?+tqF1R(-Vt(E{W!A;bHg>IPwkMn
zCzqu!EfStX`u1_VC<-yM3=4;;O(1lVx@bZNtx>N9oDCgZmt)v=KVk&p%$kPKn8#VY
zBn_0aE;FocX#p2|RU*wX$ry78vhj4*VMlMC)pHkzZR)VXh8xcvgrnq#%#7^K#5iPS
zxM|F8`e+zua}BOPF;z!eJo~sEBg7@8v1yEuRqoY=&`byyNYDyK;!;91BFqD0@T=FL
z`V1qkgF$_<jK%uRRDR7lw`fROUjfYmLm8MQzFOuMg$zmqNyy`+;%FvzPJ09tSf=a<
zVLT<!h+|su$Q-Pej@g+#RxMg>otC(iETnxyo>4~xwVZ~Ft4!<1J^PIqjVpaw^EM_!
z|D}msPU8?+j;X(?4;}p0-cTsjj_oCbDuQsIf$pQhO!>=nRks^(FC9919A|)ZO-TpB
z+~g9rR!XNl2Ss$`Vw%c#hCG;Pv{%+&&2((Q?-VDx>q1`wRD^+qh8H^D4nDrH^l?b&
z6}yRWg&Jwezq{zHF;&eJOXNmaAHyWBn=IHyFweP9AYrJF22DJ-PfeuiII7p+()a|0
z9PKFB-YWW$kMIK*A-l9`0oO6EVeE%<qem<Q2#U^5!+nNSj^ZDJV{&^Ji<7vv<X?>$
zN=rDKD0ba!*n7OjUa$IiT|*_v59f?tg|j)_{QA=7n8>KqEka-ML3eu*`XhR8Z{HUt
zXss~BiYP0GB*;p5DJ|kh1m&M`*LV|j4i%*jn}r@au=G@3PSEZB)l|uyC1#8e^zyRX
z!<~=T-46HJ4?fC>XKd7OMv4&a@e~AmnmxJ=Mj^nL<k-9A9%=CO-x*)InVhBzBjDB-
zkHbS%KX`uFYYn9uq{HdL#Jsh16ZDE9H@}#n*S##7ZFE#5Di7MBX(QK9LqD!)kc^g1
zU)7~`HU%HcwZ~z3c66W_KlJ$;CTLgDLZ@F*=ic;q%o6`N{Zk$`6v2VQNk;@PwgF<@
zjN6l$C-HN`^vR7ME+HA81wkb}kS7^i^tf<hMI3?hW(r^6K%L9#%Q4p$hbV-x>ac*?
z^EDG*ElPqv9i`BQHy9JxH-#YbvBRV<vQC!LWkTCl99oE_B!=~og_UElqxD1-xrBtM
zz<>Y=oLxeJoJ^=FpL$rMY>F{vPzE13rpU~qH7{|7W)-3^tg$GgD9cCJ9_5*OW`+VC
znFdONAS2PZO3S<uOMo*g*D{AF)9CM|=^Y0<TA%u++OU1cxnTCNn$Xj1eaC84>f@py
zvxDS8TtOvDq~I+ZjlDxUZFh=6aa;JI%ydW(lZp;*t9Kmtd_)L|BVl#+h)EbZ(!<Da
zPviwCMs#mbMCodKQQ;*VVvT{s_O=pDSDJLif{xyt7s05#hEu*wh!*8kDy%X-Kp(j@
z`J@}2+#!k*%#)8!H^b50l%{%Te2!M-)JNFP88KHcjsK$^t?62uueJYpM=QC`_P>2c
ztLZCjQ-ANJX^}q@1A079{i5BYxjP!Oavmc6(Oy30j(JbFo<Q98L|>lG{2Z3qR$&>r
z4(B@d^}S43Duy<h$1h!>UeY<yoe8rzNmOA$w4}yo<G7cIY&fKE=M5tk&(7yV^7eF8
zH(X5HDQV_5io#mVA;?}64ig+RrY?U_Vsz1D9H@nD*xgF3=f9+Rm(sD8kPe$FyqM@|
zW$`%XNCbyK{>L?*BR{SUciY!3qpr`w#3Y`_U02s)b7J)6Q87A&al(knSoJO41Q*^D
z9iR);Vdj*q06ovA0zFba-^Y9?!V$7!9Q~u3D&t;5ny7cIZFH=}c=$b!w4&t@=<NH3
zJ;G&4=eJhYLzh$(VRPYi;<CZCmK%hGC#KTn&b+vmJHFi*y*H$Z-F~J<8dAp3F*=E7
zAS3>$GvA`iTQ%NCO;?q#!Q#{;j^f76Vw>ZCzGdG+6x@rBJQVJD%!OVVFd4W?#6nz#
zPDmP_XlQN{x|RnE*rg@SH|NA1aWqS{nY!9Cd|g;%?J!RVRz!scM<uzFm1zb_kM1^n
z(0BMuqs)fH#y7r8Qe(Tk0G+!xeK+-I8Izq2c5LfYD!=w~m{y7SX@c*dr|XKCPq-5;
zrj;(qF^~I!`(p4`bC3Vv^73uPd3fsNoy(?OC&uSG1S2m;ciP=bz<+-MRvbO|=(=8@
zGWo~*pL&H?6<ykDy12C7J)M2F+f!0qfUvz0d~3ezeQLB;P4eEZv-ROk5$0#NMNV`)
z{<m8qsU1^Qr@z)-{JCK@-Z9hq=xamx&)@A2cFql*-fAlR`4)esb7A(;R!is4cZAf=
z#nsc>9Z!G04;k-#zWr$X-uIs$hzGm=qq&U_%w!EFjQOOT{2tUg*%O{LDR?xq=vkfk
zx5@<n$;Yp#{NGmcdhV>N`*5U0^UL0BQHlFH_WKln?yLICBfqOZb1lvu*GjdXg(6<4
zL>+Q|$u8Ws@rLEci&Y^a9gUDOALxsuIe+2%u=D%G-bLpjOso3nujAP_JHM~$X+9)K
zG&`rUc&{J-{;FkW`vctNJ9%P$bw!o+o2Jnkk(UPfs9cSRMSq;O=kPoF^&~oA@G7`?
z@F7P*o-N=PoVbbLWm6-vk-T+s6gIMnW2KiYK4M<X5+BCNQ8@xMw_IjoNoZ0y_ycKh
z)jV=GLToL}@U}O+6?)*}q*LY9IqUwQ<&q#KQldIa)QGIS6-r0*3oMV=J{Nu%FGRDr
zZ1mb$$S7biF2ZQXF;gOZK|z#kF05@8AuL5!V&J`=9`;uF;zxt%ix@VWomf4tI6ut!
z04uQ66c^SO7cmzXxf4gkP|0dkiWL>4CHJU#)Py!_(i}Bqhnj|o&rplcvWm|MiO<W6
zFKCMg;8wg7UxG;}`)hNXBW7-g_f;Na+SDQMgsDm4bavu8EhBCG6C-z`gInCl91g-E
z$_#l5iCdV8pd=--y}JZfp3S~=D6TWkIlwUTHzUZRlJwl-D63_d#iZNJw#b2C7p)-I
zuDQ6*T&L|>6@ilu=PmrXV5tb4L&1#7s#Nl8uB+pmvMhMK*Jr1JK<|&$sqYLSj$nLg
zaB8?37}0XOg1TI~od7dV`=yv>^abz6;m_XY6TK7dyp{0vCC>sf?S*(6!al>dI)<qx
zt{u;bjrV)kwiofiC_U9B<MWE|7RHril$g#f%VdE+#_PJUmaOcS{?PL3Ym9e|N@AUa
zf8k7QIy?Ex_9e8Gt3<rG3(7w%Q^~t6;nHrlJ#UVqdXBSoj!S3`K0n93J;!rC$9p%2
zz?<u*o(p1>L7}-J`MF{3xe@b!+R*~<f@JkPigg}{QU1l;YHV&w*{hOZ{89<G;$k#N
zQ6+8RdGn!myYcrhw(yrx+`};wXOk+c^Qoj5r9lr<7s6n00W3OZ+|ap8t?&St+uF%f
zV5j`rJ}x&{*c)4TZP=qESoX?XjB;#}q_unNR>2LFw?|7BI$a4#NGZ%OguM!--?Pph
zISDOQru2=(x91hGVtsFaay61D6yPo{98TMyPaYg8%7kC<RVF>ZtC>EV_g{A(S-+K_
z`AXR}O8;K>aY!keU(G3-=g`oufE+;x#h#pza~&a^ZzP(?UlUg%>A_@md|}sFr;@y<
zmd`H2JEwY$dOIU@&34)lya~ZJ27HGZDvl1bbE<n97RYNbQZ;7^jmq(QZCAfr1~8DK
z&Y2XbqIgrV*n<{qQ``}BY~(%h^0-!~zAbkpYiC=T$}2P3^yN_vBbTFs92>cu_G(<X
z{M<vNjV?dmh0a@4vRhRas)x2-DSR1J;VV)7J@*PKxH=~HN_RU%8BBHPAQ!-E`WUa%
z)_q8$mCCDEUgY0MuBzb@_R8`rZtS=g<{tGnpCW4`L=3B`xAAS*@NVr0u~u<mw)eR!
zBdhA3Z_-|+YjR`Sy1qxow|6xC)@ThS_sWh-ag*bfV#~z#TB3KJhx%4+cEXLBgyfri
zo)SaQf<_1_A&hONJjK`DAU0~i4gbNqm^Fxy)6wv85VQF0M9Q}7?Mm;Sk)mPs1|6oj
zG2?>1oy*EAJb5zpo!0J&EurB%&}i*Ra%}G1kT`!g|4E}Vslq0i&Zfgp_nPFsH_7wg
zQPjMneDRJ-_#L&vI~tvLw4UBM{{0S)zgbtaS^r|QVR*AqVY7*BaorOyj>ooiW)bs2
zisLupuaA&gAD64k_$#**Pj2M@Ru^VjSJ669ahj>|a^f|lzn^C7jm!)@|I*!RaQdJ<
zb-U6o@SD3|ctWaMtnaX0e1a2Xh0jnaC=IzA^*c{7pJ!=8i$8x0dgQKdNNcZ3on%{U
zV|xo@YlOx6mEqcYN@rbu$X%|QcH{Y*zcz|0j5@v-Py}|5_j7c(X%?k<c;V;lP<7=G
z3W~lecb@v*N#pP8)9mWM*fkj5HC)&=+S&E+Y1gCgT@(D>k2SleE_ToCg?G;t{u4V|
z|4YnG+4jCl#Qp!;+!E|j44eIC0t4r?2F}|KSVa6?b93-SC73ag(jZ`N1c4zxt)T$h
zq5oiR8UJo>EW;!-298Yz)WmSgkKr_dkqoVo|H9m^|6t%CYSTB4)-R4W{22YO&8<60
z+raPPaM8oju7?j7A3pl=a6(}0vDVm>?buAj*j&-rLf6>h;@I=WvA>PN{fXu9f6H<p
z2M5w{|1b)tsIB+cG6zf!$lN~50h0qV2Urfc8elnqbAQMjFf)L2K-d28IpA%7_#CjY
z{XiV>xj%3Y&>Ap25P}1Ax36>nw*b@uHUm%x(r^Ik0K5UB1M2qIL<eLJ_?&l881OlO
zbAYT`I=b4sdt7}20MP-@1DXhY&NDC+5FM~O5McvKmzG-qSPu9c;5s0GK<NO{0o4Oc
z1xOD-9e}Huxp`o9K=lCH0jmRO=jIm#hz@WaP&(jthGrK4#Q~)QCI@^DupjU_pmav&
zR>0(d!vT;34hLioa2-gx0gwY42ZC>a<p9C~`~zV(AaH=+fcXKC0|W>JZa?w{)NNnd
zlCyGex3mF)+Xps)YJk=Nvw@qnM(3;mwgG!veD)j!=z#O>(;Bce;C%mgSlWN%tN3e{
zJ5LSa5GVeH<x2j{a%hzOE6M<W5fOzV>i>o1tp0}OAd`uy_&csZn=aL(mxT4k;<>Ka
zFbd;hjmc;WG}^weYC8YO<x9^%!PzqU3_Pp7NzpVPI&<&w!v$grA51#sTyvYEY(f>i
zcnJzBk6q}2&%=dG+ZubtwBQIM;WrgooC%>~3Q2y3C?pfM4b|AIt3%Hs&!dc{LC{13
zS0eWu(jWzb+fzGq(u`uJ8CqE|1{PR^xSk9Gn>Kh5L9XDRlG1h9VLm*3S<dJ5Qo9aw
z{BvYTv|CCq!$Z2g^J@gRrT!^@>AK53+3}8WXOWC~43Y7BB1SFzxPowh(s-$~yp3Cx
z0<jp+I~n&JDaOKS942ktIApZO2q7+2OfN%WFtf%19IrREI1ce_85Rdq!y<GN`e_b4
zmrwzh+>M{PzDiawo}f4iPS~Rl2ujWLOQ;ED^~N7Zou^}gwGkF^CCd_Mx5^QeFfhD;
zUUu}C+tCDZ7}R$V7SMPO4M*9>omI9^li)m)!Hr|_Hp2FDj&;lTWhG3yNfzt8V}y82
zHK2HeD#}3*l4sJ#Lx-9n9cDEIG-yuds#&jOJ1bnpN<bmvSQB`0^i}jXun_YF7BM|&
z&w!2d266HNBXlmnx>3h0fU&s`0b(k+N-05J2-&>ba=*xPlb6hefW4v7J<`=oYo3Bb
zoXkmReKH#>V}%U!DVF|2^jd6*8y(dyrFqbiW}E}}TULbbLD(0l50}#`?m?tmNT|bI
zer*P0qhAku+bGwY#m-mPVv=^-7>=_^hR?Sw40OXwZWFDw&!=(2=Lkqdc<H7XbP8Fb
zXMbQ;_D&evl;@o>Q8iLAhv?$lJC)*QfAYF3)4W;Gth*3}xgzg~4j;mv!n<)vSzgB}
zXQb*Te5~Ubu`F4*57EaRaFRtm;%uOf$N1Y8%i}MKK0nePvb$5MRE8n$MH!uPQy^K)
zVEVI9Ng5R7OVf`WqY}*-Rc@yIlI3#`lMNyuv*pldpZWyv<#xjG>_=l{XHMzrWy`KO
z&l)Sq$y1`8Y}*WO2iu}iiD`~mFBuGkLSLlOu||+;WLuyW7@n1FwOBPOyDDLQGY%J(
zX0uT9yO2UJLJ||;1Bq1AI<l;LE;&7U!pHe_ivH7|ZH^$j?3fY1^WhakPuuK;MjB42
zFme79Vyz2)iT<Fb%o9GArdTX}31i4omJ1vmgXE>0fK}(sBK=|w@>AvLUkN?6CBsNo
z_9$4}108H*Jw}<?aZQGLQE}(k$odCgXwCkI2%OYkorK-n-R-@X=SmZ4=-0lVPKj7^
zI`mubxC2uCS|l{l1DTPrJ?zh?Ib9IU-`vBWaSWd;AoIL15{F1?DYyG7>RCS`qUaa$
zHa|(GSsr6b<Uk#Q1~15w%vfA(6w0ty$e01sG6kN{Bu6a;UV(I(SQL!u1*aiQdC?w0
z9PULlV<3S5IGcnzIj8Nl__D1#7ESCkI=+cYG{SOfVT^eg9LdTz86ht|V?GbHuAX;C
z-JI0eSQT$eo{BJr2z_tLMCf5$wvdGrQ~^6|ADeyPQvsTh8Qo`=bEo2sA=48c{iW6p
zdK81U5iR%TYuxo;FszQ0jJ}T<Bh}x}2(sVHlZ3?dOQ)=cmAWd*kNQfXg{ffLo{y@d
z-cOW9SD<Q)^+X$u&r%~CB@N)oC}Bk%Z8*eybdHKr!;)U;&=6Cw0i4ZezL%!L)+d<y
z7#{IP3rY1B+=HbMWaKG@GGno@WYL=lMFy!Qdoiv#qA!!8;768THhN*$K@~Wi-1#s6
zKe61O=I#G+6fWi+9V-)P$yKqlnhB{CN_1BG8U>BqoYl{2wS8NOP=4H93zMS}H{~GJ
zBOkqkROz2b9kUdFHz0#&QGgn*1y@)3LXoo%r0IqmAV18oA6Mpa=r9c?VU)a5e=40<
z-x51>g^1LDLi~Jo2QH^DMqFngzA3=z+h%6s-!m^KA31IK#2rUEaQMc~r(E+Rp&xo`
zorz!0&WaqXv<S}yM{5~~ecap=`T{Mse7CHy55C_1<mb8c`eWXig2dZ8HjaD~IB*E8
z_fw+kU0dGhYC}60g_{eVU}7cI1Xszt7k{DXh>GYu?85=2`?a>uj~*<$C%6X{eeQfA
zaWWLr;cldx>U{HkICL~*&kx30bVPABe@O0<e~GLon~bQd@0sGyH!U9GO=OqgeATEM
z2VP!2b}P2GM%}m6C%{EtwRI}V<=V<<7tyGyy<hjViG><voxwxH2N6kxe|ZWTvP*Oa
z<%vnENyRd5q0?_=zT%ODRdk`m41K}Z@^X*gZ3`Ek7Ni(e9(lJy-kgJ&Hydv;K8B<f
zcIPJyvlE#S9B#oO<8wjHD<O;SbY^X|cgWTO_o)q4+409VLU*GWHi<dZ<>BQ=exLdU
zeDb}v$Be--^P21r8czyduD#mn-|JS{2)C?RBp(kc%NKaTKmMWrvx}9%lAZ7AvvO%Z
z77urs>OX|bj(4DtYNUgQH^UjeYu;;7zMd4P9Cz$Um-#1en%gD+J2_n&w~l-&>`wYR
z{k-URyZ<?s`v+0DuvW#3)3)gxPZ*khKXfo~O4X8O?$puDO7(hibdO2cy5k$wryJ{v
zqaoL>o(V7NUwm%Ms}lJv>0R|j#Mb@Xz>i+!h;>Uf_tSbdH4pccpts+XUoz;l>r)N}
zx|z#uKMB73jbYFaz}@!I-1c|Kw^ycc+B@9w>V>Z^{`?|pH~6}R&%wp#-34#uA<vUR
z{usKeW<&V%t5FQT`1&|kOIHX<z@M}5J2>b3RFbV`S)RoTon#n=4q>NfP?A4O;t4T3
z6e3FsV%wW>Wyw4)JnX&xBy8J~oPfj@nERcVAT4ftNwWD{2YC#&svY@wRU^;q$yNj$
z?-IY_FDFGA7S<fC3a~bee!YEkJJ;=$6q!T`_sS7kS&e+88q<cv&LADsf?bZ`{oLBz
z&U}tR_=c(E9kSF_KUPM1F&oAqiLW8?PYel<4cMC)#qF^PM^aH1K;|w@Q&av)miy<T
zaHp!nPBJ*GwaPJ>=@wEWV3s(my!h$aC~uDBJgckkxI9*Kk8}<mQ}PRcw#vRf$zEFN
z-!0;(ch^Dww!?^2{4|eC(qL4qIh!AM^p`<-QP)`OQZLre-W;xO@2({0T3tQ2LX70_
zmm74kvT|p(W|KpDM2e>67^Trc93Yeyv!-f;y!6w8P0$*Wnsq}<rf2V@>;y%>RP!B+
zOFDBuovQ|ah;h&Jw11#{bXXQO`P&uylQ|S7$cMk?@*&>L_A07aXl9eBm+ZPfiuWqh
zZpNeSbVgNwHr|-WZNw^-BUUReEbV@o<*BFD3G|!k+?mH=@vaUQS(*5x`JoJfwJ>6U
zxKf#)S#!3(wP>xR9sgFiw{g<nWx0PT3b*U%KH>ljPq8|2xGK=%HmS|(Y6~w%yIbO%
zS_FTrLM?+q&u+w#oy0b2zUC3<D{VfkjlN5+MHs!pH#1k@>eqIHsO@tF7xvhbxz$d{
z4qls$z1CXeL1$(kIY(kyNte!dA74-0nz73^%x0KWMq<-DtrLe`!(E5v6%9f6H|=F;
z;uC7oSiIwbT)czCH5KlXE@{mN*~i}wCri7@vdR3$Z7x2lDz4IA@OMv={c};cYxgrN
zwysGV6Ml~ulC#H3WrSC^l+wWp?d~TjtH-y+c_P^SJk@d|=_tOK$U0aQTE`JD9lw6p
zo1OsU!R1W4mISuBB0m!8Pg3k;_}uv7&(B=5qjR@Wiwfun-1{6#b!4KhD~QHnMWhW=
zb!JIB7zkr{qxj^NISbF<)~`gGR0k$p6NnCY6ki!{=w>W|1=C{IIyKj}qYqj@Ji{(=
zVS#b(g@aOdGj8c&8nr1*DYJwAEG4x?u5QoTp-Na?^r-h_XuScZ(4Wt9$=KKAWUX<W
z>o4i+6>$VElDD5!`kk73r!e-G;9`VGt>kL8j4R(XQ+**r+T;Mij~eSgdhE_<35V77
z8K#>ZHqa}>o2Io51#z`>SfnIFX@Gn9xD@`<7I9qS%5*{<HuKi^g}UUex^<qLQFtPW
z!q=VC7$+5LZFGcb)VJNH;hV<IN?4=X$#9ckPp`_o3Mr9W&lif3>8kSKNi_@3dBQhW
zzvYywglFzR?`4cGS>-b@$7j@py~9_SbT<FXQ8?MeZr)2u<V$p$SNEtQl$90>wFsf7
z&P!{Mt&A`8X#J~sg-=Fpfi0Dfrz?GAn#i&xp><x{t=Zgo+3S@s5`U6UU8etVMh+8U
zAgG--S716z-5#htyH%@Fsd}6_G5=IYo^buFMSThLwb)Mka~enHHfpuiI^XZMna)w(
zc0lh(Bfgj<<}>HmR=csPHYO#u-_wkqFT1`R<ohA)`rzL8E{ifgy}M0O4<f?MyS)D1
zy#4<+Eccfv+&{r`e;tMUdo1_)-&yY8qHz8OC^7;1hb;G}DBR&uG7jZSV_@9;2Q0TA
zh3kFD;ERKW5uv}!azDnF1RlNAdi2`%(F)6>FdXcu9`ttc(fc2dHU-8%X^nre9p8!=
z-zggZ);0cPaeVK`I3zd$*PcMU8-JQ9fx0%q)IGuSY=ZUY1X^&CU3-$#Zj$@zB<9*A
zU-zWIvq_<!lR|=j6UXBK?nn7s_xoomuu{qzpal!u5A<I_3l>yh_v3i`LA-ta1MUa7
z?~e*B=)Zzc9w0st$J?*K{^$NHfIASx+wZ@E4l79H{n3B@gZ_Z{f#e<VIzWhjr1O9c
zf)*^$JfMGo{(vO{kpt)l#1Bv&a6C{91@s534<O!t)fGS=;J$C)z5!ALQU`nwC?9}F
zz<mJy0Q3RnJFIpb=pv9hz<p|Z#sKTUK}EoQKnVA_4`3Y#rU3)ocRzrB=C%$%|8z{x
zKAxJsN{It%2gL8yn-!pc`w|EY5C9;+IzWOTiw6u7&>xUM;EF&3fz(CD!~+Jjw7&uv
zaAj=`#NPl00=PSFd>W`7h{XXI+}Yj5`vw9Pe6zB;FNA;!0S|^p$IdN01wv?H@4U9L
z0ou0!2`^l70^MH?gH!u#*xA$j?%jK1bE|W<_O3qu6*cuBsRtnOlB)+u=Yb#|P(&FO
zt$jrVcvx_~3|L}i-Ocrl4Pb^ROwIs8R6b#F+~_oD)7oBffBWuz=RLqr{|A5lmHWYs
z%}~T;cwZdy`r((b+hr7b%q0Yh@KP@W#if@ZVBGYQdP&^;FBMq${c0BaJ1f1cN-BzG
zOBsU{7{bD^gw3&hG8ukc>-I?2l{ipTRla6&xAp?%6niqSy30X6l%-t?>g)|;h)0ee
z0o5wP<KQswG*p5UHzy31VuX4Sj3vQf6<dOTazAA%{EGu;hGi^t!-`j8L>Nj0i9b(#
zO^(;7lnA12?v%VPNc@?YHhfdv+?Z{w>Wk+nN#Unf9Yzd0%c%6v9C%yAW=8qEP$GUY
z3TtQ97YE6B?ldq)bbS3?tkaAUl1A&EzX0Du&Br_|VPVr0t+!uGD}f_5nfXxm5bb;U
zNBVoaC1;6DC)LoL`t-Yk6$4OmmVz0=2z^!uqR;!tU_>`IOFW=q3JEhCqn(9g`M7DN
zIy?^*Y@rLoeQ`PmoiR9i`F_PTo0Fjy&y&^OH>L|99h%Zb)wnBQ;gFOVnT5XFvIO^e
zI{5n8kL~ocXIb*)C)kJ5#YmVCL2-!l;aF}Q-TBic1~ITC>y>=E^<`K#2n51)a*J?p
zxGYfm<!4op>#G4wp31AZ)1IKR2lv`sIS8LG(S>Bqq|!39LXBP|Su<52Y`NvxdO6g!
zs(B#69W=xuen6NA1$ZJU$h|ryo#hCDyTT-dCVm)h08NCEZ?<iWdT^&|G$tU_nhAPP
z2$Q}igtcdbaUVl8(z{Iy*S-s&csf&XHJ-}DEe0qenUk&^O>}wRYbjmubv=Kb9%B_-
zgp)QigAPE>vKeJCJh}wO_L|1VZ;Hg~aw0CQ(C8SCE)t5+bY{Fv1!!ko7FWjea!jTy
z6%z<;)awr|Qny+LIbj6oq2V>pL~}?fKz<^$|8A%Atz0k-#&PsKT3_c2a`C7=Io_Gl
zzQ&G_FW1^uw~zd6{2TVn&C&~L?C?dLA!7V0wx%4m<DmFhy2^_S;o17GMYzcGOX5-Q
z*#k3y+92(>$Bwu=Gl9z*omGOa3AaK6NNw(DK1s{-Av!mT3kY4rPR-DaoM<*U{SWSn
zA;zO>lOa0gbzU8(f;zhyhhU42MjKvEt&&AdqUtqoa?b6kL3++66R$p(YOu3JuST{%
z%2tUFjX3jo&k@akzLVyIzwX_AAss(AEC4gT9or(2_vVLT`ty5tJ{=dG4Zptr`F*F3
zpc(0bOTW3d*7(-bIL&X_O5?O0erwzpxO{h9*84D&XS|F`pDKiL5T)Qa4@lu)?6jkj
z!Wh!-a|0Rkbvg66aI2T_Mzx=U>%vZMyvxsLbw-wbLPuna_g;$9bILC<Px&Xq>T+p9
zEfw^8{JqOKA_ij3IjIf9le1aM(jeRs0-f;vrsF$zc+RH<5GRQ^IUEH#yo#mQ%mZo5
zCNgR$e(3khET4JQq-!^Y**3{M;`Bt}U78ESmr@~N$HZiOBi3(jn3bH>SHUF~p<n9&
zZQ;@)4tNI}B=)j@G|*vYLMWFxu=bwjfRu>{`*M-IUa*|@`i5^b{H*02K4TIKe91}p
z)KuA{%KO?2>>_qpgKZ))4Tlqf&ad?)|3E|Mgenvz4=*5+h;%}neF>>7xC2Px`0fd!
zc`<xCy5TNXc!?fSj7mTREYo)x`C-MaF4RGrGF>5`vXpE^S?J-hs?#OhoO^Bt)d;L?
zkesXy8;0bq1tD$tmf-Fsua59+FbN{;*{>6+{2OSZ8V#mtP{+%Zc<vs()|%AGVa7L`
z@;CV5I1@q>g=}I@O+9A}U9_sfwM>bZN7QKFI4`PIiXw8St>3WcdwHf*d6=XYAnJl1
z(9LBcDicgu+EI+6-_VeL#j?hSb`gQuS0<1ciJrg+V-TbDpt7*~iJ0L?W%g1*mWNmz
z297!&M&`xpluCL{M9bhPozKrysT;h(?O-W<OE=({JTo2K7ZH)9muZ)XiA+tjsT*=I
z&c-DZksP!6M`2rcEYpom^qChP7i=|G|MuT9?e+I6uzx%4wS8}A>{jIV{<Igw+DK$D
z1xph<G}P%vGS9;$q~=`vK}@ai1>JH>wGv{OmhE-clj2+2YDVtT_7v^I8Qb<dIiPt=
zce;xR{~6PNXmBIp>9OVXypWm?rTx&`Sw~hG8q6?BA&6x{629bsWqVFV!5SfkESl7l
zSDQA@1P2l!55`M9L#Oq`sm~gc|7xtr3_~xo|CowwPB^odn{Rse$NIX%0V~DAt6EON
zFV>D8Yq0HN!Rj7hh#5zB`clg4S0H@;1DhEK%JyMbl78C+JwiE?QEiR#+re?<Zek`T
zt@+r+P}iX1)0EE-#m1Au9<>%0mmE!UlMq}W*j(}}k_~bvPuV>Ac3(c7>$a0(G!1rc
z*Ej88@H!0p%}(^5W%W(--%YnWba8He1KwR5^ou)BwB{A-?~HNVT1rJ_AGf*cqK$U*
zxCrAOhRmA1&>}uhM+ttPo31`_cjbTl?D6TqhLMP6kMe?Nzuv3ZS0mobB!<VF56f%h
zpMdCzOE6^h?Yva>qi4o7jo#;sLm|m4-(H8mnBEG`-Gd$XBRzOJgB&{6&a8;1J6!S*
z`RiGRnAgX|7sD^UWtt4`9?4EM4<C$fXoWf2-9~nGObyqxmYYBKICH0Pm@b5Nxou)C
znu9V|-O_$tw=1BfD{d0~c{iypc>^7LjrdWls74TdD_b;w-TuXP#e5mJ>Z>34N#xy`
z+fTIg67nCM+S~ooH|8Muz-HvPm96f6+rUVkiKkl3_HPi;fyuHL&uG@{KDT7v92*aw
zJSBN|_1V+y$$wmd-P@)eytf&5=EqC^UpvER?tRJ~|FNR^Yj+~`-j}K~KQ}J^`ZhOy
zZ>x20{O9}dU*DGw_UsIu+51%Z>&M!eU-lA_pK2ydK1K4jmA)8wzv89;W#i1qGU9XY
zpwgRx;g3ROSlFfo?yIHikD16_S0@xTz(Uxw=ZR}_jxR%qV{j``{I-9#lJ><d4Aozg
zzf_ZMiBwV<>SLjRJWI-{I$;t^#!%5F!7ArqS|Vb^5FXCJ;ON6AB|?J^Nveomnk7=o
z34xWQqr)P!70*{WhpJlqRa^WDRDF|Yv{cH-mfP|Y;NYQ^lZ>k<Xw#0xx`|Z<Z*r5R
z@tkCbm^WMU#<5X0A<DLDkkVR=z1n$vb<hV3Ha#BalcKurA>@;ESA3{w!!{qN%586K
zOLK^uormfbA{G21*1)+sCio=Dbl81-B_uU3aH7()4;gB)5~qVF=~l-_<I&%PRpN%Y
zd0nHsb%PV<<OCUfjGwr>8xcKLf~u%~h7KouRmARn7AsbW)tTWV?*y6YM(G%d$BJFa
zY)eFyCQew{fEMia3&}Hi$qQ}Ci*w1(caoPdDKFJhUR$NCgruzHrEIjNyq!yVzmu|w
zN&Tdj`o$`BD<pL%FZEkn>W{h9y`5BuHw~_yhOkaUhNhwN)0o=RqIV*Xw8hF%rI<<#
zUR9F}hvF9C2}^iNOxqE@-DJZMr`;{FQ!YvOLgG%Ad-DquWY#s^Vm(iY?{OvZq(8$`
zswBK-b9~=hc!cNqld9c|wla^;%U+EQY725Yw4Q88b$e{#AH3>w2O0WaA{)2tv(utv
zY@KN!5obCWs}&Nc`N~Z~A^@k8gIEe$u?VytNmj|H?7Af3w|&v=Bp0`wJ5R{hf>oHR
zlZ6?b?bgXr>7fqR*z3dDMy|QZlF1(J$pRzXe(eD>5)`vt`9Qb4TSn07++f4zya?-<
z-N~$79dGkpPi?p8?0jVn>u9A|kE+4^`L(n|JGq&a9NCUZ7ebP%=HnUZqJFr<Zf+&9
z@D}x{7xh~g4TcsC=NFB(7d@OW0#^+uc&|NHzXq-v{$+|_@4ucR*ezy67CLRQ^AXcw
zH6#R{!#d<TKe9;t_H~FiBXBEt`%|Q`UJ1(b6ule8&XAZflYkovGJWj2H=nvAT?(!%
z(YDfMgEP5CQ$O(@E!l~Y6>}Bc@IBO#$~zmyMVH%c6+5(C=7K8u)#g9q5_r&84Vjju
zyphV6myjzREsf&T9LkceO%>ohgurBv2f3dzDc#~NxytS!qMX_My0Ckfbo1;XG514}
z^RnTL*Bvz~ooy;z!Yc6vmF^vto(q-U-zo`wRel;(0X9`ZVO1doRbd@f5erq3->Qgw
z)ntw8J&H|rY*;n5pgN(WT1Xu#k#MstkXCf(l-)c*cpP$0LJxKJdZuoAXnXR{ZGz=C
z3AZ4tnMr-463-K=BELdya7#YQ?T@gBahDXFs7|cjpaP0Z&a1V`j9;#HvvWVRE|HL%
zOKl&G*OUrFbx3A!niG(m@^Lo?cdj__MHX!NvJ6#(s?=)*qrY1p%grTn@CAKb_FCA&
zYmoxmT5e#d)C-1?y_(0!Lg)xn32VHA;6~2sH_!C~3WH?OEK_8gVHvZ$_oaN-Ev82L
z$#SL8vg+7|$4tRG3FRAc9?ZB30i%3cZDA=xgLFq!W<pudLJ-IIkZy|#!Nkaup?eNz
zb4v?%g0}o`N!Pk*E!>hg1ua`N7JsZoJoPZ24Z6V8_`S8(C)d>)@0(ZIq#buB%&#d-
zy6~G)<BPZkJj0z#3C#9cg3+ni!y36~+#AHdH*1`_{cco`=esAXWq^cC)X}hJEdPx=
zN_Qp}%IsC#G(X;wk}adF^7gJyKDgP$$m#vmt$8lw+K1Jsq>i?vr)??U+tT>kGc?<?
zF1CZKhIxhU1)c3hPuq*Xx0mpDfUAZT7dtA$JE{viYCAjXpLSpuB-L6a<yNY74E>v*
z)b2`^NOd~n_-f_wLEz+J<3-B-i=K4Yx@M*uj5VEUbMbv9>T5Z$(ZsZe-}6fMqyjZ7
zZ?dR%Ge}?0uuRrQ-pW<EWxyyI6`uN#`JU$4MxnSy$Ih++*}In1ZlS8%@=wdT`FeQN
z3QoUlLhE_&eD5eW>Y}st{L0o$#L#5;dahb2bpL+Kl9_h0pp)hB(PrMLk4-I%rkWgY
zJN{t>_MeI4{r9@x-hXz#KUHA=i8$WBS785%INrYd{k=He!7WrA0s2!M@2}l2;?Y{s
zqm8adf8%~{AH{8=g0U#Z#=mtxy9wmgiT~_=2aceE<zYl3^oRRl1s{uOKNholEOGU*
z)HT<~GTo04KYJ|q^Rc|(6UDK|M0ptJc}VTr6OHaCTF;&w|M>(bIHjvSrEfQ7cy;Pe
zhYh=@OrK4i{yAlKbBeQB=Dgjs#nox6YtuH})3(p1Fa4ah7o2g_o^iIDak)B!zc%CE
zJ>&kLsge3`)VP0YZ$Di4|9D{!3|9bN1h5Fc_K^{!2|<nbk5hYq7x$fU9~nWoa9<b!
zF9JgZ&bVLx1;_}*aR1I85JS-X-S7MY*8@-ps1XR`{<S?26Wm9}{cC#w6G55~2;+XT
zaR102fW`gVFHpsOUIeNL@DVh5fhq#N1j4u<A_PDQaPX)m4yYm^#r<=602YBT8l1VX
z&x^n!0W5;lAizXGihvOTtL>)=fh1}h{f0Yb2GWFM6O)>TrvNDe>;rXUfR#P>2YLqv
zfipgTvGm~4go2jt?7~xZedFo5IgmBf`|TVs$0O>;!IeM2jz`pv%c^Pv?*r_(e|Aq%
zTUY70KF~}co8yyD073Q*4oNDhODU-Xiv;#}#`+TA&ZU>H_6x$G7kmt72;dJ~0;Js^
z00ufaH4PLJ03~oq(8+!FVhQwx2S!GLMFNNf{<xo61QxlUSp*CUAQJSH0YL(a1=<Jz
zbZ%jBKd`8G+I($&UHODQa7F;2Dmo|sz(>8`%%^7Nre^0<bWi?~Ts*3QTU}oV_y`h{
z|Hq{m|C$<gj8OKaf1<{8ya}MjXgY2{jb>yr8o5u6WmJcMr^X(8BV~5BLPL3fp+(3^
z6a;2m_0jV7;?cZ9Dl*UJh;a66X4c+$6Ih+8I?((zSQEqDFc3a+myzK1`zbb|87W3|
z-xV^Xe?gH33F8i+4SZgYPGV_j1{b=60$42ZLNAp=_IRGI6;Ur7`>B_WW^jE#TmfN5
zDuXc`IPzlfw~^O+(P$#0A`VsxV|-}M$RGP#r;3H48$2(Bj83hBLZ{{$q%=vzM-D_%
zVlOsVcrw*6Ym}hv>64e$6P;c>>UOUB4VJQpP~3S9KHyn&9LoB*EJ?@BBFL^xTyoWc
z!%(0IIdu=G%88$%G4(9s%nlyh2}X0lp(g`47W8r-9Slc{5y2jyT!t${Y&tPAD4mH|
z!AO)26?uWc<Oi!KF=LTOmK>mi{e%ZNpCiW#!nC%G;zeQlpXhabDQFyX#}_Lz<VRS^
z1cM@{{&g~Zx$01q$-Jti-6;j-K3tvr$qc&aFL%$=sq4qRIK&jd3*+KL(kcrHtgjgu
z?2simc0~3$-CQ$MVY3vIch#>;=hQbrE#`|z8kT^-!T6|56|iDWl>U7tSYui#&K!Qs
zF;Xo-I*l{X&J00kl!sfsya##G^dN<-*LrjZ7GVW!yh{msu{*wEv2?7;A4{1yVQ5dr
z``qE4O=k(UkSyzBn*IS8LdL8a7GOqCcVP}q<EnA9TyLMVp45e69ty|v!iE(XJ5DGQ
z`q=4scjqI%#`9H0Mi<zS=nIcYf(9~9o(@_`2ylaVF;Zwc3Bq~9Y*+*hp;I8;2o3W2
z*RKvi_#j;=L^2w25k4KR%SI>7Nn(W`OL{-nIIklp*o8>Dk6HV~39<0A^k4G(ajxcY
z4J<WhfcfATvk4kn$#%{`B*x+BJ%o1A`r}xUwL_5(lBg_CFD@|yx?{v%D3CLv!wrg^
zia7Qt<i4TdUSma(?;Tb)Wh}i;(=lbU>TQJsMEsbbe3K3b0!`sjvFs1gX?mQXK#SY%
zY|kq8SSBHud0wAnJnDQlRHttBU5ABhTN4}1dC?SK%zKitcD39uQXM*;XEO0-XIkSN
zOTzYE=;JaQ#*V92FHbui<fDc|`Zs$Tx=%a3M$_a1jNFIXMeD_X8Wz8AX#V`0Do<DG
zJG!G?I{bO(Sn$LC4L=@#`!J;W{aUmT{84K<-T9-?Y`D=@%MdQdRF@SdA1$_GMipf%
zKc|#NMBs2e#UVJv#%IfVmp7W`>W`e#GK+YAFx-eM5r;5Vi$4sj)%Ub-g^ql_el>>x
zN1);1d%@=RXnv#qoDz}-0ZqYqvbC$~$DRDZNMyg~jE+Gpc~JRLn8pjbRo(W{^|Gc&
z#5ov`(MCMF){0TC@@_uYYc)&TOOWr}iGDA(ShNGJ<E0^5;$sP(`EVKb5PM=^43-tK
zt1AXyLYYXd$5_c4?H2UkhnmS)l=<R^YHoy#kZH64r;*#~=)vi!0Y+>nre4BAL3JT5
z)Q_bUmsD}Y)MP0dBJe&u93$O1=8{HZiRV&d6MD`mhF+Q1mke{JLT#V01#ZIABIsED
ziY2zoQ_hg5S>jp91zBTrp-xI)4z*lzR1jxyR$wWS`^$|?I$>Bt06lc+D}DCuy(wWq
zA1U;ar4eLv3F@%zH1YB@$HnK4M3fvFV#W97BC3fz$GILRFzFu%MG+-8iD~xd4<AS}
zJ2*{U>8q&t0CC!kqQm;yH3%bd(A>FV+(+!RmdFh|cN&+w3|cYYSQ?)(F1wmHei)8r
z^cr<5K$55Agi9C^F!H&!5~f6(y9ZtRVTZ6yae4?G_s9b4RoYIP)Jt|q*G$JwiwI+Y
z(qLlp>0oaKn`~9h$gV_Xi<lr~<v>XNlC^%2j$~-VHhve~FuS6T#x2p1S3`;P^5@go
zCx_{4(wvz$n#fXC(`C6R9RFdq41@C`(CM9ecgqJ0H<if;sF*!t5qbH<nT4&Ewy~Su
z!4IB3|F+diJJ3Lg1FNTe+ik<Yfz{Ioiz^!2VD+>ipbBiL*lc&qje!l7zjJNxU!=yJ
zUUW($MbdPc>Eccw=22s;>ceH$@SXe1cDQp<BN+nSx-dr0idQUe+T?l<_M3#Af*bsB
zOrMY(=oO>UqlvHRq^R=8VikhDAKo&`pbT@}7?(tpoH&#?0WqOV)28(xy#pnzbZj3D
z!N1Vxq=*QU_DhM&B6OV06$5`7z_`jT&nJ2GJv?SIHOCbNv1MXwzA@)qU0i%~`>T(c
z&?zYQ`wwTKGwmlS3W`0DA;j6xCY8L0NjEsWqRn7G=5^`wQG<tTI?Ve0Ij8L_I+JiF
zPH)5FRZtEM6sZ2=?n4tz<skif{DI`y8Orl#UnP=Xp0{Ltl6+Aqm;N_JTaNy@x~<Cz
zbu5e$v+Z<DjZ9fLOx@2jW1sAm-R^bn7Idmxm~Rmx<{BG1UpfShw7d8>lFGd6-n2(m
z25rAYYI_IrFTpvmCY>Lm-zlxGk1q<P-0Be=kx49k@J2=X#^k$|tEyUZP3!DkV~0OH
z^$LYOIgNv}Opxf&xJmy@OtigAf&_8iq8DS4!MSYScz-2<xkeY&{@$NyA(Dl23c3m~
zR(sckgQ+Iv5}_lZ6z^ZwZ(awcY>kdQ^NZQGfviM{jm9}po~(y5-7n>V%%2-Umevq6
zmW5mEh!0t<;qjDESg>>b*S3kOCx`f38?vtjG-obMqNY|~df$YI%RlBWGHh3;|G@L^
zwXa!-CQM8>6t5ZhJ@RtdZMarU<BkfQySUZ#@PLYI)9f?vB4&%{!NGZV_z~+TRB11H
zd!AmsQ%ozG3A=gup#9L3zq+>fKSPZ@-)6`6wmN_P+)VBHv3lm$x2M1Uyn4#U;YV~b
z_)@-l>iF`}cih_i3gO?Y*i-y5l;uz}nDdy<p*Xhiy&N1p9&fW6#Tep@!Fby!c-?=6
zFAnnKp*m4pN#dk1{~?$3&uX1Ynrb4@5sXKjs*jixT71~YfF#aJB~$1E5t4eo3L!Uh
zLJU4~e}j?eORwA=Jfy}QtvN>`#`<Ea$;aC$COn4U&IXo|J&aB|N416suewd%5mm<r
z37JP*QezT={55qU#FAId3gNa2+G)#`;)ij?#|ho1co+%bFoqV(VFZkyi2`*Ggz(Pg
z1|8T@2v>`-;BbkeqAgIdRzuFuRkY$!Y?2uNaGsbms5po7aZ%I|v9&{4Ii5Db+5u8m
zWYoNBhvQP#g3g7IKdQvj-zEk{hw2$6#_5m?+cafPx?8>S2sa`{Yz4PbV@yg<kO#&3
zqQ%Q66JE4%s&V@<`H}3{jhze=9_*k;camGVQeMv40B!t#M~y7=X{@_xXx?-%dCF;>
z&K;VL0jsC+iO?GPRGbo0-tZGO%yviPHY!yHAG79{@nI(+Rw7u-Xit%CH7O3Sy4%90
z6r9;t?mC}y-eNLTbuC4P>hUVpS<;m-*g`eriO+Q9YMRWtKn|W6bT?N|mC18|B@sZ4
z^X}(PM6PD*lf03V0f(itERd8}D{(>9%C~}?=(e*-A%S!yNnZ_vuFR+C)dcwQ_=ZXb
z<3pmod2<Q8f!}f@NyrnyBPq8qR}QIT;F}z}vpHwCa`bib{ntZZ=jHvLm*KmdYaQ!&
zah_x+otJG~@G>Vkp-Q=+CPi%hkoEc@HHO?I3EXM7f}EPeQu@v#u^x5#DT2m6A*w_;
zJ~jh?jG_*;wky+r$(LXAdES=(FH_?t@AXgW*S}c*?doZ}gP^hN(R7#_PkQx9l16Fl
z!5T7C0sDc4G&yxA<FB#DY68_lDO@(`EbfOm)!ZeAJP5fSJfS658RCs|p)0$=`nyG}
zyd{u-M%fN`G_w5L#}bxMzho(*$f^&|XzrL)8FzfZf<@55Wi<pLSEVDZx+>AnO*Ns?
z+bAykFjHx4Sr(^S0Tk_Fxq&wiD~}a%ltN@_jH)~G#eWk{_}-g0T1NUc|1VNw(n590
zx9T*$nhcGaESs8~1SJZaM|ov=u9Ws+d0Z@SmexWMmrhBENJc|z%7HmwmsPT9?O~J5
zcn|B6#8-z*tSYu93)fK2$5kO70<2v+Mg<je*CN__HvW!D#b%p3zT?nNtZq$MS$`P%
zm{c7xxKy#3tt{<)oI0d^vX+g()zc)ZZY7sbwczed{bP5uyOGM%9MW0d;C3eO4Wv8H
zA#6l~|CL5mor^miI<DX4CYYfe_*MkvIm*=Le%=VyCwV?v$@PgNk4PjiG{#)bi=kf*
zgMTl<8JD+LCVb@!aSe<AE)!*Yl2g+)I@q|3{?uOGTX)QHrf6?u(*fD0-)if><$9V0
zLH4TklL;li7bMy-g&B1;MxVRGsC-*Y_Vy!*ph%ud>o%geapROpf>^Hm*@PU!@9`?z
zjfX9pJ~A|w^ThV_AL5v8LZz3xBJZA&z2&NR%ZNGb6SvW8CU1e0fl4+QcGa72zZJEX
zpSV(ct73~oxUhMN+jlpX_<I|q{S?=lS8N`hvML>>9a8hpP-DaQjz<2@Ce6;~i=8du
zoo#h#Y#LhDFOTM%c<IDx>g1$#dK|MItf=G5l6>8QvF_@8P$#`oM;q-Db(dn?+ot%9
z)ED{taL{hZJuRF0o>8po{YJx+Z?$_&R=Zy9-igUuE?c*liT+M4oC%3(o#82`Rc;@1
zzdglYu`KKI>URan@3($`+Qav)C!i`?BhgV?wnwk76BTjCKlc`#Nbkj5!O-PpRM|3o
z>XuXDz3IB%b4F4pTw3cj>OVj2Z14P=YkU9esd4;&2WtHH=I?)?#`@8`G)DS~e<EUN
zH}R{8F%P{TA3O%aUf`PFpW=hS^u**<{=a<G#N;)^<Tb_QwZ-I*i^-o5SHOwOgGcAj
zkAb-SX>oaLaV1A_WxTi&L0lnNTs}fvfh4W~2Ah+`71G2Nvc(nh|NK2&Tp{((Yt7U@
z|1?@$Axc~!R9wMdT)|yJ!B#@?jI@%Wtn%^0${KRVG>`uIkyp`DP}SallvTBlt7z$|
zX&Py0nrdlWIH7(Kr{;)L!=F&|KB4A!{C}|b7Ep10S^h5+8YICX1QOicgS)$Xa3{C~
zr-EB>hXA2)w<=tM6z=W>3l`j|Jo?u?ue)cad*;o5)?07hn!8TjI(5&!Rd?OB>U_@H
zcklh>^Ah0m<>d?J<o(S4mlpDe&T#}gZxlOk3_EW;J8v>OZw5Q>S9ab)cHUxk-ZFOH
z@_*VYICv{Kc`LYhD|vXU-t$%q@>YxT)=Ki$$@4a9@<L2_TWxvUU3j~Ed3yqRzklZK
z4dLw#<?RdS?T`4QMe+_r@j|0{2cH#U6L?2cc*iq%r*e5`zws`V@h(>IE>-d_Rq-xY
z|4pmmU9Ne*{JgK`U8?4tD;Jz7ks1am^nBB*%`?yY>i#+Vx#$f@A+?D&xsN$%lp$e^
zIc<_9cZR)miLGjdt$LN^xe#~l+WWe-XMtqRrY+N!ZR@sO$Id<Xo}Zt35B&NL1N#p{
z1`Z+z_7b5RC4&>+p^XdBZ`(szN5cufMpI5lQ_jcJFD5dtrgCm)zuhmCJ}gx}t<*lP
z);+D(Kdm-Atu;QagP%5Ao_0E)e)c{cL7$F?pN>bKj>aE<jz8>8-0n_Y?@nFrOr2~`
zZ*9&muP@K7txc?M^{@SGUc0PcyRBWjuUo$dZ{Bz8-1i(j^d3KsoIlN8KP}%qtv@{N
zKRlg2JY76IT|fRwLHYja@$u<7pZd?+bLaWkv)uCW)6>E8{@JJZFS^J8qn%+LCG=;X
zo;hMGpw=wf_}2mR%1!J{QWV*9_@Ev(K7HbIH9y0_I*>xJ5|A7FwcGA+7V_sj1E`bQ
zu>N_?C$;y8I&Gn{3F^bZ`kzB&o#)tY&*6i!<*3iatF3X(a9!?zrXI~`xgy?o@r_3*
zDmFvp?OayqRy&{LHFgMu%Q>2Ub&(tw-am&Avh`FOw7!)bnPrnR!f@NUm=C8m0Mi-R
zD)y(DsKsiK>L4-cHvF8{e9cHxLhK<m)$5SAW6^x9npjxu!BXOO{(7F*6ycq6w#6ZE
zAezunt9mcq?b%&tNL_6$wm&Ycs$yqE#^6d!3wsvmRdu`hT)y>UnZp@M@3q+)d(Vf(
zU;AcfoB2p~LO9^*?o?;uRVN(u3zs5(h<w1EGagjbfjTt96;C^T1%*)i7Tz7xKW{=f
zj!7p+<!L8r)l*gvMaLVbj&{Nl9Eun6UXHv`#~=P}A8F*9UELp_-W3A1V_~O6g>kZX
z2+(M5<&w>$F48p9P#%bee##x2#8=T7_(gM1MP=P+>80dzNsKNVcXO<RbXoO~DW(jB
zSoKMi9B<8r_~?LH)fviMpYxxzsW4QDKBHfXP1`8CRzI*AY}BSRoK>~uv+XprZK4Yh
z?l|-;5j<?S)3BCkR51?OlJi8fPAG>^V98-2)STNd5a%s`sE9e`h+@0r#4S9x2cjK-
zhv4d0F#L4=cMfISqG)$Xj1|G5RzDj{*pao(Q?Ge2@$>B@4N54D_pH*vYG4&Ar2Ncr
zj+s;fb*5~b5KEhh_qJ~%@A_}MJI**1CYbIl%=_JFK7Ohetu;HWF^|~69kWv@N*jk@
zpv;k{?WCgaqC6)&|EfloqSpM5AF7CzwP!|a=Eb6-Q{`|cYo_Y+hzE2P6A(GN(8YGM
zw+-Q@K%!_i?#HMreRtZ!B}UGOnK;7-lxr;M4j8HRpd)BkqvCP`sEv!H9pjm8Iw-J*
z@*?hXtLuLhDw|>uIHqb*63M}Zv2`=adCUb3V_Y=LKFnM#XN3rPHd^r-;}_ZKl&K2m
zZ#N`~1VY<gv)+{p*3}|r2qw3XQ)s4|Fudxmn+>s7F53wE{)2ivMntmd2jm--<u)-z
zb}SK!(p%y=ghedfJw+#-_hN<J55cW1r0(Sn?_vZU&uliATRcfW2)P}jV%AP`8eGd_
zLcn`f0aAokXe&SG2xdIpmn>B#ibBedSa?|KS|-kaFO7V32#p@~Lsa0c!#60oY3V^4
z3x0PxQ-8vnG4kGCEv8Q0W(wT#k|Nxz0^Zam+e7HH=&sGlRybYZ2H*o6>L(bgBzo5l
z8b`(pCE^54Uy5W*(-{yFte9*-{8pwSwD*O!yL?zqlZ@am4{Q8L2D}fd2}S(u3~X^e
z00#BY=9nFGVx4&LJ3-n0V92<CQSe)cVt6Vfwp4mt7G={8iu<*q#AX35*V?nYfLKf7
z3m_w5zHqY`xn(R;P#!5UF|mvC2{q_lUeel-tTdOIY)F;bTS=_BzE^oY@^>5IY-M>|
z5I7qggga%w{?G9waFlO1HzP7Iw%*=y?Z2t7SQ@_V>y3L6g3<+tC9_K@g6vX=C1^iw
zF(Eo=WhZ6xN-Rb<Q*P8wf0~s$KT@%3aP*_kMb-vJG2ejPm}}-m_P$~<|NP*XXUj#-
zX-u);p4_<4(nanqY@}HDW^g><{^BbfW{D_@`~;BrG7nYhIdynwB8>ksA1k&*l2(2)
zO8>HeXtYF{cW5%s=kgmFW~r=<{8VD*Wg(qXsl3k6RBFp5h%L5M(OP~wbLp~(Z?sg|
zYiRoKs`=q_a~a4!s^gHGc1bvp7N#Zb&r$`FUdcHGmpPo!;2elH#_ZjO33lkWU%-Wx
z>oCXZST@a6#ib<9kV^|R5TKJ)nt9q%kG;=M{;Y1|L{3$nD-slpSF6^@To=rsb;thl
z@Djl3aV5vv<RU1I8ChQEQf4fVC;wGa+k$PHI3!>;x+`^7)_#;R6mDAERWH^;ofJ0o
zUbbnjH@C?r2kEs1sV}v68-Y6@A=YCbX?7714QV<~SkSe{>dKaVJ9mF1T3Eic1ubf9
z=^62G8WyUZy)GS@O)>XkT<l7n(_L;P6y)KXKbe!EJ5IrLZ{!r%Qh%<iFJbSYlC-wl
zbklAeA!Rauzp7Mt-Snk>)EZZjxiUwhVbFsGs>ry(P34Whz!t7b<VX6rMer<V>?lz4
zX6*>syUU6BG?*~v19B2_??Gr;NMvdu_lgI0J6S(NfJa;tO-e!@sa6DigHAcYU1!UX
za_IZrRWOZb-w!S4<Tr*1sNkD6WVxgFI4G}*6R)I1Ias{HEAkQCoEW5Dp1^#N?3n-p
zuiGfAzL<{+>|mM}_1dMn_?8ZDxH(gj*u%vLDrT`yE~T|tRH<su9uXWorj9ClRy&G3
zykFsI9;<`LO*J>PF`B%tgm|DENFEyRHcHS%D079j5Ofxb6Z9z&7`T@5>s|l|h&-B@
zOoFralu_)-Kg5<p&(ACc4Dc<4<QmHc1~)CMxu)&<tLl}84r~n`mKMgEn!uySAAKK|
zH(r7v14<{ZSr04w%HWpy(G$<sht<<KaNC~JFQ4Uywc9ap$Ia-kfQN^5xL1%a6y;Ok
zo5u}Q6-W=^*lC!+<0jS@NH4AOS(L%!7SZ^vNr0kV`O1rhB4z9^Fd{#`Pqr)6mu9T_
zrLJ@Cqw{s|>Z?D>pxC8<&1T}}J=6M#!M%XPKT0*;oZ%Fg$Th6!@CB4)t2Wb&F+WK*
z6fikNKC_?wCd;>#=H7lwv9(n4cv{2uZmN#b^C~mjuvb`iqSJ3}hS=y3<!5zW-E{Pc
z!~DMeYC~P1;(nEq%`sA`^UP-M4)=8239gTGV8-xfcc8bgg2q8~8Egk_T5&04T-V_B
z*IVmHB6{N+Hp#JIovwI{Qz4YO=;_?M&uv0eB%W0(r7V`@>mvu#Ip-7a6b0I>0&WVL
z1hPe}miuW(<#<!s#8PAKWeKU8D_{B9Dmqn^Xpw#>AP^cLfngLSGct0GhVyvwl0NOd
zD)j*2Z%wO)y#9gy>8e7f9%}pLs<8K0O$Y05321eo(|PCbmCHalz92;1AY|{LXP+<{
zBnV?6=vfpQizpa}FZfv$nZP@kC_VUD6q#fp`0Z^l84-|z4@jj8r11vQr2`otz-Lip
zmRlej(Ps|6&s@5nCvRNzXgM@=*h#&DoOHaJtm%gaf~s$P7C1uCZ++|=E$DD`S&O(O
zzZ;Kl@O<1f)Fh(xa(yeujW5^u8R^z%S<Cd}9)VP<aiKNeg%q(8foE`SSgxm`Ev>12
zXb9S^&j_`*F^4;fr?G^tg+Co0inc|mbodLKa2Kmju<In>Z{kMAT4n)IkACR@{OiDw
zh#(V)l|qwGSfi^#zeSukN4%~DSCjqduDxW0-*+jSpaciwo(Q3{NMpEYfNZ2}YKU^8
zRZfHuvXzJLEn^L8v|pH=v3jKNt=DRBI2F+Hiw(D7QdmA})Lf#K8Bh3GqgAg>5Fg*`
zyn2gU84A{GuTan@IOOO~f<QTZw`R-F|Ap|uf6u3<v&bjMYWh+P0(7Dc;M??Oxb>lm
z#G#D@%A?v<g@xwb=oI0=LOE;_=g0%hQmxjnZ0J7$$$uKChZ`SCMPw0#-RUGsA<)P|
zebEv5<w`B2GJv+y{>F&r;Yd+3@2%Ku+zq(#=J_1PRU-v#flhn=Ix@_TDJIfh;VPwx
zVBI9)_ol(uAC{>DbO}<ay(6inL;LG|dU>gob@ke0K0Ho+e*L%A{Qe)M4L4_2{7FHB
zt(?xnj3-4AAy5wcC7d`_+qHMR7uMTB>dc}KPvEE!ZCeO_tTBhLSX1DtnkVX+o{?No
zP&cLuh-vfG)<MQ*2o{-AL?9wT=sky>gRpNHTuS=d)5nX_Yx%wRGJPO>B;NW)8UYPn
z1~=8a3$tXYbi6&ooOE+P)X1lN?!%10Cv|WB*SWt_OnP?oTo#NA^S|QK`p#w`Y@3*N
z*5!=y<h{G2CA&$Q^fVYM&I_Y8&Dpn+q&00LM0fYf57WVVy;Lv^PW4$#Cd<sb)XULK
zO>Infp<=)@Ku$|pNUF3<qqolb2*}|%K+;Yn<wwiMp$&h;!U#f6<FpO{pnZ$t!x=+L
zMJ3LbkNQUEV=WNnf<t4InVJ@s<|<lZEOFo)(QnAlk1u-wQb4m^`B8{XSWr>y1*#>*
z3Ih#)!cs5&4C@k4tC<BQ-GF?gJzt^;6BqjlX!{pg7V0b&y^%N9$^85(%0P&`Aeui#
zBjOX14T46Lzyxo+y*vo{&c*mPv+BOAhPb?rzq~=e{8<zkl3Cu;Qr@;y-f>^vMO@Lt
zU(u^y(eG0M&8!$|sTf(R7`v~S@JWNFxk;L9AF~OVdFtZ0I+(q$^dZo-kjw7Uvh|b$
zGU^$w$urN~X$86D3^b++W>l>|ueu^lcb!Y#pr!oGjGo?!cANd$tD1JokQ(u=jJ*XF
zr^OIoKh2o3jKaGLxjcfd%!2X0>TW0%Ru`h7V=8ojB*IWb_@?@GmKg*bb4d;A0@QJ$
z)>^)X*;+2WJa;Z4Xs!Dx&%D9!|DvV%R=%E6L3?(HGTzR(W``T$P32#z`TZBthMyHQ
z9-5rrfS>F7xf_5zeZk&YV4qg7-!eGh0UY!O0u+FR7(l{&ArV=SXHn$;Lipgn_UUD{
zwzRgkEw^_3XR7(h{kK%}I|};yDs&X^Uhw>I;asj!JkrV)8y8%zkhsN*it&+*KlMkr
zz&~vJjssnz;tHZbeUOTc<BE+RwyseXi;IEd7a8Cvu7X9-#s#;z2lvMiE~hYV1r07!
zH_*n9jEx_lXXEk3jPYa8;&I&KkBq^^ipA&tVqo8KT)_yaZ=_=U2dHl~13VJ=Y%@L*
zw|M+NIG^!<Fa3Y=9e8#pv0K!@<>hsMM#W_?gx2JL567aE&z7w%=!+)$Ly*;63jH;k
z=Beyo1zD;4(FhIyMI6Gmf8@U^$XdA!cK$JxqX7Ox9O7Vg7+k&H8H9lTrz&)tc?hUn
zy76p41SDi!^mL3(F|olUPL-EpVs5(wFR*P`;M9=J;c&I_6jkqP4s#=)mpcxsTsCk8
zuZd!6h&JI7S|o0a(@ng$<}k1?l@;$B-4+m)iQ=&`LQy7g=~PA1H$1!7yRl&mA~|d>
z-ZM*Y;!wICn|-rKD7j>WfQUA8sjq<ZuM9VRLLZnf-&m$n$G=8HR=g$(=mf>*!Cjcn
z!NXs)TW?B^kUJXyFx-oSKA{Z`tbc06BrJe~p3P^Q$5+n3g~K48$g-Jfq}2;0+}+1=
z>zqXe0^TA=U<Dw*_%soSE|s_F$+p(?H5#u<TQBI?R@T6i@1Vr;lUh^+oUPb(8dk!3
zBz<lq1}0sXIV-{Tj;mS^-;R5lN2Fnv!R{y3loTn^oN(`x)Pe-+#2eL*>9JvNvPb(M
zM!wi9uZwe&>j-xcNs?>eE#3}gd`Ljnl(i9)749|6E979<K@ggg(=UYG<?ENm@!*__
zeak~iH*g7yYbnW>DR@Cq;c<X$`OQt37?gr!`koQQN(?b7hP=Qs^u)Tiva0ElmJae7
zfrZ&em-#G}feL5sj_Z9o__`g+Kc(4N6?`<XkwBgr{t9eZ)jc+gYti4cpurNQXhjup
z?<&&B$vXXRa7N7Ph@}&glK7}!an?`bb#yjB7S41IrAl)+AEYa;I3HpHADs`g4KQ7d
zaLqehjPmVOT#O0cRGcXbqZmyfQNCbyM*?75T#k{MVs%Zc$}nHeXzDm#&FWfLUd<VL
z9be6xgfm|+Sfn{#FWMAWUN1doqh2pN4=~@XxX(M@ta|TN-n?A%yE(pD4?<zN-7rK!
zgd@L0g!_wl(4Y9g0~gM1?c2S7ox6U`ZC%?v11;ab<_2$ZTSHx;Co$H(5NK`g*Jp#1
z?)|Oq^?6ro-<X-}a<DJ=*LldZrJOpKg*Uf>9k+!ix1l{`f2;i2Y-T=peG9UFlDmFV
zK64TSJt-f3Ha^My3WcoCcdws7W}p!0a?H#L1PUz&L%V0T{wL2b|9kEKv+uw&ALw-<
z|C|qf=mc~of5!)D4E+BW_<+c!8;>Ra84(#5CH-jQFMMGCgAbTCG;r9@e85q}ll(Iu
z6fFM22YjNCXFdc2{=|ofKlp(87d`;A@glGmzoSgx(5Q+;{3AY)bIB+H{w*KK;}>5b
z{lSOQc#~&7GzG)`nGdg>-vH3u)Bef_v%lp7!N1}IRP1m0AodUWVDtBUAo>S<5c>yw
z!1@axK!_AEd4J&p(!axpfj{#BZQ?)22c*C9f#%=g1KmI213l`0Cm&S*#0M_qKl4HD
z?;j-pWoCa~_CL$Qjhw@Hq_bd~ZELXSP8(12R_w$@y|nV#MAk^^v%v)nwiWwqc|KLY
z30rGc=1HA8gTdBdTW7E>*yhy8`E%z2wz;*od2x0=wbtBrHu2mRM$RwlCoax5+hEU~
zKMh^1%}<S_w*AkZ4F31(|9^A`{w6u(AFceq4Sf02gJikCuKYp6X>5NZ3%By$wDPay
z6NUSXgiOvQ%U0tQ^!*hHDwiMRY!e5Ug!iq(X^=SpQw9#1j66gXG4dwLb5TbUsRw~s
z1KC8cTNE`AotSQ;#nmAM_2Ug@&Z+28N4g9;Ei;)!FlwlXO&*gez!iw9jh=1Pn)hoI
z`9XW{$Z*pGt}7fC{ow_PxbxT>QB~y1bTW^dhF1Y1w{JHcdZVzpu2nZqO|I)*CO*LJ
zv0DYh?Zp=7Npz9c5ChO8(}FxvGEmk%OINi`;o7<hvrR($3E#rO5nyFmLPM=}f#^-?
zSkCnzZ!rMQoDP;R!lLYiAF9~Kf*V!Ub#4S|K&r0)=KBbJH>Q?-DzQyHZ#XONerv3_
zX+7JVuotU@T_%)hR69;miQd~T(fBXmolJ#)T4kn_#uFhz<ra4BNe|M=Juw>l7c46h
zUK>V^OAT6OICZ?vMI=fWg*U~?Tr`eDqADpC734r%$w^1ED@0)LdC`@5?2>5{&44D_
zlb1X@um7>q&zP9*tAMK<d8uuS^md*#fqr2kfc;Zhf#t!CVPOT5s(~BgP?2S20|8Bt
zd)HXMT|}-tF@v{MQQ1+=$2huf+plsr*5;|gt;OQ^`RHE*ODfZkK7>RK9h;J(29ZM^
zSuDD~Njon8>Qe63XR$-1ZA<=g%5Zf09ZQDktQSwm;jE9y`aiew$NS65{O<#Su;Jin
z003&tSCpjW)PD*J;{CrHDXqX;dVVsd_mo`RuMNrnXk@Pq$=(^h)0D?eQ^tr8Ch<|?
zF_aLK5tHMQQe;z7W>!+Akuf4*_rhX`!V^j2R1Q}&3~;w{`SQ^zIVdD4DI-2UHz2&y
zArzt!)F2a7Cl%Dl4{TwJ_%8fqL_Tv)y>P>#ddH#ZD4^#eb?~rlczSqvc<A}{FWYne
zT7Q3kUtfP;&-a1Wu9?P;#p;&HlBVz9>c$F_=Zahxiw%F&+H5zw{_OHU?F+dajk}xA
zdE6*_SgU_nZhl<pdD@0Poen<T3_U#zKRr%7KFpn8>>M8-KDVQz!=DE~w|BNTHaFMT
z*Voq8me<y&*SDLu&ue!dD)*kMe?GOGK7GG>8oqm4e0<t^dfNS$w*T;Oa&vQbd3k>E
zr|r2q*wxjujOWeW-TmX^!{g)K<Kykq)8*6C>C@B6AN%X4zecD0OO(n#c>lBR>c2bq
zuZCc-zq9&RqklK{$A^Dn@I3TyzU}E>ANr5J<azwxJ>}0=@=u2T`HBCT)BlOh-~R6N
z{Edl9B3qLu1|+YtC?((S5ksK#bk3;%PKJ#0Vf$!Gi#GZT7Lr8oq}22LoyhN=Z79d_
z5*m&ydJ9z#r^;a#XX{#_cSei^3ZsNg6eysKf0IpOFdAwooi0}WCZA&`N;UYN@}=1=
z5Qk1J)!lC&&n9JOFxg6_B}5Jor^l?9VO&x>T+-F-5sK5O(D;Yv23Jub9kfxTy?W1=
z9v_!ofG8JJVQwBWh9zFLzhwEH{6~U#T-nU|`93PxIiw9^^K%@_lw!CzP3uj~@iN3s
zglVL;@Z_7e{mkZ8Mjn=cp<U8!HZ_YFhJfd>{-d6bP3|{^i-vs0XwP6OL)cA3Wt-jI
z`u=qJhw+Yk#R}wZMb>fBxC<bW-G1GNr~9!Z+2EQ!hg%n<EcLpx6cb+zp8bu_>Uz|O
zL@lbcGx%=td4{OYir{J6mKf{!kb?H>RS7bzt3F+%7x}~b2*DE);VmO-61EH(g-D_N
zVKsU1EQz}k;jM-J6nfkc?EykcIMmG~Rq2f6kO6-+l6dHoH;JEs8UzWI5~#fuEaRdh
zqb!@Uk*Y89I^JAPAXhRowZ)J<Pp<W-iz0%i+jJvR9hreH1jm(bz#lK5aK*;tWSfG7
zHZdY6QZAM)k;UCFpIGrl`@)2j-Vx#amtAbxJu6-_Hh`LYvglk8%w-!7_>x<Vf4>sK
zLAR;>mSz6ni=n>@-V2Y3Ng8o8W%=D2`&6#*A|2uhiP)+GP&8&khW=V9cMVal2Y}R?
zNle(G!J%ru$o@^F_>q|<#MAFZ1xwGlqyy;yTFOyi6OBhOmcfFHx~}<Pm}7LSw@w*w
znPHEj12xocM*H&ZYw?o3vhp*v_ABX<^x`w?pnxBv2EUYVb`|D2*xnB&mkHaDpIZ5d
zQ-zblFf{?BKN1h>zq8tb^Bf3XUhehFQqHnFz5DFjP1qXZ$=)l%F_aX|MuA>c7sPT^
zZQurxXEN2~tvGhjMK{VSL~PE!Tz00UE`5cMi=LJ0>HH!I7NE~n<}voFdDXR3bW|-L
z-W->vaS`JiDVMl?JyZOKi_XWpA%ib$;r{oekCfr$1c>6ONUa{uvWf2`@5GLq?k9km
z5^dAt*2^h8+wn$z-eP!Ges{m*6d1_HxEkfk<SEcKSxBh1!%K(K5vuq%*<w$LK8Ol6
zrJqo^4nZ25L|%5l<5fqr{^~0J%ChYKVRF*WikEjHK5KHpG0@yI_G^GO@nr)`IF79U
zi8<W61@fQ<d&AqhCN}R_`v8E%*Lxa1x+Z@GLKC8OQBlosV%;JJ?)2C93p{);!X!CQ
zD1s$KMS;w+;V5q;W3jrp%K5i{axgrnt+J72vF^u*!$i$D_DoW6GiDAH@DwRp7HHmN
z+p5wTE=1^g!Xt|&usP3Ut?Fp2hrcC}<6v~rak-ShS%{yMbjLCKbgPLYGN}+rY@lzN
znaY`Bn9o&643*-jOE4M<Mi&msWI0l8*xzxY_sy1gx9LpTe-tF`u^@hdb&eFgTFa19
zk@N*v!UG7Na8^JI4p2rOFdR%^1I;WFawHFRsa7CY#(<axy$bbcLK%C>BX$d{hK=vf
z(~vUeScpHt<Jjybb}1HdXuJjr)Y@iD#OxyePC*LBw?(;6D&hhEp9KP4JOW>Ocm0Qf
zK<Zx(HqiAqfP~urVIa`b^fn*OOIf8d^|YaxBL1sV)z~u4V)=g~>p5FSvTqVzmw8oT
zqg1XxKQ!0Wa#iX4Z)H7CwD^NCD@;%n7J7)UYa)~?%m{}U`uVSG<6|o<XcZQR^snnu
zg+Nxk!++Ef%fqa+kx}^nLLD(CBL+<}1k|x04CT5IbgEkf3%<d(0b~FaN+KjvT{+z6
zf80wiq8_Q!nh4GbK&k^D0+#kMHdY&en+g1aZNfQ5&ddanHNC5;(gmpJoQNgD*F&ua
z2$y*b#z@=lrG(XfNs8IPu}}X_uY4TEIkB~^ZHh?6Gni7Z_yd8FXyE-d2T;U0Eb&MT
z@f~s<jHPJA0&`>oDq+PDk&$ge`*pilP5L;wJjU?dvL0aoOJtlA#_r;QF2d`HE+ToH
zP&6{15mD(nWaSOyL{a!*bC!!FwF;|L#1=O1lLp(Hqb*_HMXIkX4Ie!ogRv|&kf`MV
zQAVS-Mwi_K#AIA@=QZ1}*Iy46oSc=4VLDJl^bv@pxq;?Ei0C$Oh-P$yp!bhQyjdYL
zEl>n(tZaMESHVkUHJ)i|Oks|cZ!oP~#6xj0fw(oM)CbBnFSshBsUvO?<RLe&k(CnZ
z!6vWPl`miHw;z&|JRsVgddZy!A?k|=AcM3U<8-jL7}hg~gq3UY+D3k)Xu^+b#_?st
z>~m5zi+6g7yWD}TN;vO6clAU)t8hxS0o-r0`dD%~hCL?teV5z%iSs<5Iz9Fj(+0~F
zR?Y1~F;4y$zN6*@oQ0zp=ZMuNyUM~B5qF0B&spnzmJ?F3M)7B;ybJwSgM8g`ICeeh
zD@?L99Pw!*$M`FPgMKtui`-ZUWwgyd_>G&ZWQ^U6{7AY<=R<LrjyBU-pT6H&-FLM6
zne%*EK%&lXjmROnBWMWTBfH^F_gDeqvfdtXq`O8@e%(td5nga)y{mcgdHYq{r&lsH
zY`gF|CU}y5KQiX}-dc^F3!%TCY^8m1$hm?-#mBcB{<iJV`paI8y$}MO_su3JEZ#e*
z`2ME@O+8EI#ts9*yFSY`;WYmv`?+PmOXH8-o1aL`P&?lqP<<GD3d{*q8Ha64%z0&m
zyS1Ts(scV+)i?{!x$s+?25JWt?3w%Xx`dM3uXqAXRBdU3tuOn7nQsEuWj=Y`z?<F#
zOMu-!c?KvqS-dj=2o~4@2?7aatZc5~ZJYxu2puRPo<C3=KHda6?|l{{@DuL$KuY%>
zBJ@j@38HfGm(w=mr}1H$bR#W-r#G><lD1ac^{+<>Fux912y;Y$T3YLb4kCXpMDZZ5
zK|s+qyU_`ovIa^+J;l>KMQzMH(nI%kf~0Rf>2$3W(rrR^Lnx6$jcI~lA+?AubEaC?
z-mccbKmwpmc%UI+m?CN<^`wJbn%`--NliZ@2{OPY9Ej~15D7-y>~{-~2!8_OI1M~!
z1%&wCdZK&dRG>t>;&J0y2q7a3|8Z^EHi>e!Yw8~kd@c}V7#7*7`}`CqQZp5KC^e=B
z1yO6jF?!CUoX9(l*MpEYq9@HIy(v0t&Zo*dJS!C*TQ<naI{00DP^)(I?R?xaZP02&
z2<@3W=`@NVma`smRHSFDCtYkJYK)m|BukTfZAsMb0*W!4+v}hRz9Msf9rtdTD0iqM
zTNknx8)8ga{G&`<4^6BX)X{(5kATPANhWlQ*KegiMgr_jw+o9SD1qnP{W3udv=vME
znGT;0_CLOjW#S1F3`3#eOEwEnLW*?UqYXIFF$)K~&F@9S(IilrA__?35Pb5|Cqnpj
zoxsl*_6iy$cb$Yplp5@v;-zEhyJ6m19Pk#|n=gaFTE~Lw3=xGOnjqaBPR@(IKh0tz
zR3a@EWR()DV@(P5gUJGMz)@FLrhxSH98W*@u(%($DMPZpsx<B^G#{%Y+_?x{%!quq
zi=Bp{Z>$Hs(9+$pUVqXU$jnAgPl1MnM7VsHPKc#V(TGgyB8;xJwwkdqB{Kn}uv<|>
zf<NiTQ4B^|SUE?A0T6GZQh5LyG#`QV$!pT~#{@37Fj=DMIbU5}oP%pWYlt)Ee70r3
z^T2L)&5O*mbQJg-cz<ix%}A5u{?BZ>`UeE5H+KejFA^T^zV7weSz09~q2?j$8`s~N
zUVqBNSTc&@GZUE4!?`zlL+^g|KA$KvpSUIe|4=_b+NV%9vrxXJu!k0rzAI8OszB8l
zK(7kYKKROXhNvo!BNh)}-Z1keLp0FGF}epaVIx|}>uY2JW}3O|GXV_F$SNkFbQDBw
zegutsD>plkU(}~hOYElnMLAkXFq(LP?vR1~Qqdg}BGzj}pgxYi9f68TQOJEs3tK70
ze292_(O3K;5J6E?3zyhL$(A<K98d8U0pg5pS=vw$sYYoLcbUQkV!oYzZdqw#nPsz&
zaf}^~3RZClcB$S_X=re1xn+e?OL<>rQ83!GK^g5CLWaIU-O`)9C4Hz*Whgvis-1B=
zS}B7nf-|vW$U#}!0l>EmFsYsPLBFch4rIk&`jgnv)UHIyuEZ0q`0~0)3$4P!4s?K4
zrhH%6;RCV~D>+0%qGoe8BzAN=sBVF)OlzrnW&icAtor1>+K(8)a|vJ|3fe70cS5V3
z^}%_JDkgg<ByBBr(uP$TADEpifmqQ?{SH6~0#yJ5kb!>nlfIQ8dhL&^%E~1#RE45q
z`I@w{sv~_noZ-sUFz3n^U(xs?ar<Jxeu+wJm4-m&A_JnlLP;@Ng{e;oHe-+o7P7c#
z6}75eh`bZd8^l99?~5j!{-q{EJ4anc@Ei~5jG@VF2sEfuN3GU??dvN}_EF=&-b4Y%
zU>H=z-{kSL`qOgb2YW#NK?9Xo3E;Neh0&PM05m5J32kk#Xz_(EHRwiFc$TAUMMr2H
znDsD#1s58(=E_Zp!5Vg7(+^79?-3&)E!gNaF6eFX{6!N!t<-0g)#ar*4-JaZpx&&C
zss3jzfrup-L+ze^`!ss%h!14Yw<LYIB|9A~=37$0SX=8`dX`zV@TQ}Xv32Q9Ck1+A
z^Dx9*zIB}u%#Ggg*&bj9hvanKBEr_@<_o4`?|Le4?d5N=%xZ=mwvA-9o!+-Gk+)2t
zcgGpjdozCQ@oC9gZf`{I2u4qU9yIShbRlQA$G3DSD&#Odbd)c*EI%}8wRHU|udGmL
zKpJ`TEvhRdstFsVZC{}ay`?B3qMhSS-SBeZwjBTf=>^*3T-g=zwe@1O;Visq^^Iyc
zcqm<C?4-f&02=gcQa7k)H%UKqVB5DGMT0ZL+R6;NI54^=6~JWKoqTN-_QN3Bnlgcy
zc9?$Cck19S`j{4`+Fs}EBGniWoM9WGU?=uo2Tej>t92jaQ6KpT&gNmqwtWv1d~=0;
zm786Q{BmEY;ULDFflQu(_z{Q@W2qNOXZAw_dRg<vQnNTona2twgt3+dJs~2dzn-M%
zXc$UcQ&p$mr+U~0@NOp|fpC+!+@kjnX8AQ`H;f({QD%)g5hGZZAva`JgP7_Wu#iLV
z>qKh$oTSIhoNGDRYFyC9t>b$+RgrwNYiT#@IN|D8HtNp!yF=i?pIZk!K7kAjhmedw
zusZ~9xH^84QBe~|(sJaJwmy%g>fMo|J;e&upr*;AA>(@lucgkXrQS)5@!tY4a}E9G
zyy0<JcBy??gGg&09UAm!xsi5E+aPFqW~5Mbqk4YCNbG5vi`mdd-!70CWI9qjq;JF`
zP(PB=i&{DJ*E(WC1{Vyb2oJ4$f>p%N^0*3f?~I5d<qg)e2_E^UxXSBevnN!RpeQ+`
zt_^c#pfM+<xk2kmcgML1^g0cpI(x5LnC-#>J|Z<7NW~d2yiykB2S_I@DrXA1HUy;P
zG$R@jeIhZis2Gf82oh1My&h@-2^PyJHWgnkf-Jj}+RAYJmq7k~@mVwVE6;NhSSEJV
zVhQZ21XWW)m>CB3j5g80fihcBxZ*oevIkKFE5APW8NwXD)0+18GeBHoS4+#5Tzi)a
zwFc+~p)5tKw%KhTh6ZKq9rFx38N1hPH<t#Hzzg<e3W7_FlaLYr^_A5!{^)W9`_Vna
zA<~E1yu+cl=yfa(HFgdJb5EeWquDajzWm3!ow6#H=!x|E8k*5=v|JEcK&?hjj|vv}
zRb1apb7QT-;w1AVkYUihwe~g1Ru>W&N<69R@Lgl6*@~opMQO%$*~?VF+1tM8b`)H5
zSS_8~ka=A$%!v37V^wgi^WX{0I9XxsQ*ty~hOMw|s}H6d=~7%P+&Ba~(nG6PYpj_{
zjv0rn7$&|i^&B}gxSY7qIqb+e&X}n-<f8S#%v&ILMyqAVd)7xQ!4<aM*)_v4ZGuLf
zYwa^|t)8rYI0?!{7SSD1EiJ}X%VE*2-;cYp*Lu+zW)}s2zBZit%!sHdziQ+Q$YPu>
zSvy!%giyz<cT-QaFF~(X_deu)$EaF5akQFZZa{I|kBsYw#I~tC4aJVF<oMx;k^R7q
zp1?6qYo)F9J+98k?H{bFrV&_~M_a?dSkYxV&L3KPe{z&<vva*%n7zLha@f%cGXUhY
zUUZC9JRJ(a_EyI}^EtF?cC>`YbwfYyqQ6|qTpAfZE`OPOnl=Kmh^}#Q+(}n1{qVAK
zL%99&`WTUQi)!rj7djOC2nvbn!&-zvfC`7X9VbL0h5*bmUxOnv)oOXh!Mn9-b>p4x
zH7`BmF8IJBo0UbR>UGBItu)2UchyTV@=$@!ZB2)xZ|IkIk2`xWPsn~FSeslH`So=L
zY#k|ViNm%2ux~L{*~1$yrDOe7_;fBNh|sW9*oV2_u1s{z-0{Wl(0>FZ`|<+dbOavV
z?{GW?Ef<0uhQ&In#DtDj-Yj@WA1kpg6&MbkeOyv9-pyCeNjAD2F<hHvUM`l;!Tz<K
z&{~z}w;arLuNkn{X*pRpTwniGPOnhmVN_Ezwt@Um^wc)F;a99YRO@9oiLX@by1Gm4
zSnSv`iexm#bvlDu{pgB$tPiUmYkjx3+BRpPxcX?c6v6yp(SAA-`1E-A)S@&u7d>Sy
z_@KM8-px2Sn}U>Hfv(*-%cWoSfcg9K!|&_B-?v|X-*^80ZCSiN{u?e|VM7!M$j_E#
z|F$6>hKWg`xv#n<8PyV0sOnO*B^^gvo<6aVu=SRlUNM*JCxvVjfgKUDEq&sKOw#L6
zNb+L5RZO;!KMZjwo=Q0p`}0dCpN75eczIfF_Lehq4Um@n1_ll`8itXI83EOu)~;A?
zi*S?{abbl<lVgexH3QYbWZ_3%j>cuI2=oMvWpUDUt&O+DMw1=*0u7Z*ZLy>phI$%`
zlZo`VFAE28_IhY(Sv6qFa%`?qb%X{EV(F?T*7zoh>4wW!+xl(ja`H{ky843=GntDv
zBMtLkqpeyY@QZA9Xzb<eEnz}xY+}{@S?jxUZqgRDC~8)Su6*Dq;?i%%T(&a;{Y5dA
zB4NLYPE5#0Ml&OB+0AZ85rQq+UP10Nr=7STUfL<AeKzv}bUnaHPKd_JGL$!EDAHl}
z;6iXpM5BoWPeTxIdN4$SZx4rr6G^Bd3Wr|~jU!^>YJRL5W09CFXw+7Z=n0p8JP;{+
z8}*_e*PLNODi{b+B<z<hU>Bxe%~VNiaTj!{WE9}SW@>(nW@f8Yj$jn)Og&OVB|fX0
z5IJK)6dz_q&xFPGG9@G)4sn*^qW1|Em)GVojK^q<1m{99CULR~O68DLY@#}a%1QRg
zD$H)_hUj^vm{`7{dEkI9(d?2sROW{i8)b&K>x4qp@lPhnb1*LQN2LYm`wdkbaON*L
zjNHiu-Vw9B=b{F<H&&yrPSQzP?xf_8F@!Xz%gzhXLmg`QH$$5FkZy_@su8*M!sHuW
zm6@1bo%t1ha!%{gen?3pbAN5HziJ-p=+$Z5iPWTJO4@fg?j%+3qGv9ab2C9R|8Rg(
z7StF|@6TFDP)-1N3I37WuSGax>Tyul7mvg>WW=$Ff4lIUV#O`vs}najocwe(uBKtS
zTcJX=1LIB`3vn@<o0w%;p6)E6tGbru<`ceT^nWceZ(dFdxYJ}A_Q_bqzN66TlGK_d
z97=to%r3^0)q!P;o7s9xS#^PD=8z3uyAuIeW@`<~n7iXI<{MZMO<22`kBdwJ7|%oc
zZ``n|kgIXG82#wm`Q5@fvdFm!BU)eahD{jwwU2+8X5u7Nd?24+W%3n5jxh2OqM3r1
zChb~Qz%%lgo;e-s7&#KCrP(I<VAG6f{?%w9X({FCdPrZQ9rUxWW{CROJ;9r+RE5q-
zvrmHY?YAG+CC0HscC&5%H|yad0r{oV?>{u{42T3i-RyOek)Nf?&ffEi0thC8K9T2?
z!AR;_5qKtoUxk<;QuB$SX-@zNdrgqJA!08*CqBPJG)0x-6URxN2%(iUMbm<a6EsbP
zvWA#qSn^2_TgAQPhKjxPfJnT(o(LB~G{XwzlcXS+jF6Eu!%2ZiQqBdv<jz*dtb&tb
z;MqpwE}`&qjhAA<v4}Pr87Aybmtv1gV7BBk$DB;>&#Op?Wq1Ga#urECeN%j##}SnD
zEL~jaB!R;J()<PdYiJloVmvw5HhFuAtN@2PRiyhiGP$i74I&&|+NEe<7x$p7S$q<%
zA^^^UE&heOiMGbQ1ubLx5UO$z5@H4b$#{cZo4*&884JoxSfF5p2cL#?X1N;!iw7tH
zYg1pYd}gHP2v(pm!2rksQPSy06%)@>+S>~0kT^ooFyP_FETHVKdlZauLejdE*V&>M
zrCfMwP~q69CFDyJRO2|3=M@2b9@xWb1n}7@*_KQ{^q`S=@W>R9E~H-7kdRc+3xel-
zv}935N-8cS{B}5Y6rh?J0XY)Btc@g4F9bK}5`evkAkL}^#Nyh^#~igpC-RvJrX$bi
z!iOrdo+@};tLG!t{!~sVnEIeDhR79UgH~dqu4G%2b235$XGI?`AE!=+3$+mb+N`1{
zKAl{fZO7WVq!qrOkUwflr;>ac%*m8O`)Zc%eW2~whg>Z}X%l-^7h9N4n_cfWJK0k4
zw6gf_wJU&AW03e<SprQ%LmF{osrby@JdjHpBUFi=g|j>wgyU8!B4v&8HA>Mc;37kc
zsDvfaWN4NLsXR!lNE@Xm1U)ABD-Qc1E8(ync7!ST%X1{Hm)`sbeeLRj*-*>aOtLKF
zCV<<|QezFfWLLDpn(s%4EZq9jZ8Ts|sMLw%{HN|o@tVYHKWoj+PhoQ}CCjz6Dt(lE
zm+J^L!Nf)%-TQoXa>qQr_2Ngk$mp-6^1vgKv$II=>5rKPTo;Lt?kG`bss4UR)zG|h
z;@WKxQg@`&!0g9tXFa>-IHcZNHcQJyZ=wa1N6dK`{pESXxB>%aCw1AZ9>!wEm<*s%
zl?a;FsDEu8j%f0LdLyxlvG~nn+<1N`U1LER77)F~p=zRM5!cozN3USeAk@-6*3~0X
zez+&<Y=3f8u~nSUUb}_tYkqX{f7EbOcW>=bv`sIvU!~M&Xnhk~#}ZJ!LVklY^rLYj
z8Ra=WZrZc_;?WiEsCh@#j<a|Jkx^%$Eq*0)k$QO4&6OEz9`+JE3h#Loq!z1fhCJ6S
zgaaRMYqzqiPd}IcvckfE8Hk2X#Mjou&GPlg_7#IqP)ff=puD{;PMY`d&lI~zUZZ$r
z^!t%fml{;Ad(|e_2MnPro@|YrA6m=&`P6(hc}_zbSg?}h7G4iJNfk5)XIg?bvDJ?z
z<bn?Nls+kC6;O?Dj3828iw(Fvt{z&7Q_*G1@Ay^qom#dI=KMPwpI$J8V6HibqK9l9
z9r3*o8S6_37Yv}TrWjH>5l)e)-C-PG8MdW!OP{XWjc&UOcdJ6r{N<-16#i|T`lnkS
zx>2-nTEQf%x7645_(+v-pBa#_N14v*fwHF0Tw{kvmDlRw2Nd6hK4H(gwACYP8Q-PZ
z4$mg=>akO}@5+v_SIhkBiPwPd+Es^FhrsGVAd24xl8ASYx&NNr-a~SF$3?+j`x%Sh
z<0|EN&)|IfIYZmy3g?%e(Si00n#adw3D)yoH<;ZerJ&HV#uw<+@9h0b8Oz^h8KX5k
z2J(X#<)P(za#y>#BQ;;f57upGb+xCj&$^$)>yB{P2F^2?kzwZQuXbg}&u>rVgxS1U
zZGoy^m)^W?XyZQlal-G-%nEXjmUOPEFNQTTF9qu)jGC=|m@3m#t`<I9AE}hSPn;hS
zre5w)^6gyDiU1w3P@23OD+_7^up*66Uk`GF1=`^ZBUH<1WXm}M`I+IoK^A32UiV!$
z2y~2}n9)Z{;Sr0Nzc&LJf=?I#*Ni~InFuijFcDSV7c-H1fp$fE)WxWVfU+Voyz=<?
zN?eIrYlf~e@or;vF(5?v%QsYNo8VP>82zUUR)!VkSM|^3DLZl5>qwbe-%>G#k+C0q
z<{|Hmq$ClqJQu_D3#Ks?rU(%yAVC$9r(bvN693lIEy{_K%=y)a``tw~l|d_7Hr#so
z_xPad`y}|=%<ok0J>2d^i-$t*{lwAhCFqk;Q6HIsvTTh9ESFiqq9mw4wm8|T1a97l
zt50!AZ+B2{cgR{u$Tw7SNJdF&b||)$?J4kuKg;*r^#<!!nYc%qV$`@(M(j}Zi)*w$
z<#*r+O30yiZDvW@0BH5yi!6ME19~KPe{?LO$smvvqbSe`N!B2IFF~2cJFDw1Vv}sd
z6;@yrPD}4sn-W#Xq;?dn<asQHgQb_@&PW|2$Pl;*uK+rQVo*`3B364UuFShaV`9A(
zTW2pi70TL!fz=jvG{kvum*)ck4N_%wRB$ClPHnPF29OYp7bu@0r=RJCA9}1b`)cc<
zuUh09hUIdig$EYo=nv(7`nKme#C#>;FTnVgFDVaZlP}hnZ?zf1h?1|(l0Wy6FVY+;
z*NiGt<f;_>R&gnxw=sk!-d6J%**E;Yld`SRVz|kDxQR=!K6$vgaJZ#mxV3k<ZDzQA
zd${9rxD#=t3vZ;GYNUs2<h$fZujWXfg(ANCFgRocnmjT{QUGadu47VcXlt&$<R8l>
z8{g)ih#{Mt;h*v&o7Uuq%{Y+F;_=UMk<D8O)-Wk9P?0UIC@xYdE+4&H4S7GtB$}Ar
z^cAkB{JiVi#%RjLsCJ<Qh-l19z4yKP$oA2zUkGSq?#jiGZ=iElZq9+PLlBfCZa1br
z5rxuY@y@dcRuRRLwkdi~3r_#m(i7nLNgX}&WYZ`rw+F7u)o1WzcHVm7cT03e1qTUR
zjzJh-kBvs112Kr#@B1&ei17jzb<ScD^ZrXF)Z^`{_>vMtdKD%9;yNO}SLN)ZKxn9U
zN#p*+dj+harIPOyJOr3*=yd3qLZiPmm2WA;P6T9GqKkbwB&^Y>*MD>!{HTi$5e{Qx
zz?Kz71Id|jNx{ru5zr{8>t}VPNoq|)R2=_tT&+&FO*VA%a(#h5tcXUU#>NlPn9M?C
zKaYg%E;*>*lqkMYrc;D-l4q|%W5h1!fO8b1#t&wL<Do&X5_j)Mk1Y+O12myk9@J4A
zwm>qs_~=*bht&JSbjxsMnXYhWB;J&P57^OMHC&F0uZE;P#8fI(G!O=HIUI?|{E!x^
ztVTVq44-NguT=GpnevE{Ge8d(LDz_y02yqRz&55XL&n{Xz>zhjXy1AssV4O$q<<%q
z!Fh1m3>7JE$zJ(@=t!nyeT6NCiySN}1w&O8Q|ddm#!wzO*P?J_kouGw*{am&i7e}*
za3<*l<|JX2Ghr)L9x)tYb*k8W2sX#cyLLJ+wnk*#XMvDn-F8u}SrMel>0mfUk*DcU
zll~F)`mKUVj8(0OR&}0-DV!8_Mk8&F!+DK1O^oj^vT$aad&F$|s?pLJd9-v@eRy^h
z#klFZwlC)J%p0r$oH&Pddu<Ytkcn_Kcv>xRiRerc(hQyHv?{u`(N>Qt^<+8sq|=~^
zs9Pi+K6kEjjfa9>t<tomdp}PO8J3}hBXB|Sa1s}N35HA8+0(#*LG30qU+S+`jNhBk
zr`pL)%YQ*n_Ut4zkoAw{@aW-Yjh%0-DK#=+`>wQ{%v}*7x;&Q1_XIy`sZi_4JciR+
z2n#M-=8dJb85ROd$?Ag=UZv<8Fm}d!7~$b}`canU*U_2Ba`-=hQg+6(T3*sPMkP~>
zbM~!tS$4rf@_rnpqfpCycVBak?1{-yk}0F=c#`VPHh%nR9Qv@96s^2MGIARF?jncp
z9AEL$viU4_wAW(&I`V@|=6br@diHn4o|%zMU&W!z_1{PvJ-!9~R2u-E4Fu^8MC}bE
zs|{q&4V17A)YOd^MH^^M8|eKT7;_t#FY{rT8?TTzv6Lx>E1DlkN1l#HAKH~}wbr{T
z*2_O_N<^7vnQz|gtPvoOygnf!y{3G-MulJX{#`%i!Zws0*9aL@w$#!kXi4+o683_;
zigLjMfOV@B(Kn~oq8;AHf#gU@)=ySJtju`Q$Esn*yjFI&A`e=fg>c9iQcTm%s#yA~
zS#qxxMO28z@}W=`@$Pcs)Xcxn3byDg^`2op&7L%t>O^udehDb&#rr|2^_i(@`X!Y*
zm8Ys<!<wa`x#13Hu5Mkf{!DzyxZw~ZBZ;QLRTbUq3VE%@2!qLn<9U5fNl4F&=fk=h
zsG3ExcC%!Qc3SLlT5_JO<U3mml=?v-+hMWB@%}npnA0ju6{dz2j}<d`s};i@dKMwO
z<eyh_4|J>)>ylek45slkF{bx{I>!BEbCt#25gHCXTO3Uqg2y6yqx2fE1C3mzr6nYT
zQtq-BVr!O|b1I{%*1hE}G@bDa_0-?3SPIoNV|EHS_KEiCza@f+cdVd7ja4&w44)S$
zc`B)@tQ}Iyv{NJ#;<WZhx2=wpd3a=Yr%HqnjJFdtA0<oZN@t$7YBDm*pY-*z?sc#H
zYBFOZ0+GRQ&1L=V%SxU`Fo8`j{zWpm%%41~Z3L>zv{_v(S&w%l-5srzU-F2I?6_zB
zL^q#KL&MEsK@Y<zT@Qr<HR{%`)QwoUNMdICII61qb_0j=-ck?hCE6tzZ*dms9=GfI
zuUS{eK^C5v&xrSfufI34^^R=)_z64={&*BumU5uKXcA?Wy9I%fG8U^?>=%vY@p~+H
z(fmjdwq<#cA>h=v6<?~NF-)^OqWKoAz-`GcD#f71aqTc~K)gShySkE#KNhya#$0jD
z#PL*6lDj66z<tcRyXd3tXsT^hCBNEM*&d&()pxSzI%V&NRMaMZh-xpxU#}+oW`SUJ
zOoT?SmPNzCz(8DSC!6>%9#x|uWeB4{d9U?j+1QD!f>FwdRIl>UQj?RhluA*Yxi{l-
z81YUf&`HKa&gw1gZ=CIds$cu^+Zw$+*&G9M?US<VKRb?zdh!J5grg3WoPYMM!EGF*
z7=IvvDG;RLkXTcainI`qy?@I~Np>U0Dy>Yx`<}d-?~O1_kxE7WUFQfrzapOT`&R^;
z4B&Idad@2F4d%UbmYZ`{lnXY(3wGKI4&Dn+6ajlunW#Kv6SLzslZ8kdH!huv4Tp&L
z@0@SC-8ie=;ubEV9KQ;&UI?#?XiyI-Fa$eGHaT#ePHipgX2PR&L6I6e9S>-xqk1jB
zbtWph3y8Rhi>SVvjljtk@|~iUMG)5nb491PGfD3n-wy;81O@ANSlp{QQe0`vxP2O$
z)SD?*WbE>c(^yPoW<yZzB&g+8yyh_M*z~J3`EX_A)%P>IPum>?S12qKSVXDFy!@?t
z_N}ta!}X3t4;2Y?C;7U3NR8S`SEt3ocT2>~+WiW)ROjTy<+9W1GENmXO8bRm0$;%k
zUUI^LMEql~Cm*Jc^VYS7na2XblnlykF7wSCzn2)T+j7=-irEH>IM&y<*ZC>EyPC=t
z<AnwIoU0lL*5gz*H}0I)t8wF{s_SZcgw&o@mzrN_e=&OSGpRSn-pVz2`1E*Ktlb5H
zIZEbwFYWs758bO6R&lnW_EVRk5!86`mo_>^wi2JVE>EHze7-&FZ>1&TqWG3$KirZ%
z)cs1Y5C77j^8gNifTTS%7eBOsA6f?<+U6fZH-Mz4@b4DjSr#79mqLjr;8_=d%(p<&
zl3*j~3ya})OSi4=@K@jGfx`oSq+JvVHoY(%ky@O>$J<ljTiM4cR{wXWfCRcOeUTfA
z^v4M>`nwW%*1V^s;wR$M;IH15PMyN=mRA<_HB*+i6NEt48vo_r0P@pF>Eykr)k)+h
zX!*UG^Z&)(TYyFVZ~Oj34=G&&k`huDARrD%mxy!@9U_8AN(?=8Nr!YdO2^P0f^<l?
zh$txx_w(Doy-)n_bI$(X^PGF{`Tx(JM|sF$_|Efwt@T;6-fMN}%m|>@Dz4T?LuTh&
zHb-9+$x2nKznZxPo$W=>k9vJre)0X*j;kWyT^Cp7+t+@mtDmQsv)A~QvF0#2p;v~r
zc9>A=7hHW~7Kh9o0R%Mn?6wbCx{&0Y>ZR5{SbM_hh2JR47X;rBV3oVrmXupV(O?nM
zE03=zcd|ot_LEUkCIgY8u1EVjKRL%TrEVEv=&lVW(sNX3l)6tW52Of?Q2)s6G0}WT
zQA+<Fz5AAHrqZ-GmQTrLnkr8!;H=QmB2gw$(Agp{6&}ui8zZ0fviQyxszAnQSMg0E
zze!Cf&3*fQH?H(My441cLZ077B;&oboGOiW+AQ$lHdj>^{<+djb0}f|?c(A7OtsZS
z`K#YT2Mdj^KM%hB7Cv0=2&NFQzZ5xIA4t6a`rz`>ukG=I7Zvtbq9^-vbxz+8uEfp`
zS9{|GUZcf5stsJu4y*i?F3yfR4~nxo2NU>=UA`b*I>Idt=pIN~We>YDyPw!pG5d>t
zIW)#`o9vo|3+{B&_|bW9$=o=1-!_q_n#`M{Rex@g8N_WlJtfcQkwqzU`}W6i$v526
za7#4UJ&8aRV8ByCB{y$((eOw93M8d03t-b$F4Z!##e3x(Z-j#*#B36@@-Q#ja7i{d
zhLuGj#t2gRK0dCLiaL+qn?-{~gR*%!Khb%r$23V$_3et}ojm-!6kMtwYX-080-{wO
z%{FY?DF*Jy=$qrB#;pY|XUS9foGq!W(}$(ma<W=ap3Czmm?ukTY84kp5cNw>WZfU&
z<|!+qnxs}&JVt5ARBb*i3V(ZCucl={FIrIXiRUG?o^91ef{(dG5n-YXLywhl6{f5&
zT$c%Vt9m7fYSuj7;$x0=diD%eWJZLRUY0**^jzNR+&h8R^W7$awyTTZ0w@eZaY1xD
z&P`9j4*WaKf}O--mx5hnO5%6B$;zge-ch~e)$lsqs5ADVo0Kk!vSig;?jg9-x9mq^
zDb1WG<VV0+%S|)15_~I2=W`@)gS&O5OzF$}C^!0|Eom%wHIAli#sQw_AQxGi<bw;^
zho9;F=r)sR?k<v>JeVr6sC^bQycM7w^U7|D+y0gLG_}_&wd7x_O_rIVtUU1ex3!G9
zpZQr0KQ9=hh`8iqpA^<<cw95)=9tLt9_PN*COM%);_+||h<Ox~OGddW6vq^p{`$13
zMpHbNnQ1n&RhmuczV}>#FP?1Ib&%>;rEmw2o<{#bxk-&g>Ex7ty|L=I7x(nS(AvX}
zN8Jx<4PuE84xzD1bj1Y%#`l7D`PUx>X`XUbET&quN&NoSbS-iDWAMq7tK)f}C+PFN
zwkOwDzptM_u((ix(U}Nbab`@4LKM!uN?#IBW^6XDc6{|pKk8;?-1~*?#BWG_C3M1X
zlrwjb#a0H~7H1)NQP@FMT^Y#l$wFkt)k!yA86?!qLgJ*;fpJtBEOE&~>d)21LSBWG
z6=x-nE9~O9R~4e_$x4~S)y=J56?&NCPZD02z}HytPK$Dq#6>XqZsgr?5|jA~&^(sJ
zl53l;F!Vu`Dzn5PSJQYMNve}C$H!j8Vx5*Mn*_nE#dw1m5MowM)X*p<ftH0n8q~c-
zchvj6WeCf>hM~XfgkAJJA|`^YBS)INKTtWA<J&lyjhnPwTA#ve#1KB~^S25!=lg2>
z?cx0dakLCo%y-)FQAgf;D5Dni=DjdI^+bKw$2-pnU%I{AG=M0ys1V$U&MDeZG4G&~
z*(JZdppi!J-7w6%Q61Xl`Tj12`hcq6pyU2(sItzzx)g@k6fSkmw950L2QEKf+E5hG
z6HGU8W!zWZS(xWJf5bI0rr>t@;LD2z5xK_M7h1O1liGUS4;p416(QXjjKOq@0t_08
zeQDJEk0$xwb4VLyG*WZiARi3Sp~$HXFxy!7du*%<dHUkb&P^JHv6uu6v|49MUcUD!
zsimGh&(wPx88Y(mmqKN!N&A*^n!7Jb;88K(+%?`YkdKqK^z-x(Q0HUD*A}R2NcHdL
zW|!xFPHXM@z!af5XQ?p7Z7Uh3zn)Fa5G$lY)g>^$JH`50hxUF|yfmo{<rJ<`rrqjC
zW+A_c%pUx>A)~<52rpCflln|vx0v_oA+cwx*a9g%4+JA*atk#2qZwP4^FQbA8LV$$
zbpCiF{Y^cG^I`7HGSAEUuDp21sFH<^dvy)j`ZiXA0ZOhauG#p>yE37f5?h<M8%Ez1
z%&C>=>}z2cElfr@er|j&G)d@m^X_+dM>7Lg%;Jdm%^P3L=^=YA#ms1auk^~Xf_xW8
z3+DUsc`$W_Pgi<;tu6H12=jM_Ldn{x=^R@cXu3Pq?XGIVF?PNU4^v(b6AFBl(SO6}
z*)x-%qnHt@`~H2xnAgd$wr2M0V2T_LO_h-38O7UQO^a89b9Fui=-Jr?3u)5{9;hw9
zFBX)0FvzIOQJ$q_7Kb5j&id4i<z6y@Csnn%=6QFXWmq+0N~o8qmqbHYbz`emJcc##
z)d$luy99j#h+s}~q#k)8eJSs#!e{Lf^1J-%DwLahT2m^|K3RO2nB$=%q>r=jD9E~k
zns`tT$c81@TF|7L2t5-hi0RQkhHBb)YgG&;OVEYkU~7E#Y?RGHqcyGJG=?q@bq0dl
zEd;(-+kUw_Gg%=aR2^5gZ*jkAcEnrgV-DXpn-@)UQ>`bm+iLy{4o&k*XrcN}z5~a&
zriD!j;l_!w1LvBi#RFAWV#OwbI@n!4j6q+@AH;%QPh-BKkLoBeMg)BC$1Gpmt0yOm
z6bNLCSvh%APsYN;A3_ncI#69tdRO&M1Xj#i)=~Wp$yTnIpV8~i_ZlG2mpJ0FqBkVp
zG+e_oSd)K7ZPHaYpdGxK)7PT5j(#*;Au^b<CZe{t?lxXV8!_c|M(wOQHvZ0JVk)YM
z+WlJPaZ<U&ST-2BH~-^e4VA%IRTr^8eOK)Bm=WWrg79w>j_9VIWhTak7vTq^RZU%o
zOAIYf!@mz^ol<-w7JSv#bQttRe3hc&toy#i(u}wGI-9_G|BKe6gf{Wb`xWQIPOU#P
zuEn>X3S4}SYyFk~#H*$*8UwGg^|;*U@xGbB@7amgliIe&2f818`5dH=8?GN8`bYg<
z6tFw)cp`BWS8+LIg<$J3miU!(eX)5*`C_WA_17c6t8aIFOct&s&R$hq9mW}7P6|A^
z=zN0yRnvC7^!mwVO<T-a-SyS4w(B3$Q9j2Xe6G>GE$FMSC$k?Q)bM?rOpF2J4t8d&
zMkY)l`04R2Z2Dy^RXAE969;XKW669-w*0L~0c^rMsX}R@HQKS8nef$R_S_-#l<nWW
z5Onp+-(NBBS20T+`Vxsk2sf8czbzA)!oNjeP<&jXP0Bnz&m?VRB3x$Pi-D6@X583h
zB05_B_IY_vCJU<>LQ#E-T8o8rgo)ZTD}~5}nm!Aw5<yqpMV-MyF#w^f&L9ea?{%Bt
z%rF~PG6m(XP-Ob@GyBqg?7Cqqec;T(xC<xj$dW8IAs8^B82?ON4Wqndp{vHGWH3E&
zXa3gC%+|U@+qa@o52tKoVerVN6NQmwx6@m$FivH1*s^eCx3k-?P`WH%t{Bl|ui#%S
z6Vk5mZ<-QzEK_7;(bs3*4$Y(($s$Y9VP+lrKD&bEsm><4y}}!6A}9)zv|D9h>bmX1
zLZ-^fHnMupw2N7fm69o&KY^7gn{A(Jm3)9%FoBI~is|-}5kWRvULRawHCxaq5z9Io
zAH^!t$n+9>jc+_gI28V*hnbHcn=dwprIqzAdgVSf>mB+4hFUi9Y9pA(3MSK6F})oA
zBsk?kCReqI_(`^4NBjL&CPi5jf<`#G-kLCvxrkAh$Wf+*3yaZ579o05lfK-$_9m3}
zx#!O7-?GewZ|4$)vQUn(3n#4L7qilNn^W8~;c7KeR%d@sZ6UjmyGO+;+{&h2yF@6+
zDmIW!N1FTe%|^R?7M&ogY%3d)#F|EF77;Bv>qhl5#mEMax2d|sI#(!Mk|9@ie4S%z
z^_xl79ZPma)7%>g?24-0GUY6aJZmQO90x@T-1+cZDeX6_nT3iKNaj{Z)!D7k>||(m
z<9qFf8O$<%>o?z+YYVYUy*H%{wcMLD(@4pd8GuljnhWiAF!iu~8)m~B|3JmWsZSsN
z#+KPs$m)=e^KHKI8`Uig?=0tRV`s|(EK^R`qgzkC3+!t1+^WC2gciI_*n&tDcnlbM
z)D|44Z@IQ|ddhzAe8cHAwRN;;<wE_z+uImh<f~7s5rSukMjC}MGRF4AkYlj+6Gi!D
zX9TEn1!@%r8gT_#76#dKfu$P3-dsq+ph9FMS4e{OGweS{us8slH7^H79|UY_f&}N~
z<pJN@=g*&ui;K6nw}CfteSQ7-__(#T6&M!J&(E8in+ppI`}+DWE-q$gXA24n8X6kv
z>+6@7m#3$vfBg8-+1dI3Bjffz{*?b-R{-h;p<<?m{bBTkVq@y`Rhm4-CW64M#~>Y2
z7_|2>k<evH1mp%aHLXH*mVXopLov46idkSh2@Sh^B|OVFRph2n(kz_C_XCVh@$Bq5
z=1?Fd5;xO<5`~>d0bxi|bY{UKq{GpHL{qKxq^QvGtC6zsBA^7An17jvMEr*ssUd9`
zL=a*~Fi;}c#%W<;QBqO@ga(udgjQ2i1I*21V`Gbpiya*uzP`Tg?d`$A!C;^2<>e(%
z?#jx_{QUgf+}y&#!lzH4fK>hc{kyulDl03Snwn53RAXZ!FfIeLbZ>8OXlQ6{Z7mS*
zz`#I7MFo&B&@b>$|Mz;<|MA!Um%IW{1Ox;6t8y9Ti^GOZ5CCKK$Hynf<UNB(E(cQJ
z+_N=6V8Q~42`H_hzFE?JBveEOP(c_%2?Gn0SrEo71;G`-5rIY{V8f}8Tu&ZA{47S2
z?sMxvQR5i?Nf;!`kTDqcL<t7(1JW}@Ck8e?IkU*vvab|`(wbaQ@VHdJ?yo~E|1t{U
zUy2f_2Z-|9w{M%9n^jd++1c4MGc#LTTR>7ENCJTZVF57#*#W5mg$)l610jNF+1Azu
zGz#J>u$=>q0;K|(0!@P<0zh`<<>lSo-9V{<fq`{(bwI2j*aCF|X$}nyMMOjZDgT#z
zp8oNm{u^BZXebcnI;`CvkAMN2pg9^78<&t;@U5VuB(whwtb4ZmC<p?V92+VRBa@Qq
zBcrF5hN}G`N*qjf9XMPHf+v6jgF2x86s28d^~PWlJ~9D{BKHHLq)t;igku3wN{g#O
z5GY)Hd=iGFa|8lK0Hu9!IE%pWBOt)wf<?1nVU}ZJ{TVaGz{USpF%twvAWsnPfbMp8
zcR}z3asxqfZEX$Yvp{a&zkdgT4#*Qo3}mlBp+LVt%U`~H0lFI*87VC-1u6!rJUBQ2
zkru?;y}dmU6+spp5D@TZ2pt_AU0q!T5(Xj#S_TRQst*qj2T}JQI{j~?hyP-KDl`np
zleaxf3WtOpn?M}i-WiHdp_)tU2xBI=0b-`PBm{;FVjWx!1M_L$4LWI^zr{>aHwVeT
z$Wt0R_E&itzz`s2VpFTRks>Ux@$O>5GBY8*A^AF3;;>8zB8Zd}`oJ0n!Nepcq_fk3
zqfmatL_9nisLZE$xP~~me;zO!{?I2CSShBA;ffjD=t5Ruil6ranj}jWA$&W4hs%wD
z$qXN=go!DHfk6m?VEl1G!5bV1gbf1Gfj}%E5N!xV6+B$*8~j89G}Ky5v<A$ye;qaS
z=fI)Az13%7RN`j8EA+R2e~c;OxGT&7-U<reekjKMSn@7R;jXL-zmgWank|h=2)=q6
z){A_6!*X)RMiQ@f!r)%sgfA*N3x@fV9tDl1Md8Dx4x3fxN3D*h-JZYu0<Zdzm%|ZP
z(}`Cr*;g9{S6hWwdzDuwEmyz0t}c47E=I2|=dZ3-e_w6<y4v5qI$62=J$`=KetcQ8
zf0e&>l{$U-{`2p|(VxYG%e8%9+WJNYMnBKa%q%Z0tS*1u+1>&tXplo3AOAWzIXOE!
z1E*||*#CJ0sROtHmi_A+_{{(O$$$MV|L;EfmjiG9<@^7SpZ-t(61e|==RW`aum11&
z!T<1m{?mo}pYP$HJ_9BRsX!mFU@21Yi{kQ7%Cim9+>@jx82TJI)EK7XLaL*4nB5z7
z%ijP);fOUZf*h~053`#sSwKvEKv{t;t0M)=SYDULF@N*}%%6Z!@nhj<Fi9wXzrGwF
zlB_9y!XUz?*dKNm?_LX!GrM*ar`4Rb?i&S24!^9b%HaL2ks`&v%z(BZuW*x8+_#RA
z8=%!{|Hx>))-Mx)X}HcTmWvpQ^!AC=SQXh0PoUF<diri;lfQrJOd`ZWU%og|_@X2s
zweGmFg|DGhEOxv{l;brXrcvE`k#xmlrn>Nbr#BXvT5g2V*6-4zvhx-rjZ|71kN1kj
z4v?!FreByFfU8(o%!xg&rgEB0z~^`UGn$o_I!<~oC(r$}pL<{1-nxA`z73fQAX({$
zYdYLF+%)jn#jr3?%O+!qdu37-5Gb=3-Hu~z<en>Sb?dp-hga`SSY|}w=6R%6OwJf6
z|I2Q!9Pj8^%Py%}#=E93T8Ak$$q(?cll_0<#4m{Qprx^NZ&|Rb1!wqfn_!3unNZ0)
zaL<_2$c$`nBo;|p!YQ`#DdTS(w~I^=?`af{MaMdy$0h8&&GNUr_bnkAKkP@4kymba
z-I|Q7U4XylBF>zKGQYe6T~f3x&vf+lP7fpG_<7Yx#FK~9Ia-}$=Y?u!zS2SIZX^%X
zvro#{q)X5*FhsXYus*|e%<Wi<NJ%nqxOXa07Z2D|(^B9!qm%6k-WTj(B*mska-Ya3
z@Px{iNZEPkTbKF;_1dXw9p~CqrRqMkt=!Jo)H50;$Ht++5^sQ4udBL!E|3bM-)fNA
zSXPri-))R8+Y{$_S?B*8I#(MiTEgA7Bg-(|==N!^gOa!v9^bwqsjr_(h_}E0`VCVa
zt>v?ar<%%mQMEa#M4d&^z2wtG+-c2A^4VsZt4jB}4ut9}Dn=8OH4Ay1Hnay9ZWA4a
zHuRSke-_f_V@peH7b7n_rmN4C3bnDA{PcQPpJ8(72iJ?Y1Q*Su6XVCZf?r<QTz-;z
zj`8Xkz4Tz0@K&sr1<rQyhoh9w1OfL&j-(zG<YwB)S=miGNwgD}z?^#d#_C^x&lUcf
zsn7XS-p^*xp`?ZQy}!v`xFgxD1)<l;))78YZN7Qv)|OPz2aEHaWMg~GirO1rUvBrU
zao%s=Bg%4L-($AK)XxYcD&F7!+&X6Oy!6P6L|Zj)IfIwvwq6!LSE$6{vnK*6aS<Na
z=10G@IcuzIv3SOa#Jn^MSF>4Dl#4s4CMfgSWkpmqBI{5m&2}b;><O8KN*s&H3UA8a
zicR^o*kjwTnMDebO3j%#;fC0fRr(7<V?q>%CWX!h4mYg~T*;E&+WXyXH^#dqFI?|{
z`xI>mMal0vOO9DY-}&7Dw&G|?@56~)RKl~n^q6J7Snom)o<|du^mX%VeZF%oM)!Jk
zqx)XU^UyP_khqb)9--UM!fEI_sY|zdMCX1)x(($po%Z!gT>OYa5alxCDfCIvA4MaT
zb6IKn`(#CrVxq%y**O*Z74?o{lZJ9{3-|Y{dK|@N66JAiWCyCJ9KA18&g0SUAJA$%
zimwEdgsc<>_2!Ne>WA|9UHg?ZT~-oNMEQcj3PYy!Ka={vB%#FqAxqJpV3JV&gMvR+
zip3?F^!>d_LcccYHvjHQu^)6{e{ZFjdI-~x|Am!e$Ay1?k`Qr;POswB-=8FOaa{3t
zCkZ7Dm;Q$)31u!y5(X(P&{akjK4v!3dNSe1hM}F;!C~(hbyH)7ho)r6`M~Kpk3l?s
z77h(tv2$I@;y0-}9G*J@vH4Bh)b%jD<!+s~`tXH$QaA@TQoyNGiHn+OT1b_}-YsI;
z_?Jg+)A=Wr8#7Aem^TvJ#98?f7-I|Qpu~n>kIVh_9Re?HY1k;y6>`+#3m0>B9nIg$
z<yvnpork)0@{J{h5r>;#(1`Sy#evt0NmtLjwHuF}?~=$5!J|+jtz-%O71Rr9I5$uG
zT*QtXo-n{UD*XF6gu*>s#mvZjdhAub{rppZZeUp?HPoIvqEpsxF0X%dZwbn&Ox<WU
zLPsW|NWBe%u+r{RW6z?nr)E-n3AgU7&5UsgRevDPSru!V4nTc7a-L7M5P#a(rpsTE
z|6L4+yAA<Ndp`=MOYX5g)BCJ@yFZF}VG|~o)kD7NbWBbht9d7>z5rbos-V8HqetH*
zDs*7QKV<XUXlSAq|5Ie#D>$5D+Mc=nO`yr5-R=A5UG1Ac3fV4AY@g{gjzzw$dHLAl
z>67!%9_0>6!4Y>|ZZ=J9<A&t?43Bs8VQ*|ut#hPVShd8XZ|$Ew@~z`@czP;kv$t4V
zPv+h6_{G`6C9xAC(9q7cMhwM%Bv{0j_JiQN-qg)&`6RSqpcz$;`*N^Rg`-6aTrlzX
z(gRh&KG&AR*wVS_AFb~BcSe35?p}_*KtIaqEpyT{)9*kgl)K7=?^vbYX%j_Pek3;d
zg?K66eM0RXGJCZbG?BPS{k;KS`;{pXXYhV$&ZGWYo;Eim4Oc#Y@-49{TO<y?*~uv6
z(Xlat*;JO&h9g|DjQ8xU<0kqL`K)=BX7sE_4E-ZIs(GFB85rM&K1v#G-V`1^A9;uV
znR%mSTkhG#cq;l=;j@-q?a_;=CiHP-RLj2Av)^;`=#%=<mIK$(-%HOjpinsC&<w?1
zdH{Q|$1GJ2>%bBwgr76nbo`794Zwmuse{20P8ev2FWQg_N{&j0*uuz{#jY<@$|Npc
z6GD#ONnh#Ww4E(pll>I7xOg6TZJ+n-Iu-&uTX7|Wkz!rTA-cB6zPXZ#GkeatlF6$<
zL{X3xIc$tGvdKg&JZ8^_YF-^%2D7~oQkbtsC8EO>iw^3ybm~i_hBfYrg(>Knbk_?8
z!4N|sMsPek60xAmo<eQ{4-b8a91t|V{&&vEV6*{zSw4hF?^`;)dnjM7ZGYH|7i`8S
z?h|5h%SSiKt3Sr;fYXP>4btC^g#q=nQ}@#Cqne~a5cUOO^abukd%dPbTxxrZx%m)V
z2c7obo^?em)KQ!S`)jEMJJKSq<-F13t_Y7LBp(I@PseK=&xi2Lq~A4IJUS4y<?W**
zNQAmAvK<1g^p2MC<JcxUaTVyo3wmblg*oGOQNUE*7ix?V@{~68lL&Hci_E-`8!nGL
zb`5UbM&h#gQ(61q7b50PL!n7QJzN2s+FtW=p1XL#>@4BTCSaf5?bJTxsa4>64lhU{
zcVd#?qOkuGXSj1=Xg`hj7?S2<Ix^lG=THaPEFateB|n+=gUWkeSVz{Kh4vr=WaWMM
z&O$F}g9LTFc*jCGR>Ei<qY9xoGj8D|A-c(hOhkQ%jijJo);>Iah<&c01Fo<`Ywv>k
z$YT*77dP+UBH^BW;bKs9v@0@(ej6-x^HfWUnS=Uw^!f5G2MD`+;nBrV?08d!=yr%i
zvadv$xM3+4MSkaut&xvaKMz+|h|+O?e~$FQ>5RGujXUBB`_bn~<Q_g-7+yCMyW1O~
zf*EsT)(2nb{cBxaPMf&hKCGg?7@VJ&r*5&EB2n5uA~hTQTkFGgcM@zKz282IzcLH|
zB^)v-@12T_ZG}cC>w1m%g?_OPkeZ2AnT<D>j6u@rLY4zq-2{@{f|a=ujD=wsP#=UY
zxt}|`uUjxmIG86S3e^`Mb{-pHlZv8?Z6J?E&Lq}CQ#|@Ys*>)+*@PDB20=4Jbh#22
z-E?owCa2A$IHC&^t+%}%^hcMt`NNVUOypDVhxn6cVx8y&yphK#=nuJjh~2ys-<q5d
z&*i&Y#Qms04O=H}1mC~3$hWD`hbAP^Jj-tcCs0a0T`t63ZT3ZpZp6&aySvAkLfsL>
zyUCQIFQ{!_Jlctv7RkCPn$514U0?Tsi7e~U!}pDa$o7Ibx_}7j!gOK$#E#yWT-rcc
zuF!D2<PtXoPv{HYVg!FmCLSbP`*Sc}aiY0`&(s;>$}EAsDxgg`?vu_3@rSv)&vV=4
zL#mT~rK~fxef<wkGj^Y+?cqf()49(e$@IoTAIj(4_h5IUE1=RTSULM3Qy=_dATR9^
z11nD;Ax|ip&n>FNCi4c;^A$dZ^{ks-N;YOgNP%?{p-vi}PSNRBwp|BOk0;+5KWs^t
z{OB~7Q$8otwopVblCD2DV!*A82hnXEGGZNK0}WCPiNB|qWH6h}2L{B=CCqJS%W^~H
zFe3u2^L@5+q*3Xn=WZ2^>1{=ZxgtSQ)+LiXX_B)=-YMD21D@Wrg{CQp0D0tWZ!Yge
zX~=0|8Ex5Vk=F@lz7BrHQDPjC8`j)hiB>UU(KeK7CjZvmNc47?tsYjLUJmt4Y1CFl
zX8-$PdFt;TWvkGt2#*T0N72SHIqn0V8c8w2^u?J)vi2e6A=-%^eU*)kp3&SDcF?ML
zZgdc(QuTQ#&6HcBmRsrlqNo`zuQ`tDkgc4gS@PSd46*c{cG=Zr?=r{wKk&~MoZ05e
zdr(ceMTZbncM{|#>G)#lc#4Zv3pD0Sh6R%&apW5F<llX)4E2<DLkP@&%IhmJj;Rsg
z@(s1Eyn&zj$-3@&f6nd3e_kn;zg6*}QC-a)$<N{Cfgf}$x!`_dvHDnjhbs=IU`Ae1
z;iHC%y5h`;zN%x7%2fI~y4mDg3O+{lg-eghvj-7NZUMdnS^+m}g7yM5QtAa}e8LIe
z4~N8ai)K6-U{Br2Ns|vzeDujqH{F=NQNFnTY9hUF+aTz?;@xg^zix;sdbg=EEIqJ9
zy;!HIRw<`JtZo1r&zR!X(2;PXxKa_n!ZIc6Ffj{V>@%bvGA)<ybY7vm9o@U9RrQWt
zuHG~44&o{#y|yvGZziPz>Z5*<fC;H;e%EI8n~YIUP?xp^XDtHefYpsxyc^og{-ZUA
zE`z-ai!nCjBee8XCuW6^T)(pY)nwbPmp+`$Aq7qESFBox5<lMhjcOM1?r-RDztawT
z)E=$VQdRVz${GiTOg|V5CB7&zFUo10@!}3o+WXz;IN2uG(2x?+vP|O(I}crR3niFO
zhz&^<Z*E!-Yr&XHp4TTgWAJ=Cm#k9S?9g1nJdeN&3+tTo>DTQ+JK=QdY<rO;Bib%}
z`TJsax%`}w<q@8cqO+ik!QAz|hA~brn0xG_3lm2ol(ud!yd*}<vBZ|A`{ZR+@ymXC
z5AA@kPej}C8A{&4L(w#JnRNX@8+|>eFI!=}%`IYe6r~kQ?p+_~du1CvGcUUq6$daO
z7-ZYN=lb0Tr#1Fr+K2S*<jsBq`&G^QO^n6f2<1A;W-Mz@fwhJnC$T(_qIfZpA_ayn
z(#tAlqU^wTCDD(P<+uh~bq2*3M(wDwriV%#!t$82A`|ti#ykW(i|Uw$d^aweq=<$Z
ziHdO^XJ{qgSyA-i+==eK6MHC@rI?(?Y1i{(Kj&f|#ovt9+MY)QKvT_>J_qjyjJ!;$
zn8|Qki54>K9}6C#X&QRjh%nlTx0tJVyPx1N6UO4{Lj{erg7%|cqWa#A3%a-LTx!W}
z2jnUHsOgmaCWuFAw|{sSm)?M4D*eLk9^o<6*{=NgmO=47FTX3iz=top=~A<5d83ok
zMy?ACi(dw!I0N#+yYoJM@_VVNW-z1UoT?cy6TUbT$ymSKH(gSaZh0{%TVKGN*AY8Z
zWeA--O$?H&AIW~l{_rxIbZm$ztTRn%*gOQ1z33Iylpp`C{ZUE~h9@fNvCiOJzDRm-
z>$}8^boCUksnU=zisIl)yKyeYU=QBrruyVTE}R~8*f{lN^j*~GE=IbrTUt#-kq~}0
ztyfXS`MCcE@(E%RnT)7e9B$`ZK;n0K5-ethCcu%UwqbL>Qj7EkL-%jSdcO+s@a%AQ
z50Cd6&?^oNABumOuDxp&y`$o}XNZ~>E?YlOHh;Wuqcn=GCA8YEoMou>^P};}mawSC
zruq7XxJS!R%L)TUhjG*<p$AQSi`sCJWKI=tGVe~cS4keoi1zT6-K0+)cC+RxwK3c+
z>if$vTtQ0vm0CP;!j;LK4W$tZO&XVh(Z8ctzI6nrYcI%0FnpUA%*c2{*!Y4M#~fT-
z&%tJq{^2`e&h^8M+_N^1*LAp&()1}N#ffP4?Or?mO)lMxfWlG+-9X~xFYlZ~i-tCz
zp3QS0zs@KpH*EKPzZ$!=i_pi<Cew>4*iS>36g^j%JFyNN+1q(uguK#AV=j&=D9pwo
z)S=biq@!Q?$dDdAP*u;+Kta3?b1x~tuduk>MHknPdPXSOXY`hC_%da8YbPFG1$}Pb
zZ4enFd#rP_6{(QE*0(i0Lpb6$yyv7}`As;A$D_F^EJms%kri6;Q)fa0nk{HITaY};
zsPu`3cjV|wTdlun7Co=(Hs*~#N9Z*Xue#uFANrs#Mo1s)OW)i`@|~MTg8Wb~%ZAUG
z2wx-m?|Y5=Zwc$9l%mgE#{%*y4Mfm;=*R{<wf40ZPoXQSW&2%W{K-#4zEMd>S-XcK
zL`A!*U%K(WaF_kS7R~4l{Zts~iLRdx)U1!TJ~ET2Gk!c^@@i4}%?i%wLR!oF--_Sm
zY4<ej8f?n)-YiZTHFmlZ=0s$S{JzXiZ<s`!Z8<aP2c+j=R?b8XQyChas^!hNwVir?
zJ*6!E;r^osPxka4)tE8Mne&})9%OGa-kF>486k-VvZAJN_GE-}CSmI=SfFXLTqFAR
zJZpbzxR1LZ1D4}JjC7%YE^+KC?G$XgiN?)uOm5{F)b|bH{$rh!Vu6mH10OxF_&WaR
z)7UDlC!d=+`eIU2R2C7%@|{=c#=zI3zWp(2;`U*A_L)BkgFU#e3_km@(++2Nddc&p
zi)CGX92jop=%Xq`P0k@K8#*}Y+SVUOnl`63+m3Z@t-bcCT(*gP8j=8M$MSpcj6+B+
z3GZe`(5lf&-KBjFCJ9mT8FeK+Ujvhb9(#W|6J(VN6sPAe{Va_l_Gf3qgri`X@y;;I
zatirM=4fBC7zQ;rhkTV3siI4w&>9m}e`)PnW$PbS#Qr?5bsnC@ZOCI2#jfr*IAubL
znTIoEQnkM6)$U2xHrtS!N<tofw8YW7zd4pF?bw4o#B3*->re#2Z$7nN@_Vx(6pz?I
zO*seNS>h|axACGQjuVa6xD@`OGw@2~gKWB<^IBZAjf7DF-Clb@is5v)SW>pdLhx(F
z^>1#1&$!d38%jmQgmmjH?%ZGUf-_GbYqgDgGYo%Auae#Rd1iRVXL_d@<Cl!F#?HdX
z$Odc0BSE*PZEtTzo_dg-7|uw0YyTP*K3?~DDTZ}J`j9tXkFDY^t|~b`O9HIMR1!%#
zSRn!N@T;h~jK+$}Z`$;i%FCdCf7o!DYZ_ie$@d;98Y9Hs$C0?JBq+z|Y5=Xg#vW(M
zpNiZI^<~J$RH>xFfoJk2nO+pv+$2Gai=k>+W6H;@!*=8Y-AW?+@n+XB1Q&^T?&r5>
z7(B1w`4AQ>_h@SY9Vv=+H|PGd$EWKP55(#^Yo1BsaeN%>85!bNdrD*R@wwcszz6CI
zoOvJBl?1vUyigIItbwtvVJqYbg)pcTKoXVg<Ucm9ebm(cX7+vJ6B3b$BC!!axV^V6
z^-I&(XQOX|WYly!_*#^A|BGRw6N!%1hfne|g$s@30xV|7HuuD1j+J#cSv#s~GVRuE
z@KAoH$Nlu{>IY?<*Cm8{?iF!bS<o19RKL+xho)8`<x#D!&ky><M_tU~Rh$N3rles2
zzO92%h<1tV>{Dm;w+(TuL8D#t&Q}TWWm>k=x|?`XBT~Uxh|!4<W22I#He7unqY!m8
zb(Y2!f!jJ4ADT_LG%gQ5Sr!!Wu5TpU#FC!R#HZ6i`8frJ&PS9z{gj~P>kO^+GF`?w
zRhJkep1bXDZAD*2!{>L}(o;U3)p$0Ta=*-}#XVKdB&HVSSq=5J-gq*3n;|!ER`zG>
z)ccqEk0W#sE-a%{BW~6dt=^w}{k}l+T%XWUy4m3~pWkzVz|xzJ_LXBnnyg3rBk}nu
zWPxP2i&0Z)%=rVJXBA5(w;rD*dTPAhy<PS=bx)+gZ*e|dASc%M=4!Vgi`GQAWNy*)
ztBB!TJ8Fr`Wkc#V&!0J($DYU2!u0wle@qfO-zsSH{{4OQ{V<9v?BcBMgR5bMcr{k<
z$|yor=~fEb8;gx0zMLC#UA~?~q&+J7^`pFon0eKB;VHV2SCrT*vb;%EJ&qiT8=^EC
z<?(cPH#k+s!=4ijaZnsr?yx`Um;AL)-jcgL<Woh+GQ=xih8?8jhvyG1C+&<KiSHI5
zza-SOb?t1pV&{L*g+E1#lEz>cM3PT@O(=}-Aa}X#b<EOVE+2cBOFfut)243&`H?EI
z8OP1obBZ*^m9<8b*y$s8l$DM=RZutZU0pnjUFDJ=EPWnL)5SLNYg?37Dn`tU&|JOr
zrxd5R!($H5*wsw<qaKlQyS$L~=G%1n^X^Bn$%O0{w5K!)3~%_QZDv`kGzJ2q1>-4d
z;PsVg(|$;YdPGc)(jCIH{-w%Y&PGZaW>=hiW2r$urgzL;2D-|y-N3N1_wjr;6IpHh
zgJYVpXQ=hHRWwsxDU)D^J0bhq?PGU?75rF=v2jy5d+tl;5)r)doJk?Bp2)<Lv6iB0
zR0|UNl651{TAD-jd8pQxY?^Ls*@unKBVE4a+`_Suml0KuP56?_DYH}4it;1*_$5yu
z&_>xp^hL_lmwe%F8&zk57u23Cc_p(pYJs8}+0+jUdC!V$!y7g7g(iz0sMy+Oh-wyV
zX%;+}iO~GiI9X<T{J;R`rB3p$<^*!G)T)I?ch*m<w)SDZtzn7&#(-9Rxkb6_!<UAW
zerWC1H<}eTJ1^lS7up}Ok8!Mjw<{IFuxt2h%OX|om`GN?C}yw4x(82IV!1grobjnf
zIKEW(t%uHF?MGZy2uw-%U0`7SN8O@tFydIXoFt|M{uILw1GnY5#3UDdeJ*)&=(7HD
z`O|v-PZ%i=250($YS}~|^VwMt%-&&`##MsC>>S5^JDKXL?>pN$2hU@q<em`BOdi-b
zi5V0NQr9HB`fia0pWU+*ZY;L2S55y-mOho3AK6{{wn$AcF;uv=FrM4emGDL15=}m?
zi-SLzvQZC{OFLsdrqh#`6IUL&ZQD2kW+hsBL%4}86hTG)RD%Xoi8J+_L1h7E`$lLx
z8<94VZ--7!#j8o83B7!Lj;1W(tBL5Oj(i!1=)3!i_=B`<M=gh;t|?}b;aUXPT8D8p
zL@#bKxb_RG3Q}fYu45I{4z4jCg~yayj;o&bWad@Nay5|*nobRVk$IhPm1=NXDY2au
zw<_-Ra`j%^qmCgJd)s->_067HR!Qf(>3OAk8|riQIu1%%7Pj->=o|anyWiU0XtBI!
zHp85^=%B)wPS##KS5(r2EU|c{p<`@5RYz@Gb}Qng(VEUQ<&JZu=G9&ZbbjVFN3C>Z
z%YMRb{n;Uj+8Q>@Z`Mjp%wL3RKUGA0gTH*oXt*p?(X{;PP2&8*maJ>zWQ)BEx^8~)
zdys4M#^cu>)ALKGJ+7_CEw8;#=f7U#x}k6+9Q<e&mht4=I;dJ5f`k`VZUnn^aY#6Z
zYA>wP^t$ytY;}xuU0Az?=iVnH@g_ELVVzUXeL%DIO+wwmhCs0UkcEU(%JjmfaIgD_
zbE{Lv>B80%Jdd$JiMQD_i`#N?9^>(?Z}Wv0cmBmBA?@D(^+`gfi{Jk?Nr-0YFj&rW
zm8#9HM|kN+RIukd#}oGf?WLo{UeC>kZSEtkOFuv0d2P!)@fc4`UHVlZ=e4WZ<}p>b
zbX*bawQup{-Q4ujNnNkkfpgotrPHO;Hazdcz$c!oG+)np<-CvL+dMagzn+f<d;iLN
z;<c;&^<ui$`{Yxb*MaNT-(T^3&bps?A0>Xh+>-OTm~8Vtsr!2MJ=o`R<B8A3^jGw0
zuMhgT%?Ew@_4*nQ1))S?u%j>^ps=J-*cvDta}@4d6kY%d%20%W{H4p-0CZUJg8vX#
zj8x1&x{R-{uO}xbRaBmVb_39n2-<-iot(E@La(nU#xtD9udmZ5uA6tR9Wy3^TXxc&
zGPl7GOk_GDTd%LdhoQ|#XGf>ZW@PB~PHVaoct3RedO}rItr?jajBEvsRc&pkU?*qL
z#V|fT-qF#SoSYJj3<a%I>Bv@HUA^X=iL9*bjg1W-A0N<CwX?Gm6omBf@B)2St*ve8
z6BEHsnHm~8Zf@_!uXjFt_~7N`)x5Klp8jF`dZ)Ly@7+7E!os5U^$iynS6y9wZEao9
znHijsIlj{x>=ZhFJ<;3}Ix#Wf=jUf{Z=ac&wYa#{-#?I=n&#%_J~cHB`Zl$-^)xiJ
zrl)7dGeSZ47kC-JtE>C%TW8SE33|qol9EbFN>ftO-n@AW+N;ykGhV-T0L!Ixb#=!l
zGMig69Wye6TUtj)$G(1Dc6D`~oSXuUXK&s(ySTXc`2~O$GSF`ZTFBblJIcz+K~ve#
z&~R=pFk0lNPwWI|OdK8_2DeNM505lAw}6Ij&_DLaQ}d78|EVhgIx;Z+vfJt3-pc(S
z+s$XwE`ph@n6CJ#c(O#N#&&VwQ^|A%yfc(hskU^s#(F|^Qi?enQUJDc^XX>tb=5ij
z++9?vD%WoXTe<nSPY;$mkz3T>Na3orUO5^uJEDf_jf~iv>a9Z!KZk~hgx@i#h;nQP
zW-FB#UH$mj@uk#kuzXvTWq-EbNuV_1u=e093gb{>Tddx3wv(9p$w>3tBfr5^rLD^}
z_^+LrTiUnW9ygt~&*Pw7u2sEXyFu0lOQPOMTwR<h&3Asdr6Y0m+x^?x*Y6rnuCEo&
z@s<(N`0~rXPw0@#exlrc%l;1^L019<735a}@8}{|f^OUNtpu~ULsyXuA@ZvsG|9--
zQ1YU_)iB})=vp|mUw$nDYZkc{A$lNU7A4UNHIKeSqOcw!%k;=JR?)l9Jnp6h{zjm>
z>LZhQEeWJW0-=5XhOd$LBY2W2TFx^0cY4UCmu>kY<5c@rJgc<bVFgZim!%!U3=h*@
zs}JK>_*_nYB(?@wL72hT*^PVyT=tO?p=pNU3cKuiak>L0xhcgxHU+s}1jSa_k&2A@
zDajrj#aTrJCPnCSDcqN(k;962Oly}2m`VzF2yRzYoGZf1JC0=RsyrCON=;F7wY)w9
z5`@|x$Ax5Gefsfm{$}kj!$CgvCGVFS^{do{e2yFCa`ugqWrOy9TRf-y89$_izq=kR
zHN9xP*z9`UCVWNc5OAy~?2w7$<m%vrDZucelcWvXv5QYd*)a$|%(W_;E~oCtYib`)
z^*+{#$*Ol8(;jaIYGQ`oAn&vdr3~JCC+#%M(G%`eDEeL5c2wfSh4$E!8!8{if*2#-
z<|!JxI89JICU%xqe|DudsnrX8JJm!#d~BlQldd*ndP~}6HsDo+OSNsqaOt#t4YBLO
zYfhEA1(&ae!srQ)@98#Qy$cBH4Xk<%>*s?j(naRN5*O=dqI?)1O~+XoHcTcyOMmnw
zRd}&s{KG9q(a$+}hK-{I-_t}#N~RYYhbr0_#0F~$4BqwEg{A%OZF;@%ySwcLgJ)N#
zn89U7@2#{;)F9S^XWQuB&8wD)QT?l?>6%op#`(ngmin(gHzn%U%=EoKZ7HRqYxV@@
zC91#E+-$4-`CG58{Pb(eld|8vb8RKxo`*s3<WZRPhX|;0CMJzYJQ>k}FKKutHm7_$
zf!?7X?NBDJa9=x#$DuznQ5IBAzJomFFn~)ri$J@tgSzoBP%u1;$V$GGe(o?xWGIWo
zwXc)u;t=e1BFZKWmhWPv|ACZO&L&Un>$)xaBSbAco3cQ@n@8_QsLoI}bsgx)@c0o1
zC(5DimG8Ni@*~_@Ifs6_uLsy6Ay`Psn-~a8kq$CkYxXW0TufXsl4X1>?k=J(T5OS3
zW^BKD-&>k6Kgm9fNE3(|^isZGaW00?IKYoX7{8YU0SR|n&gF0=m8I7p$KxH7q~X!^
z6Z9~NVP}@7q_mL}@gxI#Z~Pd=P}u&Ls3;l1cEb9Z0L9oNX3Ii$(pu|&3Fa>B1anJ{
z^TQ!)+s`<Rnd|p%tOh6!IEG0@`%zue4*I2;#PFhWXik^q9(?p=ep2sut4eJ^kwg;j
zF`D)%$5YZCZsd3d+_U`&-%gM~0z9)6+l&S8Fo-VN7wXN9Np;BVZ?`EK&N9{s^H}b^
zM<fk(g_%*g%=$eV$B5)l%2Cw*yStqfzhu+@f2AV>MO^L>thBI7e_G$CQvN1!aA8yQ
zv|%iw{B42K;;!Cl<IHfmOWok&fyZgnGI51luhP;{%4zeqN`=St;L=IsY0F_mh3A&i
z*NeH+*0bRX@6*Ar=!?@f2uURZPk9;h<{1jATIokKw2Uiu)=nB(8NjK$LZE-vK|4|z
zBs{c2^6spY**gS7R(X{?^{k6awJKD5XqCF@tXn`<l5n>&FcW9FM`WZb(sgK!>GxSL
zjHEg`Sb3d{b|p@NtvWVwX#KXBd%p`rI`)I|29N&vfEW`-tYgpy|GV=+DcSb-&S?-R
zFJuU&1wmttd79yf!+Y&p@8SrKL3nP$|H!Q~9Mcd4Uy_Gk8U0KIR%I;OxiLR21QsR&
z@$}{erj_MUx@(WseLVOmVzVk`me&_wnz<M1hRWEwwBmf0GWbg97p@k>mxBS0MZE2V
zMT!cN5)g$Dh@kMP`7ks`J%|In@8=L-Z5p*Tj-<*W3LMk+uwW@;BSxsS$z?lsBxK4#
zLa3aA5lSeMGNU5lJj_#OMchn>K@$BCGvnKqsvKnTT>=Dass%wb1IIW>co@l1Y5mY@
z8S6u9RrQky2yR!yghVB*?Qw)XqZKngaWo2_gxL-sCfb{n@F0Va@jJc)YBY-kf`jIT
zA3p4y9~H4b>r-N~Hn=%AK~U(Mx1nq$k<&c%sL;LdJbf)b%5xT@4*}&@wfFtnxDwua
z9NEoRlkIxBR^$D1AZ~asvF-Pit-Vkc9{M|UU2i8b!+qx10E20}c?Na^fxX1=lM-8;
zQ2Y=<PH^=~QXqLpz^O4$jQBYE+2T6fwPs+a*~YS>VUOSttKU)CHg%eA%S!v*-0Pw5
z*!Af@m~<fH_q|=kzj}UW!fW`Vu;d_PwS421H>~qp#P^TA?#s3b$8&To`+jZSm=eh5
zCeU^^h-a{#Y<xbW@_5svg8rA+t;blIEibKa!9Pb#om7(X{la3vSWc~VqYp3!lT>Nw
z$0NR;uha4EXIM#WL$;b@e~eV$VPpIPAAK7wcd-5N#qwnl)03Fl57l>Qn9xTwh;%ud
zXIfrAtlnZKA*6bIIC2mqX9$rV1S^&=WfFq?>@HQ3Z?cQ;O$yS#95wJj7RL*PKp_?w
zqkl0p0&@n)^nv{XI2->@WqAMiJ^#1@|0S*fIBMWy(}Fd!|JG4M#{mX`{CjJ_WeCoa
zY6||T`TKdaSk&Lv$iBQC@z<k9ep>OLM~#7Xp1&M5iegm;Ys=>A?oW55E7cw7H@JYK
zMi`aA*ER&!jpIA@l`EYB_-sZ)^;N4q(QMaVyx^$OBrfoBDLlDmYt)k4pGn1|XnVZy
z#kF`@<EOo<WaGgMmAHpsjV#8@$ngB}!4gX8nnZQs=izD}->qjO3y%AnW0C?<s*H!f
zc4vMXjgBxLoE$7qpuKNAGul5p+HT5tHoCNXadP;fHR_r1&gI1!-jmVMuX|T$$kH!k
z1a^nkvacpFIBMvB>s|K0kmNFXPN2$V5=bq9GzlWK?_2R@@|K4qSuy2JLoU;itlm83
z^2TBO9e8Hp`@`~V9zsj<Mv<a^y=GAhS5S5rDG~+47+I-c^VlK2e)c!25()<I)iLEP
z;+qXaIPCT874#F025>EtS|7=823lqmnWWgd^jW4dx8iRh-;CIprn}@LtulBI`nSTo
z(cEU4epB++St3lK+mWICyJk6&xcD}?(yEF(F$qS+=J_c?{Wb+^-UPevvm<RSit;T(
zY>N%b2X+(D<*huHrPT?#C0TX(!j|Qp-v&yITG6)Jl^x^YsIl}pbl<9%e_pF*B(%Wp
zV~V8GE9(g({p3$`LEW$FjJ*iUJ!T^Zlj=85H0>LMv%pbfuk}t+(~*?S>lW3;Fo72r
z2QQ7A(U^n|s7?~)$|~GjX{8-C$Ab=PBu|?4I>?pu9bb|ehrj5dpYL+){q&rux{fu9
z!M^`?Tx#`Ou8Pv~!Jbb<_nYs(K5-o8Sq#6gDEi$_eN-Y2`|X%$zw$>L*;`&;#uV>+
zeVmYf%J}h%#EX`iNf9%{nyLFv#5L3W{w>ur+;Oj}XW4RytLGSN%BtpRIt{B9$S1BU
z7m3!&Dvg)$eyUV{#lSkKSpH2OS+R1=%3rbi{oY9V+K!Zc`TCkVN%_X2X?fY^^c&T(
zt<Qc3rQ3tCk)=D`+5DxuZPg<sdkr1lCHtSo`Afc49CUp?Xg)po{T+oTaCz88L-}XG
z`HO=-AEFPTfl&V~;DCw}@b3Zd3@8kNA{4OI9335jx(~3}fEC=J4h5<_ASi+97NGJ4
zN?^d>3u-{1`~>PaVD<%wRG=sWibwJB@u27f?7P5}3u-!`vIE?Mpk4-QI>5UN{DHu{
z16;nqB?wHs4<9}Rl`k+x1Ju0A%F2NA5I6=w^$Pe2V`5@}mmgGsfTtH!e}EAY_<n%}
zQBP0r?c2AnU%yUBNRX401MWmCE34$>WKfd=*2I>UmYkd%P^SZBGGGw`Mnq67)6vnn
zd-txox;m&#f!Y(W3iI;v0*fQ?Gy+?)s;X*aWF!c-U_Jn_CW7ixN=iy*W~Q5)8!$!!
z%klH)&)>Xxqo$^onwt7wf{_1s5dW!H;4if;N^1l}l2}ZG$e=G8j>C;h_#nhjG869x
z9zBTxJTH_2f+Lh$4?!s*AkYT{;+3W$BzP=xnAQ&WIG$n=QbLx;aEPcdZYCMflES+1
zd<mGK?1!exgg5!QkQg0)!BH5}ED)GFGm0pWj4Pl&IzTFf_ZdSMEDP8IX{edg*5RZO
zKU%qa=GKxhmQFlQtOwRy5Nv8X+y}VuXy$e)OdUK=E@oIBF(H)IDt8PEmx$N^x9~xx
zv=khd!g`_bxmhR?UJe}+%4_0>n8zf?CIxG4{mAR@^P5AYlnjFyXrUq!4yX`5NpHbh
zw9L{_XeExSe5KS=GID6SD=jzaN;@XeZOR9NjPOSg%tx|sX)ED9P*!S84G|O!sfC^Y
zkl6s6gBOCrR2xI6<1l&(LI_#iAP5{nXm2!x(G!D$K!hFk1t-1;8`Raq)t+OpBbJjO
z+q1bb7%a_d5P7P!Wm<@z?pd}fL>h%66}~;G2K(pS_YV}2|1*jJhX8>9kN}DRfdGd9
zgn*|1<Pbmzzz<*#U=?5zU<qIqAOx5mu)n_#_youVfCP-jfHZ(fK+2%3t)ij=-~=!O
zAOSD~oX(Dpj(}$X4}e&JJz$=|vuDq8b8}5iO#$Hmw*Y<sv>rcx48ZUw3;-Jd=K!%l
zsT`mPFboVU03K>UGQcFjC%_~yg9OkBSfu|PbN~Pe5LHxE^z!9Pz&5}qFz&$C))oK>
zFcRPmpa{$g0;B}~Xn;vTQvg4J%#4f-Yinx+0udb@Eh#Apm;?|72m~Ms#wGwzIXO86
z1qA^c^`CtDPnE<!?(F~075EcHBFh-<R2D?gw_|W-Nz%te)Mv{pfhZ1fX%T4@3qCdk
z$FmR$LC6wOkufM{!u*s&Fz<`=7Q#CEiHIS%%rLcBB?<!Uv9wt*(u)Qc!ZZVuGVz1r
z>eWhbqgdO6xnQ7TcE~0ZN<sGkM)wmN+n+!K3vP`8mXJ~0GZ%Dp=rjo=q{fV<l!t}T
zkYF*85LKd3SQtn{Wm0ChWo#n*yi8b?Ux#lGwu(U^3p*h#i6pHVQzZn~cLJLTn{@FE
zf|-V8Y+k<#xo?7riL*>ge*5XS9uF)L(#)qs2@H6}(p+OGKg<>=vw<5a3W|k6K(t@!
z*WN{gPl_pD*|Grh#e@(DG3YK&g%e_6z?E&pO|at=rO9a#w;*)`*bnU>>QEvsX@pTC
zvGm*<ENU(_2&p`Ck}Bpyh%Ye#1_FTt`RmlKe<RHSNCAWaFag{Eg!z*s05||L03ATx
zK-z#XfGq$f00MwNK$w6q02e^cfC+#P04#tu06qX9K(GKxAXxyMQC3z?PfrI-kdTl7
zV~0S-5gQu|gb$JqkVAn)1Be~a32+8vA|MA56%_?j5ddv~`~h2loPo@Nx<SSP@C671
zr~;@32m^=1kw|1(T3TXaBH#~5ngDYETfiI!fEoZXfHm+k9DolX49I=7wY5P`^y0+}
zkp2L80{*;z|6W5w1LQjZbO1P(mX={*VPG-?7~^1OW>#HY{qf^Rz!oDTBLEfv96;26
zq&)w3K=8lexBkhNLS_s}Dsfz>^dUU6)0f}@2*b-LQVIf$w0ih*)>AA)S@}Y)fG{ai
zQ7P!5$QUe^OrDp)P0|t-#2}iqe^>}_$AnO!9#pYpDwE=qgrjs=Dq+~Z_@WD_=O*|#
z95R?6Vb9l;sRVE`y5KA8J6I%^9iGvZYy|kE49GFJ7_6tEq-N4O+{_M`{x|vL-C$#=
z6<pl=mFB*zmYq*ANck@Xx5;owsfnOO%CO8D2qBdYCi55@0x`lUrgnZP8R-9k*D$G`
z)gly1OU7j&LcZ2P)XK~08S^|lAe;{un~O$}8DW_~#gKcr+%Ah1iiPKp)OQaC!GF&f
zK;D<x9*nhrqXn-IZo-U7|4>x~E{O3z+ItVErn+_SHwnG>4jPJd6&q4SLq|kFr8fcT
zAiaYadhfl5-h1y6DWM3Vho*=@kR~F%#JhaoefHUBpMB2x?zrC>V~;!b8WTpc)?Aat
zWaS}wp85a%14Hnrxajw~K@hy}5auKpo|qL32LA92jU;7;uNV@7P8dM=9N;||*q0$r
z8pJ`ol8yht1VI40L9hN<mcf%R(F2bfgs_6JAdKXNAuA>zI%Fvf56ljG1!8&X$@N5v
z<N$;ZBW*;!pd$Da_V7o(4+MPpdIk=HgsMH)R(-DhOvhN;*w)O}1MU;z6O`y3lIj?o
zZ6AVgjV$tsFAGkph)JtT&ZtVxsmU&C%&%xKuI;XD?JI8|DeampMlO`R|5!e_+BA-B
zA76PlzSRF=Ze(;~atO89kNnct`E8(kr@wm#)w?r_+Cq=5&rYw+W3USgpO=<CEiZri
z_;GFJGZy>x%i6~3+UCmI)~B`Yk83+0*LFXC-Tk=!{nNJ}pSOOl?Hqjjez3K7u)BA#
zw|B7r<KX9?ZT}EpG5q{_^z-0o|KJ#CKMzk1k57(HPLEH|PEOBG&&~lr!`b--z+U@}
zU;E1jynp+n0dM4h5d43z{S^=JpZos*^$_rz{$Kyq{`)ci^HJae{?9hxQqOU?QylID
zhdaRG_W!LN;&5j;+yyWQ@C7^q4j=#V9q0<20K}yU5_W!dg1^c4krt^_iy*iHd4-5I
zRBG|E13(NUjp%7J85C0ndIu%~gW>T&3LMd5a4?OlnuT7Fcr8hA1RfVZNj@TgA&m6i
zEl=bNgjxnoiqd=@zQA)Hi5y~pxKcLrduhQnE63kU3ka0uKxW3Y_;eZ6257e-2)?An
z0*r~%pW2n(2=QJTCPVKk$k+%iwSEs_Ce?)UXSySv7n||XjY`91%>y10_-voGHGT_C
zQmYW{YOaDYXH!iE>w=|YC<!H;m8h}CfrO8fMAD$a&_qHfhUc(aj};mcw!4o%*TTS|
zB>Xk+jccJ265O<{IM&YX<N)x*hO00&92StgHGQAl!dR+^lvt9Bo&)7CL_{c}#0Y|L
z-2HsjFtV!H*t+cc212Kbq7NT}Unt5ZLCp^eqNNc=^n%z6?^4qe%c1)ygRO&7l^v}M
z;gm$?L9iDvD9oQ;kXao}Nv=^kgpdD#7wn*{js#Ou3sd8J;WxoxkO%kjAYl4!z(W-u
z27ga;ogDp6MF^w-cLQ=pEJQ}VwJ?w%)MS!S&MF^fa#I8er=j{PpcUwSG#@9&$yv)x
zNld&4rxdsz2PZZ6X2gGjZwI$jV@L~ErNo26@g!Vn^6<c(98R3lcL+qlIrlzd059*}
z+KpJ8g-tKmrSSG(p?Q%OoX;}Hux*u=8XAXBO9q2(f%e^o{7cC?Md8wUug%#c=%Ap2
zT#RU+W%E*bQ<g2B0GJ07@Zm9&S+4-BPlakJXpClLD3sDJ2OI(?3kv4n@*?H{gTYkn
z@#VB6u-d-P8dYR`Wh3h|e|)KSM<Hp+3o?J2&Q*FN2L*m~4nFay7+uuxCOW49O$lYy
z7SZ&1-6Fz7|8tavE9n_QMwA2wL`P3AAfYv_z(PYjEtF2GI2}4hh~F9)$1u_rw@FK?
zgh;LsylCC46g`QA5&Tl_Owz{JB$FM`7DPI^aWr<lbH$G%&mW>kM5#6wG}-OoMsGQc
zwB+2oDt8bqfhP^ahpZXHrA3&jxumI85Snkr?$Ssb)C-CT$TalEmD5u_P@kF5`;M%o
z5TXB2i%GlI=#Q{+5LRz8ijIn@@8gPL&h)70WU#*RYq{!EuOxr`7s1ln05WPjL~mT?
zW|S(CMtK|v?}5%OKBA!>$D~90QUr*=S@$K_jh=nr6F!?A8icRp+pSL&b6Q&a&EPu%
zhR^l@txNZcdj>yY5KhbvCLx8x$tGtrpK!v#L$>dHR^273!^82WY2eaYA|TQgm@0Bn
z|3|HSCrz~i-7(2B9*<)X18fCMv*Hiy=3#mstO^kk2q)!4g4>i#@NhS=a4k5Y+?82J
z=#v#BnSdj{E0oih=b7nG+FA(xZ6_mo;sA!{tzc3W7zy(OE{QaxKl&L$Fw7rB!1}_!
zn4J@1VJAbzi<aY%gWWYx0%i2xmEz8+@zuU-lB>**k{J+&VD1#c687LM0{ad@zJ)vt
zjs9SKD2Nc{&nXUtKjA`%C2s5UD?T26p5ZJU|KK<5L0P)E{twv0&x2vz->`?J7Xa*G
z#3-OBr5k`fydoJj0bmaW!o0s>4>W=e0PMk{IY$71J-FPP?gU^D)+u(*KQmWc!|uO-
zJmx$+nzf<ACpS<w=B}KWy&JWD`?J8fH)&$d5pHz-#*eabzp;c|967%bSP&hMl7Jw5
zTFOIHjt*&`%%k49Cd;k-EbVDyKJ(#}{GH)vM6VkQpi&<cWtArzqZ$kOXUvtgH&s&F
z=@V{7m&uzezo4BxC~oX4Q)O_S%<gV1d1x-69+)wiN841WAZ4SJSUw$dyQz%jji82*
z;7pl9W4V?azg9yzy2^P5VRTszdoQT<HleBV?17NpPT6eJa6^^78=t|K^0Br_hHUpP
zTk)UebB^7#kKIYP`_GgowTGc#&L?&dq`XedepB6|1~0XsI@m*cwvKvUnm}SQ6<=wk
zUNu;Wf*&44!DEbfUkCI`+D9`C1H1uK!ol$4VEBZUDNTC8VKf0npr^bRF0H{<*TaqR
zI93o6x@0%xf3f<rW3GYcBqN-Ih4e_p?4E75?YNSi%@I6+f*Gu2C^b5kmmZpt&;tu!
zD8Dk-Cwo*<PxMh*As#=)!XOK893H*Y)yL-t5yt3N`q7;YvkJrT=+$8m`daWUN=#)w
zMNR46Ph*HIwl<t19WKO<*0xE3Kna})5|E!MQ$34frEcAPQMqbR-`d~edn@Xf_?Mzt
z=EB?EPC_n~Uo`hy2TLw)#ZgI^l{0#^DcZkI_|So^7H!Lu@vG-75MB$_O7GAfa87yJ
zX-@3n)$@|jCGF?qwOixUqldzGa2X|SUt5~Rb8P$?a#n@ci6+{{$lCAZ)U{c59?fTY
z<L(6FKOKY7Efj_lmgLbbKUHvXnTVkzE9AaRe*A(}Af@}R&0WK%aAgxh1Z7jH;?vFN
znP=0bs!iqEA2zi*&Sq+3nkp@yZt0DCzaRmZ@`fR|jLy&Ikd)1}p-;C>+0HR2)#m!t
z58D=!=kw^8qlU~hTh*Sag^AI-&D;$;7B-S;YA7(}!0Vzizr|EB9mi1S?G;2$N9wm?
z7%h1voQ)bAN)0Dh{q$kPlkXj0iRRv6Unm@39oe{9B&~AV_2jMEdZU;l7>~NvpEPS0
zxqR#7ox$*)!I=+<Y&#r+Q&4q^lyrCpwck^l*mRgGpICWUeqwE{&fzoC_@!0F!<3~K
zj{_=d#^MlbO?CrJ>(aS6+9%$eZ2!90W#L;!$XQX5s&)C48$Jjn0g{12{7<0x(+XjU
zASi_QE|!?U_?=~?sy1&J0)K<re@PMeFUkKI-`PX@!Pgtd<sg52=VN~=IT46w5`6C=
zKaxaw1<#*cdRJIodgU3&6B!A*vZQdPyF}?hLy!D<jUTx}hCHM}WrIBVKx8^F5Dgr*
z%S8+XCeZ14B;v=ju*=1@F}Lw^KM;uw@#2@^(^d~Dd>(44&xvX$P<kYRGE5qrKt<4I
zd$|W<hLIBDKp<LT{3{NMM5J;eLG;KR0xm1*1;9L@j{fED2CRGkF)ZL?EF2^tCVeTZ
z<})4(A_%wi&Rh2qKtlrgAiN@eDMVgeE08Vi*E{zapNT*s<009hev0al3J;&0`)@ea
zLA*!^-k#S(BqTS~uZGC;2FM4*>~l>W0;PsLgh4<`5SXLSHj_W8GlT#N;sO!iy@PNf
zo=I##Ge89DP%cOw$>tqPc~3PpW|jA;RxdoQG?lEh`K@$MEcG##hOL$_!z@j7EMM_k
znx9x$Vl1p%Eo{RqURzl>h*>x>TezH<yJ5^dTFt%E%zZq~-{_bR(S-$wg$3z^g?NVH
z!qUPbTEn6+VKFCRam?WfV&O?T;VGWsfy}`ft>Iai@SKxy1am~bSVW;tM6qW?X<9^i
zYeXd`qWUDFmN~LsEV5B2ve`4TH7&BeHL?>E*?kg;WRB_;i|W&f8t{xlr9}<5MvY>k
z#!jNp%+Zr#(bGE7v!2nIwCIJ_=p{__$CKz4=9pEn7_3grSI?M@w3yA-m~BkV?n%rZ
zbL_rYY?TfuRRgq+f~2}WR>h0CLhVag8w&=3@!}y;1<}-wv2<uK2pR`LgJI5(+g+mR
zpmB^|@#h<0OeutUKK`89cUB2>B|QElEt<hPo?uUg%Q~JlJ(^=Bjsu3HzJiWBw}N0W
z5K8ppbLK>%&tS@LAREQ#qp$?hx&(-B!em%HemXVSD}K5(iF6`~Q6PyaJc-C8>D(%L
zA}mqD>+u7DM9MN4<|N_#B<}X(#8g+vf@cDRL<Hv&PZS<4E1vK=J^D;3m1#(Eb|cYq
zC}BP=4y+C$n@<KqL3}G<S@C#`7})z11UUuaO+c=nM&E$OLB(Ta%aRXT)3fH&b57F{
zEE)OY8HKtT#a<bu=^5p18I|)H)u$P?ESdG<nT@)c&0d+U>6z_qnVs{Q-KPNTA*)wB
zt4}v;z$*)to;BQ-H9DU)cAAA|$(|I?p4QEt^~%PiXD{H|vX|zwKb~f<u;i?Y=U{bn
zzIx?sq~~n5<!sOA?4IWAvE=TH=N{<h9(m=Sr01Ts<zCF^;!blxtO$q%0$&e7=#3!G
zK#;a0$QKZlX9#N6JX(o7dc8bG?>y#=Jl6I+_JzDFXL(T8e6BxW54_&_{2BRz?fJqB
z`8Uq;MOX`NOBCGID-iWA5X&f#XfJrMQ1I}q0LEG<BT*=)SE%4!sFYEt++L`%P^fxV
zsLopST%t%ruSm<gNGGF6uf51%p~&d0$e6X*RHE2Suh_!7*eavgroGs1q1gVc*paow
zS)#;Muf*NE#51GByS>DBp~Ua31kPF-AW@17(kl%aj<^w58qr=FwNM&!RvO1zmLO4<
zq*s<wjwcmoeo|YOwNRFGR)%0L&zC4K)GIIcE-z&zklMSg7E)e)R$j|mQGZr0g@#p0
zRJ3MPw6|B}vJzCbn{~2Q_DWP1FT}QNmK}h=7qH60GcXIXGV=_~yjM2aUN+>7*J@Mw
zbf9dgy>fZDiV|LhW~~~Rs61E!5yn-2)2qH}3_gKEHZ!UzYAb8YtB^KT!x2=UB&rdc
zm1sc-6|5#x5W>7yHJ4GPIZ$>LT5|&nCPahoJ67L^Lg?YuyAf1mWZ+%W8Y;;;YIyb3
zS@k!GDt59u=JQIBP%YVc?S&(*S~#<kauFo70^;2&BeSi?Mbt5Yz&|AF>uhQs4^*9c
zSM%6{X@wv^y&J(o5QWSdt~jvL2-P)2rGQXf)^H=AK7<BZD{x-TqFx26z+;W9d*V}<
zr3d*e2zkI(|7@}BT(5>CvgYGvV`xJ2R7T~?$a)2~YVECR&&&o~dp&ro@-(7mwY<hR
zv+^DYj8U%rZqs~53TBC`1b37H{*w0ktvctecw}waq>YNajV>LPCbli{nJrl(b>>g1
zg(T|*Dw-~8YvazF3AaFzi>*BRZFrJZW6I!zGjOD2gOn|3?W`Q3Z<f#2R;b@X=hKp~
zRg=k9#SCwn%V@w(MNri~Y3=u^oy};acI^0`(E(X(J6P$+?`U(d?R1K4#hg_YEq0bf
zHtpy^n1rfyB%3bKO_S%<fs$>-i%n`|&7r-mpGSJWY&ES3)h<W03=35ZN}6Sp*4%#5
zB4OO_xmC})RZm!3w=Y=D{-o2&7DQ9qgkA*AMAYps)Nf=o;%~Q}`8086wvCW>eA_Cg
zA~)+`?Rqm(Q=L)y<E+x5qqd!_<#}_(Y{&ZtS$(3N-F2+JIg4$|?EU@2ea{X0HGSVp
zS@i4q_G@(Z8;w@#RKEHP1pF_Ftq_PWh~bZQ1wa}a5T6`k(Ky`B4hFS@!(n!C*dyE^
zW@j9Ggc+O%as#-X`9bs=4hK9%W6`L=!Fk-#8WxSl3<8gVJ@ez}wL{#__#g@cJUBcY
z2M+D*9O90!N56CT*rVSF&>h^-_~87`&iu~N+71T2gWJLE90BS3LCpL(cJ24N0xU2B
z8jD2(+5B-}CuRqWo&R6Rvi@txf6c&OW&lWR;r+d4hFt-arc{^TAIW^jW(igITQkEK
z;`olUa43=gMftXvY5#Dl$g5#`UFYHtnPPW_kxIt?{#k5f>>yGEJRnkm?;!$iYz~T$
zdaDpjnkO)kFY7>C3Psq?RT9vGm{*!Af^zwCRkI`x1t%-T*u;$0o!|jwPpXPF^cyP(
zsL4!;YvFL%4ETC$#Ll9$9bOMHVeN{ytKD2dEYW=i3HKZQ5DN-B21j>mib=k^)C%P+
zTYZq5TuEI~2{#u>6^VF6*iVHW+Q?niUOO5i=Si-SgVvwc`RnA-iJ-H^kU!ygkJtRd
z_I#`DBk7EBP%E@FY>m)TsQD?`3?KY6<!$zdXHdvdUT?+o3!`7Stvm#Yh&K32YYF`e
zje9e6B*Y5@a2JL{?OaQc3PRd@C+~1sC-Svt{OjF!d@s!o<_G6J(!E;J)WJqt9C#DA
zKntd}EGI@`)M03-1^q)$dVe;R&;VklLgb8{V=#Wc#_rI){J_g>rB}~L_Xg=Lb14{J
zfdw&&&x}YuqKscqLM-E5@bORA2ng+3a~?N;<6HFw9UL3#(4qJAl1({F3}PR5@lQLn
z>4qBSUEMx0j-BR+`|9deKmRG(s;=deG5iwClYJRIi?M=)$!poByfM!M-BB83@#fWF
zL^voIBo~*ayJ<3VW-=%r7bo2EYW<XC@1*fkS5^wXWebrZwN%lWC9tbS+xIakmpmLX
zX~a0+ecimI(DAxuh4%1uD|Ue%_BX2}K%jpQtbbM}&-OQfxOub<L{!}N5pMqshuuEf
z*gxCG0`YJMNVQ@&fGjNVbYp)5i#yxLVt4j8HnxG9=I=c~hocRk_u1J77P}4X05<IJ
zwO>cL-^(lZ&yLQ3bI#7Tfx_s~&c^o6KF|gD+CSO=cHxfp_jiC){?Rt@3>abK2pE5R
z=U=b>f6c)E_6+=^z{>jY9|Tr3;@<-6$-Dm;SPB1OU|kyv2Lfx65=iDnzI^CM9(8HB
zc8wkx4@hLCVvgjI+Cu^nH$kmJJ*V4_Xv8Xr;6<v@)3#=~HW?Qqg4!4?t%;BK+?7LL
z0~T6Gj^oOiIONx@QRJqx7fcd1jPN5stO+h4CmHk2?f9cyU1q}xG~`4gS=JVs8Dc1v
z96ga%6)tSsIm0V(2Rzyb%*1|aT!D2m*UU;KosjEbqJ%LH8nDFjGUGK|9}I~I1dWiR
zwOlJw%GH{`ubb9-Ga&<s=R+x5lxcvvS}g?wt06(sUe0rsXZ<hLpgcOCTo^7rK3Rg4
zYW=-;iwLghM!oi&c>SGb9qAj!arn}5#rlZjl}vC*x*LVk9Q<XJv>Vj-xil;wF#Q=Z
z2v3m#1$Mg`=LjY<oM6;ef+{n73Oh&-yBcwiu?YTF#f@-5{Wc>A&yW6Fk?{-i{gZ-N
zIw?hDoQaV!GGsg5bumCKLFd!kmGEotNNWwnwVX#z)99mQI0y?Z-AwM6;&G?3WXWTy
z9%sL?$Axmgbf;m&sO`&JU-c`LQpf<kN?uzqH`WDGG*fOVIV4Y0f<^VTt-?>C8D_eS
zd6^8VOniyAyf8159h_Wqf#`}9vV*LUPU;C+TQk-5Yjw~x@|7uH51n-%p=tgYqJO=0
zHHD16?Q5~*3(#NQxXJ*xEFkv&_xSq1eGC6<{C~~BKkW<<Yy4jqdyD+Vhvtt@h_xVo
zFf)i56e{Z;QMK|jtYb{hBl7eDXAqm8jsBwiCVt@CkxOxV;=sI9VM}-?dSvT3X9645
zGxai|*d(dMwWQrRu{gYQJhXkxD85+vO@et^RsHILcNOxnZ(Q!=+UWLi-RGa~Wu1!N
zae340hH*u@QF$33R<g!dor~J^WAZ#JdQyg#wIi})duI~*F^&bz$*9Hj(NAurok@cW
zuTsjAQA=-X-|Ix?7{(PUddJ50&c?i(j_jWBt?6|tZ1X7ZR(=x~--mhZ8z0#{iJ1Bt
z)iaqn_Bo_&H17S}tCaG8+Q00-F6^Ib28e%vNL*3W2*f*J@iPeNxMxfRA!cP2&Qmub
z4kut^FEmCPM@E2*nSD8t(02i>^byp?`1mM1(ugSa)`C1xoS2K&v{PKrSS~4%qm>S*
zbc}>n2uuG%x;H$FoTu8eY{i%|mBEl5i+m;955C3o5Y%QOt;ixCZ(12o7obYdj3+EY
zTCcd&CeBTcB;l-%$Rg(eJkaZH-a~IbGPoOtR~UPh=;{(Eoy&R*LQ6Z^r(2&#(Jn@I
z_by0+FFuf5`Ad|y$Tc_wqGJH^G9e@&^RYIjhxHmm;z-CPm`%~La#1qf5@Cy=e4;2t
zdIe)uDD>YKeg8EI$iIGrTt8B<_fvHXPU;*vyTIiQ&CPv3_0Fq%Q`nf&{b6eNB(Y=o
zZAr6LY>tX+P*7#Z>!iZ>8%L($>B`Q5HFIlbQP~;qCg%1|-+w!<n_sV<S$h?kX&#;Z
zG9=ZnsL?VeyK;IpxpO3c2&3#Apz0Qsh8%xe+?>!pREAzL4NvpQuP;S^w299z99b-z
zSV`_0&FP=<%Bv|DS@17wEgD@?aSiq<s5gyBubumvjvUYIoy;AaeHEFJ(miSuk1!5P
z&FY&n2ujHApEe9i3Mg-@n*I`2(^EaWRynnr)-zT<`5A$l3#sn<r@Hz6bus@WGXO*Z
zGULBSfiTBCXb6Oil~pBQJ&!P)fQtRVqz@4l0a9f)<Lm{Z05!cclsXWC0u!oxs$&W{
z!M~$`hO<a85CsS{tV$uJs?@YBK&EpAFD{FehtSJ<Wd(==mh6?atJ3mdZXP4hDM&gD
z^vId3Ux~+(C|h2H5N1rzL(%5yB0&vr2sGdnXR&WJ!84l);WZL%wQ?jz(LSIwf`aQ6
zCbQ@s@}z|)!uzhcIjLGPbGeRPBVtG!U^z5a28qduu<T6|kdyhw8uRS^83pXoCh9VB
zQR3ZP@jjq@{HW{n62?aVFbX_XRR<Q3sj58#GQ!<GNL@YsiOI=#z3<b~GqiQ|KCiC2
zyL<Zh_~qp0YG~?qb@%A%8T25L!6D%TgQ$&f-@Lv35PA82Z{cs=_^o~Y>gnnG1-n*K
zT9%caJ2LuV<@4u{pH>PAi_$Z)`~w0PmzK13^gTVj`v(S=KYmP2ODilY&PC+e+dGVY
z7;|-XpPZUP4Gn)?U-u6Pc5raY%FbC@{x~~_(a_Y+$OITiZtwg0SHFCD*V{WhGUDOk
z2~d@$XJ&Qv^!oY-#>UaecfB*SbJ(@D%Bt$}ic0jvL`P?rv$Oj@$qo0f%lIdp0b(qO
z2#`Gk;xiD4hu(nSk@FoDG0k&FrT9V000AzDj&z(Hegr$U4HOM%FCc_T!qQ=8oZx7Y
zR|?b5YC}ddi3!YfPVh=p$SJS(O&jO=N2U?6ABkBbpyY`({`8|zE@?UNO?Fju8puBY
z#BB;G665B@OBduPgsr@IMcicf%7_}2=&#3ki@_fGOy<>8u#Bo+ni4v204htW+L||^
zfKDT0bw$x6!e!}Ro7~VTg}SIv6Hs}Eq&FHXfgW=4_#<d!Xt)?QuH-3!2;Nb$T2n7M
z%Ix$qYe%2hD?KCZC42vu4*`FC+Wzame}Je4yyO8A8UR516MY8Y&eGE}^78TlEykae
zGe8Rl2s#1r1)#P7L{|Xi3}BrBh_l?>TmW$fz|DXv6TmbBUWNeW4B(q#u>d^*1MtcK
zYT4``_%eWF2GGm^rWrssL;QZF+XG?^Kt_?Bodd`^08-hX;4(nE+Sk_)aLfQn1pqe#
zAZ7s83{X`7Vh}*D@h6=O;FSTSGC&3b!~sCl@h8&^0Ga_Pv%gZy0C@-?76V{q0J7|#
z@MinhCH?cv0P)8^%0!M}5Qvmm&_HQ#@LeD|^9?!YSBU6PkP7*ORd`-VAPpgZJbVJ=
z&-0LSR$UBKFp^4TLM;q#_$m!1p{J}Pap{#IzR3+mh<q{k55BET3snlh%5vh<^&$7v
zVG+ShBBo+{P*6nbLzYQTYj815IFYBRZ~&tP9{9#}r3XK5bB5Af6}h2_%I66P!wWa|
z1qZDVP%%qh_yT?w!HhSFgz58U%?X341bfJ3YT*{CiX?vc@b~_a6wLSGs5($JWeA=(
zuq5nRKaBDLk0ALox8U7Rl9Zw+9Dgd#9|Q9ZB-nn_6mLU9f4fco7wyJ<NvTKDGBUC<
zGKz{a&$VTrnaRGelYQ<krxq;xI9^#LOG}~5Laxq1rp-&bH%J;4A=453wDgTZnw`^|
zmwviWB4ia}q!eNwJxi4~EtR#alkx46jqH_<8C6N2)-75#tH#<iY`Apn1fh<@ht8u$
zFOnxNaxoWW%NG?NFRGW0o2OR0M$pKCzTVyrR9ER_bNE8N`%<mrYJ=luhxcB8=+Ri>
z@m#^_=la91J-geZYa6pGUzV2Ev2#0nQ$J58jxNw=mq434y~G}0d^^6_Jh|LByWBYc
z-PZqTTgMkW2fy3y&-4G-j`n_T@BQ5Q@$>us&)*i8fJp85=yx3(DAN2EQT)yJ7Zt_D
z@#W?B^GodI<^1L4^yTH`A8qRLa_;hS3Gmpwy!-}qxV${LygUbrI{#NTAYA|V<NS{u
zfYbl0KL2_Df8O)gpZ?z*`m@j9cKF-J|M}=&$NV1;0UiGHP=9y&KkW0@vw#8y$=_Fo
zskxQ2{;o1C8^Qj#{?E#=!BBnC$nVN<*5iiXm0_37rJ=t;oc#8;{5Ql&!GA+jEI0fE
zaRSg30mMo5atD=~@q1pL-hOH^sD>S46=h^+A7W>vEJO6M?e@{;kTFegk~l5D-ow#!
zhp&YqwWprK^$p*qN^N5h2_+=WR~dDU-#>UJ+AJxKPY1pA${~(ONt%b|sRYmFmqFX=
zl?q5E2PuR3R7@!o8}$l7Cfy@JUmvID<u|w><A7+zgZbR6?!Tf%_FZ=0E55a~g)Evu
z^3ECWa;`mmhmxj7UbV#S%q|)kVb$Y|2w2SmnC@%9s7XV1+(KXd3TK2+Jl~e@GsTnV
zy%KsQKnXC})u@|elP<g;N6gdC85G{kA-e2qxwf8aWUsD3{g#3jgn)Bg`T8<Ciy}V9
z^~P=b4C`$YdKMa0SFM#KP1=nD7*Ff0?iJPx9ju9mk`gFk<Fn_iC*}Z3O^gNCy?m>$
z9R3szxg}0b>LZ|l4CywxkCkmEcn1b^vGeD~`K-kU;!zZ$^Qhb9L!t}fl!sI8?M#(n
zB-msD>P!z|tpHmYW2T%8>moSC6&xcuHoyf<fp3-_wd!S&f$z!}6j|L~CtLGFs;@W;
ze<+2B(EUgW?d&nln%;mXt-s~$Y2di(SWB}aSc&(oX*;vO-kT9liD^&uYM#_ZBRW(E
zuQuVi@vWCr{vf#_ZPz}u5sfdh@yZNDrm}5I_(OaUzb!}UO2<h?B#kq@2QM872c`aZ
z$1@Vwtqu>$LO!ssf-RbCLw*#EVp%1r8Qc{W{tB!g^{1%rI1Ke4Cj23MOP+x!I$Fib
zUE%xS^~h175#_0)eHpdIZ_cPYR4Q&A#}u9hv5uw%w`3mvTGI4DaXvAN+lv`>&9SaF
zRHqPQXKfl)<2G#R(7W0qi<^6SmA)CHuQ}%tRx{u&T5bJP&$$XePi3)FjH;2<$)3u)
z<!$PVX1zFq%cs?VAdZ0*`FVHk=49@c#6CQ5F;l{wP+&wj_sjm1oSyV2QtNMWwp7*q
zz8zih)=a#)AU^2#bhidpZ6xLF0lNRo&25gQkfYvCVaR=_Z6vBGwjn|p-BOqENWCYQ
z?NO&z^{gM-dCa{eG=Q^Gy>PR}2n}nWIVItLS-Uv%+F2G(n6v`BuQ!%WnOxeHR^_wI
z2KHKs!&~u$6Z*uf5r@1eUxt1bwa`<;XRUo$Rmo>aoX%c<GMx@ZR!AKEcs5ac3x7a!
zOH8Jg(@&KSzvpDv2lpsQ*IzlVh_N>&Olxy7(NnWGgt*G|rpdC5Ov6oDjSUJhPvnS>
zdg1jSAu6OY#8K^zX?@20CJfGaG-J$t@0)1c-sXc@Xc`m(?Mh{B$fv?74|0C<7*Rh8
z{$Kf9{vmnzTYpO-`C9+~=x;e<bhiKZ{+7|Y_}uiL|J~p6X9i~UANgB;xeH+#fQGoY
z|IFTtDtWN}U;A6)T*%F=WZBS2^#AB@87tVx$p5tLf1oKI3P3~uH)x7)Y_A9d=6S5{
zS|z9Nu<D8aXO1D1v}u~JShjRv`^I%99NU%9NSz)+FyuCKr3qO@Hu6lfLFPr}2mVEt
zvFCR6vR$}sn>)7tV;RlQnxx3hp7`i@<<H)YyKeW!PaQ+WFWp$U{De>$>Q8VNdb>J%
z+cMGT&R53fh6nuHF2}S>gpQyFAI@EfAlnjwRVdLlXr<R&ve9OWVn<5Gu1#D8WUku-
zJkU?b!5bI2Dkxnw<#q!OJ707Y7wtH?{Qf}$y+nX%Zn3_;XF|BhPTFJ9%_z3#erIK6
z?!o<bUdPw2EhB*!!$<c9mUptDppWCjus&L=n1}|+imP$0??q!q!{5fOqV$-Xs;~ce
z8%(ZCu030sn>}N!{l%2zC*q;Z4K=?zu+<A0ohsD5N~i0iEHlm2jrU!IgQe|0y+_XW
zpEph80=z0$=&lZY*wPcuRAa{uIf;I-&;n<Q<6%(?9;5NmKka4&7kSrb?^8Rz%e{`y
zx)XRhO!LsyvQNlz)L92fCh8J~C#8$8Jv(umxYk5-#p0%I`<>dZM4}|vI;>@ZAfNYo
z*3D%7v39ZXqwFT#kr6XsIsCMcmJ1>44n|*=wTc$E?|IYi4&|}L?f0{H!>G88Ot~ed
zWBpu;h_Y?gv_y$3{M@{@*>zvp`k>#0xHX4n+wLXYYyBY5SaX$q`$6dG!k|KP;j{M^
zGplVMYY7_7VjtKG!rMnbH|<w4-LU);aXv$=SQp^bq5Fs^WA?DCwR+IT#w*nQ(^6M!
zFitxAdjl`qmyZ^rQTGkZuf>U@xo?W56^!bVy>0F{j%kjtRN2*)deGzH?)GN#`Wojk
za~&JgR!;c&b|TZ|H=dhbx(#-iGyJrraRvuG8|p6v_dPnM7{AwlH~gN-A&Na&_U{nr
zTG-ENStpqL-hXrXGXtNe;g=6hZ`Wd6JrWNmxlwg_-=dE@5|@{r|9|ke{B<UT`FDTI
zbKEhKs(UX~?P8Vf*9l6kdp~vj;;ZDZQ*><iL5bSsrv9%p%y{=v3vT>!*XP&y3RTa^
zpc-yJ^Vh|OTF=?sIPR$9*X3Sp&&9ghud~HpxRdc7-0}D?-1)CxAZCCX3&+=i6MDjl
z)8M470MPO`O_7?}pH>Vo2li*=_ft-Qw59sLE8)5B=>JR6gVvRxj@O`h9ghs*-<Aqy
z-5_94*AZmK=OzxADdFMR^KV`c5Wx7;!UOM?zKwSCVc7#ecJ#Ti5vaWqzyS+tUB}~%
z3u4#{x?<%ci3oVa|3*0gPtD3l8VzPZ1SmrSTUzjf`whgx0)m5sv^V@-Soypr4pt(z
zH&_oeLV|C>0;n8AwW))&5j@_lA>$=H!bq^ZCxIjqf_sSxrA7F&x8kXwOs;O=shqIA
zB@WwO54cn6qZsBRod&+MftS7!BE=u1WfeZU?k~CL?-qt1Uh1ym7;qICVT=jPR0`I&
zir8ifu}<@8Dh<1;6y6->BjFht!VG9Be6KL$tCdFGDE0SM3b-N?Dy{>*j)>Isi28ot
zP(>{I;YNgdYp`&u&qq&!1f4KUSX84`Xc;ET$1~DdEW+_5WS#l#HY$2bOz$Ka|1ix5
zNgNH>L-yYf)>I1H7K=&XkIctF&WYo`X~$%FMmBBWQS61XGsj?Cqc1n&$XVhFPIT2!
zG3+RRN|JD_SiHJU1RINA+DU}xNodnaRP#D69FX$r>qOoa4;e^H=(!)9sT1376>OFk
zu*aMvS(><}=&@)Od+F(uI|D(W655rb7_E~ubd$SUePq$#UpmPKZSkrbKAM<h)3U@D
zL$TuGDOTwzHf<?(^C|YHDUK|u&f=-Ax~cA7sh;Vn-fgMA^QnHPsc@FGfHI#(?X(cD
zw6OHFh_<w-`LvkRv^bXZ1o8AF-SiZ%bby+X(e@uC4{@ijdcGPJhHLZ$8|xjt1P|yt
z5WZ}6b1!*jY`X5zN{|_EnUP&&TIQvZFYh3jV&*%?@~qiX(!$(VK__fY&%lCpz9=(p
zFf;3iS&y~Ge80f~?rXT{7mHbOlPCqJo<oPavh2@II-llcjQF!-6|)@_9One?imf;^
zc`%20*p$+^h8<@4+{)c)*7F&#WQXB>*7e$LGYw+Om8NrAF4m_*SQLMDpt5m57CC)t
zwn?;rTnKm-hsSQ0As7N3X+oV#ooulzuNfj-nIxRfX264*h$IgL)LVm?36V8{h;?&{
z<jww-?kJoARwgV+<SV$Nr$Ic2h$G0I*79g<&V@2Lhnd?H^Lm_=7RD$R%1daN59H<^
z<~^u2oDmln%_#Ul;v&<Yb#=iLP(!F`SSUusR=l%VBd~K}E$q~^s3h@NNe845e<ykH
zE)C202a*S`dueGIWf|@NNb-<TUfy0_x$tk22Z;(&B@f>D7!?w*R%v{-P2!1II5jk+
zohhlMJg}qHrz<Rk%rOOvs-!RFX$cF6KMAK03H*X7mnaR1DD{8(EwXJrOnxKoBdS8-
zBtQ(67+&hbzfnm?oEXv?<;9#B=ow1ZR&Hh$($1IIk4m_&TP^4r)U*-$sU38(P<f#o
z6|rHs&FT+{tenP#>aoO7ES8JK;qPM-I@YUO*Zp7X)G#cD5T+-+QNla-4qj<aZuLmK
zjlx&+!qwM#*RfWFC8znQiPxEX`9QZ~uE6WBod@1{5~IghO-rAmn~r};TCwk0$2aeT
zv})i_k9&s-mK2I1BlD*ti<D1GRx%E~H4nMJSiY}ReJi|{jVzWUvzkpTDVM)qY$)N;
zMm1|X_=!%KB+}pxS@WJ)v-Oka7QU*rh(PV|hP{&{KF^dn<v?^s#iCNkF3QyYyxgHR
zF88qUm1o6kpZEuhAsfnVQXL_#Eg&aiuq$(L!&%7wN!!S9y_{9Fsa14&So25a;E;O(
z`<|_h-W{!(9qk<*or@ja=N(A4&R)sRKK;%CpH5U}=Ws{o=wjzsMM?^5*Q8|Ew0_qt
z&Zi5L*|pHowY1pv@w{t=t$S6n8>`>_HB*C2%&OSG;I%~Fv;OXUZKLFC?puef1x1;}
zgvGikFY^g=YuXBt7Vh=oHa>IaTJD*f`r2ipLBbI>TJ4BkGR-|QZ@~d`SbI0gnX3<P
z;N}S4RpqQBw|B8?`GfDWotT_qmc_oCTK1bZjx7c+i3~3^k*FrtHFJG6ck3G~)(wvh
zPi+Mf@97Mac!SIJypUjOZvmw!R)Y||N1$9TU)GP}u1`i;*t2paSl_WA!KX7$ROH%E
zQjn_yCijj^XpPNyBy_Ri9uHgWLW)gp*Sfwa&SNR|u9qibr>;DV9Q4jAmYxOUd_4NR
zFZz!M2B#14;8E6tCU$C3Srl_fSIv@jtt{}M)h}xs>*fI`58I)yrmt8nc%!^a&F!uj
zxEGB&B;x72uH+vb_6_=57P31ey7WCZ$Tkh>L$&4m7DdY*^%l+O{2I#GD;nY>wEv}P
zoO)z{n$b;d?#&tO&b=5qIl5-)o!geKBdg+0Q||a7e&i@T?~S?1tBaA$Sq}|_ZQld&
zfu%x=V>^ow>l~{O`Khj3cKs_V#Zd&AfS<<$*KxuD*;x1f7;?n?1MOD});EPMQYxLC
zGCq8>yR%iP`zyrrmdBmeZ(b%3hDNn)YzGS?ze2!z<L%eLiUSjlpaOn9T(+_I%aCNZ
z#Sm>4LkICAql6jfU*bA3*Gg!Ft;*d;o0^=RMtj7yuXeNa@LZb19taIE_HWfsUW~qL
zBg{06m>ynpaaZWQuZMo9m&InItt9UBAxr-~<NJOVk2Q01_5uC=s65q5LxVZ1MiTuy
zQsX_F8E@=zJ+3>sC>y3)nD6_1D6JUtdh^m)(BZ^NADmG_;@kb(-|`X@$1$HEHJ@ZS
zpYmotEqgwrYd&jvKId{i>qlq4)Iy=*Lh+l0((Hxuu7%3wh3d<NT8_nfsl`Ua#b&8g
zu9MbwrVwt&MwouYu%3awcyJ|IyXUvi7tBkiVQ+#m!3z?x<6=P%aQdw^o{h?BNkLD7
zxt=W1?u9Pfq>k-W&A$$_6M7S*-zZ?+9#~=Mp_Ig~uETv2^HA)g_Q-PbNt0t+{c3jj
zVO6sV$X@z!2L)qQ2t#=9Wwk(C!lq3EtygG}Ph<8;_{H+F`MJM#<R=H~_#vs!$;9=v
z*!acanC*=?WZLqhk+^EfXf5U-s_x(yY4Pc$H37Dt>HPvygi^th5nrx<QSYd^#ORRC
zN8V3gRwj#Eu&VQt#ByV5K5hi)moC|jET5b#In37%T~@r``Sb`EWW~RtX;UjWmi*x)
zMA>Nh>S;hhf6$lc<O0tokNH@(>P73w!0OhuHVGr;jxSlZ5jZR<)@o$+$=F(oP{Ov&
zCm-uI38M|YD>bbPL3P9((;Q#P%T|~dSFU|q@&C9X!!K>yz4+Sbi&y%WDZ%w#rFP~0
z&r!SUf~Zwq@zpyzSWH;b*RYTl<<{I8P*hHZYT3qJzm^rL$O4?tLK<Fab*Qwb+l7rz
zgH-~b-y$()`zuq*SU3E0wBLr*4(Z0%FWNhpk2@c6J1bXqS0C<Tjds8K?QZ1kZg%gE
z6D{oGcK5D)-+%c1!07vt-}jT8?`PfLFFt<9;lBII8+6L|goMsfDP*;-p(zFm<4)%^
zB=l4bJy)*nm2!^u23wUr{;;lDq+$owyZ+(+#TXvDwZQ|N(+gH}&t<R;qd|6&4ui;^
z+x;1ePi~CO;{)P@E4us7D+|X?3q3uIurqEn5|EoO^GH9j^G3|PCa^abEwa7P6<61L
zWSlcBZxg9mpqHH{Z}(pEjlBWm<P~^HVq%Wgh1G;bfuYX9nv<DjP1gHjTm7uwdnqqP
zJti#g>E>-8NM7pRLxL-k!3Lo^H$wI%?b1D#4pDW0mU+0@msLv5K~V((tI=1Eox_A+
zc-2o%LQveXTGjoiln|HOabR>mSc+8tv10lg!ji~rLq86yS-T%@e0nrjja)l_P`@1E
zOR;G*IN2MRYE-dmFc>__{7SJsw4CL{z*NLzah!lF8xHG1-MN3U_xLD9EkEg3eqyXX
z{@ifz@(11V@%zdsBY8KE`$eEj(;LcX)$)5=MW+ehEJQ#35H!Zk+g<+ZoUyPdIj#Bi
zIXD(n2P0^Pa+eyP|BxmT4WZ!RHQ0y?B?<l0-?E_pDuvnILT-~4szBC2*h$(u0wO_9
zLu?(aj*}|*21m|C>$7#$9H}=rd{zza(FF2uDyZ-YUePo`30?|u_59HYIyM=60h4#L
zRrFOx*N5*G%LPAZwLj#q<Ci0QUT5woq_I0duEAm<qO@<UkVQ;j>N4N*`7x6p8C{UE
z$FAu>G{-na*@@NjsF#7B>d#xaK6a7!XyH29X>JS@=ai*fiQ4B4dQV;_k>%?FjZJWs
zkn>&AakOFbep(*0^Ze)61irTBv224==Ru3{*=g^in>$@B&4NoG;zZo+#&U1o?S_4|
z4JqyNaI11`l^xS&fTTEzb?UEMr+*sEefi4|NXh>q5`lq<cxqvQzom#Y0h3v+G||-{
z5g8J`!de-!n|&g(6!)>UvQ&@oZ^_Xp^3=)EsmTF}J#Di(d8U^^w-i_`3+oiv9Qtkn
z{+8G}MZ6l&Z6(f7o_ZzjSh?GeuceyRKjzB~x~(iwQdqAnRMU6+$@La&{gazL_;*xp
z4e~Uo+!>d<^Yq@FS;N!&pMvhFimw;q8dN2}_x<5-*`W657ye!K-~N{BvQ+YSpUMA2
zf6KMT7iy0PW}a>}v-*b%^-7N5L*M8?3AlgU)>P67G@F^>^jImMRv%~QlF$s?POe~#
zILHsEvZJ7#GYJ>gY9~nPck?GS6|0{!$&|9y<?@+HMsc(=B+L*zRDvkk4PH+jYY!NO
zFF_+`jv`DY9aB-{tS1ag1|8WgMqWZ2&C9MH3=P`akxj`n=4vvtOQaf2j5;J@pyOrI
z)uNf@5yC5z?Y1|I-4?h!_@yCHYQczAAz$iK{TE~rGh<=?S*M>oZ&tj+a^2zg4|MIq
zt-x1xoMv@jI@0iZs$AVX%$v^8=4JW@y@EK3aMR{6*(|SdWce8Hwv()vYJL6m)$8{m
zXX}wQe)p{mQ*RvGRB4aRjhSjTi+yyn+`$BKFdj)7Yg)=nd=oVc=@?3<xzTJNs-}9b
zK_yn)7MS&+c;<)Zkhzy_^$X@jRGr7hip202a(AJqu43KwwsXqWxt_ro&)pIV#i=cH
zqMhicHaez#gDL;Jl;6j>8U4VWbJs5-I3<)!j~$Du&NkQ8Qm4e;>aOd}4eZ<lZ}9Y8
zT|N)ZzR7xgw<g7CsIDp%VUpS7m%hnqqHx7*l@ob#$g%kWS-ZejxOnfo>W5c``?w2&
zLbn|#LEY9BI(o5gQk2>oGg6Mdw8Ez8H9?D?Y_!K1-kX%_LT|lY3>xd@?-#tG_C2ac
zWZt!E@~x|Op-ueMPP*Sh{IS-pI^iSn&DNrh{%z};MT7RnqaOck9;2lZwvNq^@>kNg
z@F?!2RVv>TthTEOcy5q|!)nN_&VP3zcV+*CKDp`9rV>`mRWKtbDtF^h*@bj5_lr(T
z;NF`FQ@23VdcWXiu51w{r6>c`gSqbFbkf((cRpsew!&&SY0dekQ@86a24weR{jU_h
zO4Sg1kVG<K(yW|aZqZtA?e;-uGCo^?TM3qZ%|Z8xY{1oD{DpPkn|dydtOBw)aTQa>
zskA{ki`&U<Di)$s>El5bcZ<ZI+GtH>%=KA_Hnlyqcc04qgl{R<FRtpGGL^Nylo&hR
zrt022mHj=)^1+(8n)mEf&T*gR!^1W;zoV(#U-(uq0txj1#_9jyZ@EUJ0;n1eS4#4!
zUlXgu1y1y5$qB}{MVh9$Jd09xEnsILwP`G1&5>7pNDUiNyg^sB>IpCQIeq6O6Y+dp
z7-7b@_D!w+eNH1<jwFaCQd(6ez7!f##wCsNIg^<TU4@Z6At_f!HL#?UCrboOkn21}
zOr)y^l~ecIX!+M`9=U4X+v8+l=!;0pn!d(U>l>+bD+8z1bY@mc!9uCJE5TOOeXla)
z9{A<Ya;^R&H$K5&H4{iA?I+igTDPJw9nOxaO3~Rmi65oUc+?YyhCxE&UE8YbXY_UC
z*h;FyZOi-4b5-ioRRWwdFTP65?W!a-NJm%M1xp&NGS0OQ%G*09cNlyXoogEpws$R(
zG~CphYoF`4cW>%2+;u<B+rW45?3Xm!Pnqjnmv``<=`cEKp6mJ^?BKg5`SNUbuKT#(
z!SAr+CGO*pIY*(<+f1yoPV;dOErykjpt3NrbTo9GLJKcQL20P}I>A83Y^kZ|O9V-D
z3LB*ZBikrGsbri#S3^vNR`^RIWe50|!=kDD_sO`IhS#0w$G#uBdvxqus1N9O<VC*=
zF~$)(raacDiG8eseKARG8)J6+jV1<i)#|o|%w315)XsY~BrL-@9XFXm2fyqqUpLnu
z(^>MHQ9AI~?a6E432NH+$ICU3F|z*|aHkbXa6CW$me3VJAY~=Pw15s(aLs4vvQoIe
zFcBN#T6j&$T3Ors$;W=z;(J}zsvZkdxrA<|@=`X>Qx~R76x_-+yKJ;t7G`QJqU3DJ
zbcXsA`9$+xt3;k>>^1V1&?VoC{_f1NBv!)H^EKklK8xN73ft7s<Ys43ust3kR~{l2
zrF^@0;mC2YG}4V&<v>{trP^esFA()~#T0Cfd&XN2myXbr_<|vKT#;Im4wK$Tf;}wF
zp-<Au0k!?>H@L$a^1(4?OzO<D7T1=4Tp_nGJIA9lUb{n`heu?5#^j}MR?0w8{a{{s
zD|r~UeA{2Rn$tchxx(#JadLT|NkDeXKJt3>rHaF+JBhVe7i<<oWtHO3MUN+$YnNZk
zJ`}LVzr4RfNc$EwrufkLogHH?A(03Anyo%Yu466F$xfQ`_F)bk{wB{oF`HVW@g%a#
zX1<$h`t3N!;T8R=b!!jJ&ia%Ej2_ppQH0lUw;i#sYa@|BRr^%EW-?#V=iYwhm!^2L
zsn3fITW>|Xk3F>a{hG1ms(IX2W_Z97izE9<m)fqXEwOd55)wgnwfWnZD@<Vz*=Bp2
zE_WVf`Yit!{+7QGDIx!zzh%X-0gAO~U#0&m@6>aNc=nse&*!c?mF3#{YKdI6CK0#3
zUFlX|!KP!<^EUn}`>PrYUB+46)C+JvA&5!Kx}cr2!Rj`mZK6juBMW>N@nDOY9S*mC
z$9Tq_Ot#HyAi%~$mTEuI<1i1e8UlF>Fwx58GE!f8s9!8L!oxYwOfg+F>vYGT6M4@$
zKba=hq1T@$jYW8|VS~k=9acn%@+V&Ep^7YK7{N)0J}WBtCVk*VdC%weRrbv9;1V7c
z|7TzrxmoYJZV$au*1-!7-3fM!dYNjkp2MkLNYrhCNv3b8THpA0_R77My4<u&%&8L~
z8}UBTB;>)fTB}~^>TuaBeebU})_2nsI&!_gt1r`c3w%$bPr&TjeOq3<h_pvMIYaTx
zQMX`xPYTUw*j0pCX@l5~Yzuz{$S@@KYRFxse#QGs_Nw8n{<lA5AL{p4(8#uiGi!y*
zzRqBg(L?H;<sZ|etEtG}sw}3I=`kngeeT3b86+Fdd2L5GRlIZH;Bk=|xX8#m)4(p9
z5y54=c}G~N$1!2h>!R4ZanN^q@C|m*?*MQb#Ye&EQT{xrfV-$bIVDb~?qD-ih$|{I
z2o;uu3NJ)OG@>H=P*KyUXe=rQTV~8H+A&2E&pz~yOmINI&8UJn`F3*`adY&UxN`$M
zk?V1E>Co4D(IsM%bHs!2l~xBf%3Ww|))HTRdBm%&{9wfObVRgvzEq#F)B+sO{fTl9
ztR<wpCA%SpvQ)f#F%r4~CuJt~e?eSux4rU#l+SHtuUAzl{^&^&vXBB%gNAz@w&f_F
zilF?~Ie^PnE?$m|cvApw`%>;<dws67HG70FPPn|jBJ#s(OyjCh$5d3)sCb}vTNN#N
zZDw0ALJV~~@>p!74%?EJRnmlQ!__Q_MVvI{hpF^rk{s-j&(VLFq@xOcF7aV>q}Zpu
zqMf3Gt}>Y|dPzgYSLVa~!4r%=)fY@hpjG8d?#jA`*f=)+I{o$;m_!#^w8Az5X-l?s
z_o<hJ>PUXTcq@OH=Tn4?>ZVosybFKl3(>&LFoP}9?;7BOY5o(r_NlDLkqAl$I;v@O
z)InCq`=sGI&#=bY_Q1&xS#g~ycVep(#PWp4fRf~oLQ35`-~!Uv1SmR`T6DyFFm^Ad
zM6Q&ui*#m$zt@+{l<qpiYpK|z36`P>)}{%z{t5P(368aiD~A(T2_~Tolbp%%L3by)
z<tKSGC$E`L^14m(1yAxP<0b`)CIy=&g*XbdH@UV+?%GMGOi!fj#pQlwVPG3AhRHO3
z4`-%n$mR59HK=27+g7lXc|kNu3YLj1Cy{1qk7C~--FcjP7RX4)oXi-;_=vrM63IX#
zQm`dmJjbHwA)SHd?5k~LXp`=@FP{?MEGqrM&8a7t^h3iyn2C&D&fpmXnH{%tT>;dL
z)1p0F?9Kq~KDYQG?`P|DP8Vs>ZASLY%-+x3ySmbbr!$cx1@vj@$DeylHaU(Ppfct4
zUul?LcNR-rn~nZLivBD+E-))iP|L-h8C}Q1)1Gf3C-TFo_=qL1w=Ji)?$(_uty|9h
zXW#}VA#R)b0#%h<uhyzsr?o=or@8HLsAWA5g((}iEUU}{@=o#`W5zp9&O!SRg~1fs
z8bPVAs?v)-=b1rruH`@Su%4OqzZSeK6C%Z;OrV=6J^&Ocl*s#`l^ExVY)yF?mn4uU
zMUn3sQb;D9!bMx3M*Hb&4ELgfG*-s7?dti2uEYbzP=+}v)`m9}1Evy#m(~mUYYLIl
zDbM@|x9;2$?t&s{<ZB6%^*9$B<QE$?7n{r%o81;$f)`tp7uyUQ;UEwvj^U|^nK{(M
W+SLmB;+3<xxxI#iqO}D`^8W#Ve6V8x

literal 193853
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%0A=UM~VscZ-!lAeQDAOaiHc1{hcCkOy{
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
Y<fw~ZgpxlGj0g_C%(!BAF$6gNH!?=6V*mgE

diff --git a/docs/images/aux_pattern.gif b/docs/images/aux_pattern.gif
new file mode 100644
index 0000000000000000000000000000000000000000..b32660eff07ff4bba523bfa1165a538bef7f84ea
GIT binary patch
literal 41374
zcmeHwcUV(dxBf|k009D`0s;m_MMTApWoCk?L=cRQ1w}9l0s<;3BE^!>QIH}kRYQ>u
z(mN7FdJ!AFgbo2hDAHkmJHc_B&-p#~yZ4!y>)bE=HP1}uWS=+Zeb>9z+WRcEg9ns%
zo>PK3K@$)(KR>@}(~haBskyni>FH_tt-E@9dWwpQ>g((4>gpf}`t<3Ok&#hBLBVN#
zV+w^58X8(#TRS*7I66Ao+1c6F*4E$OKRP;Qaf{s0)U0c0QrFOEdj016np&eP*WbK*
z-_zUI)Y7_f<3=?#wTFIzO1o8NW@fatwO^N%-nen2y|asO^ki=z<G_IfM|DUO6BAdh
zZ%<FpjE;?E=h5`d%zgX<kLjHs9vP{sepgUjGQ?ut^YUqJYYT~p-hcQQ$@r4JtNR|c
zL%zPg=S(is>GZgyl;rfxk&)4<>FM_$YdX5R5>nD?>KaPQD`sbBV-u2C!^0nI>mCI>
zHMwS4SW=dhmN7XwIX*to*3s$c=5gx0p}V_#U`SYPeM3)QUukJ+RD6Q5`Hj0y_quy}
zU%q;M-}{lRol{O;ep%%kH}A*Y-Q8W?Jz-HX6>q9PjgRlzuU_BS^f>Sty{(-&#QIQE
zd-IN6M@L6%YwK-Cm-Ou1qSErV_KxWIL_H(Z<7f3RUApAs9~2NAYE5xqGMS|nRRu*Q
zUQhfT?mx)P&1<2z=@?ub8yg!M8ft8AQC2-@W?@AQj~o~rOv%WKjC&Ct6F)pW+|<<6
z+}!LNL~U-R(+UdxsiCQv+2Duc{{1@$$W9?4UhqLh_J`S=fY9?00xd;Ipyu177b%=6
zNeC`*#;#NkBqW9u-WTWHRZ@}|TI_*Sy(e{0w5`Zn{^#g3rAe#G9&XSt3p|*-`k?Rj
z>x`z-pVw49#oO~s-y2@@Hk9yi#kS~_sP_?@{PqT^rz)sLok%um_Q$TPeL;$`5!6T<
zc$;YWKDyG?GOjUwUE`}Djfv2vEUQti933J84UrK6q)lsGG$r*m_deH%vhOJNT&dQ*
z&T|BxN7;f9_Y6f=E<Oaw>tUX}ae5#5bIgf2LdXTmosA@1FZ_tx(u;;pZ7{2?eXW*j
zi=JvGAcdeU=O1g2oG0HCe@W5Us37HFW>12sSY^3lcNoMoe`Q66s-r8+HA#Do3^j)j
z+FVjc?495VlZ1yHZp}-d{?uM9Ap!~N8}pDMIka4%fZzVj#dr7TJds$mPOei`VzIa9
z^1D*wJKmZjf7t8Dx7kGmzZkI<t_rP!+8ixmliToOKO^53prA8GJYsP3_PzIQF~t3<
zl8oB66Q|9oo!*DG*LN<9KW>C0A&kAT{7|n5w3;Bl=^6eE?rM+-)Tx5S?24qrRrkwC
zoLKa8QPe5%BX=gB7@i=BI2$1{Jqs5ZyNTEv!#p#a@joS)>xy1&fe?==vf9Le%Xhk*
zd3_C|`@#cu9gWzBTb;63$lfGe{4oiOJkN8rjAt!r-dl9v#pfw9W2fEv*IE=oa0Bmx
zMb5OSI*iha=w35j<+q6a$u$hK3-gIao&pMJs06=`reciSWVMs%TPvc$`%Glpj9FZ|
zlZ~hF9_1q?{OikLPtR|Dr)?*@t5Z2Zd@}}*7DPO7DSX23XM6d1U$?)f99^QsUKplm
zjB^m>vD`1X@3NKB@%;|;;bNS#R1(j#17S>+^3sHQkxOIdg(5f5oh^`Bh4}z}n=dbU
zu`asZGk@8-!Xn;%OD~PRRWm)3q-mVQQmrQbY+-spvV~}WPRT$CFM8yr^xF^O7ZaQ)
zM0(q&dO?c&TdeY!0C|}*hBDs7AEi0bytdwbV!mZXU*$xr^pxNveF>k|WZT)5@yZ%b
z8<`mgJ=9v#JAG_FSao@veK6H7Bu1a=p*nAv?hSi#dAct$B7T|?o6el>Pbl6nGmvt(
zMGbjYiaNv0nPAQg(Req`vR*H}GCN$d=Edwt#g3ub(dxS*6eQ2FD|4Ufj9$!*H{BeX
zo1i;yoS*D`a%Fz1H{!+o^hXUmZH866@t4`L+AF`zP4>L_Wqx*I=$Bt03>D%f(BMT^
zAoL+Bd}#@dXBUftb)zEJ5c2s?v+Tqxs60DL@`Y@OlxzIKXf?tsQGb?${Gnj}lO?Z~
zWU(BT+=4MigaXM1mXmTtu+Ytt0-0%+^E@6Cf^{amULiT`LO2v6`lRIb>RrRGM7I#J
z2tuL4>EV0Y6(LK~OA0sG4BsbVLdA;-MVphbaDGAu!VOK?W*82`Xp<#+2x<@>_W;s{
z5KYRjx0~=hxE33VE1ZPT$kp&Q36RL#<bgdxBVKy9XlSu0KeP+ZU9d!-|0tFGQy9)u
zP&;(hrl^BjBY<UuP&mt&A|g*h>S%|`EXKiQUyD3giB&-!h$0^f+3cQGu@dnCU3y;h
z>f;nQh;-Vo6rF;D+q~{T+}f#W2&ef~8<1DR>?=+0QDHV)!&cQ!lDDOeJkCXuw<TVr
zERtX3dFMmuM)!k<aSuiwKbUubkgxcBiF%_C$w;>!rzF-`ukiNnGK<(eXjOhNWb-qu
zao1W|Y=zC~V=j-)Aj#uVWZsfRN&;47)YwI}2bN=@{wjtWg%yZiS;@~PeL4;tzo>Q6
z@)(tNrg#5MbyY{615a;a<OmW<htX(RR2jy^kSOVU%<vu6)hz1p@+>l0;fA_IWd$Ow
z^nLtGqPLG3O)gGCEBwKAzm--Bi1CBRD&-fu)0;wfso|@X4<tv&9*R+tt=4pWocvr*
zP!VIqAm~YYM?t>bvKynw1!*^;3d{!18u4lD_>ufL?X@XRu<`KmUEAG-7RMT^X*9g^
zA5V$Yj59e|-cXY@o|@o3A7^Hy(b&*1o|aJ=cR634+%i3$P7{nbch+cXmz>Bb(Tu<L
zq`awHW+Kf5w-+9+(abnKkyTe2Z<$`+%(R)vrVGBXD$Z`+T^F2oKazI&IRSQ{+7iyt
z-6*yeN0}%(`BE$F#qHsleREYyUd~otx&4c6E41!yUJ@#S^2CK+r(l(T&`il}Ii_u;
z`edqDyt&B6fd-7Jm5bEnIOm_FUSpFjU(3x0yPmw?E;eCa7=0=6{!Mhphcc_8ow1ut
zuDEq9V@#&(VO|xyYu11huy)$FA<oM~szC0cW$B?i!4K60y5!T%%R=Ik9-VZ#kZ)pL
zzINamDG$@V=w5w{!G`O1`Q9{r+!|x;VAdTK&?@yxd1wsv*gXE}L`Bb!GgEKK%=NGh
zn<xz@?9gaJO32d6-UGX*-+Des30tGtr>-;o&bP`U%vA}!%Xa!bRVX!5O_OmnVERL(
zR%-OgO2&!o>5mByQe%xY`%gDc*JM<s#^0>$*PEHHr3s}aINxq0L(rFCECLasYzPNA
z1A7X*>BpM7kG1v9t-xyzws&;0hDZJU{8%hjQ!^ddti~2PV~|<b0DNX!c6RpIr}3$&
zX<$Z&hDX{vyMcdgYwv7r>lhvx8yI9Zx6mi2rW%`D+3}wH$3@`#MgW*m7=*_Eff<$M
zr9cYuSlSmeniN+0kYh%@4R|ro<~=k*a(HEcGTV$MN4$9k%;=o8N&yV6`cOf)jBQ56
z1;v#4Q=>n|XeT%Ls2`63X0)KC^WL%8`efq(Z_V<wxW+)!*0P}c+cz|4TO~F;_k&bg
z^2m3Yg>^d;+6r_c9><*$Pt-54M{U1zNaBhC^l+W&9owCw-EVFzZXLs9ZLO=iqZ#w#
z`i9kg9}|K@9%wc)1{yLxrWpqAN*@Y-vK~LFxu>_Qy#zI+RdvR?w!7L|#zRY&KE`<a
zLjOwqZQE;6B2tRSqz=E#nHueVzsN_40w<%E@svC}ocD5WW^%N@^-W$LumU{t)H|51
z5FY=Veqe!q<U+C>{g|Ad%Pw!tDr*@Un;f5<o}HU7tLc8%+}GMOIx{=>p>=RUOXlY0
zr)K5~-gSace54Px^^HzU&oy_C<X5*Byzi>-93C2(WQ|T1e&_)jQ{T=kdfzcVHT|}+
z7YNMM^jukOZ{ho{uEFu~$(ir_k>alIKL`P~ekfZ}DdcaH+5OHE`;;Mwo{vT&_JU;g
zi+&_MFMpz>AMTJqu|psh37LP<4{7z3NOm%-u%17}9){qv*Z`7Qj(%L*mw<;Ii#lC!
zPg)~Q@o>CesJ|}I4;`v;-pe43^bIu`CWDOT@}-wgX5K~!#NS^!Kre79UNT=#R%tKx
z^w=<7ubk9X{^Od7ShvjN3zd6z+RC_#k7>OP`*~tprAR8H*5Q}#<^l1vOIfk7jF*+!
zX3XYXd($~xos8kOB*AAJ?&Me>Z?6jdxl-EBeysoCb^X>2J9kbDsi$7GU;eCq_tdCL
zVd$C{cYc^0XJ!_!KbOCc@;m*YlaWh|>6Bk?(^XJB77j2z_&)hI2eA{zZI0rGk!?;=
zmc4DxI49pWlqizsg%Ckf+wUo+^|s$vDw6MT+gfAX;jY{rxzb(OObq**2nj=np*(0M
zM}%Bc`+yFOPt8`feqw!^ZDC9Ty<vTtnVp?Welr|W$Q&4%PN`-+FB(`-BcM{l<1;{z
zCZ=aw8IyyfGpW_X)3fsvQ?ng|Q|$wj(=&6iWvqk>X7|w4qnv^8qQT+u+0lvFM>&Jz
zQ{b9Ik8%e_#%EglCm-hw0L2O`WafStc1`Jf_G++icp4~Q|HyP(|77RjWFTz-XjsqC
zluyn;Xd$zpe)M7XKv)qorFuA_l9gIL^t@=WnhriN{b_RcP3x!sAo_4`_0K?nV`7xa
zlvm_GsHh3AB`M>ucn8=HJFNJ>icnc#rgw?6tO$~ydIX_HW}BEVBD7#))NV!+yw2h7
zEm7QM(p;9xF)?frVw;%qX%-px3dXn8Dh!BFJTNh%mIJWYd+iWtNyTc73}9khG8N2e
z^egmy*OeMi4`ueZ7m-mXTPiZQw3I*CW-Ftam2$G$Pc}fW(tiu1I8MJ@YxeZm3AC_b
ze~WHfnn_%SwZQUt->bc?()NqaZfLrBva2Gr+_GwM)>wadRBM%c?(U0&w9JpT%kv~|
zT^sIvueN<-b=LHRV?DxLIB#BeYHYCo@crd;^S>CC8Wr$EOT?*Hqa-3px+Cj*N!o%x
z%AdRHo4>uy@$7z=HV4VelQ<LeE_#~_d@a`QEUz0CfnFg-{}&PJc(7-@H`HA;ho!0m
z9l|;At-(KMSJe7C9}=_hdwC^^xN4Y0NdjBw`nsNwoYr>x8a%$(?PnYw)$MPVw$l)`
zg+|<~b+Sl_0$FuO^*p^b-q-Vt%%jjtby#B38|(t#1>=>1VHbo>3_Kr-LXZ}e52}0Y
zYz+v@?A+Yw#0+z6);4YcNL+sH$ouwBx8esthXDv$O!*ivVSU3>e)%I$at9)chkyhv
zh#t^1AX&qoX2vFGZ^aKXhNoNlCV*x#N2fn@d;-$f&16eobjgrk-e6Pj#Ms2_tGdys
z5>`^xuxlFAHGQbAYuq-TEqAqD<BxJ#{&|BL??$3aSwM0_3R$k{tgynN!iKR|wIe|B
zJhPY)rKA3|VV5)}oiX8`KjM-$RMapQT{b-QY3^P+tG;`@V{o#uXZ+6~0rwjJ_Yq(V
z9r_p!_eXBa1ulkeio`*@0!uM2-?*)^eb)JKXMRcE6B+cCF0P1gg^uXno{^YOvkQc&
zdse?)sp^CzaoiSL=-x-O-Bx3|dAT9v{mRi1g0Hi{=j(^I=8+KsGKV-qw`iSSh4Qe_
zGNE_{ZED+Vk0ReKra<VDd)zSx$i`Gsl091Z#~8iJtW;AP21meMlKj-)m~p*-iIlBn
zA1dPKAsMY4<(`%lO5^sboXqPjNe_ANYUO5K?aYhNX{~DBHs0{+m-(Z<)wwxSuUj8E
zPwbx0nVCokH9EWD>7Lmc=6ll@9(i}I=f)C^p4~+r<)zy!OFc=qtCSY^wZj}x4zwq$
z$hSGBA1PVxBxSQ^xs|X`U7O3(i}E;Ec}v6db}Pbr+t07#_fZwtScC3xX4FT98g63t
zhMxOjUfzJDB6Kkfzh7pjfw%g+?^B-5xVla+3{A=ZfK4I(H5U1YLU*bgv(bf`e;h)S
z^Lh40()PmsRp?en_lCF$okj?%VaQ7%=~JYAA~HB?UwEJ;qc4K$q`-&_du+mpiVTld
zh?I%NzCx)eUlpVAiepIqaT(pw{qZ^DjQ$rio^=BWua}s{z7W5K#cN54$kCFk53CzZ
z`EbH?FtyGwW-zVEvVSnW?s3|YuQFIk=rja}1UZ`ef1fzqJLDqp|3LsP05p};j<tiq
zeoL-Ip(9Wxv>fnbdXhOjVH?+fD{dgBbl5MCH9bCNa`B>vyIW~dp-bwZwbf16bf&7R
zDzFH^h1^SHh7=CDrVV*!4UUhnW+%t}X{<*%OyCkCidatr1N`%tL&FoS5wJOe`^QD#
zdq)6xjy3XDO4M(+E38mO32le!e%r3_YlY|3W_#3QCC+w*aLoru{-%Wr&+_YVPIBeB
z*8^0DeGK1)6GPQeQx>4YqaJg<x$IHI2`^rZg|x<!s46eCD1_EYyVUqXT4XD+ye3XJ
z-W*2MCgTQAC*DNpRF=QJqMPp$AlhOqZr)z3wiIEE$-H)?)MvfvxT{}$M<vzNa(-D>
z%KPM1!U1}5M>nf|jMaZ)k$XfHRi9xLT2;Aw^<WDviYcUZ=H_rmk=MGVFLSJmTdS@v
zBGY8apZe>PO<SvSvnPh=1*`5a2Nh!LA?Xby5{{ZXGr{U8|GGka_cosh68U@K$YKk}
zEUWKUEMuUz&nBiXx{%?U(+|>-$$>5tBf|%-P9=F+&dH2NnSCJJu#M>h35Q<}1BeJn
zDQsi=27CKJL1nDB&FaQ=kZQOlGeQamT~i02zhe014tQn`Of!3eo;-{$VKRFet|<(V
zL%5_2eD9AEcYXg!2ms;uLGh1TOI~eug5tP86b^4yM<K-p;iwFd;@cxnUT7`dkt2~K
zs@bJs)WHwE?;?ny@5~g~rQsD(KsdHV*Tj<w;B)Gt`LIOe_fB#Gn<;R}@MGDd@)~_R
z^p%dP=4ENj0|HA$GaPLnzi5lQvs<XfHY4%FYpJD6Ee~0*?R58EXR2i*f$y%Q7B5*f
zwKJtJAV}kx-umP%YDKa7F&4QZX#<U`E+U{|So%;?=v{$llD9I3A7y#0YxTV~HQZh0
ztm-juyX!_1QqF*iqjH2}3r9HEt)-Z=Z(iQE7Qsk5h;KSa{(WnSQyRwI74o6N_&)m&
zLGY9)e(@hO9UuFfYHvmN*hF{xW^_j7wOuqgH_`gm-QiAgT8wRUcXV-oa6ZE|q02e3
z8wg0C=e_5-bid3lm&9J5ln%f2cB`wGMw_Z`#q@Y)FqloX(Rpoy&9zf)?}2W(CiOTc
zbpIzkmE3#%hamuDWQ#Hl_lN!iE2Hp-GP2nY`J4Y(hW^!m2=pR39VVRP3Q*j=sQFwg
zR6R&iQ~`9T{Z3bwrJBBpTPY~TQcpAc7`#G64#L&M>ZFr?SYefrHrSZ0+i^LE1f!fz
z(;w!48J*s7HrsyD?)4SJ=A=STugxvJ%1IYOAHt5ktf)8Yt_)IboINv<*!zCdmh1c6
zvQpJQE<2U|R9AF6gqAk$k9W6BANr7cSK#nP+l*oNLJ#4?@v}QdyR)CEM(9#u&d^u>
zL*Z8$$v34Y(CzJD|KdN`9qNV%8WQu_gmBbD7G(Emc6JZc<Ei(3#)o2{06+)w6C!|a
z)D>m|p&*?(ZEthq$YCuYBSBvG?on(%zDkb@eE2dxEGIT3H9Y7a_MmW=%SGTD1kjr7
z>|PrOK`=h7qB7AOg7H8+;=Wis1cSi^w?<lR3blt2Vp5PfDZkjBk59f%St$gL#x0lG
zipwV*MDiiU%+{K(Is9z>@_lGD$L4c-5^KI<n9=#Ou}>cZN&#X4ssWw>N&&(Fs$C%I
znHd=Xs`))|KC5%;oAq)31s8#THUel3Hp9?32txAkV3f!>JRlZwH5N;U@)0~@`=sP?
zDr9#Ettd}CLZYCM{Nai;+IbZuQYuW$Sc$UNQG!osYh*I%FeC_vbNI!HU>g9xP@f|h
z;L*Fh6hJ6?1ugk`AmG|R8#3<dxd{B*2%uL0eqnHU9AwACCnT=zdG3`Huj~o~WgMB}
zDzaQs5s$-hXd?+OskrH@umnPp&GjqYZ(oCe1R_vs_|ph~@4?zKVEI6x`nMOr{U8^C
ze;xwpE$pzQjHl5cBwS2PoQj7z@+_89@-&w%xW}_`?;aPgjsxyXV7OUjES_K|p|L{w
z^Oh4%_}Kw?#A%O$1nQr6^V}745%`l3__jUDi8IPy#hLn|ED&m(?^uJV0^-a<Dg<JV
zgRLcSZXnu#G6P76Kpymh>Pxn|-c|kD*WKCX`sF`qiQLO@5%^z208Qk?85{(`1%woF
zL?Q%-L6SHEmP)asK>U)PL^?=_P>XNvDItfz5pa~UFO~+WLqf7h935Ig@#Yb+L0-h_
z7d;ghm`1X2d-1=SxgWnG8O7QH5DVl$t>t;3(y&m)10-AER(@hca#%p`yP}4oY``r$
zn;U_iu7G)fbN_3|aKD&~z@LNwT8m9G0*;JFp!ntGmGNW<LWn9V8PnS!BnG39Ais$Q
z2*^)RCbIDRUBnT}zUFu;gqB&Jf+XSW^6&Erib)ZwafhMZcei6d`#f2&IK_Q{V!xId
zKp782Fc7H#(LlKl#56!3K(s&UCb*a3BJlkpfL;wKhQyL^Dlh~BLvSII@*M=ER}cs|
zSqQ<4++$&EzLE_8+@a=BhwxQ&N_idxNCT(?A`*yBfI1*jE!aU&a{z&;GCSdc!yR9D
zClIgh-n<5g74ql-ms{WO^T1u%zl{Kzz>ZGxI8Xr>;FnV(vLFh0%?*}FGN;1eq6+*z
zgd<c662&7Xg{GZDxWm`r(Igz)&RbYYe4jS1li&?q_WrQb9I_|>)?U*3id+lrCBP=Y
z7eFq+pap&b5`lCJ@C%R*#H;+o@cxe_?Ung}hJbPZ_VT$O<Rb9>B7jz7lMA$$$OwLZ
zF&q&~fndCgFlZ>B22q3&dlFo{@MMJOZXR=*2pRGaP&brfVIeq=2u8@0>KUwJ2fxz(
z;b4NwLRuvcZdCF3SKP{p4FzNZ#0q=j31|eU0~iKEnU^yK&?~^h1uzLP544|NB}P&o
zx_!SuaaYDg;J=B$0=Eb_5V&}Sl#Gc)P^sYM72B$Wrxu`K@~4k^f~M0w2x(q{K5C%m
zE-OH?K)=Pq&^)|yXSB_6D)!r9A1bD3pSiUGe7mB~SNW8O<K61qB)}fPFwlHjC|>}o
zfeOZdbD`Xia}oH5A;8I}#IOr(TTyXw5~S+PyKM6r@nJ|6m_uAni3r~A*L;doQr832
z;kKOqVLvl>xqm(a-?p4M^@g)w**0?%BUXI{h$X<Vfl34LY*ZgN;NSlI#c;34Mc_L_
z0KJ)=5{ZMY4KO4mCZ<fozp_JNG5E-8T!Hfv81al%V!Mjl@*gZam5Bxiy%EA<pEs^@
zb~ar2ibhY|oJ!N<0DAzFfIR~~4R8qXDfICJKrD~|0rLhjq=w?`7r}lY6UvMZ{?4%A
zE{BW2{}6$N?1x>pLm@;J<c;ZM7=&4}RY@6}PeF>IB(+(%l@J`oFQkZv$OH%_gj2fc
zi9bj|N#F^-*bcm%%(-qP{nv&qr?OxQxW)H*(<(Tk1rBNfZUGK`;TB*OpqjBh36KoX
z3!K#g6+Eyn9Gu4bAKnG`f8!$X{ULxp#HreWS7t&2LKty#5=8}cZqbK`G*I|P3(2GL
zWD<BcH=igtQyqp!V0QU$rPI&n+aqNx#EduPzjBlm77dHK9#I-3i2Ho5iBn#<_EnAq
zDD?f^ICn){1pW>L&_Wy!NTRCPqlDp~{T(L;eWA!g00OZFL>X>;`8$3T?st4o2%tqE
z1ca3*(rETbVaY?v<j*f~<`fgYumtSy<_41Q>1X4v<!?pc4+9COP+$h>fXPLCoHOKq
z>yo%%#zo+JLI5qy_FBIV?Aj;3@MhXC#Wdc}3I9S(8UzziivFIK&s_@_fxjF9^hz+)
z4#Im<X?8rkEB0g%&#5>GORwIChT2~{iLHm@l*s27w%~Ah!|rwdS}0rCCIB`FaQ6lL
z<v$bm3%)Z1&}$$R62d3oAPSGbibGcBxB^E$SxKMB>T~<<FWPj%pw4q81tx{~>dgpW
zZ?OT*8L)8;Y*qt1)wp}qzO&z!yPUrk0T6T8+#%vrAW%sbCzyksHA2D%j!m*?1rF$q
zKW-(`NeeNDv%lu+ZJ&Sb!njxGBJdp}0A8*8RXzg-5T7d`e|_@cx3nK5GYhRt(6<C_
z%<uS~xJ%<A@FydH7U%RZagYiHA++RJi6?n4j9)<M*ysG8(`;cM)8XvdTsQy+&f<JI
z=msbQ4!VI;Zh!K!xR>K1@ckhG$ii;6fJ4|23MC4eLwE`Wi;@)o`kgvo$g<FL;YOD4
z?`Pz$=<h%Py%<CmBo?AUb_hNQ3sGq_XYgu}-#pl15LS?%%gQcyt!rPicaSB9_;<c3
z0Ncm@jwN!xgNwj-fB<?K7*CA_r)a=77v9x-BC)}$jtGoWpl<?1S;$#<!73Gxd{s^c
zFTuHKZnkhV0PMaD_w!oV(>zpH{vF&9cL`hs{z3#6-g<}zJ6*sGQn5Yq=Ipl~!f?t;
zxVF6xSc&ZwF2n8k`yxMG6YKLL9ki3xlq7t1XdE8>Hgux9zQ486Cb|bqjbPN4yE~GL
zGvckTU9Kz6_08;#qIHb6z60cnrTT*X%e@~<Z(h9wjtAJ=-ZV45a4V+Q_koLTbdPgl
z&rstVW^1EsQg1Y^<N3?>aQ}zFuNcwA1FnhPKB*mpEsZWoeSVqU4W%zVGy1_k=+sCm
zm`dT7(fJo*#Jw~Zf&U5tFmyum3>AOw4+d=(I*M%wBf_Ym#U41--;FizIw&M}rY!Ja
za(HEc@(-5@o(r>UoQ~0c=8QGJCl{R(^*&;U-(E1*oI!{>k!*6~-VHEO_@`{U{d{ft
zb;-CwCq)u<C5#ud0tY3~Ap{Ta5(hbRGF}ZS(q4rk(l0l9kR_B^*=d(frFg<3=d?2}
z>6W9=TaBv|p&pMbOA++`T6{~T#VSm=Ej8|9u8)NB_GME81~sU<2h7GP^Ws_=SSbAx
z6(YQey=~v!oOqd8pL%KOs;B^qo;T9V#Cb2~s-QAL1n155sHf#v9o3=sxr0Y`Ol6W2
zSNhVdGF#yxB82KjJWDU5EcMA#8@<HZ03CB_T>d%ap#=Zi4!3J?@DknC-j2O6mN*5a
zwZr@J^4uN%2$;=>AO~I_I?1vz&M}BA`K~DV1dpiUDbvu!2@rhEo)YORqf^gY;fpa&
zfjaB%`L;Q2F+2|Dl)9d%)3sV}-g((=f8R;nn-V)@A=gqKvZaq;ox$;KHAS6%$DT{n
z`<w0UT5TXr!mja`X^Dymv}X1h9lbukHd2!!WD=?2C=+e0?z({?f6)C$g+4WYGHx&A
zYZ(3QpiMh}74&jr5(Sb<C{pN;O{p>Y-Js0|lYF$y=iTVPm&>_f1{m4}rhN_eG6vcj
z*yFuu+159%H&mBL7xsVZYX`%>fLz9fhmiDi8LjnJ7T1mtiS~DIUotWF^YLW%ff-)?
zez}bB0)}5s|D#Ms`imGa9W17>e_`_1P#?oNxxeXM1sMJXrhuK*Ju}?Z8bJ*LgTTPp
zFE9n{zj~gz|DB7#Ux)yZ%OmDke8M*~0=>?mMVCUxP2bE2lyg1zy6nlqjKJ<9AptW6
zdq&`4558;jQtTN$9xC6=2-H}Z5m*zyN_G#Vk=Ak21BEe`qm#iX0Z2@WM5B}89!Mc<
zwF}NpCj;WIK3<-<5y5NwHhQs6+9q<c6e{M??o7~T7u>p}q{3_cdB}P~GU5KtcqHwr
zaHRC@9h>b7^`##=24>+;SKDk`R8wN3-zu0XDAt>?^Aocwb6Z)epw75iu<RA*nu=5U
z_HEJ;JE+y;$&?Cyt@*nHnmL)H@hLl6goM+t+(0f8UD>Kb-vZ~mxoozuaXiCjwCB>J
zr<YArZ;+7=B1$lmQB;wi9a>DSUTx81UPvFtkCrB+UwtiOEHs(!WhpF!du3O1&iTZR
zUv$NFoK6ag*BL}pPLSbf9~#LrGe5odHa`*4zG@mg8SE(j%J`9+wB)!S$>QU4$SY%2
zcc<R9x7(x~An|cYsCGXO)%$3vypFfQfeYdK#^LoJ{M~~{b^#YI6MBNKG`RLWJ&<48
z^K8o$UoUkXpL%cbYKeQjA+oDHVWFNyK4jj-7*gN!Z{;#N0%uIML%~uQjF_e0$mMBM
z{^g&QlGA%-8%xemL@>d9VQ@Q`lsY&#=;7f}T3TvtZ4IWjH#RmdjBFntA7_hYTpWo+
zva+)3@9#fy<cNcV!=+1?z|?kse}6D&bzw$37{LyPvV)22U}|D|dODbt7!eTxX0d}Q
z><i=A!TfbFg?(gXWMK;X*|TTC*!AY-=7m}8U}_>5#16)>|Ao}xUYd)*R|v3;WmqKf
zkB#NxGiN5raPl|C^0|i3s(mR|3&!#~W7Y*{Zx_Uw;C@Wb4)xQ0Fikb3uO#$fkb02%
zr_~>#wUbTOTeFSjv1~hO4a>;7Bn8=h`10+Y^<F59l^lyoaX>=iQpVN5VR`|{WclLl
zbaNnn)+2!=b9-L<{Y5BhTHFQbimJlnm?zg^a3LuxMVzFZZV3bz-cH|P(Zc64D&tu`
zy|JXyr&iA}pgyz({_wbm;XvYe@hcf5LWzh^?yXwsIP)WP=5klFv2E+)bwOJRyp^i+
z{5MI#8%z*y&UtK&ug|(XV32w@umXR(?HwdabTK<^4g0`%i1h^F3_G#(YGW7A*;6Be
zJ5K8I9-@iE#9r65l3Jdh2)<eE`r({i?RxYHdso>>Nj(d{$+uR|QAK+lWhiP#op3ML
zgq)Onw?oGSrQ}KGUve)Z@QyvIgp6`|OOVz3ggO;sx8u&EmHH2Y!^O|u-b4+%HYMTY
zuXk%(y1|qCFkHti=Ki&-j+)qsoe$9V%4iHQcPcat!UYnIPF!R5tvPager>N7+gNI{
zjim<LSgNy)<<B>@OrkW<771_+%;H}sxHF<-(@vY9S4xtw1w2ydKb+uh_Cn5$wRd61
z3g?iD_OIPVpqgJjL)?GlBJiJuz_)LN;mlzB!Vh2(fKdRkA4K~9EM&NM%S8Z!zzG%5
reJ7Yx^X<@r{G6uy{9?^>1{ZKQFIpJme%8Ns;lkx(SJW;VLc9MTJW%#<

literal 0
HcmV?d00001

diff --git a/docs/index.html b/docs/index.html
index 478199b..780d285 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -711,8 +713,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -723,8 +737,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -930,7 +944,7 @@ Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi
 <div style="display:block;height:425px;">
 <img style="float:left;width:380px;" src="./images/aux_json.png">
 <img style="float:left;margin-top:200px;margin-left:10px;margin-right:10px;width:32px;" src="./images/arrow_right.png">
-<img style="float:left;width:240px" src="./images/AutoConnectAux.gif">
+<span style="float:left;width:242px;height:425px;border:1px solid lightgrey;"><img data-gifffer="./images/aux_ov.gif" data-gifffer-width="240" data-gifffer-height="423" /></span>
 </div>
 
 <h2 id="installation">Installation<a class="headerlink" href="#installation" title="Permanent link">&para;</a></h2>
diff --git a/docs/js/gifffer.min.js b/docs/js/gifffer.min.js
index 4f979ff..c46ec7d 100644
--- a/docs/js/gifffer.min.js
+++ b/docs/js/gifffer.min.js
@@ -1 +1 @@
-(function webpackUniversalModuleDefinition(root,factory){if(typeof exports==="object"&&typeof module==="object")module.exports=factory();else if(typeof define==="function"&&define.amd)define("Gifffer",[],factory);else if(typeof exports==="object")exports["Gifffer"]=factory();else root["Gifffer"]=factory()})(this,function(){var d=document;var playSize=60;var Gifffer=function(options){var images,i=0,gifs=[];images=d.querySelectorAll("[data-gifffer]");for(;i<images.length;++i)process(images[i],gifs,options);return gifs};function formatUnit(v){return v+(v.toString().indexOf("%")>0?"":"px")}function parseStyles(styles){var stylesStr="";for(prop in styles)stylesStr+=prop+":"+styles[prop]+";";return stylesStr}function createContainer(w,h,el,altText,opts){var alt;var con=d.createElement("BUTTON");var cls=el.getAttribute("class");var id=el.getAttribute("id");var playButtonStyles=opts&&opts.playButtonStyles?parseStyles(opts.playButtonStyles):["width:"+playSize+"px","height:"+playSize+"px","border-radius:"+playSize/2+"px","background:rgba(0, 0, 0, 0.3)","position:absolute","top:50%","left:50%","margin:-"+playSize/2+"px"].join(";");var playButtonIconStyles=opts&&opts.playButtonIconStyles?parseStyles(opts.playButtonIconStyles):["width: 0","height: 0","border-top: 14px solid transparent","border-bottom: 14px solid transparent","border-left: 14px solid rgba(0, 0, 0, 0.5)","position: absolute","left: 26px","top: 16px"].join(";");cls?con.setAttribute("class",el.getAttribute("class")):null;id?con.setAttribute("id",el.getAttribute("id")):null;con.setAttribute("style","position:relative;cursor:pointer;background:none;border:none;padding:0;");con.setAttribute("aria-hidden","true");var play=d.createElement("DIV");play.setAttribute("class","gifffer-play-button");play.setAttribute("style",playButtonStyles);var trngl=d.createElement("DIV");trngl.setAttribute("style",playButtonIconStyles);play.appendChild(trngl);if(altText){alt=d.createElement("p");alt.setAttribute("class","gifffer-alt");alt.setAttribute("style","border:0;clip:rect(0 0 0 0);height:1px;overflow:hidden;padding:0;position:absolute;width:1px;");alt.innerText=altText+", image"}con.appendChild(play);el.parentNode.replaceChild(con,el);altText?con.parentNode.insertBefore(alt,con.nextSibling):null;return{c:con,p:play}}function calculatePercentageDim(el,w,h,wOrig,hOrig){var parentDimW=el.parentNode.offsetWidth;var parentDimH=el.parentNode.offsetHeight;var ratio=wOrig/hOrig;if(w.toString().indexOf("%")>0){w=parseInt(w.toString().replace("%",""));w=w/100*parentDimW;h=w/ratio}else if(h.toString().indexOf("%")>0){h=parseInt(h.toString().replace("%",""));h=h/100*parentDimW;w=h*ratio}return{w:w,h:h}}function process(el,gifs,options){var url,con,c,w,h,duration,play,gif,playing=false,cc,isC,durationTimeout,dims,altText;url=el.getAttribute("data-gifffer");w=el.getAttribute("data-gifffer-width");h=el.getAttribute("data-gifffer-height");duration=el.getAttribute("data-gifffer-duration");altText=el.getAttribute("data-gifffer-alt");el.style.display="block";c=document.createElement("canvas");isC=!!(c.getContext&&c.getContext("2d"));if(w&&h&&isC)cc=createContainer(w,h,el,altText,options);el.onload=function(){if(!isC)return;w=w||el.width;h=h||el.height;if(!cc)cc=createContainer(w,h,el,altText,options);con=cc.c;play=cc.p;dims=calculatePercentageDim(con,w,h,el.width,el.height);gifs.push(con);con.addEventListener("click",function(){clearTimeout(durationTimeout);if(!playing){playing=true;gif=document.createElement("IMG");gif.setAttribute("style","width:100%;height:100%;");gif.setAttribute("data-uri",Math.floor(Math.random()*1e5)+1);setTimeout(function(){gif.src=url},0);con.removeChild(play);con.removeChild(c);con.appendChild(gif);if(parseInt(duration)>0){durationTimeout=setTimeout(function(){playing=false;con.appendChild(play);con.removeChild(gif);con.appendChild(c);gif=null},duration)}}else{playing=false;con.appendChild(play);con.removeChild(gif);con.appendChild(c);gif=null}});c.width=dims.w;c.height=dims.h;c.getContext("2d").drawImage(el,0,0,dims.w,dims.h);con.appendChild(c);con.setAttribute("style","position:relative;cursor:pointer;width:"+dims.w+"px;height:"+dims.h+"px;background:none;border:none;padding:0;");c.style.width="100%";c.style.height="100%";if(w.toString().indexOf("%")>0&&h.toString().indexOf("%")>0){con.style.width=w;con.style.height=h}else if(w.toString().indexOf("%")>0){con.style.width=w;con.style.height="inherit"}else if(h.toString().indexOf("%")>0){con.style.width="inherit";con.style.height=h}else{con.style.width=dims.w+"px";con.style.height=dims.h+"px"}};el.src=url}return Gifffer});
\ No newline at end of file
+(function webpackUniversalModuleDefinition(root,factory){if(typeof exports==="object"&&typeof module==="object")module.exports=factory();else if(typeof define==="function"&&define.amd)define("Gifffer",[],factory);else if(typeof exports==="object")exports["Gifffer"]=factory();else root["Gifffer"]=factory()})(this,function(){if(typeof window==="undefined"||typeof document==="undefined"){return}var d=document;var playSize=60;var Gifffer=function(options){var images,i=0,gifs=[];images=d.querySelectorAll("[data-gifffer]");for(;i<images.length;++i)process(images[i],gifs,options);return gifs};function formatUnit(v){return v+(v.toString().indexOf("%")>0?"":"px")}function parseStyles(styles){var stylesStr="";for(prop in styles)stylesStr+=prop+":"+styles[prop]+";";return stylesStr}function createContainer(w,h,el,altText,opts){var alt;var con=d.createElement("BUTTON");var cls=el.getAttribute("class");var id=el.getAttribute("id");var playButtonStyles=opts&&opts.playButtonStyles?parseStyles(opts.playButtonStyles):["width:"+playSize+"px","height:"+playSize+"px","border-radius:"+playSize/2+"px","background:rgba(0, 0, 0, 0.3)","position:absolute","top:50%","left:50%","margin:-"+playSize/2+"px"].join(";");var playButtonIconStyles=opts&&opts.playButtonIconStyles?parseStyles(opts.playButtonIconStyles):["width: 0","height: 0","border-top: 14px solid transparent","border-bottom: 14px solid transparent","border-left: 14px solid rgba(0, 0, 0, 0.5)","position: absolute","left: 26px","top: 16px"].join(";");cls?con.setAttribute("class",el.getAttribute("class")):null;id?con.setAttribute("id",el.getAttribute("id")):null;con.setAttribute("style","position:relative;cursor:pointer;background:none;border:none;padding:0;");con.setAttribute("aria-hidden","true");var play=d.createElement("DIV");play.setAttribute("class","gifffer-play-button");play.setAttribute("style",playButtonStyles);var trngl=d.createElement("DIV");trngl.setAttribute("style",playButtonIconStyles);play.appendChild(trngl);if(altText){alt=d.createElement("p");alt.setAttribute("class","gifffer-alt");alt.setAttribute("style","border:0;clip:rect(0 0 0 0);height:1px;overflow:hidden;padding:0;position:absolute;width:1px;");alt.innerText=altText+", image"}con.appendChild(play);el.parentNode.replaceChild(con,el);altText?con.parentNode.insertBefore(alt,con.nextSibling):null;return{c:con,p:play}}function calculatePercentageDim(el,w,h,wOrig,hOrig){var parentDimW=el.parentNode.offsetWidth;var parentDimH=el.parentNode.offsetHeight;var ratio=wOrig/hOrig;if(w.toString().indexOf("%")>0){w=parseInt(w.toString().replace("%",""));w=w/100*parentDimW;h=w/ratio}else if(h.toString().indexOf("%")>0){h=parseInt(h.toString().replace("%",""));h=h/100*parentDimW;w=h*ratio}return{w:w,h:h}}function process(el,gifs,options){var url,con,c,w,h,duration,play,gif,playing=false,cc,isC,durationTimeout,dims,altText;url=el.getAttribute("data-gifffer");w=el.getAttribute("data-gifffer-width");h=el.getAttribute("data-gifffer-height");duration=el.getAttribute("data-gifffer-duration");altText=el.getAttribute("data-gifffer-alt");el.style.display="block";c=document.createElement("canvas");isC=!!(c.getContext&&c.getContext("2d"));if(w&&h&&isC)cc=createContainer(w,h,el,altText,options);el.onload=function(){if(!isC)return;w=w||el.width;h=h||el.height;if(!cc)cc=createContainer(w,h,el,altText,options);con=cc.c;play=cc.p;dims=calculatePercentageDim(con,w,h,el.width,el.height);gifs.push(con);con.addEventListener("click",function(){clearTimeout(durationTimeout);if(!playing){playing=true;gif=document.createElement("IMG");gif.setAttribute("style","width:100%;height:100%;");gif.setAttribute("data-uri",Math.floor(Math.random()*1e5)+1);setTimeout(function(){gif.src=url},0);con.removeChild(play);con.removeChild(c);con.appendChild(gif);if(parseInt(duration)>0){durationTimeout=setTimeout(function(){playing=false;con.appendChild(play);con.removeChild(gif);con.appendChild(c);gif=null},duration)}}else{playing=false;con.appendChild(play);con.removeChild(gif);con.appendChild(c);gif=null}});c.width=dims.w;c.height=dims.h;c.getContext("2d").drawImage(el,0,0,dims.w,dims.h);con.appendChild(c);con.setAttribute("style","position:relative;cursor:pointer;width:"+dims.w+"px;height:"+dims.h+"px;background:none;border:none;padding:0;");c.style.width="100%";c.style.height="100%";if(w.toString().indexOf("%")>0&&h.toString().indexOf("%")>0){con.style.width=w;con.style.height=h}else if(w.toString().indexOf("%")>0){con.style.width=w;con.style.height="inherit"}else if(h.toString().indexOf("%")>0){con.style.width="inherit";con.style.height=h}else{con.style.width=dims.w+"px";con.style.height=dims.h+"px"}};el.src=url}return Gifffer});
\ No newline at end of file
diff --git a/docs/license.html b/docs/license.html
index a076511..9e8e8d8 100644
--- a/docs/license.html
+++ b/docs/license.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -574,8 +576,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -586,8 +600,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
diff --git a/docs/menu.html b/docs/menu.html
index 3e7a6a4..6792b06 100644
--- a/docs/menu.html
+++ b/docs/menu.html
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -668,8 +670,20 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
     </a>
   </li>
 
@@ -680,8 +694,8 @@
 
 
   <li class="md-nav__item">
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link">
-      Constucting menu
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
     </a>
   </li>
 
@@ -874,11 +888,11 @@ Enter SSID and Passphrase and tap "<strong>apply</strong>" to starts WiFi connec
 
 <p>You can change the HOME path using the AutoConnect API. The <a href="api.html#home"><strong>AutoConnect::home</strong></a> function sets the URI as a link of the HOME item of the AutoConnect menu.</p>
 <h2 id="extend-autoconnect-menu-with-your-sketches"><i class="fa fa-bars"></i> Extend AutoConnect menu with your sketches<a class="headerlink" href="#extend-autoconnect-menu-with-your-sketches" title="Permanent link">&para;</a></h2>
-<p>The AutoConnect menu can contain custom items of your own sketch. It works for the custom Web pages by <a href="acintro.html">AutoConnectAux</a>, addition to the request handler for ESP8266WebServer class that is registered by the ESP8266WebServer::on function or WebServer::on for ESP32. That is, you can make it as a menu item to invoke a legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as <a href="https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer/examples/FSBrowser">FSBrowser</a> to the AutoConnect menu item. It adds Edit and List items with little modification of the legacy sketch code.</p>
+<p>The AutoConnect menu can contain HTML pages of your sketch as custom items. It works for HTML pages implemented by <strong>ESP8266WebServer::on</strong> handler or <strong>WebServer::on</strong> handler for ESP32. That is, you can make it as menu items to invoke the legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as <a href="https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer/examples/FSBrowser">FSBrowser</a> to the AutoConnect menu item. It adds Edit and List items with little modification of the legacy sketch code.</p>
 <div style="float:left;width:auto;height:420px;"><img style="width:auto;height:420px;" src="./images/fsbmenu.png"></div>
 
 <p><img style="margin-left:70px;width:auto;height:420px;" src="./images/fsbmenu_expand.png"></p>
-<p>The procedure to extend the AutoConnect menu is described in the <a href="advancedusage.html#cast-items-of-your-sketch-own-into-the-autoccnnect-menu">Advanced usage section</a>.</p>
+<p>You can extend the AutoConnect menu to match legacy sketches and according to the procedure described in the <a href="advancedusage.html#cast-the-legacy-html-pages-as-the-add-on-menu-items">Advanced Usage section</a>.</p>
                 
                   
                 
diff --git a/docs/menuize.html b/docs/menuize.html
index a253863..d8f40c0 100644
--- a/docs/menuize.html
+++ b/docs/menuize.html
@@ -42,7 +42,7 @@
     
     
       
-        <title>Constucting menu - AutoConnect for ESP8266/ESP32</title>
+        <title>Constucting the menu - AutoConnect for ESP8266/ESP32</title>
       
     
     
@@ -73,6 +73,8 @@
     
       <link rel="stylesheet" href="css/extra.css">
     
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
     
       
         <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
@@ -141,7 +143,7 @@
                 AutoConnect for ESP8266/ESP32
               </span>
               <span class="md-header-nav__topic">
-                Constucting menu
+                Constucting the menu
               </span>
             
           
@@ -582,8 +584,8 @@
 
 
   <li class="md-nav__item">
-    <a href="datatips.md" title="Tips for data retrieval" class="md-nav__link">
-      Tips for data retrieval
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
     </a>
   </li>
 
@@ -601,11 +603,11 @@
     
     
       <label class="md-nav__link md-nav__link--active" for="__toc">
-        Constucting menu
+        Constucting the menu
       </label>
     
-    <a href="menuize.html" title="Constucting menu" class="md-nav__link md-nav__link--active">
-      Constucting menu
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link md-nav__link--active">
+      Constucting the menu
     </a>
     
       
@@ -648,6 +650,18 @@
   </li>
 
         
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link">
+      Custom Web pages w/o JSON
+    </a>
+  </li>
+
+        
       </ul>
     </nav>
   </li>
@@ -745,10 +759,10 @@
               
                 
                 
-                  <h1>Constucting menu</h1>
+                  <h1>Constucting the menu</h1>
                 
                 <h2 id="what-menus-can-be-made-using-autoconnect">What menus can be made using AutoConnect<a class="headerlink" href="#what-menus-can-be-made-using-autoconnect" title="Permanent link">&para;</a></h2>
-<p>AutoConnect generates a menu dynamically depending on the instantiated <a href="acintro.html#how-it-works">AutoConnectAux</a> at the sketch executing time. Usually, it is a collection of <a href="acelements.html">AutoConnectElement</a>. In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. That is, you can easily make the built-in menu with legacy sketches of yours.</p>
+<p>AutoConnect generates a menu dynamically depending on the instantiated <a href="acintro.html#how-it-works">AutoConnectAux</a> at the sketch executing time. Usually, it is a collection of <a href="acelements.html">AutoConnectElement</a>. In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements.<br>In other words, you can easily create a built-in menu featuring the WiFi connection facility embedding the legacy web pages.</p>
 <h2 id="basic-mechanism-of-menu-generation">Basic mechanism of menu generation<a class="headerlink" href="#basic-mechanism-of-menu-generation" title="Permanent link">&para;</a></h2>
 <p>The sketch can display the <a href="menu.html">AutoConnect menu</a> by following three patterns depending on AutoConnect-API usage.</p>
 <dl>
@@ -763,9 +777,8 @@
 <h2 id="place-the-item-for-the-legacy-sketches-on-the-menu">Place the item for the legacy sketches on the menu<a class="headerlink" href="#place-the-item-for-the-legacy-sketches-on-the-menu" title="Permanent link">&para;</a></h2>
 <p>To implement this with your sketch, use only the <a href="apiaux.html#autoconnectaux">AutoConnectAux</a> constructed with the title and URI of that page. <a href="acelements.html">AutoConnectElements</a> is not required.</p>
 <p>The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for <strong>Edit</strong> and <strong>List</strong>.</p>
-<div style="display:block;margin-left:auto;margin-right:auto;width:284px;height:491px;border:1px solid lightgrey;"><img data-gifffer="./images/aux_fsbrowser.gif" data-gifffer-width="280" data-gifffer-height="490" /></div>
-
-<p>The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows.</p>
+<p><span style="display:block;margin-left:auto;margin-right:auto;width:282px;height:492px;border:1px solid lightgrey;"><img data-gifffer="./images/aux_fsbrowser.gif" data-gifffer-height="490" data-gifffer-width="280" /></span></p>
+<p>The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows:</p>
 <ol>
 <li>Add AutoConnect declaration.</li>
 <li>Add the menu item named "<strong>Edit</strong>" and "<strong>List</strong>" of AutoConnectAux as each page.</li>
@@ -802,7 +815,7 @@
     <div class="md-footer-nav">
       <nav class="md-footer-nav__inner md-grid">
         
-          <a href="howtoembed.html" title="How to embed" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
+          <a href="datatips.html" title="Tips for data conversion" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
             <div class="md-flex__cell md-flex__cell--shrink">
               <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
             </div>
@@ -811,19 +824,19 @@
                 <span class="md-footer-nav__direction">
                   Previous
                 </span>
-                How to embed
+                Tips for data conversion
               </span>
             </div>
           </a>
         
         
-          <a href="faq.html" title="FAQ" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
+          <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
             <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
               <span class="md-flex__ellipsis">
                 <span class="md-footer-nav__direction">
                   Next
                 </span>
-                FAQ
+                Custom Web pages w/o JSON
               </span>
             </div>
             <div class="md-flex__cell md-flex__cell--shrink">
diff --git a/docs/search/search_index.json b/docs/search/search_index.json
index 0023e97..14597cf 100644
--- a/docs/search/search_index.json
+++ b/docs/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"AutoConnect for ESP8266/ESP32 \u00b6 An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface. Overview \u00b6 To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class for ESP8266 or WebServer class for ESP32. Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password. No need pre-coded SSID & password \u00b6 It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime. Simple usage \u00b6 AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected. By using the AutoConnect menu , to manage the connections convenient. Store the established connection \u00b6 The connection authentication data as credentials are saved automatically in EEPROM of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu . Easy to embed in \u00b6 AutoConnect can be placed easily in your sketch. It's \" begin \" and \" handleClient \" only. Lives with your sketches \u00b6 The sketches which provide the web page using ESP8266WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object, or itself can assign it. This effect also applies to ESP32. The corresponding class for ESP32 will be the WebServer. Easy to add the custom Web screens ENHANCED w/v0.9.7 \u00b6 You can easily add your owned web screens that can consist of representative HTML elements and invoke them from the menu. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. Installation \u00b6 Requirements \u00b6 Supported hardware \u00b6 Generic ESP8266 modules (applying the ESP8266 Community's Arduino core) Adafruit HUZZAH ESP8266 (ESP-12) ESP-WROOM-02 Heltec WiFi Kit 8 NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E) Olimex MOD-WIFI-ESP8266 SparkFun Thing SweetPea ESP-210 ESP32Dev Board (applying the Espressif's arduino-esp32 core) SparkFun ESP32 Thing WEMOS LOLIN D32 Ai-Thinker NodeMCU-32S Heltec WiFi Kit 32 M5Stack And other ESP8266/ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE. About flash size on the module The AutoConnect sketch size is relatively large. Large flash capacity is necessary. 512Kbyte (4Mbits) flash inclusion module such as ESP-01 is not recommended. Required libraries \u00b6 AutoConnect requires the following environment and libraries. Arduino IDE The current upstream at the 1.8 level or later is needed. Please install from the official Arduino IDE download page . This step is not required if you already have a modern version. ESP8266 Arduino core AutoConnect targets sketches made on the assumption of ESP8266 Community's Arduino core . The latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. Package URL is http://arduino.esp8266.com/stable/package_esp8266com_index.json ESP32 Arduino core Also, to apply AutoConnect to ESP32, the arduino-esp32 core provided by Espressif is needed. The latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. You can add multiple URLs into Additional Board Manager URLs field, separating them with commas. Package URL is https://dl.espressif.com/dl/package_esp32_index.json for ESP32. Additional library (Required) The PageBuilder library to build HTML for ESP8266WebServer is needed. To install the PageBuilder library into your Arduino IDE, you can use the Library Manager . Select the board of ESP8266 series in the Arduino IDE, open the library manager and search keyword ' PageBuilder ' with the topic ' Communication ', then you can see the PageBuilder . The latest version is required 1.3.2 later. 1 Additional library (Optional) By adding the ArduinoJson library, AutoConnect will be able to handle the custom Web pages described with JSON. With AutoConnect v0.9.7 you can insert user-owned screens that can consist of representative HTML elements as styled TEXT, INPUT, BUTTON, CHECKBOX, SELECT, SUBMIT and invoke them from the AutoConnect menu. These HTML elements can be added by sketches using the AutoConnect API. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. ArduinoJson version 5 is required to use this feature. 2 AutoConnect supports ArduinoJson version 5 only And ArduinoJson version 6 is still in beta. The Arduino Library Manager installs the ArduinoJson version 6 by default. Open the Arduino Library Manager and make sure that ArduinoJson version 5 is installed. Install the AutoConnect \u00b6 Clone or download from the AutoConnect GitHub repository . When you select Download, you can import it to Arduino IDE immediately. After downloaded, the AutoConnect-master.zip file will be saved in your download folder. Then in the Arduino IDE, navigate to \"Sketch > Include Library\" . At the top of the drop down list, select the option to \"Add .ZIP Library...\" . Details for Arduino official page . Supported by Library manager. AutoConnect was added to the Arduino IDE library manager. It can be used with the PlatformIO library also. window.onload = function() { Gifffer(); }; Since AutoConnect v0.9.7, PageBuilder v1.3.2 later is required. \u21a9 Using the AutoConnect API natively allows you to sketch custom Web pages without JSON. \u21a9","title":"Overview"},{"location":"index.html#autoconnect-for-esp8266esp32","text":"An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface.","title":"AutoConnect for ESP8266/ESP32"},{"location":"index.html#overview","text":"To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class for ESP8266 or WebServer class for ESP32. Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password.","title":"Overview"},{"location":"index.html#no-need-pre-coded-ssid-password","text":"It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime.","title":" No need pre-coded SSID &amp; password"},{"location":"index.html#simple-usage","text":"AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected. By using the AutoConnect menu , to manage the connections convenient.","title":" Simple usage"},{"location":"index.html#store-the-established-connection","text":"The connection authentication data as credentials are saved automatically in EEPROM of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu .","title":" Store the established connection"},{"location":"index.html#easy-to-embed-in","text":"AutoConnect can be placed easily in your sketch. It's \" begin \" and \" handleClient \" only.","title":" Easy to embed in"},{"location":"index.html#lives-with-your-sketches","text":"The sketches which provide the web page using ESP8266WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object, or itself can assign it. This effect also applies to ESP32. The corresponding class for ESP32 will be the WebServer.","title":" Lives with your sketches"},{"location":"index.html#easy-to-add-the-custom-web-screens-enhanced-wv097","text":"You can easily add your owned web screens that can consist of representative HTML elements and invoke them from the menu. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD.","title":" Easy to add the custom Web screens ENHANCED w/v0.9.7"},{"location":"index.html#installation","text":"","title":"Installation"},{"location":"index.html#requirements","text":"","title":"Requirements"},{"location":"index.html#supported-hardware","text":"Generic ESP8266 modules (applying the ESP8266 Community's Arduino core) Adafruit HUZZAH ESP8266 (ESP-12) ESP-WROOM-02 Heltec WiFi Kit 8 NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E) Olimex MOD-WIFI-ESP8266 SparkFun Thing SweetPea ESP-210 ESP32Dev Board (applying the Espressif's arduino-esp32 core) SparkFun ESP32 Thing WEMOS LOLIN D32 Ai-Thinker NodeMCU-32S Heltec WiFi Kit 32 M5Stack And other ESP8266/ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE. About flash size on the module The AutoConnect sketch size is relatively large. Large flash capacity is necessary. 512Kbyte (4Mbits) flash inclusion module such as ESP-01 is not recommended.","title":"Supported hardware"},{"location":"index.html#required-libraries","text":"AutoConnect requires the following environment and libraries. Arduino IDE The current upstream at the 1.8 level or later is needed. Please install from the official Arduino IDE download page . This step is not required if you already have a modern version. ESP8266 Arduino core AutoConnect targets sketches made on the assumption of ESP8266 Community's Arduino core . The latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. Package URL is http://arduino.esp8266.com/stable/package_esp8266com_index.json ESP32 Arduino core Also, to apply AutoConnect to ESP32, the arduino-esp32 core provided by Espressif is needed. The latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. You can add multiple URLs into Additional Board Manager URLs field, separating them with commas. Package URL is https://dl.espressif.com/dl/package_esp32_index.json for ESP32. Additional library (Required) The PageBuilder library to build HTML for ESP8266WebServer is needed. To install the PageBuilder library into your Arduino IDE, you can use the Library Manager . Select the board of ESP8266 series in the Arduino IDE, open the library manager and search keyword ' PageBuilder ' with the topic ' Communication ', then you can see the PageBuilder . The latest version is required 1.3.2 later. 1 Additional library (Optional) By adding the ArduinoJson library, AutoConnect will be able to handle the custom Web pages described with JSON. With AutoConnect v0.9.7 you can insert user-owned screens that can consist of representative HTML elements as styled TEXT, INPUT, BUTTON, CHECKBOX, SELECT, SUBMIT and invoke them from the AutoConnect menu. These HTML elements can be added by sketches using the AutoConnect API. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. ArduinoJson version 5 is required to use this feature. 2 AutoConnect supports ArduinoJson version 5 only And ArduinoJson version 6 is still in beta. The Arduino Library Manager installs the ArduinoJson version 6 by default. Open the Arduino Library Manager and make sure that ArduinoJson version 5 is installed.","title":"Required libraries"},{"location":"index.html#install-the-autoconnect","text":"Clone or download from the AutoConnect GitHub repository . When you select Download, you can import it to Arduino IDE immediately. After downloaded, the AutoConnect-master.zip file will be saved in your download folder. Then in the Arduino IDE, navigate to \"Sketch > Include Library\" . At the top of the drop down list, select the option to \"Add .ZIP Library...\" . Details for Arduino official page . Supported by Library manager. AutoConnect was added to the Arduino IDE library manager. It can be used with the PlatformIO library also. window.onload = function() { Gifffer(); }; Since AutoConnect v0.9.7, PageBuilder v1.3.2 later is required. \u21a9 Using the AutoConnect API natively allows you to sketch custom Web pages without JSON. \u21a9","title":"Install the AutoConnect"},{"location":"acelements.html","text":"The elements for the custom Web pages \u00b6 Representative HTML elements for making the custom Web page are provided as AutoConnectElements. AutoConnectButton : Labeled action button AutoConnectCheckbox : Labeled checkbox AutoConnectElement : General tag AutoConnectInput : Labeled text input box AutoConnectRadio : Labeled radio button AutoConnectSelect : Selection list AutoConnectSubmit : Submit button AutoConnectText : Style attributed text Layout on a custom Web page \u00b6 You can specify the direction to arrange the radio buttons as AutoConnectRadio vertically or horizontally. Other elements are arranged vertically in the order of addition to AutoConnectAux. This basic layout depends on the CSS of the AutoConnect menu so it can not be changed drastically. Form and AutoConnectElements \u00b6 All AutoConnectElements placed on a custom Web page are included in one form. Its form is fixed and created by AutoConnect. The form's value (usually the text or checkbox you entered) is sent by AutoConnectSubmit using the POST method. name and value of each AutoConnectElement which own form-data are reflected in the query string when the custom Web page was sent. You can retrieve the value in the sketch as the parameter's value of the query string with ESP8266WebServer::arg function or PageArgument class of AutoConnect::on handler when the form is submitted. AutoConnectElement - A basic class of elements \u00b6 AutoConnectElement is a base class for other element classes and has common attributes for all elements. It can also be used as a variant of each element. The following items are attributes that AutoConnectElement has and are common to other elements. Sample AutoConnectElement element(\"element\", \"<hr>\"); On the page: Constructor \u00b6 AutoConnectElement( const char * name, const char * value) name \u00b6 Each element has a name. The name is the String data type. You can identify each element by the name to access it with sketches. value \u00b6 The value is the string which is a source to generate an HTML code. Characteristics of Value vary depending on the element. The value of AutoConnectElement is native HTML code. A string of value is output as HTML as it is. type \u00b6 The type indicates the type of the element and represented as the ACElement_t enumeration type in the sketch. Since AutoConnectElement also acts as a variant of other elements, it can be applied to handle elements collectively. At that time, the type can be referred to by the typeOf() function. The following example changes the font color of all AutoConnectText elements of a custom Web page to gray. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.typeOf() == AC_Text) { AutoConnectText & text = reinterpret_cast < AutoConnectText &> (elm); text.style = \"color:gray;\" ; } } The enumerators for ACElement_t are as follows: AutoConnectButton: AC_Button AutoConnectCheckbox: AC_Checkbox AutoConnectElement: AC_Element AutoConnectInput: AC_Input AutoConnectRadio: AC_Radio AutoConnectSelect: AC_Select AutoConnectSubmit: AC_Submit AutoConnectText: AC_Text Uninitialized element: AC_Unknown Furthermore, to convert an entity that is not an AutoConnectElement to its native type, you must re-interpret that type with c++. AutoConnectButton \u00b6 AutoConnectButton generates an HTML < button type = \"button\" > tag and locates a clickable button to a custom Web page. Currently AutoConnectButton corresponds only to name, value, an onclick attribute of HTML button tag. An onclick attribute is generated from an action member variable of the AutoConnectButton, which is mostly used with a JavaScript to activate a script. Sample AutoConnectButton button(\"button\", \"OK\", \"myFunction()\"); On the page: Constructor \u00b6 AutoConnectButton( const char * name, const char * value, const String & action) name \u00b6 It is the name of the AutoConnectButton element and matches the name attribute of the button tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a value of the value attribute of an HTML button tag. action \u00b6 action is String data type and is an onclick attribute fire on a mouse click on the element. It is mostly used with a JavaScript to activate a script. 1 For example, the following code defines a custom Web page that copies a content of Text1 to Text2 by clicking Button . const char * scCopyText = R\"( <script> function CopyText() { document.getElementById(\"Text2\").value = document.getElementById(\"Text1\").value; } </script> )\" ; ACInput(Text1, \"Text1\" ); ACInput(Text2, \"Text2\" ); ACButton(Button, \"COPY\" , \"CopyText()\" ); ACElement(TextCopy, scCopyText); AutoConnectCheckbox \u00b6 AutoConnectCheckbox generates an HTML < input type = \"checkbox\" > tag and a < label > tag. It places horizontally on a custom Web page by default. Sample AutoConnectCheckbox checkbox(\"checkbox\", \"uniqueapid\", \"Use APID unique\", false); On the page: Constructor \u00b6 AutoConnectCheckbox( const char * name, const char * value, const char * label, const bool checked) name \u00b6 It is the name of the AutoConnectCheckbox element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a value of the value attribute of an HTML < input type = \"checkbox\" > tag. label \u00b6 A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <label> tag with an id attribute. The checkbox and the label are connected by the id attribute. Only will be displayed if a label is not specified. checked \u00b6 A checked is a Boolean value and indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent. AutoConnectInput \u00b6 AutoConnectInput generates an HTML < input type = \"text\" > tag and a < label > tag. It can also have a placeholder. The value of the input box is passed to the destination in the query string and can be retrieved programmatically. You can also update from the sketches. Sample AutoConnectInput input(\"input\", \"\", \"Server\", \"MQTT broker server\"); On the page: Constructor \u00b6 AutoConnectInput( const char * name, const char * value, const char * label, const char * pattern, const char * placeholder) name \u00b6 It is the name of the AutoConnectInput element and matches the name attribute, the id attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a string value of the value attribute of an HTML < input type = \"text\" > tag. The text entered from the custom Web page will be grouped in the query string of the form submission and the string set before accessing the page will be displayed as the initial value. label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. pattern \u00b6 A pattern specifies a regular expression that the AutoConnectInput element's value is checked against on form submission. If it is invalid, the background color will change, but it will be sent even if the data format does not match. The password that must contain 8 or more characters that are of at least one number, and one uppercase and lowercase letter: (?=.*\\d)(?=.*[a-z])(?=.*[A-Z]).{8,} Email address as characters@characters.domain : [a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,}$ IP address Host name of the internet Date (MM-DD-YYYY) Twitter account: ^@?(\\w){1,15}$ placeholder \u00b6 A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. AutoConnectRadio \u00b6 AutoConnectRadio generates few HTML < input type = \"radio\" > tags as grouped and the same number of < label > tags. AutoConnectRadio can keep the value of a radio button as a collection. The grouped values will be placed in the custom Web page to select only one exclusively. Sample AutoConnectRadio radio(\"radio\", { \"30 sec.\", \"60 sec.\", \"180 sec.\" }, \"Update period\", AC_Vertical, 1); On the page: Constructor \u00b6 AutoConnectRadio( const char * name, std :: vector < String > const & values, const char * label, const ACArrange_t order, const uint8_t checked) name \u00b6 It is the name of the AutoConnectRadio element and matches the name attribute of the input tags. It also becomes the parameter name of the query string when submitted. values \u00b6 A values is an array of String type for the radio button options which as actually std::vector . It is an initialization list can be used. The input tags will be generated from each entry in the values, the amount of which is the same as the number of items in values . label \u00b6 A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Specification of a label will generate an HTML < label > tag with an id attribute. The radio buttons and the label are connected by the id attribute. order \u00b6 A order specifies the direction to arrange the radio buttons. It is a value of type ACArrange_t and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. A label will place in the left or the top according to the order . checked \u00b6 A checked specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. AutoConnectSelect \u00b6 AutoConnectSelect generates an HTML < select > tag (drop-down list) and few < option > tags. Sample AutoConnectSelect select(\"select\", { String(\"Europe/London\"), String(\"Europe/Berlin\"), String(\"Europe/Helsinki\"), String(\"Europe/Moscow\"), String(\"Asia/Dubai\") }, \"Select TZ name\"); On the page: Constructor \u00b6 AutoConnectSelect( const char * name, std :: vector < String > const & options, const char * label) name \u00b6 It is the name of the AutoConnectSelect element and matches the name attribute of the select tags. options \u00b6 An options is an array of String type for the options which as actually std::vector for an HTML < option > tag. It is an initialization list can be used. The option tags will be generated from each entry in the options, the amount of which is the same as the number of items in an options . label \u00b6 A label is an optional string. A label is always arranged on the left side of the drop-down list. Specification of a label will generate an HTML < label > tag with an id attribute. The select tag and the label are connected by the id attribute. AutoConnectSubmit \u00b6 AutoConnectSubmit generates an HTML < input type = \"button\" > tag attached onclick attribute. The native code of the onclick attribute is the submission of the form with the POST method. Sample AutoConnectSubmit submit(\"submit\", \"Save\", \"/mqtt_save\"); On the page: Constructor \u00b6 AutoConnectSubmit( const char * name, const char * value, const char * uri) name \u00b6 It is the name of the AutoConnectSubmit element and matches the name attribute of the input tag. value \u00b6 It becomes a string of the value attribute of an HTML < input type = \"button\" > tag. The value will be displayed as a label of the button. uri \u00b6 A uri specifies the URI to send form data when the button declared by AutoConnectSubmit is clicked. The query string of the form data sent with AutoConnectSubmit contains the URI of the page. Its parameter name is _acuri . In Sketch, you can know the called URI by referring to the _acuri parameter with the destination page handler. The actual query string is as follows: _acuri= CALLER_URI AutoConnectText \u00b6 AutoConnectText generates an HTML < div > tag. A style attribute will be attached if a style parameter is passed. Sample AutoConnectText text(\"text\", \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\", \"font-family:serif;color:#4682b4;\"); On the page: Constructor \u00b6 AutoConnectText( const char * name, const char * value, const char * style) name \u00b6 A name does not exist in the generated HTML. It provides only a means of accessing elements with the sketches. value \u00b6 It becomes content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style \u00b6 A style specifies the qualification style to give to the content and can use the style attribute format as it is. How to coding for the elements \u00b6 Declaration for the elements in Sketches \u00b6 Variables of each AutoConnetElement can be declared with macros. By using the macros, you can treat element name that is String type as variable in sketches. 2 ACElement ( name [ , value ] ) ACButton ( name [ , value ] [ , action ] ) ACCheckbox ( name [ , value ] [ , label ] [ , true | false ] ) ACInput ( name [ , value ] [ , label ] [ , placeholder ] ) ACRadio ( name [ , values ] [ , label ] [ , AC_Horizontal | AC_Vertical ] [ , checked ] ) ACSelect ( name [ , options ] [ , label ] ) ACSubmit ( name [ , value ] [ , uri ] ) ACText ( name [ , value ] [ , style ] ) Declaration macro usage For example, AutoConnectText can be declared using macros. AutoConnectText caption( \"caption\" , \"hello, world\" , \"color:blue;\" ) equals by using ACText macro. ACText(caption, \"hello, world\" , \"color:blue;\" ) Variant for AutoConnectElements \u00b6 Some AutoConnectAux APIs specify AutoConnectElements as an argument. There are also functions that return a pointer to AutoConnectElements. AutoConnectElement behaves as a variant type of each element class to make these interfaces a single. Use reinterpret_cast to cast from a variant pointer to an Actual type pointer of AutoConnectElements. AutoConnectAux aux; ACText(Text1, \"hello, world\" ); aux.add(Text1); AutoConnectText * text_p = reinterpret_cast < AutoConnectText > (aux.getElement( \"Text1\" )); AutoConnectText & text = aux.getElement < AutoConnectText > ( \"Text1\" ); JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9 The square brackets in the syntax are optional parameters, the stroke is a selection parameter, the bold fonts are literal. \u21a9","title":"AutoConnectElements"},{"location":"acelements.html#the-elements-for-the-custom-web-pages","text":"Representative HTML elements for making the custom Web page are provided as AutoConnectElements. AutoConnectButton : Labeled action button AutoConnectCheckbox : Labeled checkbox AutoConnectElement : General tag AutoConnectInput : Labeled text input box AutoConnectRadio : Labeled radio button AutoConnectSelect : Selection list AutoConnectSubmit : Submit button AutoConnectText : Style attributed text","title":"The elements for the custom Web pages"},{"location":"acelements.html#layout-on-a-custom-web-page","text":"You can specify the direction to arrange the radio buttons as AutoConnectRadio vertically or horizontally. Other elements are arranged vertically in the order of addition to AutoConnectAux. This basic layout depends on the CSS of the AutoConnect menu so it can not be changed drastically.","title":"Layout on a custom Web page"},{"location":"acelements.html#form-and-autoconnectelements","text":"All AutoConnectElements placed on a custom Web page are included in one form. Its form is fixed and created by AutoConnect. The form's value (usually the text or checkbox you entered) is sent by AutoConnectSubmit using the POST method. name and value of each AutoConnectElement which own form-data are reflected in the query string when the custom Web page was sent. You can retrieve the value in the sketch as the parameter's value of the query string with ESP8266WebServer::arg function or PageArgument class of AutoConnect::on handler when the form is submitted.","title":"Form and AutoConnectElements"},{"location":"acelements.html#autoconnectelement-a-basic-class-of-elements","text":"AutoConnectElement is a base class for other element classes and has common attributes for all elements. It can also be used as a variant of each element. The following items are attributes that AutoConnectElement has and are common to other elements. Sample AutoConnectElement element(\"element\", \"<hr>\"); On the page:","title":"AutoConnectElement - A basic class of elements"},{"location":"acelements.html#constructor","text":"AutoConnectElement( const char * name, const char * value)","title":" Constructor"},{"location":"acelements.html#name","text":"Each element has a name. The name is the String data type. You can identify each element by the name to access it with sketches.","title":" name"},{"location":"acelements.html#value","text":"The value is the string which is a source to generate an HTML code. Characteristics of Value vary depending on the element. The value of AutoConnectElement is native HTML code. A string of value is output as HTML as it is.","title":" value"},{"location":"acelements.html#type","text":"The type indicates the type of the element and represented as the ACElement_t enumeration type in the sketch. Since AutoConnectElement also acts as a variant of other elements, it can be applied to handle elements collectively. At that time, the type can be referred to by the typeOf() function. The following example changes the font color of all AutoConnectText elements of a custom Web page to gray. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.typeOf() == AC_Text) { AutoConnectText & text = reinterpret_cast < AutoConnectText &> (elm); text.style = \"color:gray;\" ; } } The enumerators for ACElement_t are as follows: AutoConnectButton: AC_Button AutoConnectCheckbox: AC_Checkbox AutoConnectElement: AC_Element AutoConnectInput: AC_Input AutoConnectRadio: AC_Radio AutoConnectSelect: AC_Select AutoConnectSubmit: AC_Submit AutoConnectText: AC_Text Uninitialized element: AC_Unknown Furthermore, to convert an entity that is not an AutoConnectElement to its native type, you must re-interpret that type with c++.","title":" type"},{"location":"acelements.html#autoconnectbutton","text":"AutoConnectButton generates an HTML < button type = \"button\" > tag and locates a clickable button to a custom Web page. Currently AutoConnectButton corresponds only to name, value, an onclick attribute of HTML button tag. An onclick attribute is generated from an action member variable of the AutoConnectButton, which is mostly used with a JavaScript to activate a script. Sample AutoConnectButton button(\"button\", \"OK\", \"myFunction()\"); On the page:","title":"AutoConnectButton"},{"location":"acelements.html#constructor_1","text":"AutoConnectButton( const char * name, const char * value, const String & action)","title":" Constructor"},{"location":"acelements.html#name_1","text":"It is the name of the AutoConnectButton element and matches the name attribute of the button tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_1","text":"It becomes a value of the value attribute of an HTML button tag.","title":" value"},{"location":"acelements.html#action","text":"action is String data type and is an onclick attribute fire on a mouse click on the element. It is mostly used with a JavaScript to activate a script. 1 For example, the following code defines a custom Web page that copies a content of Text1 to Text2 by clicking Button . const char * scCopyText = R\"( <script> function CopyText() { document.getElementById(\"Text2\").value = document.getElementById(\"Text1\").value; } </script> )\" ; ACInput(Text1, \"Text1\" ); ACInput(Text2, \"Text2\" ); ACButton(Button, \"COPY\" , \"CopyText()\" ); ACElement(TextCopy, scCopyText);","title":" action"},{"location":"acelements.html#autoconnectcheckbox","text":"AutoConnectCheckbox generates an HTML < input type = \"checkbox\" > tag and a < label > tag. It places horizontally on a custom Web page by default. Sample AutoConnectCheckbox checkbox(\"checkbox\", \"uniqueapid\", \"Use APID unique\", false); On the page:","title":"AutoConnectCheckbox"},{"location":"acelements.html#constructor_2","text":"AutoConnectCheckbox( const char * name, const char * value, const char * label, const bool checked)","title":" Constructor"},{"location":"acelements.html#name_2","text":"It is the name of the AutoConnectCheckbox element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_2","text":"It becomes a value of the value attribute of an HTML < input type = \"checkbox\" > tag.","title":" value"},{"location":"acelements.html#label","text":"A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <label> tag with an id attribute. The checkbox and the label are connected by the id attribute. Only will be displayed if a label is not specified.","title":" label"},{"location":"acelements.html#checked","text":"A checked is a Boolean value and indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent.","title":" checked"},{"location":"acelements.html#autoconnectinput","text":"AutoConnectInput generates an HTML < input type = \"text\" > tag and a < label > tag. It can also have a placeholder. The value of the input box is passed to the destination in the query string and can be retrieved programmatically. You can also update from the sketches. Sample AutoConnectInput input(\"input\", \"\", \"Server\", \"MQTT broker server\"); On the page:","title":"AutoConnectInput"},{"location":"acelements.html#constructor_3","text":"AutoConnectInput( const char * name, const char * value, const char * label, const char * pattern, const char * placeholder)","title":" Constructor"},{"location":"acelements.html#name_3","text":"It is the name of the AutoConnectInput element and matches the name attribute, the id attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_3","text":"It becomes a string value of the value attribute of an HTML < input type = \"text\" > tag. The text entered from the custom Web page will be grouped in the query string of the form submission and the string set before accessing the page will be displayed as the initial value.","title":" value"},{"location":"acelements.html#label_1","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#pattern","text":"A pattern specifies a regular expression that the AutoConnectInput element's value is checked against on form submission. If it is invalid, the background color will change, but it will be sent even if the data format does not match. The password that must contain 8 or more characters that are of at least one number, and one uppercase and lowercase letter: (?=.*\\d)(?=.*[a-z])(?=.*[A-Z]).{8,} Email address as characters@characters.domain : [a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,}$ IP address Host name of the internet Date (MM-DD-YYYY) Twitter account: ^@?(\\w){1,15}$","title":" pattern"},{"location":"acelements.html#placeholder","text":"A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag.","title":" placeholder"},{"location":"acelements.html#autoconnectradio","text":"AutoConnectRadio generates few HTML < input type = \"radio\" > tags as grouped and the same number of < label > tags. AutoConnectRadio can keep the value of a radio button as a collection. The grouped values will be placed in the custom Web page to select only one exclusively. Sample AutoConnectRadio radio(\"radio\", { \"30 sec.\", \"60 sec.\", \"180 sec.\" }, \"Update period\", AC_Vertical, 1); On the page:","title":"AutoConnectRadio"},{"location":"acelements.html#constructor_4","text":"AutoConnectRadio( const char * name, std :: vector < String > const & values, const char * label, const ACArrange_t order, const uint8_t checked)","title":" Constructor"},{"location":"acelements.html#name_4","text":"It is the name of the AutoConnectRadio element and matches the name attribute of the input tags. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#values","text":"A values is an array of String type for the radio button options which as actually std::vector . It is an initialization list can be used. The input tags will be generated from each entry in the values, the amount of which is the same as the number of items in values .","title":" values"},{"location":"acelements.html#label_2","text":"A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Specification of a label will generate an HTML < label > tag with an id attribute. The radio buttons and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#order","text":"A order specifies the direction to arrange the radio buttons. It is a value of type ACArrange_t and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. A label will place in the left or the top according to the order .","title":" order"},{"location":"acelements.html#checked_1","text":"A checked specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked.","title":" checked"},{"location":"acelements.html#autoconnectselect","text":"AutoConnectSelect generates an HTML < select > tag (drop-down list) and few < option > tags. Sample AutoConnectSelect select(\"select\", { String(\"Europe/London\"), String(\"Europe/Berlin\"), String(\"Europe/Helsinki\"), String(\"Europe/Moscow\"), String(\"Asia/Dubai\") }, \"Select TZ name\"); On the page:","title":"AutoConnectSelect"},{"location":"acelements.html#constructor_5","text":"AutoConnectSelect( const char * name, std :: vector < String > const & options, const char * label)","title":" Constructor"},{"location":"acelements.html#name_5","text":"It is the name of the AutoConnectSelect element and matches the name attribute of the select tags.","title":" name"},{"location":"acelements.html#options","text":"An options is an array of String type for the options which as actually std::vector for an HTML < option > tag. It is an initialization list can be used. The option tags will be generated from each entry in the options, the amount of which is the same as the number of items in an options .","title":" options"},{"location":"acelements.html#label_3","text":"A label is an optional string. A label is always arranged on the left side of the drop-down list. Specification of a label will generate an HTML < label > tag with an id attribute. The select tag and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#autoconnectsubmit","text":"AutoConnectSubmit generates an HTML < input type = \"button\" > tag attached onclick attribute. The native code of the onclick attribute is the submission of the form with the POST method. Sample AutoConnectSubmit submit(\"submit\", \"Save\", \"/mqtt_save\"); On the page:","title":"AutoConnectSubmit"},{"location":"acelements.html#constructor_6","text":"AutoConnectSubmit( const char * name, const char * value, const char * uri)","title":" Constructor"},{"location":"acelements.html#name_6","text":"It is the name of the AutoConnectSubmit element and matches the name attribute of the input tag.","title":" name"},{"location":"acelements.html#value_4","text":"It becomes a string of the value attribute of an HTML < input type = \"button\" > tag. The value will be displayed as a label of the button.","title":" value"},{"location":"acelements.html#uri","text":"A uri specifies the URI to send form data when the button declared by AutoConnectSubmit is clicked. The query string of the form data sent with AutoConnectSubmit contains the URI of the page. Its parameter name is _acuri . In Sketch, you can know the called URI by referring to the _acuri parameter with the destination page handler. The actual query string is as follows: _acuri= CALLER_URI","title":" uri"},{"location":"acelements.html#autoconnecttext","text":"AutoConnectText generates an HTML < div > tag. A style attribute will be attached if a style parameter is passed. Sample AutoConnectText text(\"text\", \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\", \"font-family:serif;color:#4682b4;\"); On the page:","title":"AutoConnectText"},{"location":"acelements.html#constructor_7","text":"AutoConnectText( const char * name, const char * value, const char * style)","title":" Constructor"},{"location":"acelements.html#name_7","text":"A name does not exist in the generated HTML. It provides only a means of accessing elements with the sketches.","title":" name"},{"location":"acelements.html#value_5","text":"It becomes content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag.","title":" value"},{"location":"acelements.html#style","text":"A style specifies the qualification style to give to the content and can use the style attribute format as it is.","title":" style"},{"location":"acelements.html#how-to-coding-for-the-elements","text":"","title":"How to coding for the elements"},{"location":"acelements.html#declaration-for-the-elements-in-sketches","text":"Variables of each AutoConnetElement can be declared with macros. By using the macros, you can treat element name that is String type as variable in sketches. 2 ACElement ( name [ , value ] ) ACButton ( name [ , value ] [ , action ] ) ACCheckbox ( name [ , value ] [ , label ] [ , true | false ] ) ACInput ( name [ , value ] [ , label ] [ , placeholder ] ) ACRadio ( name [ , values ] [ , label ] [ , AC_Horizontal | AC_Vertical ] [ , checked ] ) ACSelect ( name [ , options ] [ , label ] ) ACSubmit ( name [ , value ] [ , uri ] ) ACText ( name [ , value ] [ , style ] ) Declaration macro usage For example, AutoConnectText can be declared using macros. AutoConnectText caption( \"caption\" , \"hello, world\" , \"color:blue;\" ) equals by using ACText macro. ACText(caption, \"hello, world\" , \"color:blue;\" )","title":" Declaration for the elements in Sketches"},{"location":"acelements.html#variant-for-autoconnectelements","text":"Some AutoConnectAux APIs specify AutoConnectElements as an argument. There are also functions that return a pointer to AutoConnectElements. AutoConnectElement behaves as a variant type of each element class to make these interfaces a single. Use reinterpret_cast to cast from a variant pointer to an Actual type pointer of AutoConnectElements. AutoConnectAux aux; ACText(Text1, \"hello, world\" ); aux.add(Text1); AutoConnectText * text_p = reinterpret_cast < AutoConnectText > (aux.getElement( \"Text1\" )); AutoConnectText & text = aux.getElement < AutoConnectText > ( \"Text1\" ); JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9 The square brackets in the syntax are optional parameters, the stroke is a selection parameter, the bold fonts are literal. \u21a9","title":" Variant for AutoConnectElements"},{"location":"achandling.html","text":"Handing AutoConnectElements with the sketches \u00b6 AutoConnectElements (i.e. they are the elements displayed on the custom Web page) must be contained in AutoConnectAux object. AutoConnectElements declared in sketch must be programmed to add to AutoConnectAux one after another. Elements are automatically included in AutoConnectAux by AutoConnect if you load it from the JSON description. In either method, it is common to use the function of AutoConnectAux to access an element with a sketch. The AutoConnectAux class has several functions to manipulate AutoConnectElements. The functions can add, delete, retrieve elements, and get and set values. Add AutoConnectElements to the AutoConnectAux object \u00b6 To add AutoConnectElment(s) to an AutoConnectAux object, use the add function. void AutoConnectAux :: add(AutoConenctElement & addon) void AutoConnectAux :: add(AutoConenctElementVT addons) The add function adds specified AutoConnectElement to the AutoConnectAux. If specified the collection of AutoConnectElements as a std::vector of the references to each element, these elements added in bulk. The AutoConnectElements contained in the AutoConnectAux object are uniquely identified by the name. When adding an AutoConnectElement, if an element with the same name already exists in the AutoConnectAux, checking the type, and if it is the same, the value will be replaced. If another type of AutoConnectElement exists with the same name, that add operation will be invalid. 1 In the following example, an AutoConnectButton as button addition is invalid. AutoConnectAux aux; AutoConnectText text ( \"hello\" , \"hello, world\" ); AutoConnectButton button ( \"hello\" , \"hello, world\" , \"alert('Hello world!')\") ; // This is invalid. aux.add({ text, button }); Similarly this, the uniqueness of the name is also necessary within the JSON document { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true , \"element\" : [ { \"name\" : \"hello\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"hello\" , \"type\" : \"ACButton\" , \"value\" : \"hello, world\" , \"action\" : \"alert('Hello world!')\" } ] } Load all elements from JSON document If you load all AutoConnectElements from JSON document into AutoConnect, you do not need to sketch the population process of the AutoConnectElements. It is managed by the AutoConnect library automatically. Get AutoConnectElement from the AutoConnectAux \u00b6 To retrieve an element from AutoConnectAux, use the getElement or getElements function. Normally, the getElement is needed when accessing the value of AutoConnectElement in the sketch. AutoConnectElement * AutoConnectAux :: getElement( const String & name); template < typename T > T & AutoConnectAux :: getElement( const String & name); AutoConnectElementVT * AutoConnectAux :: getElements( void ); The getElement function returns an AutoConnectElement with the specified name as a key. When you use this function, you need to know the type of AutoConnectElement in advance. To retrieve an AutoConnectElement by specifying its type, use the following method. AutoConnectAux aux; aux.load( \"SOME_JSON_DOCUMENT\" ); // Retrieve the pointer of the AutoConnectText AutoConnectText * text = reinterpret_cast < AutoConnectText *> (aux.getElement( \"TEXT_ELEMENT_NAME\" )); // Retrieve the reference of the AutoConnectText AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_ELEMENT_NAME\" ); The AutoConnectElement type behaves as a variant of other element types. Therefore use cast or template to convert to actual type as above. In the sketch, you access the real type of AutoConnectElement after casting it and storing into the variable. const String auxJson = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); AutoConenct portal; portal.load(auxJson); AutoConnectAux * aux = portal.aux( \"/page1\" ); // Identify the AutoConnectAux instance with uri AutoConenctText & text = aux -> getElement < AutoConnectText > ( \"caption\" ); // Cast to real type and access members Serial.println(text.value); To get all the AutoConnectElements of an AutoConnectAux object use the getElements function. This function returns the vector of the reference wrapper as AutoConnectElementVT to all AutoConnectElements registered in the AutoConnectAux. AutoConnectElementVT & getElements( void ) AutoConnectElementVT is a predefined type for it and can use methods of std::vector < std::reference_wrapper >. Loading & saving AutoConnectElements with JSON \u00b6 AutoConnect supports reading the custom Web page definitions written in JSON and also supports loading and saving of AutoConnectElements. In both cases, the target object is a JSON document for AutoConnect . However, it can not save all AutoConnectElements contained in the page as a custom Web page. (ie. AutoConnectAux) Loading AutoConnectAux & AutoConnectElements with JSON \u00b6 To load a JSON document as AutoConnectAux use the AutoConnect::load function and load the JSON document of each AutoConnectElement using the AutoConnectAux::loadElement function. Although the functions of both are similar, the structure of the target JSON document is different. The AutoConnect::load function loads the entire AutoConnectAux and creates both the AutoConnectAux instance and each AutoConnectElement instance. A single JSON document can contain multiple custom Web pages. If you write JSON of AutoConnectAux as an array, the load function generates all the pages contained in that array. Therefore, it is necessary to supply the JSON document of AutoConnectAux as an input of the load function and must contain the elements described here . The AutoConnectAux::loadElement function loads the elements individually into an AutoConnectAux object. The structure of its supplying JSON document is not AutoConnectAux. It must be a JSON structure for AutoConnectElement , but you can specify an array. // AutoConnectAux as a custom Web page. const char page[] PROGMEM = R\"raw( { \"title\": \"Settings\", \"uri\": \"/settings\", \"menu\": true, \"element\": [ { \"name\": \"server\", \"type\": \"ACInput\", \"label\": \"Server\" }, { \"name\": \"set\", \"type\": \"ACSubmit\", \"value\": \"SET\", \"uri\" : \"/set\" } ] } )raw\" ; // Additional AutoConnectElements. const char addons[] PROGMEM = R\"raw( [ { \"name\": \"notes\", \"type\": \"ACText\", \"value\": \"An update period as the below optionally.\" }, { \"name\": \"period\", \"type\": \"ACRadio\", \"value\": [ \"30 sec.\", \"60 sec.\", \"180 sec.\" ], \"arrange\": \"vertical\", \"checked\": 1 } ] )raw\" ; AutoConnect portal; AutoConnectAux * auxPage; // Load a custom Web page. portal.load(page); // Get a '/settings' page auxPage = portal.aux( \"/settings\" ); // Also, load only AutoConnectRadio named the period. auxPage -> loadElement(addons, \"period\" ); // Retrieve a server name from an AutoConnectText value. AutoConnectText & serverName = auxPage -> getElement < AutoConnectText > ( \"server\" ); Serial.println(serverName.value); Saving AutoConnectElements with JSON \u00b6 To save the AutoConnectElement as a JSON document, use the AutoConnectAux::saveElement function. It serializes the contents of the object based on the type of the AutoConnectElement. You can persist a serialized AutoConnectElements as a JSON document to a stream. // Open a parameter file on the SPIFFS. SPIFFS.begin(); FILE param = SPIFFS.open( \"/param\" , \"w\" ); // Save elements as the parameters. auxPage -> saveElement(param, { \"server\" , \"period\" }); // Close a parameter file. param.close(); SPIFFS.end(); The example above saves server and period elements from the AutoConnectAux object as mentioned above to the /param file on SPIFFS. Its JSON document of AutoConnectElements saved by its code looks like this: [ { \"name\" : \"server\" , \"type\" : \"ACInput\" , \"value\" : \"An inputted server name\" , \"label\" : \"Server\" , \"placeholder\" : \"\" }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"arrange\" : \"vertical\" , \"checked\" : 2 } ] Custom field data handling \u00b6 A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored in the member variable of each element by AutoConnect whenever GET/POST transmission occurs. The following diagram shows the flow of the input values of a custom Web page into a sketch and is the basis for actions to manipulate the values of custom Web pages using sketches. Where to pick up the values \u00b6 A sketch composed of handlers can receive the value of AutoConnectElements entered in a custom Web page after sending, but that handler is different from the page where the value was entered. It is necessary to be aware that can accept the entered values by the next page handler after the transition. Usually, two ways to retrieve entered values we have. One is to use the ESP8266WebServer::arg (or WebServer::arg for ESP32) function in the on handler attached by ESP8266WebServer (WebServer w/ESP32 also). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char addonJson[] PROGMEM = R\"raw( { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] } )raw\" ; ESP8266WebServer webServer; AutoConnect portal (webServer); // Here, /feels handler void feelsOn () { // Retrieve the value of a input-box named \"feels\" String feel = webServer.arg( \"feels\" ); // Echo back the value String echo = \"<html><p style= \\\" color:blue;font-family:verdana;font-size:300%; \\\" >\" + feel + String( \" and a bold world!</p></html>\" ); webServer.send( 200 , \"text/html\" , echo); } void setup () { delay( 1000 ); webServer.on( \"/feels\" , feelsOn); // Register /feels handler portal.load(addonJson); // Load a custom Web page portal.begin(); } void loop () { portal.handleClient(); } An above example is the most simple sketch of handling values entered into a custom Web page. This sketch obtains the string entered in the AutoConnectInput named feels with the /feels handler after page transition, and the AutoConnectInput is an <input type=\"text\" name=\"feels\"> element wrapped in the form as the actual HTML code. Should be accessed /_ac first When you actually try the above sketch, there is no a root handler. So the URL that should be accessed first is /_ac concatenated with the local IP address of the esp8266 module. Another method is effective when custom Web pages have complicated page transitions. It is a way to straight access the AutoConnectElements member value. You can get the AutoConnectElement with the specified name using the getElement function. The following sketch executes the above example with AutoConnect only, without using the function of ESP8266WebServer. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> const static char addonJson[] PROGMEM = R\"raw( [ { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] }, { \"title\": \"Hello\", \"uri\": \"/feels\", \"menu\": false, \"element\": [ { \"name\": \"echo\", \"type\": \"ACText\", \"style\": \"color:blue;font-family:verdana;font-size:300%;\" } ] } ] )raw\" ; AutoConnect portal; // Here, /feels handler String feelsOn (AutoConnectAux & aux, PageArgument & args) { // Get the AutoConnectInput named \"feels\". // The where() function returns the AutoConnectAux of the page that triggered this handler. AutoConnectInput & feels = portal.where() -> getElement < AutoConnectInput > ( \"feels\" ); // Get the AutoConnectText named \"echo\". AutoConnectText & echo = aux.getElement < AutoConnectText > ( \"echo\" ); // Echo back from input-box to /feels page. echo.value = feels.value + String( \" and a bold world!\" ); return String( \"\" ); } void setup () { delay( 1000 ); portal.load(addonJson); // Load custom Web pages portal.on( \"/feels\" , feelsOn, AC_EXIT_AHEAD); // Register /feels handler portal.begin(); } void loop () { portal.handleClient(); } The above example handles in the handler for the values of a custom web page. An AutoConnect::on function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the PageArgument object. To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the AutoConnect::where function. The AutoConnect::where function returns a pointer to the AutoConnectAux object of the custom Web page that caused the HTTP request. The where() function is available for only AutoConnectAux. The AutoConnect::where function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/ESP32. In other words, the AutoConnect::where function only returns the last AutoConnecAux page called. When setting the initial values \u00b6 An AutoConnectAux page is dynamically created by AutoConnect when its uri is requested. The initial value of AutoConnectElements can be set before its page request. It is also possible during loop() . To set the initial value when the page is accessed it needs by the handler of its page. The AutoConnect::on and AutoConnectAux::on functions register a handler for a custom Web page and also specify when to call that handler. The behavior of the two on functions is the same, only the class and arguments are different. bool AutoConnect :: on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order) void AutoConnectAux :: on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order) Parameter uri specifies an URI of the custom Web page, but an AutoConnectAux object with its URI must be registered with AutoConnect via the AutoConnect::join function beforehand. AutoConnect::on/AutoConnectAux::on is not ESP8266WebServer::on The on function for AutoConnect is different from the on function of Arduino core ESP8266WebServer (WebServer for ESP32). You can share the same handler via wrapper, but access to AutoConnectElements is valid only for handlers registered with on function for AutoConnect . AuxHandlerFunctionT type is a handler declaration using with std::function . String handler(AutoConnectAux & aux, PageArgument & args) The handler of the custom Web page has two arguments by a reference of AutoConnectAux and a reference of PageArgument, it returns String. AutoConnect appends the string returned from the handler to the generated HTML. This allows you to add an HTML part before displaying the page. AutoConnectExitOrder_t specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. The following example is a part of sketch contained the handlers. // AutoConnect object declarations ACInput(input1); AutoConnectAux aux ( \"/aux\" , { input1 }); AutoConnect portal; // Pre-declare handlers String initialize (AutoConnectAux & , PageArgument & ); String append (AutoConnectAux & , PageArgument & ); // Register handlers and launch the portal. aux.on(initialize, AC_AHEAD); aux.on(append, AC_LATER); portal.join(aux); portal.begin(); // Some code here... // The handler called before HTML generating String initialize (AutoConnectAux & aux, PageArgument & args) { AutoConnectInput & input1 = aux.getElement < AutoConnectInput > ( \"input1\" ); // Set initial value for the input box in a custom Web page. input1.value = \"Initial value\" ; // Nothing appendix for a generated HTML. return String(); } // The handler called after HTML generated String append (AutoConnectAux & aux, PageArgument & args) { // Append an HTML return String( \"<p>This text has been added.</p>\" ); } How you can reach the values \u00b6 AutoConnectSubmit uses the POST method to send HTTP requests. A value of AutoConnectInput sent to the ESP8266 or ESP32 with POST is stored in the request body of the HTTP request: POST /feels HTTP/1.1 Host: ESP8266_IP_ADDRESS name1=value1&name2=value2&name3=value3 ESP8266WebServer class will parse the query string and rebuilds its arguments when the above request arrives. A custom page handler registered with the ESP8266WebServer::on function can access the value of AutoConnectElements with ESP8266WebServe::arg function. It reaches the values of AutoConnectElements without the intermediation of AutoConnect. Therefore, its handler will not be AutoConnectAux and can send a response to the client directly. The following example is part of a server sketch which has two web pages. The /hello page is a custom Web page of AutoConnectAux which has an input box named \"input1\". Another /echo page is a page handler for ESP8266WebServer, which uses the ESP8266WebServer::send function to echo back the value of an input1 as an http response. ESP8266WebServer server; AutoConnect portal (server); ACInput(input1, \"\" , \"INPUT\" ); ACSubmit(send, \"HELLO\" , \"/echo\" ); AutoConnectAux aux ( \"/hello\" , { input1, send }); server.on( \"/echo\" , []() { String echo = server.arg( \"input1\" ); Serial.println(echo); server.send( 200 , \"text/plain\" , echo); }); portal.join(aux); portal.begin(); Also, you can choose another way to access arguments without going through the ESP8266WebServer class. The PageArgument object of the custom Web page handler argument is a copy of the arg object of the ESP8266WebServer class. Either of these methods is a simple and easy way to access parameters in custom Web page handlers. However, if you need to access from outside of the handler to the value of AutoConnectElements, you need to accomplish it using with the AutoConnectAux::getElement function. The following sketch code replaces the above example with JSON and PageArgument, and its behaves is equivalent basically to the above sketch. const static char auxPage[] PROGMEM = R \"raw ( [ { \"title\" : \"Hello\" , \"uri\" : \"/hello\" , \"menu\" : true, \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" , \"label\" : \"INPUT\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"value\" : \"HELLO\" , \"uri\" : \"/echo\" }] }, { \"title\" : \"Echo\" , \"uri\" : \"/echo\" , \"menu\" : false, \"element\" : [ { \"name\" : \"echo\" , \"type\" : \"ACText\" }] } ] )raw \"; AutoConnect portal; portal.load(auxPage); portal.on( \"/echo\" , [](AutoConnectAux & aux, PageArgument & args) { AutoConnectText & ac_echo = aux.getElement < AutoConnectText > ( \"echo\" ); ac_echo.value = args.arg( \"input1\" ); return String (); }); portal.begin(); Over typing \u200b\u200bwith LoadElement function \u00b6 The AutoConnectAux::loadElement function overwrites its value when loading an AutoConnectElement. If the loadElement function wields an element with an input value, the previous value will be lost by the loaded value. If you need to preserve input values \u200b\u200beven during page transition operations, we recommend that you load parameters only once at an early stage in the setup() of sketches. Check data against on submission \u00b6 Convert data to actually type \u00b6 Transitions of the custom Web pages \u00b6 The URI of the custom Web pages \u00b6 The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the ESP8266WebServer::on / WebServer::on function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the AutoConnectAux::on function. In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section. Restrictions \u00b6 The custom Web pages handler has the following restrictions. Do not send HTTP responses from the handler. If the handler returns its own response, the custom Web page will be lost. Use AutoConnectSubmit whenever possible. AutoConnect will hold the values of a custom Web Page is sent by AutoConnectSubmit. Can not handle the custom Web pages during a connection is not established yet. During the connection attempt, the web browser of the client will send a probe for a captive portal. Its request will cause unintended custom Web page transitions. Can not place URI of the custom Web pages to AUTOCONNECT_URI]. AutoConnect will not work if you place a custom Web page to AUTOCONNECT_URI . 302 Redirect Alternatives To transition from a custom Web page to a sketch owned page, execute the link function of JavaScript with the AutoConnectElement element. The valid scope of the name is within an AutoConnectAux. \u21a9","title":"Handling the custom Web pages"},{"location":"achandling.html#handing-autoconnectelements-with-the-sketches","text":"AutoConnectElements (i.e. they are the elements displayed on the custom Web page) must be contained in AutoConnectAux object. AutoConnectElements declared in sketch must be programmed to add to AutoConnectAux one after another. Elements are automatically included in AutoConnectAux by AutoConnect if you load it from the JSON description. In either method, it is common to use the function of AutoConnectAux to access an element with a sketch. The AutoConnectAux class has several functions to manipulate AutoConnectElements. The functions can add, delete, retrieve elements, and get and set values.","title":"Handing AutoConnectElements with the sketches"},{"location":"achandling.html#add-autoconnectelements-to-the-autoconnectaux-object","text":"To add AutoConnectElment(s) to an AutoConnectAux object, use the add function. void AutoConnectAux :: add(AutoConenctElement & addon) void AutoConnectAux :: add(AutoConenctElementVT addons) The add function adds specified AutoConnectElement to the AutoConnectAux. If specified the collection of AutoConnectElements as a std::vector of the references to each element, these elements added in bulk. The AutoConnectElements contained in the AutoConnectAux object are uniquely identified by the name. When adding an AutoConnectElement, if an element with the same name already exists in the AutoConnectAux, checking the type, and if it is the same, the value will be replaced. If another type of AutoConnectElement exists with the same name, that add operation will be invalid. 1 In the following example, an AutoConnectButton as button addition is invalid. AutoConnectAux aux; AutoConnectText text ( \"hello\" , \"hello, world\" ); AutoConnectButton button ( \"hello\" , \"hello, world\" , \"alert('Hello world!')\") ; // This is invalid. aux.add({ text, button }); Similarly this, the uniqueness of the name is also necessary within the JSON document { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true , \"element\" : [ { \"name\" : \"hello\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"hello\" , \"type\" : \"ACButton\" , \"value\" : \"hello, world\" , \"action\" : \"alert('Hello world!')\" } ] } Load all elements from JSON document If you load all AutoConnectElements from JSON document into AutoConnect, you do not need to sketch the population process of the AutoConnectElements. It is managed by the AutoConnect library automatically.","title":" Add AutoConnectElements to the AutoConnectAux object"},{"location":"achandling.html#get-autoconnectelement-from-the-autoconnectaux","text":"To retrieve an element from AutoConnectAux, use the getElement or getElements function. Normally, the getElement is needed when accessing the value of AutoConnectElement in the sketch. AutoConnectElement * AutoConnectAux :: getElement( const String & name); template < typename T > T & AutoConnectAux :: getElement( const String & name); AutoConnectElementVT * AutoConnectAux :: getElements( void ); The getElement function returns an AutoConnectElement with the specified name as a key. When you use this function, you need to know the type of AutoConnectElement in advance. To retrieve an AutoConnectElement by specifying its type, use the following method. AutoConnectAux aux; aux.load( \"SOME_JSON_DOCUMENT\" ); // Retrieve the pointer of the AutoConnectText AutoConnectText * text = reinterpret_cast < AutoConnectText *> (aux.getElement( \"TEXT_ELEMENT_NAME\" )); // Retrieve the reference of the AutoConnectText AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_ELEMENT_NAME\" ); The AutoConnectElement type behaves as a variant of other element types. Therefore use cast or template to convert to actual type as above. In the sketch, you access the real type of AutoConnectElement after casting it and storing into the variable. const String auxJson = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); AutoConenct portal; portal.load(auxJson); AutoConnectAux * aux = portal.aux( \"/page1\" ); // Identify the AutoConnectAux instance with uri AutoConenctText & text = aux -> getElement < AutoConnectText > ( \"caption\" ); // Cast to real type and access members Serial.println(text.value); To get all the AutoConnectElements of an AutoConnectAux object use the getElements function. This function returns the vector of the reference wrapper as AutoConnectElementVT to all AutoConnectElements registered in the AutoConnectAux. AutoConnectElementVT & getElements( void ) AutoConnectElementVT is a predefined type for it and can use methods of std::vector < std::reference_wrapper >.","title":" Get AutoConnectElement from the AutoConnectAux"},{"location":"achandling.html#loading-saving-autoconnectelements-with-json","text":"AutoConnect supports reading the custom Web page definitions written in JSON and also supports loading and saving of AutoConnectElements. In both cases, the target object is a JSON document for AutoConnect . However, it can not save all AutoConnectElements contained in the page as a custom Web page. (ie. AutoConnectAux)","title":"Loading &amp; saving AutoConnectElements with JSON"},{"location":"achandling.html#loading-autoconnectaux-autoconnectelements-with-json","text":"To load a JSON document as AutoConnectAux use the AutoConnect::load function and load the JSON document of each AutoConnectElement using the AutoConnectAux::loadElement function. Although the functions of both are similar, the structure of the target JSON document is different. The AutoConnect::load function loads the entire AutoConnectAux and creates both the AutoConnectAux instance and each AutoConnectElement instance. A single JSON document can contain multiple custom Web pages. If you write JSON of AutoConnectAux as an array, the load function generates all the pages contained in that array. Therefore, it is necessary to supply the JSON document of AutoConnectAux as an input of the load function and must contain the elements described here . The AutoConnectAux::loadElement function loads the elements individually into an AutoConnectAux object. The structure of its supplying JSON document is not AutoConnectAux. It must be a JSON structure for AutoConnectElement , but you can specify an array. // AutoConnectAux as a custom Web page. const char page[] PROGMEM = R\"raw( { \"title\": \"Settings\", \"uri\": \"/settings\", \"menu\": true, \"element\": [ { \"name\": \"server\", \"type\": \"ACInput\", \"label\": \"Server\" }, { \"name\": \"set\", \"type\": \"ACSubmit\", \"value\": \"SET\", \"uri\" : \"/set\" } ] } )raw\" ; // Additional AutoConnectElements. const char addons[] PROGMEM = R\"raw( [ { \"name\": \"notes\", \"type\": \"ACText\", \"value\": \"An update period as the below optionally.\" }, { \"name\": \"period\", \"type\": \"ACRadio\", \"value\": [ \"30 sec.\", \"60 sec.\", \"180 sec.\" ], \"arrange\": \"vertical\", \"checked\": 1 } ] )raw\" ; AutoConnect portal; AutoConnectAux * auxPage; // Load a custom Web page. portal.load(page); // Get a '/settings' page auxPage = portal.aux( \"/settings\" ); // Also, load only AutoConnectRadio named the period. auxPage -> loadElement(addons, \"period\" ); // Retrieve a server name from an AutoConnectText value. AutoConnectText & serverName = auxPage -> getElement < AutoConnectText > ( \"server\" ); Serial.println(serverName.value);","title":" Loading AutoConnectAux &amp; AutoConnectElements with JSON"},{"location":"achandling.html#saving-autoconnectelements-with-json","text":"To save the AutoConnectElement as a JSON document, use the AutoConnectAux::saveElement function. It serializes the contents of the object based on the type of the AutoConnectElement. You can persist a serialized AutoConnectElements as a JSON document to a stream. // Open a parameter file on the SPIFFS. SPIFFS.begin(); FILE param = SPIFFS.open( \"/param\" , \"w\" ); // Save elements as the parameters. auxPage -> saveElement(param, { \"server\" , \"period\" }); // Close a parameter file. param.close(); SPIFFS.end(); The example above saves server and period elements from the AutoConnectAux object as mentioned above to the /param file on SPIFFS. Its JSON document of AutoConnectElements saved by its code looks like this: [ { \"name\" : \"server\" , \"type\" : \"ACInput\" , \"value\" : \"An inputted server name\" , \"label\" : \"Server\" , \"placeholder\" : \"\" }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"arrange\" : \"vertical\" , \"checked\" : 2 } ]","title":" Saving AutoConnectElements with JSON"},{"location":"achandling.html#custom-field-data-handling","text":"A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored in the member variable of each element by AutoConnect whenever GET/POST transmission occurs. The following diagram shows the flow of the input values of a custom Web page into a sketch and is the basis for actions to manipulate the values of custom Web pages using sketches.","title":"Custom field data handling"},{"location":"achandling.html#where-to-pick-up-the-values","text":"A sketch composed of handlers can receive the value of AutoConnectElements entered in a custom Web page after sending, but that handler is different from the page where the value was entered. It is necessary to be aware that can accept the entered values by the next page handler after the transition. Usually, two ways to retrieve entered values we have. One is to use the ESP8266WebServer::arg (or WebServer::arg for ESP32) function in the on handler attached by ESP8266WebServer (WebServer w/ESP32 also). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char addonJson[] PROGMEM = R\"raw( { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] } )raw\" ; ESP8266WebServer webServer; AutoConnect portal (webServer); // Here, /feels handler void feelsOn () { // Retrieve the value of a input-box named \"feels\" String feel = webServer.arg( \"feels\" ); // Echo back the value String echo = \"<html><p style= \\\" color:blue;font-family:verdana;font-size:300%; \\\" >\" + feel + String( \" and a bold world!</p></html>\" ); webServer.send( 200 , \"text/html\" , echo); } void setup () { delay( 1000 ); webServer.on( \"/feels\" , feelsOn); // Register /feels handler portal.load(addonJson); // Load a custom Web page portal.begin(); } void loop () { portal.handleClient(); } An above example is the most simple sketch of handling values entered into a custom Web page. This sketch obtains the string entered in the AutoConnectInput named feels with the /feels handler after page transition, and the AutoConnectInput is an <input type=\"text\" name=\"feels\"> element wrapped in the form as the actual HTML code. Should be accessed /_ac first When you actually try the above sketch, there is no a root handler. So the URL that should be accessed first is /_ac concatenated with the local IP address of the esp8266 module. Another method is effective when custom Web pages have complicated page transitions. It is a way to straight access the AutoConnectElements member value. You can get the AutoConnectElement with the specified name using the getElement function. The following sketch executes the above example with AutoConnect only, without using the function of ESP8266WebServer. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> const static char addonJson[] PROGMEM = R\"raw( [ { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] }, { \"title\": \"Hello\", \"uri\": \"/feels\", \"menu\": false, \"element\": [ { \"name\": \"echo\", \"type\": \"ACText\", \"style\": \"color:blue;font-family:verdana;font-size:300%;\" } ] } ] )raw\" ; AutoConnect portal; // Here, /feels handler String feelsOn (AutoConnectAux & aux, PageArgument & args) { // Get the AutoConnectInput named \"feels\". // The where() function returns the AutoConnectAux of the page that triggered this handler. AutoConnectInput & feels = portal.where() -> getElement < AutoConnectInput > ( \"feels\" ); // Get the AutoConnectText named \"echo\". AutoConnectText & echo = aux.getElement < AutoConnectText > ( \"echo\" ); // Echo back from input-box to /feels page. echo.value = feels.value + String( \" and a bold world!\" ); return String( \"\" ); } void setup () { delay( 1000 ); portal.load(addonJson); // Load custom Web pages portal.on( \"/feels\" , feelsOn, AC_EXIT_AHEAD); // Register /feels handler portal.begin(); } void loop () { portal.handleClient(); } The above example handles in the handler for the values of a custom web page. An AutoConnect::on function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the PageArgument object. To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the AutoConnect::where function. The AutoConnect::where function returns a pointer to the AutoConnectAux object of the custom Web page that caused the HTTP request. The where() function is available for only AutoConnectAux. The AutoConnect::where function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/ESP32. In other words, the AutoConnect::where function only returns the last AutoConnecAux page called.","title":" Where to pick up the values"},{"location":"achandling.html#when-setting-the-initial-values","text":"An AutoConnectAux page is dynamically created by AutoConnect when its uri is requested. The initial value of AutoConnectElements can be set before its page request. It is also possible during loop() . To set the initial value when the page is accessed it needs by the handler of its page. The AutoConnect::on and AutoConnectAux::on functions register a handler for a custom Web page and also specify when to call that handler. The behavior of the two on functions is the same, only the class and arguments are different. bool AutoConnect :: on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order) void AutoConnectAux :: on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order) Parameter uri specifies an URI of the custom Web page, but an AutoConnectAux object with its URI must be registered with AutoConnect via the AutoConnect::join function beforehand. AutoConnect::on/AutoConnectAux::on is not ESP8266WebServer::on The on function for AutoConnect is different from the on function of Arduino core ESP8266WebServer (WebServer for ESP32). You can share the same handler via wrapper, but access to AutoConnectElements is valid only for handlers registered with on function for AutoConnect . AuxHandlerFunctionT type is a handler declaration using with std::function . String handler(AutoConnectAux & aux, PageArgument & args) The handler of the custom Web page has two arguments by a reference of AutoConnectAux and a reference of PageArgument, it returns String. AutoConnect appends the string returned from the handler to the generated HTML. This allows you to add an HTML part before displaying the page. AutoConnectExitOrder_t specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. The following example is a part of sketch contained the handlers. // AutoConnect object declarations ACInput(input1); AutoConnectAux aux ( \"/aux\" , { input1 }); AutoConnect portal; // Pre-declare handlers String initialize (AutoConnectAux & , PageArgument & ); String append (AutoConnectAux & , PageArgument & ); // Register handlers and launch the portal. aux.on(initialize, AC_AHEAD); aux.on(append, AC_LATER); portal.join(aux); portal.begin(); // Some code here... // The handler called before HTML generating String initialize (AutoConnectAux & aux, PageArgument & args) { AutoConnectInput & input1 = aux.getElement < AutoConnectInput > ( \"input1\" ); // Set initial value for the input box in a custom Web page. input1.value = \"Initial value\" ; // Nothing appendix for a generated HTML. return String(); } // The handler called after HTML generated String append (AutoConnectAux & aux, PageArgument & args) { // Append an HTML return String( \"<p>This text has been added.</p>\" ); }","title":" When setting the initial values"},{"location":"achandling.html#how-you-can-reach-the-values","text":"AutoConnectSubmit uses the POST method to send HTTP requests. A value of AutoConnectInput sent to the ESP8266 or ESP32 with POST is stored in the request body of the HTTP request: POST /feels HTTP/1.1 Host: ESP8266_IP_ADDRESS name1=value1&name2=value2&name3=value3 ESP8266WebServer class will parse the query string and rebuilds its arguments when the above request arrives. A custom page handler registered with the ESP8266WebServer::on function can access the value of AutoConnectElements with ESP8266WebServe::arg function. It reaches the values of AutoConnectElements without the intermediation of AutoConnect. Therefore, its handler will not be AutoConnectAux and can send a response to the client directly. The following example is part of a server sketch which has two web pages. The /hello page is a custom Web page of AutoConnectAux which has an input box named \"input1\". Another /echo page is a page handler for ESP8266WebServer, which uses the ESP8266WebServer::send function to echo back the value of an input1 as an http response. ESP8266WebServer server; AutoConnect portal (server); ACInput(input1, \"\" , \"INPUT\" ); ACSubmit(send, \"HELLO\" , \"/echo\" ); AutoConnectAux aux ( \"/hello\" , { input1, send }); server.on( \"/echo\" , []() { String echo = server.arg( \"input1\" ); Serial.println(echo); server.send( 200 , \"text/plain\" , echo); }); portal.join(aux); portal.begin(); Also, you can choose another way to access arguments without going through the ESP8266WebServer class. The PageArgument object of the custom Web page handler argument is a copy of the arg object of the ESP8266WebServer class. Either of these methods is a simple and easy way to access parameters in custom Web page handlers. However, if you need to access from outside of the handler to the value of AutoConnectElements, you need to accomplish it using with the AutoConnectAux::getElement function. The following sketch code replaces the above example with JSON and PageArgument, and its behaves is equivalent basically to the above sketch. const static char auxPage[] PROGMEM = R \"raw ( [ { \"title\" : \"Hello\" , \"uri\" : \"/hello\" , \"menu\" : true, \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" , \"label\" : \"INPUT\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"value\" : \"HELLO\" , \"uri\" : \"/echo\" }] }, { \"title\" : \"Echo\" , \"uri\" : \"/echo\" , \"menu\" : false, \"element\" : [ { \"name\" : \"echo\" , \"type\" : \"ACText\" }] } ] )raw \"; AutoConnect portal; portal.load(auxPage); portal.on( \"/echo\" , [](AutoConnectAux & aux, PageArgument & args) { AutoConnectText & ac_echo = aux.getElement < AutoConnectText > ( \"echo\" ); ac_echo.value = args.arg( \"input1\" ); return String (); }); portal.begin();","title":" How you can reach the values"},{"location":"achandling.html#over-typing-with-loadelement-function","text":"The AutoConnectAux::loadElement function overwrites its value when loading an AutoConnectElement. If the loadElement function wields an element with an input value, the previous value will be lost by the loaded value. If you need to preserve input values \u200b\u200beven during page transition operations, we recommend that you load parameters only once at an early stage in the setup() of sketches.","title":" Over typing \u200b\u200bwith LoadElement function"},{"location":"achandling.html#check-data-against-on-submission","text":"","title":" Check data against on submission"},{"location":"achandling.html#convert-data-to-actually-type","text":"","title":" Convert data to actually type"},{"location":"achandling.html#transitions-of-the-custom-web-pages","text":"","title":"Transitions of the custom Web pages"},{"location":"achandling.html#the-uri-of-the-custom-web-pages","text":"The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the ESP8266WebServer::on / WebServer::on function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the AutoConnectAux::on function. In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section.","title":"The URI of the custom Web pages"},{"location":"achandling.html#restrictions","text":"The custom Web pages handler has the following restrictions. Do not send HTTP responses from the handler. If the handler returns its own response, the custom Web page will be lost. Use AutoConnectSubmit whenever possible. AutoConnect will hold the values of a custom Web Page is sent by AutoConnectSubmit. Can not handle the custom Web pages during a connection is not established yet. During the connection attempt, the web browser of the client will send a probe for a captive portal. Its request will cause unintended custom Web page transitions. Can not place URI of the custom Web pages to AUTOCONNECT_URI]. AutoConnect will not work if you place a custom Web page to AUTOCONNECT_URI . 302 Redirect Alternatives To transition from a custom Web page to a sketch owned page, execute the link function of JavaScript with the AutoConnectElement element. The valid scope of the name is within an AutoConnectAux. \u21a9","title":"Restrictions"},{"location":"acintro.html","text":"What it is \u00b6 AutoConnect can handle custom Web pages prepared by user sketches individually. Custom Web pages are displayed in the AutoConnect menu and can be used from there. It can also have input-output parameters and handle it with sketches. For example, you can program some sketches that publish messages by entering the URI or unique ID of the MQTT broker on a custom page. You do not need to code the processing to handle the web page, it retrieves the input parameters and passes to the MQTT broker connection API is only. How it works \u00b6 Custom Web pages are dynamically created by AutoConnect. The Classes and APIs necessary for dynamic creation are provided. AutoConnectAux is an object dependent on AutoConnect, which provides an easy way to incorporate custom Web pages like the one on the right figure into AutoConnect. The elements that make up a custom web page are provided as an AutoConnectElement class. Furthermore, an input box, a check box, a submit button, etc. are implemented by classes derived from AutoConnectElement. AutoConnectAux is a container for AutoConnectElements. To make a custom Web page, create elements that make up the page and put it in the AutoConnectAux object. Joining its AutoConnectAux object to AutoConnect will integrate the custom Web page into the AutoConnect menu. The above figure shows a code sequence that declares AutoConnectElements and put in the AutoConnectAux container and integrates those into AutoConnect. It declares two text elements named ' header 'and ' caption ', adds them to the AutoConnectAux object ' aux ', binds to an AutoConnect object named ' portal '. It's the basic procedure for configuring the custom Web page. Also, further explanation of AutoConnectElements is the documentation . Custom Web pages in AutoConnect menu \u00b6 Custom Web pages as AutoConnectAux are integrated into the AutoConnect menu . AutoConnectAux object contains member variables which are URI and the title. It also has an indicator to show on the AutoConnect menu. You give the title and URI of the custom web page to the AutoConnectAux object with Sketch. Then the title of the custom Web page would be displayed at the bottom of the AutoConnect menu as the left figure. 1 It is a hyperlink as URI you given to the custom Web page and taps it will display a page composed of AutoConnectElements. Also, a title will display in the upper left corner of the page, which includes a hyperlink to the AutoConnect statistics screen. Multiple custom Web pages \u00b6 You can create multiple custom Web pages and specify which pages you can invoke from the menu. In the sketch below, it shows the sequence of codes to integrate three custom Web pages into one and embed them into the menu. In the above code, the third parameter of ' aux2 ' is false . The third parameter of the AutoConnectAux constructor is an indicator of whether it's shown to the AutoConnect menu. Right animation is the execution result of the above code. You will see that the custom Web page's menu is displayed only in the last two lines. The sketch of this animation is written to transition to ' aux2 ' by the utility of the AutoConnectSubmit element owned by ' aux1 '. 2 An ' aux2 ' page transitions only from the ' aux1 '. It is a page that saves the parameters you entered on the previous page as shown in mqttRSSI in the library example. It is to want to hide ' aux2 ' from AutoConnect menu lines. The utility of the third parameter of the AutoConnectAux constructor is that. Basic steps to use custom Web pages \u00b6 So, the basic procedure for handling of the custom Web pages is as follows: Create or define AutoConnectAux. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . Write the custom Web page with JSON \u00b6 You can write the custom Web page in JSON without using sketch codes. 3 It is possible to describe the entire page in JSON and can be described for each element also. The JSON description can be saved in SPIFFS or SD and read using AutoConnect's load function. If you take this approach, you can further reduce the steps of the above but this way consumes a lot of memory. The following JSON code and sketch will execute the custom Web page as the example in the above figure. That is, the sketch of this code and footnote 2 is equivalent. custom_page.json [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"MQTT broker settings\" }, { \"name\" : \"caption1\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi...\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"SAVE\" , \"uri\" : \"/mqtt_save\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption2\" , \"type\" : \"ACText\" , \"value\" : \"Save parameters\" }, { \"name\" : \"start\" , \"type\" : \"ACSubmit\" , \"value\" : \"START\" , \"uri\" : \"/mqtt_start\" } ] }, { \"title\" : \"MQTT Start\" , \"uri\" : \"/mqtt_start\" , \"menu\" : true , \"element\" : [] } ] The sketch #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> AutoConnect portal; void setup () { SPIFFS.begin(); File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); SPIFFS.end(); portal.begin(); } void loop () { portal.handleClient(); } Passing parameters with sketches and custom Web pages \u00b6 A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored to the member variables of the element by AutoConnect whenever GET / POST transmission occurs. Your sketches can get these values with the GET / POST request handler. If you assign a value to an element before a request to the page occurs, its value will appear as the initial value when the page is displayed. Details are explained in the Parameter handling . window.onload = function() { Gifffer(); }; There is no overlay in the actual menu. \u21a9 The sketch is actually this: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; ACText(header, \"MQTT broker settings\" ); ACText(caption1, \"Publishing the WiFi...\" ); ACSubmit(save, \"SAVE\" , \"/mqtt_save\" ); AutoConnectAux aux1 ( \"/mqtt_setting\" , \"MQTT Setting\" , { header, caption1, save }); ACText(caption2, \"Save parameters\" ); ACSubmit(start, \"START\" , \"/mqtt_start\" ); AutoConnectAux aux2 ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, start }); AutoConnectAux aux3 ( \"/mqtt_start\" , \"MQTT Start\" ); void setup () { portal.join({ aux1, aux2, aux3 }); portal.begin(); } void loop () { portal.handleClient(); } \u21a9 Installation of the ArduinoJson as the latest release of version 5 series is required. \u21a9","title":"Custom Web pages with AutoConnect"},{"location":"acintro.html#what-it-is","text":"AutoConnect can handle custom Web pages prepared by user sketches individually. Custom Web pages are displayed in the AutoConnect menu and can be used from there. It can also have input-output parameters and handle it with sketches. For example, you can program some sketches that publish messages by entering the URI or unique ID of the MQTT broker on a custom page. You do not need to code the processing to handle the web page, it retrieves the input parameters and passes to the MQTT broker connection API is only.","title":"What it is"},{"location":"acintro.html#how-it-works","text":"Custom Web pages are dynamically created by AutoConnect. The Classes and APIs necessary for dynamic creation are provided. AutoConnectAux is an object dependent on AutoConnect, which provides an easy way to incorporate custom Web pages like the one on the right figure into AutoConnect. The elements that make up a custom web page are provided as an AutoConnectElement class. Furthermore, an input box, a check box, a submit button, etc. are implemented by classes derived from AutoConnectElement. AutoConnectAux is a container for AutoConnectElements. To make a custom Web page, create elements that make up the page and put it in the AutoConnectAux object. Joining its AutoConnectAux object to AutoConnect will integrate the custom Web page into the AutoConnect menu. The above figure shows a code sequence that declares AutoConnectElements and put in the AutoConnectAux container and integrates those into AutoConnect. It declares two text elements named ' header 'and ' caption ', adds them to the AutoConnectAux object ' aux ', binds to an AutoConnect object named ' portal '. It's the basic procedure for configuring the custom Web page. Also, further explanation of AutoConnectElements is the documentation .","title":"How it works"},{"location":"acintro.html#custom-web-pages-in-autoconnect-menu","text":"Custom Web pages as AutoConnectAux are integrated into the AutoConnect menu . AutoConnectAux object contains member variables which are URI and the title. It also has an indicator to show on the AutoConnect menu. You give the title and URI of the custom web page to the AutoConnectAux object with Sketch. Then the title of the custom Web page would be displayed at the bottom of the AutoConnect menu as the left figure. 1 It is a hyperlink as URI you given to the custom Web page and taps it will display a page composed of AutoConnectElements. Also, a title will display in the upper left corner of the page, which includes a hyperlink to the AutoConnect statistics screen.","title":"Custom Web pages in AutoConnect menu"},{"location":"acintro.html#multiple-custom-web-pages","text":"You can create multiple custom Web pages and specify which pages you can invoke from the menu. In the sketch below, it shows the sequence of codes to integrate three custom Web pages into one and embed them into the menu. In the above code, the third parameter of ' aux2 ' is false . The third parameter of the AutoConnectAux constructor is an indicator of whether it's shown to the AutoConnect menu. Right animation is the execution result of the above code. You will see that the custom Web page's menu is displayed only in the last two lines. The sketch of this animation is written to transition to ' aux2 ' by the utility of the AutoConnectSubmit element owned by ' aux1 '. 2 An ' aux2 ' page transitions only from the ' aux1 '. It is a page that saves the parameters you entered on the previous page as shown in mqttRSSI in the library example. It is to want to hide ' aux2 ' from AutoConnect menu lines. The utility of the third parameter of the AutoConnectAux constructor is that.","title":"Multiple custom Web pages"},{"location":"acintro.html#basic-steps-to-use-custom-web-pages","text":"So, the basic procedure for handling of the custom Web pages is as follows: Create or define AutoConnectAux. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() .","title":"Basic steps to use custom Web pages"},{"location":"acintro.html#write-the-custom-web-page-with-json","text":"You can write the custom Web page in JSON without using sketch codes. 3 It is possible to describe the entire page in JSON and can be described for each element also. The JSON description can be saved in SPIFFS or SD and read using AutoConnect's load function. If you take this approach, you can further reduce the steps of the above but this way consumes a lot of memory. The following JSON code and sketch will execute the custom Web page as the example in the above figure. That is, the sketch of this code and footnote 2 is equivalent. custom_page.json [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"MQTT broker settings\" }, { \"name\" : \"caption1\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi...\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"SAVE\" , \"uri\" : \"/mqtt_save\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption2\" , \"type\" : \"ACText\" , \"value\" : \"Save parameters\" }, { \"name\" : \"start\" , \"type\" : \"ACSubmit\" , \"value\" : \"START\" , \"uri\" : \"/mqtt_start\" } ] }, { \"title\" : \"MQTT Start\" , \"uri\" : \"/mqtt_start\" , \"menu\" : true , \"element\" : [] } ] The sketch #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> AutoConnect portal; void setup () { SPIFFS.begin(); File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); SPIFFS.end(); portal.begin(); } void loop () { portal.handleClient(); }","title":"Write the custom Web page with JSON"},{"location":"acintro.html#passing-parameters-with-sketches-and-custom-web-pages","text":"A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored to the member variables of the element by AutoConnect whenever GET / POST transmission occurs. Your sketches can get these values with the GET / POST request handler. If you assign a value to an element before a request to the page occurs, its value will appear as the initial value when the page is displayed. Details are explained in the Parameter handling . window.onload = function() { Gifffer(); }; There is no overlay in the actual menu. \u21a9 The sketch is actually this: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; ACText(header, \"MQTT broker settings\" ); ACText(caption1, \"Publishing the WiFi...\" ); ACSubmit(save, \"SAVE\" , \"/mqtt_save\" ); AutoConnectAux aux1 ( \"/mqtt_setting\" , \"MQTT Setting\" , { header, caption1, save }); ACText(caption2, \"Save parameters\" ); ACSubmit(start, \"START\" , \"/mqtt_start\" ); AutoConnectAux aux2 ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, start }); AutoConnectAux aux3 ( \"/mqtt_start\" , \"MQTT Start\" ); void setup () { portal.join({ aux1, aux2, aux3 }); portal.begin(); } void loop () { portal.handleClient(); } \u21a9 Installation of the ArduinoJson as the latest release of version 5 series is required. \u21a9","title":"Passing parameters with sketches and custom Web pages"},{"location":"acjson.html","text":"Describe custom Web pages with JSON \u00b6 You can embed custom Web pages written in JSON into AutoConnect without declaring AutoConnectAux & AutoConnectElements in sketches. Custom Web page declaration in JSON can be included in the sketch in advance as the fixed string, or it can be stored in the external file such as SPIFFS for stream loading. You can also load and save AutoConnectElements objects individually. 1 By providing the following JSON document to AutoConnect, you can include the custom Web page as the bellow: A JSON document for AutoConnect can also contain declarations of multiple custom web pages. If you fit those multiple pages in one JSON document, sketch processing for loading AutoConnectAux will degenerate further. Need ArduinoJson v5 To process the AutoConnectAux & AutoConnectElements written in the JSON is you need to install the ArduinoJson version 5 library. JSON objects & elements for the custom Web page \u00b6 JSON document structure for AutoConnectAux \u00b6 An AutoConnectAux is described by a JSON object. The elements that make up an object are as follows: { \"title\" : title, \"uri\" : uri, \"menu\" : true | false, \"element\" : element_array } title \u00b6 A title of the custom Web page. This is string value. String specified title will be displayed in the AutoConnection menu. uri \u00b6 String of URI path that specifies where to place the custom web page. It needs to be a location from the root path including ' / '. menu \u00b6 This is a Boolean value indicating whether to include the custom web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu. element \u00b6 Describe an array of JSON objects as element_array . It is a JSON object array of the AutoConnectElements that make up the custom Web page. Order of elements on a custom Web page The order in which AutoConnectElements are placed on a custom web page is the order in the JSON document. Multiple custom Web pages declaration in JSON document \u00b6 You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages: [ { \"title\" : \"Page 1 title\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page2\" } ] }, { \"title\" : \"Page 1 title\" , \"uri\" : \"/page2\" , \"menu\" : false , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"Good day\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page3\" } ] }, { \"title\" : \"Page 3 title\" , \"uri\" : \"/page3\" , \"menu\" : true , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"bye\" } ] } ] JSON object for AutoConnectElements \u00b6 AutoConnectElements in JSON description are described as an array in the element with arguments of each constructor . \"element\" : [ { \"name\" : name, \"type\" : type, key_according_to_type : the_value | array_of_value , key_according_to_type : the_value | array_of_value }, { the_nect_element } ] name \u00b6 A string of the name for the element. type \u00b6 A string of the type for the element. For this type, specify the following string corresponding to each element. AutoConnectButton: ACButton AutoConnectCheckbox: ACCheckbox AutoConnectElement: ACElement AutoConnectInput: ACInput AutoConnectRadio: ACRadio AutoConnectSelect: ACSelect AutoConnectSubmit: ACSubmit AutoConnectText: ACText key_according_to_type \u00b6 This is different for each AutoConnectElements type, and the key that can be specified by the type is determined. ACButton \u00b6 value : Specifies the button label. This value also applies to the value attribute of an HTML button tag. action : Specifies an action to be fire on a mouse click on the button. It is mostly used with a JavaScript to activate a script, or it directly describes a JavaScript. ACCheckbox \u00b6 value : Specifies the value to be supplied to the checkbox. It will be packed in the query string as name=value when the checkbox is ticked. label : Specifies a label of the checkbox. Its placement is always to the right of the checkbox. checked : Specifies checking status as a boolean value. The value of the checked checkbox element is packed in the query string and sent. ACElement \u00b6 value : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is. ACInput \u00b6 value : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string. label : Specifies a label of the input box. Its placement is always to the left of the input box. placeholder : Specifies short hint of the input box. ACRadio \u00b6 value : Specifies the collection of radio buttons as an array element. label : Specifies a label of the collection of radio buttons, not for each button. The arrangement will be the top or left side according to the arrange . arrange : Specifies the orientation of the radio buttons. Its value accepts one of the following: horizontal : Horizontal arrangement. vertical : Vertical arrangement. checked : Specifies the index number (1-based) of the radio buttons collection to be checked. ACSelect \u00b6 label : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list. option : Specifies the initial value collection of the drop-down list as an array element. ACSubmit \u00b6 value : Specifies a label of the submit button. uri : Specifies the URI to send form data when the button is clicked. ACText \u00b6 value : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style : Specifies the qualification style to give to the content and can use the style attribute format as it is. AutoConnect's JSON parsing process is not perfect It is based on ArduinoJson, but the process is simplified to save memory. As a result, even if there is an unnecessary key, it will not be an error. It is ignored. Loading JSON document \u00b6 AutoConnect supports loading of JSON document from the following instances: String PROGMEM Stream To load custom Web pages JSON document into AutoConnect, use the load function of the AutoConnect class. Its JSON document can read must be completed as a description interpretable by the ArduinoJson library. It cannot import custom Web pages if there are syntax errors for the JSON. If you can not see the custom Web page prepared by JSON, you can check the syntax with ArduinoJson Assistant . It is useful for pre-checking. bool AutoConnect :: load( const String & aux) bool AutoConnect :: load( const __FlashStringHelper * aux) bool AutoConnect :: load(Stream & aux) An example of using each function is as follows. AutoConnect portal; // Loading from String const String aux = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); portal.load(aux); // Loading from PROGMEM const char aux[] PROGMEM = R\"raw( { \"title\" : \"Page 1 title\", \"uri\" : \"/page1\", \"menu\" : true, \"element\" : [ { \"name\" : \"caption\", \"type\" : \"ACText\", \"value\" : \"hello, world\" } ] } )raw\" ; portal.load(aux); // Loading from Stream assumes \"aux.json\" file should be store in SPIFFS. File aux = SPIFFS.open( \"aux.json\" , \"r\" ); portal.load(aux); aux.close(); AutoConnect passes the given JSON document directly to the parseObject() function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory. Saving JSON document \u00b6 However, AutoConnect does not support saving AutoConnectAux as a whole custom Web page. If you want to persist an AutoConnectElements object, you need to save it as an AutoConenctElement object unit. AutoConnectAux has a function to write multiple elements to the stream in a batch. Loading and saving AutoConnect parameters adopt this method. \u21a9","title":"Custom Web pages with JSON"},{"location":"acjson.html#describe-custom-web-pages-with-json","text":"You can embed custom Web pages written in JSON into AutoConnect without declaring AutoConnectAux & AutoConnectElements in sketches. Custom Web page declaration in JSON can be included in the sketch in advance as the fixed string, or it can be stored in the external file such as SPIFFS for stream loading. You can also load and save AutoConnectElements objects individually. 1 By providing the following JSON document to AutoConnect, you can include the custom Web page as the bellow: A JSON document for AutoConnect can also contain declarations of multiple custom web pages. If you fit those multiple pages in one JSON document, sketch processing for loading AutoConnectAux will degenerate further. Need ArduinoJson v5 To process the AutoConnectAux & AutoConnectElements written in the JSON is you need to install the ArduinoJson version 5 library.","title":"Describe custom Web pages with JSON"},{"location":"acjson.html#json-objects-elements-for-the-custom-web-page","text":"","title":"JSON objects &amp; elements for the custom Web page"},{"location":"acjson.html#json-document-structure-for-autoconnectaux","text":"An AutoConnectAux is described by a JSON object. The elements that make up an object are as follows: { \"title\" : title, \"uri\" : uri, \"menu\" : true | false, \"element\" : element_array }","title":" JSON document structure for AutoConnectAux"},{"location":"acjson.html#title","text":"A title of the custom Web page. This is string value. String specified title will be displayed in the AutoConnection menu.","title":" title"},{"location":"acjson.html#uri","text":"String of URI path that specifies where to place the custom web page. It needs to be a location from the root path including ' / '.","title":" uri"},{"location":"acjson.html#menu","text":"This is a Boolean value indicating whether to include the custom web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu.","title":" menu"},{"location":"acjson.html#element","text":"Describe an array of JSON objects as element_array . It is a JSON object array of the AutoConnectElements that make up the custom Web page. Order of elements on a custom Web page The order in which AutoConnectElements are placed on a custom web page is the order in the JSON document.","title":" element"},{"location":"acjson.html#multiple-custom-web-pages-declaration-in-json-document","text":"You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages: [ { \"title\" : \"Page 1 title\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page2\" } ] }, { \"title\" : \"Page 1 title\" , \"uri\" : \"/page2\" , \"menu\" : false , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"Good day\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page3\" } ] }, { \"title\" : \"Page 3 title\" , \"uri\" : \"/page3\" , \"menu\" : true , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"bye\" } ] } ]","title":" Multiple custom Web pages declaration in JSON document"},{"location":"acjson.html#json-object-for-autoconnectelements","text":"AutoConnectElements in JSON description are described as an array in the element with arguments of each constructor . \"element\" : [ { \"name\" : name, \"type\" : type, key_according_to_type : the_value | array_of_value , key_according_to_type : the_value | array_of_value }, { the_nect_element } ]","title":" JSON object for AutoConnectElements"},{"location":"acjson.html#name","text":"A string of the name for the element.","title":" name"},{"location":"acjson.html#type","text":"A string of the type for the element. For this type, specify the following string corresponding to each element. AutoConnectButton: ACButton AutoConnectCheckbox: ACCheckbox AutoConnectElement: ACElement AutoConnectInput: ACInput AutoConnectRadio: ACRadio AutoConnectSelect: ACSelect AutoConnectSubmit: ACSubmit AutoConnectText: ACText","title":" type"},{"location":"acjson.html#key_according_to_type","text":"This is different for each AutoConnectElements type, and the key that can be specified by the type is determined.","title":" key_according_to_type"},{"location":"acjson.html#acbutton","text":"value : Specifies the button label. This value also applies to the value attribute of an HTML button tag. action : Specifies an action to be fire on a mouse click on the button. It is mostly used with a JavaScript to activate a script, or it directly describes a JavaScript.","title":" ACButton"},{"location":"acjson.html#accheckbox","text":"value : Specifies the value to be supplied to the checkbox. It will be packed in the query string as name=value when the checkbox is ticked. label : Specifies a label of the checkbox. Its placement is always to the right of the checkbox. checked : Specifies checking status as a boolean value. The value of the checked checkbox element is packed in the query string and sent.","title":" ACCheckbox"},{"location":"acjson.html#acelement","text":"value : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is.","title":" ACElement"},{"location":"acjson.html#acinput","text":"value : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string. label : Specifies a label of the input box. Its placement is always to the left of the input box. placeholder : Specifies short hint of the input box.","title":" ACInput"},{"location":"acjson.html#acradio","text":"value : Specifies the collection of radio buttons as an array element. label : Specifies a label of the collection of radio buttons, not for each button. The arrangement will be the top or left side according to the arrange . arrange : Specifies the orientation of the radio buttons. Its value accepts one of the following: horizontal : Horizontal arrangement. vertical : Vertical arrangement. checked : Specifies the index number (1-based) of the radio buttons collection to be checked.","title":" ACRadio"},{"location":"acjson.html#acselect","text":"label : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list. option : Specifies the initial value collection of the drop-down list as an array element.","title":" ACSelect"},{"location":"acjson.html#acsubmit","text":"value : Specifies a label of the submit button. uri : Specifies the URI to send form data when the button is clicked.","title":" ACSubmit"},{"location":"acjson.html#actext","text":"value : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style : Specifies the qualification style to give to the content and can use the style attribute format as it is. AutoConnect's JSON parsing process is not perfect It is based on ArduinoJson, but the process is simplified to save memory. As a result, even if there is an unnecessary key, it will not be an error. It is ignored.","title":" ACText"},{"location":"acjson.html#loading-json-document","text":"AutoConnect supports loading of JSON document from the following instances: String PROGMEM Stream To load custom Web pages JSON document into AutoConnect, use the load function of the AutoConnect class. Its JSON document can read must be completed as a description interpretable by the ArduinoJson library. It cannot import custom Web pages if there are syntax errors for the JSON. If you can not see the custom Web page prepared by JSON, you can check the syntax with ArduinoJson Assistant . It is useful for pre-checking. bool AutoConnect :: load( const String & aux) bool AutoConnect :: load( const __FlashStringHelper * aux) bool AutoConnect :: load(Stream & aux) An example of using each function is as follows. AutoConnect portal; // Loading from String const String aux = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); portal.load(aux); // Loading from PROGMEM const char aux[] PROGMEM = R\"raw( { \"title\" : \"Page 1 title\", \"uri\" : \"/page1\", \"menu\" : true, \"element\" : [ { \"name\" : \"caption\", \"type\" : \"ACText\", \"value\" : \"hello, world\" } ] } )raw\" ; portal.load(aux); // Loading from Stream assumes \"aux.json\" file should be store in SPIFFS. File aux = SPIFFS.open( \"aux.json\" , \"r\" ); portal.load(aux); aux.close(); AutoConnect passes the given JSON document directly to the parseObject() function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory.","title":"Loading JSON document"},{"location":"acjson.html#saving-json-document","text":"However, AutoConnect does not support saving AutoConnectAux as a whole custom Web page. If you want to persist an AutoConnectElements object, you need to save it as an AutoConenctElement object unit. AutoConnectAux has a function to write multiple elements to the stream in a batch. Loading and saving AutoConnect parameters adopt this method. \u21a9","title":"Saving JSON document"},{"location":"advancedusage.html","text":"Advanced usage \u00b6 404 handler \u00b6 Registering the \"not found\" handler is a different way than ESP8266WebServer/WebServer. The onNotFound of ESP8266WebServer/WebServer does not work with AutoConnect. AutoConnect overrides ESP8266WebServer::onNotFound / WebServer::onNotFound to handle a captive portal. To register \"not found\" handler, use AutoConnect::onNotFound . Automatic reconnect \u00b6 When the captive portal is started, SoftAP starts and the STA is disconnected. The current SSID setting memorized in ESP8266 will be lost but then the reconnect behavior of ESP32 is somewhat different from this. The WiFiSTAClass::disconnect function implemented in the arduino-esp32 has extended parameters than the ESP8266's arduino-core. The second parameter of WiFi.disconnect on the arduino-esp32 core that does not exist in the ESP8266WiFiSTAClass has the effect of deleting the currently connected WiFi configuration and its default value is \"false\". On the ESP32 platform, even if WiFi.disconnect is executed, WiFi.begin() without the parameters in the next turn will try to connect to that AP. That is, automatic reconnection is implemented in arduino-esp32 already. Although this behavior appears seemingly competent, it is rather a disadvantage in scenes where you want to change the access point each time. When explicitly disconnecting WiFi from the Disconnect menu, AutoConnect will erase the AP connection settings saved by arduino-esp32 core. AutoConnect's automatic reconnection is a mechanism independent from the automatic reconnection of the arduino-esp32 core. If the autoReconnect option of the AutoConnectConfig class is enabled, it automatically attempts to reconnect to the disconnected past access point. When the autoReconnect option is specified, AutoConnect will not start SoftAP immediately if the first WiFi.begin fails. It will scan WiFi signal and the same connection information as the detected BSSID is stored in EEPROM as AutoConnect's credentials, explicitly apply it with WiFi.begin and rerun. AutoConnect Portal; AutoConnectConfig Config; Config.autoReconnect = true; Portal.config(Config); Portal.begin(); An autoReconnect option is available to AutoConnect::begin without SSID and pass passphrase. An autoReconnect will work if SSID detection succeeded An autoReconnect will not effect if the SSID which stored credential to be connected is a hidden access point. Auto save Credential \u00b6 By default, AutoConnect saves the credentials of the established connection in EEPROM. You can disable it with the autoSave parameter specified by AutoConnectConfig . AutoConnect Portal; AutoConnectConfig Config; Config.autoSave = AC_SAVECREDENTIAL_NEVER; Portal.config(Config); Portal.begin(); In ESP32, the credentials for AutoConnect are not in NVS The credentials used by AutoConnect are not saved in NVS on ESP32 module. ESP-IDF saves the WiFi connection configuration to NVS, but AutoConnect stores it on the EEPROM partition. You can find the partition table for default as default.csv Captive portal start detection \u00b6 The captive portal will only be activated if the first WiFi::begin fails. Sketch can detect with the AutoConnect::onDetect function that the captive portal has started. For example, the sketch can be written like as follows that turns on the LED at the start captive portal. AutoConnect Portal; bool startCP (IPAddress ip) { digitalWrite(BUILTIN_LED, HIGH); Serial.println( \"C.P. started, IP:\" + WiFi.localIP().toString()); return true; } void setup () { Serial.begin( 115200 ); pinMode(BUILTIN_LED, OUTPUT); digitalWrite(BUILTIN_LED, LOW); Portal.onDetect(startCP); if (Portal.begin()) { digitalWrite(BUILTIN_LED, LOW); } } void loop () { Portal.handleClient(); } Captive portal timeout control \u00b6 AutoConnect has two parameters for timeout control. One is a timeout value used when trying to connect to the specified AP. It behaves the same as general timeout control in connection attempt by WiFi.begin. This control is specified by the third parameter of AutoConnect::begin . Default value is macro defined by AUTOCONNECT_TIMEOUT in the AutoConnectDef.h file. The other is timeout control for the captive portal itself. It is useful when you want to continue sketch execution with offline even if the WiFi connection is not possible. You can also combine it with the immediateStart option to create sketches with high mobility. The timeout of the captive portal is specified together with AutoConnectConfig::portalTimeout as follows. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Also, if you want to stop AutoConnect completely when the captive portal is timed out, you need to call the AutoConnect::end function. It looks like the following code: bool acEnable; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); acEnable = portal.begin(); if ( ! acEnable) { portal.end(); } } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } if (acEnable) { portal.handleClient(); } } There is another option related to timeout in AutoConnectConfig. It can make use of the captive portal function even after a timeout. The AutoConnectConfig::retainPortal option will not stop the SoftAP when the captive portal is timed out. If you enable the ratainPortal option, you can try to connect to the AP at any time while continuing to sketch execution with offline even after the captive portal timed-out. The following code is its example. It can enable the captive portal after timed-out without changing sketch skeleton compared to the above code which does not specify an option. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds config.retainPortal = true; portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Cast items of your sketch own into the AutocCnnect menu \u00b6 If your sketch is handling your own web page, you can call that page from the AutoConnect menu . Unlike the custom Web pages by AutoConnectAux , this allows AutoConnect menu to legacy web pages registered by ESP8266WebServer::on / WebServer::on function. To implement this with your sketch, use only the AutoConnectAux constructed with the URI of that page. AutoConnectElements is not required. The basic procedure for this as follows. Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu. Sketch legacy page handlers. Register those handler functions to ESP8266WebServer/WebServer with the on function. Register AutoConnectAux declared with #1 to AutoConnect using AutoConnect::join function. It serves as a menu item. Begin the portal. Performs AutoConnect::handleClient in the loop function. For details see the Constructing menu section of Examples page. Change menu title \u00b6 Although the default menu title is AutoConnect , you can change the title by setting AutoConnectConfig::title . To set the menu title properly, you must set before calling AutoConnect::begin . AutoConnect Portal; AutoConnectConfig Config; void setup () { // Set menu title Config.title = \"FSBrowser\" ; Portal.config(Config); Portal.begin(); } Executing the above sketch will rewrite the menu title to FSBrowser as the below. Combination with mDNS \u00b6 With mDNS library , you can access to ESP8266 by name instead of IP address after connection. The sketch can start the MDNS responder after AutoConnect::begin . #include <ESP8266WiFi.h> #include <ESP8266mDNS.h> #include <ESP8266WebServer.h> AutoConnect Portal; void setup () { if (Portal.begin()) { if (MDNS.begin( \"esp8266\" )) { MDNS.addService( \"http\" , \"tcp\" , 80 ); } } } void loop () { Portal.handleClient(); } Debug print \u00b6 You can output AutoConnect monitor messages to the Serial . A monitor message activation switch is in an include header file AutoConnectDefs.h of library source. Define AC_DEBUG macro to output the monitor messages. 1 #define AC_DEBUG Disable the captive portal \u00b6 It can also prevent the captive portal from starting even if the connection at the first WiFi.begin fails. In this case, AutoConnect::begin behaves same as WiFi.begin . For disabling the captive portal, autoRise sets to false with AutoConnectConfig . AutoConnect portal; AutoConnectConfig acConfig; acConfig.autoRaise = false; portal.config(acConfig); portal.begin(); Make SSID of SoftAP unique \u00b6 You can change SoftAP's SSID and password programmatically when the captive portal starts up. By using chip specific ID of esp8266/esp32 you can make SSID of SoftAP unique. SSID and password for SoftAP is AutoConnectConfig::apid and AutoConnectConfig::psk . AutoConnect portal; AutoConnectConfig acConfig; acConfig.apid = \"ESP-\" + String(ESP.getChipId(), HEX); acConfig.psk = YOUR_PASSWORD; portal.config(acConfig); portal.begin(); Obtaining chip ID for ESP32 acConfig.apid = \"ESP-\" + String((uint32_t)(ESP.getEfuseMac() >> 32), HEX); Move the saving area of EEPROM for the credentials \u00b6 By default, the credentials saving area is occupied from the beginning of EEPROM area. ESP8266 Arduino core document says that: The following diagram illustrates flash layout used in Arduino environment: |--------------|-------|---------------|--|--|--|--|--| ^ ^ ^ ^ ^ Sketch OTA update File system EEPROM WiFi config (SDK) and EEPROM library uses one sector of flash located just after the SPIFFS . Also, the placement of the EEPROM area of ESP32 is described in the partition table . So in the default state, the credential storage area used by AutoConnect conflicts with data owned by the user sketch. It will be destroyed together saved data in EEPROM by user sketch and AutoConnect each other. But you can move the storage area to avoid this. The boundaryOffset in AutoConnectConfig specifies the start offset of the credentials storage area. The default value is 0. On-demand start the captive portal \u00b6 If you do not usually connect to WiFi and need to establish a WiFi connection if necessary, you can combine the autoRise option with the immediateStart option to achieve on-demand connection. This behavior is similar to the WiFiManager's startConfigPortal function. In order to do this, you usually configure only with AutoConnectConfig in setup() and AutoConnect::begin() handles in loop() . AutoConnect Portal; AutoConnectConfig Config; void setup () { Config.autoRise = false; Config.immediateStart = true; Portal.config(Config); } void loop () { if (digitalRead(TRIGGER_PIN) == LOW) { while (digitalRead(TRIGGER_PIN) == LOW) yield(); Portal.begin(); } Portal.handleClient(); } The above example does not connect to WiFi until TRIGGER_PIN goes LOW. When TRIGGER_PIN goes LOW, the captive portal starts and you can connect to WiFi. Even if you reset the module, it will not automatically reconnect. Refers the hosted ESP8266WebServer/WebServer \u00b6 Constructing an AutoConnect object variable without parameters then creates and starts an ESP8266WebServer/WebServer inside the AutoConnect. This object variable could be referred by AutoConnect::host() function to access ESP8266WebServer/WebServer instance as like below. AutoConnect Portal; Portal.begin(); ESP8266WebServer & server = Portal.host(); server.send( 200 , \"text/plain\" , \"Hello, world\" ); When host() is valid The host() can be referred at after AutoConnect::begin . Usage for automatically instantiated ESP8266WebServer/WebServer \u00b6 The sketch can handle URL requests using ESP8266WebServer or WebServer that AutoConnect started internally. ESP8266WebServer/WebServer instantiated dynamically by AutoConnect can be referred to by AutoConnect::host function. The sketch can use the ' on ' function, ' send ' function, ' client ' function and others by ESP8266WebServer/WebServer reference of its return value. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect Portal; void handleRoot () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 200 , \"text/html\" , \"Hello, world\" ); } void handleNotFound () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 404 , \"text/html\" , \"Unknown.\" ); } void setup () { bool r = Portal.begin(); if (r) { ESP8266WebServer & IntServer = Portal.host(); IntServer.on( \"/\" , handleRoot); Portal.onNotFound(handleNotFound); // For only onNotFound. } } void loop () { Portal.host().handleClient(); Portal.handleRequest(); /* or following one line code is equ. Portal.handleClient(); */ } ESP8266WebServer/WebServer function should be called after AutoConnect::begin The sketch cannot refer to an instance of ESP8266WebServer/WebServer until AutoConnect::begin completes successfully. Do not use with ESP8266WebServer::begin or WebServer::begin ESP8266WebServer/WebServer is already running inside the AutoConnect. Use with the PageBuilder library \u00b6 In ordinary, the URL handler will respond the request by sending some HTML. PageBuilder library is HTML assembly aid. it can handle predefined HTML as like a template and simplify an HTML string assemble logic, and also the generated HTML send automatically. An example sketch used with the PageBuilder as follows and it explains how it aids for the HTML generating. Details for Github repository . Configuration functions \u00b6 Configuration for Soft AP and captive portal \u00b6 AutoConnect will activate SoftAP at failed the first WiFi.begin . It SoftAP settings are stored in AutoConnectConfig as the following parameters. The sketch could be configured SoftAP using these parameters, refer the AutoConnectConfig API for details. IP address of SoftAP activated. Gateway IP address. Subnet mask. SSID for SoftAP. Password for SoftAP. Channel. SoftAP name. Hidden attribute. Auto save credential. Offset address of the credentials storage area in EEPROM. Captive portal time out limit. Retains the portal function after time out. Length of start up time after reset. Automatic starting the captive portal. Start the captive portal forcefully. Auto reset after connection establishment. Home URL of the user sketch application. AutoConnect::config before AutoConnect::begin AutoConnect::config must be executed before AutoConnect::begin . Assign user sketch's home path \u00b6 \" HOME \" for returning to the user's sketch homepage is displayed at the bottom of the AutoConnect menu. It could be set using the AutoConnect::home function. Relocate the AutoConnect home path \u00b6 A home path of AutoConnect is /_ac by default. You can access from the browser with http://IPADDRESS/_ac. You can change the home path by revising AUTOCONNECT_URI macro in the include header file as AutoConnect.h . #define AUTOCONNECT_URI \"/_ac\" Static IP assignment 2 \u00b6 It is also possible to assign static IP Address to ESP8266/ESP32 in STA mode. By default DHCP is enabled and it becomes the IP address assigned by the DHCP server with WiFi.begin . To assign a static IP to ESP8266/ESP32 with WIFI_MODE_STA, the following parameters are required: IP address. Gateway address. Subnet mask. Primary DNS server. Secondary DNS server. (optional) The above parameters must be executed before AutoConnect::begin as arguments of AutoConnectConfig . AutoConnect portal; AutoConnectConfig Config; Config.staip = IPAddress( 192 , 168 , 1 , 10 ); Config.staGateway = IPAddress( 192 , 168 , 1 , 1 ); Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); Config.dns1 = IPAddress( 192 , 168 , 1 , 1 ); portal.config(Config); portal.begin(); Station host name \u00b6 The source code placement of common macros for AutoConnect since v0.9.7 has changed. \u21a9 Static IP address assignment is available from version 0.9.3. \u21a9","title":"Advanced usage"},{"location":"advancedusage.html#advanced-usage","text":"","title":"Advanced usage"},{"location":"advancedusage.html#404-handler","text":"Registering the \"not found\" handler is a different way than ESP8266WebServer/WebServer. The onNotFound of ESP8266WebServer/WebServer does not work with AutoConnect. AutoConnect overrides ESP8266WebServer::onNotFound / WebServer::onNotFound to handle a captive portal. To register \"not found\" handler, use AutoConnect::onNotFound .","title":" 404 handler"},{"location":"advancedusage.html#automatic-reconnect","text":"When the captive portal is started, SoftAP starts and the STA is disconnected. The current SSID setting memorized in ESP8266 will be lost but then the reconnect behavior of ESP32 is somewhat different from this. The WiFiSTAClass::disconnect function implemented in the arduino-esp32 has extended parameters than the ESP8266's arduino-core. The second parameter of WiFi.disconnect on the arduino-esp32 core that does not exist in the ESP8266WiFiSTAClass has the effect of deleting the currently connected WiFi configuration and its default value is \"false\". On the ESP32 platform, even if WiFi.disconnect is executed, WiFi.begin() without the parameters in the next turn will try to connect to that AP. That is, automatic reconnection is implemented in arduino-esp32 already. Although this behavior appears seemingly competent, it is rather a disadvantage in scenes where you want to change the access point each time. When explicitly disconnecting WiFi from the Disconnect menu, AutoConnect will erase the AP connection settings saved by arduino-esp32 core. AutoConnect's automatic reconnection is a mechanism independent from the automatic reconnection of the arduino-esp32 core. If the autoReconnect option of the AutoConnectConfig class is enabled, it automatically attempts to reconnect to the disconnected past access point. When the autoReconnect option is specified, AutoConnect will not start SoftAP immediately if the first WiFi.begin fails. It will scan WiFi signal and the same connection information as the detected BSSID is stored in EEPROM as AutoConnect's credentials, explicitly apply it with WiFi.begin and rerun. AutoConnect Portal; AutoConnectConfig Config; Config.autoReconnect = true; Portal.config(Config); Portal.begin(); An autoReconnect option is available to AutoConnect::begin without SSID and pass passphrase. An autoReconnect will work if SSID detection succeeded An autoReconnect will not effect if the SSID which stored credential to be connected is a hidden access point.","title":" Automatic reconnect"},{"location":"advancedusage.html#auto-save-credential","text":"By default, AutoConnect saves the credentials of the established connection in EEPROM. You can disable it with the autoSave parameter specified by AutoConnectConfig . AutoConnect Portal; AutoConnectConfig Config; Config.autoSave = AC_SAVECREDENTIAL_NEVER; Portal.config(Config); Portal.begin(); In ESP32, the credentials for AutoConnect are not in NVS The credentials used by AutoConnect are not saved in NVS on ESP32 module. ESP-IDF saves the WiFi connection configuration to NVS, but AutoConnect stores it on the EEPROM partition. You can find the partition table for default as default.csv","title":" Auto save Credential"},{"location":"advancedusage.html#captive-portal-start-detection","text":"The captive portal will only be activated if the first WiFi::begin fails. Sketch can detect with the AutoConnect::onDetect function that the captive portal has started. For example, the sketch can be written like as follows that turns on the LED at the start captive portal. AutoConnect Portal; bool startCP (IPAddress ip) { digitalWrite(BUILTIN_LED, HIGH); Serial.println( \"C.P. started, IP:\" + WiFi.localIP().toString()); return true; } void setup () { Serial.begin( 115200 ); pinMode(BUILTIN_LED, OUTPUT); digitalWrite(BUILTIN_LED, LOW); Portal.onDetect(startCP); if (Portal.begin()) { digitalWrite(BUILTIN_LED, LOW); } } void loop () { Portal.handleClient(); }","title":" Captive portal start detection"},{"location":"advancedusage.html#captive-portal-timeout-control","text":"AutoConnect has two parameters for timeout control. One is a timeout value used when trying to connect to the specified AP. It behaves the same as general timeout control in connection attempt by WiFi.begin. This control is specified by the third parameter of AutoConnect::begin . Default value is macro defined by AUTOCONNECT_TIMEOUT in the AutoConnectDef.h file. The other is timeout control for the captive portal itself. It is useful when you want to continue sketch execution with offline even if the WiFi connection is not possible. You can also combine it with the immediateStart option to create sketches with high mobility. The timeout of the captive portal is specified together with AutoConnectConfig::portalTimeout as follows. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Also, if you want to stop AutoConnect completely when the captive portal is timed out, you need to call the AutoConnect::end function. It looks like the following code: bool acEnable; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); acEnable = portal.begin(); if ( ! acEnable) { portal.end(); } } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } if (acEnable) { portal.handleClient(); } } There is another option related to timeout in AutoConnectConfig. It can make use of the captive portal function even after a timeout. The AutoConnectConfig::retainPortal option will not stop the SoftAP when the captive portal is timed out. If you enable the ratainPortal option, you can try to connect to the AP at any time while continuing to sketch execution with offline even after the captive portal timed-out. The following code is its example. It can enable the captive portal after timed-out without changing sketch skeleton compared to the above code which does not specify an option. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds config.retainPortal = true; portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); }","title":" Captive portal timeout control"},{"location":"advancedusage.html#cast-items-of-your-sketch-own-into-the-autoccnnect-menu","text":"If your sketch is handling your own web page, you can call that page from the AutoConnect menu . Unlike the custom Web pages by AutoConnectAux , this allows AutoConnect menu to legacy web pages registered by ESP8266WebServer::on / WebServer::on function. To implement this with your sketch, use only the AutoConnectAux constructed with the URI of that page. AutoConnectElements is not required. The basic procedure for this as follows. Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu. Sketch legacy page handlers. Register those handler functions to ESP8266WebServer/WebServer with the on function. Register AutoConnectAux declared with #1 to AutoConnect using AutoConnect::join function. It serves as a menu item. Begin the portal. Performs AutoConnect::handleClient in the loop function. For details see the Constructing menu section of Examples page.","title":" Cast items of your sketch own into the AutocCnnect menu"},{"location":"advancedusage.html#change-menu-title","text":"Although the default menu title is AutoConnect , you can change the title by setting AutoConnectConfig::title . To set the menu title properly, you must set before calling AutoConnect::begin . AutoConnect Portal; AutoConnectConfig Config; void setup () { // Set menu title Config.title = \"FSBrowser\" ; Portal.config(Config); Portal.begin(); } Executing the above sketch will rewrite the menu title to FSBrowser as the below.","title":" Change menu title"},{"location":"advancedusage.html#combination-with-mdns","text":"With mDNS library , you can access to ESP8266 by name instead of IP address after connection. The sketch can start the MDNS responder after AutoConnect::begin . #include <ESP8266WiFi.h> #include <ESP8266mDNS.h> #include <ESP8266WebServer.h> AutoConnect Portal; void setup () { if (Portal.begin()) { if (MDNS.begin( \"esp8266\" )) { MDNS.addService( \"http\" , \"tcp\" , 80 ); } } } void loop () { Portal.handleClient(); }","title":" Combination with mDNS"},{"location":"advancedusage.html#debug-print","text":"You can output AutoConnect monitor messages to the Serial . A monitor message activation switch is in an include header file AutoConnectDefs.h of library source. Define AC_DEBUG macro to output the monitor messages. 1 #define AC_DEBUG","title":" Debug print"},{"location":"advancedusage.html#disable-the-captive-portal","text":"It can also prevent the captive portal from starting even if the connection at the first WiFi.begin fails. In this case, AutoConnect::begin behaves same as WiFi.begin . For disabling the captive portal, autoRise sets to false with AutoConnectConfig . AutoConnect portal; AutoConnectConfig acConfig; acConfig.autoRaise = false; portal.config(acConfig); portal.begin();","title":" Disable the captive portal"},{"location":"advancedusage.html#make-ssid-of-softap-unique","text":"You can change SoftAP's SSID and password programmatically when the captive portal starts up. By using chip specific ID of esp8266/esp32 you can make SSID of SoftAP unique. SSID and password for SoftAP is AutoConnectConfig::apid and AutoConnectConfig::psk . AutoConnect portal; AutoConnectConfig acConfig; acConfig.apid = \"ESP-\" + String(ESP.getChipId(), HEX); acConfig.psk = YOUR_PASSWORD; portal.config(acConfig); portal.begin(); Obtaining chip ID for ESP32 acConfig.apid = \"ESP-\" + String((uint32_t)(ESP.getEfuseMac() >> 32), HEX);","title":" Make SSID of SoftAP unique"},{"location":"advancedusage.html#move-the-saving-area-of-eeprom-for-the-credentials","text":"By default, the credentials saving area is occupied from the beginning of EEPROM area. ESP8266 Arduino core document says that: The following diagram illustrates flash layout used in Arduino environment: |--------------|-------|---------------|--|--|--|--|--| ^ ^ ^ ^ ^ Sketch OTA update File system EEPROM WiFi config (SDK) and EEPROM library uses one sector of flash located just after the SPIFFS . Also, the placement of the EEPROM area of ESP32 is described in the partition table . So in the default state, the credential storage area used by AutoConnect conflicts with data owned by the user sketch. It will be destroyed together saved data in EEPROM by user sketch and AutoConnect each other. But you can move the storage area to avoid this. The boundaryOffset in AutoConnectConfig specifies the start offset of the credentials storage area. The default value is 0.","title":" Move the saving area of EEPROM for the credentials"},{"location":"advancedusage.html#on-demand-start-the-captive-portal","text":"If you do not usually connect to WiFi and need to establish a WiFi connection if necessary, you can combine the autoRise option with the immediateStart option to achieve on-demand connection. This behavior is similar to the WiFiManager's startConfigPortal function. In order to do this, you usually configure only with AutoConnectConfig in setup() and AutoConnect::begin() handles in loop() . AutoConnect Portal; AutoConnectConfig Config; void setup () { Config.autoRise = false; Config.immediateStart = true; Portal.config(Config); } void loop () { if (digitalRead(TRIGGER_PIN) == LOW) { while (digitalRead(TRIGGER_PIN) == LOW) yield(); Portal.begin(); } Portal.handleClient(); } The above example does not connect to WiFi until TRIGGER_PIN goes LOW. When TRIGGER_PIN goes LOW, the captive portal starts and you can connect to WiFi. Even if you reset the module, it will not automatically reconnect.","title":" On-demand start the captive portal"},{"location":"advancedusage.html#refers-the-hosted-esp8266webserverwebserver","text":"Constructing an AutoConnect object variable without parameters then creates and starts an ESP8266WebServer/WebServer inside the AutoConnect. This object variable could be referred by AutoConnect::host() function to access ESP8266WebServer/WebServer instance as like below. AutoConnect Portal; Portal.begin(); ESP8266WebServer & server = Portal.host(); server.send( 200 , \"text/plain\" , \"Hello, world\" ); When host() is valid The host() can be referred at after AutoConnect::begin .","title":" Refers the hosted ESP8266WebServer/WebServer"},{"location":"advancedusage.html#usage-for-automatically-instantiated-esp8266webserverwebserver","text":"The sketch can handle URL requests using ESP8266WebServer or WebServer that AutoConnect started internally. ESP8266WebServer/WebServer instantiated dynamically by AutoConnect can be referred to by AutoConnect::host function. The sketch can use the ' on ' function, ' send ' function, ' client ' function and others by ESP8266WebServer/WebServer reference of its return value. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect Portal; void handleRoot () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 200 , \"text/html\" , \"Hello, world\" ); } void handleNotFound () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 404 , \"text/html\" , \"Unknown.\" ); } void setup () { bool r = Portal.begin(); if (r) { ESP8266WebServer & IntServer = Portal.host(); IntServer.on( \"/\" , handleRoot); Portal.onNotFound(handleNotFound); // For only onNotFound. } } void loop () { Portal.host().handleClient(); Portal.handleRequest(); /* or following one line code is equ. Portal.handleClient(); */ } ESP8266WebServer/WebServer function should be called after AutoConnect::begin The sketch cannot refer to an instance of ESP8266WebServer/WebServer until AutoConnect::begin completes successfully. Do not use with ESP8266WebServer::begin or WebServer::begin ESP8266WebServer/WebServer is already running inside the AutoConnect.","title":" Usage for automatically instantiated ESP8266WebServer/WebServer"},{"location":"advancedusage.html#use-with-the-pagebuilder-library","text":"In ordinary, the URL handler will respond the request by sending some HTML. PageBuilder library is HTML assembly aid. it can handle predefined HTML as like a template and simplify an HTML string assemble logic, and also the generated HTML send automatically. An example sketch used with the PageBuilder as follows and it explains how it aids for the HTML generating. Details for Github repository .","title":" Use with the PageBuilder library"},{"location":"advancedusage.html#configuration-functions","text":"","title":"Configuration functions"},{"location":"advancedusage.html#configuration-for-soft-ap-and-captive-portal","text":"AutoConnect will activate SoftAP at failed the first WiFi.begin . It SoftAP settings are stored in AutoConnectConfig as the following parameters. The sketch could be configured SoftAP using these parameters, refer the AutoConnectConfig API for details. IP address of SoftAP activated. Gateway IP address. Subnet mask. SSID for SoftAP. Password for SoftAP. Channel. SoftAP name. Hidden attribute. Auto save credential. Offset address of the credentials storage area in EEPROM. Captive portal time out limit. Retains the portal function after time out. Length of start up time after reset. Automatic starting the captive portal. Start the captive portal forcefully. Auto reset after connection establishment. Home URL of the user sketch application. AutoConnect::config before AutoConnect::begin AutoConnect::config must be executed before AutoConnect::begin .","title":" Configuration for Soft AP and captive portal"},{"location":"advancedusage.html#assign-user-sketchs-home-path","text":"\" HOME \" for returning to the user's sketch homepage is displayed at the bottom of the AutoConnect menu. It could be set using the AutoConnect::home function.","title":" Assign user sketch's home path"},{"location":"advancedusage.html#relocate-the-autoconnect-home-path","text":"A home path of AutoConnect is /_ac by default. You can access from the browser with http://IPADDRESS/_ac. You can change the home path by revising AUTOCONNECT_URI macro in the include header file as AutoConnect.h . #define AUTOCONNECT_URI \"/_ac\"","title":" Relocate the AutoConnect home path"},{"location":"advancedusage.html#static-ip-assignment-2","text":"It is also possible to assign static IP Address to ESP8266/ESP32 in STA mode. By default DHCP is enabled and it becomes the IP address assigned by the DHCP server with WiFi.begin . To assign a static IP to ESP8266/ESP32 with WIFI_MODE_STA, the following parameters are required: IP address. Gateway address. Subnet mask. Primary DNS server. Secondary DNS server. (optional) The above parameters must be executed before AutoConnect::begin as arguments of AutoConnectConfig . AutoConnect portal; AutoConnectConfig Config; Config.staip = IPAddress( 192 , 168 , 1 , 10 ); Config.staGateway = IPAddress( 192 , 168 , 1 , 1 ); Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); Config.dns1 = IPAddress( 192 , 168 , 1 , 1 ); portal.config(Config); portal.begin();","title":" Static IP assignment 2"},{"location":"advancedusage.html#station-host-name","text":"The source code placement of common macros for AutoConnect since v0.9.7 has changed. \u21a9 Static IP address assignment is available from version 0.9.3. \u21a9","title":" Station host name"},{"location":"api.html","text":"Include headers \u00b6 AutoConnect.h \u00b6 #include <AutoConnect.h> Defined macros \u00b6 They contain in AutoConnectDefs.h . #define AC_DEBUG // Monitor message output activation #define AC_DEBUG_PORT Serial // Default message output device #define AUTOCONNECT_AP_IP 0x01F4A8C0 // Default SoftAP IP #define AUTOCONNECT_AP_GW 0x01F4A8C0 // Default SoftAP Gateway IP #define AUTOCONNECT_AP_NM 0x00FFFFFF // Default subnet mask #define AUTOCONNECT_DNSPORT 53 // Default DNS port at captive portal #define AUTOCONNECT_HTTPPORT 80 // Default HTTP #define AUTOCONNECT_MENU_TITLE \"AutoConnect\" // Default AutoConnect menu title #define AUTOCONNECT_STARTUPTIME 10 // Default waiting time[s] for after reset #define AUTOCONNECT_URI \"/_ac\" // Default AutoConnect root path #define AUTOCONNECT_TIMEOUT 30000 // Default connection timeout[ms] #define AUTOCONNECT_CAPTIVEPORTAL_TIMEOUT 0 // Captive portal timeout value #define AUTOCONNECT_USE_JSON // Allow AutoConnect elements to be handled by JSON format Macros placement moved Source code placement of the above macros provided for user sketch changed from v0.9.7. The new code is in AutoConnectDefs.h . Constructors \u00b6 AutoConnect \u00b6 AutoConnect() AutoConnect default constructor. This entry internally allocates the ESP8266WebServer for ESP8266 or WebServer for ESP32 and is activated internally. For ESP8266 AutoConnect(ESP8266WebServer & webServer) For ESP32 AutoConnect(WebServer & webServer) Run the AutoConnect site using the externally ensured ESP8266WebServer for ESP8266 or WebServer for ESP32. The handleClient function of AutoConnect can include the response of the URI handler added by the user using the \" on \" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the host function. Parameters webServer A reference of ESP8266WebServer or WebServer instance. Public member functions \u00b6 aux \u00b6 AutoConnectAux * aux( const String & uri) const Returns a pointer to AutoConnectAux with the URI specified by uri . If AutoConnectAux with that URI is not bound, it returns nullptr . Parameters uri A string of the URI. Return value A Pointer of the AutoConnectAux instance. begin \u00b6 bool begin() bool begin( const char * ssid, const char * passphrase) bool begin( const char * ssid, const char * passphrase, unsigned long timeout) Starts establishing the WiFi connection. The WiFi mode at this time is WIFI_STA. AutoConnect first invokes WiFi.begin . If the ssid and the passphrase are missing, its WiFi.begin has no SSID and Password. Regardless of the result, ESP8266WebServer/WebServer will start immediately after the first WiFi.begin . The captive portal will not be started if the connection has been established with first WiFi.begin . If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts. Parameters ssid SSID to be connected. passphrase Password for connection. timeout A time out value in milliseconds for waiting connection. Return value true Connection established, AutoConnect service started with WIFI_STA mode. false Could not connected, Captive portal started with WIFI_AP_STA mode. config \u00b6 bool config(AutoConnectConfig & config) bool config( const char * ap, const char * password = nullptr ) Set SoftAP's WiFi configuration and static IP configuration. Parameters config Reference to AutoConnectConfig containing SoftAP's parameters and static IP parameters. ap SSID for SoftAP. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The default value is 12345678 . Return value true Successfully configured. false Configuration parameter is invalid, some values out of range. end \u00b6 void end() Stops AutoConnect captive portal service. Release ESP8266WebServer/WebServer and DNSServer. Attention to end The end function releases the instance of ESP8266WebServer/WebServer and DNSServer. It can not process them after the end function. handleClient \u00b6 void handleClient() Process the AutoConnect menu interface. The handleClient() function of the ESP8266WebServer/WebServer hosted by AutoConnect is also called from within AutoConnect, and the client request handlers contained in the user sketch are also handled. handleRequest \u00b6 void handleRequest() Handling for the AutoConnect menu request. About used in combination with handleClient The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient. home \u00b6 void home(String uri) Put a user site's home URI. The URI specified by home is linked from \"HOME\" in the AutoConnect menu. Parameters uri A URI string of user site's home path. host \u00b6 For ESP8266 ESP8266WebServer & host() For ESP32 WebServer & host() Returns the reference of the ESP8266WebServer/WebServer which is allocated in AutoConnect automatically. Return value A reference of the ESP8266WebServer/WebServer. &reference is not a pointer A reference cannot be re-assigned, and must be assigned at initialization. It's like as bind as alias. ESP8266WebServer & server = portal.host(); server.handleClient(); or portal.host().handleClient(); join \u00b6 void join(AutoConnectAux & aux) void join(std :: vector < std :: reference_wrapper < AutoConnectAux >> aux) Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu. Parameters aux Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with list initialization . load \u00b6 bool load( const String & aux) bool load( const __FlashStringHelper * aux) bool load(Stream & aux) Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned. Parameters aux The input string to be loaded. Return value true The JSON document as AutoConnectAux successfully loaded. false Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the ArduinoJson Assistant . on \u00b6 bool on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters uri A string of the URI assigned to the AutoConnectAux page. handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. It is not ESP8266WebServer::on, not WebServer::on for ESP32. This function effects to AutoConnectAux only. However, it coexists with that of ESP8266WebServer::on or WebServer::on of ESP32. onDetect \u00b6 void onDetect(DetectExit_ft fn) Register the function which will call from AutoConnect at the start of the captive portal. Parameters fn Function called at the captive portal start. An fn specifies the function called when the captive portal starts. Its prototype declaration is defined as \" DetectExit_ft \". typedef std :: function < bool (IPAddress softapIP) > DetectExit_ft Parameters softapIP An IP address of SoftAP for the captive portal. Retuen value true Continues captive portal handling. false Cancel the captive portal. AutoConnect::begin function will return with a false. onNotFound \u00b6 For ESP8266 void onNotFound(ESP8266WebServer :: THandlerFunction fn) For ESP32 void onNotFound(WebServer :: THandlerFunction fn) Register the handler function for undefined URL request detected. Parameters fn A function of the \"not found\" handler. where \u00b6 AutoConenctAux * where( void ) Returns a pointer to the AutoConnectAux object of the custom web page that caused the request to that page. This function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/ESP32. In other words, this function only returns the last AutoConnecAux page called. Retuen value A pointer to the AutoConnectAux that caused the request the page.","title":"AutoConnect API"},{"location":"api.html#include-headers","text":"","title":" Include headers"},{"location":"api.html#autoconnecth","text":"#include <AutoConnect.h>","title":"AutoConnect.h"},{"location":"api.html#defined-macros","text":"They contain in AutoConnectDefs.h . #define AC_DEBUG // Monitor message output activation #define AC_DEBUG_PORT Serial // Default message output device #define AUTOCONNECT_AP_IP 0x01F4A8C0 // Default SoftAP IP #define AUTOCONNECT_AP_GW 0x01F4A8C0 // Default SoftAP Gateway IP #define AUTOCONNECT_AP_NM 0x00FFFFFF // Default subnet mask #define AUTOCONNECT_DNSPORT 53 // Default DNS port at captive portal #define AUTOCONNECT_HTTPPORT 80 // Default HTTP #define AUTOCONNECT_MENU_TITLE \"AutoConnect\" // Default AutoConnect menu title #define AUTOCONNECT_STARTUPTIME 10 // Default waiting time[s] for after reset #define AUTOCONNECT_URI \"/_ac\" // Default AutoConnect root path #define AUTOCONNECT_TIMEOUT 30000 // Default connection timeout[ms] #define AUTOCONNECT_CAPTIVEPORTAL_TIMEOUT 0 // Captive portal timeout value #define AUTOCONNECT_USE_JSON // Allow AutoConnect elements to be handled by JSON format Macros placement moved Source code placement of the above macros provided for user sketch changed from v0.9.7. The new code is in AutoConnectDefs.h .","title":" Defined macros"},{"location":"api.html#constructors","text":"","title":" Constructors"},{"location":"api.html#autoconnect","text":"AutoConnect() AutoConnect default constructor. This entry internally allocates the ESP8266WebServer for ESP8266 or WebServer for ESP32 and is activated internally. For ESP8266 AutoConnect(ESP8266WebServer & webServer) For ESP32 AutoConnect(WebServer & webServer) Run the AutoConnect site using the externally ensured ESP8266WebServer for ESP8266 or WebServer for ESP32. The handleClient function of AutoConnect can include the response of the URI handler added by the user using the \" on \" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the host function. Parameters webServer A reference of ESP8266WebServer or WebServer instance.","title":"AutoConnect"},{"location":"api.html#public-member-functions","text":"","title":" Public member functions"},{"location":"api.html#aux","text":"AutoConnectAux * aux( const String & uri) const Returns a pointer to AutoConnectAux with the URI specified by uri . If AutoConnectAux with that URI is not bound, it returns nullptr . Parameters uri A string of the URI. Return value A Pointer of the AutoConnectAux instance.","title":" aux"},{"location":"api.html#begin","text":"bool begin() bool begin( const char * ssid, const char * passphrase) bool begin( const char * ssid, const char * passphrase, unsigned long timeout) Starts establishing the WiFi connection. The WiFi mode at this time is WIFI_STA. AutoConnect first invokes WiFi.begin . If the ssid and the passphrase are missing, its WiFi.begin has no SSID and Password. Regardless of the result, ESP8266WebServer/WebServer will start immediately after the first WiFi.begin . The captive portal will not be started if the connection has been established with first WiFi.begin . If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts. Parameters ssid SSID to be connected. passphrase Password for connection. timeout A time out value in milliseconds for waiting connection. Return value true Connection established, AutoConnect service started with WIFI_STA mode. false Could not connected, Captive portal started with WIFI_AP_STA mode.","title":" begin"},{"location":"api.html#config","text":"bool config(AutoConnectConfig & config) bool config( const char * ap, const char * password = nullptr ) Set SoftAP's WiFi configuration and static IP configuration. Parameters config Reference to AutoConnectConfig containing SoftAP's parameters and static IP parameters. ap SSID for SoftAP. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The default value is 12345678 . Return value true Successfully configured. false Configuration parameter is invalid, some values out of range.","title":" config"},{"location":"api.html#end","text":"void end() Stops AutoConnect captive portal service. Release ESP8266WebServer/WebServer and DNSServer. Attention to end The end function releases the instance of ESP8266WebServer/WebServer and DNSServer. It can not process them after the end function.","title":" end"},{"location":"api.html#handleclient","text":"void handleClient() Process the AutoConnect menu interface. The handleClient() function of the ESP8266WebServer/WebServer hosted by AutoConnect is also called from within AutoConnect, and the client request handlers contained in the user sketch are also handled.","title":" handleClient"},{"location":"api.html#handlerequest","text":"void handleRequest() Handling for the AutoConnect menu request. About used in combination with handleClient The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient.","title":" handleRequest"},{"location":"api.html#home","text":"void home(String uri) Put a user site's home URI. The URI specified by home is linked from \"HOME\" in the AutoConnect menu. Parameters uri A URI string of user site's home path.","title":" home"},{"location":"api.html#host","text":"For ESP8266 ESP8266WebServer & host() For ESP32 WebServer & host() Returns the reference of the ESP8266WebServer/WebServer which is allocated in AutoConnect automatically. Return value A reference of the ESP8266WebServer/WebServer. &reference is not a pointer A reference cannot be re-assigned, and must be assigned at initialization. It's like as bind as alias. ESP8266WebServer & server = portal.host(); server.handleClient(); or portal.host().handleClient();","title":" host"},{"location":"api.html#join","text":"void join(AutoConnectAux & aux) void join(std :: vector < std :: reference_wrapper < AutoConnectAux >> aux) Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu. Parameters aux Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with list initialization .","title":" join"},{"location":"api.html#load","text":"bool load( const String & aux) bool load( const __FlashStringHelper * aux) bool load(Stream & aux) Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned. Parameters aux The input string to be loaded. Return value true The JSON document as AutoConnectAux successfully loaded. false Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the ArduinoJson Assistant .","title":" load"},{"location":"api.html#on","text":"bool on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters uri A string of the URI assigned to the AutoConnectAux page. handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. It is not ESP8266WebServer::on, not WebServer::on for ESP32. This function effects to AutoConnectAux only. However, it coexists with that of ESP8266WebServer::on or WebServer::on of ESP32.","title":" on"},{"location":"api.html#ondetect","text":"void onDetect(DetectExit_ft fn) Register the function which will call from AutoConnect at the start of the captive portal. Parameters fn Function called at the captive portal start. An fn specifies the function called when the captive portal starts. Its prototype declaration is defined as \" DetectExit_ft \". typedef std :: function < bool (IPAddress softapIP) > DetectExit_ft Parameters softapIP An IP address of SoftAP for the captive portal. Retuen value true Continues captive portal handling. false Cancel the captive portal. AutoConnect::begin function will return with a false.","title":" onDetect"},{"location":"api.html#onnotfound","text":"For ESP8266 void onNotFound(ESP8266WebServer :: THandlerFunction fn) For ESP32 void onNotFound(WebServer :: THandlerFunction fn) Register the handler function for undefined URL request detected. Parameters fn A function of the \"not found\" handler.","title":" onNotFound"},{"location":"api.html#where","text":"AutoConenctAux * where( void ) Returns a pointer to the AutoConnectAux object of the custom web page that caused the request to that page. This function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/ESP32. In other words, this function only returns the last AutoConnecAux page called. Retuen value A pointer to the AutoConnectAux that caused the request the page.","title":" where"},{"location":"apiaux.html","text":"Constructor \u00b6 AutoConnectAux \u00b6 AutoConnectAux( const String & uri = String( \"\" ), const String & title = String( \"\" ), const bool menu = true, const AutoConnectElementVT addons = AutoConnectElementVT()) Parameters uri URI of this custom Web Page. title Page title of this custom web page. It will appear on the auto connection menu and at the top of that page. addons Reference to AutoConnectElement collection. Public member functions \u00b6 add \u00b6 void add(AutoConnectElement & addon) void add(AutoConnectElementVT addons) Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu. getElement \u00b6 template < typename T > T & getElement( const String & name) AutoConnectElement * getElement( const String & name) Get registered AutoConnectElement as specified name. getElements \u00b6 AutoConnectElementVT & getElements( void ) Get vector of reference of all elements. load \u00b6 bool load( const String & in) bool load( const __FlashStringHelper * in) bool load(Stream & in) Load whole elements to AutoConnectAux Pages. loadElement \u00b6 bool loadElement( const String & in, const String & name = String( \"\" )) bool loadElement( const __FlashStringHelper * in, const String & name = String( \"\" )) bool loadElement(Stream & in, const String & name = String( \"\" )) Load specified element. menu \u00b6 void menu( const bool post) Set or reset the display as menu item for this AutoConnectAux. on \u00b6 void on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. release \u00b6 bool release( const String & name) Release a specified AutoConnectElement. saveElement \u00b6 size_t saveElement(Stream & out, std :: vector < String > const & names = {}) Write elements of AutoConnectAux to the stream. setElementValue \u00b6 bool setElementValue( const String & name, const String value) bool setElementValue( const String & name, std :: vector < String > const & values) setTitle \u00b6 void setTitle( const String & title) Set the title string of the AutoConnectAux page.","title":"AutoConnectAux API"},{"location":"apiaux.html#constructor","text":"","title":" Constructor"},{"location":"apiaux.html#autoconnectaux","text":"AutoConnectAux( const String & uri = String( \"\" ), const String & title = String( \"\" ), const bool menu = true, const AutoConnectElementVT addons = AutoConnectElementVT()) Parameters uri URI of this custom Web Page. title Page title of this custom web page. It will appear on the auto connection menu and at the top of that page. addons Reference to AutoConnectElement collection.","title":"AutoConnectAux"},{"location":"apiaux.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apiaux.html#add","text":"void add(AutoConnectElement & addon) void add(AutoConnectElementVT addons) Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu.","title":" add"},{"location":"apiaux.html#getelement","text":"template < typename T > T & getElement( const String & name) AutoConnectElement * getElement( const String & name) Get registered AutoConnectElement as specified name.","title":" getElement"},{"location":"apiaux.html#getelements","text":"AutoConnectElementVT & getElements( void ) Get vector of reference of all elements.","title":" getElements"},{"location":"apiaux.html#load","text":"bool load( const String & in) bool load( const __FlashStringHelper * in) bool load(Stream & in) Load whole elements to AutoConnectAux Pages.","title":" load"},{"location":"apiaux.html#loadelement","text":"bool loadElement( const String & in, const String & name = String( \"\" )) bool loadElement( const __FlashStringHelper * in, const String & name = String( \"\" )) bool loadElement(Stream & in, const String & name = String( \"\" )) Load specified element.","title":" loadElement"},{"location":"apiaux.html#menu","text":"void menu( const bool post) Set or reset the display as menu item for this AutoConnectAux.","title":" menu"},{"location":"apiaux.html#on","text":"void on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated.","title":" on"},{"location":"apiaux.html#release","text":"bool release( const String & name) Release a specified AutoConnectElement.","title":" release"},{"location":"apiaux.html#saveelement","text":"size_t saveElement(Stream & out, std :: vector < String > const & names = {}) Write elements of AutoConnectAux to the stream.","title":" saveElement"},{"location":"apiaux.html#setelementvalue","text":"bool setElementValue( const String & name, const String value) bool setElementValue( const String & name, std :: vector < String > const & values)","title":" setElementValue"},{"location":"apiaux.html#settitle","text":"void setTitle( const String & title) Set the title string of the AutoConnectAux page.","title":" setTitle"},{"location":"apiconfig.html","text":"Constructor \u00b6 AutoConnectConfig \u00b6 AutoConnectConfig() AutoConnectConfig( const char * ap, const char * password) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout, const uint8_t channel) Parameters ap SSID for SoftAP. The length should be up to 31. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The length should be from 8 to up to 63. The default value is 12345678 . timeout The timeout value of the captive portal in [ms] units. The default value is 0. channel The channel number of WIFi when SoftAP starts. The default values is 1. Public member variables \u00b6 apid \u00b6 SoftAP's SSID. Type String apip \u00b6 Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 192.168.244.1 autoReconnect \u00b6 Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, AutoConnect::begin() function will attempt to reconnect to a known access point using credentials stored in the EEPROM, even if the connection failed by current SSID. If the connection fails, starts the captive portal in SoftAP + STA mode. Type bool Value true Reconnect automatically. false Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default. When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied. Invokes AutoConnect::begin without user name and password parameter as begin() . If one of the saved BSSIDs (not the SSID) of the credentials matches the BSSID detected by the network scan. autoReset \u00b6 Reset ESP8266 module automatically after WLAN disconnected. Type bool Value true Reset after WiFi disconnected automatically. false No reset. autoRise \u00b6 Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first WiFi.begin fails. Type bool Value true Enable the captive portal. This is the default. false Disable the captive portal. autoSave \u00b6 The credential saved automatically at the connection establishment. Type AC_SAVECREDENTIAL_t Value AC_SAVECREDENTIAL_AUTO The credential saved automatically. This is the default. AC_SAVECREDENTIAL_NEVER The credential no saved. bootUri \u00b6 Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of AC_ONBOOTURI_t indicating either the AutoConnect root path or the user screen home path. Type AC_ONBOOTURI_t Value AC_ONBOOTURI_ROOT Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h. AC_ONBOOTURI_HOME It is redirected to the uri specified by AutoConnectConfig::homeUri . boundaryOffset \u00b6 Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK) The default value is 0. Type uint16_t It will conflict with user data. If the sketch leaves this offset at zero, it will conflict the storage area of credentials with the user sketch owned data. It needs to use the behind of credential area. channel \u00b6 The channel number of WIFi when SoftAP starts. Type uint8_t Value 1 ~ 14. The default value is 1. How do I choose Channel Espressif Systems had announced the application note about Wi-Fi channel selection. dns1 \u00b6 Set primary DNS server address when using static IP address. Type IPAddress dns2 \u00b6 Set secondary DNS server address when using static IP address. Type IPAddress gateway \u00b6 Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 192.168.244.1 hidden \u00b6 Sets SoftAP to hidden SSID. Type uint8_t Value 0 SSID will be appeared. This is the default. 1 SSID will be hidden. homeUri \u00b6 Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is \"/\". Type String hostName \u00b6 Sets the station host name of ESP8266/ESP32. Type String immediateStart \u00b6 Disable the first WiFi.begin() and start the captive portal. If this option is enabled, the module will be in AP_STA mode and the captive portal will be activated regardless of AutoConnectConfig::autoRise specification. Type bool Value true Start the captive portal with AutoConnect::begin . false Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default. netmask \u00b6 Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 255.255.255.0 portalTimeout \u00b6 Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (ie Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out. Type unsigned long Captive portal timeout value. The default value is 0. psk \u00b6 Sets password for SoftAP. The length should be from 8 to up to 63. The default value is 12345678 . Type String retainPortal \u00b6 Specify whether to continue the portal function even if the captive portal timed out. If the true, when a timeout occurs, the AutoConnect::begin function is exited with returns false, but the portal facility remains alive. So SoftAP remains alive and you can invoke AutoConnect while continuing sketch execution. The default is false. Type bool Value true Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP. false When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default. Connection request after timed-out With the retainPortal , even if AutoConnect::begin in the setup() is timed out, you can execute the sketch and the portal function as a WiFi connection attempt by calling AutoConnect::handleClient in the loop(). staip \u00b6 Set a static IP address. The IP will behave with STA mode. Type IPAddress staGateway \u00b6 Set the gateway address when using static IP address. Type IPAddress staNetmask \u00b6 Set the subnetmask when using static IP address. Type IPAddress title \u00b6 Set the menu title. Type String AutoConnectConfig example \u00b6 AutoConenct Portal; AutoConenctConfig Config ( \"\" , \"passpass\" ); // SoftAp name is determined at runtime Config.apid = ESP.hostname(); // Retrieve host name to SotAp identification Config.apip = IPAddress( 192 , 168 , 10 , 101 ); // Sets SoftAP IP address Config.gateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WLAN router IP address Config.netmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.autoReconnect = true; // Enable auto-reconnect Config.autoSave = AC_SAVECREDENTIAL_NEVER; // No save credential Config.boundaryOffet = 64 ; // Reserve 64 bytes for the user data in EEPROM. Config.portalTimeout = 60000 ; // Sets timeout value for the captive portal Config.retainPortal = true; // Retains the portal function after timed-out Config.homeUri = \"/index.html\" ; // Sets home path of the sketch application Config.title = \"My menu\" ; // Customize the menu title Config.staip = IPAddress( 192 , 168 , 10 , 10 ); // Sets static IP Config.staGateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WiFi router address Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.dns1 = IPAddress( 192 , 168 , 10 , 1 ); // Sets primary DNS address Portal.config(Config); // Configure AutoConnect Portal.begin(); // Starts and behaves captive portal","title":"AutoConnectConfig API"},{"location":"apiconfig.html#constructor","text":"","title":" Constructor"},{"location":"apiconfig.html#autoconnectconfig","text":"AutoConnectConfig() AutoConnectConfig( const char * ap, const char * password) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout, const uint8_t channel) Parameters ap SSID for SoftAP. The length should be up to 31. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The length should be from 8 to up to 63. The default value is 12345678 . timeout The timeout value of the captive portal in [ms] units. The default value is 0. channel The channel number of WIFi when SoftAP starts. The default values is 1.","title":"AutoConnectConfig"},{"location":"apiconfig.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apiconfig.html#apid","text":"SoftAP's SSID. Type String","title":" apid"},{"location":"apiconfig.html#apip","text":"Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 192.168.244.1","title":" apip"},{"location":"apiconfig.html#autoreconnect","text":"Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, AutoConnect::begin() function will attempt to reconnect to a known access point using credentials stored in the EEPROM, even if the connection failed by current SSID. If the connection fails, starts the captive portal in SoftAP + STA mode. Type bool Value true Reconnect automatically. false Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default. When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied. Invokes AutoConnect::begin without user name and password parameter as begin() . If one of the saved BSSIDs (not the SSID) of the credentials matches the BSSID detected by the network scan.","title":" autoReconnect"},{"location":"apiconfig.html#autoreset","text":"Reset ESP8266 module automatically after WLAN disconnected. Type bool Value true Reset after WiFi disconnected automatically. false No reset.","title":" autoReset"},{"location":"apiconfig.html#autorise","text":"Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first WiFi.begin fails. Type bool Value true Enable the captive portal. This is the default. false Disable the captive portal.","title":" autoRise"},{"location":"apiconfig.html#autosave","text":"The credential saved automatically at the connection establishment. Type AC_SAVECREDENTIAL_t Value AC_SAVECREDENTIAL_AUTO The credential saved automatically. This is the default. AC_SAVECREDENTIAL_NEVER The credential no saved.","title":" autoSave"},{"location":"apiconfig.html#booturi","text":"Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of AC_ONBOOTURI_t indicating either the AutoConnect root path or the user screen home path. Type AC_ONBOOTURI_t Value AC_ONBOOTURI_ROOT Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h. AC_ONBOOTURI_HOME It is redirected to the uri specified by AutoConnectConfig::homeUri .","title":" bootUri"},{"location":"apiconfig.html#boundaryoffset","text":"Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK) The default value is 0. Type uint16_t It will conflict with user data. If the sketch leaves this offset at zero, it will conflict the storage area of credentials with the user sketch owned data. It needs to use the behind of credential area.","title":" boundaryOffset"},{"location":"apiconfig.html#channel","text":"The channel number of WIFi when SoftAP starts. Type uint8_t Value 1 ~ 14. The default value is 1. How do I choose Channel Espressif Systems had announced the application note about Wi-Fi channel selection.","title":" channel"},{"location":"apiconfig.html#dns1","text":"Set primary DNS server address when using static IP address. Type IPAddress","title":" dns1"},{"location":"apiconfig.html#dns2","text":"Set secondary DNS server address when using static IP address. Type IPAddress","title":" dns2"},{"location":"apiconfig.html#gateway","text":"Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 192.168.244.1","title":" gateway"},{"location":"apiconfig.html#hidden","text":"Sets SoftAP to hidden SSID. Type uint8_t Value 0 SSID will be appeared. This is the default. 1 SSID will be hidden.","title":" hidden"},{"location":"apiconfig.html#homeuri","text":"Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is \"/\". Type String","title":" homeUri"},{"location":"apiconfig.html#hostname","text":"Sets the station host name of ESP8266/ESP32. Type String","title":" hostName"},{"location":"apiconfig.html#immediatestart","text":"Disable the first WiFi.begin() and start the captive portal. If this option is enabled, the module will be in AP_STA mode and the captive portal will be activated regardless of AutoConnectConfig::autoRise specification. Type bool Value true Start the captive portal with AutoConnect::begin . false Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default.","title":" immediateStart"},{"location":"apiconfig.html#netmask","text":"Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 255.255.255.0","title":" netmask"},{"location":"apiconfig.html#portaltimeout","text":"Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (ie Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out. Type unsigned long Captive portal timeout value. The default value is 0.","title":" portalTimeout"},{"location":"apiconfig.html#psk","text":"Sets password for SoftAP. The length should be from 8 to up to 63. The default value is 12345678 . Type String","title":" psk"},{"location":"apiconfig.html#retainportal","text":"Specify whether to continue the portal function even if the captive portal timed out. If the true, when a timeout occurs, the AutoConnect::begin function is exited with returns false, but the portal facility remains alive. So SoftAP remains alive and you can invoke AutoConnect while continuing sketch execution. The default is false. Type bool Value true Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP. false When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default. Connection request after timed-out With the retainPortal , even if AutoConnect::begin in the setup() is timed out, you can execute the sketch and the portal function as a WiFi connection attempt by calling AutoConnect::handleClient in the loop().","title":" retainPortal"},{"location":"apiconfig.html#staip","text":"Set a static IP address. The IP will behave with STA mode. Type IPAddress","title":" staip"},{"location":"apiconfig.html#stagateway","text":"Set the gateway address when using static IP address. Type IPAddress","title":" staGateway"},{"location":"apiconfig.html#stanetmask","text":"Set the subnetmask when using static IP address. Type IPAddress","title":" staNetmask"},{"location":"apiconfig.html#title","text":"Set the menu title. Type String","title":" title"},{"location":"apiconfig.html#autoconnectconfig-example","text":"AutoConenct Portal; AutoConenctConfig Config ( \"\" , \"passpass\" ); // SoftAp name is determined at runtime Config.apid = ESP.hostname(); // Retrieve host name to SotAp identification Config.apip = IPAddress( 192 , 168 , 10 , 101 ); // Sets SoftAP IP address Config.gateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WLAN router IP address Config.netmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.autoReconnect = true; // Enable auto-reconnect Config.autoSave = AC_SAVECREDENTIAL_NEVER; // No save credential Config.boundaryOffet = 64 ; // Reserve 64 bytes for the user data in EEPROM. Config.portalTimeout = 60000 ; // Sets timeout value for the captive portal Config.retainPortal = true; // Retains the portal function after timed-out Config.homeUri = \"/index.html\" ; // Sets home path of the sketch application Config.title = \"My menu\" ; // Customize the menu title Config.staip = IPAddress( 192 , 168 , 10 , 10 ); // Sets static IP Config.staGateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WiFi router address Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.dns1 = IPAddress( 192 , 168 , 10 , 1 ); // Sets primary DNS address Portal.config(Config); // Configure AutoConnect Portal.begin(); // Starts and behaves captive portal","title":" AutoConnectConfig example"},{"location":"apielements.html","text":"AutoConnectButton \u00b6 Constructor \u00b6 AutoConnectButton( const char * name = \"\" , const char * value = \"\" , const String & action = String()) Parameters name The element name. value Value of the element. action Native code of the action script executed when the button is clicked. Public member variables \u00b6 name \u00b6 The element name. Type String value \u00b6 Value of the element. Type String action \u00b6 HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script. 1 Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Button AutoConnectCheckbox \u00b6 Constructor \u00b6 explicit AutoConnectCheckboxBasis( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const bool checked = false) Parameters name The element name. value Value of the element. label A label string prefixed to the checkbox. check Checked state of the checkbox. Public member variables \u00b6 name \u00b6 The element name. Type String value \u00b6 Value of the element. It becomes a value attribute of an HTML < input type = \"checkbox\" > tag. Type String label \u00b6 A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML < label > tag with an id attribute. The checkbox and the label are connected by the id attribute. Type String checked \u00b6 It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit. Type Boolean Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Checkbox AutoConnectElement \u00b6 Constructor \u00b6 AutoConnectElement( const char * name = \"\" , const char * value = \"\" ) Parameters name The element name. value Value of the element. Public member variables \u00b6 name \u00b6 The element name. Type String value \u00b6 Value of the element. It is output as HTML as it is as a source for generating HTML code. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Element AutoConnectInput \u00b6 Constructor \u00b6 AutoConnectInput( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const char * pattern = \"\" , const char * placeholder = \"\" ) Parameters name The element name. value Value of the element. label Label string. pattern Regular expression string for checking data format. placeholder A placeholder string. Public member variables \u00b6 name \u00b6 The element name. Type String value \u00b6 Value of the element. It becomes a value attribute of an HTML < input type = \"text\" > tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value. Type String label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. Type String pattern \u00b6 A pattern specifies a regular expression that the input-box's value is checked against on form submission. Type String placeholder \u00b6 A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Input AutoConnectRadio \u00b6 Constructor \u00b6 AutoConnectRadio( const char * name = \"\" , std :: vector < String > const & values = {}, const char * label = \"\" , const ACArrange_t order = AC_Vertical, const uint8_t checked = 0 ) Parameters name The element name. values An array of values of the radio buttons. Specifies an std::vector object. label Label string. order The direction to arrange the radio buttons. checked An index to be checked in the radio buttons. Public member variables \u00b6 name \u00b6 The element name. Type String values \u00b6 An array of String type for the radio button options. It is an initialization list can be used. The < input type = \"radio\" > tags will be generated from each entry in the values. Type std::vector<String> label \u00b6 A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Type String order \u00b6 Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the order . It is a value of ACArrange_t type and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. Type ACArrange_t checked \u00b6 Specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. Type uint8_t Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Radio add \u00b6 void add( const String & value) Adds an option for the radio button. Parameters value An option string to add to the radio button. check \u00b6 void check( const String & value) Indicates the check of the specified option for the radio buttons. You can use the check function for checking dynamically with arbitrary of the radio button. Parameters value An option string to be checked. empty \u00b6 void empty( const size_t reserve = 0 ) Clear the array of option strings that AutoConnectRadio has in values. When a reserve parameter is specified, a vector container of that size is reserved. Parameters reserve Reserved size of a container for option strings. operator [ ] \u00b6 const String & operator [] ( const std :: size_t n) Returns the option string of the index specified by n . Parameters n Index of values array to return. value \u00b6 const String & value( void ) const Returns current checked option of the radio buttons. Return value A String of an option current checked. If there is no checked option, a null string returned. AutoConnectSelect \u00b6 AutoConnectSubmit \u00b6 AutoConnectText \u00b6 JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9","title":"AutoConnectElements API"},{"location":"apielements.html#autoconnectbutton","text":"","title":"AutoConnectButton"},{"location":"apielements.html#constructor","text":"AutoConnectButton( const char * name = \"\" , const char * value = \"\" , const String & action = String()) Parameters name The element name. value Value of the element. action Native code of the action script executed when the button is clicked.","title":" Constructor"},{"location":"apielements.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apielements.html#name","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value","text":"Value of the element. Type String","title":" value"},{"location":"apielements.html#action","text":"HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script. 1 Type String","title":" action"},{"location":"apielements.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apielements.html#typeof","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Button","title":" typeOf"},{"location":"apielements.html#autoconnectcheckbox","text":"","title":"AutoConnectCheckbox"},{"location":"apielements.html#constructor_1","text":"explicit AutoConnectCheckboxBasis( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const bool checked = false) Parameters name The element name. value Value of the element. label A label string prefixed to the checkbox. check Checked state of the checkbox.","title":" Constructor"},{"location":"apielements.html#public-member-variables_1","text":"","title":" Public member variables"},{"location":"apielements.html#name_1","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value_1","text":"Value of the element. It becomes a value attribute of an HTML < input type = \"checkbox\" > tag. Type String","title":" value"},{"location":"apielements.html#label","text":"A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML < label > tag with an id attribute. The checkbox and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#checked","text":"It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit. Type Boolean","title":" checked"},{"location":"apielements.html#public-member-functions_1","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_1","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Checkbox","title":" typeOf"},{"location":"apielements.html#autoconnectelement","text":"","title":"AutoConnectElement"},{"location":"apielements.html#constructor_2","text":"AutoConnectElement( const char * name = \"\" , const char * value = \"\" ) Parameters name The element name. value Value of the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_2","text":"","title":" Public member variables"},{"location":"apielements.html#name_2","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value_2","text":"Value of the element. It is output as HTML as it is as a source for generating HTML code. Type String","title":" value"},{"location":"apielements.html#public-member-functions_2","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_2","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Element","title":" typeOf"},{"location":"apielements.html#autoconnectinput","text":"","title":"AutoConnectInput"},{"location":"apielements.html#constructor_3","text":"AutoConnectInput( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const char * pattern = \"\" , const char * placeholder = \"\" ) Parameters name The element name. value Value of the element. label Label string. pattern Regular expression string for checking data format. placeholder A placeholder string.","title":" Constructor"},{"location":"apielements.html#public-member-variables_3","text":"","title":" Public member variables"},{"location":"apielements.html#name_3","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value_3","text":"Value of the element. It becomes a value attribute of an HTML < input type = \"text\" > tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value. Type String","title":" value"},{"location":"apielements.html#label_1","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#pattern","text":"A pattern specifies a regular expression that the input-box's value is checked against on form submission. Type String","title":" pattern"},{"location":"apielements.html#placeholder","text":"A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. Type String","title":" placeholder"},{"location":"apielements.html#public-member-functions_3","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_3","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Input","title":" typeOf"},{"location":"apielements.html#autoconnectradio","text":"","title":"AutoConnectRadio"},{"location":"apielements.html#constructor_4","text":"AutoConnectRadio( const char * name = \"\" , std :: vector < String > const & values = {}, const char * label = \"\" , const ACArrange_t order = AC_Vertical, const uint8_t checked = 0 ) Parameters name The element name. values An array of values of the radio buttons. Specifies an std::vector object. label Label string. order The direction to arrange the radio buttons. checked An index to be checked in the radio buttons.","title":" Constructor"},{"location":"apielements.html#public-member-variables_4","text":"","title":" Public member variables"},{"location":"apielements.html#name_4","text":"The element name. Type String","title":" name"},{"location":"apielements.html#values","text":"An array of String type for the radio button options. It is an initialization list can be used. The < input type = \"radio\" > tags will be generated from each entry in the values. Type std::vector<String>","title":" values"},{"location":"apielements.html#label_2","text":"A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Type String","title":" label"},{"location":"apielements.html#order","text":"Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the order . It is a value of ACArrange_t type and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. Type ACArrange_t","title":" order"},{"location":"apielements.html#checked_1","text":"Specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. Type uint8_t","title":" checked"},{"location":"apielements.html#public-member-functions_4","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_4","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Radio","title":" typeOf"},{"location":"apielements.html#add","text":"void add( const String & value) Adds an option for the radio button. Parameters value An option string to add to the radio button.","title":" add"},{"location":"apielements.html#check","text":"void check( const String & value) Indicates the check of the specified option for the radio buttons. You can use the check function for checking dynamically with arbitrary of the radio button. Parameters value An option string to be checked.","title":" check"},{"location":"apielements.html#empty","text":"void empty( const size_t reserve = 0 ) Clear the array of option strings that AutoConnectRadio has in values. When a reserve parameter is specified, a vector container of that size is reserved. Parameters reserve Reserved size of a container for option strings.","title":" empty"},{"location":"apielements.html#operator","text":"const String & operator [] ( const std :: size_t n) Returns the option string of the index specified by n . Parameters n Index of values array to return.","title":" operator &#91;&nbsp;&#93;"},{"location":"apielements.html#value_4","text":"const String & value( void ) const Returns current checked option of the radio buttons. Return value A String of an option current checked. If there is no checked option, a null string returned.","title":" value"},{"location":"apielements.html#autoconnectselect","text":"","title":"AutoConnectSelect"},{"location":"apielements.html#autoconnectsubmit","text":"","title":"AutoConnectSubmit"},{"location":"apielements.html#autoconnecttext","text":"JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9","title":"AutoConnectText"},{"location":"apiextra.html","text":"Icons \u00b6 The library presents two PNG icons which can be used to embed a hyperlink to the AutoConnect menu. Bar type Cog type To reference the icon, use the AUTOCONNECT_LINK macro in the sketch. It expands into the string literal as an HTML <a></a> tag with PNG embedded of the AutoConnect menu hyperlinks. Icon type is specified by the parameter of the macro. BAR_24 Bars icon, 24x24. BAR_32 Bars icon, 32x32. BAR_48 Bars icon, 48x48. COG_24 Cog icon, 24x24. COG_32 Cog icon, 32x32. Usage String html = \"<html>\" ; html += AUTOCONNECT_LINK(BAR_32); html += \"</html>\" ; server.send( 200 , \"text/html\" , html);","title":"Something extra"},{"location":"apiextra.html#icons","text":"The library presents two PNG icons which can be used to embed a hyperlink to the AutoConnect menu. Bar type Cog type To reference the icon, use the AUTOCONNECT_LINK macro in the sketch. It expands into the string literal as an HTML <a></a> tag with PNG embedded of the AutoConnect menu hyperlinks. Icon type is specified by the parameter of the macro. BAR_24 Bars icon, 24x24. BAR_32 Bars icon, 32x32. BAR_48 Bars icon, 48x48. COG_24 Cog icon, 24x24. COG_32 Cog icon, 32x32. Usage String html = \"<html>\" ; html += AUTOCONNECT_LINK(BAR_32); html += \"</html>\" ; server.send( 200 , \"text/html\" , html);","title":" Icons"},{"location":"basicusage.html","text":"Simple usage \u00b6 Embed to the sketches \u00b6 How embed the AutoConnect to the sketches you have. Most simple approach to applying AutoConnect for the existing sketches, follow the below steps. The below sketch is for ESP8266. For ESP32, replace ESP8266WebServer with WebServer and ESP8266WiFi.h with WiFi.h respectively. Insert #include <AutoConnect.h> to behind of #include <ESP8266WebServer.h> . Insert AutoConnect PORTAL(WEBSERVER); to behind of ESP8266WebServer WEBSERVER; declaration. 1 Remove WiFi. begin ( SSID , PSK ) and the subsequent logic for the connection status check. Replace WEBSERVER . begin () to PORTAL . begin () . 2 Replace WEBSERVER . handleClient () to PORTAL . handleClient () . 3 If the connection checks logic is needed, you can check the return value according to PORTAL . begin () with true or false . Basic usage \u00b6 Basic logic sequence for the user sketches \u00b6 1. A typical logic sequence \u00b6 Include headers, ESP8266WebServer.h / WebServer.h and AutoConnect.h Declare an ESP8266WebServer variable for ESP8266 or a WebServer variable for ESP32. Declare an AutoConnect variable. Implement the URL handlers provided for the on method of ESP8266WebServer/WebServer with the function() . setup() 5.1 Sets URL handler the function() to ESP8266WebServer/WebServer by ESP8266WebServer::on / WebServer::on . 5.2 Starts AutoConnect::begin() . 5.3 Check WiFi connection status. loop() 6.1 Do the process for actual sketch. 6.2 Invokes AutoConnect::handleClient() , or invokes ESP8266WebServer::handleClient() / WebServer::handleClient then AutoConnect::handleRequest() . 2. Declare AutoConnect object \u00b6 Two options are available for AutoConnect constructor . AutoConnect VARIABLE ( & ESP8266WebServer); // For ESP8266 AutoConnect VARIABLE ( & WebServer); // For ESP32 or AutoConnect VARIABLE; The parameter with an ESP8266WebServer/WebServer variable: An ESP8266WebServer/WebServer object variable must be declared. AutoConnect uses its variable to handles the AutoConnect menu . With no parameter: The sketch does not declare ESP8266WebServer/WebServer object. In this case, AutoConnect allocates an instance of the ESP8266WebServer/WebServer internally. The logic sequence of the sketch is somewhat different as the above. To register a URL handler function by ESP8266WebServer::on or WebServer::on should be performed after AutoConnect::begin . 3. No need WiFI.begin(...) \u00b6 AutoConnect internally performs WiFi.begin to establish a WiFi connection. There is no need for a general process to establish a connection using WiFi.begin with a sketch code. 4. Alternate ESP8266WebServer::begin() and WebServer::begin() \u00b6 AutoConnect::begin executes ESP8266WebServer::begin / WebServer::begin internally too and it starts the DNS server to behave as a Captive portal. So it is not needed to call ESP8266WebServer::begin / WebServer::begin in the sketch. Why DNS Server starts AutoConnect traps the detection of the captive portal and achieves a connection with the WLAN interactively by the AutoConnect menu. It responds SoftAP address to all DNS queries temporarily to trap. Once a WiFi connection establishes, the DNS server contributed by AutoConnect stops. 5. AutoConnect::begin with SSID and Password \u00b6 SSID and Password can also specify by AutoConnect::begin . ESP8266/ESP32 uses provided SSID and Password explicitly. If the connection false with specified SSID with Password then a captive portal is activated. SSID and Password are not present, ESP8266 SDK will attempt to connect using the still effectual SSID and password. Usually, it succeeds. 6. Use ESP8266WebServer::on and WebServer::on to handle URL \u00b6 AutoConnect is designed to coexist with the process for handling the web pages by user sketches. The page processing function which will send an HTML to the client invoked by the \" on::ESP8266WebServer \" or the \" on::WebServer \" function is the same as when using ESP8266WebServer/WebServer natively. 7. Use either ESP8266WebServer::handleClient()/WebServer::handleClient() or AutoConnect::handleClient() \u00b6 Both classes member function name is the same: handleClient , but the behavior is different. Using the AutoConnect embedded along with ESP8266WebServer::handleClient/WebServer::handleClient has limitations. Refer to the below section for details. ESP8266WebServer/WebServer hosted or parasitic \u00b6 The interoperable process with an ESP8266WebServer/WebServer depends on the parameters of the AutoConnect constructor . Declaration parameter for the constructor Use ESP8266WebServer::handleClient or WebServer::handleClient only Use AutoConnect::handleClient None AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . also to use ESP8266WebServer/WebServer natively, need AutoConnect::host() . AutoConnect menu available. To use ESP8266WebServer/WebServer natively, need AutoConnect::host() . Reference to ESP8266WebServer/WebServer AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . AutoConnect menu available. By declaration for the AutoConnect variable with no parameter : The ESP8266WebServer/WebServer instance is hosted by AutoConnect automatically then the sketches use AutoConnect::host as API to get it after AutoConnect::begin performed. By declaration for the AutoConnect variable with the reference of ESP8266WebServer/WebServer : AutoConnect will use it. The sketch can use it is too. In use ESP8266WebServer::handleClient()/WebServer::handleClient() : AutoConnect menu can be dispatched but not works normally. It is necessary to call AutoConnect::handleRequest after ESP8255WebServer::handleClient / WebServer::handleClient invoking. In use AutoConnect::handleClient() : The handleClient() process and the AutoConnect menu is available without calling ESP8266WebServer::handleClient . Why AutoConnect::handleRequest is needed when using ESP8266WebServer::handleClient/WebServer::handleClient The AutoConnect menu function may affect WiFi connection state. It follows that the menu process must execute outside ESP8266WebServer::handleClient and WebServer::handleClient . AutoConnect::handleClient is equivalent ESP8266WebServer::handleClient and WEbServer::handleClient included AutoConnect::handleRequest . Each VARIABLE conforms to the actual declaration in the sketches. \u21a9 WiFi SSID and Password can be specified AutoConnect::begin() too. \u21a9 Replacement the handleClient method is not indispensable. AutoConnect can still connect with the captive portal as it is ESP8266WebServer::handleClient. But it can not valid AutoConnect menu . \u21a9","title":"Basic usage"},{"location":"basicusage.html#simple-usage","text":"","title":"Simple usage"},{"location":"basicusage.html#embed-to-the-sketches","text":"How embed the AutoConnect to the sketches you have. Most simple approach to applying AutoConnect for the existing sketches, follow the below steps. The below sketch is for ESP8266. For ESP32, replace ESP8266WebServer with WebServer and ESP8266WiFi.h with WiFi.h respectively. Insert #include <AutoConnect.h> to behind of #include <ESP8266WebServer.h> . Insert AutoConnect PORTAL(WEBSERVER); to behind of ESP8266WebServer WEBSERVER; declaration. 1 Remove WiFi. begin ( SSID , PSK ) and the subsequent logic for the connection status check. Replace WEBSERVER . begin () to PORTAL . begin () . 2 Replace WEBSERVER . handleClient () to PORTAL . handleClient () . 3 If the connection checks logic is needed, you can check the return value according to PORTAL . begin () with true or false .","title":" Embed to the sketches"},{"location":"basicusage.html#basic-usage","text":"","title":"Basic usage"},{"location":"basicusage.html#basic-logic-sequence-for-the-user-sketches","text":"","title":" Basic logic sequence for the user sketches"},{"location":"basicusage.html#1-a-typical-logic-sequence","text":"Include headers, ESP8266WebServer.h / WebServer.h and AutoConnect.h Declare an ESP8266WebServer variable for ESP8266 or a WebServer variable for ESP32. Declare an AutoConnect variable. Implement the URL handlers provided for the on method of ESP8266WebServer/WebServer with the function() . setup() 5.1 Sets URL handler the function() to ESP8266WebServer/WebServer by ESP8266WebServer::on / WebServer::on . 5.2 Starts AutoConnect::begin() . 5.3 Check WiFi connection status. loop() 6.1 Do the process for actual sketch. 6.2 Invokes AutoConnect::handleClient() , or invokes ESP8266WebServer::handleClient() / WebServer::handleClient then AutoConnect::handleRequest() .","title":"1. A typical logic sequence"},{"location":"basicusage.html#2-declare-autoconnect-object","text":"Two options are available for AutoConnect constructor . AutoConnect VARIABLE ( & ESP8266WebServer); // For ESP8266 AutoConnect VARIABLE ( & WebServer); // For ESP32 or AutoConnect VARIABLE; The parameter with an ESP8266WebServer/WebServer variable: An ESP8266WebServer/WebServer object variable must be declared. AutoConnect uses its variable to handles the AutoConnect menu . With no parameter: The sketch does not declare ESP8266WebServer/WebServer object. In this case, AutoConnect allocates an instance of the ESP8266WebServer/WebServer internally. The logic sequence of the sketch is somewhat different as the above. To register a URL handler function by ESP8266WebServer::on or WebServer::on should be performed after AutoConnect::begin .","title":"2. Declare AutoConnect object"},{"location":"basicusage.html#3-no-need-wifibegin","text":"AutoConnect internally performs WiFi.begin to establish a WiFi connection. There is no need for a general process to establish a connection using WiFi.begin with a sketch code.","title":"3. No need WiFI.begin(...)"},{"location":"basicusage.html#4-alternate-esp8266webserverbegin-and-webserverbegin","text":"AutoConnect::begin executes ESP8266WebServer::begin / WebServer::begin internally too and it starts the DNS server to behave as a Captive portal. So it is not needed to call ESP8266WebServer::begin / WebServer::begin in the sketch. Why DNS Server starts AutoConnect traps the detection of the captive portal and achieves a connection with the WLAN interactively by the AutoConnect menu. It responds SoftAP address to all DNS queries temporarily to trap. Once a WiFi connection establishes, the DNS server contributed by AutoConnect stops.","title":"4. Alternate ESP8266WebServer::begin() and WebServer::begin()"},{"location":"basicusage.html#5-autoconnectbegin-with-ssid-and-password","text":"SSID and Password can also specify by AutoConnect::begin . ESP8266/ESP32 uses provided SSID and Password explicitly. If the connection false with specified SSID with Password then a captive portal is activated. SSID and Password are not present, ESP8266 SDK will attempt to connect using the still effectual SSID and password. Usually, it succeeds.","title":"5. AutoConnect::begin with SSID and Password"},{"location":"basicusage.html#6-use-esp8266webserveron-and-webserveron-to-handle-url","text":"AutoConnect is designed to coexist with the process for handling the web pages by user sketches. The page processing function which will send an HTML to the client invoked by the \" on::ESP8266WebServer \" or the \" on::WebServer \" function is the same as when using ESP8266WebServer/WebServer natively.","title":"6. Use ESP8266WebServer::on and WebServer::on to handle URL"},{"location":"basicusage.html#7-use-either-esp8266webserverhandleclientwebserverhandleclient-or-autoconnecthandleclient","text":"Both classes member function name is the same: handleClient , but the behavior is different. Using the AutoConnect embedded along with ESP8266WebServer::handleClient/WebServer::handleClient has limitations. Refer to the below section for details.","title":"7. Use either ESP8266WebServer::handleClient()/WebServer::handleClient() or AutoConnect::handleClient()"},{"location":"basicusage.html#esp8266webserverwebserver-hosted-or-parasitic","text":"The interoperable process with an ESP8266WebServer/WebServer depends on the parameters of the AutoConnect constructor . Declaration parameter for the constructor Use ESP8266WebServer::handleClient or WebServer::handleClient only Use AutoConnect::handleClient None AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . also to use ESP8266WebServer/WebServer natively, need AutoConnect::host() . AutoConnect menu available. To use ESP8266WebServer/WebServer natively, need AutoConnect::host() . Reference to ESP8266WebServer/WebServer AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . AutoConnect menu available. By declaration for the AutoConnect variable with no parameter : The ESP8266WebServer/WebServer instance is hosted by AutoConnect automatically then the sketches use AutoConnect::host as API to get it after AutoConnect::begin performed. By declaration for the AutoConnect variable with the reference of ESP8266WebServer/WebServer : AutoConnect will use it. The sketch can use it is too. In use ESP8266WebServer::handleClient()/WebServer::handleClient() : AutoConnect menu can be dispatched but not works normally. It is necessary to call AutoConnect::handleRequest after ESP8255WebServer::handleClient / WebServer::handleClient invoking. In use AutoConnect::handleClient() : The handleClient() process and the AutoConnect menu is available without calling ESP8266WebServer::handleClient . Why AutoConnect::handleRequest is needed when using ESP8266WebServer::handleClient/WebServer::handleClient The AutoConnect menu function may affect WiFi connection state. It follows that the menu process must execute outside ESP8266WebServer::handleClient and WebServer::handleClient . AutoConnect::handleClient is equivalent ESP8266WebServer::handleClient and WEbServer::handleClient included AutoConnect::handleRequest . Each VARIABLE conforms to the actual declaration in the sketches. \u21a9 WiFi SSID and Password can be specified AutoConnect::begin() too. \u21a9 Replacement the handleClient method is not indispensable. AutoConnect can still connect with the captive portal as it is ESP8266WebServer::handleClient. But it can not valid AutoConnect menu . \u21a9","title":" ESP8266WebServer/WebServer hosted or parasitic"},{"location":"changelog.html","text":"[0.9.7] Jan. 25, 2019 \u00b6 Fixed crash in some environments. Thank you @ageurtse Supports AutoConnect menu extention by user sketch with AutoConnectAux . Supports loading and saving of user-defined parameters with JSON format. Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed. Supports the AutoConnectConfig::immediateStart option and immediately starts the portal without first trying WiFi.begin. You can start the captive portal at any time in combination with the AutoConnectConfig::autoRise option. Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu. Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h . Supports AutoConnectConfig::hostName . It activates WiFi.hostname() / WiFi.setHostName() . Supports the captive portal time-out. It can be controlled by AutoConnectConfig::portalTimeout and AutoConnectConfig::retainPortal . [0.9.6] Sep.27, 2018. \u00b6 Improvement of RSSI detection for saved SSIDs. Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin . [0.9.5] Aug.27, 2018. \u00b6 Supports ESP32. Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks. [0.9.4] May 5, 2018. \u00b6 Automatically focus passphrase after selecting SSID with Configure New AP. Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting. [0.9.3] March 23, 2018. \u00b6 Supports a static IP address assignment. [0.9.2] March 19, 2018. \u00b6 Improvement of string literal declaration with the examples, no library change. [0.9.1] March 13, 2018. \u00b6 A release of the stable.","title":"Change log"},{"location":"changelog.html#097-jan-25-2019","text":"Fixed crash in some environments. Thank you @ageurtse Supports AutoConnect menu extention by user sketch with AutoConnectAux . Supports loading and saving of user-defined parameters with JSON format. Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed. Supports the AutoConnectConfig::immediateStart option and immediately starts the portal without first trying WiFi.begin. You can start the captive portal at any time in combination with the AutoConnectConfig::autoRise option. Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu. Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h . Supports AutoConnectConfig::hostName . It activates WiFi.hostname() / WiFi.setHostName() . Supports the captive portal time-out. It can be controlled by AutoConnectConfig::portalTimeout and AutoConnectConfig::retainPortal .","title":"[0.9.7] Jan. 25, 2019"},{"location":"changelog.html#096-sep27-2018","text":"Improvement of RSSI detection for saved SSIDs. Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin .","title":"[0.9.6] Sep.27, 2018."},{"location":"changelog.html#095-aug27-2018","text":"Supports ESP32. Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks.","title":"[0.9.5] Aug.27, 2018."},{"location":"changelog.html#094-may-5-2018","text":"Automatically focus passphrase after selecting SSID with Configure New AP. Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting.","title":"[0.9.4] May 5, 2018."},{"location":"changelog.html#093-march-23-2018","text":"Supports a static IP address assignment.","title":"[0.9.3] March 23, 2018."},{"location":"changelog.html#092-march-19-2018","text":"Improvement of string literal declaration with the examples, no library change.","title":"[0.9.2] March 19, 2018."},{"location":"changelog.html#091-march-13-2018","text":"A release of the stable.","title":"[0.9.1] March 13, 2018."},{"location":"faq.html","text":"After connected, AutoConnect menu performs but no happens. \u00b6 If you can access the AutoConnect root path as http://ESP8266IPADDRESS/_ac from browser, probably the sketch uses ESP8266WebServer::handleClient() without AutoConnect::handleRequest() . For AutoConnect menus to work properly, call AutoConnect::handleRequest() after ESP8266WebServer::handleClient() invoked, or use AutoConnect::handleClient() . AutoConnect::handleClient() is equivalent ESP8266WebServer::handleClient combined AutoConnect::handleRequest() . See also the explanation here . An esp8266ap as SoftAP was connected but Captive portal does not start. \u00b6 Captive portal detection could not be trapped. It is necessary to disconnect and reset ESP8266 to clear memorized connection data in ESP8266. Also, It may be displayed on the smartphone if the connection information of esp8266ap is wrong. In that case, delete the connection information of esp8266ap memorized by the smartphone once. Does not appear esp8266ap in smartphone. \u00b6 Maybe it is successfully connected at the first WiFi.begin . ESP8266 remembers the last SSID successfully connected and will use at the next. It means SoftAP will only start up when the first WiFi.begin() fails. The saved SSID would be cleared by WiFi.disconnect() with WIFI_STA mode. If you do not want automatic reconnection, you can erase the memorized SSID with the following simple sketch. #include <ESP8266WiFi.h> void setup () { delay( 1000 ); Serial.begin( 115200 ); WiFi.mode(WIFI_STA); delay( 100 ); WiFi.begin(); if (WiFi.waitForConnectResult() == WL_CONNECTED) { WiFi.disconnect(); while (WiFi.status() == WL_CONNECTED) delay( 100 ); } Serial.println( \"WiFi disconnected.\" ); } void loop () { delay( 1000 ); } You can interactively check the WiFi state of ESP8266. Please try ESPShaker . It is ESP8266 interactive serial command processor. Does not response from /_ac. \u00b6 Probably WiFi.begin failed with the specified SSID. Activating the debug printing will help you to track down the cause. How change esp8266ap for SSID name in Captive portal? \u00b6 An esp8266ap is default SSID name for SoftAP of captive portal and password is 12345678 . You can change both by using AutoConnectConfig . How change HTTP port? \u00b6 HTTP port number is defined as a macro in AutoConnect.h header file. You can change it directly with several editors and must re-compile. #define AUTOCONNECT_HTTPPORT 80 Hang up after Reset? \u00b6 If ESP8266 hang up after reset by AutoConnect menu, perhaps manual reset is not yet. Especially if it is not manual reset yet after uploading the sketch, the boot mode will stay 'Uart Download'. There is some discussion about this on the Github's ESP8266 core: https://github.com/esp8266/Arduino/issues/1017 If you received the following message, the boot mode is still sketch uploaded. It needs to the manual reset once. ets Jan 8 2013,rst cause:2, boot mode:(1,6) or (1,7) ets Jan 8 2013,rst cause:4, boot mode:(1,6) or (1,7) wdt reset The correct boot mode for starting the sketch is (3, x) . ESP8266 Boot Messages It is described by ESP8266 Non-OS SDK API Reference , section A.5. Messages Description rst cause 1: power on 2: external reset 4: hardware watchdog reset boot mode (the first parameter) 1: ESP8266 is in UART-down mode (and downloads firmware into flash). 3: ESP8266 is in Flash-boot mode (and boots up from flash). How erase the credentials saved in EEPROM? \u00b6 Make some sketches for erasing the EEPROM area, or some erasing utility is needed. You can prepare the sketch to erase the saved credential with AutoConnectCredential . The AutoConnectCrendential class provides the access method to the saved credential in EEPROM and library source file is including it. A class description of AutoConnectCredential is follows. Include header \u00b6 #include <AutoConnectCredential.h> Constructor \u00b6 AutoConnectCredential(); AutoConnectCredential default constructor. The default offset value is 0. If the offset value is 0, the credential storage area starts from the top of the EEPROM. AutoConnect sometimes overwrites data when using this area with user sketch. AutoConnectCredential( uint16_t offset); Specify offset from the top of the EEPROM for the credential storage area together. The offset value is from 0 to the flash sector size. Public member functions \u00b6 uint8_t entries() Returns number of entries as contained credentials. int8_t load(const char* ssid , struct station_config* config ) Load a credential entry specified ssid to config . Returns -1 as unsuccessfully loaded. bool load(int8_t entry , struct station_config* config ) Load a credential entry to config . The entry parameter specify to index of the entry. bool save(const struct station_config* config ) Save a credential entry stored in config to EEPROM. Returns the true as succeeded. bool del(const char* ssid ) Delete a credential entry specified ssid . Returns the true as successfully deleted. Data structures \u00b6 station_config A structure is included in the ESP8266 SDK. You can use it in the sketch like as follows. extern \"C\" { #include <user_interface.h> } struct station_config { uint8 ssid[ 32 ]; uint8 password[ 64 ]; uint8 bssid_set; uint8 bssid[ 6 ]; }; EEPROM data structure A data structure of the credential saving area in EEPROM as the below. 1 Byte offset Length Value 0 8 AC_CREDT 8 1 Number of contained entries (uint8_t) 9 2 Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). 11 variable SSID terminated by 0x00. Max length is 32 bytes. variable variable Password plain text terminated by 0x00. Max length is 64 bytes. variable 6 BSSID variable Contained the next entries. (Continuation SSID+Password+BSSID) variable 1 0x00. End of container. Hint With the ESPShaker , you can access EEPROM interactively from the serial monitor, and of course you can erase saved credentials. How locate the link button to the AutoConnect menu? \u00b6 Link button to AutoConnect menu can be embedded into Sketch's web page. The root path of the menu is /_ac by default and embed the following <a></a> tag in the generating HTML. < a style = \"background-color:SteelBlue; display:inline-block; padding:7px 13px; text-decoration:none;\" href = \"/_ac\" > MENU </ a > How much memory does AutoConnect consume? \u00b6 Sketch size \u00b6 It increases about 53K bytes compared to the case without AutoConnect. A sketch size of the most simple example introduced in the Getting started is about 330K bytes. (270K byte without AutoConnect) Heap size \u00b6 It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed. I cannot complete to Wi-Fi login from smartphone. \u00b6 Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu. I can not see the custom web page. \u00b6 JSON parse error AutoConnect behaves not stable with my sketch yet. \u00b6 If AutoConnect behavior is not stable with your sketch, you can try the following measures. 1. Change WiFi channel \u00b6 Both ESP8266 and ESP32 can only work on one channel at any given moment, this will cause loss of connection on the channel where your station operates the captive portal. If the channel of the AP which you want to connect is different from the SoftAP channel, the operation of the captive portal will not respond with the screen of the AutoConnect connection attempt remains displayed. In such a case please try the AutoConnectConfig to match the channel to the access point. 2. Change arduino core version \u00b6 I recommend change installed an arduino core version to the upstream when your sketch is not stable with AutoConnect on each board. with ESP8266 arduino core \u00b6 To stabilize the behavior, You can select the lwIP variant to contribute. Lower memory option of Arduino IDE for core version 2.4.2 is based on the lwIP-v2. On the other hand, the core version 2.5.0 upstream is based on the lwIP-2.1.2 stable release. You can select the option from Arduino IDE as Tool menu, if you are using ESP8266 core 2.5.0. It can be select lwIP v2 Lower Memory option. (not lwIP v2 Lower Memory (no features) ) It is expected to improve response performance and stability. with ESP32 arduino core \u00b6 The arduino-esp32 is still under development even if it is a stable release. It is necessary to judge whether the cause of the problem is the core or AutoConnect. Trace the log with the esp32 core and the AutoConnect debug option enabled for problem diagnosis and please you check the issue of arduino-esp32 . The problem that your sketch possesses may already have been solved. 3. Turn on the debug log options \u00b6 To fully enable for the AutoConnect debug logging options, change the following two files. AutoConnectDefs.h #define AC_DEBUG PageBuilder.h 2 #define PB_DEBUG 4. Reports the issue to AutoConnect repository on Github \u00b6 If you can not solve AutoConnect problems please report to Issues . And please make your question comprehensively, not a statement. Include all relevant information. There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused. \u21a9 PageBuilder.h file exists in the libraries/PageBuilder/src directory under your sketch folder. \u21a9","title":"FAQ"},{"location":"faq.html#after-connected-autoconnect-menu-performs-but-no-happens","text":"If you can access the AutoConnect root path as http://ESP8266IPADDRESS/_ac from browser, probably the sketch uses ESP8266WebServer::handleClient() without AutoConnect::handleRequest() . For AutoConnect menus to work properly, call AutoConnect::handleRequest() after ESP8266WebServer::handleClient() invoked, or use AutoConnect::handleClient() . AutoConnect::handleClient() is equivalent ESP8266WebServer::handleClient combined AutoConnect::handleRequest() . See also the explanation here .","title":" After connected, AutoConnect menu performs but no happens."},{"location":"faq.html#an-esp8266ap-as-softap-was-connected-but-captive-portal-does-not-start","text":"Captive portal detection could not be trapped. It is necessary to disconnect and reset ESP8266 to clear memorized connection data in ESP8266. Also, It may be displayed on the smartphone if the connection information of esp8266ap is wrong. In that case, delete the connection information of esp8266ap memorized by the smartphone once.","title":" An esp8266ap as SoftAP was connected but Captive portal does not start."},{"location":"faq.html#does-not-appear-esp8266ap-in-smartphone","text":"Maybe it is successfully connected at the first WiFi.begin . ESP8266 remembers the last SSID successfully connected and will use at the next. It means SoftAP will only start up when the first WiFi.begin() fails. The saved SSID would be cleared by WiFi.disconnect() with WIFI_STA mode. If you do not want automatic reconnection, you can erase the memorized SSID with the following simple sketch. #include <ESP8266WiFi.h> void setup () { delay( 1000 ); Serial.begin( 115200 ); WiFi.mode(WIFI_STA); delay( 100 ); WiFi.begin(); if (WiFi.waitForConnectResult() == WL_CONNECTED) { WiFi.disconnect(); while (WiFi.status() == WL_CONNECTED) delay( 100 ); } Serial.println( \"WiFi disconnected.\" ); } void loop () { delay( 1000 ); } You can interactively check the WiFi state of ESP8266. Please try ESPShaker . It is ESP8266 interactive serial command processor.","title":" Does not appear esp8266ap in smartphone."},{"location":"faq.html#does-not-response-from-95ac","text":"Probably WiFi.begin failed with the specified SSID. Activating the debug printing will help you to track down the cause.","title":" Does not response from /_ac."},{"location":"faq.html#how-change-esp8266ap-for-ssid-name-in-captive-portal","text":"An esp8266ap is default SSID name for SoftAP of captive portal and password is 12345678 . You can change both by using AutoConnectConfig .","title":" How change esp8266ap for SSID name in Captive portal?"},{"location":"faq.html#how-change-http-port","text":"HTTP port number is defined as a macro in AutoConnect.h header file. You can change it directly with several editors and must re-compile. #define AUTOCONNECT_HTTPPORT 80","title":" How change HTTP port?"},{"location":"faq.html#hang-up-after-reset","text":"If ESP8266 hang up after reset by AutoConnect menu, perhaps manual reset is not yet. Especially if it is not manual reset yet after uploading the sketch, the boot mode will stay 'Uart Download'. There is some discussion about this on the Github's ESP8266 core: https://github.com/esp8266/Arduino/issues/1017 If you received the following message, the boot mode is still sketch uploaded. It needs to the manual reset once. ets Jan 8 2013,rst cause:2, boot mode:(1,6) or (1,7) ets Jan 8 2013,rst cause:4, boot mode:(1,6) or (1,7) wdt reset The correct boot mode for starting the sketch is (3, x) . ESP8266 Boot Messages It is described by ESP8266 Non-OS SDK API Reference , section A.5. Messages Description rst cause 1: power on 2: external reset 4: hardware watchdog reset boot mode (the first parameter) 1: ESP8266 is in UART-down mode (and downloads firmware into flash). 3: ESP8266 is in Flash-boot mode (and boots up from flash).","title":" Hang up after Reset?"},{"location":"faq.html#how-erase-the-credentials-saved-in-eeprom","text":"Make some sketches for erasing the EEPROM area, or some erasing utility is needed. You can prepare the sketch to erase the saved credential with AutoConnectCredential . The AutoConnectCrendential class provides the access method to the saved credential in EEPROM and library source file is including it. A class description of AutoConnectCredential is follows.","title":" How erase the credentials saved in EEPROM?"},{"location":"faq.html#include-header","text":"#include <AutoConnectCredential.h>","title":"Include header"},{"location":"faq.html#constructor","text":"AutoConnectCredential(); AutoConnectCredential default constructor. The default offset value is 0. If the offset value is 0, the credential storage area starts from the top of the EEPROM. AutoConnect sometimes overwrites data when using this area with user sketch. AutoConnectCredential( uint16_t offset); Specify offset from the top of the EEPROM for the credential storage area together. The offset value is from 0 to the flash sector size.","title":"Constructor"},{"location":"faq.html#public-member-functions","text":"uint8_t entries() Returns number of entries as contained credentials. int8_t load(const char* ssid , struct station_config* config ) Load a credential entry specified ssid to config . Returns -1 as unsuccessfully loaded. bool load(int8_t entry , struct station_config* config ) Load a credential entry to config . The entry parameter specify to index of the entry. bool save(const struct station_config* config ) Save a credential entry stored in config to EEPROM. Returns the true as succeeded. bool del(const char* ssid ) Delete a credential entry specified ssid . Returns the true as successfully deleted.","title":"Public member functions"},{"location":"faq.html#data-structures","text":"station_config A structure is included in the ESP8266 SDK. You can use it in the sketch like as follows. extern \"C\" { #include <user_interface.h> } struct station_config { uint8 ssid[ 32 ]; uint8 password[ 64 ]; uint8 bssid_set; uint8 bssid[ 6 ]; }; EEPROM data structure A data structure of the credential saving area in EEPROM as the below. 1 Byte offset Length Value 0 8 AC_CREDT 8 1 Number of contained entries (uint8_t) 9 2 Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). 11 variable SSID terminated by 0x00. Max length is 32 bytes. variable variable Password plain text terminated by 0x00. Max length is 64 bytes. variable 6 BSSID variable Contained the next entries. (Continuation SSID+Password+BSSID) variable 1 0x00. End of container. Hint With the ESPShaker , you can access EEPROM interactively from the serial monitor, and of course you can erase saved credentials.","title":"Data structures"},{"location":"faq.html#how-locate-the-link-button-to-the-autoconnect-menu","text":"Link button to AutoConnect menu can be embedded into Sketch's web page. The root path of the menu is /_ac by default and embed the following <a></a> tag in the generating HTML. < a style = \"background-color:SteelBlue; display:inline-block; padding:7px 13px; text-decoration:none;\" href = \"/_ac\" > MENU </ a >","title":" How locate the link button to the  AutoConnect menu?"},{"location":"faq.html#how-much-memory-does-autoconnect-consume","text":"","title":" How much memory does AutoConnect consume?"},{"location":"faq.html#sketch-size","text":"It increases about 53K bytes compared to the case without AutoConnect. A sketch size of the most simple example introduced in the Getting started is about 330K bytes. (270K byte without AutoConnect)","title":"Sketch size"},{"location":"faq.html#heap-size","text":"It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed.","title":"Heap size"},{"location":"faq.html#i-cannot-complete-to-wi-fi-login-from-smartphone","text":"Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu.","title":" I cannot complete to Wi-Fi login from smartphone."},{"location":"faq.html#i-can-not-see-the-custom-web-page","text":"JSON parse error","title":" I can not see the custom web page."},{"location":"faq.html#autoconnect-behaves-not-stable-with-my-sketch-yet","text":"If AutoConnect behavior is not stable with your sketch, you can try the following measures.","title":" AutoConnect behaves not stable with my sketch yet."},{"location":"faq.html#1-change-wifi-channel","text":"Both ESP8266 and ESP32 can only work on one channel at any given moment, this will cause loss of connection on the channel where your station operates the captive portal. If the channel of the AP which you want to connect is different from the SoftAP channel, the operation of the captive portal will not respond with the screen of the AutoConnect connection attempt remains displayed. In such a case please try the AutoConnectConfig to match the channel to the access point.","title":"1. Change WiFi channel"},{"location":"faq.html#2-change-arduino-core-version","text":"I recommend change installed an arduino core version to the upstream when your sketch is not stable with AutoConnect on each board.","title":"2. Change arduino core version"},{"location":"faq.html#with-esp8266-arduino-core","text":"To stabilize the behavior, You can select the lwIP variant to contribute. Lower memory option of Arduino IDE for core version 2.4.2 is based on the lwIP-v2. On the other hand, the core version 2.5.0 upstream is based on the lwIP-2.1.2 stable release. You can select the option from Arduino IDE as Tool menu, if you are using ESP8266 core 2.5.0. It can be select lwIP v2 Lower Memory option. (not lwIP v2 Lower Memory (no features) ) It is expected to improve response performance and stability.","title":"with ESP8266 arduino core"},{"location":"faq.html#with-esp32-arduino-core","text":"The arduino-esp32 is still under development even if it is a stable release. It is necessary to judge whether the cause of the problem is the core or AutoConnect. Trace the log with the esp32 core and the AutoConnect debug option enabled for problem diagnosis and please you check the issue of arduino-esp32 . The problem that your sketch possesses may already have been solved.","title":"with ESP32 arduino core"},{"location":"faq.html#3-turn-on-the-debug-log-options","text":"To fully enable for the AutoConnect debug logging options, change the following two files. AutoConnectDefs.h #define AC_DEBUG PageBuilder.h 2 #define PB_DEBUG","title":"3. Turn on the debug log options"},{"location":"faq.html#4-reports-the-issue-to-autoconnect-repository-on-github","text":"If you can not solve AutoConnect problems please report to Issues . And please make your question comprehensively, not a statement. Include all relevant information. There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused. \u21a9 PageBuilder.h file exists in the libraries/PageBuilder/src directory under your sketch folder. \u21a9","title":"4. Reports the issue to AutoConnect repository on Github"},{"location":"gettingstarted.html","text":"Let's do the most simple sketch \u00b6 Open the Arduino IDE, write the following sketch and upload it. The feature of this sketch is that the SSID and Password are not coded. #include <ESP8266WiFi.h> // Replace with WiFi.h for ESP32 #include <ESP8266WebServer.h> // Replace with WebServer.h for ESP32 #include <AutoConnect.h> ESP8266WebServer Server; // Replace with WebServer for ESP32 AutoConnect Portal (Server); void rootPage () { char content[] = \"Hello, world\" ; Server.send( 200 , \"text/plain\" , content); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); Server.on( \"/\" , rootPage); if (Portal.begin()) { Serial.println( \"WiFi connected: \" + WiFi.localIP().toString()); } } void loop () { Portal.handleClient(); } The above code can be applied to ESP8266. To apply to ESP32, replace ESP8266WebServer class with WebServer and include WiFi.h and WebServer.h of arduino-esp32 appropriately. Run at first \u00b6 After about 30 seconds, if the ESP8266 cannot connect to nearby Wi-Fi spot, you pull out your smartphone and open Wi-Fi settings from the Settings Apps. You can see the esp8266ap 1 in the list of \"CHOOSE A NETWORK...\" . Then tap the esp8266ap and enter password 12345678 , a something screen pops up automatically as shown below. This is the AutoConnect statistics screen. This screen displays the current status of the established connection, WiFi mode, IP address, free memory size, and etc. Also, the hamburger icon is the control menu of AutoConnect seems at the upper right. By tap the hamburger icon, the control menu appears as the below. Join to the new access point \u00b6 Here, tap \"Configure new AP\" to connect the new access point then the SSID configuration screen would be shown. Enter the SSID and Passphrase and tap apply to start connecting the access point. Connection establishment \u00b6 After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step. For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to \" Log in \" by upper right on the screen. Or, \" RESET \" can be selected. The ESP8266 resets and reboots. After that, immediately before the connection will be restored automatically with WIFI_STA mode. Run for usually \u00b6 The IP address of ESP8266 would be displayed on the serial monitor after connection restored. Please access its address from the browser. The \"Hello, world\" page will respond. It's the page that was handled by in the sketch with \" on \" function of ESP8266WebServer . window.onload = function() { Gifffer(); }; When applied to ESP32, SSID will appear as esp32ap . \u21a9","title":"Getting started"},{"location":"gettingstarted.html#lets-do-the-most-simple-sketch","text":"Open the Arduino IDE, write the following sketch and upload it. The feature of this sketch is that the SSID and Password are not coded. #include <ESP8266WiFi.h> // Replace with WiFi.h for ESP32 #include <ESP8266WebServer.h> // Replace with WebServer.h for ESP32 #include <AutoConnect.h> ESP8266WebServer Server; // Replace with WebServer for ESP32 AutoConnect Portal (Server); void rootPage () { char content[] = \"Hello, world\" ; Server.send( 200 , \"text/plain\" , content); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); Server.on( \"/\" , rootPage); if (Portal.begin()) { Serial.println( \"WiFi connected: \" + WiFi.localIP().toString()); } } void loop () { Portal.handleClient(); } The above code can be applied to ESP8266. To apply to ESP32, replace ESP8266WebServer class with WebServer and include WiFi.h and WebServer.h of arduino-esp32 appropriately.","title":"Let's do the most simple sketch"},{"location":"gettingstarted.html#run-at-first","text":"After about 30 seconds, if the ESP8266 cannot connect to nearby Wi-Fi spot, you pull out your smartphone and open Wi-Fi settings from the Settings Apps. You can see the esp8266ap 1 in the list of \"CHOOSE A NETWORK...\" . Then tap the esp8266ap and enter password 12345678 , a something screen pops up automatically as shown below. This is the AutoConnect statistics screen. This screen displays the current status of the established connection, WiFi mode, IP address, free memory size, and etc. Also, the hamburger icon is the control menu of AutoConnect seems at the upper right. By tap the hamburger icon, the control menu appears as the below.","title":" Run at first"},{"location":"gettingstarted.html#join-to-the-new-access-point","text":"Here, tap \"Configure new AP\" to connect the new access point then the SSID configuration screen would be shown. Enter the SSID and Passphrase and tap apply to start connecting the access point.","title":" Join to the new access point"},{"location":"gettingstarted.html#connection-establishment","text":"After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step. For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to \" Log in \" by upper right on the screen. Or, \" RESET \" can be selected. The ESP8266 resets and reboots. After that, immediately before the connection will be restored automatically with WIFI_STA mode.","title":" Connection establishment"},{"location":"gettingstarted.html#run-for-usually","text":"The IP address of ESP8266 would be displayed on the serial monitor after connection restored. Please access its address from the browser. The \"Hello, world\" page will respond. It's the page that was handled by in the sketch with \" on \" function of ESP8266WebServer . window.onload = function() { Gifffer(); }; When applied to ESP32, SSID will appear as esp32ap . \u21a9","title":" Run for usually"},{"location":"howtoembed.html","text":"Embed the AutoConnect to the sketch \u00b6 Here holds two case examples. Both examples perform the same function. Only how to incorporate the AutoConnect into the sketch differs. Also included in the sample folder, HandlePortal.ino also shows how to use the PageBuilder library for HTML assemblies. What does this example do? \u00b6 Uses the web interface to light the LED connected to the NodeMCU module D0 port (which could be referred to as BUILTIN_LED ), the following animation is it. Access to the ESP8266 module connected WiFi from the browser then the page contains the current value of the D0 port would be displayed. The page has the buttons to switch the port value. The LED blinks according to the value of the button that was clicked. This example is a typical sketch of manipulating ESP8266's GPIO via WLAN. Embed AutoConnect library into this sketch. There are few places to be changed. And you can use AutoConnect's captive portal function to establish a connection freely to other WiFi spots. Embed AutoConnect \u00b6 Pattern A. \u00b6 Bind to ESP8266WebServer, performs handleClient with handleRequest. In what situations should the handleRequest be used. It is something needs to be done immediately after the handle client. It is better to call only AutoConnect::handleClient whenever possible. Pattern B. \u00b6 Declare only AutoConnect, performs handleClient. Used with MQTT as a client application \u00b6 The effect of AutoConnect is not only for ESP8266/ESP32 as the web server. It has advantages for something WiFi client as well. For example, AutoConnect is also effective for publishing MQTT messages from various measurement points. Even if the SSID is different for each measurement point, it is not necessary to modify the sketch. This example tries to publish the WiFi signal strength of ESP8266 with MQTT. It uses the ThingSpeak for MQTT broker. ESP8266 publishes the RSSI value to the channel created on ThingSpeak as MQTT client . This example is well suited to demonstrate the usefulness of AutoConnect, as RSSI values are measured at each access point usually. Just adding a few lines of code makes it unnecessary to upload sketches with the different SSIDs rewrite for each access point. Advance procedures \u00b6 Arduino Client for MQTT - It's the PubSubClient , install it to Arduino IDE. If you have the latest version already, this step does not need. Create a channel on ThingSpeak. Get the Channel API Keys from ThingSpeak, put its keys to the sketch. The ThingSpeak is the open IoT platform. It is capable of sending data privately to the cloud and analyzing, visualizing its data. If you do not have an account of ThingSpeak, you need that account to proceed further. ThingSpeak has the free plan for the account which uses within the scope of this example. 1 You can sign up with the ThingSpeak sign-up page . Whether you should do sign-up or not. You are entrusted with the final judgment of account creation for ThingSpeak. Create an account at your own risk. Create a channel on ThingSpeak \u00b6 Sign in ThingSpeak. Select Channels to show the My Channels , then click New Channel . At the New Channel screen, enter each field as a below. And click Save Channel at the bottom of the screen to save. Name: ESP8266 Signal Strength Description: ESP8266 RSSI publish Field1: RSSI Get Channel ID and API Keys \u00b6 The channel successfully created, you can see the channel status screen as a below. Channel ID is displayed there. 2 Here, switch the channel status tab to API Keys . The API key required to publish the message is the Write API Key . The last key you need is the User API Key and can be confirmed it in the user profile. Pull down Account from the top menu, select My profile . Then you can see the ThingSpeak settings and the User API Key is displayed middle of this screen. The sketch, Publishes messages \u00b6 The complete code of the sketch is mqttRSSI.ino in the AutoConnect repository . Replace the following #define in a sketch with User API Key , Write API Key and Channel ID . After Keys updated, compile the sketch and upload it. #define MQTT_USER_KEY \"****************\" // Replace to User API Key. #define CHANNEL_ID \"******\" // Replace to Channel ID. #define CHANNEL_API_KEY_WR \"****************\" // Replace to the write API Key. Publish messages \u00b6 After upload and reboot complete, the message publishing will start via the access point now set. The message carries RSSI as the current WiFi signal strength. The signal strength variations in RSSI are displayed on ThingSpeak's Channel status screen. How embed to your sketches \u00b6 For the client sketches, the code required to connect to WiFi is the following four parts only. #include directive 3 Include AutoConnect.h header file behind the include of ESP8266WiFi.h . Declare AutoConnect The declaration of the AutoConnect variable is not accompanied by ESP8266WebServer. Invokes \"begin()\" Call AutoConnect::begin . If you need to assign a static IP address, executes AutoConnectConfig before that. Performs \"handleClent()\" in \"loop()\" Invokes AutoConnect::handleClient() at inside loop() to enable the AutoConnect menu. window.onload = function() { Gifffer(); }; As of March 21, 2018. \u21a9 '454951' in the example above, but your channel ID should be different. \u21a9 #include <ESP8266WebServer.h> does not necessary for uses only client. \u21a9","title":"How to embed"},{"location":"howtoembed.html#embed-the-autoconnect-to-the-sketch","text":"Here holds two case examples. Both examples perform the same function. Only how to incorporate the AutoConnect into the sketch differs. Also included in the sample folder, HandlePortal.ino also shows how to use the PageBuilder library for HTML assemblies.","title":"Embed the AutoConnect to the sketch"},{"location":"howtoembed.html#what-does-this-example-do","text":"Uses the web interface to light the LED connected to the NodeMCU module D0 port (which could be referred to as BUILTIN_LED ), the following animation is it. Access to the ESP8266 module connected WiFi from the browser then the page contains the current value of the D0 port would be displayed. The page has the buttons to switch the port value. The LED blinks according to the value of the button that was clicked. This example is a typical sketch of manipulating ESP8266's GPIO via WLAN. Embed AutoConnect library into this sketch. There are few places to be changed. And you can use AutoConnect's captive portal function to establish a connection freely to other WiFi spots.","title":"What does this example do?"},{"location":"howtoembed.html#embed-autoconnect","text":"","title":"Embed AutoConnect"},{"location":"howtoembed.html#pattern-a","text":"Bind to ESP8266WebServer, performs handleClient with handleRequest. In what situations should the handleRequest be used. It is something needs to be done immediately after the handle client. It is better to call only AutoConnect::handleClient whenever possible.","title":" Pattern A."},{"location":"howtoembed.html#pattern-b","text":"Declare only AutoConnect, performs handleClient.","title":" Pattern B."},{"location":"howtoembed.html#used-with-mqtt-as-a-client-application","text":"The effect of AutoConnect is not only for ESP8266/ESP32 as the web server. It has advantages for something WiFi client as well. For example, AutoConnect is also effective for publishing MQTT messages from various measurement points. Even if the SSID is different for each measurement point, it is not necessary to modify the sketch. This example tries to publish the WiFi signal strength of ESP8266 with MQTT. It uses the ThingSpeak for MQTT broker. ESP8266 publishes the RSSI value to the channel created on ThingSpeak as MQTT client . This example is well suited to demonstrate the usefulness of AutoConnect, as RSSI values are measured at each access point usually. Just adding a few lines of code makes it unnecessary to upload sketches with the different SSIDs rewrite for each access point.","title":"Used with MQTT as a client application"},{"location":"howtoembed.html#advance-procedures","text":"Arduino Client for MQTT - It's the PubSubClient , install it to Arduino IDE. If you have the latest version already, this step does not need. Create a channel on ThingSpeak. Get the Channel API Keys from ThingSpeak, put its keys to the sketch. The ThingSpeak is the open IoT platform. It is capable of sending data privately to the cloud and analyzing, visualizing its data. If you do not have an account of ThingSpeak, you need that account to proceed further. ThingSpeak has the free plan for the account which uses within the scope of this example. 1 You can sign up with the ThingSpeak sign-up page . Whether you should do sign-up or not. You are entrusted with the final judgment of account creation for ThingSpeak. Create an account at your own risk.","title":"Advance procedures"},{"location":"howtoembed.html#create-a-channel-on-thingspeak","text":"Sign in ThingSpeak. Select Channels to show the My Channels , then click New Channel . At the New Channel screen, enter each field as a below. And click Save Channel at the bottom of the screen to save. Name: ESP8266 Signal Strength Description: ESP8266 RSSI publish Field1: RSSI","title":"Create a channel on ThingSpeak"},{"location":"howtoembed.html#get-channel-id-and-api-keys","text":"The channel successfully created, you can see the channel status screen as a below. Channel ID is displayed there. 2 Here, switch the channel status tab to API Keys . The API key required to publish the message is the Write API Key . The last key you need is the User API Key and can be confirmed it in the user profile. Pull down Account from the top menu, select My profile . Then you can see the ThingSpeak settings and the User API Key is displayed middle of this screen.","title":"Get Channel ID and API Keys"},{"location":"howtoembed.html#the-sketch-publishes-messages","text":"The complete code of the sketch is mqttRSSI.ino in the AutoConnect repository . Replace the following #define in a sketch with User API Key , Write API Key and Channel ID . After Keys updated, compile the sketch and upload it. #define MQTT_USER_KEY \"****************\" // Replace to User API Key. #define CHANNEL_ID \"******\" // Replace to Channel ID. #define CHANNEL_API_KEY_WR \"****************\" // Replace to the write API Key.","title":"The sketch, Publishes messages"},{"location":"howtoembed.html#publish-messages","text":"After upload and reboot complete, the message publishing will start via the access point now set. The message carries RSSI as the current WiFi signal strength. The signal strength variations in RSSI are displayed on ThingSpeak's Channel status screen.","title":"Publish messages"},{"location":"howtoembed.html#how-embed-to-your-sketches","text":"For the client sketches, the code required to connect to WiFi is the following four parts only. #include directive 3 Include AutoConnect.h header file behind the include of ESP8266WiFi.h . Declare AutoConnect The declaration of the AutoConnect variable is not accompanied by ESP8266WebServer. Invokes \"begin()\" Call AutoConnect::begin . If you need to assign a static IP address, executes AutoConnectConfig before that. Performs \"handleClent()\" in \"loop()\" Invokes AutoConnect::handleClient() at inside loop() to enable the AutoConnect menu. window.onload = function() { Gifffer(); }; As of March 21, 2018. \u21a9 '454951' in the example above, but your channel ID should be different. \u21a9 #include <ESP8266WebServer.h> does not necessary for uses only client. \u21a9","title":"How embed to your sketches"},{"location":"license.html","text":"MIT License Copyright \u00a9 2018 Hieromon Ikasamo Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Acknowledgments The Luxbar is licensed under the MIT License. https://github.com/balzss/luxbar ArduinoJson is licensed under the MIT License. https://arduinojson.org/","title":"License"},{"location":"menu.html","text":"Luxbar The AutoConnect menu is developed using the LuxBar which is licensed under the MIT License. See the License . Where the from \u00b6 The AutoConnect menu appears when you access the AutoConnect root path . It is assigned \" /_ac \" located on the local IP address of ESP8266/ESP32 module by default. This location can be changed in the sketch. The following screen will appear at access to http://{localIP}/_ac as the root path. This is the statistics of the current WiFi connection. You can access the menu from the here, to invoke it tap at right on top. (e.g. http://192.168.244.1/_ac for SoftAP mode.) What's the local IP? A local IP means Local IP at connection established or SoftAP's IP. Right on top \u00b6 Currently, AutoConnect supports four menus. Undermost menu as \"HOME\" returns to the home path of its sketch. Configure new AP : Configure SSID and Password for new access point. Open SSIDs : Opens the past SSID which has been established connection from EEPROM. Disconnect : Disconnects current connection. Reset... : Rest the ESP8266/ESP32 module. HOME : Return to user home page. Configure new AP \u00b6 Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The is indicated for the SSID that needs a security key. \" Hidden: \" means the number of hidden SSIDs discovered. Enter SSID and Passphrase and tap \" apply \" to starts WiFi connection. Open SSIDs \u00b6 Once it was established WiFi connection, its SSID and password will be saved in EEPROM of ESP8266/ESP32 automatically. The Open SSIDs menu reads the saved SSID credentials from the EEPROM. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it. Disconnect \u00b6 Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using API in the sketch. After tapping \"Disconnect\", you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting the WLAN. Reset... \u00b6 Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complete, the ESP8266/ESP32 module begins establishing the previous connection with WIFI_STA mode, and esp8266ap or esp32ap of an access point will disappear from WLAN. Not every ESP8266 module will be rebooted normally The Reset menu is using the ESP.reset() function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the state of GPIO0 is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also FAQ . Custom menu items \u00b6 The menu items of the custom Web page line up at the below in the AutoConnect menu if the custom Web pages are joined. Details for Custom Web pages in AutoConnect menu . HOME \u00b6 A HOME item located at the bottom of the menu list is a link to the home path. The URI as the home path is / by default, and it is defined by AUTOCONNECT_HOMEURI with AutoConnectDefs.h file. #define AUTOCONNECT_HOMEURI \"/\" You can change the HOME path using the AutoConnect API. The AutoConnect::home function sets the URI as a link of the HOME item of the AutoConnect menu. Extend AutoConnect menu with your sketches \u00b6 The AutoConnect menu can contain custom items of your own sketch. It works for the custom Web pages by AutoConnectAux , addition to the request handler for ESP8266WebServer class that is registered by the ESP8266WebServer::on function or WebServer::on for ESP32. That is, you can make it as a menu item to invoke a legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as FSBrowser to the AutoConnect menu item. It adds Edit and List items with little modification of the legacy sketch code. The procedure to extend the AutoConnect menu is described in the Advanced usage section .","title":"AutoConnect menu"},{"location":"menu.html#where-the-from","text":"The AutoConnect menu appears when you access the AutoConnect root path . It is assigned \" /_ac \" located on the local IP address of ESP8266/ESP32 module by default. This location can be changed in the sketch. The following screen will appear at access to http://{localIP}/_ac as the root path. This is the statistics of the current WiFi connection. You can access the menu from the here, to invoke it tap at right on top. (e.g. http://192.168.244.1/_ac for SoftAP mode.) What's the local IP? A local IP means Local IP at connection established or SoftAP's IP.","title":" Where the from"},{"location":"menu.html#right-on-top","text":"Currently, AutoConnect supports four menus. Undermost menu as \"HOME\" returns to the home path of its sketch. Configure new AP : Configure SSID and Password for new access point. Open SSIDs : Opens the past SSID which has been established connection from EEPROM. Disconnect : Disconnects current connection. Reset... : Rest the ESP8266/ESP32 module. HOME : Return to user home page.","title":" Right on top"},{"location":"menu.html#configure-new-ap","text":"Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The is indicated for the SSID that needs a security key. \" Hidden: \" means the number of hidden SSIDs discovered. Enter SSID and Passphrase and tap \" apply \" to starts WiFi connection.","title":" Configure new AP"},{"location":"menu.html#open-ssids","text":"Once it was established WiFi connection, its SSID and password will be saved in EEPROM of ESP8266/ESP32 automatically. The Open SSIDs menu reads the saved SSID credentials from the EEPROM. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it.","title":" Open SSIDs"},{"location":"menu.html#disconnect","text":"Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using API in the sketch. After tapping \"Disconnect\", you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting the WLAN.","title":" Disconnect"},{"location":"menu.html#reset","text":"Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complete, the ESP8266/ESP32 module begins establishing the previous connection with WIFI_STA mode, and esp8266ap or esp32ap of an access point will disappear from WLAN. Not every ESP8266 module will be rebooted normally The Reset menu is using the ESP.reset() function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the state of GPIO0 is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also FAQ .","title":" Reset..."},{"location":"menu.html#custom-menu-items","text":"The menu items of the custom Web page line up at the below in the AutoConnect menu if the custom Web pages are joined. Details for Custom Web pages in AutoConnect menu .","title":" Custom menu items"},{"location":"menu.html#home","text":"A HOME item located at the bottom of the menu list is a link to the home path. The URI as the home path is / by default, and it is defined by AUTOCONNECT_HOMEURI with AutoConnectDefs.h file. #define AUTOCONNECT_HOMEURI \"/\" You can change the HOME path using the AutoConnect API. The AutoConnect::home function sets the URI as a link of the HOME item of the AutoConnect menu.","title":" HOME"},{"location":"menu.html#extend-autoconnect-menu-with-your-sketches","text":"The AutoConnect menu can contain custom items of your own sketch. It works for the custom Web pages by AutoConnectAux , addition to the request handler for ESP8266WebServer class that is registered by the ESP8266WebServer::on function or WebServer::on for ESP32. That is, you can make it as a menu item to invoke a legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as FSBrowser to the AutoConnect menu item. It adds Edit and List items with little modification of the legacy sketch code. The procedure to extend the AutoConnect menu is described in the Advanced usage section .","title":" Extend AutoConnect menu with your sketches"},{"location":"menuize.html","text":"What menus can be made using AutoConnect \u00b6 AutoConnect generates a menu dynamically depending on the instantiated AutoConnectAux at the sketch executing time. Usually, it is a collection of AutoConnectElement . In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. That is, you can easily make the built-in menu with legacy sketches of yours. Basic mechanism of menu generation \u00b6 The sketch can display the AutoConnect menu by following three patterns depending on AutoConnect-API usage. \u2002 Basic menu It is the most basic menu for only connecting WiFi. Sketch can automatically display this menu with the basic call sequence of the AutoConnect API which invokes AutoConnect::begin and AutoConnect::handleClient . \u2002 Extra menu with custom Web pages which is consisted by AutoConnectElements It is an extended menu that appears when the sketch consists of the custom Web pages with AutoConnectAux and AutoConnectElements. Refer to Custom Web pages section . \u2002 Extra menu which contains legacy pages It is for the legacy sketches using the on handler of ESP8266WebServer/WebServer(for ESP32) class natively and looks the same as the extra menu as above. The mechanism to generate the AutoConnect menu is simple. It will insert the item as <li> tag generated from the title and uri member variable of the AutoConnectAux object to the menu list of AutoConnect's built-in HTML. Therefore, the legacy sketches can invoke the web pages from the AutoConnect menu with just declaration the title and URI to AutoConnectAux. Place the item for the legacy sketches on the menu \u00b6 To implement this with your sketch, use only the AutoConnectAux constructed with the title and URI of that page. AutoConnectElements is not required. The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for Edit and List . The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows. Add AutoConnect declaration. Add the menu item named \" Edit \" and \" List \" of AutoConnectAux as each page. Replace the instance of ESP8266WebServer to AutoConnect. Change the menu title to FSBrowser using AutoConnectConfig::title . Join the legacy pages to AutoConnect declared at step #1 using AutoConnect::join . Joining multiple at one time with std::vector 's' list initialization . According to the basic procedure of AutoConnect. Establish a connection with AutoConnect::begin and perform AutoConnect::handleClient in loop() . \u2002 Modification for FSBrowser (part of sketch code) window.onload = function() { Gifffer(); };","title":"Constucting menu"},{"location":"menuize.html#what-menus-can-be-made-using-autoconnect","text":"AutoConnect generates a menu dynamically depending on the instantiated AutoConnectAux at the sketch executing time. Usually, it is a collection of AutoConnectElement . In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. That is, you can easily make the built-in menu with legacy sketches of yours.","title":"What menus can be made using AutoConnect"},{"location":"menuize.html#basic-mechanism-of-menu-generation","text":"The sketch can display the AutoConnect menu by following three patterns depending on AutoConnect-API usage. \u2002 Basic menu It is the most basic menu for only connecting WiFi. Sketch can automatically display this menu with the basic call sequence of the AutoConnect API which invokes AutoConnect::begin and AutoConnect::handleClient . \u2002 Extra menu with custom Web pages which is consisted by AutoConnectElements It is an extended menu that appears when the sketch consists of the custom Web pages with AutoConnectAux and AutoConnectElements. Refer to Custom Web pages section . \u2002 Extra menu which contains legacy pages It is for the legacy sketches using the on handler of ESP8266WebServer/WebServer(for ESP32) class natively and looks the same as the extra menu as above. The mechanism to generate the AutoConnect menu is simple. It will insert the item as <li> tag generated from the title and uri member variable of the AutoConnectAux object to the menu list of AutoConnect's built-in HTML. Therefore, the legacy sketches can invoke the web pages from the AutoConnect menu with just declaration the title and URI to AutoConnectAux.","title":"Basic mechanism of menu generation"},{"location":"menuize.html#place-the-item-for-the-legacy-sketches-on-the-menu","text":"To implement this with your sketch, use only the AutoConnectAux constructed with the title and URI of that page. AutoConnectElements is not required. The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for Edit and List . The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows. Add AutoConnect declaration. Add the menu item named \" Edit \" and \" List \" of AutoConnectAux as each page. Replace the instance of ESP8266WebServer to AutoConnect. Change the menu title to FSBrowser using AutoConnectConfig::title . Join the legacy pages to AutoConnect declared at step #1 using AutoConnect::join . Joining multiple at one time with std::vector 's' list initialization . According to the basic procedure of AutoConnect. Establish a connection with AutoConnect::begin and perform AutoConnect::handleClient in loop() . \u2002 Modification for FSBrowser (part of sketch code) window.onload = function() { Gifffer(); };","title":"Place the item for the legacy sketches on the menu"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"AutoConnect for ESP8266/ESP32 \u00b6 An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface. Overview \u00b6 To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class for ESP8266 or WebServer class for ESP32. Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password. No need pre-coded SSID & password \u00b6 It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime. Simple usage \u00b6 AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected. By using the AutoConnect menu , to manage the connections convenient. Store the established connection \u00b6 The connection authentication data as credentials are saved automatically in EEPROM of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu . Easy to embed in \u00b6 AutoConnect can be placed easily in your sketch. It's \" begin \" and \" handleClient \" only. Lives with your sketches \u00b6 The sketches which provide the web page using ESP8266WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object, or itself can assign it. This effect also applies to ESP32. The corresponding class for ESP32 will be the WebServer. Easy to add the custom Web screens ENHANCED w/v0.9.7 \u00b6 You can easily add your owned web screens that can consist of representative HTML elements and invoke them from the menu. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. Installation \u00b6 Requirements \u00b6 Supported hardware \u00b6 Generic ESP8266 modules (applying the ESP8266 Community's Arduino core) Adafruit HUZZAH ESP8266 (ESP-12) ESP-WROOM-02 Heltec WiFi Kit 8 NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E) Olimex MOD-WIFI-ESP8266 SparkFun Thing SweetPea ESP-210 ESP32Dev Board (applying the Espressif's arduino-esp32 core) SparkFun ESP32 Thing WEMOS LOLIN D32 Ai-Thinker NodeMCU-32S Heltec WiFi Kit 32 M5Stack And other ESP8266/ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE. About flash size on the module The AutoConnect sketch size is relatively large. Large flash capacity is necessary. 512Kbyte (4Mbits) flash inclusion module such as ESP-01 is not recommended. Required libraries \u00b6 AutoConnect requires the following environment and libraries. Arduino IDE The current upstream at the 1.8 level or later is needed. Please install from the official Arduino IDE download page . This step is not required if you already have a modern version. ESP8266 Arduino core AutoConnect targets sketches made on the assumption of ESP8266 Community's Arduino core . The latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. Package URL is http://arduino.esp8266.com/stable/package_esp8266com_index.json ESP32 Arduino core Also, to apply AutoConnect to ESP32, the arduino-esp32 core provided by Espressif is needed. The latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. You can add multiple URLs into Additional Board Manager URLs field, separating them with commas. Package URL is https://dl.espressif.com/dl/package_esp32_index.json for ESP32. Additional library (Required) The PageBuilder library to build HTML for ESP8266WebServer is needed. To install the PageBuilder library into your Arduino IDE, you can use the Library Manager . Select the board of ESP8266 series in the Arduino IDE, open the library manager and search keyword ' PageBuilder ' with the topic ' Communication ', then you can see the PageBuilder . The latest version is required 1.3.2 later. 1 Additional library (Optional) By adding the ArduinoJson library, AutoConnect will be able to handle the custom Web pages described with JSON. With AutoConnect v0.9.7 you can insert user-owned screens that can consist of representative HTML elements as styled TEXT, INPUT, BUTTON, CHECKBOX, SELECT, SUBMIT and invoke them from the AutoConnect menu. These HTML elements can be added by sketches using the AutoConnect API. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. ArduinoJson version 5 is required to use this feature. 2 AutoConnect supports ArduinoJson version 5 only And ArduinoJson version 6 is still in beta. The Arduino Library Manager installs the ArduinoJson version 6 by default. Open the Arduino Library Manager and make sure that ArduinoJson version 5 is installed. Install the AutoConnect \u00b6 Clone or download from the AutoConnect GitHub repository . When you select Download, you can import it to Arduino IDE immediately. After downloaded, the AutoConnect-master.zip file will be saved in your download folder. Then in the Arduino IDE, navigate to \"Sketch > Include Library\" . At the top of the drop down list, select the option to \"Add .ZIP Library...\" . Details for Arduino official page . Supported by Library manager. AutoConnect was added to the Arduino IDE library manager. It can be used with the PlatformIO library also. window.onload = function() { Gifffer(); }; Since AutoConnect v0.9.7, PageBuilder v1.3.2 later is required. \u21a9 Using the AutoConnect API natively allows you to sketch custom Web pages without JSON. \u21a9","title":"Overview"},{"location":"index.html#autoconnect-for-esp8266esp32","text":"An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface.","title":"AutoConnect for ESP8266/ESP32"},{"location":"index.html#overview","text":"To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class for ESP8266 or WebServer class for ESP32. Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password.","title":"Overview"},{"location":"index.html#no-need-pre-coded-ssid-password","text":"It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime.","title":" No need pre-coded SSID &amp; password"},{"location":"index.html#simple-usage","text":"AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected. By using the AutoConnect menu , to manage the connections convenient.","title":" Simple usage"},{"location":"index.html#store-the-established-connection","text":"The connection authentication data as credentials are saved automatically in EEPROM of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu .","title":" Store the established connection"},{"location":"index.html#easy-to-embed-in","text":"AutoConnect can be placed easily in your sketch. It's \" begin \" and \" handleClient \" only.","title":" Easy to embed in"},{"location":"index.html#lives-with-your-sketches","text":"The sketches which provide the web page using ESP8266WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object, or itself can assign it. This effect also applies to ESP32. The corresponding class for ESP32 will be the WebServer.","title":" Lives with your sketches"},{"location":"index.html#easy-to-add-the-custom-web-screens-enhanced-wv097","text":"You can easily add your owned web screens that can consist of representative HTML elements and invoke them from the menu. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD.","title":" Easy to add the custom Web screens ENHANCED w/v0.9.7"},{"location":"index.html#installation","text":"","title":"Installation"},{"location":"index.html#requirements","text":"","title":"Requirements"},{"location":"index.html#supported-hardware","text":"Generic ESP8266 modules (applying the ESP8266 Community's Arduino core) Adafruit HUZZAH ESP8266 (ESP-12) ESP-WROOM-02 Heltec WiFi Kit 8 NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E) Olimex MOD-WIFI-ESP8266 SparkFun Thing SweetPea ESP-210 ESP32Dev Board (applying the Espressif's arduino-esp32 core) SparkFun ESP32 Thing WEMOS LOLIN D32 Ai-Thinker NodeMCU-32S Heltec WiFi Kit 32 M5Stack And other ESP8266/ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE. About flash size on the module The AutoConnect sketch size is relatively large. Large flash capacity is necessary. 512Kbyte (4Mbits) flash inclusion module such as ESP-01 is not recommended.","title":"Supported hardware"},{"location":"index.html#required-libraries","text":"AutoConnect requires the following environment and libraries. Arduino IDE The current upstream at the 1.8 level or later is needed. Please install from the official Arduino IDE download page . This step is not required if you already have a modern version. ESP8266 Arduino core AutoConnect targets sketches made on the assumption of ESP8266 Community's Arduino core . The latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. Package URL is http://arduino.esp8266.com/stable/package_esp8266com_index.json ESP32 Arduino core Also, to apply AutoConnect to ESP32, the arduino-esp32 core provided by Espressif is needed. The latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. You can add multiple URLs into Additional Board Manager URLs field, separating them with commas. Package URL is https://dl.espressif.com/dl/package_esp32_index.json for ESP32. Additional library (Required) The PageBuilder library to build HTML for ESP8266WebServer is needed. To install the PageBuilder library into your Arduino IDE, you can use the Library Manager . Select the board of ESP8266 series in the Arduino IDE, open the library manager and search keyword ' PageBuilder ' with the topic ' Communication ', then you can see the PageBuilder . The latest version is required 1.3.2 later. 1 Additional library (Optional) By adding the ArduinoJson library, AutoConnect will be able to handle the custom Web pages described with JSON. With AutoConnect v0.9.7 you can insert user-owned screens that can consist of representative HTML elements as styled TEXT, INPUT, BUTTON, CHECKBOX, SELECT, SUBMIT and invoke them from the AutoConnect menu. These HTML elements can be added by sketches using the AutoConnect API. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. ArduinoJson version 5 is required to use this feature. 2 AutoConnect supports ArduinoJson version 5 only And ArduinoJson version 6 is still in beta. The Arduino Library Manager installs the ArduinoJson version 6 by default. Open the Arduino Library Manager and make sure that ArduinoJson version 5 is installed.","title":"Required libraries"},{"location":"index.html#install-the-autoconnect","text":"Clone or download from the AutoConnect GitHub repository . When you select Download, you can import it to Arduino IDE immediately. After downloaded, the AutoConnect-master.zip file will be saved in your download folder. Then in the Arduino IDE, navigate to \"Sketch > Include Library\" . At the top of the drop down list, select the option to \"Add .ZIP Library...\" . Details for Arduino official page . Supported by Library manager. AutoConnect was added to the Arduino IDE library manager. It can be used with the PlatformIO library also. window.onload = function() { Gifffer(); }; Since AutoConnect v0.9.7, PageBuilder v1.3.2 later is required. \u21a9 Using the AutoConnect API natively allows you to sketch custom Web pages without JSON. \u21a9","title":"Install the AutoConnect"},{"location":"acelements.html","text":"The elements for the custom Web pages \u00b6 Representative HTML elements for making the custom Web page are provided as AutoConnectElements. AutoConnectButton : Labeled action button AutoConnectCheckbox : Labeled checkbox AutoConnectElement : General tag AutoConnectInput : Labeled text input box AutoConnectRadio : Labeled radio button AutoConnectSelect : Selection list AutoConnectSubmit : Submit button AutoConnectText : Style attributed text Layout on a custom Web page \u00b6 You can specify the direction to arrange the radio buttons as AutoConnectRadio vertically or horizontally. Other elements are arranged vertically in the order of addition to AutoConnectAux. This basic layout depends on the CSS of the AutoConnect menu so it can not be changed drastically. Form and AutoConnectElements \u00b6 All AutoConnectElements placed on a custom Web page are included in one form. Its form is fixed and created by AutoConnect. The form's value (usually the text or checkbox you entered) is sent by AutoConnectSubmit using the POST method. name and value of each AutoConnectElement which own form-data are reflected in the query string when the custom Web page was sent. You can retrieve the value in the sketch as the parameter's value of the query string with ESP8266WebServer::arg function or PageArgument class of AutoConnect::on handler when the form is submitted. AutoConnectElement - A basic class of elements \u00b6 AutoConnectElement is a base class for other element classes and has common attributes for all elements. It can also be used as a variant of each element. The following items are attributes that AutoConnectElement has and are common to other elements. Sample AutoConnectElement element(\"element\", \"<hr>\"); On the page: Constructor \u00b6 AutoConnectElement( const char * name, const char * value) name \u00b6 Each element has a name. The name is the String data type. You can identify each element by the name to access it with sketches. value \u00b6 The value is the string which is a source to generate an HTML code. Characteristics of Value vary depending on the element. The value of AutoConnectElement is native HTML code. A string of value is output as HTML as it is. type \u00b6 The type indicates the type of the element and represented as the ACElement_t enumeration type in the sketch. Since AutoConnectElement also acts as a variant of other elements, it can be applied to handle elements collectively. At that time, the type can be referred to by the typeOf() function. The following example changes the font color of all AutoConnectText elements of a custom Web page to gray. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.typeOf() == AC_Text) { AutoConnectText & text = reinterpret_cast < AutoConnectText &> (elm); text.style = \"color:gray;\" ; } } The enumerators for ACElement_t are as follows: AutoConnectButton: AC_Button AutoConnectCheckbox: AC_Checkbox AutoConnectElement: AC_Element AutoConnectInput: AC_Input AutoConnectRadio: AC_Radio AutoConnectSelect: AC_Select AutoConnectSubmit: AC_Submit AutoConnectText: AC_Text Uninitialized element: AC_Unknown Furthermore, to convert an entity that is not an AutoConnectElement to its native type, you must re-interpret that type with c++. AutoConnectButton \u00b6 AutoConnectButton generates an HTML < button type = \"button\" > tag and locates a clickable button to a custom Web page. Currently AutoConnectButton corresponds only to name, value, an onclick attribute of HTML button tag. An onclick attribute is generated from an action member variable of the AutoConnectButton, which is mostly used with a JavaScript to activate a script. Sample AutoConnectButton button(\"button\", \"OK\", \"myFunction()\"); On the page: Constructor \u00b6 AutoConnectButton( const char * name, const char * value, const String & action) name \u00b6 It is the name of the AutoConnectButton element and matches the name attribute of the button tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a value of the value attribute of an HTML button tag. action \u00b6 action is String data type and is an onclick attribute fire on a mouse click on the element. It is mostly used with a JavaScript to activate a script. 1 For example, the following code defines a custom Web page that copies a content of Text1 to Text2 by clicking Button . const char * scCopyText = R\"( <script> function CopyText() { document.getElementById(\"Text2\").value = document.getElementById(\"Text1\").value; } </script> )\" ; ACInput(Text1, \"Text1\" ); ACInput(Text2, \"Text2\" ); ACButton(Button, \"COPY\" , \"CopyText()\" ); ACElement(TextCopy, scCopyText); AutoConnectCheckbox \u00b6 AutoConnectCheckbox generates an HTML < input type = \"checkbox\" > tag and a < label > tag. It places horizontally on a custom Web page by default. Sample AutoConnectCheckbox checkbox(\"checkbox\", \"uniqueapid\", \"Use APID unique\", false); On the page: Constructor \u00b6 AutoConnectCheckbox( const char * name, const char * value, const char * label, const bool checked) name \u00b6 It is the name of the AutoConnectCheckbox element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a value of the value attribute of an HTML < input type = \"checkbox\" > tag. label \u00b6 A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <label> tag with an id attribute. The checkbox and the label are connected by the id attribute. Only will be displayed if a label is not specified. checked \u00b6 A checked is a Boolean value and indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent. AutoConnectInput \u00b6 AutoConnectInput generates an HTML < input type = \"text\" > tag and a < label > tag. It can also have a placeholder. The value of the input box is passed to the destination in the query string and can be retrieved programmatically. You can also update from the sketches. Sample AutoConnectInput input(\"input\", \"\", \"Server\", \"MQTT broker server\"); On the page: Constructor \u00b6 AutoConnectInput( const char * name, const char * value, const char * label, const char * pattern, const char * placeholder) name \u00b6 It is the name of the AutoConnectInput element and matches the name attribute, the id attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a string value of the value attribute of an HTML < input type = \"text\" > tag. The text entered from the custom Web page will be grouped in the query string of the form submission and the string set before accessing the page will be displayed as the initial value. label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. pattern \u00b6 A pattern specifies a regular expression that the AutoConnectInput element's value is checked against on form submission. If it is invalid, the background color will change, but it will be sent even if the data format does not match. The password that must contain 8 or more characters that are of at least one number, and one uppercase and lowercase letter: (?=.*\\d)(?=.*[a-z])(?=.*[A-Z]).{8,} Email address as characters@characters.domain : [a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,}$ IP address Host name of the internet Date (MM-DD-YYYY) Twitter account: ^@?(\\w){1,15}$ placeholder \u00b6 A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. AutoConnectRadio \u00b6 AutoConnectRadio generates few HTML < input type = \"radio\" > tags as grouped and the same number of < label > tags. AutoConnectRadio can keep the value of a radio button as a collection. The grouped values will be placed in the custom Web page to select only one exclusively. Sample AutoConnectRadio radio(\"radio\", { \"30 sec.\", \"60 sec.\", \"180 sec.\" }, \"Update period\", AC_Vertical, 1); On the page: Constructor \u00b6 AutoConnectRadio( const char * name, std :: vector < String > const & values, const char * label, const ACArrange_t order, const uint8_t checked) name \u00b6 It is the name of the AutoConnectRadio element and matches the name attribute of the input tags. It also becomes the parameter name of the query string when submitted. values \u00b6 A values is an array of String type for the radio button options which as actually std::vector . It is an initialization list can be used. The input tags will be generated from each entry in the values, the amount of which is the same as the number of items in values . label \u00b6 A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Specification of a label will generate an HTML < label > tag with an id attribute. The radio buttons and the label are connected by the id attribute. order \u00b6 A order specifies the direction to arrange the radio buttons. It is a value of type ACArrange_t and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. A label will place in the left or the top according to the order . checked \u00b6 A checked specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. AutoConnectSelect \u00b6 AutoConnectSelect generates an HTML < select > tag (drop-down list) and few < option > tags. Sample AutoConnectSelect select(\"select\", { String(\"Europe/London\"), String(\"Europe/Berlin\"), String(\"Europe/Helsinki\"), String(\"Europe/Moscow\"), String(\"Asia/Dubai\") }, \"Select TZ name\"); On the page: Constructor \u00b6 AutoConnectSelect( const char * name, std :: vector < String > const & options, const char * label) name \u00b6 It is the name of the AutoConnectSelect element and matches the name attribute of the select tags. options \u00b6 An options is an array of String type for the options which as actually std::vector for an HTML < option > tag. It is an initialization list can be used. The option tags will be generated from each entry in the options, the amount of which is the same as the number of items in an options . label \u00b6 A label is an optional string. A label is always arranged on the left side of the drop-down list. Specification of a label will generate an HTML < label > tag with an id attribute. The select tag and the label are connected by the id attribute. AutoConnectSubmit \u00b6 AutoConnectSubmit generates an HTML < input type = \"button\" > tag attached onclick attribute. The native code of the onclick attribute is the submission of the form with the POST method. Sample AutoConnectSubmit submit(\"submit\", \"Save\", \"/mqtt_save\"); On the page: Constructor \u00b6 AutoConnectSubmit( const char * name, const char * value, const char * uri) name \u00b6 It is the name of the AutoConnectSubmit element and matches the name attribute of the input tag. value \u00b6 It becomes a string of the value attribute of an HTML < input type = \"button\" > tag. The value will be displayed as a label of the button. uri \u00b6 A uri specifies the URI to send form data when the button declared by AutoConnectSubmit is clicked. The query string of the form data sent with AutoConnectSubmit contains the URI of the page. Its parameter name is _acuri . In Sketch, you can know the called URI by referring to the _acuri parameter with the destination page handler. The actual query string is as follows: _acuri= CALLER_URI AutoConnectText \u00b6 AutoConnectText generates an HTML < div > tag. A style attribute will be attached if a style parameter is passed. Sample AutoConnectText text(\"text\", \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\", \"font-family:serif;color:#4682b4;\"); On the page: Constructor \u00b6 AutoConnectText( const char * name, const char * value, const char * style) name \u00b6 A name does not exist in the generated HTML. It provides only a means of accessing elements with the sketches. value \u00b6 It becomes content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style \u00b6 A style specifies the qualification style to give to the content and can use the style attribute format as it is. How to coding for the elements \u00b6 Declaration for the elements in Sketches \u00b6 Variables of each AutoConnetElement can be declared with macros. By using the macros, you can treat element name that is String type as variable in sketches. 2 ACElement ( name [ , value ] ) ACButton ( name [ , value ] [ , action ] ) ACCheckbox ( name [ , value ] [ , label ] [ , true | false ] ) ACInput ( name [ , value ] [ , label ] [ , placeholder ] ) ACRadio ( name [ , values ] [ , label ] [ , AC_Horizontal | AC_Vertical ] [ , checked ] ) ACSelect ( name [ , options ] [ , label ] ) ACSubmit ( name [ , value ] [ , uri ] ) ACText ( name [ , value ] [ , style ] ) Declaration macro usage For example, AutoConnectText can be declared using macros. AutoConnectText caption( \"caption\" , \"hello, world\" , \"color:blue;\" ) equals by using ACText macro. ACText(caption, \"hello, world\" , \"color:blue;\" ) Variant for AutoConnectElements \u00b6 Some AutoConnectAux APIs specify AutoConnectElements as an argument. There are also functions that return a pointer to AutoConnectElements. AutoConnectElement behaves as a variant type of each element class to make these interfaces a single. Use reinterpret_cast to cast from a variant pointer to an Actual type pointer of AutoConnectElements. AutoConnectAux aux; ACText(Text1, \"hello, world\" ); aux.add(Text1); AutoConnectText * text_p = reinterpret_cast < AutoConnectText > (aux.getElement( \"Text1\" )); AutoConnectText & text = aux.getElement < AutoConnectText > ( \"Text1\" ); JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9 The square brackets in the syntax are optional parameters, the stroke is a selection parameter, the bold fonts are literal. \u21a9","title":"AutoConnectElements"},{"location":"acelements.html#the-elements-for-the-custom-web-pages","text":"Representative HTML elements for making the custom Web page are provided as AutoConnectElements. AutoConnectButton : Labeled action button AutoConnectCheckbox : Labeled checkbox AutoConnectElement : General tag AutoConnectInput : Labeled text input box AutoConnectRadio : Labeled radio button AutoConnectSelect : Selection list AutoConnectSubmit : Submit button AutoConnectText : Style attributed text","title":"The elements for the custom Web pages"},{"location":"acelements.html#layout-on-a-custom-web-page","text":"You can specify the direction to arrange the radio buttons as AutoConnectRadio vertically or horizontally. Other elements are arranged vertically in the order of addition to AutoConnectAux. This basic layout depends on the CSS of the AutoConnect menu so it can not be changed drastically.","title":"Layout on a custom Web page"},{"location":"acelements.html#form-and-autoconnectelements","text":"All AutoConnectElements placed on a custom Web page are included in one form. Its form is fixed and created by AutoConnect. The form's value (usually the text or checkbox you entered) is sent by AutoConnectSubmit using the POST method. name and value of each AutoConnectElement which own form-data are reflected in the query string when the custom Web page was sent. You can retrieve the value in the sketch as the parameter's value of the query string with ESP8266WebServer::arg function or PageArgument class of AutoConnect::on handler when the form is submitted.","title":"Form and AutoConnectElements"},{"location":"acelements.html#autoconnectelement-a-basic-class-of-elements","text":"AutoConnectElement is a base class for other element classes and has common attributes for all elements. It can also be used as a variant of each element. The following items are attributes that AutoConnectElement has and are common to other elements. Sample AutoConnectElement element(\"element\", \"<hr>\"); On the page:","title":"AutoConnectElement - A basic class of elements"},{"location":"acelements.html#constructor","text":"AutoConnectElement( const char * name, const char * value)","title":" Constructor"},{"location":"acelements.html#name","text":"Each element has a name. The name is the String data type. You can identify each element by the name to access it with sketches.","title":" name"},{"location":"acelements.html#value","text":"The value is the string which is a source to generate an HTML code. Characteristics of Value vary depending on the element. The value of AutoConnectElement is native HTML code. A string of value is output as HTML as it is.","title":" value"},{"location":"acelements.html#type","text":"The type indicates the type of the element and represented as the ACElement_t enumeration type in the sketch. Since AutoConnectElement also acts as a variant of other elements, it can be applied to handle elements collectively. At that time, the type can be referred to by the typeOf() function. The following example changes the font color of all AutoConnectText elements of a custom Web page to gray. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.typeOf() == AC_Text) { AutoConnectText & text = reinterpret_cast < AutoConnectText &> (elm); text.style = \"color:gray;\" ; } } The enumerators for ACElement_t are as follows: AutoConnectButton: AC_Button AutoConnectCheckbox: AC_Checkbox AutoConnectElement: AC_Element AutoConnectInput: AC_Input AutoConnectRadio: AC_Radio AutoConnectSelect: AC_Select AutoConnectSubmit: AC_Submit AutoConnectText: AC_Text Uninitialized element: AC_Unknown Furthermore, to convert an entity that is not an AutoConnectElement to its native type, you must re-interpret that type with c++.","title":" type"},{"location":"acelements.html#autoconnectbutton","text":"AutoConnectButton generates an HTML < button type = \"button\" > tag and locates a clickable button to a custom Web page. Currently AutoConnectButton corresponds only to name, value, an onclick attribute of HTML button tag. An onclick attribute is generated from an action member variable of the AutoConnectButton, which is mostly used with a JavaScript to activate a script. Sample AutoConnectButton button(\"button\", \"OK\", \"myFunction()\"); On the page:","title":"AutoConnectButton"},{"location":"acelements.html#constructor_1","text":"AutoConnectButton( const char * name, const char * value, const String & action)","title":" Constructor"},{"location":"acelements.html#name_1","text":"It is the name of the AutoConnectButton element and matches the name attribute of the button tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_1","text":"It becomes a value of the value attribute of an HTML button tag.","title":" value"},{"location":"acelements.html#action","text":"action is String data type and is an onclick attribute fire on a mouse click on the element. It is mostly used with a JavaScript to activate a script. 1 For example, the following code defines a custom Web page that copies a content of Text1 to Text2 by clicking Button . const char * scCopyText = R\"( <script> function CopyText() { document.getElementById(\"Text2\").value = document.getElementById(\"Text1\").value; } </script> )\" ; ACInput(Text1, \"Text1\" ); ACInput(Text2, \"Text2\" ); ACButton(Button, \"COPY\" , \"CopyText()\" ); ACElement(TextCopy, scCopyText);","title":" action"},{"location":"acelements.html#autoconnectcheckbox","text":"AutoConnectCheckbox generates an HTML < input type = \"checkbox\" > tag and a < label > tag. It places horizontally on a custom Web page by default. Sample AutoConnectCheckbox checkbox(\"checkbox\", \"uniqueapid\", \"Use APID unique\", false); On the page:","title":"AutoConnectCheckbox"},{"location":"acelements.html#constructor_2","text":"AutoConnectCheckbox( const char * name, const char * value, const char * label, const bool checked)","title":" Constructor"},{"location":"acelements.html#name_2","text":"It is the name of the AutoConnectCheckbox element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_2","text":"It becomes a value of the value attribute of an HTML < input type = \"checkbox\" > tag.","title":" value"},{"location":"acelements.html#label","text":"A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <label> tag with an id attribute. The checkbox and the label are connected by the id attribute. Only will be displayed if a label is not specified.","title":" label"},{"location":"acelements.html#checked","text":"A checked is a Boolean value and indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent.","title":" checked"},{"location":"acelements.html#autoconnectinput","text":"AutoConnectInput generates an HTML < input type = \"text\" > tag and a < label > tag. It can also have a placeholder. The value of the input box is passed to the destination in the query string and can be retrieved programmatically. You can also update from the sketches. Sample AutoConnectInput input(\"input\", \"\", \"Server\", \"MQTT broker server\"); On the page:","title":"AutoConnectInput"},{"location":"acelements.html#constructor_3","text":"AutoConnectInput( const char * name, const char * value, const char * label, const char * pattern, const char * placeholder)","title":" Constructor"},{"location":"acelements.html#name_3","text":"It is the name of the AutoConnectInput element and matches the name attribute, the id attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_3","text":"It becomes a string value of the value attribute of an HTML < input type = \"text\" > tag. The text entered from the custom Web page will be grouped in the query string of the form submission and the string set before accessing the page will be displayed as the initial value.","title":" value"},{"location":"acelements.html#label_1","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#pattern","text":"A pattern specifies a regular expression that the AutoConnectInput element's value is checked against on form submission. If it is invalid, the background color will change, but it will be sent even if the data format does not match. The password that must contain 8 or more characters that are of at least one number, and one uppercase and lowercase letter: (?=.*\\d)(?=.*[a-z])(?=.*[A-Z]).{8,} Email address as characters@characters.domain : [a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,}$ IP address Host name of the internet Date (MM-DD-YYYY) Twitter account: ^@?(\\w){1,15}$","title":" pattern"},{"location":"acelements.html#placeholder","text":"A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag.","title":" placeholder"},{"location":"acelements.html#autoconnectradio","text":"AutoConnectRadio generates few HTML < input type = \"radio\" > tags as grouped and the same number of < label > tags. AutoConnectRadio can keep the value of a radio button as a collection. The grouped values will be placed in the custom Web page to select only one exclusively. Sample AutoConnectRadio radio(\"radio\", { \"30 sec.\", \"60 sec.\", \"180 sec.\" }, \"Update period\", AC_Vertical, 1); On the page:","title":"AutoConnectRadio"},{"location":"acelements.html#constructor_4","text":"AutoConnectRadio( const char * name, std :: vector < String > const & values, const char * label, const ACArrange_t order, const uint8_t checked)","title":" Constructor"},{"location":"acelements.html#name_4","text":"It is the name of the AutoConnectRadio element and matches the name attribute of the input tags. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#values","text":"A values is an array of String type for the radio button options which as actually std::vector . It is an initialization list can be used. The input tags will be generated from each entry in the values, the amount of which is the same as the number of items in values .","title":" values"},{"location":"acelements.html#label_2","text":"A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Specification of a label will generate an HTML < label > tag with an id attribute. The radio buttons and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#order","text":"A order specifies the direction to arrange the radio buttons. It is a value of type ACArrange_t and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. A label will place in the left or the top according to the order .","title":" order"},{"location":"acelements.html#checked_1","text":"A checked specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked.","title":" checked"},{"location":"acelements.html#autoconnectselect","text":"AutoConnectSelect generates an HTML < select > tag (drop-down list) and few < option > tags. Sample AutoConnectSelect select(\"select\", { String(\"Europe/London\"), String(\"Europe/Berlin\"), String(\"Europe/Helsinki\"), String(\"Europe/Moscow\"), String(\"Asia/Dubai\") }, \"Select TZ name\"); On the page:","title":"AutoConnectSelect"},{"location":"acelements.html#constructor_5","text":"AutoConnectSelect( const char * name, std :: vector < String > const & options, const char * label)","title":" Constructor"},{"location":"acelements.html#name_5","text":"It is the name of the AutoConnectSelect element and matches the name attribute of the select tags.","title":" name"},{"location":"acelements.html#options","text":"An options is an array of String type for the options which as actually std::vector for an HTML < option > tag. It is an initialization list can be used. The option tags will be generated from each entry in the options, the amount of which is the same as the number of items in an options .","title":" options"},{"location":"acelements.html#label_3","text":"A label is an optional string. A label is always arranged on the left side of the drop-down list. Specification of a label will generate an HTML < label > tag with an id attribute. The select tag and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#autoconnectsubmit","text":"AutoConnectSubmit generates an HTML < input type = \"button\" > tag attached onclick attribute. The native code of the onclick attribute is the submission of the form with the POST method. Sample AutoConnectSubmit submit(\"submit\", \"Save\", \"/mqtt_save\"); On the page:","title":"AutoConnectSubmit"},{"location":"acelements.html#constructor_6","text":"AutoConnectSubmit( const char * name, const char * value, const char * uri)","title":" Constructor"},{"location":"acelements.html#name_6","text":"It is the name of the AutoConnectSubmit element and matches the name attribute of the input tag.","title":" name"},{"location":"acelements.html#value_4","text":"It becomes a string of the value attribute of an HTML < input type = \"button\" > tag. The value will be displayed as a label of the button.","title":" value"},{"location":"acelements.html#uri","text":"A uri specifies the URI to send form data when the button declared by AutoConnectSubmit is clicked. The query string of the form data sent with AutoConnectSubmit contains the URI of the page. Its parameter name is _acuri . In Sketch, you can know the called URI by referring to the _acuri parameter with the destination page handler. The actual query string is as follows: _acuri= CALLER_URI","title":" uri"},{"location":"acelements.html#autoconnecttext","text":"AutoConnectText generates an HTML < div > tag. A style attribute will be attached if a style parameter is passed. Sample AutoConnectText text(\"text\", \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\", \"font-family:serif;color:#4682b4;\"); On the page:","title":"AutoConnectText"},{"location":"acelements.html#constructor_7","text":"AutoConnectText( const char * name, const char * value, const char * style)","title":" Constructor"},{"location":"acelements.html#name_7","text":"A name does not exist in the generated HTML. It provides only a means of accessing elements with the sketches.","title":" name"},{"location":"acelements.html#value_5","text":"It becomes content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag.","title":" value"},{"location":"acelements.html#style","text":"A style specifies the qualification style to give to the content and can use the style attribute format as it is.","title":" style"},{"location":"acelements.html#how-to-coding-for-the-elements","text":"","title":"How to coding for the elements"},{"location":"acelements.html#declaration-for-the-elements-in-sketches","text":"Variables of each AutoConnetElement can be declared with macros. By using the macros, you can treat element name that is String type as variable in sketches. 2 ACElement ( name [ , value ] ) ACButton ( name [ , value ] [ , action ] ) ACCheckbox ( name [ , value ] [ , label ] [ , true | false ] ) ACInput ( name [ , value ] [ , label ] [ , placeholder ] ) ACRadio ( name [ , values ] [ , label ] [ , AC_Horizontal | AC_Vertical ] [ , checked ] ) ACSelect ( name [ , options ] [ , label ] ) ACSubmit ( name [ , value ] [ , uri ] ) ACText ( name [ , value ] [ , style ] ) Declaration macro usage For example, AutoConnectText can be declared using macros. AutoConnectText caption( \"caption\" , \"hello, world\" , \"color:blue;\" ) equals by using ACText macro. ACText(caption, \"hello, world\" , \"color:blue;\" )","title":" Declaration for the elements in Sketches"},{"location":"acelements.html#variant-for-autoconnectelements","text":"Some AutoConnectAux APIs specify AutoConnectElements as an argument. There are also functions that return a pointer to AutoConnectElements. AutoConnectElement behaves as a variant type of each element class to make these interfaces a single. Use reinterpret_cast to cast from a variant pointer to an Actual type pointer of AutoConnectElements. AutoConnectAux aux; ACText(Text1, \"hello, world\" ); aux.add(Text1); AutoConnectText * text_p = reinterpret_cast < AutoConnectText > (aux.getElement( \"Text1\" )); AutoConnectText & text = aux.getElement < AutoConnectText > ( \"Text1\" ); JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9 The square brackets in the syntax are optional parameters, the stroke is a selection parameter, the bold fonts are literal. \u21a9","title":" Variant for AutoConnectElements"},{"location":"achandling.html","text":"Handing AutoConnectElements with the sketches \u00b6 AutoConnectElements (i.e. they are the elements displayed on the custom Web page) must be contained in AutoConnectAux object. AutoConnectElements declared in sketch must be programmed to add to AutoConnectAux one after another. Elements are automatically included in AutoConnectAux by AutoConnect if you load it from the JSON description. In either method, it is common to use the function of AutoConnectAux to access an element with a sketch. The AutoConnectAux class has several functions to manipulate AutoConnectElements. The functions can add, delete, retrieve elements, and get and set values. Add AutoConnectElements to the AutoConnectAux object \u00b6 To add AutoConnectElment(s) to an AutoConnectAux object, use the add function. void AutoConnectAux :: add(AutoConenctElement & addon) void AutoConnectAux :: add(AutoConenctElementVT addons) The add function adds specified AutoConnectElement to the AutoConnectAux. If specified the collection of AutoConnectElements as a std::vector of the references to each element, these elements added in bulk. The AutoConnectElements contained in the AutoConnectAux object are uniquely identified by the name. When adding an AutoConnectElement, if an element with the same name already exists in the AutoConnectAux, checking the type, and if it is the same, the value will be replaced. If another type of AutoConnectElement exists with the same name, that add operation will be invalid. 1 In the following example, an AutoConnectButton as button addition is invalid. AutoConnectAux aux; AutoConnectText text ( \"hello\" , \"hello, world\" ); AutoConnectButton button ( \"hello\" , \"hello, world\" , \"alert('Hello world!')\") ; // This is invalid. aux.add({ text, button }); Similarly this, the uniqueness of the name is also necessary within the JSON document { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true , \"element\" : [ { \"name\" : \"hello\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"hello\" , \"type\" : \"ACButton\" , \"value\" : \"hello, world\" , \"action\" : \"alert('Hello world!')\" } ] } Load all elements from JSON document If you load all AutoConnectElements from JSON document into AutoConnect, you do not need to sketch the population process of the AutoConnectElements. It is managed by the AutoConnect library automatically. Get AutoConnectElement from the AutoConnectAux \u00b6 To retrieve an element from AutoConnectAux, use the getElement or getElements function. Normally, the getElement is needed when accessing the value of AutoConnectElement in the sketch. AutoConnectElement * AutoConnectAux :: getElement( const String & name); template < typename T > T & AutoConnectAux :: getElement( const String & name); AutoConnectElementVT * AutoConnectAux :: getElements( void ); The getElement function returns an AutoConnectElement with the specified name as a key. When you use this function, you need to know the type of AutoConnectElement in advance. To retrieve an AutoConnectElement by specifying its type, use the following method. AutoConnectAux aux; aux.load( \"SOME_JSON_DOCUMENT\" ); // Retrieve the pointer of the AutoConnectText AutoConnectText * text = reinterpret_cast < AutoConnectText *> (aux.getElement( \"TEXT_ELEMENT_NAME\" )); // Retrieve the reference of the AutoConnectText AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_ELEMENT_NAME\" ); The AutoConnectElement type behaves as a variant of other element types. Therefore use cast or template to convert to actual type as above. In the sketch, you access the real type of AutoConnectElement after casting it and storing into the variable. const String auxJson = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); AutoConenct portal; portal.load(auxJson); AutoConnectAux * aux = portal.aux( \"/page1\" ); // Identify the AutoConnectAux instance with uri AutoConenctText & text = aux -> getElement < AutoConnectText > ( \"caption\" ); // Cast to real type and access members Serial.println(text.value); To get all the AutoConnectElements of an AutoConnectAux object use the getElements function. This function returns the vector of the reference wrapper as AutoConnectElementVT to all AutoConnectElements registered in the AutoConnectAux. AutoConnectElementVT & getElements( void ) AutoConnectElementVT is a predefined type for it and can use methods of std::vector < std::reference_wrapper >. Loading & saving AutoConnectElements with JSON \u00b6 AutoConnect supports reading the custom Web page definitions written in JSON and also supports loading and saving of AutoConnectElements. In both cases, the target object is a JSON document for AutoConnect . However, it can not save all AutoConnectElements contained in the page as a custom Web page. (ie. AutoConnectAux) Loading AutoConnectAux & AutoConnectElements with JSON \u00b6 To load a JSON document as AutoConnectAux use the AutoConnect::load function and load the JSON document of each AutoConnectElement using the AutoConnectAux::loadElement function. Although the functions of both are similar, the structure of the target JSON document is different. The AutoConnect::load function loads the entire AutoConnectAux and creates both the AutoConnectAux instance and each AutoConnectElement instance. A single JSON document can contain multiple custom Web pages. If you write JSON of AutoConnectAux as an array, the load function generates all the pages contained in that array. Therefore, it is necessary to supply the JSON document of AutoConnectAux as an input of the load function and must contain the elements described here . The AutoConnectAux::loadElement function loads the elements individually into an AutoConnectAux object. The structure of its supplying JSON document is not AutoConnectAux. It must be a JSON structure for AutoConnectElement , but you can specify an array. // AutoConnectAux as a custom Web page. const char page[] PROGMEM = R\"raw( { \"title\": \"Settings\", \"uri\": \"/settings\", \"menu\": true, \"element\": [ { \"name\": \"server\", \"type\": \"ACInput\", \"label\": \"Server\" }, { \"name\": \"set\", \"type\": \"ACSubmit\", \"value\": \"SET\", \"uri\" : \"/set\" } ] } )raw\" ; // Additional AutoConnectElements. const char addons[] PROGMEM = R\"raw( [ { \"name\": \"notes\", \"type\": \"ACText\", \"value\": \"An update period as the below optionally.\" }, { \"name\": \"period\", \"type\": \"ACRadio\", \"value\": [ \"30 sec.\", \"60 sec.\", \"180 sec.\" ], \"arrange\": \"vertical\", \"checked\": 1 } ] )raw\" ; AutoConnect portal; AutoConnectAux * auxPage; // Load a custom Web page. portal.load(page); // Get a '/settings' page auxPage = portal.aux( \"/settings\" ); // Also, load only AutoConnectRadio named the period. auxPage -> loadElement(addons, \"period\" ); // Retrieve a server name from an AutoConnectText value. AutoConnectText & serverName = auxPage -> getElement < AutoConnectText > ( \"server\" ); Serial.println(serverName.value); Saving AutoConnectElements with JSON \u00b6 To save the AutoConnectElement as a JSON document, use the AutoConnectAux::saveElement function. It serializes the contents of the object based on the type of the AutoConnectElement. You can persist a serialized AutoConnectElements as a JSON document to a stream. // Open a parameter file on the SPIFFS. SPIFFS.begin(); FILE param = SPIFFS.open( \"/param\" , \"w\" ); // Save elements as the parameters. auxPage -> saveElement(param, { \"server\" , \"period\" }); // Close a parameter file. param.close(); SPIFFS.end(); The example above saves server and period elements from the AutoConnectAux object as mentioned above to the /param file on SPIFFS. Its JSON document of AutoConnectElements saved by its code looks like this: [ { \"name\" : \"server\" , \"type\" : \"ACInput\" , \"value\" : \"An inputted server name\" , \"label\" : \"Server\" , \"placeholder\" : \"\" }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"arrange\" : \"vertical\" , \"checked\" : 2 } ] Custom field data handling \u00b6 A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored in the member variable of each element by AutoConnect whenever GET/POST transmission occurs. The following diagram shows the flow of the input values of a custom Web page into a sketch and is the basis for actions to manipulate the values of custom Web pages using sketches. Where to pick up the values \u00b6 A sketch composed of handlers can receive the value of AutoConnectElements entered in a custom Web page after sending, but that handler is different from the page where the value was entered. It is necessary to be aware that can accept the entered values by the next page handler after the transition. Usually, two ways to retrieve entered values we have. One is to use the ESP8266WebServer::arg (or WebServer::arg for ESP32) function in the on handler attached by ESP8266WebServer (WebServer w/ESP32 also). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char addonJson[] PROGMEM = R\"raw( { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] } )raw\" ; ESP8266WebServer webServer; AutoConnect portal (webServer); // Here, /feels handler void feelsOn () { // Retrieve the value of a input-box named \"feels\" String feel = webServer.arg( \"feels\" ); // Echo back the value String echo = \"<html><p style= \\\" color:blue;font-family:verdana;font-size:300%; \\\" >\" + feel + String( \" and a bold world!</p></html>\" ); webServer.send( 200 , \"text/html\" , echo); } void setup () { delay( 1000 ); webServer.on( \"/feels\" , feelsOn); // Register /feels handler portal.load(addonJson); // Load a custom Web page portal.begin(); } void loop () { portal.handleClient(); } An above example is the most simple sketch of handling values entered into a custom Web page. This sketch obtains the string entered in the AutoConnectInput named feels with the /feels handler after page transition, and the AutoConnectInput is an <input type=\"text\" name=\"feels\"> element wrapped in the form as the actual HTML code. Should be accessed /_ac first When you actually try the above sketch, there is no a root handler. So the URL that should be accessed first is /_ac concatenated with the local IP address of the esp8266 module. Another method is effective when custom Web pages have complicated page transitions. It is a way to straight access the AutoConnectElements member value. You can get the AutoConnectElement with the specified name using the getElement function. The following sketch executes the above example with AutoConnect only, without using the function of ESP8266WebServer. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> const static char addonJson[] PROGMEM = R\"raw( [ { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] }, { \"title\": \"Hello\", \"uri\": \"/feels\", \"menu\": false, \"element\": [ { \"name\": \"echo\", \"type\": \"ACText\", \"style\": \"color:blue;font-family:verdana;font-size:300%;\" } ] } ] )raw\" ; AutoConnect portal; // Here, /feels handler String feelsOn (AutoConnectAux & aux, PageArgument & args) { // Get the AutoConnectInput named \"feels\". // The where() function returns the AutoConnectAux of the page that triggered this handler. AutoConnectInput & feels = portal.where() -> getElement < AutoConnectInput > ( \"feels\" ); // Get the AutoConnectText named \"echo\". AutoConnectText & echo = aux.getElement < AutoConnectText > ( \"echo\" ); // Echo back from input-box to /feels page. echo.value = feels.value + String( \" and a bold world!\" ); return String( \"\" ); } void setup () { delay( 1000 ); portal.load(addonJson); // Load custom Web pages portal.on( \"/feels\" , feelsOn, AC_EXIT_AHEAD); // Register /feels handler portal.begin(); } void loop () { portal.handleClient(); } The above example handles in the handler for the values of a custom Web page. An AutoConnect::on function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the PageArgument object. To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the AutoConnect::where function. The AutoConnect::where function returns a pointer to the AutoConnectAux object of the custom Web page that caused the HTTP request. The where() function is available for only AutoConnectAux. The AutoConnect::where function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/ESP32. In other words, the AutoConnect::where function only returns the last AutoConnecAux page called. When setting the initial values \u00b6 An AutoConnectAux page is dynamically created by AutoConnect when its uri is requested. The initial value of AutoConnectElements can be set before its page request. It is also possible during loop() . To set the initial value when the page is accessed it needs by the handler of its page. The AutoConnect::on and AutoConnectAux::on functions register a handler for a custom Web page and also specify when to call that handler. The behavior of the two on functions is the same, only the class and arguments are different. bool AutoConnect :: on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order) void AutoConnectAux :: on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order) Parameter uri specifies an URI of the custom Web page, but an AutoConnectAux object with its URI must be registered with AutoConnect via the AutoConnect::join function beforehand. AutoConnect::on/AutoConnectAux::on is not ESP8266WebServer::on The on function for AutoConnect is different from the on function of Arduino core ESP8266WebServer (WebServer for ESP32). You can share the same handler via wrapper, but access to AutoConnectElements is valid only for handlers registered with on function for AutoConnect . AuxHandlerFunctionT type is a handler declaration using with std::function . String handler(AutoConnectAux & aux, PageArgument & args) The handler of the custom Web page has two arguments by a reference of AutoConnectAux and a reference of PageArgument, it returns String. AutoConnect appends the string returned from the handler to the generated HTML. This allows you to add an HTML part before displaying the page. AutoConnectExitOrder_t specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. The following example is a part of sketch contained the handlers. // AutoConnect object declarations ACInput(input1); AutoConnectAux aux ( \"/aux\" , { input1 }); AutoConnect portal; // Pre-declare handlers String initialize (AutoConnectAux & , PageArgument & ); String append (AutoConnectAux & , PageArgument & ); // Register handlers and launch the portal. aux.on(initialize, AC_AHEAD); aux.on(append, AC_LATER); portal.join(aux); portal.begin(); // Some code here... // The handler called before HTML generating String initialize (AutoConnectAux & aux, PageArgument & args) { AutoConnectInput & input1 = aux.getElement < AutoConnectInput > ( \"input1\" ); // Set initial value for the input box in a custom Web page. input1.value = \"Initial value\" ; // Nothing appendix for a generated HTML. return String(); } // The handler called after HTML generated String append (AutoConnectAux & aux, PageArgument & args) { // Append an HTML return String( \"<p>This text has been added.</p>\" ); } How you can reach the values \u00b6 AutoConnectSubmit uses the POST method to send HTTP requests. A value of AutoConnectInput sent to the ESP8266 or ESP32 with POST is stored in the request body of the HTTP request: POST /feels HTTP/1.1 Host: ESP8266_IP_ADDRESS name1=value1&name2=value2&name3=value3 ESP8266WebServer class will parse the query string and rebuilds its arguments when the above request arrives. A custom page handler registered with the ESP8266WebServer::on function can access the value of AutoConnectElements with ESP8266WebServe::arg function. It reaches the values of AutoConnectElements without the intermediation of AutoConnect. Therefore, its handler will not be AutoConnectAux and can send a response to the client directly. The following example is part of a server sketch which has two web pages. The /hello page is a custom Web page of AutoConnectAux which has an input box named \"input1\". Another /echo page is a page handler for ESP8266WebServer, which uses the ESP8266WebServer::send function to echo back the value of an input1 as an http response. ESP8266WebServer server; AutoConnect portal (server); ACInput(input1, \"\" , \"INPUT\" ); ACSubmit(send, \"HELLO\" , \"/echo\" ); AutoConnectAux aux ( \"/hello\" , { input1, send }); server.on( \"/echo\" , []() { String echo = server.arg( \"input1\" ); Serial.println(echo); server.send( 200 , \"text/plain\" , echo); }); portal.join(aux); portal.begin(); Also, you can choose another way to access arguments without going through the ESP8266WebServer class. The PageArgument object of the custom Web page handler argument is a copy of the arg object of the ESP8266WebServer class. Either of these methods is a simple and easy way to access parameters in custom Web page handlers. However, if you need to access from outside of the handler to the value of AutoConnectElements, you need to accomplish it using with the AutoConnectAux::getElement function. The following sketch code replaces the above example with JSON and PageArgument, and its behaves is equivalent basically to the above sketch. const static char auxPage[] PROGMEM = R \"raw ( [ { \"title\" : \"Hello\" , \"uri\" : \"/hello\" , \"menu\" : true, \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" , \"label\" : \"INPUT\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"value\" : \"HELLO\" , \"uri\" : \"/echo\" }] }, { \"title\" : \"Echo\" , \"uri\" : \"/echo\" , \"menu\" : false, \"element\" : [ { \"name\" : \"echo\" , \"type\" : \"ACText\" }] } ] )raw \"; AutoConnect portal; portal.load(auxPage); portal.on( \"/echo\" , [](AutoConnectAux & aux, PageArgument & args) { AutoConnectText & ac_echo = aux.getElement < AutoConnectText > ( \"echo\" ); ac_echo.value = args.arg( \"input1\" ); return String (); }); portal.begin(); Overwrite the AutoConnectElements \u00b6 Sketches can update the attributes of AutoConnectElements with two approaches. A one is to assign directly to the attributes of a member variable of its element. The other is to overwrite them with loading the element by AutoConnectAux::loadElement . The elements for attributes described in the JSON document for AutoConnectElements overwrites the member variables of the target AutoConnectElements. However, AutoConnectAux::loadElement keeps the member variables unchanged if there is no element in the JSON document. This overwriting behavior is the same for the AutoConnect::load function. For example, the combination of the sketch and JSON document as follows updates only the style while keeping Captiopn (ie. \"Hello, world\") as AutoConnectText value. The sketch (part of code) ACText(Caption, \"Hello, world\" ); AutoConnectAux helloPage ( \"/hello\" , \"Hello\" , true, { Caption }); AutoConnect portal; String onHello (AutoConnectAux & aux, PageArgument & args) { aux.loadElement(JSON); return String(); } void setup () { helloPage.on(onHello); portal.join(helloPage); portal.begin(); } void loop () { portal.handleClient(); } External JSON document for the above sketch to modify the text style { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"style\" : \"text-align:center;font-family:'Avenir','Corbel','Osaka';color:Green;\" } Check data against on submission \u00b6 By giving a pattern to AutoConnectInput , you can find errors in data styles while typing in custom Web pages. The pattern is specified by regular expression . 2 If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. The following example shows the behavior when checking the IP address in the AutoConnectInput field. { \"title\" : \"Page-1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" , \"pattern\" : \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" } ] } Convert data to actually type \u00b6 Transitions of the custom Web pages \u00b6 Scope & Lifetime of AutoConnectAux \u00b6 The lifetime of AutoConnectAux and AutoConnectElements must remain in the period when the custom Web page can be manipulated. The implementation of the custom Web page inherits from requestHandler driven from ESP8266WebServer (WebServer for ESP32), so the instance of AutoConnectAux and AutoConnectElements must exist for the duration of effect of handleClient. The following example is incorrect for manipulating custom Web pages. Its AutoConnectAux instance will be destructed at the exit of the setup(). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const auxPage[] PROGMEM = R\"raw( { \"title\": \"Page-1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\":\"Server\", \"type\":\"ACText\", \"label\":\"Server address\" } ] } )raw\" ; AutoConnect portal; void setup () { // This declaration is wrong. AutoConnectAux aux; aux.load(auxPage); portal.join(aux); portal.begin(); } void loop () { portal.handleClient(); } The URI of the custom Web pages \u00b6 The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the ESP8266WebServer::on / WebServer::on function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the AutoConnectAux::on function. In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section. Restrictions \u00b6 The custom Web pages handler has the following restrictions. Do not send HTTP responses from the handler. If the handler returns its own response, the custom Web page will be lost. Use AutoConnectSubmit whenever possible. AutoConnect will hold the values of a custom Web Page is sent by AutoConnectSubmit. Can not handle the custom Web pages during a connection is not established yet. During the connection attempt, the web browser of the client will send a probe for a captive portal. Its request will cause unintended custom Web page transitions. Can not place URI of the custom Web pages to AUTOCONNECT_URI]. AutoConnect will not work if you place a custom Web page to AUTOCONNECT_URI . 302 Redirect Alternatives To transition from a custom Web page to a sketch owned page, execute the link function of JavaScript with the AutoConnectElement element. window.onload = function() { Gifffer(); }; The valid scope of the name is within an AutoConnectAux. \u21a9 The pattern of AutoConnectInput conforms to javascript specification. \u21a9","title":"Handling the custom Web pages"},{"location":"achandling.html#handing-autoconnectelements-with-the-sketches","text":"AutoConnectElements (i.e. they are the elements displayed on the custom Web page) must be contained in AutoConnectAux object. AutoConnectElements declared in sketch must be programmed to add to AutoConnectAux one after another. Elements are automatically included in AutoConnectAux by AutoConnect if you load it from the JSON description. In either method, it is common to use the function of AutoConnectAux to access an element with a sketch. The AutoConnectAux class has several functions to manipulate AutoConnectElements. The functions can add, delete, retrieve elements, and get and set values.","title":"Handing AutoConnectElements with the sketches"},{"location":"achandling.html#add-autoconnectelements-to-the-autoconnectaux-object","text":"To add AutoConnectElment(s) to an AutoConnectAux object, use the add function. void AutoConnectAux :: add(AutoConenctElement & addon) void AutoConnectAux :: add(AutoConenctElementVT addons) The add function adds specified AutoConnectElement to the AutoConnectAux. If specified the collection of AutoConnectElements as a std::vector of the references to each element, these elements added in bulk. The AutoConnectElements contained in the AutoConnectAux object are uniquely identified by the name. When adding an AutoConnectElement, if an element with the same name already exists in the AutoConnectAux, checking the type, and if it is the same, the value will be replaced. If another type of AutoConnectElement exists with the same name, that add operation will be invalid. 1 In the following example, an AutoConnectButton as button addition is invalid. AutoConnectAux aux; AutoConnectText text ( \"hello\" , \"hello, world\" ); AutoConnectButton button ( \"hello\" , \"hello, world\" , \"alert('Hello world!')\") ; // This is invalid. aux.add({ text, button }); Similarly this, the uniqueness of the name is also necessary within the JSON document { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true , \"element\" : [ { \"name\" : \"hello\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"hello\" , \"type\" : \"ACButton\" , \"value\" : \"hello, world\" , \"action\" : \"alert('Hello world!')\" } ] } Load all elements from JSON document If you load all AutoConnectElements from JSON document into AutoConnect, you do not need to sketch the population process of the AutoConnectElements. It is managed by the AutoConnect library automatically.","title":" Add AutoConnectElements to the AutoConnectAux object"},{"location":"achandling.html#get-autoconnectelement-from-the-autoconnectaux","text":"To retrieve an element from AutoConnectAux, use the getElement or getElements function. Normally, the getElement is needed when accessing the value of AutoConnectElement in the sketch. AutoConnectElement * AutoConnectAux :: getElement( const String & name); template < typename T > T & AutoConnectAux :: getElement( const String & name); AutoConnectElementVT * AutoConnectAux :: getElements( void ); The getElement function returns an AutoConnectElement with the specified name as a key. When you use this function, you need to know the type of AutoConnectElement in advance. To retrieve an AutoConnectElement by specifying its type, use the following method. AutoConnectAux aux; aux.load( \"SOME_JSON_DOCUMENT\" ); // Retrieve the pointer of the AutoConnectText AutoConnectText * text = reinterpret_cast < AutoConnectText *> (aux.getElement( \"TEXT_ELEMENT_NAME\" )); // Retrieve the reference of the AutoConnectText AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_ELEMENT_NAME\" ); The AutoConnectElement type behaves as a variant of other element types. Therefore use cast or template to convert to actual type as above. In the sketch, you access the real type of AutoConnectElement after casting it and storing into the variable. const String auxJson = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); AutoConenct portal; portal.load(auxJson); AutoConnectAux * aux = portal.aux( \"/page1\" ); // Identify the AutoConnectAux instance with uri AutoConenctText & text = aux -> getElement < AutoConnectText > ( \"caption\" ); // Cast to real type and access members Serial.println(text.value); To get all the AutoConnectElements of an AutoConnectAux object use the getElements function. This function returns the vector of the reference wrapper as AutoConnectElementVT to all AutoConnectElements registered in the AutoConnectAux. AutoConnectElementVT & getElements( void ) AutoConnectElementVT is a predefined type for it and can use methods of std::vector < std::reference_wrapper >.","title":" Get AutoConnectElement from the AutoConnectAux"},{"location":"achandling.html#loading-saving-autoconnectelements-with-json","text":"AutoConnect supports reading the custom Web page definitions written in JSON and also supports loading and saving of AutoConnectElements. In both cases, the target object is a JSON document for AutoConnect . However, it can not save all AutoConnectElements contained in the page as a custom Web page. (ie. AutoConnectAux)","title":"Loading &amp; saving AutoConnectElements with JSON"},{"location":"achandling.html#loading-autoconnectaux-autoconnectelements-with-json","text":"To load a JSON document as AutoConnectAux use the AutoConnect::load function and load the JSON document of each AutoConnectElement using the AutoConnectAux::loadElement function. Although the functions of both are similar, the structure of the target JSON document is different. The AutoConnect::load function loads the entire AutoConnectAux and creates both the AutoConnectAux instance and each AutoConnectElement instance. A single JSON document can contain multiple custom Web pages. If you write JSON of AutoConnectAux as an array, the load function generates all the pages contained in that array. Therefore, it is necessary to supply the JSON document of AutoConnectAux as an input of the load function and must contain the elements described here . The AutoConnectAux::loadElement function loads the elements individually into an AutoConnectAux object. The structure of its supplying JSON document is not AutoConnectAux. It must be a JSON structure for AutoConnectElement , but you can specify an array. // AutoConnectAux as a custom Web page. const char page[] PROGMEM = R\"raw( { \"title\": \"Settings\", \"uri\": \"/settings\", \"menu\": true, \"element\": [ { \"name\": \"server\", \"type\": \"ACInput\", \"label\": \"Server\" }, { \"name\": \"set\", \"type\": \"ACSubmit\", \"value\": \"SET\", \"uri\" : \"/set\" } ] } )raw\" ; // Additional AutoConnectElements. const char addons[] PROGMEM = R\"raw( [ { \"name\": \"notes\", \"type\": \"ACText\", \"value\": \"An update period as the below optionally.\" }, { \"name\": \"period\", \"type\": \"ACRadio\", \"value\": [ \"30 sec.\", \"60 sec.\", \"180 sec.\" ], \"arrange\": \"vertical\", \"checked\": 1 } ] )raw\" ; AutoConnect portal; AutoConnectAux * auxPage; // Load a custom Web page. portal.load(page); // Get a '/settings' page auxPage = portal.aux( \"/settings\" ); // Also, load only AutoConnectRadio named the period. auxPage -> loadElement(addons, \"period\" ); // Retrieve a server name from an AutoConnectText value. AutoConnectText & serverName = auxPage -> getElement < AutoConnectText > ( \"server\" ); Serial.println(serverName.value);","title":" Loading AutoConnectAux &amp; AutoConnectElements with JSON"},{"location":"achandling.html#saving-autoconnectelements-with-json","text":"To save the AutoConnectElement as a JSON document, use the AutoConnectAux::saveElement function. It serializes the contents of the object based on the type of the AutoConnectElement. You can persist a serialized AutoConnectElements as a JSON document to a stream. // Open a parameter file on the SPIFFS. SPIFFS.begin(); FILE param = SPIFFS.open( \"/param\" , \"w\" ); // Save elements as the parameters. auxPage -> saveElement(param, { \"server\" , \"period\" }); // Close a parameter file. param.close(); SPIFFS.end(); The example above saves server and period elements from the AutoConnectAux object as mentioned above to the /param file on SPIFFS. Its JSON document of AutoConnectElements saved by its code looks like this: [ { \"name\" : \"server\" , \"type\" : \"ACInput\" , \"value\" : \"An inputted server name\" , \"label\" : \"Server\" , \"placeholder\" : \"\" }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"arrange\" : \"vertical\" , \"checked\" : 2 } ]","title":" Saving AutoConnectElements with JSON"},{"location":"achandling.html#custom-field-data-handling","text":"A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored in the member variable of each element by AutoConnect whenever GET/POST transmission occurs. The following diagram shows the flow of the input values of a custom Web page into a sketch and is the basis for actions to manipulate the values of custom Web pages using sketches.","title":"Custom field data handling"},{"location":"achandling.html#where-to-pick-up-the-values","text":"A sketch composed of handlers can receive the value of AutoConnectElements entered in a custom Web page after sending, but that handler is different from the page where the value was entered. It is necessary to be aware that can accept the entered values by the next page handler after the transition. Usually, two ways to retrieve entered values we have. One is to use the ESP8266WebServer::arg (or WebServer::arg for ESP32) function in the on handler attached by ESP8266WebServer (WebServer w/ESP32 also). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char addonJson[] PROGMEM = R\"raw( { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] } )raw\" ; ESP8266WebServer webServer; AutoConnect portal (webServer); // Here, /feels handler void feelsOn () { // Retrieve the value of a input-box named \"feels\" String feel = webServer.arg( \"feels\" ); // Echo back the value String echo = \"<html><p style= \\\" color:blue;font-family:verdana;font-size:300%; \\\" >\" + feel + String( \" and a bold world!</p></html>\" ); webServer.send( 200 , \"text/html\" , echo); } void setup () { delay( 1000 ); webServer.on( \"/feels\" , feelsOn); // Register /feels handler portal.load(addonJson); // Load a custom Web page portal.begin(); } void loop () { portal.handleClient(); } An above example is the most simple sketch of handling values entered into a custom Web page. This sketch obtains the string entered in the AutoConnectInput named feels with the /feels handler after page transition, and the AutoConnectInput is an <input type=\"text\" name=\"feels\"> element wrapped in the form as the actual HTML code. Should be accessed /_ac first When you actually try the above sketch, there is no a root handler. So the URL that should be accessed first is /_ac concatenated with the local IP address of the esp8266 module. Another method is effective when custom Web pages have complicated page transitions. It is a way to straight access the AutoConnectElements member value. You can get the AutoConnectElement with the specified name using the getElement function. The following sketch executes the above example with AutoConnect only, without using the function of ESP8266WebServer. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> const static char addonJson[] PROGMEM = R\"raw( [ { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] }, { \"title\": \"Hello\", \"uri\": \"/feels\", \"menu\": false, \"element\": [ { \"name\": \"echo\", \"type\": \"ACText\", \"style\": \"color:blue;font-family:verdana;font-size:300%;\" } ] } ] )raw\" ; AutoConnect portal; // Here, /feels handler String feelsOn (AutoConnectAux & aux, PageArgument & args) { // Get the AutoConnectInput named \"feels\". // The where() function returns the AutoConnectAux of the page that triggered this handler. AutoConnectInput & feels = portal.where() -> getElement < AutoConnectInput > ( \"feels\" ); // Get the AutoConnectText named \"echo\". AutoConnectText & echo = aux.getElement < AutoConnectText > ( \"echo\" ); // Echo back from input-box to /feels page. echo.value = feels.value + String( \" and a bold world!\" ); return String( \"\" ); } void setup () { delay( 1000 ); portal.load(addonJson); // Load custom Web pages portal.on( \"/feels\" , feelsOn, AC_EXIT_AHEAD); // Register /feels handler portal.begin(); } void loop () { portal.handleClient(); } The above example handles in the handler for the values of a custom Web page. An AutoConnect::on function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the PageArgument object. To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the AutoConnect::where function. The AutoConnect::where function returns a pointer to the AutoConnectAux object of the custom Web page that caused the HTTP request. The where() function is available for only AutoConnectAux. The AutoConnect::where function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/ESP32. In other words, the AutoConnect::where function only returns the last AutoConnecAux page called.","title":" Where to pick up the values"},{"location":"achandling.html#when-setting-the-initial-values","text":"An AutoConnectAux page is dynamically created by AutoConnect when its uri is requested. The initial value of AutoConnectElements can be set before its page request. It is also possible during loop() . To set the initial value when the page is accessed it needs by the handler of its page. The AutoConnect::on and AutoConnectAux::on functions register a handler for a custom Web page and also specify when to call that handler. The behavior of the two on functions is the same, only the class and arguments are different. bool AutoConnect :: on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order) void AutoConnectAux :: on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order) Parameter uri specifies an URI of the custom Web page, but an AutoConnectAux object with its URI must be registered with AutoConnect via the AutoConnect::join function beforehand. AutoConnect::on/AutoConnectAux::on is not ESP8266WebServer::on The on function for AutoConnect is different from the on function of Arduino core ESP8266WebServer (WebServer for ESP32). You can share the same handler via wrapper, but access to AutoConnectElements is valid only for handlers registered with on function for AutoConnect . AuxHandlerFunctionT type is a handler declaration using with std::function . String handler(AutoConnectAux & aux, PageArgument & args) The handler of the custom Web page has two arguments by a reference of AutoConnectAux and a reference of PageArgument, it returns String. AutoConnect appends the string returned from the handler to the generated HTML. This allows you to add an HTML part before displaying the page. AutoConnectExitOrder_t specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. The following example is a part of sketch contained the handlers. // AutoConnect object declarations ACInput(input1); AutoConnectAux aux ( \"/aux\" , { input1 }); AutoConnect portal; // Pre-declare handlers String initialize (AutoConnectAux & , PageArgument & ); String append (AutoConnectAux & , PageArgument & ); // Register handlers and launch the portal. aux.on(initialize, AC_AHEAD); aux.on(append, AC_LATER); portal.join(aux); portal.begin(); // Some code here... // The handler called before HTML generating String initialize (AutoConnectAux & aux, PageArgument & args) { AutoConnectInput & input1 = aux.getElement < AutoConnectInput > ( \"input1\" ); // Set initial value for the input box in a custom Web page. input1.value = \"Initial value\" ; // Nothing appendix for a generated HTML. return String(); } // The handler called after HTML generated String append (AutoConnectAux & aux, PageArgument & args) { // Append an HTML return String( \"<p>This text has been added.</p>\" ); }","title":" When setting the initial values"},{"location":"achandling.html#how-you-can-reach-the-values","text":"AutoConnectSubmit uses the POST method to send HTTP requests. A value of AutoConnectInput sent to the ESP8266 or ESP32 with POST is stored in the request body of the HTTP request: POST /feels HTTP/1.1 Host: ESP8266_IP_ADDRESS name1=value1&name2=value2&name3=value3 ESP8266WebServer class will parse the query string and rebuilds its arguments when the above request arrives. A custom page handler registered with the ESP8266WebServer::on function can access the value of AutoConnectElements with ESP8266WebServe::arg function. It reaches the values of AutoConnectElements without the intermediation of AutoConnect. Therefore, its handler will not be AutoConnectAux and can send a response to the client directly. The following example is part of a server sketch which has two web pages. The /hello page is a custom Web page of AutoConnectAux which has an input box named \"input1\". Another /echo page is a page handler for ESP8266WebServer, which uses the ESP8266WebServer::send function to echo back the value of an input1 as an http response. ESP8266WebServer server; AutoConnect portal (server); ACInput(input1, \"\" , \"INPUT\" ); ACSubmit(send, \"HELLO\" , \"/echo\" ); AutoConnectAux aux ( \"/hello\" , { input1, send }); server.on( \"/echo\" , []() { String echo = server.arg( \"input1\" ); Serial.println(echo); server.send( 200 , \"text/plain\" , echo); }); portal.join(aux); portal.begin(); Also, you can choose another way to access arguments without going through the ESP8266WebServer class. The PageArgument object of the custom Web page handler argument is a copy of the arg object of the ESP8266WebServer class. Either of these methods is a simple and easy way to access parameters in custom Web page handlers. However, if you need to access from outside of the handler to the value of AutoConnectElements, you need to accomplish it using with the AutoConnectAux::getElement function. The following sketch code replaces the above example with JSON and PageArgument, and its behaves is equivalent basically to the above sketch. const static char auxPage[] PROGMEM = R \"raw ( [ { \"title\" : \"Hello\" , \"uri\" : \"/hello\" , \"menu\" : true, \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" , \"label\" : \"INPUT\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"value\" : \"HELLO\" , \"uri\" : \"/echo\" }] }, { \"title\" : \"Echo\" , \"uri\" : \"/echo\" , \"menu\" : false, \"element\" : [ { \"name\" : \"echo\" , \"type\" : \"ACText\" }] } ] )raw \"; AutoConnect portal; portal.load(auxPage); portal.on( \"/echo\" , [](AutoConnectAux & aux, PageArgument & args) { AutoConnectText & ac_echo = aux.getElement < AutoConnectText > ( \"echo\" ); ac_echo.value = args.arg( \"input1\" ); return String (); }); portal.begin();","title":" How you can reach the values"},{"location":"achandling.html#overwrite-the-autoconnectelements","text":"Sketches can update the attributes of AutoConnectElements with two approaches. A one is to assign directly to the attributes of a member variable of its element. The other is to overwrite them with loading the element by AutoConnectAux::loadElement . The elements for attributes described in the JSON document for AutoConnectElements overwrites the member variables of the target AutoConnectElements. However, AutoConnectAux::loadElement keeps the member variables unchanged if there is no element in the JSON document. This overwriting behavior is the same for the AutoConnect::load function. For example, the combination of the sketch and JSON document as follows updates only the style while keeping Captiopn (ie. \"Hello, world\") as AutoConnectText value. The sketch (part of code) ACText(Caption, \"Hello, world\" ); AutoConnectAux helloPage ( \"/hello\" , \"Hello\" , true, { Caption }); AutoConnect portal; String onHello (AutoConnectAux & aux, PageArgument & args) { aux.loadElement(JSON); return String(); } void setup () { helloPage.on(onHello); portal.join(helloPage); portal.begin(); } void loop () { portal.handleClient(); } External JSON document for the above sketch to modify the text style { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"style\" : \"text-align:center;font-family:'Avenir','Corbel','Osaka';color:Green;\" }","title":" Overwrite the AutoConnectElements"},{"location":"achandling.html#check-data-against-on-submission","text":"By giving a pattern to AutoConnectInput , you can find errors in data styles while typing in custom Web pages. The pattern is specified by regular expression . 2 If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. The following example shows the behavior when checking the IP address in the AutoConnectInput field. { \"title\" : \"Page-1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" , \"pattern\" : \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" } ] }","title":" Check data against on submission"},{"location":"achandling.html#convert-data-to-actually-type","text":"","title":" Convert data to actually type"},{"location":"achandling.html#transitions-of-the-custom-web-pages","text":"","title":"Transitions of the custom Web pages"},{"location":"achandling.html#scope-lifetime-of-autoconnectaux","text":"The lifetime of AutoConnectAux and AutoConnectElements must remain in the period when the custom Web page can be manipulated. The implementation of the custom Web page inherits from requestHandler driven from ESP8266WebServer (WebServer for ESP32), so the instance of AutoConnectAux and AutoConnectElements must exist for the duration of effect of handleClient. The following example is incorrect for manipulating custom Web pages. Its AutoConnectAux instance will be destructed at the exit of the setup(). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const auxPage[] PROGMEM = R\"raw( { \"title\": \"Page-1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\":\"Server\", \"type\":\"ACText\", \"label\":\"Server address\" } ] } )raw\" ; AutoConnect portal; void setup () { // This declaration is wrong. AutoConnectAux aux; aux.load(auxPage); portal.join(aux); portal.begin(); } void loop () { portal.handleClient(); }","title":"Scope &amp; Lifetime of AutoConnectAux"},{"location":"achandling.html#the-uri-of-the-custom-web-pages","text":"The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the ESP8266WebServer::on / WebServer::on function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the AutoConnectAux::on function. In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section.","title":"The URI of the custom Web pages"},{"location":"achandling.html#restrictions","text":"The custom Web pages handler has the following restrictions. Do not send HTTP responses from the handler. If the handler returns its own response, the custom Web page will be lost. Use AutoConnectSubmit whenever possible. AutoConnect will hold the values of a custom Web Page is sent by AutoConnectSubmit. Can not handle the custom Web pages during a connection is not established yet. During the connection attempt, the web browser of the client will send a probe for a captive portal. Its request will cause unintended custom Web page transitions. Can not place URI of the custom Web pages to AUTOCONNECT_URI]. AutoConnect will not work if you place a custom Web page to AUTOCONNECT_URI . 302 Redirect Alternatives To transition from a custom Web page to a sketch owned page, execute the link function of JavaScript with the AutoConnectElement element. window.onload = function() { Gifffer(); }; The valid scope of the name is within an AutoConnectAux. \u21a9 The pattern of AutoConnectInput conforms to javascript specification. \u21a9","title":"Restrictions"},{"location":"acintro.html","text":"What it is \u00b6 AutoConnect can handle custom Web pages prepared by user sketches individually. Custom Web pages are displayed in the AutoConnect menu and can be used from there. It can also have input-output parameters and handle it with sketches. For example, you can program some sketches that publish messages by entering the URI or unique ID of the MQTT broker on a custom page. You do not need to code the processing to handle the web page, it retrieves the input parameters and passes to the MQTT broker connection API is only. How it works \u00b6 Custom Web pages are dynamically created by AutoConnect. The Classes and APIs necessary for dynamic creation are provided. AutoConnectAux is an object dependent on AutoConnect, which provides an easy way to incorporate custom Web pages like the one on the right figure into AutoConnect. The elements that make up a custom web page are provided as an AutoConnectElement class. Furthermore, an input box, a check box, a submit button, etc. are implemented by classes derived from AutoConnectElement. AutoConnectAux is a container for AutoConnectElements. To make a custom Web page, create elements that make up the page and put it in the AutoConnectAux object. Joining its AutoConnectAux object to AutoConnect will integrate the custom Web page into the AutoConnect menu. The above figure shows a code sequence that declares AutoConnectElements and put in the AutoConnectAux container and integrates those into AutoConnect. It declares two text elements named ' header 'and ' caption ', adds them to the AutoConnectAux object ' aux ', binds to an AutoConnect object named ' portal '. It's the basic procedure for configuring the custom Web page. Also, further explanation of AutoConnectElements is the documentation . Custom Web pages in AutoConnect menu \u00b6 Custom Web pages as AutoConnectAux are integrated into the AutoConnect menu . AutoConnectAux object contains member variables which are URI and the title. It also has an indicator to show on the AutoConnect menu. You give the title and URI of the custom web page to the AutoConnectAux object with Sketch. Then the title of the custom Web page would be displayed at the bottom of the AutoConnect menu as the left figure. 1 It is a hyperlink as URI you given to the custom Web page and taps it will display a page composed of AutoConnectElements. Also, a title will display in the upper left corner of the page, which includes a hyperlink to the AutoConnect statistics screen. Multiple custom Web pages \u00b6 You can create multiple custom Web pages and specify which pages you can invoke from the menu. In the sketch below, it shows the sequence of codes to integrate three custom Web pages into one and embed them into the menu. In the above code, the third parameter of ' aux2 ' is false . The third parameter of the AutoConnectAux constructor is an indicator of whether it's shown to the AutoConnect menu. Right animation is the execution result of the above code. You will see that the custom Web page's menu is displayed only in the last two lines. The sketch of this animation is written to transition to ' aux2 ' by the utility of the AutoConnectSubmit element owned by ' aux1 '. 2 An ' aux2 ' page transitions only from the ' aux1 '. It is a page that saves the parameters you entered on the previous page as shown in mqttRSSI in the library example. It is to want to hide ' aux2 ' from AutoConnect menu lines. The utility of the third parameter of the AutoConnectAux constructor is that. Basic steps to use custom Web pages \u00b6 So, the basic procedure for handling of the custom Web pages is as follows: Create or define AutoConnectAux. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . Write the custom Web page with JSON \u00b6 You can write the custom Web page in JSON without using sketch codes. 3 It is possible to describe the entire page in JSON and can be described for each element also. The JSON description can be saved in SPIFFS or SD and read using AutoConnect's load function. If you take this approach, you can further reduce the steps of the above but this way consumes a lot of memory. The following JSON code and sketch will execute the custom Web page as the example in the above figure. That is, the sketch of this code and footnote 2 is equivalent. custom_page.json [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"MQTT broker settings\" }, { \"name\" : \"caption1\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi...\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"SAVE\" , \"uri\" : \"/mqtt_save\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption2\" , \"type\" : \"ACText\" , \"value\" : \"Save parameters\" }, { \"name\" : \"start\" , \"type\" : \"ACSubmit\" , \"value\" : \"START\" , \"uri\" : \"/mqtt_start\" } ] }, { \"title\" : \"MQTT Start\" , \"uri\" : \"/mqtt_start\" , \"menu\" : true , \"element\" : [] } ] The sketch #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> AutoConnect portal; void setup () { SPIFFS.begin(); File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); SPIFFS.end(); portal.begin(); } void loop () { portal.handleClient(); } Passing parameters with sketches and custom Web pages \u00b6 A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored to the member variables of the element by AutoConnect whenever GET / POST transmission occurs. Your sketches can get these values with the GET / POST request handler. If you assign a value to an element before a request to the page occurs, its value will appear as the initial value when the page is displayed. Details are explained in the Parameter handling . window.onload = function() { Gifffer(); }; There is no overlay in the actual menu. \u21a9 The sketch is actually this: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; ACText(header, \"MQTT broker settings\" ); ACText(caption1, \"Publishing the WiFi...\" ); ACSubmit(save, \"SAVE\" , \"/mqtt_save\" ); AutoConnectAux aux1 ( \"/mqtt_setting\" , \"MQTT Setting\" , { header, caption1, save }); ACText(caption2, \"Save parameters\" ); ACSubmit(start, \"START\" , \"/mqtt_start\" ); AutoConnectAux aux2 ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, start }); AutoConnectAux aux3 ( \"/mqtt_start\" , \"MQTT Start\" ); void setup () { portal.join({ aux1, aux2, aux3 }); portal.begin(); } void loop () { portal.handleClient(); } \u21a9 Installation of the ArduinoJson as the latest release of version 5 series is required. \u21a9","title":"Custom Web pages with AutoConnect"},{"location":"acintro.html#what-it-is","text":"AutoConnect can handle custom Web pages prepared by user sketches individually. Custom Web pages are displayed in the AutoConnect menu and can be used from there. It can also have input-output parameters and handle it with sketches. For example, you can program some sketches that publish messages by entering the URI or unique ID of the MQTT broker on a custom page. You do not need to code the processing to handle the web page, it retrieves the input parameters and passes to the MQTT broker connection API is only.","title":"What it is"},{"location":"acintro.html#how-it-works","text":"Custom Web pages are dynamically created by AutoConnect. The Classes and APIs necessary for dynamic creation are provided. AutoConnectAux is an object dependent on AutoConnect, which provides an easy way to incorporate custom Web pages like the one on the right figure into AutoConnect. The elements that make up a custom web page are provided as an AutoConnectElement class. Furthermore, an input box, a check box, a submit button, etc. are implemented by classes derived from AutoConnectElement. AutoConnectAux is a container for AutoConnectElements. To make a custom Web page, create elements that make up the page and put it in the AutoConnectAux object. Joining its AutoConnectAux object to AutoConnect will integrate the custom Web page into the AutoConnect menu. The above figure shows a code sequence that declares AutoConnectElements and put in the AutoConnectAux container and integrates those into AutoConnect. It declares two text elements named ' header 'and ' caption ', adds them to the AutoConnectAux object ' aux ', binds to an AutoConnect object named ' portal '. It's the basic procedure for configuring the custom Web page. Also, further explanation of AutoConnectElements is the documentation .","title":"How it works"},{"location":"acintro.html#custom-web-pages-in-autoconnect-menu","text":"Custom Web pages as AutoConnectAux are integrated into the AutoConnect menu . AutoConnectAux object contains member variables which are URI and the title. It also has an indicator to show on the AutoConnect menu. You give the title and URI of the custom web page to the AutoConnectAux object with Sketch. Then the title of the custom Web page would be displayed at the bottom of the AutoConnect menu as the left figure. 1 It is a hyperlink as URI you given to the custom Web page and taps it will display a page composed of AutoConnectElements. Also, a title will display in the upper left corner of the page, which includes a hyperlink to the AutoConnect statistics screen.","title":"Custom Web pages in AutoConnect menu"},{"location":"acintro.html#multiple-custom-web-pages","text":"You can create multiple custom Web pages and specify which pages you can invoke from the menu. In the sketch below, it shows the sequence of codes to integrate three custom Web pages into one and embed them into the menu. In the above code, the third parameter of ' aux2 ' is false . The third parameter of the AutoConnectAux constructor is an indicator of whether it's shown to the AutoConnect menu. Right animation is the execution result of the above code. You will see that the custom Web page's menu is displayed only in the last two lines. The sketch of this animation is written to transition to ' aux2 ' by the utility of the AutoConnectSubmit element owned by ' aux1 '. 2 An ' aux2 ' page transitions only from the ' aux1 '. It is a page that saves the parameters you entered on the previous page as shown in mqttRSSI in the library example. It is to want to hide ' aux2 ' from AutoConnect menu lines. The utility of the third parameter of the AutoConnectAux constructor is that.","title":"Multiple custom Web pages"},{"location":"acintro.html#basic-steps-to-use-custom-web-pages","text":"So, the basic procedure for handling of the custom Web pages is as follows: Create or define AutoConnectAux. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() .","title":"Basic steps to use custom Web pages"},{"location":"acintro.html#write-the-custom-web-page-with-json","text":"You can write the custom Web page in JSON without using sketch codes. 3 It is possible to describe the entire page in JSON and can be described for each element also. The JSON description can be saved in SPIFFS or SD and read using AutoConnect's load function. If you take this approach, you can further reduce the steps of the above but this way consumes a lot of memory. The following JSON code and sketch will execute the custom Web page as the example in the above figure. That is, the sketch of this code and footnote 2 is equivalent. custom_page.json [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"MQTT broker settings\" }, { \"name\" : \"caption1\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi...\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"SAVE\" , \"uri\" : \"/mqtt_save\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption2\" , \"type\" : \"ACText\" , \"value\" : \"Save parameters\" }, { \"name\" : \"start\" , \"type\" : \"ACSubmit\" , \"value\" : \"START\" , \"uri\" : \"/mqtt_start\" } ] }, { \"title\" : \"MQTT Start\" , \"uri\" : \"/mqtt_start\" , \"menu\" : true , \"element\" : [] } ] The sketch #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> AutoConnect portal; void setup () { SPIFFS.begin(); File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); SPIFFS.end(); portal.begin(); } void loop () { portal.handleClient(); }","title":"Write the custom Web page with JSON"},{"location":"acintro.html#passing-parameters-with-sketches-and-custom-web-pages","text":"A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored to the member variables of the element by AutoConnect whenever GET / POST transmission occurs. Your sketches can get these values with the GET / POST request handler. If you assign a value to an element before a request to the page occurs, its value will appear as the initial value when the page is displayed. Details are explained in the Parameter handling . window.onload = function() { Gifffer(); }; There is no overlay in the actual menu. \u21a9 The sketch is actually this: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; ACText(header, \"MQTT broker settings\" ); ACText(caption1, \"Publishing the WiFi...\" ); ACSubmit(save, \"SAVE\" , \"/mqtt_save\" ); AutoConnectAux aux1 ( \"/mqtt_setting\" , \"MQTT Setting\" , { header, caption1, save }); ACText(caption2, \"Save parameters\" ); ACSubmit(start, \"START\" , \"/mqtt_start\" ); AutoConnectAux aux2 ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, start }); AutoConnectAux aux3 ( \"/mqtt_start\" , \"MQTT Start\" ); void setup () { portal.join({ aux1, aux2, aux3 }); portal.begin(); } void loop () { portal.handleClient(); } \u21a9 Installation of the ArduinoJson as the latest release of version 5 series is required. \u21a9","title":"Passing parameters with sketches and custom Web pages"},{"location":"acjson.html","text":"You can embed custom Web pages written in JSON into AutoConnect without declaring AutoConnectAux & AutoConnectElements in sketches. Custom Web page declaration in JSON can be included in the sketch in advance as the fixed string, or it can be stored in the external file such as SPIFFS for stream loading. You can also load and save AutoConnectElements objects individually. 1 By providing the following JSON document to AutoConnect, you can include the custom Web page as the bellow: A JSON document for AutoConnect can also contain declarations of multiple custom Web pages. If you fit those multiple pages in one JSON document, sketch processing for loading AutoConnectAux will degenerate further. Need ArduinoJson v5 To process the AutoConnectAux & AutoConnectElements written in the JSON is you need to install the ArduinoJson version 5 library. JSON objects & elements for the custom Web page \u00b6 JSON document structure for AutoConnectAux \u00b6 An AutoConnectAux is described by a JSON object. The elements that make up an object are as follows: { \"title\" : title, \"uri\" : uri, \"menu\" : true | false, \"element\" : element_array } title \u00b6 A title of the custom Web page. This is string value. String specified title will be displayed in the AutoConnection menu. uri \u00b6 String of URI path that specifies where to place the custom Web page. It needs to be a location from the root path including ' / '. menu \u00b6 This is a Boolean value indicating whether to include the custom Web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu. element \u00b6 Describe an array of JSON objects as element_array . It is a JSON object array of the AutoConnectElements that make up the custom Web page. Order of elements on a custom Web page The order in which AutoConnectElements are placed on a custom Web page is the order in the JSON document. Multiple custom Web pages declaration in JSON document \u00b6 You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages: [ { \"title\" : \"Page 1 title\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page2\" } ] }, { \"title\" : \"Page 1 title\" , \"uri\" : \"/page2\" , \"menu\" : false , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"Good day\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page3\" } ] }, { \"title\" : \"Page 3 title\" , \"uri\" : \"/page3\" , \"menu\" : true , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"bye\" } ] } ] JSON object for AutoConnectElements \u00b6 AutoConnectElements in JSON description are described as an array in the element with arguments of each constructor . { \"name\" : name, \"type\" : type, key_according_to_type : the_value | array_of_value, [ key_according_to_type : the_value | array_of_value ] } name \u00b6 A string of the name for the element. type \u00b6 A string of the type for the element. For this type, specify the following string corresponding to each element. AutoConnectButton: ACButton AutoConnectCheckbox: ACCheckbox AutoConnectElement: ACElement AutoConnectInput: ACInput AutoConnectRadio: ACRadio AutoConnectSelect: ACSelect AutoConnectSubmit: ACSubmit AutoConnectText: ACText key_according_to_type \u00b6 This is different for each AutoConnectElements type, and the key that can be specified by the type is determined. ACButton \u00b6 value : Specifies the button label. This value also applies to the value attribute of an HTML button tag. action : Specifies an action to be fire on a mouse click on the button. It is mostly used with a JavaScript to activate a script, or it directly describes a JavaScript. ACCheckbox \u00b6 value : Specifies the value to be supplied to the checkbox. It will be packed in the query string as name=value when the checkbox is ticked. label : Specifies a label of the checkbox. Its placement is always to the right of the checkbox. checked : Specifies checking status as a boolean value. The value of the checked checkbox element is packed in the query string and sent. ACElement \u00b6 value : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is. ACInput \u00b6 value : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string. label : Specifies a label of the input box. Its placement is always to the left of the input box. placeholder : Specifies short hint of the input box. ACRadio \u00b6 value : Specifies the collection of radio buttons as an array element. label : Specifies a label of the collection of radio buttons, not for each button. The arrangement will be the top or left side according to the arrange . arrange : Specifies the orientation of the radio buttons. Its value accepts one of the following: horizontal : Horizontal arrangement. vertical : Vertical arrangement. checked : Specifies the index number (1-based) of the radio buttons collection to be checked. ACSelect \u00b6 label : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list. option : Specifies the initial value collection of the drop-down list as an array element. ACSubmit \u00b6 value : Specifies a label of the submit button. uri : Specifies the URI to send form data when the button is clicked. ACText \u00b6 value : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style : Specifies the qualification style to give to the content and can use the style attribute format as it is. AutoConnect's JSON parsing process is not perfect It is based on ArduinoJson, but the process is simplified to save memory. As a result, even if there is an unnecessary key, it will not be an error. It is ignored. Loading JSON document \u00b6 AutoConnect supports loading of JSON document from the following instances: String PROGMEM Stream To load custom Web pages JSON document into AutoConnect, use the load function of the AutoConnect class. Its JSON document can read must be completed as a description interpretable by the ArduinoJson library. It cannot import custom Web pages if there are syntax errors for the JSON. If you can not see the custom Web page prepared by JSON, you can check the syntax with ArduinoJson Assistant . It is useful for pre-checking. bool AutoConnect :: load( const String & aux) bool AutoConnect :: load( const __FlashStringHelper * aux) bool AutoConnect :: load(Stream & aux) An example of using each function is as follows. AutoConnect portal; // Loading from String const String aux = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); portal.load(aux); // Loading from PROGMEM const char aux[] PROGMEM = R\"raw( { \"title\" : \"Page 1 title\", \"uri\" : \"/page1\", \"menu\" : true, \"element\" : [ { \"name\" : \"caption\", \"type\" : \"ACText\", \"value\" : \"hello, world\" } ] } )raw\" ; portal.load(aux); // Loading from Stream assumes \"aux.json\" file should be store in SPIFFS. File aux = SPIFFS.open( \"aux.json\" , \"r\" ); portal.load(aux); aux.close(); AutoConnect passes the given JSON document directly to the parseObject() function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory. Saving JSON document \u00b6 The sketch can persist AutoConnectElements as a JSON document and also uses this function to save the values \u200b\u200bentered on the custom Web page. And you can reload the saved JSON document into AutoConnectElements as the field in a custom Web page using the load function . Loading and saving AutoConnect parameters adopt this method. \u21a9","title":"Custom Web pages with JSON"},{"location":"acjson.html#json-objects-elements-for-the-custom-web-page","text":"","title":"JSON objects &amp; elements for the custom Web page"},{"location":"acjson.html#json-document-structure-for-autoconnectaux","text":"An AutoConnectAux is described by a JSON object. The elements that make up an object are as follows: { \"title\" : title, \"uri\" : uri, \"menu\" : true | false, \"element\" : element_array }","title":" JSON document structure for AutoConnectAux"},{"location":"acjson.html#title","text":"A title of the custom Web page. This is string value. String specified title will be displayed in the AutoConnection menu.","title":" title"},{"location":"acjson.html#uri","text":"String of URI path that specifies where to place the custom Web page. It needs to be a location from the root path including ' / '.","title":" uri"},{"location":"acjson.html#menu","text":"This is a Boolean value indicating whether to include the custom Web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu.","title":" menu"},{"location":"acjson.html#element","text":"Describe an array of JSON objects as element_array . It is a JSON object array of the AutoConnectElements that make up the custom Web page. Order of elements on a custom Web page The order in which AutoConnectElements are placed on a custom Web page is the order in the JSON document.","title":" element"},{"location":"acjson.html#multiple-custom-web-pages-declaration-in-json-document","text":"You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages: [ { \"title\" : \"Page 1 title\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page2\" } ] }, { \"title\" : \"Page 1 title\" , \"uri\" : \"/page2\" , \"menu\" : false , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"Good day\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page3\" } ] }, { \"title\" : \"Page 3 title\" , \"uri\" : \"/page3\" , \"menu\" : true , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"bye\" } ] } ]","title":" Multiple custom Web pages declaration in JSON document"},{"location":"acjson.html#json-object-for-autoconnectelements","text":"AutoConnectElements in JSON description are described as an array in the element with arguments of each constructor . { \"name\" : name, \"type\" : type, key_according_to_type : the_value | array_of_value, [ key_according_to_type : the_value | array_of_value ] }","title":" JSON object for AutoConnectElements"},{"location":"acjson.html#name","text":"A string of the name for the element.","title":" name"},{"location":"acjson.html#type","text":"A string of the type for the element. For this type, specify the following string corresponding to each element. AutoConnectButton: ACButton AutoConnectCheckbox: ACCheckbox AutoConnectElement: ACElement AutoConnectInput: ACInput AutoConnectRadio: ACRadio AutoConnectSelect: ACSelect AutoConnectSubmit: ACSubmit AutoConnectText: ACText","title":" type"},{"location":"acjson.html#key_according_to_type","text":"This is different for each AutoConnectElements type, and the key that can be specified by the type is determined.","title":" key_according_to_type"},{"location":"acjson.html#acbutton","text":"value : Specifies the button label. This value also applies to the value attribute of an HTML button tag. action : Specifies an action to be fire on a mouse click on the button. It is mostly used with a JavaScript to activate a script, or it directly describes a JavaScript.","title":" ACButton"},{"location":"acjson.html#accheckbox","text":"value : Specifies the value to be supplied to the checkbox. It will be packed in the query string as name=value when the checkbox is ticked. label : Specifies a label of the checkbox. Its placement is always to the right of the checkbox. checked : Specifies checking status as a boolean value. The value of the checked checkbox element is packed in the query string and sent.","title":" ACCheckbox"},{"location":"acjson.html#acelement","text":"value : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is.","title":" ACElement"},{"location":"acjson.html#acinput","text":"value : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string. label : Specifies a label of the input box. Its placement is always to the left of the input box. placeholder : Specifies short hint of the input box.","title":" ACInput"},{"location":"acjson.html#acradio","text":"value : Specifies the collection of radio buttons as an array element. label : Specifies a label of the collection of radio buttons, not for each button. The arrangement will be the top or left side according to the arrange . arrange : Specifies the orientation of the radio buttons. Its value accepts one of the following: horizontal : Horizontal arrangement. vertical : Vertical arrangement. checked : Specifies the index number (1-based) of the radio buttons collection to be checked.","title":" ACRadio"},{"location":"acjson.html#acselect","text":"label : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list. option : Specifies the initial value collection of the drop-down list as an array element.","title":" ACSelect"},{"location":"acjson.html#acsubmit","text":"value : Specifies a label of the submit button. uri : Specifies the URI to send form data when the button is clicked.","title":" ACSubmit"},{"location":"acjson.html#actext","text":"value : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style : Specifies the qualification style to give to the content and can use the style attribute format as it is. AutoConnect's JSON parsing process is not perfect It is based on ArduinoJson, but the process is simplified to save memory. As a result, even if there is an unnecessary key, it will not be an error. It is ignored.","title":" ACText"},{"location":"acjson.html#loading-json-document","text":"AutoConnect supports loading of JSON document from the following instances: String PROGMEM Stream To load custom Web pages JSON document into AutoConnect, use the load function of the AutoConnect class. Its JSON document can read must be completed as a description interpretable by the ArduinoJson library. It cannot import custom Web pages if there are syntax errors for the JSON. If you can not see the custom Web page prepared by JSON, you can check the syntax with ArduinoJson Assistant . It is useful for pre-checking. bool AutoConnect :: load( const String & aux) bool AutoConnect :: load( const __FlashStringHelper * aux) bool AutoConnect :: load(Stream & aux) An example of using each function is as follows. AutoConnect portal; // Loading from String const String aux = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); portal.load(aux); // Loading from PROGMEM const char aux[] PROGMEM = R\"raw( { \"title\" : \"Page 1 title\", \"uri\" : \"/page1\", \"menu\" : true, \"element\" : [ { \"name\" : \"caption\", \"type\" : \"ACText\", \"value\" : \"hello, world\" } ] } )raw\" ; portal.load(aux); // Loading from Stream assumes \"aux.json\" file should be store in SPIFFS. File aux = SPIFFS.open( \"aux.json\" , \"r\" ); portal.load(aux); aux.close(); AutoConnect passes the given JSON document directly to the parseObject() function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory.","title":"Loading JSON document"},{"location":"acjson.html#saving-json-document","text":"The sketch can persist AutoConnectElements as a JSON document and also uses this function to save the values \u200b\u200bentered on the custom Web page. And you can reload the saved JSON document into AutoConnectElements as the field in a custom Web page using the load function . Loading and saving AutoConnect parameters adopt this method. \u21a9","title":"Saving JSON document"},{"location":"advancedusage.html","text":"Advanced usage \u00b6 404 handler \u00b6 Registering the \"not found\" handler is a different way than ESP8266WebServer/WebServer. The onNotFound of ESP8266WebServer/WebServer does not work with AutoConnect. AutoConnect overrides ESP8266WebServer::onNotFound / WebServer::onNotFound to handle a captive portal. To register \"not found\" handler, use AutoConnect::onNotFound . Automatic reconnect \u00b6 When the captive portal is started, SoftAP starts and the STA is disconnected. The current SSID setting memorized in ESP8266 will be lost but then the reconnect behavior of ESP32 is somewhat different from this. The WiFiSTAClass::disconnect function implemented in the arduino-esp32 has extended parameters than the ESP8266's arduino-core. The second parameter of WiFi.disconnect on the arduino-esp32 core that does not exist in the ESP8266WiFiSTAClass has the effect of deleting the currently connected WiFi configuration and its default value is \"false\". On the ESP32 platform, even if WiFi.disconnect is executed, WiFi.begin() without the parameters in the next turn will try to connect to that AP. That is, automatic reconnection is implemented in arduino-esp32 already. Although this behavior appears seemingly competent, it is rather a disadvantage in scenes where you want to change the access point each time. When explicitly disconnecting WiFi from the Disconnect menu, AutoConnect will erase the AP connection settings saved by arduino-esp32 core. AutoConnect's automatic reconnection is a mechanism independent from the automatic reconnection of the arduino-esp32 core. If the autoReconnect option of the AutoConnectConfig class is enabled, it automatically attempts to reconnect to the disconnected past access point. When the autoReconnect option is specified, AutoConnect will not start SoftAP immediately if the first WiFi.begin fails. It will scan WiFi signal and the same connection information as the detected BSSID is stored in EEPROM as AutoConnect's credentials, explicitly apply it with WiFi.begin and rerun. AutoConnect Portal; AutoConnectConfig Config; Config.autoReconnect = true; Portal.config(Config); Portal.begin(); An autoReconnect option is available to AutoConnect::begin without SSID and pass passphrase. An autoReconnect will work if SSID detection succeeded An autoReconnect will not effect if the SSID which stored credential to be connected is a hidden access point. Auto save Credential \u00b6 By default, AutoConnect saves the credentials of the established connection in EEPROM. You can disable it with the autoSave parameter specified by AutoConnectConfig . AutoConnect Portal; AutoConnectConfig Config; Config.autoSave = AC_SAVECREDENTIAL_NEVER; Portal.config(Config); Portal.begin(); In ESP32, the credentials for AutoConnect are not in NVS The credentials used by AutoConnect are not saved in NVS on ESP32 module. ESP-IDF saves the WiFi connection configuration to NVS, but AutoConnect stores it on the EEPROM partition. You can find the partition table for default as default.csv Captive portal start detection \u00b6 The captive portal will only be activated if the first WiFi::begin fails. Sketch can detect with the AutoConnect::onDetect function that the captive portal has started. For example, the sketch can be written like as follows that turns on the LED at the start captive portal. AutoConnect Portal; bool startCP (IPAddress ip) { digitalWrite(BUILTIN_LED, HIGH); Serial.println( \"C.P. started, IP:\" + WiFi.localIP().toString()); return true; } void setup () { Serial.begin( 115200 ); pinMode(BUILTIN_LED, OUTPUT); digitalWrite(BUILTIN_LED, LOW); Portal.onDetect(startCP); if (Portal.begin()) { digitalWrite(BUILTIN_LED, LOW); } } void loop () { Portal.handleClient(); } Captive portal timeout control \u00b6 AutoConnect has two parameters for timeout control. One is a timeout value used when trying to connect to the specified AP. It behaves the same as general timeout control in connection attempt by WiFi.begin. This control is specified by the third parameter of AutoConnect::begin . Default value is macro defined by AUTOCONNECT_TIMEOUT in the AutoConnectDef.h file. The other is timeout control for the captive portal itself. It is useful when you want to continue sketch execution with offline even if the WiFi connection is not possible. You can also combine it with the immediateStart option to create sketches with high mobility. The timeout of the captive portal is specified together with AutoConnectConfig::portalTimeout as follows. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Also, if you want to stop AutoConnect completely when the captive portal is timed out, you need to call the AutoConnect::end function. It looks like the following code: bool acEnable; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); acEnable = portal.begin(); if ( ! acEnable) { portal.end(); } } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } if (acEnable) { portal.handleClient(); } } There is another option related to timeout in AutoConnectConfig. It can make use of the captive portal function even after a timeout. The AutoConnectConfig::retainPortal option will not stop the SoftAP when the captive portal is timed out. If you enable the ratainPortal option, you can try to connect to the AP at any time while continuing to sketch execution with offline even after the captive portal timed-out. The following code is its example. It can enable the captive portal after timed-out without changing sketch skeleton compared to the above code which does not specify an option. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds config.retainPortal = true; portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Cast the legacy HTML pages as the add-on menu items \u00b6 If your sketch handles web pages, you can embed the pages into the AutoConnect menu with keeping the WiFi connection feature. Unlike the custom Web pages by AutoConnectAux , this allows to legacy web pages registered by ESP8266WebServer::on or WebServer::on function. To implement embedding the your sketch web pages, use only the AutoConnectAux constructed with the URI of that page. AutoConnectElements is not required. The basic procedure for this as follows: Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu. Sketch the legacy page handlers. Register those handler functions to ESP8266WebServer/WebServer with the on function. Register AutoConnectAux declared with #1 to AutoConnect using AutoConnect::join function. It serves as a menu item. Begin the portal. Performs AutoConnect::handleClient in the loop function. For details see the Constructing the menu section of Examples page. Change menu title \u00b6 Although the default menu title is AutoConnect , you can change the title by setting AutoConnectConfig::title . To set the menu title properly, you must set before calling AutoConnect::begin . AutoConnect Portal; AutoConnectConfig Config; void setup () { // Set menu title Config.title = \"FSBrowser\" ; Portal.config(Config); Portal.begin(); } Executing the above sketch will rewrite the menu title to FSBrowser as the below. Combination with mDNS \u00b6 With mDNS library , you can access to ESP8266 by name instead of IP address after connection. The sketch can start the MDNS responder after AutoConnect::begin . #include <ESP8266WiFi.h> #include <ESP8266mDNS.h> #include <ESP8266WebServer.h> AutoConnect Portal; void setup () { if (Portal.begin()) { if (MDNS.begin( \"esp8266\" )) { MDNS.addService( \"http\" , \"tcp\" , 80 ); } } } void loop () { Portal.handleClient(); } Debug print \u00b6 You can output AutoConnect monitor messages to the Serial . A monitor message activation switch is in an include header file AutoConnectDefs.h of library source. Define AC_DEBUG macro to output the monitor messages. 1 #define AC_DEBUG Disable the captive portal \u00b6 It can also prevent the captive portal from starting even if the connection at the first WiFi.begin fails. In this case, AutoConnect::begin behaves same as WiFi.begin . For disabling the captive portal, autoRise sets to false with AutoConnectConfig . AutoConnect portal; AutoConnectConfig acConfig; acConfig.autoRaise = false; portal.config(acConfig); portal.begin(); Make SSID of SoftAP unique \u00b6 You can change SoftAP's SSID and password programmatically when the captive portal starts up. By using chip specific ID of esp8266/esp32 you can make SSID of SoftAP unique. SSID and password for SoftAP is AutoConnectConfig::apid and AutoConnectConfig::psk . AutoConnect portal; AutoConnectConfig acConfig; acConfig.apid = \"ESP-\" + String(ESP.getChipId(), HEX); acConfig.psk = YOUR_PASSWORD; portal.config(acConfig); portal.begin(); Obtaining chip ID for ESP32 acConfig.apid = \"ESP-\" + String((uint32_t)(ESP.getEfuseMac() >> 32), HEX); Move the saving area of EEPROM for the credentials \u00b6 By default, the credentials saving area is occupied from the beginning of EEPROM area. ESP8266 Arduino core document says that: The following diagram illustrates flash layout used in Arduino environment: |--------------|-------|---------------|--|--|--|--|--| ^ ^ ^ ^ ^ Sketch OTA update File system EEPROM WiFi config (SDK) and EEPROM library uses one sector of flash located just after the SPIFFS . Also, the placement of the EEPROM area of ESP32 is described in the partition table . So in the default state, the credential storage area used by AutoConnect conflicts with data owned by the user sketch. It will be destroyed together saved data in EEPROM by user sketch and AutoConnect each other. But you can move the storage area to avoid this. The boundaryOffset in AutoConnectConfig specifies the start offset of the credentials storage area. The default value is 0. On-demand start the captive portal \u00b6 If you do not usually connect to WiFi and need to establish a WiFi connection if necessary, you can combine the autoRise option with the immediateStart option to achieve on-demand connection. This behavior is similar to the WiFiManager's startConfigPortal function. In order to do this, you usually configure only with AutoConnectConfig in setup() and AutoConnect::begin() handles in loop() . AutoConnect Portal; AutoConnectConfig Config; void setup () { Config.autoRise = false; Config.immediateStart = true; Portal.config(Config); } void loop () { if (digitalRead(TRIGGER_PIN) == LOW) { while (digitalRead(TRIGGER_PIN) == LOW) yield(); Portal.begin(); } Portal.handleClient(); } The above example does not connect to WiFi until TRIGGER_PIN goes LOW. When TRIGGER_PIN goes LOW, the captive portal starts and you can connect to WiFi. Even if you reset the module, it will not automatically reconnect. Refers the hosted ESP8266WebServer/WebServer \u00b6 Constructing an AutoConnect object variable without parameters then creates and starts an ESP8266WebServer/WebServer inside the AutoConnect. This object variable could be referred by AutoConnect::host() function to access ESP8266WebServer/WebServer instance as like below. AutoConnect Portal; Portal.begin(); ESP8266WebServer & server = Portal.host(); server.send( 200 , \"text/plain\" , \"Hello, world\" ); When host() is valid The host() can be referred at after AutoConnect::begin . Usage for automatically instantiated ESP8266WebServer/WebServer \u00b6 The sketch can handle URL requests using ESP8266WebServer or WebServer that AutoConnect started internally. ESP8266WebServer/WebServer instantiated dynamically by AutoConnect can be referred to by AutoConnect::host function. The sketch can use the ' on ' function, ' send ' function, ' client ' function and others by ESP8266WebServer/WebServer reference of its return value. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect Portal; void handleRoot () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 200 , \"text/html\" , \"Hello, world\" ); } void handleNotFound () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 404 , \"text/html\" , \"Unknown.\" ); } void setup () { bool r = Portal.begin(); if (r) { ESP8266WebServer & IntServer = Portal.host(); IntServer.on( \"/\" , handleRoot); Portal.onNotFound(handleNotFound); // For only onNotFound. } } void loop () { Portal.host().handleClient(); Portal.handleRequest(); /* or following one line code is equ. Portal.handleClient(); */ } ESP8266WebServer/WebServer function should be called after AutoConnect::begin The sketch cannot refer to an instance of ESP8266WebServer/WebServer until AutoConnect::begin completes successfully. Do not use with ESP8266WebServer::begin or WebServer::begin ESP8266WebServer/WebServer is already running inside the AutoConnect. Use with the PageBuilder library \u00b6 In ordinary, the URL handler will respond the request by sending some HTML. PageBuilder library is HTML assembly aid. it can handle predefined HTML as like a template and simplify an HTML string assemble logic, and also the generated HTML send automatically. An example sketch used with the PageBuilder as follows and it explains how it aids for the HTML generating. Details for Github repository . Configuration functions \u00b6 Configuration for Soft AP and captive portal \u00b6 AutoConnect will activate SoftAP at failed the first WiFi.begin . It SoftAP settings are stored in AutoConnectConfig as the following parameters. The sketch could be configured SoftAP using these parameters, refer the AutoConnectConfig API for details. IP address of SoftAP activated. Gateway IP address. Subnet mask. SSID for SoftAP. Password for SoftAP. Channel. SoftAP name. Hidden attribute. Auto save credential. Offset address of the credentials storage area in EEPROM. Captive portal time out limit. Retains the portal function after time out. Length of start up time after reset. Automatic starting the captive portal. Start the captive portal forcefully. Auto reset after connection establishment. Home URL of the user sketch application. AutoConnect::config before AutoConnect::begin AutoConnect::config must be executed before AutoConnect::begin . Assign user sketch's home path \u00b6 \" HOME \" for returning to the user's sketch homepage is displayed at the bottom of the AutoConnect menu. It could be set using the AutoConnect::home function. Relocate the AutoConnect home path \u00b6 A home path of AutoConnect is /_ac by default. You can access from the browser with http://IPADDRESS/_ac. You can change the home path by revising AUTOCONNECT_URI macro in the include header file as AutoConnect.h . #define AUTOCONNECT_URI \"/_ac\" Static IP assignment 2 \u00b6 It is also possible to assign static IP Address to ESP8266/ESP32 in STA mode. By default DHCP is enabled and it becomes the IP address assigned by the DHCP server with WiFi.begin . To assign a static IP to ESP8266/ESP32 with WIFI_MODE_STA, the following parameters are required: IP address. Gateway address. Subnet mask. Primary DNS server. Secondary DNS server. (optional) The above parameters must be executed before AutoConnect::begin as arguments of AutoConnectConfig . AutoConnect portal; AutoConnectConfig Config; Config.staip = IPAddress( 192 , 168 , 1 , 10 ); Config.staGateway = IPAddress( 192 , 168 , 1 , 1 ); Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); Config.dns1 = IPAddress( 192 , 168 , 1 , 1 ); portal.config(Config); portal.begin(); Station host name \u00b6 The source code placement of common macros for AutoConnect since v0.9.7 has changed. \u21a9 Static IP address assignment is available from version 0.9.3. \u21a9","title":"Advanced usage"},{"location":"advancedusage.html#advanced-usage","text":"","title":"Advanced usage"},{"location":"advancedusage.html#404-handler","text":"Registering the \"not found\" handler is a different way than ESP8266WebServer/WebServer. The onNotFound of ESP8266WebServer/WebServer does not work with AutoConnect. AutoConnect overrides ESP8266WebServer::onNotFound / WebServer::onNotFound to handle a captive portal. To register \"not found\" handler, use AutoConnect::onNotFound .","title":" 404 handler"},{"location":"advancedusage.html#automatic-reconnect","text":"When the captive portal is started, SoftAP starts and the STA is disconnected. The current SSID setting memorized in ESP8266 will be lost but then the reconnect behavior of ESP32 is somewhat different from this. The WiFiSTAClass::disconnect function implemented in the arduino-esp32 has extended parameters than the ESP8266's arduino-core. The second parameter of WiFi.disconnect on the arduino-esp32 core that does not exist in the ESP8266WiFiSTAClass has the effect of deleting the currently connected WiFi configuration and its default value is \"false\". On the ESP32 platform, even if WiFi.disconnect is executed, WiFi.begin() without the parameters in the next turn will try to connect to that AP. That is, automatic reconnection is implemented in arduino-esp32 already. Although this behavior appears seemingly competent, it is rather a disadvantage in scenes where you want to change the access point each time. When explicitly disconnecting WiFi from the Disconnect menu, AutoConnect will erase the AP connection settings saved by arduino-esp32 core. AutoConnect's automatic reconnection is a mechanism independent from the automatic reconnection of the arduino-esp32 core. If the autoReconnect option of the AutoConnectConfig class is enabled, it automatically attempts to reconnect to the disconnected past access point. When the autoReconnect option is specified, AutoConnect will not start SoftAP immediately if the first WiFi.begin fails. It will scan WiFi signal and the same connection information as the detected BSSID is stored in EEPROM as AutoConnect's credentials, explicitly apply it with WiFi.begin and rerun. AutoConnect Portal; AutoConnectConfig Config; Config.autoReconnect = true; Portal.config(Config); Portal.begin(); An autoReconnect option is available to AutoConnect::begin without SSID and pass passphrase. An autoReconnect will work if SSID detection succeeded An autoReconnect will not effect if the SSID which stored credential to be connected is a hidden access point.","title":" Automatic reconnect"},{"location":"advancedusage.html#auto-save-credential","text":"By default, AutoConnect saves the credentials of the established connection in EEPROM. You can disable it with the autoSave parameter specified by AutoConnectConfig . AutoConnect Portal; AutoConnectConfig Config; Config.autoSave = AC_SAVECREDENTIAL_NEVER; Portal.config(Config); Portal.begin(); In ESP32, the credentials for AutoConnect are not in NVS The credentials used by AutoConnect are not saved in NVS on ESP32 module. ESP-IDF saves the WiFi connection configuration to NVS, but AutoConnect stores it on the EEPROM partition. You can find the partition table for default as default.csv","title":" Auto save Credential"},{"location":"advancedusage.html#captive-portal-start-detection","text":"The captive portal will only be activated if the first WiFi::begin fails. Sketch can detect with the AutoConnect::onDetect function that the captive portal has started. For example, the sketch can be written like as follows that turns on the LED at the start captive portal. AutoConnect Portal; bool startCP (IPAddress ip) { digitalWrite(BUILTIN_LED, HIGH); Serial.println( \"C.P. started, IP:\" + WiFi.localIP().toString()); return true; } void setup () { Serial.begin( 115200 ); pinMode(BUILTIN_LED, OUTPUT); digitalWrite(BUILTIN_LED, LOW); Portal.onDetect(startCP); if (Portal.begin()) { digitalWrite(BUILTIN_LED, LOW); } } void loop () { Portal.handleClient(); }","title":" Captive portal start detection"},{"location":"advancedusage.html#captive-portal-timeout-control","text":"AutoConnect has two parameters for timeout control. One is a timeout value used when trying to connect to the specified AP. It behaves the same as general timeout control in connection attempt by WiFi.begin. This control is specified by the third parameter of AutoConnect::begin . Default value is macro defined by AUTOCONNECT_TIMEOUT in the AutoConnectDef.h file. The other is timeout control for the captive portal itself. It is useful when you want to continue sketch execution with offline even if the WiFi connection is not possible. You can also combine it with the immediateStart option to create sketches with high mobility. The timeout of the captive portal is specified together with AutoConnectConfig::portalTimeout as follows. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Also, if you want to stop AutoConnect completely when the captive portal is timed out, you need to call the AutoConnect::end function. It looks like the following code: bool acEnable; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); acEnable = portal.begin(); if ( ! acEnable) { portal.end(); } } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } if (acEnable) { portal.handleClient(); } } There is another option related to timeout in AutoConnectConfig. It can make use of the captive portal function even after a timeout. The AutoConnectConfig::retainPortal option will not stop the SoftAP when the captive portal is timed out. If you enable the ratainPortal option, you can try to connect to the AP at any time while continuing to sketch execution with offline even after the captive portal timed-out. The following code is its example. It can enable the captive portal after timed-out without changing sketch skeleton compared to the above code which does not specify an option. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds config.retainPortal = true; portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); }","title":" Captive portal timeout control"},{"location":"advancedusage.html#cast-the-legacy-html-pages-as-the-add-on-menu-items","text":"If your sketch handles web pages, you can embed the pages into the AutoConnect menu with keeping the WiFi connection feature. Unlike the custom Web pages by AutoConnectAux , this allows to legacy web pages registered by ESP8266WebServer::on or WebServer::on function. To implement embedding the your sketch web pages, use only the AutoConnectAux constructed with the URI of that page. AutoConnectElements is not required. The basic procedure for this as follows: Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu. Sketch the legacy page handlers. Register those handler functions to ESP8266WebServer/WebServer with the on function. Register AutoConnectAux declared with #1 to AutoConnect using AutoConnect::join function. It serves as a menu item. Begin the portal. Performs AutoConnect::handleClient in the loop function. For details see the Constructing the menu section of Examples page.","title":" Cast the legacy HTML pages as the add-on menu items"},{"location":"advancedusage.html#change-menu-title","text":"Although the default menu title is AutoConnect , you can change the title by setting AutoConnectConfig::title . To set the menu title properly, you must set before calling AutoConnect::begin . AutoConnect Portal; AutoConnectConfig Config; void setup () { // Set menu title Config.title = \"FSBrowser\" ; Portal.config(Config); Portal.begin(); } Executing the above sketch will rewrite the menu title to FSBrowser as the below.","title":" Change menu title"},{"location":"advancedusage.html#combination-with-mdns","text":"With mDNS library , you can access to ESP8266 by name instead of IP address after connection. The sketch can start the MDNS responder after AutoConnect::begin . #include <ESP8266WiFi.h> #include <ESP8266mDNS.h> #include <ESP8266WebServer.h> AutoConnect Portal; void setup () { if (Portal.begin()) { if (MDNS.begin( \"esp8266\" )) { MDNS.addService( \"http\" , \"tcp\" , 80 ); } } } void loop () { Portal.handleClient(); }","title":" Combination with mDNS"},{"location":"advancedusage.html#debug-print","text":"You can output AutoConnect monitor messages to the Serial . A monitor message activation switch is in an include header file AutoConnectDefs.h of library source. Define AC_DEBUG macro to output the monitor messages. 1 #define AC_DEBUG","title":" Debug print"},{"location":"advancedusage.html#disable-the-captive-portal","text":"It can also prevent the captive portal from starting even if the connection at the first WiFi.begin fails. In this case, AutoConnect::begin behaves same as WiFi.begin . For disabling the captive portal, autoRise sets to false with AutoConnectConfig . AutoConnect portal; AutoConnectConfig acConfig; acConfig.autoRaise = false; portal.config(acConfig); portal.begin();","title":" Disable the captive portal"},{"location":"advancedusage.html#make-ssid-of-softap-unique","text":"You can change SoftAP's SSID and password programmatically when the captive portal starts up. By using chip specific ID of esp8266/esp32 you can make SSID of SoftAP unique. SSID and password for SoftAP is AutoConnectConfig::apid and AutoConnectConfig::psk . AutoConnect portal; AutoConnectConfig acConfig; acConfig.apid = \"ESP-\" + String(ESP.getChipId(), HEX); acConfig.psk = YOUR_PASSWORD; portal.config(acConfig); portal.begin(); Obtaining chip ID for ESP32 acConfig.apid = \"ESP-\" + String((uint32_t)(ESP.getEfuseMac() >> 32), HEX);","title":" Make SSID of SoftAP unique"},{"location":"advancedusage.html#move-the-saving-area-of-eeprom-for-the-credentials","text":"By default, the credentials saving area is occupied from the beginning of EEPROM area. ESP8266 Arduino core document says that: The following diagram illustrates flash layout used in Arduino environment: |--------------|-------|---------------|--|--|--|--|--| ^ ^ ^ ^ ^ Sketch OTA update File system EEPROM WiFi config (SDK) and EEPROM library uses one sector of flash located just after the SPIFFS . Also, the placement of the EEPROM area of ESP32 is described in the partition table . So in the default state, the credential storage area used by AutoConnect conflicts with data owned by the user sketch. It will be destroyed together saved data in EEPROM by user sketch and AutoConnect each other. But you can move the storage area to avoid this. The boundaryOffset in AutoConnectConfig specifies the start offset of the credentials storage area. The default value is 0.","title":" Move the saving area of EEPROM for the credentials"},{"location":"advancedusage.html#on-demand-start-the-captive-portal","text":"If you do not usually connect to WiFi and need to establish a WiFi connection if necessary, you can combine the autoRise option with the immediateStart option to achieve on-demand connection. This behavior is similar to the WiFiManager's startConfigPortal function. In order to do this, you usually configure only with AutoConnectConfig in setup() and AutoConnect::begin() handles in loop() . AutoConnect Portal; AutoConnectConfig Config; void setup () { Config.autoRise = false; Config.immediateStart = true; Portal.config(Config); } void loop () { if (digitalRead(TRIGGER_PIN) == LOW) { while (digitalRead(TRIGGER_PIN) == LOW) yield(); Portal.begin(); } Portal.handleClient(); } The above example does not connect to WiFi until TRIGGER_PIN goes LOW. When TRIGGER_PIN goes LOW, the captive portal starts and you can connect to WiFi. Even if you reset the module, it will not automatically reconnect.","title":" On-demand start the captive portal"},{"location":"advancedusage.html#refers-the-hosted-esp8266webserverwebserver","text":"Constructing an AutoConnect object variable without parameters then creates and starts an ESP8266WebServer/WebServer inside the AutoConnect. This object variable could be referred by AutoConnect::host() function to access ESP8266WebServer/WebServer instance as like below. AutoConnect Portal; Portal.begin(); ESP8266WebServer & server = Portal.host(); server.send( 200 , \"text/plain\" , \"Hello, world\" ); When host() is valid The host() can be referred at after AutoConnect::begin .","title":" Refers the hosted ESP8266WebServer/WebServer"},{"location":"advancedusage.html#usage-for-automatically-instantiated-esp8266webserverwebserver","text":"The sketch can handle URL requests using ESP8266WebServer or WebServer that AutoConnect started internally. ESP8266WebServer/WebServer instantiated dynamically by AutoConnect can be referred to by AutoConnect::host function. The sketch can use the ' on ' function, ' send ' function, ' client ' function and others by ESP8266WebServer/WebServer reference of its return value. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect Portal; void handleRoot () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 200 , \"text/html\" , \"Hello, world\" ); } void handleNotFound () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 404 , \"text/html\" , \"Unknown.\" ); } void setup () { bool r = Portal.begin(); if (r) { ESP8266WebServer & IntServer = Portal.host(); IntServer.on( \"/\" , handleRoot); Portal.onNotFound(handleNotFound); // For only onNotFound. } } void loop () { Portal.host().handleClient(); Portal.handleRequest(); /* or following one line code is equ. Portal.handleClient(); */ } ESP8266WebServer/WebServer function should be called after AutoConnect::begin The sketch cannot refer to an instance of ESP8266WebServer/WebServer until AutoConnect::begin completes successfully. Do not use with ESP8266WebServer::begin or WebServer::begin ESP8266WebServer/WebServer is already running inside the AutoConnect.","title":" Usage for automatically instantiated ESP8266WebServer/WebServer"},{"location":"advancedusage.html#use-with-the-pagebuilder-library","text":"In ordinary, the URL handler will respond the request by sending some HTML. PageBuilder library is HTML assembly aid. it can handle predefined HTML as like a template and simplify an HTML string assemble logic, and also the generated HTML send automatically. An example sketch used with the PageBuilder as follows and it explains how it aids for the HTML generating. Details for Github repository .","title":" Use with the PageBuilder library"},{"location":"advancedusage.html#configuration-functions","text":"","title":"Configuration functions"},{"location":"advancedusage.html#configuration-for-soft-ap-and-captive-portal","text":"AutoConnect will activate SoftAP at failed the first WiFi.begin . It SoftAP settings are stored in AutoConnectConfig as the following parameters. The sketch could be configured SoftAP using these parameters, refer the AutoConnectConfig API for details. IP address of SoftAP activated. Gateway IP address. Subnet mask. SSID for SoftAP. Password for SoftAP. Channel. SoftAP name. Hidden attribute. Auto save credential. Offset address of the credentials storage area in EEPROM. Captive portal time out limit. Retains the portal function after time out. Length of start up time after reset. Automatic starting the captive portal. Start the captive portal forcefully. Auto reset after connection establishment. Home URL of the user sketch application. AutoConnect::config before AutoConnect::begin AutoConnect::config must be executed before AutoConnect::begin .","title":" Configuration for Soft AP and captive portal"},{"location":"advancedusage.html#assign-user-sketchs-home-path","text":"\" HOME \" for returning to the user's sketch homepage is displayed at the bottom of the AutoConnect menu. It could be set using the AutoConnect::home function.","title":" Assign user sketch's home path"},{"location":"advancedusage.html#relocate-the-autoconnect-home-path","text":"A home path of AutoConnect is /_ac by default. You can access from the browser with http://IPADDRESS/_ac. You can change the home path by revising AUTOCONNECT_URI macro in the include header file as AutoConnect.h . #define AUTOCONNECT_URI \"/_ac\"","title":" Relocate the AutoConnect home path"},{"location":"advancedusage.html#static-ip-assignment-2","text":"It is also possible to assign static IP Address to ESP8266/ESP32 in STA mode. By default DHCP is enabled and it becomes the IP address assigned by the DHCP server with WiFi.begin . To assign a static IP to ESP8266/ESP32 with WIFI_MODE_STA, the following parameters are required: IP address. Gateway address. Subnet mask. Primary DNS server. Secondary DNS server. (optional) The above parameters must be executed before AutoConnect::begin as arguments of AutoConnectConfig . AutoConnect portal; AutoConnectConfig Config; Config.staip = IPAddress( 192 , 168 , 1 , 10 ); Config.staGateway = IPAddress( 192 , 168 , 1 , 1 ); Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); Config.dns1 = IPAddress( 192 , 168 , 1 , 1 ); portal.config(Config); portal.begin();","title":" Static IP assignment 2"},{"location":"advancedusage.html#station-host-name","text":"The source code placement of common macros for AutoConnect since v0.9.7 has changed. \u21a9 Static IP address assignment is available from version 0.9.3. \u21a9","title":" Station host name"},{"location":"api.html","text":"Include headers \u00b6 AutoConnect.h \u00b6 #include <AutoConnect.h> Defined macros \u00b6 They contain in AutoConnectDefs.h . #define AC_DEBUG // Monitor message output activation #define AC_DEBUG_PORT Serial // Default message output device #define AUTOCONNECT_AP_IP 0x01F4A8C0 // Default SoftAP IP #define AUTOCONNECT_AP_GW 0x01F4A8C0 // Default SoftAP Gateway IP #define AUTOCONNECT_AP_NM 0x00FFFFFF // Default subnet mask #define AUTOCONNECT_DNSPORT 53 // Default DNS port at captive portal #define AUTOCONNECT_HTTPPORT 80 // Default HTTP #define AUTOCONNECT_MENU_TITLE \"AutoConnect\" // Default AutoConnect menu title #define AUTOCONNECT_STARTUPTIME 10 // Default waiting time[s] for after reset #define AUTOCONNECT_URI \"/_ac\" // Default AutoConnect root path #define AUTOCONNECT_TIMEOUT 30000 // Default connection timeout[ms] #define AUTOCONNECT_CAPTIVEPORTAL_TIMEOUT 0 // Captive portal timeout value #define AUTOCONNECT_USE_JSON // Allow AutoConnect elements to be handled by JSON format Macros placement moved Source code placement of the above macros provided for user sketch changed from v0.9.7. The new code is in AutoConnectDefs.h . Constructors \u00b6 AutoConnect \u00b6 AutoConnect() AutoConnect default constructor. This entry internally allocates the ESP8266WebServer for ESP8266 or WebServer for ESP32 and is activated internally. For ESP8266 AutoConnect(ESP8266WebServer & webServer) For ESP32 AutoConnect(WebServer & webServer) Run the AutoConnect site using the externally ensured ESP8266WebServer for ESP8266 or WebServer for ESP32. The handleClient function of AutoConnect can include the response of the URI handler added by the user using the \" on \" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the host function. Parameters webServer A reference of ESP8266WebServer or WebServer instance. Public member functions \u00b6 aux \u00b6 AutoConnectAux * aux( const String & uri) const Returns a pointer to AutoConnectAux with the URI specified by uri . If AutoConnectAux with that URI is not bound, it returns nullptr . Parameters uri A string of the URI. Return value A Pointer of the AutoConnectAux instance. begin \u00b6 bool begin() bool begin( const char * ssid, const char * passphrase) bool begin( const char * ssid, const char * passphrase, unsigned long timeout) Starts establishing the WiFi connection. The WiFi mode at this time is WIFI_STA. AutoConnect first invokes WiFi.begin . If the ssid and the passphrase are missing, its WiFi.begin has no SSID and Password. Regardless of the result, ESP8266WebServer/WebServer will start immediately after the first WiFi.begin . The captive portal will not be started if the connection has been established with first WiFi.begin . If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts. Parameters ssid SSID to be connected. passphrase Password for connection. timeout A time out value in milliseconds for waiting connection. Return value true Connection established, AutoConnect service started with WIFI_STA mode. false Could not connected, Captive portal started with WIFI_AP_STA mode. config \u00b6 bool config(AutoConnectConfig & config) bool config( const char * ap, const char * password = nullptr ) Set SoftAP's WiFi configuration and static IP configuration. Parameters config Reference to AutoConnectConfig containing SoftAP's parameters and static IP parameters. ap SSID for SoftAP. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The default value is 12345678 . Return value true Successfully configured. false Configuration parameter is invalid, some values out of range. end \u00b6 void end() Stops AutoConnect captive portal service. Release ESP8266WebServer/WebServer and DNSServer. Attention to end The end function releases the instance of ESP8266WebServer/WebServer and DNSServer. It can not process them after the end function. handleClient \u00b6 void handleClient() Process the AutoConnect menu interface. The handleClient() function of the ESP8266WebServer/WebServer hosted by AutoConnect is also called from within AutoConnect, and the client request handlers contained in the user sketch are also handled. handleRequest \u00b6 void handleRequest() Handling for the AutoConnect menu request. About used in combination with handleClient The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient. home \u00b6 void home(String & uri) Put a user site's home URI. The URI specified by home is linked from \"HOME\" in the AutoConnect menu. Parameters uri A URI string of user site's home path. host \u00b6 For ESP8266 ESP8266WebServer & host() For ESP32 WebServer & host() Returns the reference of the ESP8266WebServer/WebServer which is allocated in AutoConnect automatically. Return value A reference of the ESP8266WebServer/WebServer. &reference is not a pointer A reference cannot be re-assigned, and must be assigned at initialization. It's like as bind as alias. ESP8266WebServer & server = portal.host(); server.handleClient(); or portal.host().handleClient(); join \u00b6 void join(AutoConnectAux & aux) void join(std :: vector < std :: reference_wrapper < AutoConnectAux >> aux) Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu. Parameters aux Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with list initialization . load \u00b6 bool load( const String & aux) bool load( const __FlashStringHelper * aux) bool load(Stream & aux) Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned. Parameters aux The input string to be loaded. Return value true The JSON document as AutoConnectAux successfully loaded. false Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the ArduinoJson Assistant . on \u00b6 bool on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters uri A string of the URI assigned to the AutoConnectAux page. handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. It is not ESP8266WebServer::on, not WebServer::on for ESP32. This function effects to AutoConnectAux only. However, it coexists with that of ESP8266WebServer::on or WebServer::on of ESP32. onDetect \u00b6 void onDetect(DetectExit_ft fn) Register the function which will call from AutoConnect at the start of the captive portal. Parameters fn Function called at the captive portal start. An fn specifies the function called when the captive portal starts. Its prototype declaration is defined as \" DetectExit_ft \". typedef std :: function < bool (IPAddress softapIP) > DetectExit_ft Parameters softapIP An IP address of SoftAP for the captive portal. Retuen value true Continues captive portal handling. false Cancel the captive portal. AutoConnect::begin function will return with a false. onNotFound \u00b6 For ESP8266 void onNotFound(ESP8266WebServer :: THandlerFunction fn) For ESP32 void onNotFound(WebServer :: THandlerFunction fn) Register the handler function for undefined URL request detected. Parameters fn A function of the \"not found\" handler. where \u00b6 AutoConenctAux * where( void ) Returns a pointer to the AutoConnectAux object of the custom Web page that caused the request to that page. This function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/ESP32. In other words, this function only returns the last AutoConnecAux page called. Retuen value A pointer to the AutoConnectAux that caused the request the page.","title":"AutoConnect API"},{"location":"api.html#include-headers","text":"","title":" Include headers"},{"location":"api.html#autoconnecth","text":"#include <AutoConnect.h>","title":"AutoConnect.h"},{"location":"api.html#defined-macros","text":"They contain in AutoConnectDefs.h . #define AC_DEBUG // Monitor message output activation #define AC_DEBUG_PORT Serial // Default message output device #define AUTOCONNECT_AP_IP 0x01F4A8C0 // Default SoftAP IP #define AUTOCONNECT_AP_GW 0x01F4A8C0 // Default SoftAP Gateway IP #define AUTOCONNECT_AP_NM 0x00FFFFFF // Default subnet mask #define AUTOCONNECT_DNSPORT 53 // Default DNS port at captive portal #define AUTOCONNECT_HTTPPORT 80 // Default HTTP #define AUTOCONNECT_MENU_TITLE \"AutoConnect\" // Default AutoConnect menu title #define AUTOCONNECT_STARTUPTIME 10 // Default waiting time[s] for after reset #define AUTOCONNECT_URI \"/_ac\" // Default AutoConnect root path #define AUTOCONNECT_TIMEOUT 30000 // Default connection timeout[ms] #define AUTOCONNECT_CAPTIVEPORTAL_TIMEOUT 0 // Captive portal timeout value #define AUTOCONNECT_USE_JSON // Allow AutoConnect elements to be handled by JSON format Macros placement moved Source code placement of the above macros provided for user sketch changed from v0.9.7. The new code is in AutoConnectDefs.h .","title":" Defined macros"},{"location":"api.html#constructors","text":"","title":" Constructors"},{"location":"api.html#autoconnect","text":"AutoConnect() AutoConnect default constructor. This entry internally allocates the ESP8266WebServer for ESP8266 or WebServer for ESP32 and is activated internally. For ESP8266 AutoConnect(ESP8266WebServer & webServer) For ESP32 AutoConnect(WebServer & webServer) Run the AutoConnect site using the externally ensured ESP8266WebServer for ESP8266 or WebServer for ESP32. The handleClient function of AutoConnect can include the response of the URI handler added by the user using the \" on \" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the host function. Parameters webServer A reference of ESP8266WebServer or WebServer instance.","title":"AutoConnect"},{"location":"api.html#public-member-functions","text":"","title":" Public member functions"},{"location":"api.html#aux","text":"AutoConnectAux * aux( const String & uri) const Returns a pointer to AutoConnectAux with the URI specified by uri . If AutoConnectAux with that URI is not bound, it returns nullptr . Parameters uri A string of the URI. Return value A Pointer of the AutoConnectAux instance.","title":" aux"},{"location":"api.html#begin","text":"bool begin() bool begin( const char * ssid, const char * passphrase) bool begin( const char * ssid, const char * passphrase, unsigned long timeout) Starts establishing the WiFi connection. The WiFi mode at this time is WIFI_STA. AutoConnect first invokes WiFi.begin . If the ssid and the passphrase are missing, its WiFi.begin has no SSID and Password. Regardless of the result, ESP8266WebServer/WebServer will start immediately after the first WiFi.begin . The captive portal will not be started if the connection has been established with first WiFi.begin . If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts. Parameters ssid SSID to be connected. passphrase Password for connection. timeout A time out value in milliseconds for waiting connection. Return value true Connection established, AutoConnect service started with WIFI_STA mode. false Could not connected, Captive portal started with WIFI_AP_STA mode.","title":" begin"},{"location":"api.html#config","text":"bool config(AutoConnectConfig & config) bool config( const char * ap, const char * password = nullptr ) Set SoftAP's WiFi configuration and static IP configuration. Parameters config Reference to AutoConnectConfig containing SoftAP's parameters and static IP parameters. ap SSID for SoftAP. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The default value is 12345678 . Return value true Successfully configured. false Configuration parameter is invalid, some values out of range.","title":" config"},{"location":"api.html#end","text":"void end() Stops AutoConnect captive portal service. Release ESP8266WebServer/WebServer and DNSServer. Attention to end The end function releases the instance of ESP8266WebServer/WebServer and DNSServer. It can not process them after the end function.","title":" end"},{"location":"api.html#handleclient","text":"void handleClient() Process the AutoConnect menu interface. The handleClient() function of the ESP8266WebServer/WebServer hosted by AutoConnect is also called from within AutoConnect, and the client request handlers contained in the user sketch are also handled.","title":" handleClient"},{"location":"api.html#handlerequest","text":"void handleRequest() Handling for the AutoConnect menu request. About used in combination with handleClient The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient.","title":" handleRequest"},{"location":"api.html#home","text":"void home(String & uri) Put a user site's home URI. The URI specified by home is linked from \"HOME\" in the AutoConnect menu. Parameters uri A URI string of user site's home path.","title":" home"},{"location":"api.html#host","text":"For ESP8266 ESP8266WebServer & host() For ESP32 WebServer & host() Returns the reference of the ESP8266WebServer/WebServer which is allocated in AutoConnect automatically. Return value A reference of the ESP8266WebServer/WebServer. &reference is not a pointer A reference cannot be re-assigned, and must be assigned at initialization. It's like as bind as alias. ESP8266WebServer & server = portal.host(); server.handleClient(); or portal.host().handleClient();","title":" host"},{"location":"api.html#join","text":"void join(AutoConnectAux & aux) void join(std :: vector < std :: reference_wrapper < AutoConnectAux >> aux) Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu. Parameters aux Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with list initialization .","title":" join"},{"location":"api.html#load","text":"bool load( const String & aux) bool load( const __FlashStringHelper * aux) bool load(Stream & aux) Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned. Parameters aux The input string to be loaded. Return value true The JSON document as AutoConnectAux successfully loaded. false Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the ArduinoJson Assistant .","title":" load"},{"location":"api.html#on","text":"bool on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters uri A string of the URI assigned to the AutoConnectAux page. handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. It is not ESP8266WebServer::on, not WebServer::on for ESP32. This function effects to AutoConnectAux only. However, it coexists with that of ESP8266WebServer::on or WebServer::on of ESP32.","title":" on"},{"location":"api.html#ondetect","text":"void onDetect(DetectExit_ft fn) Register the function which will call from AutoConnect at the start of the captive portal. Parameters fn Function called at the captive portal start. An fn specifies the function called when the captive portal starts. Its prototype declaration is defined as \" DetectExit_ft \". typedef std :: function < bool (IPAddress softapIP) > DetectExit_ft Parameters softapIP An IP address of SoftAP for the captive portal. Retuen value true Continues captive portal handling. false Cancel the captive portal. AutoConnect::begin function will return with a false.","title":" onDetect"},{"location":"api.html#onnotfound","text":"For ESP8266 void onNotFound(ESP8266WebServer :: THandlerFunction fn) For ESP32 void onNotFound(WebServer :: THandlerFunction fn) Register the handler function for undefined URL request detected. Parameters fn A function of the \"not found\" handler.","title":" onNotFound"},{"location":"api.html#where","text":"AutoConenctAux * where( void ) Returns a pointer to the AutoConnectAux object of the custom Web page that caused the request to that page. This function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/ESP32. In other words, this function only returns the last AutoConnecAux page called. Retuen value A pointer to the AutoConnectAux that caused the request the page.","title":" where"},{"location":"apiaux.html","text":"Constructor \u00b6 AutoConnectAux \u00b6 AutoConnectAux( const String & uri = String( \"\" ), const String & title = String( \"\" ), const bool menu = true, const AutoConnectElementVT addons = AutoConnectElementVT()) Parameters uri URI of this custom Web Page. title Page title of this custom Web page. It will appear on the auto connection menu and at the top of that page. menu Specifies whether to display this page on menu. addons Reference to AutoConnectElement collection. Public member functions \u00b6 add \u00b6 void add(AutoConnectElement & addon) void add(AutoConnectElementVT addons) Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu. Parameters addon Reference of AutoConnectElements. Specifies one of the AutoConnectElements classes. addons An array list of reference of AutoConnectElements. An list initialization of the std::vector can be used for the addons parameter cause the actual definition of type AutoConnectElementVT is std::vector<std::reference_wrapper<AutoConnectElement>> . getElement \u00b6 T & getElement < T > ( const String & name) AutoConnectElement * getElement( const String & name) Get a registered AutoConnectElement as specified name. If T is specified as an actual type of AutoConnectElements, it returns a reference to that instance. Parameters T Actual type name of AutoConnectElements as AutoConnectButton , AutoConnectCheckbox , AutoConnectElement , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectSubmit , AutoConnectText . name Name of the AutoConnectElements to be retrieved. Return value A reference of the AutoConnectElements. If a type is not specified returns a pointer. getElements \u00b6 AutoConnectElementVT & getElements( void ) Get vector of reference of all elements. Return value A reference to std::vector of reference to AutoConnecctElements. The getElements returns a reference to std::vector of reference to AutoConnecctElements. This function is provided to handle AutoConnectElemets owned by AutoConnectAux in bulk, and you can use each method of std::vector for a return value. // An example of getting type and name of all AutoConnectElements registered in AutoConnectAux. AutoConnectAux aux; // some code here... AutoConnectElementVt & elements = aux.getElements(); for (AutoConnectElement & elm : elements) { Serial.printf( \"name<%s> as type %d \\n \" , elm.name.c_str(), ( int )elm.typeOf()); } load \u00b6 bool load( const String & in) bool load( const __FlashStringHelper * in) bool load(Stream & in) Load all AutoConnectElements elements from JSON document into AutoConnectAux as custom Web pages. The JSON document specified by the load function must be the document structure of AutoConnectAux. Its JSON document can describe multiple pages as an array. Parameters in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. Return value true JSON document as the custom Web pages successfully loaded. false JSON document loading failed. Load multiple custom Web pages separately Multiple custom Web pages can be loaded at once with JSON as an array. But it will consume a lot of memory. By loading a JSON document by page as much as possible, you can reduce memory consumption. loadElement \u00b6 bool loadElement( const String & in, const String & name = String( \"\" )) bool loadElement( const __FlashStringHelper * in, const String & name = String( \"\" )) bool loadElement(Stream & in, const String & name = String( \"\" )) Load specified element from JSON document into AutoConnectAux. The JSON document specified by the loadElement function must be the AutoConnectElement document structure . When loading from a JSON document that describes multiple elements, its description must be an array syntax. Parameters in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. name Specifies the name to be load. If the name is not specified, the loadElement function will load all elements contained in the JSON document. Return value true Specified AutoConnectElements successfully loaded. false JSON document loading failed. Maybe it is an array Please note that the JSON document that is the input for loadElement is an array syntax of AutoConnectElements when there are multiple elements. For example, the following JSON document has a syntax error: { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"value\" : \"Hello, world\" } , { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" } The outermost [ , ] is missing. menu \u00b6 void menu( const bool post) Set or reset the display as menu item for this AutoConnectAux. This function programmatically manipulates the menu parameter of the AutoConenctAux constructor . Parameters true Show on the menu. false Hidden on the menu. on \u00b6 void on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. release \u00b6 bool release( const String & name) Release a specified AutoConnectElement from AutoConenctAux. The release function is provided to dynamically change the structure of the custom Web pages with the sketch. By combining the release function and the add function or the loadElement function, the sketch can change the style of the custom Web page according to its behavior. Parameters name Specifies the name of AutoConnectElements to be released. Return value true The AutoConnectElement successfully released. false The AutoConnectElement can not be released. saveElement \u00b6 size_t saveElement(Stream & out, std :: vector < String > const & names = {}) Write elements of AutoConnectAux to the stream. The saveElement function outputs the specified AutoConenctElements as a JSON document using the prettyPrintTo function of the ArduinoJson library. Parameters out Output stream to be output. SPIFFS, SD also Serial can be specified generally. names The array of the name of AutoConnectElements to be output. If the names parameter is not specified, all AutoConnectElements registered in AutoConnectAux are output. Return value The number of bytes written. The output format is pretty The saveElement function outputs a prettified JSON document. setElementValue \u00b6 bool setElementValue( const String & name, const String value) bool setElementValue( const String & name, std :: vector < String > const & values) Sets the value of the specified AutoConnectElement. If values \u200b\u200bis specified as a std::vector of String, the element that can set the values is the AutoConnectRadio or the AutoConnectSelect . Parameters name Specifies the name of the AutoConnectElements that you want to set the value. value Specifies the value to be set. values Specifies a reference of a std::vector of String. It contains the values of the AutoConnectRadio or the AutoConnectSelect. Return value true The value has been set. false AutoConnectElements with the specified name are not registered. Or the type of the value is not consistent with the specified AutoConnectElements. You can directly access the value member variable. If you are gripping with the sketch to the AutoConnectElements of the target that sets the value, you can access the value member variable directly. The following sketch code has the same effect. AutoConnectAux aux; // ... Griping the AutoConnectText here. aux.setElementValue( \"TEXT_FIELD\" , \"New value\" ); AutoConnectAux aux; // ... Griping the AutoConnectText here. AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_FIELD\" ); text.value = \"New value\" ; The difference between the setElementValue and the value access with the getElement is the certainty of the registration state for the element. The getElement returns an empty object if the element is not registered then a sketch assigns the value to it. May occur unexpected results and crashes. You should use the setElementValue if its registration is unsettled. setTitle \u00b6 void setTitle( const String & title) Set the title string of the custom Web page. This title will be displayed as the menu title of the custom Web page. Parameter title Title string to be display. Not the menu title The setTitle function is not set for the AutoConnect menu title. The effect of this function is that custom Web page only. To change the AutoConnect menu title use AutoConnectConfig::title .","title":"AutoConnectAux API"},{"location":"apiaux.html#constructor","text":"","title":" Constructor"},{"location":"apiaux.html#autoconnectaux","text":"AutoConnectAux( const String & uri = String( \"\" ), const String & title = String( \"\" ), const bool menu = true, const AutoConnectElementVT addons = AutoConnectElementVT()) Parameters uri URI of this custom Web Page. title Page title of this custom Web page. It will appear on the auto connection menu and at the top of that page. menu Specifies whether to display this page on menu. addons Reference to AutoConnectElement collection.","title":"AutoConnectAux"},{"location":"apiaux.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apiaux.html#add","text":"void add(AutoConnectElement & addon) void add(AutoConnectElementVT addons) Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu. Parameters addon Reference of AutoConnectElements. Specifies one of the AutoConnectElements classes. addons An array list of reference of AutoConnectElements. An list initialization of the std::vector can be used for the addons parameter cause the actual definition of type AutoConnectElementVT is std::vector<std::reference_wrapper<AutoConnectElement>> .","title":" add"},{"location":"apiaux.html#getelement","text":"T & getElement < T > ( const String & name) AutoConnectElement * getElement( const String & name) Get a registered AutoConnectElement as specified name. If T is specified as an actual type of AutoConnectElements, it returns a reference to that instance. Parameters T Actual type name of AutoConnectElements as AutoConnectButton , AutoConnectCheckbox , AutoConnectElement , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectSubmit , AutoConnectText . name Name of the AutoConnectElements to be retrieved. Return value A reference of the AutoConnectElements. If a type is not specified returns a pointer.","title":" getElement"},{"location":"apiaux.html#getelements","text":"AutoConnectElementVT & getElements( void ) Get vector of reference of all elements. Return value A reference to std::vector of reference to AutoConnecctElements. The getElements returns a reference to std::vector of reference to AutoConnecctElements. This function is provided to handle AutoConnectElemets owned by AutoConnectAux in bulk, and you can use each method of std::vector for a return value. // An example of getting type and name of all AutoConnectElements registered in AutoConnectAux. AutoConnectAux aux; // some code here... AutoConnectElementVt & elements = aux.getElements(); for (AutoConnectElement & elm : elements) { Serial.printf( \"name<%s> as type %d \\n \" , elm.name.c_str(), ( int )elm.typeOf()); }","title":" getElements"},{"location":"apiaux.html#load","text":"bool load( const String & in) bool load( const __FlashStringHelper * in) bool load(Stream & in) Load all AutoConnectElements elements from JSON document into AutoConnectAux as custom Web pages. The JSON document specified by the load function must be the document structure of AutoConnectAux. Its JSON document can describe multiple pages as an array. Parameters in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. Return value true JSON document as the custom Web pages successfully loaded. false JSON document loading failed. Load multiple custom Web pages separately Multiple custom Web pages can be loaded at once with JSON as an array. But it will consume a lot of memory. By loading a JSON document by page as much as possible, you can reduce memory consumption.","title":" load"},{"location":"apiaux.html#loadelement","text":"bool loadElement( const String & in, const String & name = String( \"\" )) bool loadElement( const __FlashStringHelper * in, const String & name = String( \"\" )) bool loadElement(Stream & in, const String & name = String( \"\" )) Load specified element from JSON document into AutoConnectAux. The JSON document specified by the loadElement function must be the AutoConnectElement document structure . When loading from a JSON document that describes multiple elements, its description must be an array syntax. Parameters in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. name Specifies the name to be load. If the name is not specified, the loadElement function will load all elements contained in the JSON document. Return value true Specified AutoConnectElements successfully loaded. false JSON document loading failed. Maybe it is an array Please note that the JSON document that is the input for loadElement is an array syntax of AutoConnectElements when there are multiple elements. For example, the following JSON document has a syntax error: { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"value\" : \"Hello, world\" } , { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" } The outermost [ , ] is missing.","title":" loadElement"},{"location":"apiaux.html#menu","text":"void menu( const bool post) Set or reset the display as menu item for this AutoConnectAux. This function programmatically manipulates the menu parameter of the AutoConenctAux constructor . Parameters true Show on the menu. false Hidden on the menu.","title":" menu"},{"location":"apiaux.html#on","text":"void on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated.","title":" on"},{"location":"apiaux.html#release","text":"bool release( const String & name) Release a specified AutoConnectElement from AutoConenctAux. The release function is provided to dynamically change the structure of the custom Web pages with the sketch. By combining the release function and the add function or the loadElement function, the sketch can change the style of the custom Web page according to its behavior. Parameters name Specifies the name of AutoConnectElements to be released. Return value true The AutoConnectElement successfully released. false The AutoConnectElement can not be released.","title":" release"},{"location":"apiaux.html#saveelement","text":"size_t saveElement(Stream & out, std :: vector < String > const & names = {}) Write elements of AutoConnectAux to the stream. The saveElement function outputs the specified AutoConenctElements as a JSON document using the prettyPrintTo function of the ArduinoJson library. Parameters out Output stream to be output. SPIFFS, SD also Serial can be specified generally. names The array of the name of AutoConnectElements to be output. If the names parameter is not specified, all AutoConnectElements registered in AutoConnectAux are output. Return value The number of bytes written. The output format is pretty The saveElement function outputs a prettified JSON document.","title":" saveElement"},{"location":"apiaux.html#setelementvalue","text":"bool setElementValue( const String & name, const String value) bool setElementValue( const String & name, std :: vector < String > const & values) Sets the value of the specified AutoConnectElement. If values \u200b\u200bis specified as a std::vector of String, the element that can set the values is the AutoConnectRadio or the AutoConnectSelect . Parameters name Specifies the name of the AutoConnectElements that you want to set the value. value Specifies the value to be set. values Specifies a reference of a std::vector of String. It contains the values of the AutoConnectRadio or the AutoConnectSelect. Return value true The value has been set. false AutoConnectElements with the specified name are not registered. Or the type of the value is not consistent with the specified AutoConnectElements. You can directly access the value member variable. If you are gripping with the sketch to the AutoConnectElements of the target that sets the value, you can access the value member variable directly. The following sketch code has the same effect. AutoConnectAux aux; // ... Griping the AutoConnectText here. aux.setElementValue( \"TEXT_FIELD\" , \"New value\" ); AutoConnectAux aux; // ... Griping the AutoConnectText here. AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_FIELD\" ); text.value = \"New value\" ; The difference between the setElementValue and the value access with the getElement is the certainty of the registration state for the element. The getElement returns an empty object if the element is not registered then a sketch assigns the value to it. May occur unexpected results and crashes. You should use the setElementValue if its registration is unsettled.","title":" setElementValue"},{"location":"apiaux.html#settitle","text":"void setTitle( const String & title) Set the title string of the custom Web page. This title will be displayed as the menu title of the custom Web page. Parameter title Title string to be display. Not the menu title The setTitle function is not set for the AutoConnect menu title. The effect of this function is that custom Web page only. To change the AutoConnect menu title use AutoConnectConfig::title .","title":" setTitle"},{"location":"apiconfig.html","text":"Constructor \u00b6 AutoConnectConfig \u00b6 AutoConnectConfig() AutoConnectConfig( const char * ap, const char * password) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout, const uint8_t channel) Parameters ap SSID for SoftAP. The length should be up to 31. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The length should be from 8 to up to 63. The default value is 12345678 . timeout The timeout value of the captive portal in [ms] units. The default value is 0. channel The channel number of WIFi when SoftAP starts. The default values is 1. Public member variables \u00b6 apid \u00b6 SoftAP's SSID. Type String apip \u00b6 Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 192.168.244.1 autoReconnect \u00b6 Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, AutoConnect::begin() function will attempt to reconnect to a known access point using credentials stored in the EEPROM, even if the connection failed by current SSID. If the connection fails, starts the captive portal in SoftAP + STA mode. Type bool Value true Reconnect automatically. false Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default. When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied. Invokes AutoConnect::begin without user name and password parameter as begin() . If one of the saved BSSIDs (not the SSID) of the credentials matches the BSSID detected by the network scan. autoReset \u00b6 Reset ESP8266 module automatically after WLAN disconnected. Type bool Value true Reset after WiFi disconnected automatically. false No reset. autoRise \u00b6 Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first WiFi.begin fails. Type bool Value true Enable the captive portal. This is the default. false Disable the captive portal. autoSave \u00b6 The credential saved automatically at the connection establishment. Type AC_SAVECREDENTIAL_t Value AC_SAVECREDENTIAL_AUTO The credential saved automatically. This is the default. AC_SAVECREDENTIAL_NEVER The credential no saved. bootUri \u00b6 Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of AC_ONBOOTURI_t indicating either the AutoConnect root path or the user screen home path. Type AC_ONBOOTURI_t Value AC_ONBOOTURI_ROOT Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h. AC_ONBOOTURI_HOME It is redirected to the uri specified by AutoConnectConfig::homeUri . boundaryOffset \u00b6 Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK) The default value is 0. Type uint16_t It will conflict with user data. If the sketch leaves this offset at zero, it will conflict the storage area of credentials with the user sketch owned data. It needs to use the behind of credential area. channel \u00b6 The channel number of WIFi when SoftAP starts. Type uint8_t Value 1 ~ 14. The default value is 1. How do I choose Channel Espressif Systems had announced the application note about Wi-Fi channel selection. dns1 \u00b6 Set primary DNS server address when using static IP address. Type IPAddress dns2 \u00b6 Set secondary DNS server address when using static IP address. Type IPAddress gateway \u00b6 Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 192.168.244.1 hidden \u00b6 Sets SoftAP to hidden SSID. Type uint8_t Value 0 SSID will be appeared. This is the default. 1 SSID will be hidden. homeUri \u00b6 Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is \"/\". Type String hostName \u00b6 Sets the station host name of ESP8266/ESP32. Type String immediateStart \u00b6 Disable the first WiFi.begin() and start the captive portal. If this option is enabled, the module will be in AP_STA mode and the captive portal will be activated regardless of AutoConnectConfig::autoRise specification. Type bool Value true Start the captive portal with AutoConnect::begin . false Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default. netmask \u00b6 Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 255.255.255.0 portalTimeout \u00b6 Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (ie Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out. Type unsigned long Captive portal timeout value. The default value is 0. psk \u00b6 Sets password for SoftAP. The length should be from 8 to up to 63. The default value is 12345678 . Type String retainPortal \u00b6 Specify whether to continue the portal function even if the captive portal timed out. If the true, when a timeout occurs, the AutoConnect::begin function is exited with returns false, but the portal facility remains alive. So SoftAP remains alive and you can invoke AutoConnect while continuing sketch execution. The default is false. Type bool Value true Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP. false When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default. Connection request after timed-out With the retainPortal , even if AutoConnect::begin in the setup() is timed out, you can execute the sketch and the portal function as a WiFi connection attempt by calling AutoConnect::handleClient in the loop(). staip \u00b6 Set a static IP address. The IP will behave with STA mode. Type IPAddress staGateway \u00b6 Set the gateway address when using static IP address. Type IPAddress staNetmask \u00b6 Set the subnetmask when using static IP address. Type IPAddress title \u00b6 Set the menu title. Type String AutoConnectConfig example \u00b6 AutoConenct Portal; AutoConenctConfig Config ( \"\" , \"passpass\" ); // SoftAp name is determined at runtime Config.apid = ESP.hostname(); // Retrieve host name to SotAp identification Config.apip = IPAddress( 192 , 168 , 10 , 101 ); // Sets SoftAP IP address Config.gateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WLAN router IP address Config.netmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.autoReconnect = true; // Enable auto-reconnect Config.autoSave = AC_SAVECREDENTIAL_NEVER; // No save credential Config.boundaryOffet = 64 ; // Reserve 64 bytes for the user data in EEPROM. Config.portalTimeout = 60000 ; // Sets timeout value for the captive portal Config.retainPortal = true; // Retains the portal function after timed-out Config.homeUri = \"/index.html\" ; // Sets home path of the sketch application Config.title = \"My menu\" ; // Customize the menu title Config.staip = IPAddress( 192 , 168 , 10 , 10 ); // Sets static IP Config.staGateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WiFi router address Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.dns1 = IPAddress( 192 , 168 , 10 , 1 ); // Sets primary DNS address Portal.config(Config); // Configure AutoConnect Portal.begin(); // Starts and behaves captive portal","title":"AutoConnectConfig API"},{"location":"apiconfig.html#constructor","text":"","title":" Constructor"},{"location":"apiconfig.html#autoconnectconfig","text":"AutoConnectConfig() AutoConnectConfig( const char * ap, const char * password) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout, const uint8_t channel) Parameters ap SSID for SoftAP. The length should be up to 31. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The length should be from 8 to up to 63. The default value is 12345678 . timeout The timeout value of the captive portal in [ms] units. The default value is 0. channel The channel number of WIFi when SoftAP starts. The default values is 1.","title":"AutoConnectConfig"},{"location":"apiconfig.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apiconfig.html#apid","text":"SoftAP's SSID. Type String","title":" apid"},{"location":"apiconfig.html#apip","text":"Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 192.168.244.1","title":" apip"},{"location":"apiconfig.html#autoreconnect","text":"Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, AutoConnect::begin() function will attempt to reconnect to a known access point using credentials stored in the EEPROM, even if the connection failed by current SSID. If the connection fails, starts the captive portal in SoftAP + STA mode. Type bool Value true Reconnect automatically. false Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default. When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied. Invokes AutoConnect::begin without user name and password parameter as begin() . If one of the saved BSSIDs (not the SSID) of the credentials matches the BSSID detected by the network scan.","title":" autoReconnect"},{"location":"apiconfig.html#autoreset","text":"Reset ESP8266 module automatically after WLAN disconnected. Type bool Value true Reset after WiFi disconnected automatically. false No reset.","title":" autoReset"},{"location":"apiconfig.html#autorise","text":"Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first WiFi.begin fails. Type bool Value true Enable the captive portal. This is the default. false Disable the captive portal.","title":" autoRise"},{"location":"apiconfig.html#autosave","text":"The credential saved automatically at the connection establishment. Type AC_SAVECREDENTIAL_t Value AC_SAVECREDENTIAL_AUTO The credential saved automatically. This is the default. AC_SAVECREDENTIAL_NEVER The credential no saved.","title":" autoSave"},{"location":"apiconfig.html#booturi","text":"Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of AC_ONBOOTURI_t indicating either the AutoConnect root path or the user screen home path. Type AC_ONBOOTURI_t Value AC_ONBOOTURI_ROOT Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h. AC_ONBOOTURI_HOME It is redirected to the uri specified by AutoConnectConfig::homeUri .","title":" bootUri"},{"location":"apiconfig.html#boundaryoffset","text":"Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK) The default value is 0. Type uint16_t It will conflict with user data. If the sketch leaves this offset at zero, it will conflict the storage area of credentials with the user sketch owned data. It needs to use the behind of credential area.","title":" boundaryOffset"},{"location":"apiconfig.html#channel","text":"The channel number of WIFi when SoftAP starts. Type uint8_t Value 1 ~ 14. The default value is 1. How do I choose Channel Espressif Systems had announced the application note about Wi-Fi channel selection.","title":" channel"},{"location":"apiconfig.html#dns1","text":"Set primary DNS server address when using static IP address. Type IPAddress","title":" dns1"},{"location":"apiconfig.html#dns2","text":"Set secondary DNS server address when using static IP address. Type IPAddress","title":" dns2"},{"location":"apiconfig.html#gateway","text":"Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 192.168.244.1","title":" gateway"},{"location":"apiconfig.html#hidden","text":"Sets SoftAP to hidden SSID. Type uint8_t Value 0 SSID will be appeared. This is the default. 1 SSID will be hidden.","title":" hidden"},{"location":"apiconfig.html#homeuri","text":"Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is \"/\". Type String","title":" homeUri"},{"location":"apiconfig.html#hostname","text":"Sets the station host name of ESP8266/ESP32. Type String","title":" hostName"},{"location":"apiconfig.html#immediatestart","text":"Disable the first WiFi.begin() and start the captive portal. If this option is enabled, the module will be in AP_STA mode and the captive portal will be activated regardless of AutoConnectConfig::autoRise specification. Type bool Value true Start the captive portal with AutoConnect::begin . false Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default.","title":" immediateStart"},{"location":"apiconfig.html#netmask","text":"Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 255.255.255.0","title":" netmask"},{"location":"apiconfig.html#portaltimeout","text":"Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (ie Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out. Type unsigned long Captive portal timeout value. The default value is 0.","title":" portalTimeout"},{"location":"apiconfig.html#psk","text":"Sets password for SoftAP. The length should be from 8 to up to 63. The default value is 12345678 . Type String","title":" psk"},{"location":"apiconfig.html#retainportal","text":"Specify whether to continue the portal function even if the captive portal timed out. If the true, when a timeout occurs, the AutoConnect::begin function is exited with returns false, but the portal facility remains alive. So SoftAP remains alive and you can invoke AutoConnect while continuing sketch execution. The default is false. Type bool Value true Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP. false When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default. Connection request after timed-out With the retainPortal , even if AutoConnect::begin in the setup() is timed out, you can execute the sketch and the portal function as a WiFi connection attempt by calling AutoConnect::handleClient in the loop().","title":" retainPortal"},{"location":"apiconfig.html#staip","text":"Set a static IP address. The IP will behave with STA mode. Type IPAddress","title":" staip"},{"location":"apiconfig.html#stagateway","text":"Set the gateway address when using static IP address. Type IPAddress","title":" staGateway"},{"location":"apiconfig.html#stanetmask","text":"Set the subnetmask when using static IP address. Type IPAddress","title":" staNetmask"},{"location":"apiconfig.html#title","text":"Set the menu title. Type String","title":" title"},{"location":"apiconfig.html#autoconnectconfig-example","text":"AutoConenct Portal; AutoConenctConfig Config ( \"\" , \"passpass\" ); // SoftAp name is determined at runtime Config.apid = ESP.hostname(); // Retrieve host name to SotAp identification Config.apip = IPAddress( 192 , 168 , 10 , 101 ); // Sets SoftAP IP address Config.gateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WLAN router IP address Config.netmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.autoReconnect = true; // Enable auto-reconnect Config.autoSave = AC_SAVECREDENTIAL_NEVER; // No save credential Config.boundaryOffet = 64 ; // Reserve 64 bytes for the user data in EEPROM. Config.portalTimeout = 60000 ; // Sets timeout value for the captive portal Config.retainPortal = true; // Retains the portal function after timed-out Config.homeUri = \"/index.html\" ; // Sets home path of the sketch application Config.title = \"My menu\" ; // Customize the menu title Config.staip = IPAddress( 192 , 168 , 10 , 10 ); // Sets static IP Config.staGateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WiFi router address Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.dns1 = IPAddress( 192 , 168 , 10 , 1 ); // Sets primary DNS address Portal.config(Config); // Configure AutoConnect Portal.begin(); // Starts and behaves captive portal","title":" AutoConnectConfig example"},{"location":"apielements.html","text":"AutoConnectButton \u00b6 Constructor \u00b6 AutoConnectButton( const char * name = \"\" , const char * value = \"\" , const String & action = String()) Parameters name The element name. value Value of the element. action Native code of the action script executed when the button is clicked. Public member variables \u00b6 name \u00b6 The element name. Type String value \u00b6 Value of the element. Type String action \u00b6 HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script. 1 Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Button AutoConnectCheckbox \u00b6 Constructor \u00b6 explicit AutoConnectCheckboxBasis( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const bool checked = false) Parameters name The element name. value Value of the element. label A label string prefixed to the checkbox. check Checked state of the checkbox. Public member variables \u00b6 name \u00b6 The element name. Type String value \u00b6 Value of the element. It becomes a value attribute of an HTML < input type = \"checkbox\" > tag. Type String label \u00b6 A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML < label > tag with an id attribute. The checkbox and the label are connected by the id attribute. Type String checked \u00b6 It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit. Type Boolean Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Checkbox AutoConnectElement \u00b6 Constructor \u00b6 AutoConnectElement( const char * name = \"\" , const char * value = \"\" ) Parameters name The element name. value Value of the element. Public member variables \u00b6 name \u00b6 The element name. Type String value \u00b6 Value of the element. It is output as HTML as it is as a source for generating HTML code. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Element AutoConnectInput \u00b6 Constructor \u00b6 AutoConnectInput( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const char * pattern = \"\" , const char * placeholder = \"\" ) Parameters name The element name. value Value of the element. label Label string. pattern Regular expression string for checking data format. placeholder A placeholder string. Public member variables \u00b6 name \u00b6 The element name. Type String value \u00b6 Value of the element. It becomes a value attribute of an HTML < input type = \"text\" > tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value. Type String label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. Type String pattern \u00b6 A pattern specifies a regular expression that the input-box's value is checked against on form submission. Type String placeholder \u00b6 A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Input AutoConnectRadio \u00b6 Constructor \u00b6 AutoConnectRadio( const char * name = \"\" , std :: vector < String > const & values = {}, const char * label = \"\" , const ACArrange_t order = AC_Vertical, const uint8_t checked = 0 ) Parameters name The element name. values An array of values of the radio buttons. Specifies an std::vector object. label Label string. order The direction to arrange the radio buttons. checked An index to be checked in the radio buttons. Public member variables \u00b6 name \u00b6 The element name. Type String values \u00b6 An array of String type for the radio button options. It is an initialization list can be used. The < input type = \"radio\" > tags will be generated from each entry in the values. Type std::vector<String> label \u00b6 A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Type String order \u00b6 Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the order . It is a value of ACArrange_t type and accepts one of the following: Type ACArrange_t AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. checked \u00b6 Specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. Type uint8_t Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Radio add \u00b6 void add( const String & value) Adds an option for the radio button. Parameters value An option string to add to the radio button. check \u00b6 void check( const String & value) Indicates the check of the specified option for the radio buttons. You can use the check function for checking dynamically with arbitrary of the radio button. Parameters value An option string to be checked. empty \u00b6 void empty( const size_t reserve = 0 ) Clear the array of option strings that AutoConnectRadio has in values. When a reserve parameter is specified, a vector container of that size is reserved. Parameters reserve Reserved size of a container for option strings. operator [ ] \u00b6 const String & operator [] ( const std :: size_t n) Returns the option string of the index specified by n . Parameters n Index of values array to return. value \u00b6 const String & value( void ) const Returns current checked option of the radio buttons. Return value A String of an option current checked. If there is no checked option, a null string returned. AutoConnectSelect \u00b6 Constructor \u00b6 AutoConnectSelect( const char * name = \"\" , std :: vector < String > const & options = {}, const char * label = \"\" ) Parameters name The element name. options An array of options of the select element. Specifies an std::vector object. label Label string. Public member variables \u00b6 name \u00b6 The element name. Type String options \u00b6 An array of String type for the selection options. It is an initialization list can be used. The < option value > tags will be generated from each entry in the options. Type std::vector<String> label \u00b6 A label is an optional string. A label will be arranged in the top of the selection list. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Select add \u00b6 void add( const String & option) empty \u00b6 void empty( const size_t reserve = 0 ) size \u00b6 size_t size( void ) operator [ ] \u00b6 const String & operator [] ( const std :: size_t n) AutoConnectSubmit \u00b6 AutoConnectText \u00b6 JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9","title":"AutoConnectElements API"},{"location":"apielements.html#autoconnectbutton","text":"","title":"AutoConnectButton"},{"location":"apielements.html#constructor","text":"AutoConnectButton( const char * name = \"\" , const char * value = \"\" , const String & action = String()) Parameters name The element name. value Value of the element. action Native code of the action script executed when the button is clicked.","title":" Constructor"},{"location":"apielements.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apielements.html#name","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value","text":"Value of the element. Type String","title":" value"},{"location":"apielements.html#action","text":"HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script. 1 Type String","title":" action"},{"location":"apielements.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apielements.html#typeof","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Button","title":" typeOf"},{"location":"apielements.html#autoconnectcheckbox","text":"","title":"AutoConnectCheckbox"},{"location":"apielements.html#constructor_1","text":"explicit AutoConnectCheckboxBasis( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const bool checked = false) Parameters name The element name. value Value of the element. label A label string prefixed to the checkbox. check Checked state of the checkbox.","title":" Constructor"},{"location":"apielements.html#public-member-variables_1","text":"","title":" Public member variables"},{"location":"apielements.html#name_1","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value_1","text":"Value of the element. It becomes a value attribute of an HTML < input type = \"checkbox\" > tag. Type String","title":" value"},{"location":"apielements.html#label","text":"A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML < label > tag with an id attribute. The checkbox and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#checked","text":"It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit. Type Boolean","title":" checked"},{"location":"apielements.html#public-member-functions_1","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_1","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Checkbox","title":" typeOf"},{"location":"apielements.html#autoconnectelement","text":"","title":"AutoConnectElement"},{"location":"apielements.html#constructor_2","text":"AutoConnectElement( const char * name = \"\" , const char * value = \"\" ) Parameters name The element name. value Value of the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_2","text":"","title":" Public member variables"},{"location":"apielements.html#name_2","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value_2","text":"Value of the element. It is output as HTML as it is as a source for generating HTML code. Type String","title":" value"},{"location":"apielements.html#public-member-functions_2","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_2","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Element","title":" typeOf"},{"location":"apielements.html#autoconnectinput","text":"","title":"AutoConnectInput"},{"location":"apielements.html#constructor_3","text":"AutoConnectInput( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const char * pattern = \"\" , const char * placeholder = \"\" ) Parameters name The element name. value Value of the element. label Label string. pattern Regular expression string for checking data format. placeholder A placeholder string.","title":" Constructor"},{"location":"apielements.html#public-member-variables_3","text":"","title":" Public member variables"},{"location":"apielements.html#name_3","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value_3","text":"Value of the element. It becomes a value attribute of an HTML < input type = \"text\" > tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value. Type String","title":" value"},{"location":"apielements.html#label_1","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#pattern","text":"A pattern specifies a regular expression that the input-box's value is checked against on form submission. Type String","title":" pattern"},{"location":"apielements.html#placeholder","text":"A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. Type String","title":" placeholder"},{"location":"apielements.html#public-member-functions_3","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_3","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Input","title":" typeOf"},{"location":"apielements.html#autoconnectradio","text":"","title":"AutoConnectRadio"},{"location":"apielements.html#constructor_4","text":"AutoConnectRadio( const char * name = \"\" , std :: vector < String > const & values = {}, const char * label = \"\" , const ACArrange_t order = AC_Vertical, const uint8_t checked = 0 ) Parameters name The element name. values An array of values of the radio buttons. Specifies an std::vector object. label Label string. order The direction to arrange the radio buttons. checked An index to be checked in the radio buttons.","title":" Constructor"},{"location":"apielements.html#public-member-variables_4","text":"","title":" Public member variables"},{"location":"apielements.html#name_4","text":"The element name. Type String","title":" name"},{"location":"apielements.html#values","text":"An array of String type for the radio button options. It is an initialization list can be used. The < input type = \"radio\" > tags will be generated from each entry in the values. Type std::vector<String>","title":" values"},{"location":"apielements.html#label_2","text":"A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Type String","title":" label"},{"location":"apielements.html#order","text":"Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the order . It is a value of ACArrange_t type and accepts one of the following: Type ACArrange_t AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement.","title":" order"},{"location":"apielements.html#checked_1","text":"Specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. Type uint8_t","title":" checked"},{"location":"apielements.html#public-member-functions_4","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_4","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Radio","title":" typeOf"},{"location":"apielements.html#add","text":"void add( const String & value) Adds an option for the radio button. Parameters value An option string to add to the radio button.","title":" add"},{"location":"apielements.html#check","text":"void check( const String & value) Indicates the check of the specified option for the radio buttons. You can use the check function for checking dynamically with arbitrary of the radio button. Parameters value An option string to be checked.","title":" check"},{"location":"apielements.html#empty","text":"void empty( const size_t reserve = 0 ) Clear the array of option strings that AutoConnectRadio has in values. When a reserve parameter is specified, a vector container of that size is reserved. Parameters reserve Reserved size of a container for option strings.","title":" empty"},{"location":"apielements.html#operator","text":"const String & operator [] ( const std :: size_t n) Returns the option string of the index specified by n . Parameters n Index of values array to return.","title":" operator &#91;&nbsp;&#93;"},{"location":"apielements.html#value_4","text":"const String & value( void ) const Returns current checked option of the radio buttons. Return value A String of an option current checked. If there is no checked option, a null string returned.","title":" value"},{"location":"apielements.html#autoconnectselect","text":"","title":"AutoConnectSelect"},{"location":"apielements.html#constructor_5","text":"AutoConnectSelect( const char * name = \"\" , std :: vector < String > const & options = {}, const char * label = \"\" ) Parameters name The element name. options An array of options of the select element. Specifies an std::vector object. label Label string.","title":" Constructor"},{"location":"apielements.html#public-member-variables_5","text":"","title":" Public member variables"},{"location":"apielements.html#name_5","text":"The element name. Type String","title":" name"},{"location":"apielements.html#options","text":"An array of String type for the selection options. It is an initialization list can be used. The < option value > tags will be generated from each entry in the options. Type std::vector<String>","title":" options"},{"location":"apielements.html#label_3","text":"A label is an optional string. A label will be arranged in the top of the selection list. Type String","title":" label"},{"location":"apielements.html#public-member-functions_5","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_5","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Select","title":" typeOf"},{"location":"apielements.html#add_1","text":"void add( const String & option)","title":" add"},{"location":"apielements.html#empty_1","text":"void empty( const size_t reserve = 0 )","title":" empty"},{"location":"apielements.html#size","text":"size_t size( void )","title":" size"},{"location":"apielements.html#operator_1","text":"const String & operator [] ( const std :: size_t n)","title":" operator &#91;&nbsp;&#93;"},{"location":"apielements.html#autoconnectsubmit","text":"","title":"AutoConnectSubmit"},{"location":"apielements.html#autoconnecttext","text":"JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9","title":"AutoConnectText"},{"location":"apiextra.html","text":"Icons \u00b6 The library presents two PNG icons which can be used to embed a hyperlink to the AutoConnect menu. Bar type Cog type To reference the icon, use the AUTOCONNECT_LINK macro in the sketch. It expands into the string literal as an HTML <a></a> tag with PNG embedded of the AutoConnect menu hyperlinks. Icon type is specified by the parameter of the macro. BAR_24 Bars icon, 24x24. BAR_32 Bars icon, 32x32. BAR_48 Bars icon, 48x48. COG_24 Cog icon, 24x24. COG_32 Cog icon, 32x32. Usage String html = \"<html>\" ; html += AUTOCONNECT_LINK(BAR_32); html += \"</html>\" ; server.send( 200 , \"text/html\" , html);","title":"Something extra"},{"location":"apiextra.html#icons","text":"The library presents two PNG icons which can be used to embed a hyperlink to the AutoConnect menu. Bar type Cog type To reference the icon, use the AUTOCONNECT_LINK macro in the sketch. It expands into the string literal as an HTML <a></a> tag with PNG embedded of the AutoConnect menu hyperlinks. Icon type is specified by the parameter of the macro. BAR_24 Bars icon, 24x24. BAR_32 Bars icon, 32x32. BAR_48 Bars icon, 48x48. COG_24 Cog icon, 24x24. COG_32 Cog icon, 32x32. Usage String html = \"<html>\" ; html += AUTOCONNECT_LINK(BAR_32); html += \"</html>\" ; server.send( 200 , \"text/html\" , html);","title":" Icons"},{"location":"basicusage.html","text":"Simple usage \u00b6 Embed to the sketches \u00b6 How embed the AutoConnect to the sketches you have. Most simple approach to applying AutoConnect for the existing sketches, follow the below steps. The below sketch is for ESP8266. For ESP32, replace ESP8266WebServer with WebServer and ESP8266WiFi.h with WiFi.h respectively. Insert #include <AutoConnect.h> to behind of #include <ESP8266WebServer.h> . Insert AutoConnect PORTAL(WEBSERVER); to behind of ESP8266WebServer WEBSERVER; declaration. 1 Remove WiFi. begin ( SSID , PSK ) and the subsequent logic for the connection status check. Replace WEBSERVER . begin () to PORTAL . begin () . 2 Replace WEBSERVER . handleClient () to PORTAL . handleClient () . 3 If the connection checks logic is needed, you can check the return value according to PORTAL . begin () with true or false . Basic usage \u00b6 Basic logic sequence for the user sketches \u00b6 1. A typical logic sequence \u00b6 Include headers, ESP8266WebServer.h / WebServer.h and AutoConnect.h Declare an ESP8266WebServer variable for ESP8266 or a WebServer variable for ESP32. Declare an AutoConnect variable. Implement the URL handlers provided for the on method of ESP8266WebServer/WebServer with the function() . setup() 5.1 Sets URL handler the function() to ESP8266WebServer/WebServer by ESP8266WebServer::on / WebServer::on . 5.2 Starts AutoConnect::begin() . 5.3 Check WiFi connection status. loop() 6.1 Do the process for actual sketch. 6.2 Invokes AutoConnect::handleClient() , or invokes ESP8266WebServer::handleClient() / WebServer::handleClient then AutoConnect::handleRequest() . 2. Declare AutoConnect object \u00b6 Two options are available for AutoConnect constructor . AutoConnect VARIABLE ( & ESP8266WebServer); // For ESP8266 AutoConnect VARIABLE ( & WebServer); // For ESP32 or AutoConnect VARIABLE; The parameter with an ESP8266WebServer/WebServer variable: An ESP8266WebServer/WebServer object variable must be declared. AutoConnect uses its variable to handles the AutoConnect menu . With no parameter: The sketch does not declare ESP8266WebServer/WebServer object. In this case, AutoConnect allocates an instance of the ESP8266WebServer/WebServer internally. The logic sequence of the sketch is somewhat different as the above. To register a URL handler function by ESP8266WebServer::on or WebServer::on should be performed after AutoConnect::begin . 3. No need WiFI.begin(...) \u00b6 AutoConnect internally performs WiFi.begin to establish a WiFi connection. There is no need for a general process to establish a connection using WiFi.begin with a sketch code. 4. Alternate ESP8266WebServer::begin() and WebServer::begin() \u00b6 AutoConnect::begin executes ESP8266WebServer::begin / WebServer::begin internally too and it starts the DNS server to behave as a Captive portal. So it is not needed to call ESP8266WebServer::begin / WebServer::begin in the sketch. Why DNS Server starts AutoConnect traps the detection of the captive portal and achieves a connection with the WLAN interactively by the AutoConnect menu. It responds SoftAP address to all DNS queries temporarily to trap. Once a WiFi connection establishes, the DNS server contributed by AutoConnect stops. 5. AutoConnect::begin with SSID and Password \u00b6 SSID and Password can also specify by AutoConnect::begin . ESP8266/ESP32 uses provided SSID and Password explicitly. If the connection false with specified SSID with Password then a captive portal is activated. SSID and Password are not present, ESP8266 SDK will attempt to connect using the still effectual SSID and password. Usually, it succeeds. 6. Use ESP8266WebServer::on and WebServer::on to handle URL \u00b6 AutoConnect is designed to coexist with the process for handling the web pages by user sketches. The page processing function which will send an HTML to the client invoked by the \" on::ESP8266WebServer \" or the \" on::WebServer \" function is the same as when using ESP8266WebServer/WebServer natively. 7. Use either ESP8266WebServer::handleClient()/WebServer::handleClient() or AutoConnect::handleClient() \u00b6 Both classes member function name is the same: handleClient , but the behavior is different. Using the AutoConnect embedded along with ESP8266WebServer::handleClient/WebServer::handleClient has limitations. Refer to the below section for details. ESP8266WebServer/WebServer hosted or parasitic \u00b6 The interoperable process with an ESP8266WebServer/WebServer depends on the parameters of the AutoConnect constructor . Declaration parameter for the constructor Use ESP8266WebServer::handleClient or WebServer::handleClient only Use AutoConnect::handleClient None AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . also to use ESP8266WebServer/WebServer natively, need AutoConnect::host() . AutoConnect menu available. To use ESP8266WebServer/WebServer natively, need AutoConnect::host() . Reference to ESP8266WebServer/WebServer AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . AutoConnect menu available. By declaration for the AutoConnect variable with no parameter : The ESP8266WebServer/WebServer instance is hosted by AutoConnect automatically then the sketches use AutoConnect::host as API to get it after AutoConnect::begin performed. By declaration for the AutoConnect variable with the reference of ESP8266WebServer/WebServer : AutoConnect will use it. The sketch can use it is too. In use ESP8266WebServer::handleClient()/WebServer::handleClient() : AutoConnect menu can be dispatched but not works normally. It is necessary to call AutoConnect::handleRequest after ESP8255WebServer::handleClient / WebServer::handleClient invoking. In use AutoConnect::handleClient() : The handleClient() process and the AutoConnect menu is available without calling ESP8266WebServer::handleClient . Why AutoConnect::handleRequest is needed when using ESP8266WebServer::handleClient/WebServer::handleClient The AutoConnect menu function may affect WiFi connection state. It follows that the menu process must execute outside ESP8266WebServer::handleClient and WebServer::handleClient . AutoConnect::handleClient is equivalent ESP8266WebServer::handleClient and WEbServer::handleClient included AutoConnect::handleRequest . Each VARIABLE conforms to the actual declaration in the sketches. \u21a9 WiFi SSID and Password can be specified AutoConnect::begin() too. \u21a9 Replacement the handleClient method is not indispensable. AutoConnect can still connect with the captive portal as it is ESP8266WebServer::handleClient. But it can not valid AutoConnect menu . \u21a9","title":"Basic usage"},{"location":"basicusage.html#simple-usage","text":"","title":"Simple usage"},{"location":"basicusage.html#embed-to-the-sketches","text":"How embed the AutoConnect to the sketches you have. Most simple approach to applying AutoConnect for the existing sketches, follow the below steps. The below sketch is for ESP8266. For ESP32, replace ESP8266WebServer with WebServer and ESP8266WiFi.h with WiFi.h respectively. Insert #include <AutoConnect.h> to behind of #include <ESP8266WebServer.h> . Insert AutoConnect PORTAL(WEBSERVER); to behind of ESP8266WebServer WEBSERVER; declaration. 1 Remove WiFi. begin ( SSID , PSK ) and the subsequent logic for the connection status check. Replace WEBSERVER . begin () to PORTAL . begin () . 2 Replace WEBSERVER . handleClient () to PORTAL . handleClient () . 3 If the connection checks logic is needed, you can check the return value according to PORTAL . begin () with true or false .","title":" Embed to the sketches"},{"location":"basicusage.html#basic-usage","text":"","title":"Basic usage"},{"location":"basicusage.html#basic-logic-sequence-for-the-user-sketches","text":"","title":" Basic logic sequence for the user sketches"},{"location":"basicusage.html#1-a-typical-logic-sequence","text":"Include headers, ESP8266WebServer.h / WebServer.h and AutoConnect.h Declare an ESP8266WebServer variable for ESP8266 or a WebServer variable for ESP32. Declare an AutoConnect variable. Implement the URL handlers provided for the on method of ESP8266WebServer/WebServer with the function() . setup() 5.1 Sets URL handler the function() to ESP8266WebServer/WebServer by ESP8266WebServer::on / WebServer::on . 5.2 Starts AutoConnect::begin() . 5.3 Check WiFi connection status. loop() 6.1 Do the process for actual sketch. 6.2 Invokes AutoConnect::handleClient() , or invokes ESP8266WebServer::handleClient() / WebServer::handleClient then AutoConnect::handleRequest() .","title":"1. A typical logic sequence"},{"location":"basicusage.html#2-declare-autoconnect-object","text":"Two options are available for AutoConnect constructor . AutoConnect VARIABLE ( & ESP8266WebServer); // For ESP8266 AutoConnect VARIABLE ( & WebServer); // For ESP32 or AutoConnect VARIABLE; The parameter with an ESP8266WebServer/WebServer variable: An ESP8266WebServer/WebServer object variable must be declared. AutoConnect uses its variable to handles the AutoConnect menu . With no parameter: The sketch does not declare ESP8266WebServer/WebServer object. In this case, AutoConnect allocates an instance of the ESP8266WebServer/WebServer internally. The logic sequence of the sketch is somewhat different as the above. To register a URL handler function by ESP8266WebServer::on or WebServer::on should be performed after AutoConnect::begin .","title":"2. Declare AutoConnect object"},{"location":"basicusage.html#3-no-need-wifibegin","text":"AutoConnect internally performs WiFi.begin to establish a WiFi connection. There is no need for a general process to establish a connection using WiFi.begin with a sketch code.","title":"3. No need WiFI.begin(...)"},{"location":"basicusage.html#4-alternate-esp8266webserverbegin-and-webserverbegin","text":"AutoConnect::begin executes ESP8266WebServer::begin / WebServer::begin internally too and it starts the DNS server to behave as a Captive portal. So it is not needed to call ESP8266WebServer::begin / WebServer::begin in the sketch. Why DNS Server starts AutoConnect traps the detection of the captive portal and achieves a connection with the WLAN interactively by the AutoConnect menu. It responds SoftAP address to all DNS queries temporarily to trap. Once a WiFi connection establishes, the DNS server contributed by AutoConnect stops.","title":"4. Alternate ESP8266WebServer::begin() and WebServer::begin()"},{"location":"basicusage.html#5-autoconnectbegin-with-ssid-and-password","text":"SSID and Password can also specify by AutoConnect::begin . ESP8266/ESP32 uses provided SSID and Password explicitly. If the connection false with specified SSID with Password then a captive portal is activated. SSID and Password are not present, ESP8266 SDK will attempt to connect using the still effectual SSID and password. Usually, it succeeds.","title":"5. AutoConnect::begin with SSID and Password"},{"location":"basicusage.html#6-use-esp8266webserveron-and-webserveron-to-handle-url","text":"AutoConnect is designed to coexist with the process for handling the web pages by user sketches. The page processing function which will send an HTML to the client invoked by the \" on::ESP8266WebServer \" or the \" on::WebServer \" function is the same as when using ESP8266WebServer/WebServer natively.","title":"6. Use ESP8266WebServer::on and WebServer::on to handle URL"},{"location":"basicusage.html#7-use-either-esp8266webserverhandleclientwebserverhandleclient-or-autoconnecthandleclient","text":"Both classes member function name is the same: handleClient , but the behavior is different. Using the AutoConnect embedded along with ESP8266WebServer::handleClient/WebServer::handleClient has limitations. Refer to the below section for details.","title":"7. Use either ESP8266WebServer::handleClient()/WebServer::handleClient() or AutoConnect::handleClient()"},{"location":"basicusage.html#esp8266webserverwebserver-hosted-or-parasitic","text":"The interoperable process with an ESP8266WebServer/WebServer depends on the parameters of the AutoConnect constructor . Declaration parameter for the constructor Use ESP8266WebServer::handleClient or WebServer::handleClient only Use AutoConnect::handleClient None AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . also to use ESP8266WebServer/WebServer natively, need AutoConnect::host() . AutoConnect menu available. To use ESP8266WebServer/WebServer natively, need AutoConnect::host() . Reference to ESP8266WebServer/WebServer AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . AutoConnect menu available. By declaration for the AutoConnect variable with no parameter : The ESP8266WebServer/WebServer instance is hosted by AutoConnect automatically then the sketches use AutoConnect::host as API to get it after AutoConnect::begin performed. By declaration for the AutoConnect variable with the reference of ESP8266WebServer/WebServer : AutoConnect will use it. The sketch can use it is too. In use ESP8266WebServer::handleClient()/WebServer::handleClient() : AutoConnect menu can be dispatched but not works normally. It is necessary to call AutoConnect::handleRequest after ESP8255WebServer::handleClient / WebServer::handleClient invoking. In use AutoConnect::handleClient() : The handleClient() process and the AutoConnect menu is available without calling ESP8266WebServer::handleClient . Why AutoConnect::handleRequest is needed when using ESP8266WebServer::handleClient/WebServer::handleClient The AutoConnect menu function may affect WiFi connection state. It follows that the menu process must execute outside ESP8266WebServer::handleClient and WebServer::handleClient . AutoConnect::handleClient is equivalent ESP8266WebServer::handleClient and WEbServer::handleClient included AutoConnect::handleRequest . Each VARIABLE conforms to the actual declaration in the sketches. \u21a9 WiFi SSID and Password can be specified AutoConnect::begin() too. \u21a9 Replacement the handleClient method is not indispensable. AutoConnect can still connect with the captive portal as it is ESP8266WebServer::handleClient. But it can not valid AutoConnect menu . \u21a9","title":" ESP8266WebServer/WebServer hosted or parasitic"},{"location":"changelog.html","text":"[0.9.7] Jan. 25, 2019 \u00b6 Fixed crash in some environments. Thank you @ageurtse Supports AutoConnect menu extention by user sketch with AutoConnectAux . Supports loading and saving of user-defined parameters with JSON format. Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed. Supports the AutoConnectConfig::immediateStart option and immediately starts the portal without first trying WiFi.begin. You can start the captive portal at any time in combination with the AutoConnectConfig::autoRise option. Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu. Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h . Supports AutoConnectConfig::hostName . It activates WiFi.hostname() / WiFi.setHostName() . Supports the captive portal time-out. It can be controlled by AutoConnectConfig::portalTimeout and AutoConnectConfig::retainPortal . [0.9.6] Sep.27, 2018. \u00b6 Improvement of RSSI detection for saved SSIDs. Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin . [0.9.5] Aug.27, 2018. \u00b6 Supports ESP32. Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks. [0.9.4] May 5, 2018. \u00b6 Automatically focus passphrase after selecting SSID with Configure New AP. Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting. [0.9.3] March 23, 2018. \u00b6 Supports a static IP address assignment. [0.9.2] March 19, 2018. \u00b6 Improvement of string literal declaration with the examples, no library change. [0.9.1] March 13, 2018. \u00b6 A release of the stable.","title":"Change log"},{"location":"changelog.html#097-jan-25-2019","text":"Fixed crash in some environments. Thank you @ageurtse Supports AutoConnect menu extention by user sketch with AutoConnectAux . Supports loading and saving of user-defined parameters with JSON format. Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed. Supports the AutoConnectConfig::immediateStart option and immediately starts the portal without first trying WiFi.begin. You can start the captive portal at any time in combination with the AutoConnectConfig::autoRise option. Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu. Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h . Supports AutoConnectConfig::hostName . It activates WiFi.hostname() / WiFi.setHostName() . Supports the captive portal time-out. It can be controlled by AutoConnectConfig::portalTimeout and AutoConnectConfig::retainPortal .","title":"[0.9.7] Jan. 25, 2019"},{"location":"changelog.html#096-sep27-2018","text":"Improvement of RSSI detection for saved SSIDs. Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin .","title":"[0.9.6] Sep.27, 2018."},{"location":"changelog.html#095-aug27-2018","text":"Supports ESP32. Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks.","title":"[0.9.5] Aug.27, 2018."},{"location":"changelog.html#094-may-5-2018","text":"Automatically focus passphrase after selecting SSID with Configure New AP. Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting.","title":"[0.9.4] May 5, 2018."},{"location":"changelog.html#093-march-23-2018","text":"Supports a static IP address assignment.","title":"[0.9.3] March 23, 2018."},{"location":"changelog.html#092-march-19-2018","text":"Improvement of string literal declaration with the examples, no library change.","title":"[0.9.2] March 19, 2018."},{"location":"changelog.html#091-march-13-2018","text":"A release of the stable.","title":"[0.9.1] March 13, 2018."},{"location":"datatips.html","text":"Convert AutoConnectElements value to actual data type \u00b6 The value of the AutoConnectElements field of the custom Web pages consists of String type for all. Sketches will need to convert them to the actual data type. And then if the data type required for processing in the sketch is not a String type, it is necessary to convert to String type when storing to the AutoConenctElements value. AutoConnect library does not provide the data conversion utility, and its function depends on Arduino language functions or functions of the type class. However, commonly used data conversion methods are generally similar. Here, represent examples the typical method for the data type conversion for the AutoConnectElements value of custom Web pages. Integer \u00b6 Use int() or toInt() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); int value = input.value.toInt(); Float \u00b6 Use float() or toFloat() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); float value = input.value.toFloat(); Date & Time \u00b6 The easiest way is to use the Arduino Time Library . Sketches must accommodate differences in date and time formats depending on the time zone. You can absorb the difference in DateTime format by using sscanf function. 1 #include <TimeLib.h> time_t tm; int Year, Month, Day, Hour, Minute, Second; AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); sscanf(input.value.c_str(), \"%d-%d-%d %d:%d:%d\" , & Year, & Month, & Day, & Hour, & Minute, & Second); tm.Year = CalendarYrToTm(Year); tm.Month = Month; tm.Day = Day; tm.Hour = Hour; tm.Minute = Minute; tm.Second = Second; IP adderss \u00b6 To convert a String to an IP address, use IPAddress::fromString . To stringize an instance of an IP address, use IPAddress::toString . IPAddress ip; AutoConnectInput & input aux.getElement < AutoConnectInput > ( \"INPUT\" ); ip.fromString(input.value); input.value = ip.toString(); Validation for the value \u00b6 In order for data to be correctly converted from a string, the input data must be consistent with the format. How to implement strict validation in sketches depends on various perspectives and the power of tiny devices is not enough to implement a complete lexical analysis. But you can reduce the burden for data verification using the pattern of AutoConnectInput. By giving a pattern to AutoConnectInput , you can find errors in data styles while typing in custom Web pages. The pattern is specified by regular expression . If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. Refer to Handling the custom Web pages section. Regular Expressions for JavaScript Regular expressions specified in the AutoConnectInput pattern conforms to the JavaScript specification . Here, represent examples the typical regular expression for the input validation. URL \u00b6 ^\\w+([-+.]\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$ DNS hostname \u00b6 ^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$ email address 1 \u00b6 ^[a-zA-Z0-9.!#$%&'*+\\/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*$ IP Address \u00b6 ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ Date as MM/DD/YYYY 2 \u00b6 ^(0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d$ Contain with backquote If that regular expression contains a backquote it must be escaped by backquote duplication. This regular expression does not fully support the format of the e-mail address requested in RFC5322 . \u21a9 \u21a9 This regular expression does not consider semantic constraints. It is not possible to detect errors that do not exist as actual dates. \u21a9","title":"Tips for data conversion"},{"location":"datatips.html#convert-autoconnectelements-value-to-actual-data-type","text":"The value of the AutoConnectElements field of the custom Web pages consists of String type for all. Sketches will need to convert them to the actual data type. And then if the data type required for processing in the sketch is not a String type, it is necessary to convert to String type when storing to the AutoConenctElements value. AutoConnect library does not provide the data conversion utility, and its function depends on Arduino language functions or functions of the type class. However, commonly used data conversion methods are generally similar. Here, represent examples the typical method for the data type conversion for the AutoConnectElements value of custom Web pages.","title":"Convert AutoConnectElements value to actual data type"},{"location":"datatips.html#integer","text":"Use int() or toInt() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); int value = input.value.toInt();","title":" Integer"},{"location":"datatips.html#float","text":"Use float() or toFloat() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); float value = input.value.toFloat();","title":" Float"},{"location":"datatips.html#date-time","text":"The easiest way is to use the Arduino Time Library . Sketches must accommodate differences in date and time formats depending on the time zone. You can absorb the difference in DateTime format by using sscanf function. 1 #include <TimeLib.h> time_t tm; int Year, Month, Day, Hour, Minute, Second; AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); sscanf(input.value.c_str(), \"%d-%d-%d %d:%d:%d\" , & Year, & Month, & Day, & Hour, & Minute, & Second); tm.Year = CalendarYrToTm(Year); tm.Month = Month; tm.Day = Day; tm.Hour = Hour; tm.Minute = Minute; tm.Second = Second;","title":" Date &amp; Time"},{"location":"datatips.html#ip-adderss","text":"To convert a String to an IP address, use IPAddress::fromString . To stringize an instance of an IP address, use IPAddress::toString . IPAddress ip; AutoConnectInput & input aux.getElement < AutoConnectInput > ( \"INPUT\" ); ip.fromString(input.value); input.value = ip.toString();","title":" IP adderss"},{"location":"datatips.html#validation-for-the-value","text":"In order for data to be correctly converted from a string, the input data must be consistent with the format. How to implement strict validation in sketches depends on various perspectives and the power of tiny devices is not enough to implement a complete lexical analysis. But you can reduce the burden for data verification using the pattern of AutoConnectInput. By giving a pattern to AutoConnectInput , you can find errors in data styles while typing in custom Web pages. The pattern is specified by regular expression . If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. Refer to Handling the custom Web pages section. Regular Expressions for JavaScript Regular expressions specified in the AutoConnectInput pattern conforms to the JavaScript specification . Here, represent examples the typical regular expression for the input validation.","title":"Validation for the value"},{"location":"datatips.html#url","text":"^\\w+([-+.]\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$","title":" URL"},{"location":"datatips.html#dns-hostname","text":"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$","title":" DNS hostname"},{"location":"datatips.html#email-address-1","text":"^[a-zA-Z0-9.!#$%&'*+\\/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*$","title":" email address 1"},{"location":"datatips.html#ip-address","text":"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$","title":" IP Address"},{"location":"datatips.html#date-as-mmddyyyy-2","text":"^(0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d$ Contain with backquote If that regular expression contains a backquote it must be escaped by backquote duplication. This regular expression does not fully support the format of the e-mail address requested in RFC5322 . \u21a9 \u21a9 This regular expression does not consider semantic constraints. It is not possible to detect errors that do not exist as actual dates. \u21a9","title":" Date as MM/DD/YYYY 2"},{"location":"faq.html","text":"After connected, AutoConnect menu performs but no happens. \u00b6 If you can access the AutoConnect root path as http://ESP8266IPADDRESS/_ac from browser, probably the sketch uses ESP8266WebServer::handleClient() without AutoConnect::handleRequest() . For AutoConnect menus to work properly, call AutoConnect::handleRequest() after ESP8266WebServer::handleClient() invoked, or use AutoConnect::handleClient() . AutoConnect::handleClient() is equivalent ESP8266WebServer::handleClient combined AutoConnect::handleRequest() . See also the explanation here . An esp8266ap as SoftAP was connected but Captive portal does not start. \u00b6 Captive portal detection could not be trapped. It is necessary to disconnect and reset ESP8266 to clear memorized connection data in ESP8266. Also, It may be displayed on the smartphone if the connection information of esp8266ap is wrong. In that case, delete the connection information of esp8266ap memorized by the smartphone once. Does not appear esp8266ap in smartphone. \u00b6 Maybe it is successfully connected at the first WiFi.begin . ESP8266 remembers the last SSID successfully connected and will use at the next. It means SoftAP will only start up when the first WiFi.begin() fails. The saved SSID would be cleared by WiFi.disconnect() with WIFI_STA mode. If you do not want automatic reconnection, you can erase the memorized SSID with the following simple sketch. #include <ESP8266WiFi.h> void setup () { delay( 1000 ); Serial.begin( 115200 ); WiFi.mode(WIFI_STA); delay( 100 ); WiFi.begin(); if (WiFi.waitForConnectResult() == WL_CONNECTED) { WiFi.disconnect(); while (WiFi.status() == WL_CONNECTED) delay( 100 ); } Serial.println( \"WiFi disconnected.\" ); } void loop () { delay( 1000 ); } You can interactively check the WiFi state of ESP8266. Please try ESPShaker . It is ESP8266 interactive serial command processor. Does not response from /_ac. \u00b6 Probably WiFi.begin failed with the specified SSID. Activating the debug printing will help you to track down the cause. How change esp8266ap for SSID name in Captive portal? \u00b6 An esp8266ap is default SSID name for SoftAP of captive portal and password is 12345678 . You can change both by using AutoConnectConfig . How change HTTP port? \u00b6 HTTP port number is defined as a macro in AutoConnect.h header file. You can change it directly with several editors and must re-compile. #define AUTOCONNECT_HTTPPORT 80 Hang up after Reset? \u00b6 If ESP8266 hang up after reset by AutoConnect menu, perhaps manual reset is not yet. Especially if it is not manual reset yet after uploading the sketch, the boot mode will stay 'Uart Download'. There is some discussion about this on the Github's ESP8266 core: https://github.com/esp8266/Arduino/issues/1017 If you received the following message, the boot mode is still sketch uploaded. It needs to the manual reset once. ets Jan 8 2013,rst cause:2, boot mode:(1,6) or (1,7) ets Jan 8 2013,rst cause:4, boot mode:(1,6) or (1,7) wdt reset The correct boot mode for starting the sketch is (3, x) . ESP8266 Boot Messages It is described by ESP8266 Non-OS SDK API Reference , section A.5. Messages Description rst cause 1: power on 2: external reset 4: hardware watchdog reset boot mode (the first parameter) 1: ESP8266 is in UART-down mode (and downloads firmware into flash). 3: ESP8266 is in Flash-boot mode (and boots up from flash). How erase the credentials saved in EEPROM? \u00b6 Make some sketches for erasing the EEPROM area, or some erasing utility is needed. You can prepare the sketch to erase the saved credential with AutoConnectCredential . The AutoConnectCrendential class provides the access method to the saved credential in EEPROM and library source file is including it. A class description of AutoConnectCredential is follows. Include header \u00b6 #include <AutoConnectCredential.h> Constructor \u00b6 AutoConnectCredential(); AutoConnectCredential default constructor. The default offset value is 0. If the offset value is 0, the credential storage area starts from the top of the EEPROM. AutoConnect sometimes overwrites data when using this area with user sketch. AutoConnectCredential( uint16_t offset); Specify offset from the top of the EEPROM for the credential storage area together. The offset value is from 0 to the flash sector size. Public member functions \u00b6 uint8_t entries() Returns number of entries as contained credentials. int8_t load(const char* ssid , struct station_config* config ) Load a credential entry specified ssid to config . Returns -1 as unsuccessfully loaded. bool load(int8_t entry , struct station_config* config ) Load a credential entry to config . The entry parameter specify to index of the entry. bool save(const struct station_config* config ) Save a credential entry stored in config to EEPROM. Returns the true as succeeded. bool del(const char* ssid ) Delete a credential entry specified ssid . Returns the true as successfully deleted. Data structures \u00b6 station_config A structure is included in the ESP8266 SDK. You can use it in the sketch like as follows. extern \"C\" { #include <user_interface.h> } struct station_config { uint8 ssid[ 32 ]; uint8 password[ 64 ]; uint8 bssid_set; uint8 bssid[ 6 ]; }; EEPROM data structure A data structure of the credential saving area in EEPROM as the below. 1 Byte offset Length Value 0 8 AC_CREDT 8 1 Number of contained entries (uint8_t) 9 2 Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). 11 variable SSID terminated by 0x00. Max length is 32 bytes. variable variable Password plain text terminated by 0x00. Max length is 64 bytes. variable 6 BSSID variable Contained the next entries. (Continuation SSID+Password+BSSID) variable 1 0x00. End of container. Hint With the ESPShaker , you can access EEPROM interactively from the serial monitor, and of course you can erase saved credentials. How locate the link button to the AutoConnect menu? \u00b6 Link button to AutoConnect menu can be embedded into Sketch's web page. The root path of the menu is /_ac by default and embed the following <a></a> tag in the generating HTML. < a style = \"background-color:SteelBlue; display:inline-block; padding:7px 13px; text-decoration:none;\" href = \"/_ac\" > MENU </ a > How much memory does AutoConnect consume? \u00b6 Sketch size \u00b6 It increases about 53K bytes compared to the case without AutoConnect. A sketch size of the most simple example introduced in the Getting started is about 330K bytes. (270K byte without AutoConnect) Heap size \u00b6 It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed. I cannot complete to Wi-Fi login from smartphone. \u00b6 Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu. I cannot see the custom Web page. \u00b6 If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the AC_DEBUG and rerun. If you take the message of JSON syntax error, the Json Assistant helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect. AutoConnect behaves not stable with my sketch yet. \u00b6 If AutoConnect behavior is not stable with your sketch, you can try the following measures. 1. Change WiFi channel \u00b6 Both ESP8266 and ESP32 can only work on one channel at any given moment, this will cause loss of connection on the channel where your station operates the captive portal. If the channel of the AP which you want to connect is different from the SoftAP channel, the operation of the captive portal will not respond with the screen of the AutoConnect connection attempt remains displayed. In such a case please try the AutoConnectConfig to match the channel to the access point. 2. Change arduino core version \u00b6 I recommend change installed an arduino core version to the upstream when your sketch is not stable with AutoConnect on each board. with ESP8266 arduino core \u00b6 To stabilize the behavior, You can select the lwIP variant to contribute. Lower memory option of Arduino IDE for core version 2.4.2 is based on the lwIP-v2. On the other hand, the core version 2.5.0 upstream is based on the lwIP-2.1.2 stable release. You can select the option from Arduino IDE as Tool menu, if you are using ESP8266 core 2.5.0. It can be select lwIP v2 Lower Memory option. (not lwIP v2 Lower Memory (no features) ) It is expected to improve response performance and stability. with ESP32 arduino core \u00b6 The arduino-esp32 is still under development even if it is a stable release. It is necessary to judge whether the cause of the problem is the core or AutoConnect. Trace the log with the esp32 core and the AutoConnect debug option enabled for problem diagnosis and please you check the issue of arduino-esp32 . The problem that your sketch possesses may already have been solved. 3. Turn on the debug log options \u00b6 To fully enable for the AutoConnect debug logging options, change the following two files. AutoConnectDefs.h #define AC_DEBUG PageBuilder.h 2 #define PB_DEBUG 4. Reports the issue to AutoConnect repository on Github \u00b6 If you can not solve AutoConnect problems please report to Issues . And please make your question comprehensively, not a statement. Include all relevant information as follows. Hardware module Arduino core Version (including the upstream tag ID.) Operating System which you use lwIP variant Problem description If you have a STACK DUMP decoded result with formatted by the code block tag The sketch code with formatted by the code block tag Debug messages output There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused. \u21a9 PageBuilder.h file exists in the libraries/PageBuilder/src directory under your sketch folder. \u21a9","title":"FAQ"},{"location":"faq.html#after-connected-autoconnect-menu-performs-but-no-happens","text":"If you can access the AutoConnect root path as http://ESP8266IPADDRESS/_ac from browser, probably the sketch uses ESP8266WebServer::handleClient() without AutoConnect::handleRequest() . For AutoConnect menus to work properly, call AutoConnect::handleRequest() after ESP8266WebServer::handleClient() invoked, or use AutoConnect::handleClient() . AutoConnect::handleClient() is equivalent ESP8266WebServer::handleClient combined AutoConnect::handleRequest() . See also the explanation here .","title":" After connected, AutoConnect menu performs but no happens."},{"location":"faq.html#an-esp8266ap-as-softap-was-connected-but-captive-portal-does-not-start","text":"Captive portal detection could not be trapped. It is necessary to disconnect and reset ESP8266 to clear memorized connection data in ESP8266. Also, It may be displayed on the smartphone if the connection information of esp8266ap is wrong. In that case, delete the connection information of esp8266ap memorized by the smartphone once.","title":" An esp8266ap as SoftAP was connected but Captive portal does not start."},{"location":"faq.html#does-not-appear-esp8266ap-in-smartphone","text":"Maybe it is successfully connected at the first WiFi.begin . ESP8266 remembers the last SSID successfully connected and will use at the next. It means SoftAP will only start up when the first WiFi.begin() fails. The saved SSID would be cleared by WiFi.disconnect() with WIFI_STA mode. If you do not want automatic reconnection, you can erase the memorized SSID with the following simple sketch. #include <ESP8266WiFi.h> void setup () { delay( 1000 ); Serial.begin( 115200 ); WiFi.mode(WIFI_STA); delay( 100 ); WiFi.begin(); if (WiFi.waitForConnectResult() == WL_CONNECTED) { WiFi.disconnect(); while (WiFi.status() == WL_CONNECTED) delay( 100 ); } Serial.println( \"WiFi disconnected.\" ); } void loop () { delay( 1000 ); } You can interactively check the WiFi state of ESP8266. Please try ESPShaker . It is ESP8266 interactive serial command processor.","title":" Does not appear esp8266ap in smartphone."},{"location":"faq.html#does-not-response-from-95ac","text":"Probably WiFi.begin failed with the specified SSID. Activating the debug printing will help you to track down the cause.","title":" Does not response from /_ac."},{"location":"faq.html#how-change-esp8266ap-for-ssid-name-in-captive-portal","text":"An esp8266ap is default SSID name for SoftAP of captive portal and password is 12345678 . You can change both by using AutoConnectConfig .","title":" How change esp8266ap for SSID name in Captive portal?"},{"location":"faq.html#how-change-http-port","text":"HTTP port number is defined as a macro in AutoConnect.h header file. You can change it directly with several editors and must re-compile. #define AUTOCONNECT_HTTPPORT 80","title":" How change HTTP port?"},{"location":"faq.html#hang-up-after-reset","text":"If ESP8266 hang up after reset by AutoConnect menu, perhaps manual reset is not yet. Especially if it is not manual reset yet after uploading the sketch, the boot mode will stay 'Uart Download'. There is some discussion about this on the Github's ESP8266 core: https://github.com/esp8266/Arduino/issues/1017 If you received the following message, the boot mode is still sketch uploaded. It needs to the manual reset once. ets Jan 8 2013,rst cause:2, boot mode:(1,6) or (1,7) ets Jan 8 2013,rst cause:4, boot mode:(1,6) or (1,7) wdt reset The correct boot mode for starting the sketch is (3, x) . ESP8266 Boot Messages It is described by ESP8266 Non-OS SDK API Reference , section A.5. Messages Description rst cause 1: power on 2: external reset 4: hardware watchdog reset boot mode (the first parameter) 1: ESP8266 is in UART-down mode (and downloads firmware into flash). 3: ESP8266 is in Flash-boot mode (and boots up from flash).","title":" Hang up after Reset?"},{"location":"faq.html#how-erase-the-credentials-saved-in-eeprom","text":"Make some sketches for erasing the EEPROM area, or some erasing utility is needed. You can prepare the sketch to erase the saved credential with AutoConnectCredential . The AutoConnectCrendential class provides the access method to the saved credential in EEPROM and library source file is including it. A class description of AutoConnectCredential is follows.","title":" How erase the credentials saved in EEPROM?"},{"location":"faq.html#include-header","text":"#include <AutoConnectCredential.h>","title":"Include header"},{"location":"faq.html#constructor","text":"AutoConnectCredential(); AutoConnectCredential default constructor. The default offset value is 0. If the offset value is 0, the credential storage area starts from the top of the EEPROM. AutoConnect sometimes overwrites data when using this area with user sketch. AutoConnectCredential( uint16_t offset); Specify offset from the top of the EEPROM for the credential storage area together. The offset value is from 0 to the flash sector size.","title":"Constructor"},{"location":"faq.html#public-member-functions","text":"uint8_t entries() Returns number of entries as contained credentials. int8_t load(const char* ssid , struct station_config* config ) Load a credential entry specified ssid to config . Returns -1 as unsuccessfully loaded. bool load(int8_t entry , struct station_config* config ) Load a credential entry to config . The entry parameter specify to index of the entry. bool save(const struct station_config* config ) Save a credential entry stored in config to EEPROM. Returns the true as succeeded. bool del(const char* ssid ) Delete a credential entry specified ssid . Returns the true as successfully deleted.","title":"Public member functions"},{"location":"faq.html#data-structures","text":"station_config A structure is included in the ESP8266 SDK. You can use it in the sketch like as follows. extern \"C\" { #include <user_interface.h> } struct station_config { uint8 ssid[ 32 ]; uint8 password[ 64 ]; uint8 bssid_set; uint8 bssid[ 6 ]; }; EEPROM data structure A data structure of the credential saving area in EEPROM as the below. 1 Byte offset Length Value 0 8 AC_CREDT 8 1 Number of contained entries (uint8_t) 9 2 Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). 11 variable SSID terminated by 0x00. Max length is 32 bytes. variable variable Password plain text terminated by 0x00. Max length is 64 bytes. variable 6 BSSID variable Contained the next entries. (Continuation SSID+Password+BSSID) variable 1 0x00. End of container. Hint With the ESPShaker , you can access EEPROM interactively from the serial monitor, and of course you can erase saved credentials.","title":"Data structures"},{"location":"faq.html#how-locate-the-link-button-to-the-autoconnect-menu","text":"Link button to AutoConnect menu can be embedded into Sketch's web page. The root path of the menu is /_ac by default and embed the following <a></a> tag in the generating HTML. < a style = \"background-color:SteelBlue; display:inline-block; padding:7px 13px; text-decoration:none;\" href = \"/_ac\" > MENU </ a >","title":" How locate the link button to the  AutoConnect menu?"},{"location":"faq.html#how-much-memory-does-autoconnect-consume","text":"","title":" How much memory does AutoConnect consume?"},{"location":"faq.html#sketch-size","text":"It increases about 53K bytes compared to the case without AutoConnect. A sketch size of the most simple example introduced in the Getting started is about 330K bytes. (270K byte without AutoConnect)","title":"Sketch size"},{"location":"faq.html#heap-size","text":"It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed.","title":"Heap size"},{"location":"faq.html#i-cannot-complete-to-wi-fi-login-from-smartphone","text":"Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu.","title":" I cannot complete to Wi-Fi login from smartphone."},{"location":"faq.html#i-cannot-see-the-custom-web-page","text":"If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the AC_DEBUG and rerun. If you take the message of JSON syntax error, the Json Assistant helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect.","title":" I cannot see the custom Web page."},{"location":"faq.html#autoconnect-behaves-not-stable-with-my-sketch-yet","text":"If AutoConnect behavior is not stable with your sketch, you can try the following measures.","title":" AutoConnect behaves not stable with my sketch yet."},{"location":"faq.html#1-change-wifi-channel","text":"Both ESP8266 and ESP32 can only work on one channel at any given moment, this will cause loss of connection on the channel where your station operates the captive portal. If the channel of the AP which you want to connect is different from the SoftAP channel, the operation of the captive portal will not respond with the screen of the AutoConnect connection attempt remains displayed. In such a case please try the AutoConnectConfig to match the channel to the access point.","title":"1. Change WiFi channel"},{"location":"faq.html#2-change-arduino-core-version","text":"I recommend change installed an arduino core version to the upstream when your sketch is not stable with AutoConnect on each board.","title":"2. Change arduino core version"},{"location":"faq.html#with-esp8266-arduino-core","text":"To stabilize the behavior, You can select the lwIP variant to contribute. Lower memory option of Arduino IDE for core version 2.4.2 is based on the lwIP-v2. On the other hand, the core version 2.5.0 upstream is based on the lwIP-2.1.2 stable release. You can select the option from Arduino IDE as Tool menu, if you are using ESP8266 core 2.5.0. It can be select lwIP v2 Lower Memory option. (not lwIP v2 Lower Memory (no features) ) It is expected to improve response performance and stability.","title":"with ESP8266 arduino core"},{"location":"faq.html#with-esp32-arduino-core","text":"The arduino-esp32 is still under development even if it is a stable release. It is necessary to judge whether the cause of the problem is the core or AutoConnect. Trace the log with the esp32 core and the AutoConnect debug option enabled for problem diagnosis and please you check the issue of arduino-esp32 . The problem that your sketch possesses may already have been solved.","title":"with ESP32 arduino core"},{"location":"faq.html#3-turn-on-the-debug-log-options","text":"To fully enable for the AutoConnect debug logging options, change the following two files. AutoConnectDefs.h #define AC_DEBUG PageBuilder.h 2 #define PB_DEBUG","title":"3. Turn on the debug log options"},{"location":"faq.html#4-reports-the-issue-to-autoconnect-repository-on-github","text":"If you can not solve AutoConnect problems please report to Issues . And please make your question comprehensively, not a statement. Include all relevant information as follows. Hardware module Arduino core Version (including the upstream tag ID.) Operating System which you use lwIP variant Problem description If you have a STACK DUMP decoded result with formatted by the code block tag The sketch code with formatted by the code block tag Debug messages output There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused. \u21a9 PageBuilder.h file exists in the libraries/PageBuilder/src directory under your sketch folder. \u21a9","title":"4. Reports the issue to AutoConnect repository on Github"},{"location":"gettingstarted.html","text":"Let's do the most simple sketch \u00b6 Open the Arduino IDE, write the following sketch and upload it. The feature of this sketch is that the SSID and Password are not coded. #include <ESP8266WiFi.h> // Replace with WiFi.h for ESP32 #include <ESP8266WebServer.h> // Replace with WebServer.h for ESP32 #include <AutoConnect.h> ESP8266WebServer Server; // Replace with WebServer for ESP32 AutoConnect Portal (Server); void rootPage () { char content[] = \"Hello, world\" ; Server.send( 200 , \"text/plain\" , content); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); Server.on( \"/\" , rootPage); if (Portal.begin()) { Serial.println( \"WiFi connected: \" + WiFi.localIP().toString()); } } void loop () { Portal.handleClient(); } The above code can be applied to ESP8266. To apply to ESP32, replace ESP8266WebServer class with WebServer and include WiFi.h and WebServer.h of arduino-esp32 appropriately. Run at first \u00b6 After about 30 seconds, if the ESP8266 cannot connect to nearby Wi-Fi spot, you pull out your smartphone and open Wi-Fi settings from the Settings Apps. You can see the esp8266ap 1 in the list of \"CHOOSE A NETWORK...\" . Then tap the esp8266ap and enter password 12345678 , a something screen pops up automatically as shown below. This is the AutoConnect statistics screen. This screen displays the current status of the established connection, WiFi mode, IP address, free memory size, and etc. Also, the hamburger icon is the control menu of AutoConnect seems at the upper right. By tap the hamburger icon, the control menu appears as the below. Join to the new access point \u00b6 Here, tap \"Configure new AP\" to connect the new access point then the SSID configuration screen would be shown. Enter the SSID and Passphrase and tap apply to start connecting the access point. Connection establishment \u00b6 After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step. For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to \" Log in \" by upper right on the screen. Or, \" RESET \" can be selected. The ESP8266 resets and reboots. After that, immediately before the connection will be restored automatically with WIFI_STA mode. Run for usually \u00b6 The IP address of ESP8266 would be displayed on the serial monitor after connection restored. Please access its address from the browser. The \"Hello, world\" page will respond. It's the page that was handled by in the sketch with \" on \" function of ESP8266WebServer . window.onload = function() { Gifffer(); }; When applied to ESP32, SSID will appear as esp32ap . \u21a9","title":"Getting started"},{"location":"gettingstarted.html#lets-do-the-most-simple-sketch","text":"Open the Arduino IDE, write the following sketch and upload it. The feature of this sketch is that the SSID and Password are not coded. #include <ESP8266WiFi.h> // Replace with WiFi.h for ESP32 #include <ESP8266WebServer.h> // Replace with WebServer.h for ESP32 #include <AutoConnect.h> ESP8266WebServer Server; // Replace with WebServer for ESP32 AutoConnect Portal (Server); void rootPage () { char content[] = \"Hello, world\" ; Server.send( 200 , \"text/plain\" , content); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); Server.on( \"/\" , rootPage); if (Portal.begin()) { Serial.println( \"WiFi connected: \" + WiFi.localIP().toString()); } } void loop () { Portal.handleClient(); } The above code can be applied to ESP8266. To apply to ESP32, replace ESP8266WebServer class with WebServer and include WiFi.h and WebServer.h of arduino-esp32 appropriately.","title":"Let's do the most simple sketch"},{"location":"gettingstarted.html#run-at-first","text":"After about 30 seconds, if the ESP8266 cannot connect to nearby Wi-Fi spot, you pull out your smartphone and open Wi-Fi settings from the Settings Apps. You can see the esp8266ap 1 in the list of \"CHOOSE A NETWORK...\" . Then tap the esp8266ap and enter password 12345678 , a something screen pops up automatically as shown below. This is the AutoConnect statistics screen. This screen displays the current status of the established connection, WiFi mode, IP address, free memory size, and etc. Also, the hamburger icon is the control menu of AutoConnect seems at the upper right. By tap the hamburger icon, the control menu appears as the below.","title":" Run at first"},{"location":"gettingstarted.html#join-to-the-new-access-point","text":"Here, tap \"Configure new AP\" to connect the new access point then the SSID configuration screen would be shown. Enter the SSID and Passphrase and tap apply to start connecting the access point.","title":" Join to the new access point"},{"location":"gettingstarted.html#connection-establishment","text":"After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step. For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to \" Log in \" by upper right on the screen. Or, \" RESET \" can be selected. The ESP8266 resets and reboots. After that, immediately before the connection will be restored automatically with WIFI_STA mode.","title":" Connection establishment"},{"location":"gettingstarted.html#run-for-usually","text":"The IP address of ESP8266 would be displayed on the serial monitor after connection restored. Please access its address from the browser. The \"Hello, world\" page will respond. It's the page that was handled by in the sketch with \" on \" function of ESP8266WebServer . window.onload = function() { Gifffer(); }; When applied to ESP32, SSID will appear as esp32ap . \u21a9","title":" Run for usually"},{"location":"howtoembed.html","text":"Embed the AutoConnect to the sketch \u00b6 Here holds two case examples. Both examples perform the same function. Only how to incorporate the AutoConnect into the sketch differs. Also included in the sample folder, HandlePortal.ino also shows how to use the PageBuilder library for HTML assemblies. What does this example do? \u00b6 Uses the web interface to light the LED connected to the NodeMCU module D0 port (which could be referred to as BUILTIN_LED ), the following animation is it. Access to the ESP8266 module connected WiFi from the browser then the page contains the current value of the D0 port would be displayed. The page has the buttons to switch the port value. The LED blinks according to the value of the button that was clicked. This example is a typical sketch of manipulating ESP8266's GPIO via WLAN. Embed AutoConnect library into this sketch. There are few places to be changed. And you can use AutoConnect's captive portal function to establish a connection freely to other WiFi spots. Embed AutoConnect \u00b6 Pattern A. \u00b6 Bind to ESP8266WebServer, performs handleClient with handleRequest. In what situations should the handleRequest be used. It is something needs to be done immediately after the handle client. It is better to call only AutoConnect::handleClient whenever possible. Pattern B. \u00b6 Declare only AutoConnect, performs handleClient. Used with MQTT as a client application \u00b6 The effect of AutoConnect is not only for ESP8266/ESP32 as the web server. It has advantages for something WiFi client as well. For example, AutoConnect is also effective for publishing MQTT messages from various measurement points. Even if the SSID is different for each measurement point, it is not necessary to modify the sketch. This example tries to publish the WiFi signal strength of ESP8266 with MQTT. It uses the ThingSpeak for MQTT broker. ESP8266 publishes the RSSI value to the channel created on ThingSpeak as MQTT client . This example is well suited to demonstrate the usefulness of AutoConnect, as RSSI values are measured at each access point usually. Just adding a few lines of code makes it unnecessary to upload sketches with the different SSIDs rewrite for each access point. Advance procedures \u00b6 Arduino Client for MQTT - It's the PubSubClient , install it to Arduino IDE. If you have the latest version already, this step does not need. Create a channel on ThingSpeak. Get the Channel API Keys from ThingSpeak, put its keys to the sketch. The ThingSpeak is the open IoT platform. It is capable of sending data privately to the cloud and analyzing, visualizing its data. If you do not have an account of ThingSpeak, you need that account to proceed further. ThingSpeak has the free plan for the account which uses within the scope of this example. 1 You can sign up with the ThingSpeak sign-up page . Whether you should do sign-up or not. You are entrusted with the final judgment of account creation for ThingSpeak. Create an account at your own risk. Create a channel on ThingSpeak \u00b6 Sign in ThingSpeak. Select Channels to show the My Channels , then click New Channel . At the New Channel screen, enter each field as a below. And click Save Channel at the bottom of the screen to save. Name: ESP8266 Signal Strength Description: ESP8266 RSSI publish Field1: RSSI Get Channel ID and API Keys \u00b6 The channel successfully created, you can see the channel status screen as a below. Channel ID is displayed there. 2 Here, switch the channel status tab to API Keys . The API key required to publish the message is the Write API Key . The last key you need is the User API Key and can be confirmed it in the user profile. Pull down Account from the top menu, select My profile . Then you can see the ThingSpeak settings and the User API Key is displayed middle of this screen. The sketch, Publishes messages \u00b6 The complete code of the sketch is mqttRSSI.ino in the AutoConnect repository . Replace the following #define in a sketch with User API Key , Write API Key and Channel ID . After Keys updated, compile the sketch and upload it. #define MQTT_USER_KEY \"****************\" // Replace to User API Key. #define CHANNEL_ID \"******\" // Replace to Channel ID. #define CHANNEL_API_KEY_WR \"****************\" // Replace to the write API Key. Publish messages \u00b6 After upload and reboot complete, the message publishing will start via the access point now set. The message carries RSSI as the current WiFi signal strength. The signal strength variations in RSSI are displayed on ThingSpeak's Channel status screen. How embed to your sketches \u00b6 For the client sketches, the code required to connect to WiFi is the following four parts only. #include directive 3 Include AutoConnect.h header file behind the include of ESP8266WiFi.h . Declare AutoConnect The declaration of the AutoConnect variable is not accompanied by ESP8266WebServer. Invokes \"begin()\" Call AutoConnect::begin . If you need to assign a static IP address, executes AutoConnectConfig before that. Performs \"handleClent()\" in \"loop()\" Invokes AutoConnect::handleClient() at inside loop() to enable the AutoConnect menu. window.onload = function() { Gifffer(); }; As of March 21, 2018. \u21a9 '454951' in the example above, but your channel ID should be different. \u21a9 #include <ESP8266WebServer.h> does not necessary for uses only client. \u21a9","title":"How to embed"},{"location":"howtoembed.html#embed-the-autoconnect-to-the-sketch","text":"Here holds two case examples. Both examples perform the same function. Only how to incorporate the AutoConnect into the sketch differs. Also included in the sample folder, HandlePortal.ino also shows how to use the PageBuilder library for HTML assemblies.","title":"Embed the AutoConnect to the sketch"},{"location":"howtoembed.html#what-does-this-example-do","text":"Uses the web interface to light the LED connected to the NodeMCU module D0 port (which could be referred to as BUILTIN_LED ), the following animation is it. Access to the ESP8266 module connected WiFi from the browser then the page contains the current value of the D0 port would be displayed. The page has the buttons to switch the port value. The LED blinks according to the value of the button that was clicked. This example is a typical sketch of manipulating ESP8266's GPIO via WLAN. Embed AutoConnect library into this sketch. There are few places to be changed. And you can use AutoConnect's captive portal function to establish a connection freely to other WiFi spots.","title":"What does this example do?"},{"location":"howtoembed.html#embed-autoconnect","text":"","title":"Embed AutoConnect"},{"location":"howtoembed.html#pattern-a","text":"Bind to ESP8266WebServer, performs handleClient with handleRequest. In what situations should the handleRequest be used. It is something needs to be done immediately after the handle client. It is better to call only AutoConnect::handleClient whenever possible.","title":" Pattern A."},{"location":"howtoembed.html#pattern-b","text":"Declare only AutoConnect, performs handleClient.","title":" Pattern B."},{"location":"howtoembed.html#used-with-mqtt-as-a-client-application","text":"The effect of AutoConnect is not only for ESP8266/ESP32 as the web server. It has advantages for something WiFi client as well. For example, AutoConnect is also effective for publishing MQTT messages from various measurement points. Even if the SSID is different for each measurement point, it is not necessary to modify the sketch. This example tries to publish the WiFi signal strength of ESP8266 with MQTT. It uses the ThingSpeak for MQTT broker. ESP8266 publishes the RSSI value to the channel created on ThingSpeak as MQTT client . This example is well suited to demonstrate the usefulness of AutoConnect, as RSSI values are measured at each access point usually. Just adding a few lines of code makes it unnecessary to upload sketches with the different SSIDs rewrite for each access point.","title":"Used with MQTT as a client application"},{"location":"howtoembed.html#advance-procedures","text":"Arduino Client for MQTT - It's the PubSubClient , install it to Arduino IDE. If you have the latest version already, this step does not need. Create a channel on ThingSpeak. Get the Channel API Keys from ThingSpeak, put its keys to the sketch. The ThingSpeak is the open IoT platform. It is capable of sending data privately to the cloud and analyzing, visualizing its data. If you do not have an account of ThingSpeak, you need that account to proceed further. ThingSpeak has the free plan for the account which uses within the scope of this example. 1 You can sign up with the ThingSpeak sign-up page . Whether you should do sign-up or not. You are entrusted with the final judgment of account creation for ThingSpeak. Create an account at your own risk.","title":"Advance procedures"},{"location":"howtoembed.html#create-a-channel-on-thingspeak","text":"Sign in ThingSpeak. Select Channels to show the My Channels , then click New Channel . At the New Channel screen, enter each field as a below. And click Save Channel at the bottom of the screen to save. Name: ESP8266 Signal Strength Description: ESP8266 RSSI publish Field1: RSSI","title":"Create a channel on ThingSpeak"},{"location":"howtoembed.html#get-channel-id-and-api-keys","text":"The channel successfully created, you can see the channel status screen as a below. Channel ID is displayed there. 2 Here, switch the channel status tab to API Keys . The API key required to publish the message is the Write API Key . The last key you need is the User API Key and can be confirmed it in the user profile. Pull down Account from the top menu, select My profile . Then you can see the ThingSpeak settings and the User API Key is displayed middle of this screen.","title":"Get Channel ID and API Keys"},{"location":"howtoembed.html#the-sketch-publishes-messages","text":"The complete code of the sketch is mqttRSSI.ino in the AutoConnect repository . Replace the following #define in a sketch with User API Key , Write API Key and Channel ID . After Keys updated, compile the sketch and upload it. #define MQTT_USER_KEY \"****************\" // Replace to User API Key. #define CHANNEL_ID \"******\" // Replace to Channel ID. #define CHANNEL_API_KEY_WR \"****************\" // Replace to the write API Key.","title":"The sketch, Publishes messages"},{"location":"howtoembed.html#publish-messages","text":"After upload and reboot complete, the message publishing will start via the access point now set. The message carries RSSI as the current WiFi signal strength. The signal strength variations in RSSI are displayed on ThingSpeak's Channel status screen.","title":"Publish messages"},{"location":"howtoembed.html#how-embed-to-your-sketches","text":"For the client sketches, the code required to connect to WiFi is the following four parts only. #include directive 3 Include AutoConnect.h header file behind the include of ESP8266WiFi.h . Declare AutoConnect The declaration of the AutoConnect variable is not accompanied by ESP8266WebServer. Invokes \"begin()\" Call AutoConnect::begin . If you need to assign a static IP address, executes AutoConnectConfig before that. Performs \"handleClent()\" in \"loop()\" Invokes AutoConnect::handleClient() at inside loop() to enable the AutoConnect menu. window.onload = function() { Gifffer(); }; As of March 21, 2018. \u21a9 '454951' in the example above, but your channel ID should be different. \u21a9 #include <ESP8266WebServer.h> does not necessary for uses only client. \u21a9","title":"How embed to your sketches"},{"location":"license.html","text":"MIT License Copyright \u00a9 2018 Hieromon Ikasamo Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Acknowledgments The Luxbar is licensed under the MIT License. https://github.com/balzss/luxbar ArduinoJson is licensed under the MIT License. https://arduinojson.org/","title":"License"},{"location":"menu.html","text":"Luxbar The AutoConnect menu is developed using the LuxBar which is licensed under the MIT License. See the License . Where the from \u00b6 The AutoConnect menu appears when you access the AutoConnect root path . It is assigned \" /_ac \" located on the local IP address of ESP8266/ESP32 module by default. This location can be changed in the sketch. The following screen will appear at access to http://{localIP}/_ac as the root path. This is the statistics of the current WiFi connection. You can access the menu from the here, to invoke it tap at right on top. (e.g. http://192.168.244.1/_ac for SoftAP mode.) What's the local IP? A local IP means Local IP at connection established or SoftAP's IP. Right on top \u00b6 Currently, AutoConnect supports four menus. Undermost menu as \"HOME\" returns to the home path of its sketch. Configure new AP : Configure SSID and Password for new access point. Open SSIDs : Opens the past SSID which has been established connection from EEPROM. Disconnect : Disconnects current connection. Reset... : Rest the ESP8266/ESP32 module. HOME : Return to user home page. Configure new AP \u00b6 Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The is indicated for the SSID that needs a security key. \" Hidden: \" means the number of hidden SSIDs discovered. Enter SSID and Passphrase and tap \" apply \" to starts WiFi connection. Open SSIDs \u00b6 Once it was established WiFi connection, its SSID and password will be saved in EEPROM of ESP8266/ESP32 automatically. The Open SSIDs menu reads the saved SSID credentials from the EEPROM. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it. Disconnect \u00b6 Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using API in the sketch. After tapping \"Disconnect\", you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting the WLAN. Reset... \u00b6 Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complete, the ESP8266/ESP32 module begins establishing the previous connection with WIFI_STA mode, and esp8266ap or esp32ap of an access point will disappear from WLAN. Not every ESP8266 module will be rebooted normally The Reset menu is using the ESP.reset() function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the state of GPIO0 is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also FAQ . Custom menu items \u00b6 The menu items of the custom Web page line up at the below in the AutoConnect menu if the custom Web pages are joined. Details for Custom Web pages in AutoConnect menu . HOME \u00b6 A HOME item located at the bottom of the menu list is a link to the home path. The URI as the home path is / by default, and it is defined by AUTOCONNECT_HOMEURI with AutoConnectDefs.h file. #define AUTOCONNECT_HOMEURI \"/\" You can change the HOME path using the AutoConnect API. The AutoConnect::home function sets the URI as a link of the HOME item of the AutoConnect menu. Extend AutoConnect menu with your sketches \u00b6 The AutoConnect menu can contain HTML pages of your sketch as custom items. It works for HTML pages implemented by ESP8266WebServer::on handler or WebServer::on handler for ESP32. That is, you can make it as menu items to invoke the legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as FSBrowser to the AutoConnect menu item. It adds Edit and List items with little modification of the legacy sketch code. You can extend the AutoConnect menu to match legacy sketches and according to the procedure described in the Advanced Usage section .","title":"AutoConnect menu"},{"location":"menu.html#where-the-from","text":"The AutoConnect menu appears when you access the AutoConnect root path . It is assigned \" /_ac \" located on the local IP address of ESP8266/ESP32 module by default. This location can be changed in the sketch. The following screen will appear at access to http://{localIP}/_ac as the root path. This is the statistics of the current WiFi connection. You can access the menu from the here, to invoke it tap at right on top. (e.g. http://192.168.244.1/_ac for SoftAP mode.) What's the local IP? A local IP means Local IP at connection established or SoftAP's IP.","title":" Where the from"},{"location":"menu.html#right-on-top","text":"Currently, AutoConnect supports four menus. Undermost menu as \"HOME\" returns to the home path of its sketch. Configure new AP : Configure SSID and Password for new access point. Open SSIDs : Opens the past SSID which has been established connection from EEPROM. Disconnect : Disconnects current connection. Reset... : Rest the ESP8266/ESP32 module. HOME : Return to user home page.","title":" Right on top"},{"location":"menu.html#configure-new-ap","text":"Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The is indicated for the SSID that needs a security key. \" Hidden: \" means the number of hidden SSIDs discovered. Enter SSID and Passphrase and tap \" apply \" to starts WiFi connection.","title":" Configure new AP"},{"location":"menu.html#open-ssids","text":"Once it was established WiFi connection, its SSID and password will be saved in EEPROM of ESP8266/ESP32 automatically. The Open SSIDs menu reads the saved SSID credentials from the EEPROM. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it.","title":" Open SSIDs"},{"location":"menu.html#disconnect","text":"Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using API in the sketch. After tapping \"Disconnect\", you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting the WLAN.","title":" Disconnect"},{"location":"menu.html#reset","text":"Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complete, the ESP8266/ESP32 module begins establishing the previous connection with WIFI_STA mode, and esp8266ap or esp32ap of an access point will disappear from WLAN. Not every ESP8266 module will be rebooted normally The Reset menu is using the ESP.reset() function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the state of GPIO0 is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also FAQ .","title":" Reset..."},{"location":"menu.html#custom-menu-items","text":"The menu items of the custom Web page line up at the below in the AutoConnect menu if the custom Web pages are joined. Details for Custom Web pages in AutoConnect menu .","title":" Custom menu items"},{"location":"menu.html#home","text":"A HOME item located at the bottom of the menu list is a link to the home path. The URI as the home path is / by default, and it is defined by AUTOCONNECT_HOMEURI with AutoConnectDefs.h file. #define AUTOCONNECT_HOMEURI \"/\" You can change the HOME path using the AutoConnect API. The AutoConnect::home function sets the URI as a link of the HOME item of the AutoConnect menu.","title":" HOME"},{"location":"menu.html#extend-autoconnect-menu-with-your-sketches","text":"The AutoConnect menu can contain HTML pages of your sketch as custom items. It works for HTML pages implemented by ESP8266WebServer::on handler or WebServer::on handler for ESP32. That is, you can make it as menu items to invoke the legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as FSBrowser to the AutoConnect menu item. It adds Edit and List items with little modification of the legacy sketch code. You can extend the AutoConnect menu to match legacy sketches and according to the procedure described in the Advanced Usage section .","title":" Extend AutoConnect menu with your sketches"},{"location":"menuize.html","text":"What menus can be made using AutoConnect \u00b6 AutoConnect generates a menu dynamically depending on the instantiated AutoConnectAux at the sketch executing time. Usually, it is a collection of AutoConnectElement . In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. In other words, you can easily create a built-in menu featuring the WiFi connection facility embedding the legacy web pages. Basic mechanism of menu generation \u00b6 The sketch can display the AutoConnect menu by following three patterns depending on AutoConnect-API usage. \u2002 Basic menu It is the most basic menu for only connecting WiFi. Sketch can automatically display this menu with the basic call sequence of the AutoConnect API which invokes AutoConnect::begin and AutoConnect::handleClient . \u2002 Extra menu with custom Web pages which is consisted by AutoConnectElements It is an extended menu that appears when the sketch consists of the custom Web pages with AutoConnectAux and AutoConnectElements. Refer to Custom Web pages section . \u2002 Extra menu which contains legacy pages It is for the legacy sketches using the on handler of ESP8266WebServer/WebServer(for ESP32) class natively and looks the same as the extra menu as above. The mechanism to generate the AutoConnect menu is simple. It will insert the item as <li> tag generated from the title and uri member variable of the AutoConnectAux object to the menu list of AutoConnect's built-in HTML. Therefore, the legacy sketches can invoke the web pages from the AutoConnect menu with just declaration the title and URI to AutoConnectAux. Place the item for the legacy sketches on the menu \u00b6 To implement this with your sketch, use only the AutoConnectAux constructed with the title and URI of that page. AutoConnectElements is not required. The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for Edit and List . The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows: Add AutoConnect declaration. Add the menu item named \" Edit \" and \" List \" of AutoConnectAux as each page. Replace the instance of ESP8266WebServer to AutoConnect. Change the menu title to FSBrowser using AutoConnectConfig::title . Join the legacy pages to AutoConnect declared at step #1 using AutoConnect::join . Joining multiple at one time with std::vector 's' list initialization . According to the basic procedure of AutoConnect. Establish a connection with AutoConnect::begin and perform AutoConnect::handleClient in loop() . \u2002 Modification for FSBrowser (part of sketch code) window.onload = function() { Gifffer(); };","title":"Constucting the menu"},{"location":"menuize.html#what-menus-can-be-made-using-autoconnect","text":"AutoConnect generates a menu dynamically depending on the instantiated AutoConnectAux at the sketch executing time. Usually, it is a collection of AutoConnectElement . In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. In other words, you can easily create a built-in menu featuring the WiFi connection facility embedding the legacy web pages.","title":"What menus can be made using AutoConnect"},{"location":"menuize.html#basic-mechanism-of-menu-generation","text":"The sketch can display the AutoConnect menu by following three patterns depending on AutoConnect-API usage. \u2002 Basic menu It is the most basic menu for only connecting WiFi. Sketch can automatically display this menu with the basic call sequence of the AutoConnect API which invokes AutoConnect::begin and AutoConnect::handleClient . \u2002 Extra menu with custom Web pages which is consisted by AutoConnectElements It is an extended menu that appears when the sketch consists of the custom Web pages with AutoConnectAux and AutoConnectElements. Refer to Custom Web pages section . \u2002 Extra menu which contains legacy pages It is for the legacy sketches using the on handler of ESP8266WebServer/WebServer(for ESP32) class natively and looks the same as the extra menu as above. The mechanism to generate the AutoConnect menu is simple. It will insert the item as <li> tag generated from the title and uri member variable of the AutoConnectAux object to the menu list of AutoConnect's built-in HTML. Therefore, the legacy sketches can invoke the web pages from the AutoConnect menu with just declaration the title and URI to AutoConnectAux.","title":"Basic mechanism of menu generation"},{"location":"menuize.html#place-the-item-for-the-legacy-sketches-on-the-menu","text":"To implement this with your sketch, use only the AutoConnectAux constructed with the title and URI of that page. AutoConnectElements is not required. The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for Edit and List . The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows: Add AutoConnect declaration. Add the menu item named \" Edit \" and \" List \" of AutoConnectAux as each page. Replace the instance of ESP8266WebServer to AutoConnect. Change the menu title to FSBrowser using AutoConnectConfig::title . Join the legacy pages to AutoConnect declared at step #1 using AutoConnect::join . Joining multiple at one time with std::vector 's' list initialization . According to the basic procedure of AutoConnect. Establish a connection with AutoConnect::begin and perform AutoConnect::handleClient in loop() . \u2002 Modification for FSBrowser (part of sketch code) window.onload = function() { Gifffer(); };","title":"Place the item for the legacy sketches on the menu"},{"location":"wojson.html","text":"Suppress increase in memory consumption \u00b6 Custom Web page processing consumes a lot of memory. AutoConnect will take a whole string of the JSON document for the custom Web pages into memory. The required buffer size for the JSON document of example sketch mqttRSSI reaches approximately 3000 bytes. And actually, it needs twice the heap area. Especially this constraint will be a problem with the ESP8266 which has a heap size poor. AutoConnect can handle custom Web pages without using JSON. In that case, since the ArduinoJson library will not be bound, the sketch size will also be reduced. Writing the custom Web pages without JSON \u00b6 To handle a custom Web page without using JSON, follow the steps below. Create or define AutoConnectAux for each page. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . In addition to the above procedure, to completely cut off for binding with the ArduinoJson library, turn off the ArduinoJson use indicator which is declared by the AutoConnect definitions . Its declaration is in AutoConnectDefs.h file. 1 // Comment out the AUTOCONNECT_USE_JSON macro to detach the ArduinoJson. #define AUTOCONNECT_USE_JSON JSON processing will be disabled Commenting out the AUTOCONNECT_USE_JSON macro invalidates all functions related to JSON processing. If the sketch is using the JSON function, it will result in a compile error. Implementation example without ArduinoJson \u00b6 The code excluding JSON processing from the mqttRSSI sketch attached to the library is as follows. (It is a part of code. Refer to mqttRSSI_NA.ino for the whole sketch.) The JSON document for mqttRSSI [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"<h2>MQTT broker settings</h2>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"style\" : \"font-family:serif;color:#4682b4;\" }, { \"name\" : \"mqttserver\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"Server\" , \"pattern\" : \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\\\-]*[a-zA-Z0-9])\\\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\\\-]*[A-Za-z0-9])$\" , \"placeholder\" : \"MQTT broker server\" }, { \"name\" : \"channelid\" , \"type\" : \"ACInput\" , \"label\" : \"Channel ID\" , \"pattern\" : \"^[0-9]{6}$\" }, { \"name\" : \"userkey\" , \"type\" : \"ACInput\" , \"label\" : \"User Key\" }, { \"name\" : \"apikey\" , \"type\" : \"ACInput\" , \"label\" : \"API Key\" }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"uniqueid\" , \"type\" : \"ACCheckbox\" , \"value\" : \"unique\" , \"label\" : \"Use APID unique\" , \"checked\" : false }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"label\" : \"Update period\" , \"arrange\" : \"vertical\" , \"checked\" : 1 }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"hostname\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"ESP host name\" , \"pattern\" : \"^([a-zA-Z0-9]([a-zA-Z0-9-])*[a-zA-Z0-9]){1,32}$\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"Save&amp;Start\" , \"uri\" : \"/mqtt_save\" }, { \"name\" : \"discard\" , \"type\" : \"ACSubmit\" , \"value\" : \"Discard\" , \"uri\" : \"/\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"<h4>Parameters saved as:</h4>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"parameters\" , \"type\" : \"ACText\" }, { \"name\" : \"clear\" , \"type\" : \"ACSubmit\" , \"value\" : \"Clear channel\" , \"uri\" : \"/mqtt_clear\" } ] } ] Exclude the JSON and replace to the AutoConnectElements natively // In the declaration, // Declare AutoConnectElements for the page asf /mqtt_setting ACText(header, \"<h2>MQTT broker settings</h2>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(caption, \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"font-family:serif;color:#4682b4;\" ); ACInput(mqttserver, \"\" , \"Server\" , \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9 \\\\ -]*[a-zA-Z0-9]) \\\\ .)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9 \\\\ -]*[A-Za-z0-9])$\" , \"MQTT broker server\" ); ACInput(channelid, \"\" , \"Channel ID\" , \"^[0-9]{6}$\" ); ACInput(userkey, \"\" , \"User Key\" ); ACInput(apikey, \"\" , \"API Key\" ); ACElement(newline, \"<hr>\" ); ACCheckbox(uniqueid, \"unique\" , \"Use APID unique\" ); ACRadio(period, { \"30 sec.\" , \"60 sec.\" , \"180 sec.\" }, \"Update period\" , AC_Vertical, 1 ); ACSubmit(save, \"Start\" , \"mqtt_save\" ); ACSubmit(discard, \"Discard\" , \"/\" ); // Declare the custom Web page as /mqtt_setting and contains the AutoConnectElements AutoConnectAux mqtt_setting ( \"/mqtt_setting\" , \"MQTT Setting\" , true, { header, caption, mqttserver, channelid, userkey, apikey, newline, uniqueid, period, newline, save, discard }); // Declare AutoConnectElements for the page as /mqtt_save ACText(caption2, \"<h4>Parameters available as:</h4>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(parameters); ACSubmit(clear, \"Clear channel\" , \"/mqtt_clear\" ); // Declare the custom Web page as /mqtt_save and contains the AutoConnectElements AutoConnectAux mqtt_save ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, parameters, clear }); // In the setup(), // Join the custom Web pages and performs begin portal.join({ mqtt_setting, mqtt_save }); portal.begin(); Detaching the ArduinoJson library reduces the sketch size by approximately 10K bytes. \u21a9","title":"Custom Web pages w/o JSON"},{"location":"wojson.html#suppress-increase-in-memory-consumption","text":"Custom Web page processing consumes a lot of memory. AutoConnect will take a whole string of the JSON document for the custom Web pages into memory. The required buffer size for the JSON document of example sketch mqttRSSI reaches approximately 3000 bytes. And actually, it needs twice the heap area. Especially this constraint will be a problem with the ESP8266 which has a heap size poor. AutoConnect can handle custom Web pages without using JSON. In that case, since the ArduinoJson library will not be bound, the sketch size will also be reduced.","title":"Suppress increase in memory consumption"},{"location":"wojson.html#writing-the-custom-web-pages-without-json","text":"To handle a custom Web page without using JSON, follow the steps below. Create or define AutoConnectAux for each page. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . In addition to the above procedure, to completely cut off for binding with the ArduinoJson library, turn off the ArduinoJson use indicator which is declared by the AutoConnect definitions . Its declaration is in AutoConnectDefs.h file. 1 // Comment out the AUTOCONNECT_USE_JSON macro to detach the ArduinoJson. #define AUTOCONNECT_USE_JSON JSON processing will be disabled Commenting out the AUTOCONNECT_USE_JSON macro invalidates all functions related to JSON processing. If the sketch is using the JSON function, it will result in a compile error.","title":"Writing the custom Web pages without JSON"},{"location":"wojson.html#implementation-example-without-arduinojson","text":"The code excluding JSON processing from the mqttRSSI sketch attached to the library is as follows. (It is a part of code. Refer to mqttRSSI_NA.ino for the whole sketch.) The JSON document for mqttRSSI [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"<h2>MQTT broker settings</h2>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"style\" : \"font-family:serif;color:#4682b4;\" }, { \"name\" : \"mqttserver\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"Server\" , \"pattern\" : \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\\\-]*[a-zA-Z0-9])\\\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\\\-]*[A-Za-z0-9])$\" , \"placeholder\" : \"MQTT broker server\" }, { \"name\" : \"channelid\" , \"type\" : \"ACInput\" , \"label\" : \"Channel ID\" , \"pattern\" : \"^[0-9]{6}$\" }, { \"name\" : \"userkey\" , \"type\" : \"ACInput\" , \"label\" : \"User Key\" }, { \"name\" : \"apikey\" , \"type\" : \"ACInput\" , \"label\" : \"API Key\" }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"uniqueid\" , \"type\" : \"ACCheckbox\" , \"value\" : \"unique\" , \"label\" : \"Use APID unique\" , \"checked\" : false }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"label\" : \"Update period\" , \"arrange\" : \"vertical\" , \"checked\" : 1 }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"hostname\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"ESP host name\" , \"pattern\" : \"^([a-zA-Z0-9]([a-zA-Z0-9-])*[a-zA-Z0-9]){1,32}$\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"Save&amp;Start\" , \"uri\" : \"/mqtt_save\" }, { \"name\" : \"discard\" , \"type\" : \"ACSubmit\" , \"value\" : \"Discard\" , \"uri\" : \"/\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"<h4>Parameters saved as:</h4>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"parameters\" , \"type\" : \"ACText\" }, { \"name\" : \"clear\" , \"type\" : \"ACSubmit\" , \"value\" : \"Clear channel\" , \"uri\" : \"/mqtt_clear\" } ] } ] Exclude the JSON and replace to the AutoConnectElements natively // In the declaration, // Declare AutoConnectElements for the page asf /mqtt_setting ACText(header, \"<h2>MQTT broker settings</h2>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(caption, \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"font-family:serif;color:#4682b4;\" ); ACInput(mqttserver, \"\" , \"Server\" , \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9 \\\\ -]*[a-zA-Z0-9]) \\\\ .)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9 \\\\ -]*[A-Za-z0-9])$\" , \"MQTT broker server\" ); ACInput(channelid, \"\" , \"Channel ID\" , \"^[0-9]{6}$\" ); ACInput(userkey, \"\" , \"User Key\" ); ACInput(apikey, \"\" , \"API Key\" ); ACElement(newline, \"<hr>\" ); ACCheckbox(uniqueid, \"unique\" , \"Use APID unique\" ); ACRadio(period, { \"30 sec.\" , \"60 sec.\" , \"180 sec.\" }, \"Update period\" , AC_Vertical, 1 ); ACSubmit(save, \"Start\" , \"mqtt_save\" ); ACSubmit(discard, \"Discard\" , \"/\" ); // Declare the custom Web page as /mqtt_setting and contains the AutoConnectElements AutoConnectAux mqtt_setting ( \"/mqtt_setting\" , \"MQTT Setting\" , true, { header, caption, mqttserver, channelid, userkey, apikey, newline, uniqueid, period, newline, save, discard }); // Declare AutoConnectElements for the page as /mqtt_save ACText(caption2, \"<h4>Parameters available as:</h4>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(parameters); ACSubmit(clear, \"Clear channel\" , \"/mqtt_clear\" ); // Declare the custom Web page as /mqtt_save and contains the AutoConnectElements AutoConnectAux mqtt_save ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, parameters, clear }); // In the setup(), // Join the custom Web pages and performs begin portal.join({ mqtt_setting, mqtt_save }); portal.begin(); Detaching the ArduinoJson library reduces the sketch size by approximately 10K bytes. \u21a9","title":"Implementation example without ArduinoJson"}]}
\ No newline at end of file
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index 87cfa16..fe15d41 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -2,102 +2,107 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/index.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/gettingstarted.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/menu.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/basicusage.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/advancedusage.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/acintro.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/acelements.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/acjson.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/achandling.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/api.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apiaux.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apiconfig.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apielements.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apiextra.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/howtoembed.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
-     <loc></loc>
-     
+     <loc>https://Hieromon.github.io/AutoConnect/datatips.html</loc>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/menuize.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
+     <changefreq>daily</changefreq>
+    </url>
+    <url>
+     <loc>https://Hieromon.github.io/AutoConnect/wojson.html</loc>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/faq.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/changelog.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/license.html</loc>
-     <lastmod>2019-02-16</lastmod>
+     <lastmod>2019-02-20</lastmod>
      <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/docs/sitemap.xml.gz b/docs/sitemap.xml.gz
index bdc21835e0549fe7529c34a899cbeec53a19eb98..1711acb02fcaa30121e23f707e6e6db21cb0fc8a 100644
GIT binary patch
literal 357
zcmV-r0h<0FiwFouU2R+f|8r?{Wo=<_E_iKh0L_=pPQx$^$M1WJs`oYBP7HOO5E9}6
z-~qD4YmL&li`{kb^ki%x&PYhkC5e;#^;14<r`er{P@Et!QrwoSsxAwNjy%S0TfV+L
zE$_-*yJ)5q7^KLPBX7%IWV|<Kp67~DV6Y=slsdz%&mA^5qp7P+*)ED)E&|t9(FAhs
zMS-)#GeV+)V%4Ga)4oD750lU%#RyIeMi1wzmmxIfvg}*IvJB+gb-mgw>-BP7=i!^}
zHpTTec5p~=Y`w+s-k4vOE0XzP`XgNjB6*)!Y!dKlF$ai~TDZMsbQ9YS)FN7cveAK8
zPU$d8BE@_VAYVmc#fWd52le7*NguMu(Tg~uW;Q#WHRCyo2ULBy`k!!SJWH}_0ehN-
zVAw0p7rYfKII`-520!$M;+a&(k%K*|WxFZ{((45SI*9zwm+z~}AFlQjx{mrKpbY>3
Dsz0ty

literal 353
zcmV-n0iOOJiwFoM?`B*A|8r?{Wo=<_E_iKh0L_=pP6Htj$M1cL&EC6gdob2)w=pKh
z2hazgFx|xf(=xN&)u)%*YI-(NhYK(Re}3U(fMzoVUmPKk!?-RNRb3Vk4O$nwb@}rA
zIKM47?W`G+C*UGCj<ha&=KY;g<2Y927=qqYg{f0y`dlG(F{-*+mF=v^=_GJ26^%#J
zo)jocJUK`hFjk%8e%MwH)&0QufH8t$<)VeD>N)sEow|J~XySmjUDk`$yk5>1H`#r$
zU7DC)#}0N04z1PBzcuR0az;|$Oh2USfH}_-u}%zDEM|Z>h=to~a%LdifmlRsk2)H#
z!YPf5oKP?yc*t9kNigCoWv5)cENOj?IC2s9PBNPwCdqgP<Iag*T=_>hGfteeSil}f
zMhM&gcrRQJ_Q&rJ_b&J5-06c@wzHx~xlzG81Cf4tbw9KG0ck$~g%y8NunYhI?Y*Tv

diff --git a/docs/wojson.html b/docs/wojson.html
new file mode 100644
index 0000000..faec13b
--- /dev/null
+++ b/docs/wojson.html
@@ -0,0 +1,1056 @@
+
+
+
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      <meta http-equiv="x-ua-compatible" content="ie=edge">
+      
+        <meta name="description" content="ESP8266/ESP32 WLAN configuration at run time with web interface">
+      
+      
+        <link rel="canonical" href="https://Hieromon.github.io/AutoConnect/wojson.html">
+      
+      
+        <meta name="author" content="Hieromon Ikasamo">
+      
+      
+        <meta name="lang:clipboard.copy" content="Copy to clipboard">
+      
+        <meta name="lang:clipboard.copied" content="Copied to clipboard">
+      
+        <meta name="lang:search.language" content="en">
+      
+        <meta name="lang:search.pipeline.stopwords" content="True">
+      
+        <meta name="lang:search.pipeline.trimmer" content="True">
+      
+        <meta name="lang:search.result.none" content="No matching documents">
+      
+        <meta name="lang:search.result.one" content="1 matching document">
+      
+        <meta name="lang:search.result.other" content="# matching documents">
+      
+        <meta name="lang:search.tokenizer" content="[\s\-]+">
+      
+      <link rel="shortcut icon" href="assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-3.3.0">
+    
+    
+      
+        <title>Custom Web pages w/o JSON - AutoConnect for ESP8266/ESP32</title>
+      
+    
+    
+      <link rel="stylesheet" href="assets/stylesheets/application.572ca0f0.css">
+      
+        <link rel="stylesheet" href="assets/stylesheets/application-palette.22915126.css">
+      
+      
+        
+        
+        <meta name="theme-color" content="#3f51b5">
+      
+    
+    
+      <script src="assets/javascripts/modernizr.962652e9.js"></script>
+    
+    
+      
+        <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono">
+        <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
+      
+    
+    <link rel="stylesheet" href="assets/fonts/material-icons.css">
+    
+    
+      <link rel="stylesheet" href="css/paragraph.css">
+    
+      <link rel="stylesheet" href="css/extra.css">
+    
+      <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.1/css/all.css">
+    
+    
+      
+        <script async src="https://www.googletagmanager.com/gtag/js?id=None"></script>
+<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","None")</script>
+      
+    
+    
+  </head>
+  
+    
+    
+    <body dir="ltr" data-md-color-primary="indigo" data-md-color-accent="indigo">
+  
+    <svg class="md-svg">
+      <defs>
+        
+        
+          <svg xmlns="http://www.w3.org/2000/svg" width="416" height="448"
+    viewBox="0 0 416 448" id="__github">
+  <path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19-18.125
+        8.5-18.125-8.5-10.75-19-3.125-20.5 3.125-20.5 10.75-19 18.125-8.5
+        18.125 8.5 10.75 19 3.125 20.5zM320 304q0 10-3.125 20.5t-10.75
+        19-18.125 8.5-18.125-8.5-10.75-19-3.125-20.5 3.125-20.5 10.75-19
+        18.125-8.5 18.125 8.5 10.75 19 3.125 20.5zM360
+        304q0-30-17.25-51t-46.75-21q-10.25 0-48.75 5.25-17.75 2.75-39.25
+        2.75t-39.25-2.75q-38-5.25-48.75-5.25-29.5 0-46.75 21t-17.25 51q0 22 8
+        38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0
+        37.25-1.75t35-7.375 30.5-15 20.25-25.75 8-38.375zM416 260q0 51.75-15.25
+        82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5-41.75
+        1.125q-19.5 0-35.5-0.75t-36.875-3.125-38.125-7.5-34.25-12.875-30.25-20.25-21.5-28.75q-15.5-30.75-15.5-82.75
+        0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25
+        30.875q36.75-8.75 77.25-8.75 37 0 70 8 26.25-20.5
+        46.75-30.25t47.25-9.75q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34
+        99.5z" />
+</svg>
+        
+      </defs>
+    </svg>
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
+    
+      <a href="#suppress-increase-in-memory-consumption" tabindex="1" class="md-skip">
+        Skip to content
+      </a>
+    
+    
+      <header class="md-header" data-md-component="header">
+  <nav class="md-header-nav md-grid">
+    <div class="md-flex">
+      <div class="md-flex__cell md-flex__cell--shrink">
+        <a href="https://Hieromon.github.io/AutoConnect/" title="AutoConnect for ESP8266/ESP32" class="md-header-nav__button md-logo">
+          
+            <img src="images/arduino-logo.svg" width="24" height="24">
+          
+        </a>
+      </div>
+      <div class="md-flex__cell md-flex__cell--shrink">
+        <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
+      </div>
+      <div class="md-flex__cell md-flex__cell--stretch">
+        <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
+          
+            
+              <span class="md-header-nav__topic">
+                AutoConnect for ESP8266/ESP32
+              </span>
+              <span class="md-header-nav__topic">
+                Custom Web pages w/o JSON
+              </span>
+            
+          
+        </div>
+      </div>
+      <div class="md-flex__cell md-flex__cell--shrink">
+        
+          
+            <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
+            
+<div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
+      <label class="md-icon md-search__icon" for="__search"></label>
+      <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
+        &#xE5CD;
+      </button>
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="result">
+          <div class="md-search-result__meta">
+            Type to start searching
+          </div>
+          <ol class="md-search-result__list"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+          
+        
+      </div>
+      
+        <div class="md-flex__cell md-flex__cell--shrink">
+          <div class="md-header-nav__source">
+            
+
+
+  
+
+
+  <a href="https://github.com/Hieromon/AutoConnect" title="Go to repository" class="md-source" data-md-source="github">
+    
+      <div class="md-source__icon">
+        <svg viewBox="0 0 24 24" width="24" height="24">
+          <use xlink:href="#__github" width="24" height="24"></use>
+        </svg>
+      </div>
+    
+    <div class="md-source__repository">
+      Hieromon/AutoConnect
+    </div>
+  </a>
+
+          </div>
+        </div>
+      
+    </div>
+  </nav>
+</header>
+    
+    <div class="md-container">
+      
+        
+      
+      
+        
+
+  
+
+<nav class="md-tabs md-tabs--active" data-md-component="tabs">
+  <div class="md-tabs__inner md-grid">
+    <ul class="md-tabs__list">
+      
+        
+  <li class="md-tabs__item">
+    
+      <a href="index.html" title="Overview" class="md-tabs__link">
+        Overview
+      </a>
+    
+  </li>
+
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+  
+  
+    <li class="md-tabs__item">
+      
+        <a href="acintro.html" title="Custom Web pages" class="md-tabs__link">
+          Custom Web pages
+        </a>
+      
+    </li>
+  
+
+      
+        
+  
+  
+    <li class="md-tabs__item">
+      
+        <a href="api.html" title="Library APIs" class="md-tabs__link">
+          Library APIs
+        </a>
+      
+    </li>
+  
+
+      
+        
+  
+  
+    <li class="md-tabs__item">
+      
+        <a href="howtoembed.html" title="Examples" class="md-tabs__link md-tabs__link--active">
+          Examples
+        </a>
+      
+    </li>
+  
+
+      
+        
+      
+        
+      
+        
+      
+    </ul>
+  </div>
+</nav>
+      
+      <main class="md-main">
+        <div class="md-main__inner md-grid" data-md-component="container">
+          
+            
+              <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    <nav class="md-nav md-nav--primary" data-md-level="0">
+  <label class="md-nav__title md-nav__title--site" for="__drawer">
+    <a href="https://Hieromon.github.io/AutoConnect/" title="AutoConnect for ESP8266/ESP32" class="md-nav__button md-logo">
+      
+        <img src="images/arduino-logo.svg" width="48" height="48">
+      
+    </a>
+    AutoConnect for ESP8266/ESP32
+  </label>
+  
+    <div class="md-nav__source">
+      
+
+
+  
+
+
+  <a href="https://github.com/Hieromon/AutoConnect" title="Go to repository" class="md-source" data-md-source="github">
+    
+      <div class="md-source__icon">
+        <svg viewBox="0 0 24 24" width="24" height="24">
+          <use xlink:href="#__github" width="24" height="24"></use>
+        </svg>
+      </div>
+    
+    <div class="md-source__repository">
+      Hieromon/AutoConnect
+    </div>
+  </a>
+
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="index.html" title="Overview" class="md-nav__link">
+      Overview
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="gettingstarted.html" title="Getting started" class="md-nav__link">
+      Getting started
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="menu.html" title="AutoConnect menu" class="md-nav__link">
+      AutoConnect menu
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="basicusage.html" title="Basic usage" class="md-nav__link">
+      Basic usage
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="advancedusage.html" title="Advanced usage" class="md-nav__link">
+      Advanced usage
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item md-nav__item--nested">
+    
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6">
+    
+    <label class="md-nav__link" for="nav-6">
+      Custom Web pages
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-6">
+        Custom Web pages
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+        
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="acintro.html" title="Custom Web pages with AutoConnect" class="md-nav__link">
+      Custom Web pages with AutoConnect
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="acelements.html" title="AutoConnectElements" class="md-nav__link">
+      AutoConnectElements
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="acjson.html" title="Custom Web pages with JSON" class="md-nav__link">
+      Custom Web pages with JSON
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="achandling.html" title="Handling the custom Web pages" class="md-nav__link">
+      Handling the custom Web pages
+    </a>
+  </li>
+
+        
+      </ul>
+    </nav>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item md-nav__item--nested">
+    
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7">
+    
+    <label class="md-nav__link" for="nav-7">
+      Library APIs
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-7">
+        Library APIs
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+        
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="api.html" title="AutoConnect API" class="md-nav__link">
+      AutoConnect API
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="apiaux.html" title="AutoConnectAux API" class="md-nav__link">
+      AutoConnectAux API
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="apiconfig.html" title="AutoConnectConfig API" class="md-nav__link">
+      AutoConnectConfig API
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="apielements.html" title="AutoConnectElements API" class="md-nav__link">
+      AutoConnectElements API
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="apiextra.html" title="Something extra" class="md-nav__link">
+      Something extra
+    </a>
+  </li>
+
+        
+      </ul>
+    </nav>
+  </li>
+
+    
+      
+      
+      
+
+  
+
+
+  <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+    
+      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-8" type="checkbox" id="nav-8" checked>
+    
+    <label class="md-nav__link" for="nav-8">
+      Examples
+    </label>
+    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
+      <label class="md-nav__title" for="nav-8">
+        Examples
+      </label>
+      <ul class="md-nav__list" data-md-scrollfix>
+        
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="howtoembed.html" title="How to embed" class="md-nav__link">
+      How to embed
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="datatips.html" title="Tips for data conversion" class="md-nav__link">
+      Tips for data conversion
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="menuize.html" title="Constucting the menu" class="md-nav__link">
+      Constucting the menu
+    </a>
+  </li>
+
+        
+          
+          
+          
+
+  
+
+
+  <li class="md-nav__item md-nav__item--active">
+    
+    <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
+    
+    
+      <label class="md-nav__link md-nav__link--active" for="__toc">
+        Custom Web pages w/o JSON
+      </label>
+    
+    <a href="wojson.html" title="Custom Web pages w/o JSON" class="md-nav__link md-nav__link--active">
+      Custom Web pages w/o JSON
+    </a>
+    
+      
+<nav class="md-nav md-nav--secondary">
+  
+  
+  
+    <label class="md-nav__title" for="__toc">Table of contents</label>
+    <ul class="md-nav__list" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#suppress-increase-in-memory-consumption" title="Suppress increase in memory consumption" class="md-nav__link">
+    Suppress increase in memory consumption
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#writing-the-custom-web-pages-without-json" title="Writing the custom Web pages without JSON" class="md-nav__link">
+    Writing the custom Web pages without JSON
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#implementation-example-without-arduinojson" title="Implementation example without ArduinoJson" class="md-nav__link">
+    Implementation example without ArduinoJson
+  </a>
+  
+</li>
+      
+      
+      
+      
+      
+    </ul>
+  
+</nav>
+    
+  </li>
+
+        
+      </ul>
+    </nav>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="faq.html" title="FAQ" class="md-nav__link">
+      FAQ
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="changelog.html" title="Change log" class="md-nav__link">
+      Change log
+    </a>
+  </li>
+
+    
+      
+      
+      
+
+
+  <li class="md-nav__item">
+    <a href="license.html" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+<nav class="md-nav md-nav--secondary">
+  
+  
+  
+    <label class="md-nav__title" for="__toc">Table of contents</label>
+    <ul class="md-nav__list" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#suppress-increase-in-memory-consumption" title="Suppress increase in memory consumption" class="md-nav__link">
+    Suppress increase in memory consumption
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#writing-the-custom-web-pages-without-json" title="Writing the custom Web pages without JSON" class="md-nav__link">
+    Writing the custom Web pages without JSON
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#implementation-example-without-arduinojson" title="Implementation example without ArduinoJson" class="md-nav__link">
+    Implementation example without ArduinoJson
+  </a>
+  
+</li>
+      
+      
+      
+      
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          <div class="md-content">
+            <article class="md-content__inner md-typeset">
+              
+                
+                
+                  <h1>Custom Web pages w/o JSON</h1>
+                
+                <h2 id="suppress-increase-in-memory-consumption">Suppress increase in memory consumption<a class="headerlink" href="#suppress-increase-in-memory-consumption" title="Permanent link">&para;</a></h2>
+<p>Custom Web page processing consumes a lot of memory. AutoConnect will take a whole string of the JSON document for the custom Web pages into memory. The required buffer size for the JSON document of example sketch <em>mqttRSSI</em> reaches approximately 3000 bytes. And actually, it needs twice the heap area. Especially this constraint will be a problem with the ESP8266 which has a heap size poor.</p>
+<p>AutoConnect can handle custom Web pages without using JSON. In that case, since the ArduinoJson library will not be bound, the sketch size will also be reduced.</p>
+<h2 id="writing-the-custom-web-pages-without-json">Writing the custom Web pages without JSON<a class="headerlink" href="#writing-the-custom-web-pages-without-json" title="Permanent link">&para;</a></h2>
+<p>To handle a custom Web page without using JSON, follow the steps below.</p>
+<ol>
+<li>Create or define <a href="apiaux.html">AutoConnectAux</a> for each page.</li>
+<li>Create or define <a href="acelements.html">AutoConnectElement(s)</a>.</li>
+<li>Add <a href="acelements.html">AutoConnectElement(s)</a> to AutoConnectAux.</li>
+<li>Create more AutoConnectAux containing <a href="acelements.html">AutoConnectElement(s)</a>, if necessary.</li>
+<li>Register the request handlers for the custom Web pages.</li>
+<li><a href="api.html#join">Join</a> prepared AutoConnectAux(s) to AutoConnect.</li>
+<li>Invoke <a href="api.html#begin">AutoConnect::begin()</a>.</li>
+</ol>
+<p>In addition to the above procedure, to completely cut off for binding with the ArduinoJson library, turn off the ArduinoJson use indicator which is declared by the <a href="api.html#defined-macros">AutoConnect definitions</a>. Its declaration is in <strong>AutoConnectDefs.h</strong> file.<sup id="fnref:1"><a class="footnote-ref" href="#fn:1" rel="footnote">1</a></sup></p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #75715e">// Comment out the AUTOCONNECT_USE_JSON macro to detach the ArduinoJson.</span>
+<span style="color: #75715e">#define AUTOCONNECT_USE_JSON</span>
+</pre></div>
+
+<div class="admonition caution">
+<p class="admonition-title">JSON processing will be disabled</p>
+<p>Commenting out the <strong>AUTOCONNECT_USE_JSON</strong> macro invalidates all functions related to JSON processing. If the sketch is using the JSON function, it will result in a compile error.</p>
+</div>
+<h2 id="implementation-example-without-arduinojson">Implementation example without ArduinoJson<a class="headerlink" href="#implementation-example-without-arduinojson" title="Permanent link">&para;</a></h2>
+<p>The code excluding JSON processing from the mqttRSSI sketch attached to the library is as follows. <small>(It is a part of code. Refer to mqttRSSI_NA.ino for the whole sketch.)</small></p>
+<p><i class="fa fa-code"></i> The JSON document for mqttRSSI</p>
+<p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #f8f8f2">[</span>
+  <span style="color: #f8f8f2">{</span>
+    <span style="color: #f92672">&quot;title&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;MQTT Setting&quot;</span><span style="color: #f8f8f2">,</span>
+    <span style="color: #f92672">&quot;uri&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;/mqtt_setting&quot;</span><span style="color: #f8f8f2">,</span>
+    <span style="color: #f92672">&quot;menu&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #66d9ef">true</span><span style="color: #f8f8f2">,</span>
+    <span style="color: #f92672">&quot;element&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #f8f8f2">[</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;header&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACText&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;&lt;h2&gt;MQTT broker settings&lt;/h2&gt;&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;style&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;text-align:center;color:#2f4f4f;padding:10px;&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;caption&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACText&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;style&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;font-family:serif;color:#4682b4;&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;mqttserver&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACInput&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Server&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;pattern&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;placeholder&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;MQTT broker server&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;channelid&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACInput&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Channel ID&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;pattern&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;^[0-9]{6}$&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;userkey&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACInput&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;User Key&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;apikey&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACInput&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;API Key&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;newline&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACElement&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;&lt;hr&gt;&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;uniqueid&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACCheckbox&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;unique&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Use APID unique&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;checked&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #66d9ef">false</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;period&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACRadio&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #f8f8f2">[</span>
+          <span style="color: #e6db74">&quot;30 sec.&quot;</span><span style="color: #f8f8f2">,</span>
+          <span style="color: #e6db74">&quot;60 sec.&quot;</span><span style="color: #f8f8f2">,</span>
+          <span style="color: #e6db74">&quot;180 sec.&quot;</span>
+        <span style="color: #f8f8f2">],</span>
+        <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Update period&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;arrange&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;vertical&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;checked&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #ae81ff">1</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;newline&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACElement&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;&lt;hr&gt;&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;hostname&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACInput&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;label&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ESP host name&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;pattern&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;^([a-zA-Z0-9]([a-zA-Z0-9-])*[a-zA-Z0-9]){1,32}$&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;save&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACSubmit&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Save&amp;amp;Start&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;uri&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;/mqtt_save&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;discard&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACSubmit&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Discard&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;uri&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;/&quot;</span>
+      <span style="color: #f8f8f2">}</span>
+    <span style="color: #f8f8f2">]</span>
+  <span style="color: #f8f8f2">},</span>
+  <span style="color: #f8f8f2">{</span>
+    <span style="color: #f92672">&quot;title&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;MQTT Setting&quot;</span><span style="color: #f8f8f2">,</span>
+    <span style="color: #f92672">&quot;uri&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;/mqtt_save&quot;</span><span style="color: #f8f8f2">,</span>
+    <span style="color: #f92672">&quot;menu&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #66d9ef">false</span><span style="color: #f8f8f2">,</span>
+    <span style="color: #f92672">&quot;element&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #f8f8f2">[</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;caption&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACText&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;&lt;h4&gt;Parameters saved as:&lt;/h4&gt;&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;style&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;text-align:center;color:#2f4f4f;padding:10px;&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;parameters&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACText&quot;</span>
+      <span style="color: #f8f8f2">},</span>
+      <span style="color: #f8f8f2">{</span>
+        <span style="color: #f92672">&quot;name&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;clear&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;type&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;ACSubmit&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;value&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;Clear channel&quot;</span><span style="color: #f8f8f2">,</span>
+        <span style="color: #f92672">&quot;uri&quot;</span><span style="color: #f8f8f2">:</span> <span style="color: #e6db74">&quot;/mqtt_clear&quot;</span>
+      <span style="color: #f8f8f2">}</span>
+    <span style="color: #f8f8f2">]</span>
+  <span style="color: #f8f8f2">}</span>
+<span style="color: #f8f8f2">]</span>
+</pre></div>
+<span style="margin-right:6px;margin-top:2px;"><img align="middle" width="32" height="32" src="./images/arrow_down.png"></span><i class="fa fa-code"></i> Exclude the JSON and replace to the AutoConnectElements natively</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #75715e">// In the declaration,</span>
+<span style="color: #75715e">// Declare AutoConnectElements for the page asf /mqtt_setting</span>
+<span style="color: #f8f8f2">ACText(header,</span> <span style="color: #e6db74">&quot;&lt;h2&gt;MQTT broker settings&lt;/h2&gt;&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;text-align:center;color:#2f4f4f;padding:10px;&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACText(caption,</span> <span style="color: #e6db74">&quot;Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;font-family:serif;color:#4682b4;&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACInput(mqttserver,</span> <span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;Server&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9</span><span style="color: #ae81ff">\\</span><span style="color: #e6db74">-]*[a-zA-Z0-9])</span><span style="color: #ae81ff">\\</span><span style="color: #e6db74">.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9</span><span style="color: #ae81ff">\\</span><span style="color: #e6db74">-]*[A-Za-z0-9])$&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;MQTT broker server&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACInput(channelid,</span> <span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;Channel ID&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;^[0-9]{6}$&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACInput(userkey,</span> <span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;User Key&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACInput(apikey,</span> <span style="color: #e6db74">&quot;&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;API Key&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACElement(newline,</span> <span style="color: #e6db74">&quot;&lt;hr&gt;&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACCheckbox(uniqueid,</span> <span style="color: #e6db74">&quot;unique&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;Use APID unique&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACRadio(period,</span> <span style="color: #f8f8f2">{</span> <span style="color: #e6db74">&quot;30 sec.&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;60 sec.&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;180 sec.&quot;</span> <span style="color: #f8f8f2">},</span> <span style="color: #e6db74">&quot;Update period&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">AC_Vertical,</span> <span style="color: #ae81ff">1</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACSubmit(save,</span> <span style="color: #e6db74">&quot;Start&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;mqtt_save&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACSubmit(discard,</span> <span style="color: #e6db74">&quot;Discard&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;/&quot;</span><span style="color: #f8f8f2">);</span>
+
+<span style="color: #75715e">// Declare the custom Web page as /mqtt_setting and contains the AutoConnectElements</span>
+<span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #a6e22e">mqtt_setting</span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">&quot;/mqtt_setting&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;MQTT Setting&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">true,</span> <span style="color: #f8f8f2">{</span>
+  <span style="color: #f8f8f2">header,</span>
+  <span style="color: #f8f8f2">caption,</span>
+  <span style="color: #f8f8f2">mqttserver,</span>
+  <span style="color: #f8f8f2">channelid,</span>
+  <span style="color: #f8f8f2">userkey,</span>
+  <span style="color: #f8f8f2">apikey,</span>
+  <span style="color: #f8f8f2">newline,</span>
+  <span style="color: #f8f8f2">uniqueid,</span>
+  <span style="color: #f8f8f2">period,</span>
+  <span style="color: #f8f8f2">newline,</span>
+  <span style="color: #f8f8f2">save,</span>
+  <span style="color: #f8f8f2">discard</span>
+<span style="color: #f8f8f2">});</span>
+
+<span style="color: #75715e">// Declare AutoConnectElements for the page as /mqtt_save</span>
+<span style="color: #f8f8f2">ACText(caption2,</span> <span style="color: #e6db74">&quot;&lt;h4&gt;Parameters available as:&lt;/h4&gt;&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;text-align:center;color:#2f4f4f;padding:10px;&quot;</span><span style="color: #f8f8f2">);</span>
+<span style="color: #f8f8f2">ACText(parameters);</span>
+<span style="color: #f8f8f2">ACSubmit(clear,</span> <span style="color: #e6db74">&quot;Clear channel&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;/mqtt_clear&quot;</span><span style="color: #f8f8f2">);</span>
+
+<span style="color: #75715e">// Declare the custom Web page as /mqtt_save and contains the AutoConnectElements</span>
+<span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #a6e22e">mqtt_save</span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">&quot;/mqtt_save&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;MQTT Setting&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">false,</span> <span style="color: #f8f8f2">{</span>
+  <span style="color: #f8f8f2">caption2,</span>
+  <span style="color: #f8f8f2">parameters,</span>
+  <span style="color: #f8f8f2">clear</span>
+<span style="color: #f8f8f2">});</span>
+
+<span style="color: #75715e">// In the setup(),</span>
+<span style="color: #75715e">// Join the custom Web pages and performs begin</span>
+  <span style="color: #f8f8f2">portal.join({</span> <span style="color: #f8f8f2">mqtt_setting,</span> <span style="color: #f8f8f2">mqtt_save</span> <span style="color: #f8f8f2">});</span>
+  <span style="color: #f8f8f2">portal.begin();</span>
+</pre></div>
+
+<div class="footnote">
+<hr />
+<ol>
+<li id="fn:1">
+<p>Detaching the ArduinoJson library reduces the sketch size by approximately 10K bytes.&#160;<a class="footnote-backref" href="#fnref:1" rev="footnote" title="Jump back to footnote 1 in the text">&#8617;</a></p>
+</li>
+</ol>
+</div>
+                
+                  
+                
+              
+              
+                
+
+
+              
+            </article>
+          </div>
+        </div>
+      </main>
+      
+        
+<footer class="md-footer">
+  
+    <div class="md-footer-nav">
+      <nav class="md-footer-nav__inner md-grid">
+        
+          <a href="menuize.html" title="Constucting the menu" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
+            </div>
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  Previous
+                </span>
+                Constucting the menu
+              </span>
+            </div>
+          </a>
+        
+        
+          <a href="faq.html" title="FAQ" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  Next
+                </span>
+                FAQ
+              </span>
+            </div>
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
+            </div>
+          </a>
+        
+      </nav>
+    </div>
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-footer-copyright">
+        
+          <div class="md-footer-copyright__highlight">
+            Copyright &copy; 2018-2019 Hieromon Ikasamo
+          </div>
+        
+        powered by
+        <a href="https://www.mkdocs.org">MkDocs</a>
+        and
+        <a href="https://squidfunk.github.io/mkdocs-material/">
+          Material for MkDocs</a>
+      </div>
+      
+        
+  <div class="md-footer-social">
+    <link rel="stylesheet" href="assets/fonts/font-awesome.css">
+    
+      <a href="https://github.com/Hieromon" class="md-footer-social__link fa fa-github"></a>
+    
+      <a href="https://twitter.com/hieromon" class="md-footer-social__link fa fa-twitter"></a>
+    
+  </div>
+
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    
+      <script src="assets/javascripts/application.a353778b.js"></script>
+      
+      <script>app.initialize({version:"1.0.4",url:{base:"."}})</script>
+      
+        <script src="js/gifffer.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 2cfcbe2..2fb42eb 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -28,7 +28,7 @@ nav:
   - 'Examples' :
     - 'How to embed': howtoembed.md
     - 'Tips for data conversion': datatips.md
-    - 'Constucting menu': menuize.md
+    - 'Constucting the menu': menuize.md
     - 'Custom Web pages w/o JSON': wojson.md
   - 'FAQ' : faq.md
   - 'Change log' : changelog.md
diff --git a/mkdocs/advancedusage.md b/mkdocs/advancedusage.md
index 1e8bab5..1d5e78b 100644
--- a/mkdocs/advancedusage.md
+++ b/mkdocs/advancedusage.md
@@ -155,20 +155,20 @@ void loop() {
 }
 ```
 
-### <i class="fa fa-caret-right"></i> Cast items of your sketch own into the AutocCnnect menu
+### <i class="fa fa-caret-right"></i> Cast the legacy HTML pages as the add-on menu items
 
-If your sketch is handling your own web page, you can call that page from the [AutoConnect menu](menu.md). Unlike the custom Web pages by [AutoConnectAux](apiaux.md#autoconnectaux), this allows AutoConnect menu to legacy web pages registered by *ESP8266WebServer::on*/*WebServer::on* function.
+If your sketch handles web pages, you can embed the pages into the AutoConnect menu with keeping the WiFi connection feature. Unlike the custom Web pages by [AutoConnectAux](apiaux.md#autoconnectaux), this allows to legacy web pages registered by *ESP8266WebServer::on* or *WebServer::on* function.
 
-To implement this with your sketch, use only the [AutoConnectAux](apiaux.md#autoconnectaux) constructed with the URI of that page. [AutoConnectElements](acelements.md) is not required. The basic procedure for this as follows. 
+To implement embedding the your sketch web pages, use only the [AutoConnectAux](apiaux.md#autoconnectaux) constructed with the URI of that page. [AutoConnectElements](acelements.md) is not required. The basic procedure for this as follows:
 
 1. Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu.
-2. Sketch legacy page handlers.
+2. Sketch the legacy page handlers.
 3. Register those handler functions to ESP8266WebServer/WebServer with the **on** function.
 4. Register AutoConnectAux declared with #1 to AutoConnect using [AutoConnect::join](api.md#join) function. It serves as a menu item.
 5. [Begin](api.md#begin) the portal.
 6. Performs [AutoConnect::handleClient](api.md#handleClient) in the **loop** function.
 
-For details see the [Constructing menu](menuize.md) section of Examples page.
+For details see the [Constructing the menu](menuize.md) section of Examples page.
 
 ### <i class="fa fa-caret-right"></i> Change menu title
 
diff --git a/mkdocs/menu.md b/mkdocs/menu.md
index 3b9a0f2..c88fa19 100644
--- a/mkdocs/menu.md
+++ b/mkdocs/menu.md
@@ -66,9 +66,9 @@ You can change the HOME path using the AutoConnect API. The [**AutoConnect::home
 
 ## <i class="fa fa-bars"></i> Extend AutoConnect menu with your sketches
 
-The AutoConnect menu can contain custom items of your own sketch. It works for the custom Web pages by [AutoConnectAux](acintro.md), addition to the request handler for ESP8266WebServer class that is registered by the ESP8266WebServer::on function or WebServer::on for ESP32. That is, you can make it as a menu item to invoke a legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as [FSBrowser](https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer/examples/FSBrowser) to the AutoConnect menu item. It adds Edit and List items with little modification of the legacy sketch code.
+The AutoConnect menu can contain HTML pages of your sketch as custom items. It works for HTML pages implemented by **ESP8266WebServer::on** handler or **WebServer::on** handler for ESP32. That is, you can make it as menu items to invoke the legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as [FSBrowser](https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer/examples/FSBrowser) to the AutoConnect menu item. It adds Edit and List items with little modification of the legacy sketch code.
 
 <div style="float:left;width:auto;height:420px;"><img style="width:auto;height:420px;" src="./images/fsbmenu.png"></div>
 <img style="margin-left:70px;width:auto;height:420px;" src="./images/fsbmenu_expand.png">
 
-The procedure to extend the AutoConnect menu is described in the [Advanced usage section](advancedusage.md#cast-items-of-your-sketch-own-into-the-autoccnnect-menu).
+You can extend the AutoConnect menu to match legacy sketches and according to the procedure described in the [Advanced Usage section](advancedusage.md#cast-the-legacy-html-pages-as-the-add-on-menu-items).
diff --git a/mkdocs/menuize.md b/mkdocs/menuize.md
index 4e8e488..a11d269 100644
--- a/mkdocs/menuize.md
+++ b/mkdocs/menuize.md
@@ -1,6 +1,6 @@
 ## What menus can be made using AutoConnect
 
-AutoConnect generates a menu dynamically depending on the instantiated [AutoConnectAux](acintro.md#how-it-works) at the sketch executing time. Usually, it is a collection of [AutoConnectElement](acelements.md). In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. That is, you can easily make the built-in menu with legacy sketches of yours.
+AutoConnect generates a menu dynamically depending on the instantiated [AutoConnectAux](acintro.md#how-it-works) at the sketch executing time. Usually, it is a collection of [AutoConnectElement](acelements.md). In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements.<br>In other words, you can easily create a built-in menu featuring the WiFi connection facility embedding the legacy web pages.
 
 ## Basic mechanism of menu generation
 
@@ -25,7 +25,7 @@ The AutoConnect library package contains an example sketch for ESP8266WebServer
 
 <span style="display:block;margin-left:auto;margin-right:auto;width:282px;height:492px;border:1px solid lightgrey;"><img data-gifffer="./images/aux_fsbrowser.gif" data-gifffer-height="490" data-gifffer-width="280" /></span>
 
-The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows.
+The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows:
 
 1. Add AutoConnect declaration.
 2. Add the menu item named "**Edit**" and "**List**" of AutoConnectAux as each page.