If you like BoxMatrix then please contribute Supportdata, Supportdata2, Firmware and/or Hardware (get in touch).
My metamonk@yahoo.com is not reachable by me since years. Please use hippie2000@webnmail.de instead.
Property:plchost (avmcmd)
| BoxMatrix >> Shell-Commands >> plchost (avmcmd) | @ BoxMatrix - IRC-Chat - Translate: de es fr it nl pl |
| News | Selectors | Models | Accessories | Components | Environment | Config | Commands | System | Webif | Software | Develop | Lexicon | Community | Project | Media |
| Startup-Scr | Hotplug-Scr | BusyBox-Cmds | Bash-Cmds | AVM-Cmds | Chipset-Cmds | Linux-Cmds | Shared-Libs | Kernel-Mods | Research |
 |
Name-Collision - multiple objects in this wiki use the name plchost!
|
AVM-Command
| Command: | plchost (avmcmd) - type Exec | Wiki | Freetz | IPPF | whmf | AVM | Web |
| Location: | Shell-Commands >> AVM-Commands - Origin: AVM | ||||||
| Path: | Release: /usr/bin, /usr/sbin Lab+Rel: /usr/bin, /usr/sbin | ||||||
| Properties: | Size: 44.4k - 93.1k - Firmware: 5.50 - 7.58 | ||||||
| Function: | Powerline controller management daemon. | ||||||
Goto: Examples - Config - Events - GPL-Browser - Dependencies - Model-Matrix - Symbols - SMW-Browser
Details
plchost is the Powerline controller management daemon for the AMP. Variants are part of the open-plc-utils package, see the
GPL-Browser. AVM uses the proprietary plc-utils package by QCA, which differs from the source on the GPL-Browser.
Besides this AVM enhanced this program to a (nearly) full featured FRITZ!OS daemon.
plchost is used in all WLAN capable FRITZ!Powerline models, which are all FRITZ!OS based and use an AMP controller.
It is launched by the startup script E80-bootplc, see the Examples below.
plchost uses the plc network interface to upload the fw.nvm firmware. It uses the modpib generated factorydefault_en.pib and
factorydefault_ce.pib to maintain the PIB file stored in plc.pib. Since this is a character device it's buffered in plcuser.pib.
plchost provides the plchost event source to send the powerline_status event, which is received by the plc_status sink of
libplcctlmgr.so for ctlmgr. powerline_status reports the controller to be not running, running (booted) or connected.
The plchost event sink receives the push_button event from the LED driver, to initiate connection to another Powerline device.
That's all the host daemon has to do, bring the builtin AMP controller up and keep it running and connected.
The management of all devices in the Powerline network, builtin or remote, is performed by plcd.
1240e fw 7.16 - double default PIB:
root@fake:/var/mod/root# ./plchost -?
program: Qualcomm Atheros PLC Host Daemon
command: plchost [options] -C file -E file -N file -p file
options: [C:E:i:N:p:qt:vw:x]
-C f ce factory default parameter file is (f)
-E f en factory default parameter file is (f)
-i s host interface is (s) ["eth1"]
-N f firmware file is (f)
-p f user parameter file is (f)
-q quiet mode
-v verbose mode
-x exit on error
-! version information
-? help summary
root@fake:/var/mod/root# ./plchost -!
plchost plc-utils-2.1.11 QCAOSR-5270 ISO C Qualcomm Atheros, Santa Clara CA, USA
15:06:27 Feb 3 2023 QCA Proprietary License
546e fw 6.32 - single default PIB:
root@fake:/var/mod/root# ./plchost -?
program: Qualcomm Atheros PLC Host Daemon
command: plchost [options] -N file -P file -p file
options: [i:N:p:P:qt:vw:x]
-i s host interface is (s) ["eth1"]
-N f firmware file is (f)
-p f user parameter file is (f)
-P f factory default parameter file is (f)
-q quiet mode
-v verbose mode
-x exit on error
-! version information
-? help summary
root@fake:/var/mod/root# ./plchost -!
plchost plc-utils-2.1.5 OSR-8348-2 ISO C Qualcomm Atheros, Ocala FL USA
14:52:21 Jun 29 2015
Powerline stack:
- Lexicon: PLC, HPAV, PIB
- Companies: Intellon, Atheros, Qualcomm
- Components: AMP, BCM60
- Startup: bootplc.service, E80-bootplc, plcd.service, E50-plcd
- Commands: modpib, plchost, plcd, plctool, dpm_manager, chkpib
- Commands: supportdata.plc, supportdata.dpm
- Libraries: libplcaccess.so, libplccommon.so, libluaplc.so
- Libraries: libplcctlmgr.so, libmesh_plcservice.so, libserviceinterface.so
- Environment: plc_dak_nmk
- Config: plc.pib
- Defaults: factorydefault.pib, factorydefault-1.pib, factorydefault-2.pib, factorydefault-3.pib
- Defaults: factorydefault-ce.pib, factorydefault-en.pib, factorydefault-1-ce.pib, factorydefault-1-en.pib
- Defaults: factorydefault-2-ce.pib, factorydefault-2-en.pib
- Tempfiles: factorydefault_en.pib, factorydefault_ce.pib, factorydefault.pib
- Tempfiles: plcuser.pib, plc_dynamic_coupling_power_saving, dpm_manager.txt
- Firmware: fw.nvm
- Sockets: plc_sock_if, avmplcd
- Ports: Port-30000-tcp
- Interfaces: plc
- UI-Modules: plc
- Event-Sources: plchost
- Event-Sinks: plchost, plc_status, plc_ui_module
- Events: powerline_status
Examples
Simplified from E80-bootplc of a 1240e fw 7.16 - double default PIB:
ip link set dev plc up plchost -i plc -N fw.nvm -E factorydefault_en.pib -C factorydefault_ce.pib -p plc.pib
Simplified from E80-bootplc of a 546e fw 6.32 - single default PIB:
plchost -i lan -N fw.nvm -P factorydefault.pib -p plc.pib
Config
Daily updated index of Configuration files accessed by this command. Last update: 2024-12-21 07:02 GMT.
A - in the Mod column marks manual research, the Firmware then shows where the item occurs, not the Relation.
| Relation | Typ | Object | Mod | Firmware | Info | Origin |
|---|---|---|---|---|---|---|
| Config from | tffs | plc.pib | - | 5.50 - 7.58 | User-PIB on Powerline models without own flash for the AMP | AVM |
| 1 config relation for this command | ||||||
Events
Daily updated index of AVM-Events and AVMIPC-Datastore nodes affecting this command. Last update: 2023-12-10 05:13 GMT.
The owners of Event-Sinks and Event-Sources are manual research, which may be incomplete or even wrong.
A * in the Mod column marks info from Supportdata-Probes, which will always stay incomplete.
A ** in the Mod column marks info from Supportdata2 probes, which by their nature will stay way more incomplete.
A - in the Mod column marks manual research, the Firmware then shows where the item occurs, not the Relation.
| Relation | Typ | Object | Mod | Firmware | Info | Origin |
|---|---|---|---|---|---|---|
| Sink | evsink | plchost (evsink) | 4* | 6.92 - 7.27 | Event-Sink of plchost | AVM |
| Receives | event | push_button (event) | 4* | 6.92 - 7.27 | Button pressed or switch turned | AVM |
| Source | evsrc | plchost (evsrc) | 4* | 6.92 - 7.27 | Event-Source of plchost | AVM |
| Sends | event | powerline_status | 4* | 6.92 - 7.27 | PLC connection status | AVM |
| 4 event relations for this command | ||||||
GPL-Browser
Daily updated index of all plchost code findings on the GPL-Browser. Last update: 2024-12-21 05:03 GMT.
The Browse column points to the Path containing the respective source code on the gpl.boxmatrix.info service.
The SoC column lists the Chip-Codenames, the Model column lists the nicks of the Box-Models.
The Diff column links the comparison of the AVM Kernel to the pristine original from Kernel.org.
The Download column links the full tarball the respective directory content is extracted from.
The presence of the source does not mean it fits the respective model and architecture. See the Model-Matrix where it's used.
| Browse | Path | SoC | Arch | Model | Firmw | Diff | Download |
|---|---|---|---|---|---|---|---|
| zzzz-none-000 | packages/open-plc-utils/plc | none | none | none | 0.00 | none | Download |
| 1 directory containing plchost source code | |||||||
Dependencies
Daily updated index of all dependencies of this command. Last update: 2024-12-21 07:44 GMT.
A * in the Mod column marks info from Supportdata-Probes, which will always stay incomplete.
| Relation | Typ | Object | Mod | Firmware | Info | Origin |
|---|---|---|---|---|---|---|
| Started by | serv | plchost.service | 3 | 7.50 - 7.58 | supervisor service for plchost | AVM |
| Runs as | proc | plchost (process) | 6* | 5.50 - 7.58 | Process running plchost | AVM |
| Registers | wdog | plchost (watchdog) | 1* | 7.58 | Watchdog for plchost | AVM |
| Depends on | lib | ld.so | 5 | 7.08 - 7.58 | Dynamic linker / loader | Linux |
| Depends on | lib | libavm_event.so | 6 | 5.50 - 7.58 | AVM-Events management API | AVM |
| Depends on | lib | libavmcppterminatehandler.so | 3 | 7.50 - 7.58 | Process termination handler for C++ programs | AVM |
| Depends on | lib | libavmcsock.so | 6 | 6.90 - 7.58 | Networking, I/O and helper functions | AVM |
| Depends on | lib | libavmnexus.so | 3 | 7.27 - 7.58 | avmnexusd worker socket API | AVM |
| Depends on | lib | libbacktrace.so | 6 | 6.90 - 7.58 | Crash handler and logger | AVM |
| Depends on | lib | libboxlib.so | 6 | 6.90 - 7.58 | Box status, logging and statistics functions | AVM |
| Depends on | lib | libc.so | 6 | 5.50 - 7.58 | Standard C library | Linux |
| Depends on | lib | libgcc_s.so | 5 | 5.50 - 7.58 | GCC low-level runtime library | Linux |
| Depends on | lib | libled2.so | 6 | 5.50 - 7.58 | LED API - second+third generation | AVM |
| Depends on | lib | libplcaccess.so | 6 | 6.98 - 7.58 | Powerline access and administration API | AVM |
| Depends on | lib | libplccommon.so | 3 | 7.50 - 7.58 | Common Powerline related helper functions | AVM |
| Depends on | lib | libstdc++.so | 3 | 7.50 - 7.58 | GNU C++ library | Linux |
| Depends on | lib | libwdt.so | 3 | 7.50 - 7.58 | AVM-Watchdogs management API | AVM |
| 17 dependencies for this command | ||||||
Model-Matrix
Daily updated index of the presence, path and size of this command for each model. Last update: 2024-12-21 05:44 GMT.
Showing all models using this command. Click any column header (click-wait-click) to sort the list by the respective data.
The (main/scrpn/boot/arm/prx/atom/rtl) label in the Model column shows which CPU is meant for Multi-Linux models.
Note that this list is merged from Firmware-Probes of all known AVM firmware for a model, including Recovery.exe and Labor-Files.
| Model | Firmware | Path | Size |
|---|---|---|---|
| FRITZ!Powerline 540E | 5.58 - 7.15 | /usr/bin, /usr/sbin | 50.1k - 93.1k |
| FRITZ!Powerline 546E | 5.50 - 7.15 | /usr/bin, /usr/sbin | 50.1k - 93.1k |
| FRITZ!Powerline 1240 AX | 7.57 - 7.58 | /usr/sbin | 70.0k |
| FRITZ!Powerline 1240E | 6.33 - 7.16 | /usr/bin, /usr/sbin | 50.1k - 84.4k |
| FRITZ!Powerline 1260E | 6.90 - 7.58 | /usr/bin, /usr/sbin | 44.4k - 70.0k |
| FRITZ!Powerline 1260 | 7.27 - 7.58 | /usr/sbin | 62.1k - 70.0k |
| 6 models use this command | |||
Symbols
Daily updated index of all symbols of this command. Last update: 2024-12-21 07:44 GMT.
| Firmware | Symbol |
|---|---|
| 5.50 - 7.16 | BootDevice2 |
| 5.50 - 7.16 | BootFirmware2 |
| 5.50 - 7.16 | BootParameters2 |
| 5.50 - 7.16 | Confirm |
| 5.50 - 7.16 | EthernetHeader |
| 5.50 - 7.16 | Failure |
| 5.50 - 7.16 | HostActionResponse |
| 5.50 - 7.16 | InitDevice2 |
| 5.50 - 7.16 | MMECode |
| 5.50 - 7.16 | ModuleRead |
| 5.50 - 7.16 | PushButton |
| 5.50 - 7.16 | QualcommHeader |
| 6.98 - 7.16 | QualcommHeader1 |
| 5.50 - 7.16 | ReadMFG |
| 5.50 - 7.16 | ReadMME |
| 5.50 - 7.16 | ReadParameters2 |
| 5.50 - 7.16 | Request |
| 6.98 - 7.16 | ResetAndWait |
| 5.50 - 7.16 | ResetDevice |
| 5.50 - 7.16 | SendMME |
| 5.50 - 7.16 | UnwantedMessage |
| 5.50 - 7.16 | WaitForStart |
| 5.50 - 7.16 | WriteExecuteFirmware2 |
| 5.50 - 7.16 | WriteExecuteParameters2 |
| 5.50 - 7.16 | checkfilename |
| 5.50 - 7.16 | checksum32 |
| 5.50 - 7.16 | chipset |
| 5.50 - 7.16 | closechannel |
| 7.50 - 7.58 | error |
| 5.50 - 7.16 | fdchecksum32 |
| 5.50 - 7.16 | getoptv |
| 5.50 - 7.16 | hexdecode |
| 5.50 - 7.16 | hexdump |
| 5.50 - 7.16 | hexencode |
| 5.50 - 7.29 | main |
| 5.50 - 6.32 | nvmfile2 |
| 5.50 - 7.16 | openchannel |
| 6.33 - 7.16 | panther_nvm_file |
| 6.33 - 6.92 | panther_pib_file |
| 5.50 - 6.32 | pibfile2 |
| 5.50 - 7.16 | putoptv |
| 5.50 - 7.16 | readpacket |
| 5.50 - 7.16 | sendpacket |
| 5.50 - 7.16 | todigit |
| 5.50 - 7.16 | typename |
| 5.50 | uintspec |
| 5.50 - 7.16 | version |
| 47 symbols for this command | |
