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.

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