|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!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/acjson.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.1, mkdocs-material-4.6.3">
|
|
|
|
|
|
|
|
|
|
|
|
<title>Custom Web pages with JSON - AutoConnect for ESP8266/ESP32</title>
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="assets/stylesheets/application.adb8469c.css">
|
|
|
|
|
|
<link rel="stylesheet" href="assets/stylesheets/application-palette.a8b3c06d.css">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<meta name="theme-color" content="#3f51b5">
|
|
|
|
|
|
|
|
|
|
|
|
<script src="assets/javascripts/modernizr.86422ebf.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%7CRoboto+Mono&display=fallback">
|
|
|
<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.3/css/all.css">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<script>
|
|
|
window.ga = window.ga || function() {
|
|
|
(ga.q = ga.q || []).push(arguments)
|
|
|
}
|
|
|
ga.l = +new Date
|
|
|
/* Setup integration and send page view */
|
|
|
ga("create", "UA-116150854-1", "auto")
|
|
|
ga("set", "anonymizeIp", true)
|
|
|
ga("send", "pageview")
|
|
|
/* Register handler to log search on blur */
|
|
|
document.addEventListener("DOMContentLoaded", () => {
|
|
|
if (document.forms.search) {
|
|
|
var query = document.forms.search.query
|
|
|
query.addEventListener("blur", function() {
|
|
|
if (this.value) {
|
|
|
var path = document.location.pathname;
|
|
|
ga("send", "pageview", path + "?q=" + this.value)
|
|
|
}
|
|
|
})
|
|
|
}
|
|
|
})
|
|
|
</script>
|
|
|
<script async src="https://www.google-analytics.com/analytics.js"></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 19T128 352t-18.125-8.5-10.75-19T96 304t3.125-20.5 10.75-19T128 256t18.125 8.5 10.75 19T160 304zm160 0q0 10-3.125 20.5t-10.75 19T288 352t-18.125-8.5-10.75-19T256 304t3.125-20.5 10.75-19T288 256t18.125 8.5 10.75 19T320 304zm40 0q0-30-17.25-51T296 232q-10.25 0-48.75 5.25Q229.5 240 208 240t-39.25-2.75Q130.75 232 120 232q-29.5 0-46.75 21T56 304q0 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.75T360 304zm56-44q0 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.5T212 416q-19.5 0-35.5-.75t-36.875-3.125-38.125-7.5-34.25-12.875T37 371.5t-21.5-28.75Q0 312 0 260q0-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.875Q171.5 96 212 96q37 0 70 8 26.25-20.5 46.75-30.25T376 64q12.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="#json-objects-elements-for-the-custom-web-page" tabindex="0" 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" aria-label="AutoConnect for ESP8266/ESP32" class="md-header-nav__button md-logo">
|
|
|
|
|
|
<img alt="logo" 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 with 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" aria-label="search" 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">
|
|
|

