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.

760 lines
21 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
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
7 years ago
7 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. #include "ws.h"
  8. #include "wifi.h"
  9. #include "wifi_config.h"
  10. bool _wifi_wps_running = false;
  11. bool _wifi_smartconfig_running = false;
  12. bool _wifi_smartconfig_initial = false;
  13. int _wifi_ap_mode = WIFI_AP_FALLBACK;
  14. #if WIFI_GRATUITOUS_ARP_SUPPORT
  15. unsigned long _wifi_gratuitous_arp_interval = 0;
  16. unsigned long _wifi_gratuitous_arp_last = 0;
  17. #endif
  18. // -----------------------------------------------------------------------------
  19. // PRIVATE
  20. // -----------------------------------------------------------------------------
  21. struct wifi_scan_info_t {
  22. String ssid_scan;
  23. int32_t rssi_scan;
  24. uint8_t sec_scan;
  25. uint8_t* BSSID_scan;
  26. int32_t chan_scan;
  27. bool hidden_scan;
  28. char buffer[128];
  29. };
  30. void _wifiUpdateSoftAP() {
  31. if (WiFi.softAPgetStationNum() == 0) {
  32. #if USE_PASSWORD
  33. jw.setSoftAP(getSetting("hostname").c_str(), getAdminPass().c_str());
  34. #else
  35. jw.setSoftAP(getSetting("hostname").c_str());
  36. #endif
  37. }
  38. }
  39. void _wifiCheckAP() {
  40. if (
  41. (WIFI_AP_FALLBACK == _wifi_ap_mode)
  42. && ((WiFi.getMode() & WIFI_AP) > 0)
  43. && jw.connected()
  44. && (WiFi.softAPgetStationNum() == 0)
  45. ) {
  46. jw.enableAP(false);
  47. }
  48. }
  49. WiFiSleepType_t _wifiSleepModeConvert(const String& value) {
  50. switch (value.toInt()) {
  51. case 2:
  52. return WIFI_MODEM_SLEEP;
  53. case 1:
  54. return WIFI_LIGHT_SLEEP;
  55. case 0:
  56. default:
  57. return WIFI_NONE_SLEEP;
  58. }
  59. }
  60. void _wifiConfigure() {
  61. jw.setHostname(getSetting("hostname").c_str());
  62. _wifiUpdateSoftAP();
  63. jw.setConnectTimeout(WIFI_CONNECT_TIMEOUT);
  64. wifiReconnectCheck();
  65. jw.enableAPFallback(WIFI_FALLBACK_APMODE);
  66. jw.cleanNetworks();
  67. _wifi_ap_mode = getSetting("apmode", WIFI_AP_FALLBACK);
  68. // If system is flagged unstable we do not init wifi networks
  69. #if SYSTEM_CHECK_ENABLED
  70. if (!systemCheck()) return;
  71. #endif
  72. // Clean settings
  73. _wifiClean(WIFI_MAX_NETWORKS);
  74. unsigned char i;
  75. for (i = 0; i < WIFI_MAX_NETWORKS; i++) {
  76. if (hasSetting({"ip", i}) || _wifiHasIP(i)) {
  77. jw.addNetwork(
  78. getSetting({"ssid", i}, _wifiSSID(i)).c_str(),
  79. getSetting({"pass", i}, _wifiPass(i)).c_str(),
  80. getSetting({"ip", i}, _wifiIP(i)).c_str(),
  81. getSetting({"gw", i}, _wifiGateway(i)).c_str(),
  82. getSetting({"mask", i}, _wifiNetmask(i)).c_str(),
  83. getSetting({"dns", i}, _wifiDNS(i)).c_str()
  84. );
  85. } else if (hasSetting({"ssid", i}) || _wifiHasSSID(i)) {
  86. jw.addNetwork(
  87. getSetting({"ssid", i}, _wifiSSID(i)).c_str(),
  88. getSetting({"pass", i}, _wifiPass(i)).c_str()
  89. );
  90. }
  91. }
  92. #if JUSTWIFI_ENABLE_SMARTCONFIG
  93. if (i == 0) _wifi_smartconfig_initial = true;
  94. #endif
  95. jw.enableScan(getSetting("wifiScan", 1 == WIFI_SCAN_NETWORKS));
  96. const auto sleep_mode = getSetting<WiFiSleepType_t, _wifiSleepModeConvert>("wifiSleep", WIFI_SLEEP_MODE);
  97. WiFi.setSleepMode(sleep_mode);
  98. #if WIFI_GRATUITOUS_ARP_SUPPORT
  99. _wifi_gratuitous_arp_last = millis();
  100. _wifi_gratuitous_arp_interval = getSetting("wifiGarpIntvl", secureRandom(
  101. WIFI_GRATUITOUS_ARP_INTERVAL_MIN, WIFI_GRATUITOUS_ARP_INTERVAL_MAX
  102. ));
  103. #endif
  104. const auto tx_power = getSetting("wifiTxPwr", WIFI_OUTPUT_POWER_DBM);
  105. WiFi.setOutputPower(tx_power);
  106. }
  107. void _wifiScan(wifi_scan_f callback = nullptr) {
  108. DEBUG_MSG_P(PSTR("[WIFI] Start scanning\n"));
  109. unsigned char result = WiFi.scanNetworks();
  110. if (result == WIFI_SCAN_FAILED) {
  111. DEBUG_MSG_P(PSTR("[WIFI] Scan failed\n"));
  112. return;
  113. } else if (result == 0) {
  114. DEBUG_MSG_P(PSTR("[WIFI] No networks found\n"));
  115. return;
  116. }
  117. DEBUG_MSG_P(PSTR("[WIFI] %d networks found:\n"), result);
  118. // Populate defined networks with scan data
  119. wifi_scan_info_t info;
  120. for (unsigned char i = 0; i < result; ++i) {
  121. WiFi.getNetworkInfo(i, info.ssid_scan, info.sec_scan, info.rssi_scan, info.BSSID_scan, info.chan_scan, info.hidden_scan);
  122. snprintf_P(info.buffer, sizeof(info.buffer),
  123. PSTR("BSSID: %02X:%02X:%02X:%02X:%02X:%02X SEC: %s RSSI: %3d CH: %2d SSID: %s"),
  124. info.BSSID_scan[0], info.BSSID_scan[1], info.BSSID_scan[2], info.BSSID_scan[3], info.BSSID_scan[4], info.BSSID_scan[5],
  125. (info.sec_scan != ENC_TYPE_NONE ? "YES" : "NO "),
  126. info.rssi_scan,
  127. info.chan_scan,
  128. info.ssid_scan.c_str()
  129. );
  130. if (callback) {
  131. callback(info);
  132. } else {
  133. DEBUG_MSG_P(PSTR("[WIFI] > %s\n"), info.buffer);
  134. }
  135. }
  136. WiFi.scanDelete();
  137. }
  138. bool _wifiClean(unsigned char num) {
  139. bool changed = false;
  140. unsigned char i = 0;
  141. // Clean defined settings
  142. while (i < num) {
  143. // Skip on first non-defined setting
  144. if (!getSetting({"ssid", i}).length()) {
  145. delSetting({"ssid", i});
  146. break;
  147. }
  148. // Delete empty values
  149. if (!getSetting({"pass", i}).length()) delSetting({"pass", i});
  150. if (!getSetting({"ip", i}).length()) delSetting({"ip", i});
  151. if (!getSetting({"gw", i}).length()) delSetting({"gw", i});
  152. if (!getSetting({"mask", i}).length()) delSetting({"mask", i});
  153. if (!getSetting({"dns", i}).length()) delSetting({"dns", i});
  154. ++i;
  155. }
  156. // Delete all other settings
  157. while (i < WIFI_MAX_NETWORKS) {
  158. changed = (getSetting({"ssid", i}).length() > 0);
  159. delSetting({"ssid", i});
  160. delSetting({"pass", i});
  161. delSetting({"ip", i});
  162. delSetting({"gw", i});
  163. delSetting({"mask", i});
  164. delSetting({"dns", i});
  165. ++i;
  166. }
  167. return changed;
  168. }
  169. void _wifiCallback(justwifi_messages_t code, char * parameter) {
  170. if (MESSAGE_WPS_START == code) {
  171. _wifi_wps_running = true;
  172. }
  173. if (MESSAGE_SMARTCONFIG_START == code) {
  174. _wifi_smartconfig_running = true;
  175. }
  176. if (MESSAGE_WPS_ERROR == code || MESSAGE_SMARTCONFIG_ERROR == code) {
  177. _wifi_wps_running = false;
  178. _wifi_smartconfig_running = false;
  179. }
  180. if (MESSAGE_WPS_SUCCESS == code || MESSAGE_SMARTCONFIG_SUCCESS == code) {
  181. String ssid = WiFi.SSID();
  182. String pass = WiFi.psk();
  183. // Look for the same SSID
  184. uint8_t count = 0;
  185. while (count < WIFI_MAX_NETWORKS) {
  186. if (!hasSetting({"ssid", count})) break;
  187. if (ssid.equals(getSetting({"ssid", count}))) break;
  188. count++;
  189. }
  190. // If we have reached the max we overwrite the first one
  191. if (WIFI_MAX_NETWORKS == count) count = 0;
  192. setSetting({"ssid", count}, ssid);
  193. setSetting({"pass", count}, pass);
  194. _wifi_wps_running = false;
  195. _wifi_smartconfig_running = false;
  196. }
  197. }
  198. #if WIFI_AP_CAPTIVE
  199. #include "DNSServer.h"
  200. DNSServer _wifi_dnsServer;
  201. void _wifiCaptivePortal(justwifi_messages_t code, char * parameter) {
  202. if (MESSAGE_ACCESSPOINT_CREATED == code) {
  203. _wifi_dnsServer.setErrorReplyCode(DNSReplyCode::NoError);
  204. _wifi_dnsServer.start(53, "*", WiFi.softAPIP());
  205. DEBUG_MSG_P(PSTR("[WIFI] Captive portal enabled\n"));
  206. }
  207. if (MESSAGE_CONNECTED == code) {
  208. _wifi_dnsServer.stop();
  209. DEBUG_MSG_P(PSTR("[WIFI] Captive portal disabled\n"));
  210. }
  211. }
  212. #endif // WIFI_AP_CAPTIVE
  213. #if DEBUG_SUPPORT
  214. void _wifiDebugCallback(justwifi_messages_t code, char * parameter) {
  215. // -------------------------------------------------------------------------
  216. if (code == MESSAGE_SCANNING) {
  217. DEBUG_MSG_P(PSTR("[WIFI] Scanning\n"));
  218. }
  219. if (code == MESSAGE_SCAN_FAILED) {
  220. DEBUG_MSG_P(PSTR("[WIFI] Scan failed\n"));
  221. }
  222. if (code == MESSAGE_NO_NETWORKS) {
  223. DEBUG_MSG_P(PSTR("[WIFI] No networks found\n"));
  224. }
  225. if (code == MESSAGE_NO_KNOWN_NETWORKS) {
  226. DEBUG_MSG_P(PSTR("[WIFI] No known networks found\n"));
  227. }
  228. if (code == MESSAGE_FOUND_NETWORK) {
  229. DEBUG_MSG_P(PSTR("[WIFI] %s\n"), parameter);
  230. }
  231. // -------------------------------------------------------------------------
  232. if (code == MESSAGE_CONNECTING) {
  233. DEBUG_MSG_P(PSTR("[WIFI] Connecting to %s\n"), parameter);
  234. }
  235. if (code == MESSAGE_CONNECT_WAITING) {
  236. // too much noise
  237. }
  238. if (code == MESSAGE_CONNECT_FAILED) {
  239. DEBUG_MSG_P(PSTR("[WIFI] Could not connect to %s\n"), parameter);
  240. }
  241. if (code == MESSAGE_CONNECTED) {
  242. wifiDebug(WIFI_STA);
  243. }
  244. if (code == MESSAGE_DISCONNECTED) {
  245. DEBUG_MSG_P(PSTR("[WIFI] Disconnected\n"));
  246. }
  247. // -------------------------------------------------------------------------
  248. if (code == MESSAGE_ACCESSPOINT_CREATING) {
  249. DEBUG_MSG_P(PSTR("[WIFI] Creating access point\n"));
  250. }
  251. if (code == MESSAGE_ACCESSPOINT_CREATED) {
  252. wifiDebug(WIFI_AP);
  253. }
  254. if (code == MESSAGE_ACCESSPOINT_FAILED) {
  255. DEBUG_MSG_P(PSTR("[WIFI] Could not create access point\n"));
  256. }
  257. if (code == MESSAGE_ACCESSPOINT_DESTROYED) {
  258. _wifiUpdateSoftAP();
  259. DEBUG_MSG_P(PSTR("[WIFI] Access point destroyed\n"));
  260. }
  261. // -------------------------------------------------------------------------
  262. if (code == MESSAGE_WPS_START) {
  263. DEBUG_MSG_P(PSTR("[WIFI] WPS started\n"));
  264. }
  265. if (code == MESSAGE_WPS_SUCCESS) {
  266. DEBUG_MSG_P(PSTR("[WIFI] WPS succeded!\n"));
  267. }
  268. if (code == MESSAGE_WPS_ERROR) {
  269. DEBUG_MSG_P(PSTR("[WIFI] WPS failed\n"));
  270. }
  271. // ------------------------------------------------------------------------
  272. if (code == MESSAGE_SMARTCONFIG_START) {
  273. DEBUG_MSG_P(PSTR("[WIFI] Smart Config started\n"));
  274. }
  275. if (code == MESSAGE_SMARTCONFIG_SUCCESS) {
  276. DEBUG_MSG_P(PSTR("[WIFI] Smart Config succeded!\n"));
  277. }
  278. if (code == MESSAGE_SMARTCONFIG_ERROR) {
  279. DEBUG_MSG_P(PSTR("[WIFI] Smart Config failed\n"));
  280. }
  281. }
  282. #endif // DEBUG_SUPPORT
  283. // -----------------------------------------------------------------------------
  284. // SETTINGS
  285. // -----------------------------------------------------------------------------
  286. #if TERMINAL_SUPPORT
  287. void _wifiInitCommands() {
  288. terminalRegisterCommand(F("WIFI"), [](Embedis* e) {
  289. wifiDebug();
  290. terminalOK();
  291. });
  292. terminalRegisterCommand(F("WIFI.RESET"), [](Embedis* e) {
  293. _wifiConfigure();
  294. wifiDisconnect();
  295. terminalOK();
  296. });
  297. terminalRegisterCommand(F("WIFI.STA"), [](Embedis* e) {
  298. wifiStartSTA();
  299. terminalOK();
  300. });
  301. terminalRegisterCommand(F("WIFI.AP"), [](Embedis* e) {
  302. wifiStartAP();
  303. terminalOK();
  304. });
  305. #if defined(JUSTWIFI_ENABLE_WPS)
  306. terminalRegisterCommand(F("WIFI.WPS"), [](Embedis* e) {
  307. wifiStartWPS();
  308. terminalOK();
  309. });
  310. #endif // defined(JUSTWIFI_ENABLE_WPS)
  311. #if defined(JUSTWIFI_ENABLE_SMARTCONFIG)
  312. terminalRegisterCommand(F("WIFI.SMARTCONFIG"), [](Embedis* e) {
  313. wifiStartSmartConfig();
  314. terminalOK();
  315. });
  316. #endif // defined(JUSTWIFI_ENABLE_SMARTCONFIG)
  317. terminalRegisterCommand(F("WIFI.SCAN"), [](Embedis* e) {
  318. _wifiScan();
  319. terminalOK();
  320. });
  321. }
  322. #endif
  323. // -----------------------------------------------------------------------------
  324. // WEB
  325. // -----------------------------------------------------------------------------
  326. #if WEB_SUPPORT
  327. bool _wifiWebSocketOnKeyCheck(const char * key, JsonVariant& value) {
  328. if (strncmp(key, "wifi", 4) == 0) return true;
  329. if (strncmp(key, "ssid", 4) == 0) return true;
  330. if (strncmp(key, "pass", 4) == 0) return true;
  331. if (strncmp(key, "ip", 2) == 0) return true;
  332. if (strncmp(key, "gw", 2) == 0) return true;
  333. if (strncmp(key, "mask", 4) == 0) return true;
  334. if (strncmp(key, "dns", 3) == 0) return true;
  335. return false;
  336. }
  337. void _wifiWebSocketOnConnected(JsonObject& root) {
  338. root["wifiScan"] = getSetting("wifiScan", 1 == WIFI_SCAN_NETWORKS);
  339. JsonObject& wifi = root.createNestedObject("wifi");
  340. root["max"] = WIFI_MAX_NETWORKS;
  341. const char* keys[] = {
  342. "ssid", "pass", "ip", "gw", "mask", "dns", "stored"
  343. };
  344. JsonArray& schema = wifi.createNestedArray("schema");
  345. schema.copyFrom(keys, 7);
  346. JsonArray& networks = wifi.createNestedArray("networks");
  347. for (unsigned char index = 0; index < WIFI_MAX_NETWORKS; ++index) {
  348. if (!getSetting({"ssid", index}, _wifiSSID(index)).length()) break;
  349. JsonArray& network = networks.createNestedArray();
  350. network.add(getSetting({"ssid", index}, _wifiSSID(index)));
  351. network.add(getSetting({"pass", index}, _wifiPass(index)));
  352. network.add(getSetting({"ip", index}, _wifiIP(index)));
  353. network.add(getSetting({"gw", index}, _wifiGateway(index)));
  354. network.add(getSetting({"mask", index}, _wifiNetmask(index)));
  355. network.add(getSetting({"dns", index}, _wifiDNS(index)));
  356. network.add(_wifiHasSSID(index));
  357. }
  358. }
  359. void _wifiWebSocketScan(JsonObject& root) {
  360. JsonArray& scanResult = root.createNestedArray("scanResult");
  361. _wifiScan([&scanResult](wifi_scan_info_t& info) {
  362. scanResult.add(info.buffer);
  363. });
  364. }
  365. void _wifiWebSocketOnAction(uint32_t client_id, const char * action, JsonObject& data) {
  366. if (strcmp(action, "scan") == 0) wsPost(client_id, _wifiWebSocketScan);
  367. }
  368. #endif
  369. // -----------------------------------------------------------------------------
  370. // SUPPORT
  371. // -----------------------------------------------------------------------------
  372. #if WIFI_GRATUITOUS_ARP_SUPPORT
  373. // ref: lwip src/core/netif.c netif_issue_reports(...)
  374. // ref: esp-lwip/core/ipv4/etharp.c garp_tmr()
  375. // TODO: only for ipv4, need (?) a different method with ipv6
  376. bool _wifiSendGratuitousArp() {
  377. bool result = false;
  378. for (netif* interface = netif_list; interface != nullptr; interface = interface->next) {
  379. if (
  380. (interface->flags & NETIF_FLAG_ETHARP)
  381. && (interface->hwaddr_len == ETHARP_HWADDR_LEN)
  382. #if LWIP_VERSION_MAJOR == 1
  383. && (!ip_addr_isany(&interface->ip_addr))
  384. #else
  385. && (!ip4_addr_isany_val(*netif_ip4_addr(interface)))
  386. #endif
  387. && (interface->flags & NETIF_FLAG_LINK_UP)
  388. && (interface->flags & NETIF_FLAG_UP)
  389. ) {
  390. etharp_gratuitous(interface);
  391. result = true;
  392. }
  393. }
  394. return result;
  395. }
  396. void _wifiSendGratuitousArp(unsigned long interval) {
  397. if (millis() - _wifi_gratuitous_arp_last > interval) {
  398. _wifi_gratuitous_arp_last = millis();
  399. _wifiSendGratuitousArp();
  400. }
  401. }
  402. #endif // WIFI_GRATUITOUS_ARP_SUPPORT
  403. // -----------------------------------------------------------------------------
  404. // INFO
  405. // -----------------------------------------------------------------------------
  406. // backported WiFiAPClass methods
  407. String _wifiSoftAPSSID() {
  408. struct softap_config config;
  409. wifi_softap_get_config(&config);
  410. char* name = reinterpret_cast<char*>(config.ssid);
  411. char ssid[sizeof(config.ssid) + 1];
  412. memcpy(ssid, name, sizeof(config.ssid));
  413. ssid[sizeof(config.ssid)] = '\0';
  414. return String(ssid);
  415. }
  416. String _wifiSoftAPPSK() {
  417. struct softap_config config;
  418. wifi_softap_get_config(&config);
  419. char* pass = reinterpret_cast<char*>(config.password);
  420. char psk[sizeof(config.password) + 1];
  421. memcpy(psk, pass, sizeof(config.password));
  422. psk[sizeof(config.password)] = '\0';
  423. return String(psk);
  424. }
  425. void wifiDebug(WiFiMode_t modes) {
  426. #if DEBUG_SUPPORT
  427. bool footer = false;
  428. if (((modes & WIFI_STA) > 0) && ((WiFi.getMode() & WIFI_STA) > 0)) {
  429. DEBUG_MSG_P(PSTR("[WIFI] ------------------------------------- MODE STA\n"));
  430. DEBUG_MSG_P(PSTR("[WIFI] SSID %s\n"), WiFi.SSID().c_str());
  431. DEBUG_MSG_P(PSTR("[WIFI] IP %s\n"), WiFi.localIP().toString().c_str());
  432. DEBUG_MSG_P(PSTR("[WIFI] MAC %s\n"), WiFi.macAddress().c_str());
  433. DEBUG_MSG_P(PSTR("[WIFI] GW %s\n"), WiFi.gatewayIP().toString().c_str());
  434. DEBUG_MSG_P(PSTR("[WIFI] DNS %s\n"), WiFi.dnsIP().toString().c_str());
  435. DEBUG_MSG_P(PSTR("[WIFI] MASK %s\n"), WiFi.subnetMask().toString().c_str());
  436. DEBUG_MSG_P(PSTR("[WIFI] HOST http://%s.local\n"), WiFi.hostname().c_str());
  437. DEBUG_MSG_P(PSTR("[WIFI] BSSID %s\n"), WiFi.BSSIDstr().c_str());
  438. DEBUG_MSG_P(PSTR("[WIFI] CH %d\n"), WiFi.channel());
  439. DEBUG_MSG_P(PSTR("[WIFI] RSSI %d\n"), WiFi.RSSI());
  440. footer = true;
  441. }
  442. if (((modes & WIFI_AP) > 0) && ((WiFi.getMode() & WIFI_AP) > 0)) {
  443. DEBUG_MSG_P(PSTR("[WIFI] -------------------------------------- MODE AP\n"));
  444. DEBUG_MSG_P(PSTR("[WIFI] SSID %s\n"), _wifiSoftAPSSID().c_str());
  445. DEBUG_MSG_P(PSTR("[WIFI] PASS %s\n"), _wifiSoftAPPSK().c_str());
  446. DEBUG_MSG_P(PSTR("[WIFI] IP %s\n"), WiFi.softAPIP().toString().c_str());
  447. DEBUG_MSG_P(PSTR("[WIFI] MAC %s\n"), WiFi.softAPmacAddress().c_str());
  448. footer = true;
  449. }
  450. if (WiFi.getMode() == 0) {
  451. DEBUG_MSG_P(PSTR("[WIFI] ------------------------------------- MODE OFF\n"));
  452. DEBUG_MSG_P(PSTR("[WIFI] No connection\n"));
  453. footer = true;
  454. }
  455. if (footer) {
  456. DEBUG_MSG_P(PSTR("[WIFI] ----------------------------------------------\n"));
  457. }
  458. #endif //DEBUG_SUPPORT
  459. }
  460. void wifiDebug() {
  461. wifiDebug(WIFI_AP_STA);
  462. }
  463. // -----------------------------------------------------------------------------
  464. // API
  465. // -----------------------------------------------------------------------------
  466. String getIP() {
  467. if (WiFi.getMode() == WIFI_AP) {
  468. return WiFi.softAPIP().toString();
  469. }
  470. return WiFi.localIP().toString();
  471. }
  472. String getNetwork() {
  473. if (WiFi.getMode() == WIFI_AP) {
  474. return jw.getAPSSID();
  475. }
  476. return WiFi.SSID();
  477. }
  478. bool wifiConnected() {
  479. return jw.connected();
  480. }
  481. void wifiDisconnect() {
  482. jw.disconnect();
  483. }
  484. void wifiStartSTA() {
  485. jw.disconnect();
  486. jw.enableSTA(true);
  487. jw.enableAP(false);
  488. }
  489. void wifiStartAP(bool only) {
  490. if (only) {
  491. jw.enableSTA(false);
  492. jw.disconnect();
  493. jw.resetReconnectTimeout();
  494. }
  495. jw.enableAP(true);
  496. }
  497. void wifiStartAP() {
  498. wifiStartAP(true);
  499. }
  500. #if defined(JUSTWIFI_ENABLE_WPS)
  501. void wifiStartWPS() {
  502. jw.enableAP(false);
  503. jw.disconnect();
  504. jw.startWPS();
  505. }
  506. #endif // defined(JUSTWIFI_ENABLE_WPS)
  507. #if defined(JUSTWIFI_ENABLE_SMARTCONFIG)
  508. void wifiStartSmartConfig() {
  509. jw.enableAP(false);
  510. jw.disconnect();
  511. jw.startSmartConfig();
  512. }
  513. #endif // defined(JUSTWIFI_ENABLE_SMARTCONFIG)
  514. void wifiReconnectCheck() {
  515. bool connected = false;
  516. #if WEB_SUPPORT
  517. if (wsConnected()) connected = true;
  518. #endif
  519. #if TELNET_SUPPORT
  520. if (telnetConnected()) connected = true;
  521. #endif
  522. jw.enableSTA(true);
  523. jw.setReconnectTimeout(connected ? 0 : WIFI_RECONNECT_INTERVAL);
  524. }
  525. uint8_t wifiState() {
  526. uint8_t state = 0;
  527. if (jw.connected()) state += WIFI_STATE_STA;
  528. if (jw.connectable()) state += WIFI_STATE_AP;
  529. if (_wifi_wps_running) state += WIFI_STATE_WPS;
  530. if (_wifi_smartconfig_running) state += WIFI_STATE_SMARTCONFIG;
  531. return state;
  532. }
  533. void wifiRegister(wifi_callback_f callback) {
  534. jw.subscribe(callback);
  535. }
  536. // -----------------------------------------------------------------------------
  537. // INITIALIZATION
  538. // -----------------------------------------------------------------------------
  539. void wifiSetup() {
  540. _wifiConfigure();
  541. #if JUSTWIFI_ENABLE_SMARTCONFIG
  542. if (_wifi_smartconfig_initial) jw.startSmartConfig();
  543. #endif
  544. // Message callbacks
  545. wifiRegister(_wifiCallback);
  546. #if WIFI_AP_CAPTIVE
  547. wifiRegister(_wifiCaptivePortal);
  548. #endif
  549. #if DEBUG_SUPPORT
  550. wifiRegister(_wifiDebugCallback);
  551. #endif
  552. #if WEB_SUPPORT
  553. wsRegister()
  554. .onAction(_wifiWebSocketOnAction)
  555. .onConnected(_wifiWebSocketOnConnected)
  556. .onKeyCheck(_wifiWebSocketOnKeyCheck);
  557. #endif
  558. #if TERMINAL_SUPPORT
  559. _wifiInitCommands();
  560. #endif
  561. // Main callbacks
  562. espurnaRegisterLoop(wifiLoop);
  563. espurnaRegisterReload(_wifiConfigure);
  564. }
  565. void wifiLoop() {
  566. // Main wifi loop
  567. jw.loop();
  568. // Process captrive portal DNS queries if in AP mode only
  569. #if WIFI_AP_CAPTIVE
  570. if ((WiFi.getMode() & WIFI_AP) == WIFI_AP) {
  571. _wifi_dnsServer.processNextRequest();
  572. }
  573. #endif
  574. // Only send out gra arp when in STA mode
  575. #if WIFI_GRATUITOUS_ARP_SUPPORT
  576. if (_wifi_gratuitous_arp_interval) {
  577. _wifiSendGratuitousArp(_wifi_gratuitous_arp_interval);
  578. }
  579. #endif
  580. // Check if we should disable AP
  581. static unsigned long last = 0;
  582. if (millis() - last > 60000) {
  583. last = millis();
  584. _wifiCheckAP();
  585. }
  586. }