Fork of the espurna firmware for `mhsw` switches
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

785 lines
22 KiB

8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
Remove wifi info from File: dir, Node: Top, This is the top of the INFO tree. This is the Info main menu (aka directory node). A few useful Info commands: 'q' quits; '?' lists all Info commands; 'h' starts the Info tutorial; 'mTexinfo RET' visits the Texinfo manual, etc. * Menu: Basics * Common options: (coreutils)Common options. * Coreutils: (coreutils). Core GNU (file, text, shell) utilities. * Date input formats: (coreutils)Date input formats. * Ed: (ed). The GNU line editor * File permissions: (coreutils)File permissions. Access modes. * Finding files: (find). Operating on files matching certain criteria. C++ libraries * autosprintf: (autosprintf). Support for printf format strings in C++. Compression * Gzip: (gzip). General (de)compression of files (lzw). Development * SSIP: (ssip). Speech Synthesis Interface Protocol. * Speech Dispatcher: (speech-dispatcher). Speech Dispatcher. * libffi: (libffi). Portable foreign-function interface library. DOS * Mtools: (mtools). Mtools: utilities to access DOS disks in Unix. Editors * nano: (nano). Small and friendly text editor. General Commands * Screen: (screen). Full-screen window manager. GNU Gettext Utilities * autopoint: (gettext)autopoint Invocation. Copy gettext infrastructure. * envsubst: (gettext)envsubst Invocation. Expand environment variables. * gettextize: (gettext)gettextize Invocation. Prepare a package for gettext. * gettext: (gettext). GNU gettext utilities. * ISO3166: (gettext)Country Codes. ISO 3166 country codes. * ISO639: (gettext)Language Codes. ISO 639 language codes. * msgattrib: (gettext)msgattrib Invocation. Select part of a PO file. * msgcat: (gettext)msgcat Invocation. Combine several PO files. * msgcmp: (gettext)msgcmp Invocation. Compare a PO file and template. * msgcomm: (gettext)msgcomm Invocation. Match two PO files. * msgconv: (gettext)msgconv Invocation. Convert PO file to encoding. * msgen: (gettext)msgen Invocation. Create an English PO file. * msgexec: (gettext)msgexec Invocation. Process a PO file. * msgfilter: (gettext)msgfilter Invocation. Pipe a PO file through a filter. * msgfmt: (gettext)msgfmt Invocation. Make MO files out of PO files. * msggrep: (gettext)msggrep Invocation. Select part of a PO file. * msginit: (gettext)msginit Invocation. Create a fresh PO file. * msgmerge: (gettext)msgmerge Invocation. Update a PO file from template. * msgunfmt: (gettext)msgunfmt Invocation. Uncompile MO file into PO file. * msguniq: (gettext)msguniq Invocation. Unify duplicates for PO file. * ngettext: (gettext)ngettext Invocation. Translate a message with plural. * xgettext: (gettext)xgettext Invocation. Extract strings into a PO file. GNU organization * Maintaining Findutils: (find-maint). Maintaining GNU findutils GNU Utilities * dirmngr-client: (gnupg). X.509 CRL and OCSP client. * dirmngr: (gnupg). X.509 CRL and OCSP server. * gpg: (gnupg1). OpenPGP encryption and signing tool (v1). * gpg-agent: (gnupg). The secret key daemon. * gpg2: (gnupg). OpenPGP encryption and signing tool. * gpgsm: (gnupg). S/MIME encryption and signing tool. Individual utilities * aclocal-invocation: (automake-1.15)aclocal Invocation. Generating aclocal.m4. * arch: (coreutils)arch invocation. Print machine hardware name. * automake-invocation: (automake-1.15)automake Invocation. Generating Makefile.in. * base32: (coreutils)base32 invocation. Base32 encode/decode data. * base64: (coreutils)base64 invocation. Base64 encode/decode data. * basename: (coreutils)basename invocation. Strip directory and suffix. * bibtex: (web2c)bibtex invocation. Maintaining bibliographies. * cat: (coreutils)cat invocation. Concatenate and write files. * chcon: (coreutils)chcon invocation. Change SELinux CTX of files. * chgrp: (coreutils)chgrp invocation. Change file groups. * chmod: (coreutils)chmod invocation. Change access permissions. * chown: (coreutils)chown invocation. Change file owners and groups. * chroot: (coreutils)chroot invocation. Specify the root directory. * cksum: (coreutils)cksum invocation. Print POSIX CRC checksum. * cmp: (diffutils)Invoking cmp. Compare 2 files byte by byte. * comm: (coreutils)comm invocation. Compare sorted files by line. * cp: (coreutils)cp invocation. Copy files. * csplit: (coreutils)csplit invocation. Split by context. * cut: (coreutils)cut invocation. Print selected parts of lines. * date: (coreutils)date invocation. Print/set system date and time. * dd: (coreutils)dd invocation. Copy and convert a file. * df: (coreutils)df invocation. Report file system disk usage. * diff: (diffutils)Invoking diff. Compare 2 files line by line. * diff3: (diffutils)Invoking diff3. Compare 3 files line by line. * dir: (coreutils)dir invocation. List directories briefly. * dircolors: (coreutils)dircolors invocation. Color setup for ls. * dirname: (coreutils)dirname invocation. Strip last file name component. * du: (coreutils)du invocation. Report on disk usage. * dvicopy: (web2c)dvicopy invocation. Virtual font expansion * dvitomp: (web2c)dvitomp invocation. DVI to MPX (MetaPost pictures). * dvitype: (web2c)dvitype invocation. DVI to human-readable text. * echo: (coreutils)echo invocation. Print a line of text. * env: (coreutils)env invocation. Modify the environment. * expand: (coreutils)expand invocation. Convert tabs to spaces. * expr: (coreutils)expr invocation. Evaluate expressions. * factor: (coreutils)factor invocation. Print prime factors * false: (coreutils)false invocation. Do nothing, unsuccessfully. * find: (find)Invoking find. Finding and acting on files. * fmt: (coreutils)fmt invocation. Reformat paragraph text. * fold: (coreutils)fold invocation. Wrap long input lines. * gftodvi: (web2c)gftodvi invocation. Generic font proofsheets. * gftopk: (web2c)gftopk invocation. Generic to packed fonts. * gftype: (web2c)gftype invocation. GF to human-readable text. * groups: (coreutils)groups invocation. Print group names a user is in. * gunzip: (gzip)Overview. Decompression. * gzexe: (gzip)Overview. Compress executables. * head: (coreutils)head invocation. Output the first part of files. * hostid: (coreutils)hostid invocation. Print numeric host identifier. * hostname: (coreutils)hostname invocation. Print or set system name. * id: (coreutils)id invocation. Print user identity. * install: (coreutils)install invocation. Copy files and set attributes. * join: (coreutils)join invocation. Join lines on a common field. * kill: (coreutils)kill invocation. Send a signal to processes. * link: (coreutils)link invocation. Make hard links between files. * ln: (coreutils)ln invocation. Make links between files. * locate: (find)Invoking locate. Finding files in a database. * logname: (coreutils)logname invocation. Print current login name. * ls: (coreutils)ls invocation. List directory contents. * md5sum: (coreutils)md5sum invocation. Print or check MD5 digests. * mf: (web2c)mf invocation. Creating typeface families. * mft: (web2c)mft invocation. Prettyprinting Metafont source. * mkdir: (coreutils)mkdir invocation. Create directories. * mkfifo: (coreutils)mkfifo invocation. Create FIFOs (named pipes). * mknod: (coreutils)mknod invocation. Create special files. * mktemp: (coreutils)mktemp invocation. Create temporary files. * mltex: (web2c)MLTeX. Multi-lingual TeX. * mpost: (web2c)mpost invocation. Creating technical diagrams. * mv: (coreutils)mv invocation. Rename files. * nice: (coreutils)nice invocation. Modify niceness. * nl: (coreutils)nl invocation. Number lines and write files. * nohup: (coreutils)nohup invocation. Immunize to hangups. * nproc: (coreutils)nproc invocation. Print the number of processors. * numfmt: (coreutils)numfmt invocation. Reformat numbers. * od: (coreutils)od invocation. Dump files in octal, etc. * paste: (coreutils)paste invocation. Merge lines of files. * patch: (diffutils)Invoking patch. Apply a patch to a file. * patgen: (web2c)patgen invocation. Creating hyphenation patterns. * pathchk: (coreutils)pathchk invocation. Check file name portability. * pktogf: (web2c)pktogf invocation. Packed to generic fonts. * pktype: (web2c)pktype invocation. PK to human-readable text. * pltotf: (web2c)pltotf invocation. Property list to TFM. * pooltype: (web2c)pooltype invocation. Display WEB pool files. * pr: (coreutils)pr invocation. Paginate or columnate files. * printenv: (coreutils)printenv invocation. Print environment variables. * printf: (coreutils)printf invocation. Format and print data. * ptx: (coreutils)ptx invocation. Produce permuted indexes. * pwd: (coreutils)pwd invocation. Print working directory. * readlink: (coreutils)readlink invocation. Print referent of a symlink. * realpath: (coreutils)realpath invocation. Print resolved file names. * rm: (coreutils)rm invocation. Remove files. * rmdir: (coreutils)rmdir invocation. Remove empty directories. * runcon: (coreutils)runcon invocation. Run in specified SELinux CTX. * sdiff: (diffutils)Invoking sdiff. Merge 2 files side-by-side. * seq: (coreutils)seq invocation. Print numeric sequences * sha1sum: (coreutils)sha1sum invocation. Print or check SHA-1 digests. * sha2: (coreutils)sha2 utilities. Print or check SHA-2 digests. * shred: (coreutils)shred invocation. Remove files more securely. * shuf: (coreutils)shuf invocation. Shuffling text files. * sleep: (coreutils)sleep invocation. Delay for a specified time. * sort: (coreutils)sort invocation. Sort text files. * split: (coreutils)split invocation. Split into pieces. * stat: (coreutils)stat invocation. Report file(system) status. * stdbuf: (coreutils)stdbuf invocation. Modify stdio buffering. * stty: (coreutils)stty invocation. Print/change terminal settings. * sum: (coreutils)sum invocation. Print traditional checksum. * sync: (coreutils)sync invocation. Synchronize memory to disk. * tac: (coreutils)tac invocation. Reverse files. * tail: (coreutils)tail invocation. Output the last part of files. * tangle: (web2c)tangle invocation. WEB to Pascal. * tee: (coreutils)tee invocation. Redirect to multiple files. * test: (coreutils)test invocation. File/string tests. * tex: (web2c)tex invocation. Typesetting. * tftopl: (web2c)tftopl invocation. TFM -> property list. * time: (time). Run programs and summarize system resource usage. * timeout: (coreutils)timeout invocation. Run with time limit. * touch: (coreutils)touch invocation. Change file timestamps. * tr: (coreutils)tr invocation. Translate characters. * true: (coreutils)true invocation. Do nothing, successfully. * truncate: (coreutils)truncate invocation. Shrink/extend size of a file. * tsort: (coreutils)tsort invocation. Topological sort. * tty: (coreutils)tty invocation. Print terminal name. * uname: (coreutils)uname invocation. Print system information. * unexpand: (coreutils)unexpand invocation. Convert spaces to tabs. * uniq: (coreutils)uniq invocation. Uniquify files. * unlink: (coreutils)unlink invocation. Removal via unlink(2). * updatedb: (find)Invoking updatedb. Building the locate database. * uptime: (coreutils)uptime invocation. Print uptime and load. * users: (coreutils)users invocation. Print current user names. * vdir: (coreutils)vdir invocation. List directories verbosely. * vftovp: (web2c)vftovp invocation. Virtual font -> virtual pl. * vptovf: (web2c)vptovf invocation. Virtual pl -> virtual font. * wc: (coreutils)wc invocation. Line, word, and byte counts. * weave: (web2c)weave invocation. WEB to TeX. * who: (coreutils)who invocation. Print who is logged in. * whoami: (coreutils)whoami invocation. Print effective user ID. * xargs: (find)Invoking xargs. Operating on many files. * yes: (coreutils)yes invocation. Print a string indefinitely. * zcat: (gzip)Overview. Decompression to stdout. * zdiff: (gzip)Overview. Compare compressed files. * zforce: (gzip)Overview. Force .gz extension on files. * zgrep: (gzip)Overview. Search compressed files. * zmore: (gzip)Overview. Decompression output by pages. Kernel * GRUB: (grub). The GRand Unified Bootloader * grub-dev: (grub-dev). The GRand Unified Bootloader Dev * grub-install: (grub)Invoking grub-install. Install GRUB on your drive * grub-mkconfig: (grub)Invoking grub-mkconfig. Generate GRUB configuration * grub-mkpasswd-pbkdf2: (grub)Invoking grub-mkpasswd-pbkdf2. * grub-mkrelpath: (grub)Invoking grub-mkrelpath. * grub-mkrescue: (grub)Invoking grub-mkrescue. Make a GRUB rescue image * grub-mount: (grub)Invoking grub-mount. Mount a file system using GRUB * grub-probe: (grub)Invoking grub-probe. Probe device information * grub-script-check: (grub)Invoking grub-script-check. Libraries * RLuserman: (rluserman). The GNU readline library User's Manual. Man-pages * Latex2man: (latex2man). Its Man-Page Math * bc: (bc). An arbitrary precision calculator language. * dc: (dc). Arbitrary precision RPN "Desktop Calculator". Network applications * Wget: (wget). Non-interactive network downloader. Programming * flex: (flex). Fast lexical analyzer generator (lex replacement). * gnucash: (gnucash-design). Design of the GnuCash program Programming Tools * Gperf: (gperf). Perfect Hash Function Generator. Software development * Autoconf Archive: (autoconf-archive). A collection of re-usable Autoconf macros. * Automake: (automake-1.15). Making GNU standards-compliant Makefiles. Sound * SSIP: (ssip). Speech Synthesis Interface Protocol. * Say for Speech Dispatcher: (spd-say). Say. * Speech Dispatcher: (speech-dispatcher). Speech Dispatcher. TeX * DVI-to-PNG: (dvipng). Translating TeX DVI files to Portable Network Graphics (PNG). * DVI-to-Postscript: (dvips). Translating TeX DVI files to PostScript. * Eplain: (eplain). Expanding on plain Tex. * EpsPDF: (epspdf). Portable GUI- and command-line EPS/PS/PDF conversion * Kpathsea: (kpathsea). File lookup along search paths. * LaTeX2e: (latex2e). Unofficial LaTeX reference manual. * LaTeX2e-es: (latex2e-es). Manual de extraoficial de LaTeX. * Naming TeX fonts: (fontname). Filenames for TeX fonts. * TL-build: (tlbuild). TeX Live configuration and development. * TeX Directories: (tds). A directory structure for TeX files. * TeXdraw: (texdraw). A system for producing PostScript drawings from TeX. * Web2c: (web2c). TeX, Metafont, and companion programs. * afm2tfm: (dvips)Invoking afm2tfm. Making Type 1 fonts available to TeX. * dvipng: (dvipng). A DVI-to-PNG translator. * dvips: (dvips)Invoking Dvips. DVI-to-PostScript translator. * kpsewhich: (kpathsea)Invoking kpsewhich. TeX file searching. * mf2pt1: (mf2pt1). PostScript Type 1 fonts from Metafont source. * mktexfmt: (kpathsea)mktex scripts. Format (fmt/base/mem) generation. * mktexlsr: (kpathsea)Filename database. Update ls-R. * mktexmf: (kpathsea)mktex scripts. MF source generation. * mktexpk: (kpathsea)mktex scripts. PK bitmap generation. * mktextex: (kpathsea)mktex scripts. TeX source generation. * mktextfm: (kpathsea)mktex scripts. TeX font metric generation. Text creation and manipulation * Diffutils: (diffutils). Comparing and merging files. * M4: (m4). A powerful macro processor. * grep: (grep). Print lines matching a pattern. * sed: (sed). Stream EDitor. command. Use * SSID MODE CHAN RATE SIGNAL BARS SECURITY to get current connections
6 years ago
Remove wifi info from File: dir, Node: Top, This is the top of the INFO tree. This is the Info main menu (aka directory node). A few useful Info commands: 'q' quits; '?' lists all Info commands; 'h' starts the Info tutorial; 'mTexinfo RET' visits the Texinfo manual, etc. * Menu: Basics * Common options: (coreutils)Common options. * Coreutils: (coreutils). Core GNU (file, text, shell) utilities. * Date input formats: (coreutils)Date input formats. * Ed: (ed). The GNU line editor * File permissions: (coreutils)File permissions. Access modes. * Finding files: (find). Operating on files matching certain criteria. C++ libraries * autosprintf: (autosprintf). Support for printf format strings in C++. Compression * Gzip: (gzip). General (de)compression of files (lzw). Development * SSIP: (ssip). Speech Synthesis Interface Protocol. * Speech Dispatcher: (speech-dispatcher). Speech Dispatcher. * libffi: (libffi). Portable foreign-function interface library. DOS * Mtools: (mtools). Mtools: utilities to access DOS disks in Unix. Editors * nano: (nano). Small and friendly text editor. General Commands * Screen: (screen). Full-screen window manager. GNU Gettext Utilities * autopoint: (gettext)autopoint Invocation. Copy gettext infrastructure. * envsubst: (gettext)envsubst Invocation. Expand environment variables. * gettextize: (gettext)gettextize Invocation. Prepare a package for gettext. * gettext: (gettext). GNU gettext utilities. * ISO3166: (gettext)Country Codes. ISO 3166 country codes. * ISO639: (gettext)Language Codes. ISO 639 language codes. * msgattrib: (gettext)msgattrib Invocation. Select part of a PO file. * msgcat: (gettext)msgcat Invocation. Combine several PO files. * msgcmp: (gettext)msgcmp Invocation. Compare a PO file and template. * msgcomm: (gettext)msgcomm Invocation. Match two PO files. * msgconv: (gettext)msgconv Invocation. Convert PO file to encoding. * msgen: (gettext)msgen Invocation. Create an English PO file. * msgexec: (gettext)msgexec Invocation. Process a PO file. * msgfilter: (gettext)msgfilter Invocation. Pipe a PO file through a filter. * msgfmt: (gettext)msgfmt Invocation. Make MO files out of PO files. * msggrep: (gettext)msggrep Invocation. Select part of a PO file. * msginit: (gettext)msginit Invocation. Create a fresh PO file. * msgmerge: (gettext)msgmerge Invocation. Update a PO file from template. * msgunfmt: (gettext)msgunfmt Invocation. Uncompile MO file into PO file. * msguniq: (gettext)msguniq Invocation. Unify duplicates for PO file. * ngettext: (gettext)ngettext Invocation. Translate a message with plural. * xgettext: (gettext)xgettext Invocation. Extract strings into a PO file. GNU organization * Maintaining Findutils: (find-maint). Maintaining GNU findutils GNU Utilities * dirmngr-client: (gnupg). X.509 CRL and OCSP client. * dirmngr: (gnupg). X.509 CRL and OCSP server. * gpg: (gnupg1). OpenPGP encryption and signing tool (v1). * gpg-agent: (gnupg). The secret key daemon. * gpg2: (gnupg). OpenPGP encryption and signing tool. * gpgsm: (gnupg). S/MIME encryption and signing tool. Individual utilities * aclocal-invocation: (automake-1.15)aclocal Invocation. Generating aclocal.m4. * arch: (coreutils)arch invocation. Print machine hardware name. * automake-invocation: (automake-1.15)automake Invocation. Generating Makefile.in. * base32: (coreutils)base32 invocation. Base32 encode/decode data. * base64: (coreutils)base64 invocation. Base64 encode/decode data. * basename: (coreutils)basename invocation. Strip directory and suffix. * bibtex: (web2c)bibtex invocation. Maintaining bibliographies. * cat: (coreutils)cat invocation. Concatenate and write files. * chcon: (coreutils)chcon invocation. Change SELinux CTX of files. * chgrp: (coreutils)chgrp invocation. Change file groups. * chmod: (coreutils)chmod invocation. Change access permissions. * chown: (coreutils)chown invocation. Change file owners and groups. * chroot: (coreutils)chroot invocation. Specify the root directory. * cksum: (coreutils)cksum invocation. Print POSIX CRC checksum. * cmp: (diffutils)Invoking cmp. Compare 2 files byte by byte. * comm: (coreutils)comm invocation. Compare sorted files by line. * cp: (coreutils)cp invocation. Copy files. * csplit: (coreutils)csplit invocation. Split by context. * cut: (coreutils)cut invocation. Print selected parts of lines. * date: (coreutils)date invocation. Print/set system date and time. * dd: (coreutils)dd invocation. Copy and convert a file. * df: (coreutils)df invocation. Report file system disk usage. * diff: (diffutils)Invoking diff. Compare 2 files line by line. * diff3: (diffutils)Invoking diff3. Compare 3 files line by line. * dir: (coreutils)dir invocation. List directories briefly. * dircolors: (coreutils)dircolors invocation. Color setup for ls. * dirname: (coreutils)dirname invocation. Strip last file name component. * du: (coreutils)du invocation. Report on disk usage. * dvicopy: (web2c)dvicopy invocation. Virtual font expansion * dvitomp: (web2c)dvitomp invocation. DVI to MPX (MetaPost pictures). * dvitype: (web2c)dvitype invocation. DVI to human-readable text. * echo: (coreutils)echo invocation. Print a line of text. * env: (coreutils)env invocation. Modify the environment. * expand: (coreutils)expand invocation. Convert tabs to spaces. * expr: (coreutils)expr invocation. Evaluate expressions. * factor: (coreutils)factor invocation. Print prime factors * false: (coreutils)false invocation. Do nothing, unsuccessfully. * find: (find)Invoking find. Finding and acting on files. * fmt: (coreutils)fmt invocation. Reformat paragraph text. * fold: (coreutils)fold invocation. Wrap long input lines. * gftodvi: (web2c)gftodvi invocation. Generic font proofsheets. * gftopk: (web2c)gftopk invocation. Generic to packed fonts. * gftype: (web2c)gftype invocation. GF to human-readable text. * groups: (coreutils)groups invocation. Print group names a user is in. * gunzip: (gzip)Overview. Decompression. * gzexe: (gzip)Overview. Compress executables. * head: (coreutils)head invocation. Output the first part of files. * hostid: (coreutils)hostid invocation. Print numeric host identifier. * hostname: (coreutils)hostname invocation. Print or set system name. * id: (coreutils)id invocation. Print user identity. * install: (coreutils)install invocation. Copy files and set attributes. * join: (coreutils)join invocation. Join lines on a common field. * kill: (coreutils)kill invocation. Send a signal to processes. * link: (coreutils)link invocation. Make hard links between files. * ln: (coreutils)ln invocation. Make links between files. * locate: (find)Invoking locate. Finding files in a database. * logname: (coreutils)logname invocation. Print current login name. * ls: (coreutils)ls invocation. List directory contents. * md5sum: (coreutils)md5sum invocation. Print or check MD5 digests. * mf: (web2c)mf invocation. Creating typeface families. * mft: (web2c)mft invocation. Prettyprinting Metafont source. * mkdir: (coreutils)mkdir invocation. Create directories. * mkfifo: (coreutils)mkfifo invocation. Create FIFOs (named pipes). * mknod: (coreutils)mknod invocation. Create special files. * mktemp: (coreutils)mktemp invocation. Create temporary files. * mltex: (web2c)MLTeX. Multi-lingual TeX. * mpost: (web2c)mpost invocation. Creating technical diagrams. * mv: (coreutils)mv invocation. Rename files. * nice: (coreutils)nice invocation. Modify niceness. * nl: (coreutils)nl invocation. Number lines and write files. * nohup: (coreutils)nohup invocation. Immunize to hangups. * nproc: (coreutils)nproc invocation. Print the number of processors. * numfmt: (coreutils)numfmt invocation. Reformat numbers. * od: (coreutils)od invocation. Dump files in octal, etc. * paste: (coreutils)paste invocation. Merge lines of files. * patch: (diffutils)Invoking patch. Apply a patch to a file. * patgen: (web2c)patgen invocation. Creating hyphenation patterns. * pathchk: (coreutils)pathchk invocation. Check file name portability. * pktogf: (web2c)pktogf invocation. Packed to generic fonts. * pktype: (web2c)pktype invocation. PK to human-readable text. * pltotf: (web2c)pltotf invocation. Property list to TFM. * pooltype: (web2c)pooltype invocation. Display WEB pool files. * pr: (coreutils)pr invocation. Paginate or columnate files. * printenv: (coreutils)printenv invocation. Print environment variables. * printf: (coreutils)printf invocation. Format and print data. * ptx: (coreutils)ptx invocation. Produce permuted indexes. * pwd: (coreutils)pwd invocation. Print working directory. * readlink: (coreutils)readlink invocation. Print referent of a symlink. * realpath: (coreutils)realpath invocation. Print resolved file names. * rm: (coreutils)rm invocation. Remove files. * rmdir: (coreutils)rmdir invocation. Remove empty directories. * runcon: (coreutils)runcon invocation. Run in specified SELinux CTX. * sdiff: (diffutils)Invoking sdiff. Merge 2 files side-by-side. * seq: (coreutils)seq invocation. Print numeric sequences * sha1sum: (coreutils)sha1sum invocation. Print or check SHA-1 digests. * sha2: (coreutils)sha2 utilities. Print or check SHA-2 digests. * shred: (coreutils)shred invocation. Remove files more securely. * shuf: (coreutils)shuf invocation. Shuffling text files. * sleep: (coreutils)sleep invocation. Delay for a specified time. * sort: (coreutils)sort invocation. Sort text files. * split: (coreutils)split invocation. Split into pieces. * stat: (coreutils)stat invocation. Report file(system) status. * stdbuf: (coreutils)stdbuf invocation. Modify stdio buffering. * stty: (coreutils)stty invocation. Print/change terminal settings. * sum: (coreutils)sum invocation. Print traditional checksum. * sync: (coreutils)sync invocation. Synchronize memory to disk. * tac: (coreutils)tac invocation. Reverse files. * tail: (coreutils)tail invocation. Output the last part of files. * tangle: (web2c)tangle invocation. WEB to Pascal. * tee: (coreutils)tee invocation. Redirect to multiple files. * test: (coreutils)test invocation. File/string tests. * tex: (web2c)tex invocation. Typesetting. * tftopl: (web2c)tftopl invocation. TFM -> property list. * time: (time). Run programs and summarize system resource usage. * timeout: (coreutils)timeout invocation. Run with time limit. * touch: (coreutils)touch invocation. Change file timestamps. * tr: (coreutils)tr invocation. Translate characters. * true: (coreutils)true invocation. Do nothing, successfully. * truncate: (coreutils)truncate invocation. Shrink/extend size of a file. * tsort: (coreutils)tsort invocation. Topological sort. * tty: (coreutils)tty invocation. Print terminal name. * uname: (coreutils)uname invocation. Print system information. * unexpand: (coreutils)unexpand invocation. Convert spaces to tabs. * uniq: (coreutils)uniq invocation. Uniquify files. * unlink: (coreutils)unlink invocation. Removal via unlink(2). * updatedb: (find)Invoking updatedb. Building the locate database. * uptime: (coreutils)uptime invocation. Print uptime and load. * users: (coreutils)users invocation. Print current user names. * vdir: (coreutils)vdir invocation. List directories verbosely. * vftovp: (web2c)vftovp invocation. Virtual font -> virtual pl. * vptovf: (web2c)vptovf invocation. Virtual pl -> virtual font. * wc: (coreutils)wc invocation. Line, word, and byte counts. * weave: (web2c)weave invocation. WEB to TeX. * who: (coreutils)who invocation. Print who is logged in. * whoami: (coreutils)whoami invocation. Print effective user ID. * xargs: (find)Invoking xargs. Operating on many files. * yes: (coreutils)yes invocation. Print a string indefinitely. * zcat: (gzip)Overview. Decompression to stdout. * zdiff: (gzip)Overview. Compare compressed files. * zforce: (gzip)Overview. Force .gz extension on files. * zgrep: (gzip)Overview. Search compressed files. * zmore: (gzip)Overview. Decompression output by pages. Kernel * GRUB: (grub). The GRand Unified Bootloader * grub-dev: (grub-dev). The GRand Unified Bootloader Dev * grub-install: (grub)Invoking grub-install. Install GRUB on your drive * grub-mkconfig: (grub)Invoking grub-mkconfig. Generate GRUB configuration * grub-mkpasswd-pbkdf2: (grub)Invoking grub-mkpasswd-pbkdf2. * grub-mkrelpath: (grub)Invoking grub-mkrelpath. * grub-mkrescue: (grub)Invoking grub-mkrescue. Make a GRUB rescue image * grub-mount: (grub)Invoking grub-mount. Mount a file system using GRUB * grub-probe: (grub)Invoking grub-probe. Probe device information * grub-script-check: (grub)Invoking grub-script-check. Libraries * RLuserman: (rluserman). The GNU readline library User's Manual. Man-pages * Latex2man: (latex2man). Its Man-Page Math * bc: (bc). An arbitrary precision calculator language. * dc: (dc). Arbitrary precision RPN "Desktop Calculator". Network applications * Wget: (wget). Non-interactive network downloader. Programming * flex: (flex). Fast lexical analyzer generator (lex replacement). * gnucash: (gnucash-design). Design of the GnuCash program Programming Tools * Gperf: (gperf). Perfect Hash Function Generator. Software development * Autoconf Archive: (autoconf-archive). A collection of re-usable Autoconf macros. * Automake: (automake-1.15). Making GNU standards-compliant Makefiles. Sound * SSIP: (ssip). Speech Synthesis Interface Protocol. * Say for Speech Dispatcher: (spd-say). Say. * Speech Dispatcher: (speech-dispatcher). Speech Dispatcher. TeX * DVI-to-PNG: (dvipng). Translating TeX DVI files to Portable Network Graphics (PNG). * DVI-to-Postscript: (dvips). Translating TeX DVI files to PostScript. * Eplain: (eplain). Expanding on plain Tex. * EpsPDF: (epspdf). Portable GUI- and command-line EPS/PS/PDF conversion * Kpathsea: (kpathsea). File lookup along search paths. * LaTeX2e: (latex2e). Unofficial LaTeX reference manual. * LaTeX2e-es: (latex2e-es). Manual de extraoficial de LaTeX. * Naming TeX fonts: (fontname). Filenames for TeX fonts. * TL-build: (tlbuild). TeX Live configuration and development. * TeX Directories: (tds). A directory structure for TeX files. * TeXdraw: (texdraw). A system for producing PostScript drawings from TeX. * Web2c: (web2c). TeX, Metafont, and companion programs. * afm2tfm: (dvips)Invoking afm2tfm. Making Type 1 fonts available to TeX. * dvipng: (dvipng). A DVI-to-PNG translator. * dvips: (dvips)Invoking Dvips. DVI-to-PostScript translator. * kpsewhich: (kpathsea)Invoking kpsewhich. TeX file searching. * mf2pt1: (mf2pt1). PostScript Type 1 fonts from Metafont source. * mktexfmt: (kpathsea)mktex scripts. Format (fmt/base/mem) generation. * mktexlsr: (kpathsea)Filename database. Update ls-R. * mktexmf: (kpathsea)mktex scripts. MF source generation. * mktexpk: (kpathsea)mktex scripts. PK bitmap generation. * mktextex: (kpathsea)mktex scripts. TeX source generation. * mktextfm: (kpathsea)mktex scripts. TeX font metric generation. Text creation and manipulation * Diffutils: (diffutils). Comparing and merging files. * M4: (m4). A powerful macro processor. * grep: (grep). Print lines matching a pattern. * sed: (sed). Stream EDitor. command. Use * SSID MODE CHAN RATE SIGNAL BARS SECURITY to get current connections
6 years ago
8 years ago
8 years ago
6 years ago
6 years ago
  1. /*
  2. WIFI MODULE
  3. Copyright (C) 2016-2019 by Xose Pérez <xose dot perez at gmail dot com>
  4. */
  5. #include <JustWifi.h>
  6. #include <Ticker.h>
  7. bool _wifi_wps_running = false;
  8. bool _wifi_smartconfig_running = false;
  9. bool _wifi_smartconfig_initial = false;
  10. uint8_t _wifi_ap_mode = WIFI_AP_FALLBACK;
  11. #if WIFI_GRATUITOUS_ARP_SUPPORT
  12. unsigned long _wifi_gratuitous_arp_interval = 0;
  13. unsigned long _wifi_gratuitous_arp_last = 0;
  14. #endif
  15. // -----------------------------------------------------------------------------
  16. // PRIVATE
  17. // -----------------------------------------------------------------------------
  18. struct wifi_scan_info_t {
  19. String ssid_scan;
  20. int32_t rssi_scan;
  21. uint8_t sec_scan;
  22. uint8_t* BSSID_scan;
  23. int32_t chan_scan;
  24. bool hidden_scan;
  25. char buffer[128];
  26. };
  27. void _wifiUpdateSoftAP() {
  28. if (WiFi.softAPgetStationNum() == 0) {
  29. #if USE_PASSWORD
  30. jw.setSoftAP(getSetting("hostname").c_str(), getAdminPass().c_str());
  31. #else
  32. jw.setSoftAP(getSetting("hostname").c_str());
  33. #endif
  34. }
  35. }
  36. void _wifiCheckAP() {
  37. if (
  38. (WIFI_AP_FALLBACK == _wifi_ap_mode)
  39. && ((WiFi.getMode() & WIFI_AP) > 0)
  40. && jw.connected()
  41. && (WiFi.softAPgetStationNum() == 0)
  42. ) {
  43. jw.enableAP(false);
  44. }
  45. }
  46. void _wifiConfigure() {
  47. jw.setHostname(getSetting("hostname").c_str());
  48. _wifiUpdateSoftAP();
  49. jw.setConnectTimeout(WIFI_CONNECT_TIMEOUT);
  50. wifiReconnectCheck();
  51. jw.enableAPFallback(WIFI_FALLBACK_APMODE);
  52. jw.cleanNetworks();
  53. _wifi_ap_mode = getSetting("apmode", WIFI_AP_FALLBACK).toInt();
  54. // If system is flagged unstable we do not init wifi networks
  55. #if SYSTEM_CHECK_ENABLED
  56. if (!systemCheck()) return;
  57. #endif
  58. // Clean settings
  59. _wifiClean(WIFI_MAX_NETWORKS);
  60. int i;
  61. for (i = 0; i< WIFI_MAX_NETWORKS; i++) {
  62. if (!hasSetting("ssid", i)) break;
  63. if (!hasSetting("ip", i)) {
  64. jw.addNetwork(
  65. getSetting("ssid", i, "").c_str(),
  66. getSetting("pass", i, "").c_str()
  67. );
  68. } else {
  69. jw.addNetwork(
  70. getSetting("ssid", i, "").c_str(),
  71. getSetting("pass", i, "").c_str(),
  72. getSetting("ip", i, "").c_str(),
  73. getSetting("gw", i, "").c_str(),
  74. getSetting("mask", i, "").c_str(),
  75. getSetting("dns", i, "").c_str()
  76. );
  77. }
  78. }
  79. #if JUSTWIFI_ENABLE_SMARTCONFIG
  80. if (i == 0) _wifi_smartconfig_initial = true;
  81. #endif
  82. jw.enableScan(getSetting("wifiScan", WIFI_SCAN_NETWORKS).toInt() == 1);
  83. unsigned char sleep_mode = getSetting("wifiSleep", WIFI_SLEEP_MODE).toInt();
  84. sleep_mode = constrain(sleep_mode, 0, 2);
  85. WiFi.setSleepMode(static_cast<WiFiSleepType_t>(sleep_mode));
  86. #if WIFI_GRATUITOUS_ARP_SUPPORT
  87. _wifi_gratuitous_arp_last = millis();
  88. _wifi_gratuitous_arp_interval = getSetting("wifiGarpIntvl", secureRandom(
  89. WIFI_GRATUITOUS_ARP_INTERVAL_MIN, WIFI_GRATUITOUS_ARP_INTERVAL_MAX
  90. )).toInt();
  91. #endif
  92. const auto tx_power = getSetting("wifiTxPwr", WIFI_OUTPUT_POWER_DBM).toFloat();
  93. WiFi.setOutputPower(tx_power);
  94. }
  95. void _wifiScan(wifi_scan_f callback = nullptr) {
  96. DEBUG_MSG_P(PSTR("[WIFI] Start scanning\n"));
  97. unsigned char result = WiFi.scanNetworks();
  98. if (result == WIFI_SCAN_FAILED) {
  99. DEBUG_MSG_P(PSTR("[WIFI] Scan failed\n"));
  100. return;
  101. } else if (result == 0) {
  102. DEBUG_MSG_P(PSTR("[WIFI] No networks found\n"));
  103. return;
  104. }
  105. DEBUG_MSG_P(PSTR("[WIFI] %d networks found:\n"), result);
  106. // Populate defined networks with scan data
  107. wifi_scan_info_t info;
  108. for (unsigned char i = 0; i < result; ++i) {
  109. WiFi.getNetworkInfo(i, info.ssid_scan, info.sec_scan, info.rssi_scan, info.BSSID_scan, info.chan_scan, info.hidden_scan);
  110. snprintf_P(info.buffer, sizeof(info.buffer),
  111. PSTR("BSSID: %02X:%02X:%02X:%02X:%02X:%02X SEC: %s RSSI: %3d CH: %2d SSID: %s"),
  112. info.BSSID_scan[0], info.BSSID_scan[1], info.BSSID_scan[2], info.BSSID_scan[3], info.BSSID_scan[4], info.BSSID_scan[5],
  113. (info.sec_scan != ENC_TYPE_NONE ? "YES" : "NO "),
  114. info.rssi_scan,
  115. info.chan_scan,
  116. info.ssid_scan.c_str()
  117. );
  118. if (callback) {
  119. callback(info);
  120. } else {
  121. DEBUG_MSG_P(PSTR("[WIFI] > %s\n"), info.buffer);
  122. }
  123. }
  124. WiFi.scanDelete();
  125. }
  126. bool _wifiClean(unsigned char num) {
  127. bool changed = false;
  128. int i = 0;
  129. // Clean defined settings
  130. while (i < num) {
  131. // Skip on first non-defined setting
  132. if (!hasSetting("ssid", i)) {
  133. delSetting("ssid", i);
  134. break;
  135. }
  136. // Delete empty values
  137. if (!hasSetting("pass", i)) delSetting("pass", i);
  138. if (!hasSetting("ip", i)) delSetting("ip", i);
  139. if (!hasSetting("gw", i)) delSetting("gw", i);
  140. if (!hasSetting("mask", i)) delSetting("mask", i);
  141. if (!hasSetting("dns", i)) delSetting("dns", i);
  142. ++i;
  143. }
  144. // Delete all other settings
  145. while (i < WIFI_MAX_NETWORKS) {
  146. changed = hasSetting("ssid", i);
  147. delSetting("ssid", i);
  148. delSetting("pass", i);
  149. delSetting("ip", i);
  150. delSetting("gw", i);
  151. delSetting("mask", i);
  152. delSetting("dns", i);
  153. ++i;
  154. }
  155. return changed;
  156. }
  157. // Inject hardcoded networks
  158. void _wifiInject() {
  159. if (strlen(WIFI1_SSID)) {
  160. if (!hasSetting("ssid", 0)) {
  161. setSetting("ssid", 0, F(WIFI1_SSID));
  162. setSetting("pass", 0, F(WIFI1_PASS));
  163. setSetting("ip", 0, F(WIFI1_IP));
  164. setSetting("gw", 0, F(WIFI1_GW));
  165. setSetting("mask", 0, F(WIFI1_MASK));
  166. setSetting("dns", 0, F(WIFI1_DNS));
  167. }
  168. if (strlen(WIFI2_SSID)) {
  169. if (!hasSetting("ssid", 1)) {
  170. setSetting("ssid", 1, F(WIFI2_SSID));
  171. setSetting("pass", 1, F(WIFI2_PASS));
  172. setSetting("ip", 1, F(WIFI2_IP));
  173. setSetting("gw", 1, F(WIFI2_GW));
  174. setSetting("mask", 1, F(WIFI2_MASK));
  175. setSetting("dns", 1, F(WIFI2_DNS));
  176. }
  177. if (strlen(WIFI3_SSID)) {
  178. if (!hasSetting("ssid", 2)) {
  179. setSetting("ssid", 2, F(WIFI3_SSID));
  180. setSetting("pass", 2, F(WIFI3_PASS));
  181. setSetting("ip", 2, F(WIFI3_IP));
  182. setSetting("gw", 2, F(WIFI3_GW));
  183. setSetting("mask", 2, F(WIFI3_MASK));
  184. setSetting("dns", 2, F(WIFI3_DNS));
  185. }
  186. if (strlen(WIFI4_SSID)) {
  187. if (!hasSetting("ssid", 3)) {
  188. setSetting("ssid", 3, F(WIFI4_SSID));
  189. setSetting("pass", 3, F(WIFI4_PASS));
  190. setSetting("ip", 3, F(WIFI4_IP));
  191. setSetting("gw", 3, F(WIFI4_GW));
  192. setSetting("mask", 3, F(WIFI4_MASK));
  193. setSetting("dns", 3, F(WIFI4_DNS));
  194. }
  195. }
  196. }
  197. }
  198. }
  199. }
  200. void _wifiCallback(justwifi_messages_t code, char * parameter) {
  201. if (MESSAGE_WPS_START == code) {
  202. _wifi_wps_running = true;
  203. }
  204. if (MESSAGE_SMARTCONFIG_START == code) {
  205. _wifi_smartconfig_running = true;
  206. }
  207. if (MESSAGE_WPS_ERROR == code || MESSAGE_SMARTCONFIG_ERROR == code) {
  208. _wifi_wps_running = false;
  209. _wifi_smartconfig_running = false;
  210. }
  211. if (MESSAGE_WPS_SUCCESS == code || MESSAGE_SMARTCONFIG_SUCCESS == code) {
  212. String ssid = WiFi.SSID();
  213. String pass = WiFi.psk();
  214. // Look for the same SSID
  215. uint8_t count = 0;
  216. while (count < WIFI_MAX_NETWORKS) {
  217. if (!hasSetting("ssid", count)) break;
  218. if (ssid.equals(getSetting("ssid", count, ""))) break;
  219. count++;
  220. }
  221. // If we have reached the max we overwrite the first one
  222. if (WIFI_MAX_NETWORKS == count) count = 0;
  223. setSetting("ssid", count, ssid);
  224. setSetting("pass", count, pass);
  225. _wifi_wps_running = false;
  226. _wifi_smartconfig_running = false;
  227. }
  228. }
  229. #if WIFI_AP_CAPTIVE
  230. #include "DNSServer.h"
  231. DNSServer _wifi_dnsServer;
  232. void _wifiCaptivePortal(justwifi_messages_t code, char * parameter) {
  233. if (MESSAGE_ACCESSPOINT_CREATED == code) {
  234. _wifi_dnsServer.setErrorReplyCode(DNSReplyCode::NoError);
  235. _wifi_dnsServer.start(53, "*", WiFi.softAPIP());
  236. DEBUG_MSG_P(PSTR("[WIFI] Captive portal enabled\n"));
  237. }
  238. if (MESSAGE_CONNECTED == code) {
  239. _wifi_dnsServer.stop();
  240. DEBUG_MSG_P(PSTR("[WIFI] Captive portal disabled\n"));
  241. }
  242. }
  243. #endif // WIFI_AP_CAPTIVE
  244. #if DEBUG_SUPPORT
  245. void _wifiDebugCallback(justwifi_messages_t code, char * parameter) {
  246. // -------------------------------------------------------------------------
  247. if (code == MESSAGE_SCANNING) {
  248. DEBUG_MSG_P(PSTR("[WIFI] Scanning\n"));
  249. }
  250. if (code == MESSAGE_SCAN_FAILED) {
  251. DEBUG_MSG_P(PSTR("[WIFI] Scan failed\n"));
  252. }
  253. if (code == MESSAGE_NO_NETWORKS) {
  254. DEBUG_MSG_P(PSTR("[WIFI] No networks found\n"));
  255. }
  256. if (code == MESSAGE_NO_KNOWN_NETWORKS) {
  257. DEBUG_MSG_P(PSTR("[WIFI] No known networks found\n"));
  258. }
  259. if (code == MESSAGE_FOUND_NETWORK) {
  260. DEBUG_MSG_P(PSTR("[WIFI] %s\n"), parameter);
  261. }
  262. // -------------------------------------------------------------------------
  263. if (code == MESSAGE_CONNECTING) {
  264. DEBUG_MSG_P(PSTR("[WIFI] Connecting to %s\n"), parameter);
  265. }
  266. if (code == MESSAGE_CONNECT_WAITING) {
  267. // too much noise
  268. }
  269. if (code == MESSAGE_CONNECT_FAILED) {
  270. DEBUG_MSG_P(PSTR("[WIFI] Could not connect to %s\n"), parameter);
  271. }
  272. if (code == MESSAGE_CONNECTED) {
  273. wifiDebug(WIFI_STA);
  274. }
  275. if (code == MESSAGE_DISCONNECTED) {
  276. DEBUG_MSG_P(PSTR("[WIFI] Disconnected\n"));
  277. }
  278. // -------------------------------------------------------------------------
  279. if (code == MESSAGE_ACCESSPOINT_CREATING) {
  280. DEBUG_MSG_P(PSTR("[WIFI] Creating access point\n"));
  281. }
  282. if (code == MESSAGE_ACCESSPOINT_CREATED) {
  283. wifiDebug(WIFI_AP);
  284. }
  285. if (code == MESSAGE_ACCESSPOINT_FAILED) {
  286. DEBUG_MSG_P(PSTR("[WIFI] Could not create access point\n"));
  287. }
  288. if (code == MESSAGE_ACCESSPOINT_DESTROYED) {
  289. _wifiUpdateSoftAP();
  290. DEBUG_MSG_P(PSTR("[WIFI] Access point destroyed\n"));
  291. }
  292. // -------------------------------------------------------------------------
  293. if (code == MESSAGE_WPS_START) {
  294. DEBUG_MSG_P(PSTR("[WIFI] WPS started\n"));
  295. }
  296. if (code == MESSAGE_WPS_SUCCESS) {
  297. DEBUG_MSG_P(PSTR("[WIFI] WPS succeded!\n"));
  298. }
  299. if (code == MESSAGE_WPS_ERROR) {
  300. DEBUG_MSG_P(PSTR("[WIFI] WPS failed\n"));
  301. }
  302. // ------------------------------------------------------------------------
  303. if (code == MESSAGE_SMARTCONFIG_START) {
  304. DEBUG_MSG_P(PSTR("[WIFI] Smart Config started\n"));
  305. }
  306. if (code == MESSAGE_SMARTCONFIG_SUCCESS) {
  307. DEBUG_MSG_P(PSTR("[WIFI] Smart Config succeded!\n"));
  308. }
  309. if (code == MESSAGE_SMARTCONFIG_ERROR) {
  310. DEBUG_MSG_P(PSTR("[WIFI] Smart Config failed\n"));
  311. }
  312. }
  313. #endif // DEBUG_SUPPORT
  314. // -----------------------------------------------------------------------------
  315. // SETTINGS
  316. // -----------------------------------------------------------------------------
  317. #if TERMINAL_SUPPORT
  318. void _wifiInitCommands() {
  319. terminalRegisterCommand(F("WIFI"), [](Embedis* e) {
  320. wifiDebug();
  321. terminalOK();
  322. });
  323. terminalRegisterCommand(F("WIFI.RESET"), [](Embedis* e) {
  324. _wifiConfigure();
  325. wifiDisconnect();
  326. terminalOK();
  327. });
  328. terminalRegisterCommand(F("WIFI.STA"), [](Embedis* e) {
  329. wifiStartSTA();
  330. terminalOK();
  331. });
  332. terminalRegisterCommand(F("WIFI.AP"), [](Embedis* e) {
  333. wifiStartAP();
  334. terminalOK();
  335. });
  336. #if defined(JUSTWIFI_ENABLE_WPS)
  337. terminalRegisterCommand(F("WIFI.WPS"), [](Embedis* e) {
  338. wifiStartWPS();
  339. terminalOK();
  340. });
  341. #endif // defined(JUSTWIFI_ENABLE_WPS)
  342. #if defined(JUSTWIFI_ENABLE_SMARTCONFIG)
  343. terminalRegisterCommand(F("WIFI.SMARTCONFIG"), [](Embedis* e) {
  344. wifiStartSmartConfig();
  345. terminalOK();
  346. });
  347. #endif // defined(JUSTWIFI_ENABLE_SMARTCONFIG)
  348. terminalRegisterCommand(F("WIFI.SCAN"), [](Embedis* e) {
  349. _wifiScan();
  350. terminalOK();
  351. });
  352. }
  353. #endif
  354. // -----------------------------------------------------------------------------
  355. // WEB
  356. // -----------------------------------------------------------------------------
  357. #if WEB_SUPPORT
  358. bool _wifiWebSocketOnKeyCheck(const char * key, JsonVariant& value) {
  359. if (strncmp(key, "wifi", 4) == 0) return true;
  360. if (strncmp(key, "ssid", 4) == 0) return true;
  361. if (strncmp(key, "pass", 4) == 0) return true;
  362. if (strncmp(key, "ip", 2) == 0) return true;
  363. if (strncmp(key, "gw", 2) == 0) return true;
  364. if (strncmp(key, "mask", 4) == 0) return true;
  365. if (strncmp(key, "dns", 3) == 0) return true;
  366. return false;
  367. }
  368. void _wifiWebSocketOnConnected(JsonObject& root) {
  369. root["maxNetworks"] = WIFI_MAX_NETWORKS;
  370. root["wifiScan"] = getSetting("wifiScan", WIFI_SCAN_NETWORKS).toInt() == 1;
  371. JsonArray& wifi = root.createNestedArray("wifi");
  372. for (byte i=0; i<WIFI_MAX_NETWORKS; i++) {
  373. if (!hasSetting("ssid", i)) break;
  374. JsonObject& network = wifi.createNestedObject();
  375. network["ssid"] = getSetting("ssid", i, "");
  376. network["pass"] = getSetting("pass", i, "");
  377. network["ip"] = getSetting("ip", i, "");
  378. network["gw"] = getSetting("gw", i, "");
  379. network["mask"] = getSetting("mask", i, "");
  380. network["dns"] = getSetting("dns", i, "");
  381. }
  382. }
  383. void _wifiWebSocketScan(JsonObject& root) {
  384. JsonArray& scanResult = root.createNestedArray("scanResult");
  385. _wifiScan([&scanResult](wifi_scan_info_t& info) {
  386. scanResult.add(info.buffer);
  387. });
  388. }
  389. void _wifiWebSocketOnAction(uint32_t client_id, const char * action, JsonObject& data) {
  390. if (strcmp(action, "scan") == 0) wsPost(client_id, _wifiWebSocketScan);
  391. }
  392. #endif
  393. // -----------------------------------------------------------------------------
  394. // SUPPORT
  395. // -----------------------------------------------------------------------------
  396. #if WIFI_GRATUITOUS_ARP_SUPPORT
  397. // ref: lwip src/core/netif.c netif_issue_reports(...)
  398. // ref: esp-lwip/core/ipv4/etharp.c garp_tmr()
  399. // TODO: only for ipv4, need (?) a different method with ipv6
  400. bool _wifiSendGratuitousArp() {
  401. bool result = false;
  402. for (netif* interface = netif_list; interface != nullptr; interface = interface->next) {
  403. if (
  404. (interface->flags & NETIF_FLAG_ETHARP)
  405. && (interface->hwaddr_len == ETHARP_HWADDR_LEN)
  406. #if LWIP_VERSION_MAJOR == 1
  407. && (!ip_addr_isany(&interface->ip_addr))
  408. #else
  409. && (!ip4_addr_isany_val(*netif_ip4_addr(interface)))
  410. #endif
  411. && (interface->flags & NETIF_FLAG_LINK_UP)
  412. && (interface->flags & NETIF_FLAG_UP)
  413. ) {
  414. etharp_gratuitous(interface);
  415. result = true;
  416. }
  417. }
  418. return result;
  419. }
  420. void _wifiSendGratuitousArp(unsigned long interval) {
  421. if (millis() - _wifi_gratuitous_arp_last > interval) {
  422. _wifi_gratuitous_arp_last = millis();
  423. _wifiSendGratuitousArp();
  424. }
  425. }
  426. #endif // WIFI_GRATUITOUS_ARP_SUPPORT
  427. // -----------------------------------------------------------------------------
  428. // INFO
  429. // -----------------------------------------------------------------------------
  430. // backported WiFiAPClass methods
  431. String _wifiSoftAPSSID() {
  432. struct softap_config config;
  433. wifi_softap_get_config(&config);
  434. char* name = reinterpret_cast<char*>(config.ssid);
  435. char ssid[sizeof(config.ssid) + 1];
  436. memcpy(ssid, name, sizeof(config.ssid));
  437. ssid[sizeof(config.ssid)] = '\0';
  438. return String(ssid);
  439. }
  440. String _wifiSoftAPPSK() {
  441. struct softap_config config;
  442. wifi_softap_get_config(&config);
  443. char* pass = reinterpret_cast<char*>(config.password);
  444. char psk[sizeof(config.password) + 1];
  445. memcpy(psk, pass, sizeof(config.password));
  446. psk[sizeof(config.password)] = '\0';
  447. return String(psk);
  448. }
  449. void wifiDebug(WiFiMode_t modes) {
  450. #if DEBUG_SUPPORT
  451. bool footer = false;
  452. if (((modes & WIFI_STA) > 0) && ((WiFi.getMode() & WIFI_STA) > 0)) {
  453. DEBUG_MSG_P(PSTR("[WIFI] ------------------------------------- MODE STA\n"));
  454. DEBUG_MSG_P(PSTR("[WIFI] SSID %s\n"), WiFi.SSID().c_str());
  455. DEBUG_MSG_P(PSTR("[WIFI] IP %s\n"), WiFi.localIP().toString().c_str());
  456. DEBUG_MSG_P(PSTR("[WIFI] MAC %s\n"), WiFi.macAddress().c_str());
  457. DEBUG_MSG_P(PSTR("[WIFI] GW %s\n"), WiFi.gatewayIP().toString().c_str());
  458. DEBUG_MSG_P(PSTR("[WIFI] DNS %s\n"), WiFi.dnsIP().toString().c_str());
  459. DEBUG_MSG_P(PSTR("[WIFI] MASK %s\n"), WiFi.subnetMask().toString().c_str());
  460. DEBUG_MSG_P(PSTR("[WIFI] HOST http://%s.local\n"), WiFi.hostname().c_str());
  461. DEBUG_MSG_P(PSTR("[WIFI] BSSID %s\n"), WiFi.BSSIDstr().c_str());
  462. DEBUG_MSG_P(PSTR("[WIFI] CH %d\n"), WiFi.channel());
  463. DEBUG_MSG_P(PSTR("[WIFI] RSSI %d\n"), WiFi.RSSI());
  464. footer = true;
  465. }
  466. if (((modes & WIFI_AP) > 0) && ((WiFi.getMode() & WIFI_AP) > 0)) {
  467. DEBUG_MSG_P(PSTR("[WIFI] -------------------------------------- MODE AP\n"));
  468. DEBUG_MSG_P(PSTR("[WIFI] SSID %s\n"), _wifiSoftAPSSID().c_str());
  469. DEBUG_MSG_P(PSTR("[WIFI] PASS %s\n"), _wifiSoftAPPSK().c_str());
  470. DEBUG_MSG_P(PSTR("[WIFI] IP %s\n"), WiFi.softAPIP().toString().c_str());
  471. DEBUG_MSG_P(PSTR("[WIFI] MAC %s\n"), WiFi.softAPmacAddress().c_str());
  472. footer = true;
  473. }
  474. if (WiFi.getMode() == 0) {
  475. DEBUG_MSG_P(PSTR("[WIFI] ------------------------------------- MODE OFF\n"));
  476. DEBUG_MSG_P(PSTR("[WIFI] No connection\n"));
  477. footer = true;
  478. }
  479. if (footer) {
  480. DEBUG_MSG_P(PSTR("[WIFI] ----------------------------------------------\n"));
  481. }
  482. #endif //DEBUG_SUPPORT
  483. }
  484. void wifiDebug() {
  485. wifiDebug(WIFI_AP_STA);
  486. }
  487. // -----------------------------------------------------------------------------
  488. // API
  489. // -----------------------------------------------------------------------------
  490. String getIP() {
  491. if (WiFi.getMode() == WIFI_AP) {
  492. return WiFi.softAPIP().toString();
  493. }
  494. return WiFi.localIP().toString();
  495. }
  496. String getNetwork() {
  497. if (WiFi.getMode() == WIFI_AP) {
  498. return jw.getAPSSID();
  499. }
  500. return WiFi.SSID();
  501. }
  502. bool wifiConnected() {
  503. return jw.connected();
  504. }
  505. void wifiDisconnect() {
  506. jw.disconnect();
  507. }
  508. void wifiStartSTA() {
  509. jw.disconnect();
  510. jw.enableSTA(true);
  511. jw.enableAP(false);
  512. }
  513. void wifiStartAP(bool only) {
  514. if (only) {
  515. jw.enableSTA(false);
  516. jw.disconnect();
  517. jw.resetReconnectTimeout();
  518. }
  519. jw.enableAP(true);
  520. }
  521. void wifiStartAP() {
  522. wifiStartAP(true);
  523. }
  524. #if defined(JUSTWIFI_ENABLE_WPS)
  525. void wifiStartWPS() {
  526. jw.enableAP(false);
  527. jw.disconnect();
  528. jw.startWPS();
  529. }
  530. #endif // defined(JUSTWIFI_ENABLE_WPS)
  531. #if defined(JUSTWIFI_ENABLE_SMARTCONFIG)
  532. void wifiStartSmartConfig() {
  533. jw.enableAP(false);
  534. jw.disconnect();
  535. jw.startSmartConfig();
  536. }
  537. #endif // defined(JUSTWIFI_ENABLE_SMARTCONFIG)
  538. void wifiReconnectCheck() {
  539. bool connected = false;
  540. #if WEB_SUPPORT
  541. if (wsConnected()) connected = true;
  542. #endif
  543. #if TELNET_SUPPORT
  544. if (telnetConnected()) connected = true;
  545. #endif
  546. jw.enableSTA(true);
  547. jw.setReconnectTimeout(connected ? 0 : WIFI_RECONNECT_INTERVAL);
  548. }
  549. uint8_t wifiState() {
  550. uint8_t state = 0;
  551. if (jw.connected()) state += WIFI_STATE_STA;
  552. if (jw.connectable()) state += WIFI_STATE_AP;
  553. if (_wifi_wps_running) state += WIFI_STATE_WPS;
  554. if (_wifi_smartconfig_running) state += WIFI_STATE_SMARTCONFIG;
  555. return state;
  556. }
  557. void wifiRegister(wifi_callback_f callback) {
  558. jw.subscribe(callback);
  559. }
  560. // -----------------------------------------------------------------------------
  561. // INITIALIZATION
  562. // -----------------------------------------------------------------------------
  563. void wifiSetup() {
  564. _wifiInject();
  565. _wifiConfigure();
  566. #if JUSTWIFI_ENABLE_SMARTCONFIG
  567. if (_wifi_smartconfig_initial) jw.startSmartConfig();
  568. #endif
  569. // Message callbacks
  570. wifiRegister(_wifiCallback);
  571. #if WIFI_AP_CAPTIVE
  572. wifiRegister(_wifiCaptivePortal);
  573. #endif
  574. #if DEBUG_SUPPORT
  575. wifiRegister(_wifiDebugCallback);
  576. #endif
  577. #if WEB_SUPPORT
  578. wsRegister()
  579. .onAction(_wifiWebSocketOnAction)
  580. .onConnected(_wifiWebSocketOnConnected)
  581. .onKeyCheck(_wifiWebSocketOnKeyCheck);
  582. #endif
  583. #if TERMINAL_SUPPORT
  584. _wifiInitCommands();
  585. #endif
  586. // Main callbacks
  587. espurnaRegisterLoop(wifiLoop);
  588. espurnaRegisterReload(_wifiConfigure);
  589. }
  590. void wifiLoop() {
  591. // Main wifi loop
  592. jw.loop();
  593. // Process captrive portal DNS queries if in AP mode only
  594. #if WIFI_AP_CAPTIVE
  595. if ((WiFi.getMode() & WIFI_AP) == WIFI_AP) {
  596. _wifi_dnsServer.processNextRequest();
  597. }
  598. #endif
  599. // Only send out gra arp when in STA mode
  600. #if WIFI_GRATUITOUS_ARP_SUPPORT
  601. if (_wifi_gratuitous_arp_interval) {
  602. _wifiSendGratuitousArp(_wifi_gratuitous_arp_interval);
  603. }
  604. #endif
  605. // Check if we should disable AP
  606. static unsigned long last = 0;
  607. if (millis() - last > 60000) {
  608. last = millis();
  609. _wifiCheckAP();
  610. }
  611. }