|
|
|
</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">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<main class="md-main" role="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 alt="logo" 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--active md-nav__item--nested">
|
|
|
|
|
|
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6" checked>
|
|
|
|
|
|
<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 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 with JSON
|
|
|
</label>
|
|
|
|
|
|
<a href="acjson.html" title="Custom Web pages with JSON" class="md-nav__link md-nav__link--active">
|
|
|
Custom Web pages with 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="#json-objects-elements-for-the-custom-web-page" class="md-nav__link">
|
|
|
JSON objects & elements for the custom Web page
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#json-document-structure-for-autoconnectaux" class="md-nav__link">
|
|
|
JSON document structure for AutoConnectAux
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#title" class="md-nav__link">
|
|
|
title
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#uri" class="md-nav__link">
|
|
|
uri
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#menu" class="md-nav__link">
|
|
|
menu
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#element" class="md-nav__link">
|
|
|
element
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#multiple-custom-web-pages-declaration-in-json-document" class="md-nav__link">
|
|
|
Multiple custom Web pages declaration in JSON document
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#json-object-for-autoconnectelements" class="md-nav__link">
|
|
|
JSON object for AutoConnectElements
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#name" class="md-nav__link">
|
|
|
name
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#type" class="md-nav__link">
|
|
|
type
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#key_according_to_type" class="md-nav__link">
|
|
|
key_according_to_type
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acbutton" class="md-nav__link">
|
|
|
ACButton
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#accheckbox" class="md-nav__link">
|
|
|
ACCheckbox
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acelement" class="md-nav__link">
|
|
|
ACElement
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acfile" class="md-nav__link">
|
|
|
ACFile
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acinput" class="md-nav__link">
|
|
|
ACInput
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acradio" class="md-nav__link">
|
|
|
ACRadio
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acselect" class="md-nav__link">
|
|
|
ACSelect
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acstyle" class="md-nav__link">
|
|
|
ACStyle
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acsubmit" class="md-nav__link">
|
|
|
ACSubmit
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#actext" class="md-nav__link">
|
|
|
ACText
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#loading-json-document" class="md-nav__link">
|
|
|
Loading JSON document
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#loading-to-autoconnect" class="md-nav__link">
|
|
|
Loading to AutoConnect
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#loading-from-the-streamed-file" class="md-nav__link">
|
|
|
Loading from the streamed file
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#adjust-the-json-document-buffer-size" class="md-nav__link">
|
|
|
Adjust the JSON document buffer size
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#autoconnect_jsonbuffer_size" class="md-nav__link">
|
|
|
AUTOCONNECT_JSONBUFFER_SIZE
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#autoconnect_jsondocument_size" class="md-nav__link">
|
|
|
AUTOCONNECT_JSONDOCUMENT_SIZE
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#autoconnect_jsonpsram_size" class="md-nav__link">
|
|
|
AUTOCONNECT_JSONPSRAM_SIZE
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#saving-json-document" class="md-nav__link">
|
|
|
Saving JSON document
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
</nav>
|
|
|
|
|
|
</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">
|
|
|
OTA Updates
|
|
|
</label>
|
|
|
<nav class="md-nav" data-md-component="collapsible" data-md-level="1">
|
|
|
<label class="md-nav__title" for="nav-7">
|
|
|
OTA Updates
|
|
|
</label>
|
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="otaupdate.html" title="OTA Updates" class="md-nav__link">
|
|
|
OTA Updates
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="otabrowser.html" title="Using Web Browser" class="md-nav__link">
|
|
|
Using Web Browser
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="otaserver.html" title="Using Update Server" class="md-nav__link">
|
|
|
Using Update Server
|
|
|
</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-8" type="checkbox" id="nav-8">
|
|
|
|
|
|
<label class="md-nav__link" for="nav-8">
|
|
|
Library APIs
|
|
|
</label>
|
|
|
<nav class="md-nav" data-md-component="collapsible" data-md-level="1">
|
|
|
<label class="md-nav__title" for="nav-8">
|
|
|
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="apiupdate.html" title="AutoConnectUpdate API" class="md-nav__link">
|
|
|
AutoConnectUpdate 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--nested">
|
|
|
|
|
|
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-9" type="checkbox" id="nav-9">
|
|
|
|
|
|
<label class="md-nav__link" for="nav-9">
|
|
|
Examples
|
|
|
</label>
|
|
|
<nav class="md-nav" data-md-component="collapsible" data-md-level="1">
|
|
|
<label class="md-nav__title" for="nav-9">
|
|
|
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="Attach the menu" class="md-nav__link">
|
|
|
Attach 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 md-nav__item--nested">
|
|
|
|
|
|
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10">
|
|
|
|
|
|
<label class="md-nav__link" for="nav-10">
|
|
|
Appendix
|
|
|
</label>
|
|
|
<nav class="md-nav" data-md-component="collapsible" data-md-level="1">
|
|
|
<label class="md-nav__title" for="nav-10">
|
|
|
Appendix
|
|
|
</label>
|
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="lsbegin.html" title="Inside AutoConnect::begin" class="md-nav__link">
|
|
|
Inside AutoConnect::begin
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="credit.html" title="Saved credentials access" class="md-nav__link">
|
|
|
Saved credentials access
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="acupload.html" title="File upload handler" class="md-nav__link">
|
|
|
File upload handler
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="colorized.html" title="Custom colorized" class="md-nav__link">
|
|
|
Custom colorized
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="changelabel.html" title="Change label text" class="md-nav__link">
|
|
|
Change label text
|
|
|
</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="#json-objects-elements-for-the-custom-web-page" class="md-nav__link">
|
|
|
JSON objects & elements for the custom Web page
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#json-document-structure-for-autoconnectaux" class="md-nav__link">
|
|
|
JSON document structure for AutoConnectAux
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#title" class="md-nav__link">
|
|
|
title
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#uri" class="md-nav__link">
|
|
|
uri
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#menu" class="md-nav__link">
|
|
|
menu
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#element" class="md-nav__link">
|
|
|
element
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#multiple-custom-web-pages-declaration-in-json-document" class="md-nav__link">
|
|
|
Multiple custom Web pages declaration in JSON document
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#json-object-for-autoconnectelements" class="md-nav__link">
|
|
|
JSON object for AutoConnectElements
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#name" class="md-nav__link">
|
|
|
name
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#type" class="md-nav__link">
|
|
|
type
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#key_according_to_type" class="md-nav__link">
|
|
|
key_according_to_type
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acbutton" class="md-nav__link">
|
|
|
ACButton
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#accheckbox" class="md-nav__link">
|
|
|
ACCheckbox
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acelement" class="md-nav__link">
|
|
|
ACElement
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acfile" class="md-nav__link">
|
|
|
ACFile
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acinput" class="md-nav__link">
|
|
|
ACInput
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acradio" class="md-nav__link">
|
|
|
ACRadio
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acselect" class="md-nav__link">
|
|
|
ACSelect
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acstyle" class="md-nav__link">
|
|
|
ACStyle
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#acsubmit" class="md-nav__link">
|
|
|
ACSubmit
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#actext" class="md-nav__link">
|
|
|
ACText
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#loading-json-document" class="md-nav__link">
|
|
|
Loading JSON document
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#loading-to-autoconnect" class="md-nav__link">
|
|
|
Loading to AutoConnect
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#loading-from-the-streamed-file" class="md-nav__link">
|
|
|
Loading from the streamed file
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#adjust-the-json-document-buffer-size" class="md-nav__link">
|
|
|
Adjust the JSON document buffer size
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#autoconnect_jsonbuffer_size" class="md-nav__link">
|
|
|
AUTOCONNECT_JSONBUFFER_SIZE
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#autoconnect_jsondocument_size" class="md-nav__link">
|
|
|
AUTOCONNECT_JSONDOCUMENT_SIZE
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#autoconnect_jsonpsram_size" class="md-nav__link">
|
|
|
AUTOCONNECT_JSONPSRAM_SIZE
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#saving-json-document" class="md-nav__link">
|
|
|
Saving JSON document
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
</nav>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
<div class="md-content">
|
|
|
<article class="md-content__inner md-typeset">
|
|
|
|
|
|
|
|
|
|
|
|
<h1>Custom Web pages with JSON</h1>
|
|
|
|
|
|
<p>You can embed custom Web pages written in <a href="https://www.json.org/index.html"><strong>JSON</strong></a> into AutoConnect without AutoConnectAux & AutoConnectElements declaration. Custom Web page declaration by JSON can embed in the Sketch as a fixed string or can store in the external file such as SPIFFS for stream loading. Also, you can also load and save AutoConnectElements objects individually.<sup id="fnref:1"><a class="footnote-ref" href="#fn:1">1</a></sup></p>
|
|
|
<p>By providing the following JSON document to AutoConnect, you can include the custom Web page like the below:</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 contain the custom Web page multiple. You can further reduce the Sketch process by loading multiple pages of JSON document at once.</p>
|
|
|
<div class="admonition caution">
|
|
|
<p class="admonition-title">Adopt ArduinoJson v5 or v6</p>
|
|
|
<p>To handle AutoConnectAux and AutoConnectElements written in JSON, you need to install the ArduinoJson library. You can adopt either <a href="https://arduinojson.org/v5/doc/installation/">version 5</a> or <a href="https://arduinojson.org/v6/doc/installation/">version 6</a> for the ArduinoJson. AutoConnect supports both versions.</p>
|
|
|
</div>
|
|
|
<h2 id="json-objects-elements-for-the-custom-web-page">JSON objects & elements for the custom Web page<a class="headerlink" href="#json-objects-elements-for-the-custom-web-page" title="Permanent link">¶</a></h2>
|
|
|
<h3 id="json-document-structure-for-autoconnectaux"><i class="fa fa-caret-right"></i> JSON document structure for AutoConnectAux<a class="headerlink" href="#json-document-structure-for-autoconnectaux" title="Permanent link">¶</a></h3>
|
|
|
<p>AutoConnectAux will configure custom Web pages with JSON objects. The elements that make up the object are as follows:</p>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"title"</span> <span style="color: #f92672">:</span> <span style="color: #a6e22e">title</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"uri"</span> <span style="color: #f92672">:</span> <span style="color: #a6e22e">uri</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"menu"</span> <span style="color: #f92672">:</span> <span style="color: #66d9ef">true</span> <span style="color: #f92672">|</span> <span style="color: #66d9ef">false</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"element"</span> <span style="color: #f92672">:</span> <span style="color: #a6e22e">element_array</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<h4 id="title"><i class="fa fa-key"></i> <strong>title</strong><a class="headerlink" href="#title" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>A title of the custom Web page. This is string value. String specified <em>title</em> will be displayed in the AutoConnection menu.</dd>
|
|
|
</dl>
|
|
|
<h4 id="uri"><i class="fa fa-key"></i> <strong>uri</strong><a class="headerlink" href="#uri" title="Permanent link">¶</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>
|
|
|
</dl>
|
|
|
<h4 id="menu"><i class="fa fa-key"></i> <strong>menu</strong><a class="headerlink" href="#menu" title="Permanent link">¶</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>
|
|
|
</dl>
|
|
|
<h4 id="element"><i class="fa fa-key"></i> <strong>element</strong><a class="headerlink" href="#element" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>Describe an array of JSON objects as <em>element_array</em>. It is a JSON object array of the <a href="#json-object-for-autoconnectelements">AutoConnectElements</a> that make up the custom Web page.</dd>
|
|
|
</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>
|
|
|
</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">¶</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>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #f92672">"title"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"Page 1 title"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"uri"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"/page1"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"menu"</span> <span style="color: #f8f8f2">:</span> <span style="color: #66d9ef">true</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"element"</span> <span style="color: #f8f8f2">:</span> <span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #f92672">"name"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"caption"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"type"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"ACText"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"value"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"hello, world"</span>
|
|
|
<span style="color: #f8f8f2">},</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #f92672">"name"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"send"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"type"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"ACSubmit"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"uri"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"/page2"</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">"title"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"Page 1 title"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"uri"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"/page2"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"menu"</span> <span style="color: #f8f8f2">:</span> <span style="color: #66d9ef">false</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"element"</span> <span style="color: #f8f8f2">:</span> <span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #f92672">"name"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"responds"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"type"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"ACText"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"value"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"Good day"</span>
|
|
|
<span style="color: #f8f8f2">},</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #f92672">"name"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"send"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"type"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"ACSubmit"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"uri"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"/page3"</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">"title"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"Page 3 title"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"uri"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"/page3"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"menu"</span> <span style="color: #f8f8f2">:</span> <span style="color: #66d9ef">true</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"element"</span> <span style="color: #f8f8f2">:</span> <span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #f92672">"name"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"responds"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"type"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"ACText"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f92672">"value"</span> <span style="color: #f8f8f2">:</span> <span style="color: #e6db74">"bye"</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
<span style="color: #f8f8f2">]</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
<span style="color: #f8f8f2">]</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<p>The above custom Web page definitions can be loaded in a batch using the <a href="api.html#load">AutoConnect::load</a> function.</p>
|
|
|
<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">¶</a></h3>
|
|
|
<p>JSON description for AutoConnectElements describes as an array in the <em>element</em> with arguments of <a href="acelements.html#constructor">each constructor</a>.</p>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"name"</span> <span style="color: #f92672">:</span> <span style="color: #a6e22e">name</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"type"</span> <span style="color: #f92672">:</span> <span style="color: #a6e22e">type</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #a6e22e">key_according_to_type</span> <span style="color: #f92672">:</span> <span style="color: #a6e22e">the_value</span> <span style="color: #f92672">|</span> <span style="color: #a6e22e">array_of_value</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #f8f8f2">[</span> <span style="color: #a6e22e">key_according_to_type</span> <span style="color: #f92672">:</span> <span style="color: #a6e22e">the_value</span> <span style="color: #f92672">|</span> <span style="color: #a6e22e">array_of_value</span> <span style="color: #f8f8f2">]</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<h4 id="name"><i class="fa fa-key"></i> <strong>name</strong><a class="headerlink" href="#name" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>A string of the name for the element.</dd>
|
|
|
</dl>
|
|
|
<h4 id="type"><i class="fa fa-key"></i> <strong>type</strong><a class="headerlink" href="#type" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>A string of the type for the element. For this type, specify the following string corresponding to each element.</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectButton: <a href="#acbutton"><strong>ACButton</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectCheckbox: <a href="#accheckbox"><strong>ACCheckbox</strong> </a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectElement: <a href="#acelement"><strong>ACElement</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectFile: <a href="#acfile"><strong>ACFile</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectInput: <a href="#acinput"><strong>ACInput</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectRadio: <a href="#acradio"><strong>ACRadio</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectSelect: <a href="#acselect"><strong>ACSelect</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectStyle: <a href="#acstyle"><strong>ACStyle</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectSubmit: <a href="#acsubmit"><strong>ACSubmit</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li>AutoConnectText: <a href="#actext"><strong>ACText</strong></a></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="key_according_to_type"><i class="fa fa-key"></i> <strong><i>key_according_to_type</i></strong><a class="headerlink" href="#key_according_to_type" title="Permanent link">¶</a></h4>
|
|
|
<p>This is different for each AutoConnectElements, and the key that can be specified by the type of AutoConnectElements is determined.</p>
|
|
|
<h4 id="acbutton"><i class="fa fa-caret-right"></i> ACButton<a class="headerlink" href="#acbutton" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : Specifies the button label. This value also applies to the <code>value</code> attribute of an HTML <code>button</code> tag.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>action</strong> : 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.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="accheckbox"><i class="fa fa-caret-right"></i> ACCheckbox<a class="headerlink" href="#accheckbox" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : Specifies the value to be supplied to the checkbox. It will be packed in the query string as <code>name=value</code> when the checkbox is ticked.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>label</strong> : Specifies a label of the checkbox. Its placement is always to the right of the checkbox.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>checked</strong> : Specifies checking status as a <strong>boolean</strong> value. The value of the checked checkbox element is packed in the query string and sent.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="acelement"><i class="fa fa-caret-right"></i> ACElement<a class="headerlink" href="#acelement" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="acfile"><i class="fa fa-caret-right"></i> ACFile<a class="headerlink" href="#acfile" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : The file name of the upload file will be stored. The <code>value</code> is read-only and will be ignored if specified.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>label</strong> : Specifies a label of the file selection box. Its placement is always to the left of the file selection box.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>store</strong> : Specifies the destination to save the uploaded file. Its value accepts one of the following:<p>
|
|
|
<b>fs</b> : Save as the SPIFFS file in flash of ESP8266/ESP32 module.<br>
|
|
|
<b>sd</b> : Save to an external SD device connected to ESP8266/ESP32 module.<br>
|
|
|
<b>extern</b> : Pass the content of the uploaded file to the uploader which is declared by the Sketch individually. Its uploader must inherit <a href="acupload.html#to-upload-to-a-device-other-than-flash-or-sd"><strong>AutoConnectUploadHandler</strong></a> class and implements <em>_open</em>, <em>_write</em> and <em>_close</em> function.</p></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="acinput"><i class="fa fa-caret-right"></i> ACInput<a class="headerlink" href="#acinput" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>label</strong> : Specifies a label of the input box. Its placement is always to the left of the input box.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>placeholder</strong> : Specifies short hint of the input box.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="acradio"><i class="fa fa-caret-right"></i> ACRadio<a class="headerlink" href="#acradio" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : Specifies the collection of radio buttons as an array element.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>label</strong> : 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 <code>arrange</code>.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>arrange</strong> : Specifies the orientation of the radio buttons. Its value accepts one of the following:<p>
|
|
|
<b>horizontal</b> : Horizontal arrangement.<br>
|
|
|
<b>vertical</b> : Vertical arrangement.</p></li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>checked</strong> : Specifies the index number (1-based) of the radio buttons collection to be checked.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="acselect"><i class="fa fa-caret-right"></i> ACSelect<a class="headerlink" href="#acselect" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>label</strong> : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>option</strong> : Specifies the initial value collection of the drop-down list as an array element.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="acstyle"><i class="fa fa-caret-right"></i> ACStyle<a class="headerlink" href="#acstyle" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : Specifies the custom CSS code.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="acsubmit"><i class="fa fa-caret-right"></i> ACSubmit<a class="headerlink" href="#acsubmit" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : Specifies a label of the submit button.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>uri</strong> : Specifies the URI to send form data when the button is clicked.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<h4 id="actext"><i class="fa fa-caret-right"></i> ACText<a class="headerlink" href="#actext" title="Permanent link">¶</a></h4>
|
|
|
<dl>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>value</strong> : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>style</strong> : Specifies the qualification style to give to the content and can use the style attribute format as it is.</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
<dd>
|
|
|
<ul>
|
|
|
<li><strong>format</strong> : Specifies how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to the C-style printf library functions, but depends on the espressif sdk implementation. The conversion specification is valid only for <strong>%s</strong> format. (Left and Right justification, width are also valid.)</li>
|
|
|
</ul>
|
|
|
</dd>
|
|
|
</dl>
|
|
|
<div class="admonition caution">
|
|
|
<p class="admonition-title">AutoConnect's JSON parsing process is not perfect</p>
|
|
|
<p>It is based on analysis by ArduinoJson, but the semantic analysis is simplified to save memory. Consequently, it is not an error that a custom Web page JSON document to have unnecessary keys. It will be ignored.</p>
|
|
|
</div>
|
|
|
<h2 id="loading-json-document">Loading JSON document<a class="headerlink" href="#loading-json-document" title="Permanent link">¶</a></h2>
|
|
|
<h3 id="loading-to-autoconnect"><i class="fa fa-caret-right"></i> Loading to AutoConnect<a class="headerlink" href="#loading-to-autoconnect" title="Permanent link">¶</a></h3>
|
|
|
<p>There are two main ways to load the custom Web pages into AutoConnect.</p>
|
|
|
<ol>
|
|
|
<li>
|
|
|
<p>Load directly into AutoConnect</p>
|
|
|
<p>This way does not require an explicit declaration of AutoConnectAux objects with sketches and is also useful when importing the custom Web pages JSON document from an external file such as SPIFFS because the page definition and sketch coding structure can be separated.</p>
|
|
|
<p>Using the <a href="api.html#load">AutoCoonnect::load</a> function, AutoConnect dynamically generates the necessary AutoConnectAux objects internally based on the custom Web page definition of the imported JSON document content. In the Sketch, the generated AutoConnectAux object can be referenced using the <a href="api.html#aux">AutoConnect::aux</a> function. You can reach the AutoConnectElements you desired using the <a href="apiaux.html#getelement">AutoConnectAux::getElement</a> function of its AutoConnectAux.</p>
|
|
|
<p>In the following example, it loads in a batch a JSON document of custom Web pages stored in SPIFFS and accesses to the AutoConnectInput element.</p>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"title"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"page1"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"uri"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"/page1"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"menu"</span><span style="color: #f92672">:</span> <span style="color: #66d9ef">true</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"element"</span><span style="color: #f92672">:</span> <span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"name"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"input1"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"type"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"ACInput"</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
<span style="color: #f8f8f2">]</span>
|
|
|
<span style="color: #f8f8f2">},</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"title"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"page2"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"uri"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"/page2"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"menu"</span><span style="color: #f92672">:</span> <span style="color: #66d9ef">true</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"element"</span><span style="color: #f92672">:</span> <span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"name"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"input2"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"type"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"ACInput"</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
<span style="color: #f8f8f2">]</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
<span style="color: #f8f8f2">]</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">AutoConnect</span> <span style="color: #f8f8f2">portal;</span>
|
|
|
<span style="color: #f8f8f2">File</span> <span style="color: #f8f8f2">page</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">SPIFFS.open(</span><span style="color: #e6db74">"/custom_page.json"</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">"r"</span><span style="color: #f8f8f2">);</span>
|
|
|
<span style="background-color: #49483e"><span style="color: #f8f8f2">portal.load(page);</span>
|
|
|
</span><span style="color: #f8f8f2">page.close();</span>
|
|
|
<span style="background-color: #49483e"><span style="color: #f8f8f2">AutoConnectAux</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">aux</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">portal.aux(</span><span style="color: #e6db74">"/page1"</span><span style="color: #f8f8f2">);</span>
|
|
|
</span><span style="background-color: #49483e"><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&</span> <span style="color: #f8f8f2">input1</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">aux</span><span style="color: #f92672">-></span><span style="color: #f8f8f2">getElement</span><span style="color: #f92672"><</span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">></span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">"input1"</span><span style="color: #f8f8f2">);</span>
|
|
|
</span></code></pre></div>
|
|
|
|
|
|
</li>
|
|
|
<li>
|
|
|
<p>Load to AutoConnectAux and join to AutoConnect</p>
|
|
|
<p>This way declares AutoConnectAux in the Sketch and loads the custom Web pages JSON document there. It has an advantage for if you want to define each page of a custom Web page individually or allocate AutoConnectAux objects dynamically on the Sketch side.</p>
|
|
|
<p>After loading a JSON document using the <a href="apiaux.html#load">AutoConnectAux::load</a> function by each, integrate those into AutoConnect using the <a href="api.html#join">AutoConnect::join</a> function.</p>
|
|
|
<p>In the following example, you can see the difference between two sketches in a sketch modified using the AutoConnectAux::load.</p>
|
|
|
<p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"title"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"page1"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"uri"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"/page1"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"menu"</span><span style="color: #f92672">:</span> <span style="color: #66d9ef">true</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"element"</span><span style="color: #f92672">:</span> <span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"name"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"input1"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"type"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"ACInput"</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
<span style="color: #f8f8f2">]</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
</code></pre></div>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"title"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"page2"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"uri"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"/page2"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"menu"</span><span style="color: #f92672">:</span> <span style="color: #66d9ef">true</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"element"</span><span style="color: #f92672">:</span> <span style="color: #f8f8f2">[</span>
|
|
|
<span style="color: #f8f8f2">{</span>
|
|
|
<span style="color: #e6db74">"name"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"input2"</span><span style="color: #f8f8f2">,</span>
|
|
|
<span style="color: #e6db74">"type"</span><span style="color: #f92672">:</span> <span style="color: #e6db74">"ACInput"</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
<span style="color: #f8f8f2">]</span>
|
|
|
<span style="color: #f8f8f2">}</span>
|
|
|
</code></pre></div>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">AutoConnect</span> <span style="color: #f8f8f2">portal;</span>
|
|
|
<span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #f8f8f2">page1;</span>
|
|
|
<span style="color: #f8f8f2">AutoConnectAux</span> <span style="color: #f8f8f2">page2;</span>
|
|
|
<span style="color: #f8f8f2">File</span> <span style="color: #f8f8f2">page</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">SPIFFS.open(</span><span style="color: #e6db74">"/custom_page1.json"</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">"r"</span><span style="color: #f8f8f2">);</span>
|
|
|
<span style="background-color: #49483e"><span style="color: #f8f8f2">page1.load(page);</span>
|
|
|
</span><span style="color: #f8f8f2">page.close();</span>
|
|
|
<span style="color: #f8f8f2">page</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">SPIFFS.open(</span><span style="color: #e6db74">"/custom_page2.json"</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">"r"</span><span style="color: #f8f8f2">);</span>
|
|
|
<span style="background-color: #49483e"><span style="color: #f8f8f2">page2.load(page);</span>
|
|
|
</span><span style="color: #f8f8f2">page.close();</span>
|
|
|
<span style="background-color: #49483e"><span style="color: #f8f8f2">portal.join(</span> <span style="color: #f8f8f2">{</span> <span style="color: #f8f8f2">page1,</span> <span style="color: #f8f8f2">page2</span> <span style="color: #f8f8f2">}</span> <span style="color: #f8f8f2">);</span>
|
|
|
</span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">&</span> <span style="color: #f8f8f2">input1</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">page1.getElement</span><span style="color: #f92672"><</span><span style="color: #f8f8f2">AutoConnectInput</span><span style="color: #f92672">></span><span style="color: #f8f8f2">(</span><span style="color: #e6db74">"input1"</span><span style="color: #f8f8f2">);</span>
|
|
|
</code></pre></div></p>
|
|
|
</li>
|
|
|
</ol>
|
|
|
<h3 id="loading-from-the-streamed-file"><i class="fa fa-caret-right"></i> Loading from the streamed file<a class="headerlink" href="#loading-from-the-streamed-file" title="Permanent link">¶</a></h3>
|
|
|
<p>AutoConnect supports loading of JSON document from the following instances:</p>
|
|
|
<ul>
|
|
|
<li>String</li>
|
|
|
<li>PROGMEM</li>
|
|
|
<li>Stream</li>
|
|
|
</ul>
|
|
|
<p>To load custom Web pages JSON document into AutoConnect, use the <a href="api.html#load">load</a> 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 <a href="https://arduinojson.org/v5/assistant/">ArduinoJson Assistant</a>. It is useful for pre-checking.</p>
|
|
|
<p><div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">AutoConnect</span><span style="color: #f92672">::</span><span style="color: #f8f8f2">load(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span><span style="color: #f92672">&</span> <span style="color: #f8f8f2">aux)</span>
|
|
|
</code></pre></div>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">AutoConnect</span><span style="color: #f92672">::</span><span style="color: #f8f8f2">load(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">__FlashStringHelper</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">aux)</span>
|
|
|
</code></pre></div>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">AutoConnect</span><span style="color: #f92672">::</span><span style="color: #f8f8f2">load(Stream</span><span style="color: #f92672">&</span> <span style="color: #f8f8f2">aux)</span>
|
|
|
</code></pre></div>
|
|
|
An example of using each function is as follows.
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #f8f8f2">AutoConnect</span> <span style="color: #f8f8f2">portal;</span>
|
|
|
|
|
|
<span style="color: #75715e">// Loading from String</span>
|
|
|
<span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">String</span> <span style="color: #f8f8f2">aux</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">String(</span><span style="color: #e6db74">"{</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">title</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">:</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">Page 1 title</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">,</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">uri</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">:</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">/page1</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">,</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">menu</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">:true,</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">element</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">:[{</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">name</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">:</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">caption</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">,</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">type</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">:</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">ACText</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">,</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">value</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">:</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">hello, world</span><span style="color: #ae81ff">\"</span><span style="color: #e6db74">}]}"</span><span style="color: #f8f8f2">);</span>
|
|
|
<span style="color: #f8f8f2">portal.load(aux);</span>
|
|
|
|
|
|
<span style="color: #75715e">// Loading from PROGMEM</span>
|
|
|
<span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span> <span style="color: #f8f8f2">aux[]</span> <span style="color: #f8f8f2">PROGMEM</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">R"raw(</span>
|
|
|
<span style="color: #e6db74">{</span>
|
|
|
<span style="color: #e6db74"> "title" : "Page 1 title",</span>
|
|
|
<span style="color: #e6db74"> "uri" : "/page1",</span>
|
|
|
<span style="color: #e6db74"> "menu" : true,</span>
|
|
|
<span style="color: #e6db74"> "element" : [</span>
|
|
|
<span style="color: #e6db74"> {</span>
|
|
|
<span style="color: #e6db74"> "name" : "caption",</span>
|
|
|
<span style="color: #e6db74"> "type" : "ACText",</span>
|
|
|
<span style="color: #e6db74"> "value" : "hello, world"</span>
|
|
|
<span style="color: #e6db74"> }</span>
|
|
|
<span style="color: #e6db74"> ]</span>
|
|
|
<span style="color: #e6db74">}</span>
|
|
|
<span style="color: #e6db74">)raw"</span><span style="color: #f8f8f2">;</span>
|
|
|
<span style="color: #f8f8f2">portal.load(aux);</span>
|
|
|
|
|
|
<span style="color: #75715e">// Loading from Stream assumes "aux.json" file should be store in SPIFFS.</span>
|
|
|
<span style="color: #f8f8f2">File</span> <span style="color: #f8f8f2">aux</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">SPIFFS.open(</span><span style="color: #e6db74">"aux.json"</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">"r"</span><span style="color: #f8f8f2">);</span>
|
|
|
<span style="color: #f8f8f2">portal.load(aux);</span>
|
|
|
<span style="color: #f8f8f2">aux.close();</span>
|
|
|
</code></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>
|
|
|
<h3 id="adjust-the-json-document-buffer-size"><i class="fa fa-caret-right"></i> Adjust the JSON document buffer size<a class="headerlink" href="#adjust-the-json-document-buffer-size" title="Permanent link">¶</a></h3>
|
|
|
<p>AutoConnect uses ArduinoJson library's dynamic buffer to parse JSON documents. Its dynamic buffer allocation scheme depends on the version 5 or version 6 of ArduinoJson library. Either version must have enough buffer to parse the custom web page's JSON document successfully. AutoConnect has the following three constants internally to complete the parsing as much as possible in both ArduinoJson version. These constants are macro defined in <a href="https://github.com/Hieromon/AutoConnect/blob/master/src/AutoConnectDefs.h">AutoConnectDefs.h</a>.</p>
|
|
|
<p>If memory insufficiency occurs during JSON document parsing, you can adjust these constants to avoid insufficiency by using the <a href="https://arduinojson.org/v6/assistant/">JsonAssistant</a> with deriving the required buffer size in advance.</p>
|
|
|
<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><code><span style="color: #75715e">#define AUTOCONNECT_JSONBUFFER_SIZE 256</span>
|
|
|
<span style="color: #75715e">#define AUTOCONNECT_JSONDOCUMENT_SIZE (8 * 1024)</span>
|
|
|
<span style="color: #75715e">#define AUTOCONNECT_JSONPSRAM_SIZE (16* 1024)</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<h4 id="autoconnect_jsonbuffer_size">AUTOCONNECT_JSONBUFFER_SIZE<a class="headerlink" href="#autoconnect_jsonbuffer_size" title="Permanent link">¶</a></h4>
|
|
|
<p>This is a unit size constant of <a href="https://arduinojson.org/v5/faq/what-are-the-differences-between-staticjsonbuffer-and-dynamicjsonbuffer/">DynamicJsonBuffer</a> and works when the library used is ArduinoJson version 5. A buffer size of the JSON document increases with this unit. This value relates to the impact of the fragmented heap area. If it is too large, may occur run-out of memory.</p>
|
|
|
<h4 id="autoconnect_jsondocument_size">AUTOCONNECT_JSONDOCUMENT_SIZE<a class="headerlink" href="#autoconnect_jsondocument_size" title="Permanent link">¶</a></h4>
|
|
|
<p>This is a size of <a href="https://arduinojson.org/v6/api/dynamicjsondocument/">DynamicJsonDocument</a> for ArduinoJson version 6. This buffer is not automatically expanding, and the size determines the limit.</p>
|
|
|
<h4 id="autoconnect_jsonpsram_size">AUTOCONNECT_JSONPSRAM_SIZE<a class="headerlink" href="#autoconnect_jsonpsram_size" title="Permanent link">¶</a></h4>
|
|
|
<p>For ESP32 module equips with PSRAM, you can allocate the JSON document buffer to PSRAM. Buffer allocation to PSRAM will enable when <strong>PSRAM:Enabled</strong> option selected in the Arduino IDE's Board Manager menu. It is available since ArduinoJson 6.10.0.</p>
|
|
|
<h2 id="saving-json-document">Saving JSON document<a class="headerlink" href="#saving-json-document" title="Permanent link">¶</a></h2>
|
|
|
<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>
|
|
|
<li id="fn:1">
|
|
|
<p>Loading and saving AutoConnect parameters adopt this method. <a class="footnote-backref" href="#fnref:1" title="Jump back to footnote 1 in the text">↩</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="acelements.html" title="AutoConnectElements" 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>
|
|
|
AutoConnectElements
|
|
|
</span>
|
|
|
</div>
|
|
|
</a>
|
|
|
|
|
|
|
|
|
<a href="achandling.html" title="Handling the custom Web pages" 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>
|
|
|
Handling the custom Web pages
|
|
|
</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 © 2018-2020 Hieromon Ikasamo
|
|
|
</div>
|
|
|
|
|
|
powered by
|
|
|
<a href="https://www.mkdocs.org" target="_blank" rel="noopener">MkDocs</a>
|
|
|
and
|
|
|
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
|
|
|
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" target="_blank" rel="noopener" title="github" class="md-footer-social__link fa fa-github"></a>
|
|
|
|
|
|
<a href="https://twitter.com/hieromon" target="_blank" rel="noopener" title="twitter" class="md-footer-social__link fa fa-twitter"></a>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
</div>
|
|
|
</footer>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<script src="assets/javascripts/application.c33a9706.js"></script>
|
|
|
|
|
|
<script>app.initialize({version:"1.1",url:{base:"."}})</script>
|
|
|
|
|
|
<script src="js/gifffer.min.js"></script>
|
|
|
|
|
|
|
|
|
</body>
|
|
|
</html> |
