Interfaccia di linea di cummanda
Manuale d'usu
CLI

Introduzione

Stu manuale descrive cumu cuntrullà i prudutti via a so interfaccia di cuntrollu. L'interfaccia di linea di cummandu (CLI) permette à u hub o hubs per esse integrati in un sistema più grande chì hè cuntrullatu da un computer host. Un emulatore di terminal seriale deve esse installatu per pudè usà a CLI, è l'emulatore richiede l'accessu à u portu COM, cusì nisun altru software, cum'è Live.Viewer, pò accede à u portu à u listessu tempu. Un example emulator chì pò esse usatu hè puTTY chì pò esse scaricatu da u ligame seguente.
www.putty.org
I cumandamenti chì sò emessi via u portu COM sò chjamati cumandamenti. Certi paràmetri modificati da i cumandamenti in stu documentu sò volatili - vale à dì, i paràmetri sò persi quandu u hub hè riavviatu o spento, per piacè vede i cumandamenti individuali per i dettagli.
In tuttu stu manuale, i paràmetri opzionali sò indicati in parentesi quadrate: [ ]. I caratteri di cuntrollu ASCII sò indicati trà <> parentesi.
Stu documentu è i cumandamenti sò sottumessi à cambià. I dati duveranu esse analizati per esse tolleranti sia in maiuscule sia in minuscule, spazii bianchi, caratteri di linea supplementari ... ecc.
Pudete scaricà l'ultima versione di stu manuale da u nostru websitu à u ligame seguente.
www.cambrionix.com/cli

2.1. Locu di u dispusitivu

U sistema appare cum'è un portu seriale virtuale (chjamatu ancu VCP). In Microsoft Windows™, u sistema apparirà cum'è un portu di cumunicazione numerata (COM). U numeru di portu COM pò esse trovu da accessing manager dispusitivu.
In macOS®, un dispositivu file hè creatu in u cartulare /dev. Questu hè di a forma / dev / tty.usbserial S induve S hè una stringa seriale alfanumerica unica per ogni dispusitivu in a Serie Universale.

2.2. Drivers USB
A cumunicazione cù i nostri prudutti hè attivata per mezu di un portu COM virtuale, sta cumunicazione richiede driver USB.
In Windows 7 o più tardi, un driver pò esse installatu automaticamente (se Windows hè cunfiguratu per scaricà automaticamente i driver da Internet). Se ùn hè micca u casu, u driver pò esse scaricatu da www.ftdichip.com. I driver VCP sò richiesti. Per l'urdinatori Linux® o Mac®, i drivers OS predeterminati devenu esse utilizati.

2.3. Paràmetri di cumunicazione
I paràmetri di cumunicazione predeterminati sò cum'è quì sottu.

Ambientazione di cumunicazione	Valore
Numeru di bit per seconda (baud)	115200
U numeru di bit di dati	8
Parità	Nimu
Numaru di bit di stop	1
cuntrollu di flussu	Nimu

L'emulazione di terminal ANSI deve esse sceltu. U cumandamentu mandatu deve esse terminatu cùE linee ricevute da u hub sò terminate cùU hub accetterà cumandamenti back-to-back, in ogni modu, l'urdinatore ospitante deve aspittà una risposta prima di emette un novu cumandamentu.

	ATTENZIONE
	U hub pò esse micca rispunsevuli Per a cumunicazione seriale duvete aspittà una risposta da qualsiasi cumandamenti prima di emette un novu cumandamentu. A falla di fà cusì pò fà chì u hub ùn risponda micca è esige un reset completo di putenza.

2.4. Boot testu è prompt di cumanda
À u boot, u hub emetterà una stringa di sequenze di escape ANSI per resettate un emulatore di terminal attaccatu.
U bloccu di titulu seguita questu, dopu un prompt di cumanda.
U prompt di cumanda ricevutu hè cum'è quì sottuEccettu in u modu di boot induve hè cum'è quì sottuPer ghjunghje à un novu prompt di boot, mandate . Questu annulla ogni stringa di cumanda parziale.

2.5. I prudutti è u so firmware
Quì sottu hè una lista di i prudutti, i so numeri di parte è u tipu di Firmware chì usa.

Firmware	Part Number	Nome di u produttu
Universale	PP15S	PowerPad 15S
Universale	PP15C	PowerPad15C
Universale	PP8S	PowerPad 8S
Universale	SS15	SuperSync15
Universale	TS3-16	ThunderSync3-16
TS3-C10	TS3-C10	ThunderSync3-C10
Universale	U16S Spade	U16S Spade
Universale	U8S	U8S
PowerDelivery	PDS-C4	PDSync-C4
Universale	ModIT-Max	ModIT-Max
MotorControl	Cunsigliu di cuntrollu di u mutore	ModIT-Max

2.6. Struttura di cumandamentu
Ogni cumanda seguita u furmatu sottu.U cumandamentu duverà esse inseritu prima, se ùn esiste micca paràmetri per u cumandamentu allora questu duverà esse seguitu immediatamente da è per mandà u cumandamentu.
Micca ogni cumanda hà paràmetri obligatorii, ma s'ellu sò applicabili allora questi anu da esse inseriti per u cumandamentu per travaglià, una volta chì u cumandamentu è i paràmetri obligatorii sò inseriti allora è serà necessariu di significà a fine di un cumandamentu.
I paràmetri opzionali sò indicati in parentesi quadrate, per esempiu [port]. Questi ùn anu micca bisognu à esse inseriti per u cumandamentu per esse mandatu, ma s'ellu sò inclusi, anu da esse seguitu da è per significà a fine di un cumandamentu.

2.7. Struttura di risposta
Ogni cumanda riceverà a so risposta specifica seguita da , un prompt di cumanda è dopu un spaziu. A risposta hè terminata cum'è mostra quì sottu.

Certi risposti di cumanda sò "live" chì significa chì ci sarà una risposta cuntinuu da u pruduttu finu à chì u cumandamentu hè annullatu mandendu un cumanda. In questi casi ùn riceverete micca a risposta standard cum'è sopra finu à cumanda hè statu mandatu. Sè vo disconnect u prodottu ùn fermarà u flussu di dati è ricunniscendu vi risultatu in a continuazione di u flussu di dati.

Cumandamenti

A sottu hè una lista di cumandamenti chì sò supportati da tutti i prudutti

Cumanda	Descrizzione
bd	Descrizzione di u produttu
cef	Cancella i bandieri d'errore
cls	Clear u screnu di u terminal
crf	Cancella bandiera riavviata
salute	Mostra voltages, temperatura, errori è bandiera di boot
host	Mostra se l'ospite USB hè presente, è stabilisce u cambiamentu di modu
id	Mostra a stringa d'ID
l	Live view (Invia periodicamente risposte nantu à u statu attuale di u pruduttu)
ledb	Stabilisce u mudellu LED utilizendu un formatu di bit
leds	Stabilisce u mudellu LED utilizendu un furmatu di stringa
limiti	Mostra voltage limite di temperatura
scatula	Log statu è avvenimenti
modu	Stabilisce u modu per unu o più porti
riavvia	Reboot u pruduttu
luntani	Entra o esce da u modu induve i LED sò cuntrullati manualmente o automaticamente
sef	Pone i bandieri d'errore
statu	Mostra u statu per unu o più porti
sistema	Mostra l'infurmazione di hardware è firmware di u sistema

Quì sottu hè una tavola di cumandamenti specifichi à u Firmware Universale

Cumanda	Descrizzione
bip	Face u bip di u pruduttu
clcd	LCD chjara
fr_profile	Attiva o disattiva profile
get_profiles	Ottene una lista di profiles assuciatu à un portu
chjavi	Leghjite i bandieri di l'avvenimentu di cliccà chjave

lcd	Scrivite una stringa à u display LCD
list_profiles	Lista tutti i profiles nantu à u sistema
logc	Log currente
sec	Stabilite o uttene u modu di sicurità
serial_speed	Cambia a velocità di l'interfaccia seriale
set_delays	Cambia i ritardi interni
set_profiles	Piazzà profiles assuciatu à un portu

Quì sottu hè una lista di cumandamenti specifichi per u PD Sync è u Firmware TS3-C10

Cumanda	Descrizzione
dettagliu	mostra u statu per unu o più porti
logp	Log currente
putenza	stabilisce a putenza massima di u produttu o uttene u putere di u produttu per unu o più porti
qcmode	stabilisce u modu di carica rapida per unu o più porti.

Quì sottu hè una lista di cumandamenti specifichi à u Firmware di Control Motor

Cumanda	Descrizzione
porta	Aprite, chjude o fermate e porte
interruttore à chjave	Mostra u statu di l'interruttore di chjave
proxy	Distingui i cumandamenti significati per a scheda Motorcontrol
stalla	Impostare a corrente di stallo per i mutori,
rgb	Impostate i LED per attivare l'override RGB nantu à i porti
rgb_led	Pone i LED nantu à i porti à u valore RGBA in hex

3.1. Notes

1. Certi prudutti ùn sustene micca tutti i cumandamenti. Vede u Prudutti supportati sezzione per
2. Tutti i cumandamenti destinati à a scheda di cuntrollu di u Motore deve esse prefissatu cù u proxy

3.2. bd (descrizzione di u pruduttu)
U cumandamentu bd furnisce una descrizzione di l'architettura di u pruduttu. Questu include tutti i porti upstreand downstream. Questu hè di furnisce u software esternu l'architettura di l'arbulu di cunnessione USB.
Sintassi: (vede 'Struttura di cumandamenti)

Risposta: (vede a struttura di Risposta)
Coppiu di valore di nome chì indicanu a presenza di caratteristiche di u pruduttu. Questu hè seguitatu da una descrizzione di ogni hub USB in turnu, listendu ciò chì hè attaccatu à ogni portu di quellu hub. Ogni portu di un hub serà attaccatu à un portu di carica, un portu di espansione, un hub downstream, un dispositivu USB o hè inutilizatu.
E caratteristiche sò indicate da queste entrate:

Parametru	Valore
Porti	U numeru di porti USB
Sincronizza	Un "1" indica chì u pruduttu furnisce capacità di sincronia
Temp	Un "1" indica chì u pruduttu pò misurà a temperatura
EXTPSU	Un "1" indica chì u pruduttu hè furnitu cù una PSU esterna chì hè più grande di 5V

A sezione di attache pò avè e seguenti entrate, tutti l'indici sò basati in 1:

Parametru	Valore	Descrizzione
Nodi	n	Un numeru chì indica u numeru di nodi chì sta descrizzione include. Un node serà o un hub USB o un controller USB.
Node i Type	tipu	i hè un indice chì indica quale nodu hè questu. tipu hè una entrata da u Table Node sottu.
Node è Ports	n	Un numeru chì indica quanti porti hà stu node.

Hub	Hub	U hub USB
	Portu di cuntrollu	U hub USB
	Portu di espansione	U hub USB
	Portu	U hub USB
	Hub opzionale	U hub USB
	Turbo Hub	U hub USB
	Hub USB3	U hub USB
	Portu inutilizatu	U hub USB

U tipu di nodu pò esse unu di i seguenti:

Tipu di nodu	Descrizzione
Hub j	Un hub USB 2.0 index j
Hub opzionale j	Un hub USB chì pò esse stallatu, index j
radica r	Un controller USB cù un hub di root chì significa ancu chì u numeru di bus USB cambierà
Turbo Hub j	Un hub USB capace di funziunà in modalità Turbo cù l'indice j
Hub USB3 j	Un hub USB 3.x cù index j

Example3.3 cef (Clear flags error)
U CLI hà bandieri d'errore chì significheranu se un errore specificu hè accadutu. I bandieri seranu sbulicati solu usendu u cumandamentu cef o attraversu un reset di u produttu o un ciclu di accensione / spegnimentu.

"UV"	Sottu voltagL'avvenimentu hè accadutu
"OV"	Over-voltagL'avvenimentu hè accadutu
"OT"	Un avvenimentu di over-temperature (over-heat) hè accadutu

Se a cundizione d'errore persiste, u hub hà da stabilisce a bandiera di novu dopu chì hè stata sguassata.

Sintassi: (vede Struttura di cumanda)

Risposta: (vede a struttura di Risposta)3.4. cls (schermu chjaru)
Mandate sequenze di escape ANSI per sguassà è resettate u screnu di u terminal.
Sintassi: (vede Struttura di cumanda)Risposta: (vede a struttura di Risposta)

3.5. crf (Clear flag rebooted)
A bandiera rebootata hè di informà se u hub hà riavviatu trà i cumandamenti è pò esse sbulicatu cù u cumandamentu crf.
Se a bandiera rebootata hè stata stabilita, allora i cumandamenti precedenti chì cambianu i paràmetri volatili seranu persi.
Sintassi: (vede Struttura di cumanda)Risposta: (vede a struttura di Risposta)

3.6. salute (salute di u sistema)
U cumandamentu di salute mostra u supply voltages, temperatura PCB, bandieri d'errore è a bandiera rebootata.
Sintassi: (vede Struttura di cumanda)

Risposta: (vede a struttura di Risposta)
paràmetru: coppia di valori, una coppia per fila.

Parametru	Descrizzione	Valore
Voltage Avà	Fornitura attuale voltage
Voltage Min	Volu di offerta più bassutagè vistu
Voltage Max	Volu di offerta più altutagè vistu
Voltage Bandiere	Lista di u voltage bandiere d'errore di rail di furnimentu, siparati da spazii		Nisuna bandiera: voltage hè accettabile
		UV	Sottu voltagL'avvenimentu hè accadutu
		OV	Over-voltagL'avvenimentu hè accadutu
Temperature Now	Température du PCB, °C	> 100 C	A temperatura hè sopra à 100 ° C
		<0.0 C	A temperatura hè sottu à 0 ° C
		tt.t C	Temperature, per esempiu 32.2 ° C
Température min	Temperature PCB più bassu vistu, ° C	<0.0 C	A temperatura hè sottu à 0 ° C
Temperature Max	A più alta temperatura PCB vista, °C	> 100 C	A temperatura hè sopra à 100 ° C
Bandiere di temperatura	Bandiere di errore di temperatura		Nisuna bandiera: a temperatura hè accettata
		OT	Un avvenimentu di over-temperature (over-heat) hè accadutu
Bandiera riavviata	Adupratu per detectà se u sistema hà iniziatu	R	U sistema hà iniziatu o riavviatu
			Bandiera sguassata cù u cumandamentu crf

Example* uscita da un SS15

3.7. host (rilevazione di l'ospite)
U hub monitoreghja u socket USB host per un computer host attaccatu. In modu automaticu, se u pruduttu rileva un òspite, cambierà à u modu di sincronia.
U cumandamentu di l'ospite pò esse usatu per stabilisce se un computer host hè attaccatu. Pò esse ancu usatu per impedisce chì u hub cambie automaticamente i modi.
Sintassi: (vede Struttura di cumanda)

Tabella per u modu in u Firmware Universale

Modu	Descrizzione
autumàticu	U modu di tutti i porti populati cambia automaticamente quandu un host hè cunnessu o disconnected
manuale	Solu i cumandamenti ponu esse usatu per cambià modi. A prisenza o l'assenza di un òspite ùn cambierà micca u modu

Tabella per u modu in u firmware PDSync è TS3-C10

Modu	Descrizzione
autumàticu	I porti permetteranu a cunnessione di sincronia cum'è l'ospitu vene è va. A carica hè sempre attivata, salvu chì u portu hè disattivatu.
off	Se l'ospite ùn hè più rilevatu, tutti i porti di carica seranu disattivati.

Risposta se u paràmetru hè furnitu: (vede Struttura di Risposta)

Risposta s'ellu ùn hè micca furnitu un paràmetru:

Parametru	Descrizzione	Valore
Presente	Sia un òspite hè presente o micca	Iè / No
Cambiamentu di modu	U modu in u hub hè	Auto / Manuale

Table per prisente in tutti i firmware

Presente	Descrizzione
Iè	l'ospite hè rilevatu
Innò	l'ospite ùn hè micca rilevatu

Notes

1.  A prisenza di l'urdinatore òspite hè sempre signalata se u modu hè stallatu in manuale.
2. In carica solu i prudutti, u cumandamentu di l'ospite hè presente, ma cum'è i prudutti sò incaricati solu è ùn ponu micca uttene infurmazioni di u dispositivu, u cumandamentu hè redundante.
3. Solu l'U8S pò signalà chì l'ospitu ùn sia micca presente perchè hè l'unicu pruduttu chì hà un cuntrollu separatu è una cunnessione di l'ospite.
4. U modu d'ospite predeterminatu hè auto per tutti i prudutti.

Examples
Per stabilisce u modu di host à manuale:Per determinà se un host hè presente, è uttene u modu:

È cù un host attaccatu:3.8. id (identità di u produttu)
U cumandamentu id hè utilizatu per identificà u pruduttu è furnisce ancu qualchì infurmazione basica nantu à u firmware chì funziona nantu à u pruduttu.
Sintassi: (vede Struttura di cumanda)Risposta: (vede a struttura di Risposta)
Una sola linea di testu chì cuntene parechje coppie nome: valore separati da virgule, chì ponu esse aduprate per identificà u pruduttu.

Nome	Valore
mfr	Stringa di fabricatore (per esempiu, cambrionix)
modu	Una stringa per descriverà in quale modu operativu hè u firmware (per esempiu, principale)
hw	U numeru di parte di u hardware Numeri di parte)
hwid	Un valore esadecimale utilizatu internamente per identificà u pruduttu (per esempiu, 0x13)
fw	Un pseudonumeru chì rapprisenta a revisione di firmware (per esempiu, 1.68)
bl	Un pseudonumeru chì rapprisenta a rivisione di u bootloader (per esempiu, 0.15)
sn	Un numaru di seriale. Se ùn hè micca utilizatu, mostrarà tutti i zeri (per esempiu, 000000)
gruppu	Adupratu nantu à certi prudutti per urdinà l'aghjurnamenti di firmware chì hè utile à l'aghjurnà di i prudutti chì sò in catena in margherita in modu chì i prudutti downstream sò aghjurnati è riavviati prima.
fc	Firmware Code hè adupratu per denotà quale tipu di firmware accetta u pruduttu

Example

3.9. l (Vivu view)
Live view furnisce un flussu cuntinuu di dati à view i stati portu è bandiere. I porti ponu esse urdinati usendu una sola pressa chjave cum'è a tabella sottu.
Sintassi (vede Struttura di cumanda)Live view hè pensatu per esse interattivu cù un terminal. Face un usu estensivu di e sequenze di escape ANSI per cuntrullà a pusizione di u cursore. Ùn pruvate micca di scrive u cuntrollu di u live view.
A dimensione di u terminal (fila, culonne) deve esse abbastanza grande o a visualizazione serà corrotta. U hub prova di stabilisce u numeru di fila è colonne di u terminal quandu entra in diretta viewmodu.

Cumandamenti:
Scrivite i cumandamenti sottu per interagisce cù live view.
Selezziunate un portu scrivite un numeru di portu di 2 cifre (per esempiu 01) per cambià tutti i porti utilizati /

Cumanda	Descrizzione
/	Cambia tutti i porti
o	Spegni u portu
c	Turn u portu per carica solu
s	Turn u portu à u modu di sincronia
q/	Smettite in diretta view

Example

3.10. ledb (LED bit flash pattern)
U cumandamentu ledb pò esse usatu per assignà un mudellu di bit flash à un LED individuale.
Sintassi: (vede Struttura di cumanda)

portu: hè u numeru di portu, cuminciendu da 1
fila: hè u numeru di fila LED, cuminciendu da 1. Tipicamente questi sò disposti cusì:

Fila	Funzione LED
1	Incaricatu
2	Carica
3	Modu di sincronizazione

ptn: pò esse specificatu cum'è decimale (range 0..255), esadecimale (range 00h à ffh) o binariu (range 00000000b à 11111111b). U numeru esadecimale deve finisce cù 'h'. I numeri binari anu da finisce cù 'b'. Cifri più significati ponu esse omessi per tutti i radici. Per esample, '0b' hè u listessu cum'è '00000000b'.
I numeri esadecimali ùn sò micca sensible à u casu. I caratteri di u mudellu validu ponu esse vistu in u cuntrollu LED
Cuntrolla
usendu u [H | R] paràmetri opzionali

Parametru	Descrizzione
H	piglia u cuntrollu di u LED senza un cumandamentu remota
R	libera u cuntrollu di u LED torna à u funziunamentu normale.

Example
Per lampà u LED di carica in u portu 8 à u ciclu di duty 50/50, utilizate:Per accende u portu 1 LED in carica continuamente (vale à dì senza lampeggiante):Per disattivà u portu 1 sync LED:

Notes

1. Quandu ùn ci sò micca LED, i cumandamenti ùn sò micca truvati.
2. U statu LED ùn hè micca ristabilitu quandu u modu remotu hè esce è dopu rientratu.

3.11. leds (modulu di flash di stringa LED)
U cumandamentu di leds pò esse usatu per assignà una catena di mudelli di flash à una fila di LED. Questu hè assai più veloce per cuntrullà una fila sana di LED. Solu trè usi di u cumandamentu di leds ponu stabilisce tutti i LED in u sistema.
Sintassi: (vede Struttura di cumanda)fila: hè l'indirizzu cum'è per ledb sopra.
[ptnstr] hè una stringa di caratteri, unu per portu, cuminciendu da u portu 1. Ogni caratteru rapprisenta un mudellu di flash differenti per esse assignatu à u portu. Una stringa di caratteri assignarà mudelli flash à i porti.
I caratteri di u mudellu validu ponu esse vistu in u cuntrollu LED
Example
Per stabilisce u seguente mudellu di lampu nantu à a fila chì cuntene un LED:

Portu	Funzione LED
1	Immubiliatu
2	On
3	Flash veloce
4	Pulsu unicu
5	Off
6	On continuamente
7	On continuamente
8	Immubiliatu

Emette u cumandamentu:Nota chì u primu LED (port 1) deve esse saltatu cù u caratteru x. U portu 8 ùn hè micca cambiatu postu chì a stringa di mudellu cuntene solu 7 caratteri.

Notes

1. Quandu ùn ci sò micca LED, i cumandamenti ùn sò micca truvati.
2. U statu LED ùn hè micca ristabilitu quandu u modu remotu hè esce è dopu rientratu.

3.12. limiti (limiti di u sistema)
Per vede i limiti (soglie) à quale u sottu-voltage, sopra-voltage e errore over-temperature sò triggered, issu u cumandimu limiti.
Sintassi (vede Struttura di cumanda)

Example* uscita da SS15
Notes

1. I limiti sò fissati in u firmware è ùn pò micca esse cambiatu da un cumandamentu.
2. E misure sò sampguidatu ogni 1 ms. U voltages deve esse sopra o sottu voltage per 20 ms prima chì una bandiera hè alzata.
3. A temperatura hè misurata ogni 10 ms. Una media di corsa di 32 sampi sò usati per dà u risultatu.
4. Se u voltage hè sampguidatu duie volte in una fila fora di e specificazioni di u produttu allora i porti seranu chjusi

3.13. logc (Portu di log currente)
Per u firmware Universale u cumandamentu logc hè utilizatu per vede l'attuale per tutti i porti in un intervallu di tempu predeterminatu. In più di a temperatura attuale è a velocità di u fan.
U logging per i dui casi pò esse firmatu mandendu q o .
Sintassi Universale di Firmware: (vede Struttura di cumanda)seconde hè l'intervallu trà e risposti in u range 1..32767

Risposta: (vede a struttura di Risposta)
CSV (valori separati da virgole).

ExampleNotes

1. U paràmetru hè specificatu in seconde, ma hè cunfirmatu cum'è minuti: seconde per comodità:
2.  A registrazione attuale funziona in i modi di carica è di sincronia.
3. L'output hè arrotondatu à 1mA prima di a visualizazione

3.14. logp (putenza di u portu di log)
Per u firmware PDSync è TS3-C10, u cumandamentu logp hè utilizatu per vede u currente è u voltage per tutti i porti à un intervallu di tempu predeterminatu.
A registrazione per i dui casi pò esse fermata premendu q o CTRL C.
Sintassi: (vede Struttura di cumanda)[secondi] hè l'intervallu trà e risposte in a gamma 1..32767
Risposta: (vede a struttura di Risposta)
CSV (valori separati da virgole).
Example

Notes

1. U paràmetru hè specificatu in seconde, ma hè cunfirmatu cum'è minuti: seconde per comodità:
2. A registrazione attuale funziona in i modi di carica è di sincronia.
3. L'output hè arrotondatu à 1mA prima di a visualizazione

3.15. loge (Log events)
U cumandamentu di logu hè utilizatu per annunzià l'avvenimenti di cambiamentu di u statu di u portu è per annunzià periodicamente u statu di tutti i porti.
U logging hè firmatu da u mandatu
Sintassi: (vede Struttura di cumanda)[secondi] hè l'intervallu trà e risposte in a gamma 0..32767
Risposta: (vede a struttura di Risposta)
CSV (valori separati da virgole).
Example
Eccu un dispositivu chì hè attaccatu à u portu 4, lasciatu per 6 seconde, è dopu sguassatu:

Notes

1. I cumandamenti sò accettati mentre in questu modu, ma i cumandamenti ùn sò micca eccu è u prompt di cumanda ùn hè micca emessu.
2. Se un valore di seconde di "0" hè specificatu, u rapportu periodicu hè disattivatu è solu l'avvenimenti di cambiamentu di u statu di u portu seranu signalati. Se ùn hè micca furnitu un parametru di seconde, un valore predeterminatu di 60s serà utilizatu.
3. Un tempu stamp in seconde hè uscita prima di ogni avvenimentu o rapportu periodicu u tempu stamp hè u tempu chì u hub hè attivatu.

3.16. modu (modu Hub)
Ogni portu pò esse piazzatu in unu di quattru modi usendu u cumandamentu di modu.
Sintassi: (vede Struttura di cumanda)

Parametru	Descrizzione
m	Un caratteru di modu validu
p	U numeru di portu
cp	U prufessiunale di caricafile

Risposta: (vede 'Struttura di risposta)

paràmetri di modu per u Firmware Universale

Parametru	Descrizzione	Valore
Carica	U portu hè prontu per carricà un dispositivu, è pò detectà se un dispositivu hè attaccatu o staccatu. Se un dispositivu hè attaccatu, u charger profiles attivati ​​per quellu portu sò pruvati unu per unu. Allora u dispusitivu hè carica cù u profile chì hà datu a più alta corrente. Durante u sopra, u portu hè disconnected from the host USB bus.	s
Sincronizza	U portu hè attaccatu à u bus USB host via un hub USB. U dispusitivu pò piglià corrente di carica da VBUS secondu e capacità di u dispusitivu.	b
Biased	U portu hè rilevatu, ma ùn ci sarà micca carica o sincronizazione.	o
Off	U putere à u portu hè eliminatu. Ùn ci hè micca carica. Nisun dispositivu attache o staccate a rilevazione hè pussibule.	c

paràmetri di modu per PDSync è TS3-C10 Firmware

Parametru	Descrizzione	Valore
Sincronizza	U dispusitivu pò carica mentre cumunicà cù l'ospite cunnessu à u hub.	c
Off	A putenza (VBUS) à u portu hè eliminata. Ùn ci hè micca carica. Nisun dispositivu attache o staccate a rilevazione hè pussibule.	o

U paràmetru di u portu
[p], hè facultativu. Pò esse usatu per specificà u numeru di portu. Se lasciate in biancu, tutti i porti sò affettati da u cumandamentu.
U prufessiunale di caricafile paràmetru
[cp] hè facultativu ma pò esse usatu solu quandu si mette un portu unicu in modu di carica. Se specificate, allora u portu entrerà direttamente in modalità di carica cù u pro sceltufile.

Profile paràmetru	Descrizzione
0	Algoritmu di carica intelligente chì selezziunà un prufessiunalefile 1-6
1	2.1A (Apple è altri cù tempu di rilevazione brevi)
2	BC1.2 Standard (Questu copre a maiò parte di i telefoni Android è altri dispositi)
3	Samsung
4	2.1A (Apple è altri cù longu tempu di rilevazione)
5	1.0A (Tipicamenti usatu da Apple)
6	2.4A (Tipicamenti usatu da Apple)

Examples
Per disattivà tutti i porti:Per mette solu u portu 2 in modu di carica:

Per mette solu u portu 4 in modu di carica cù profile 1:

3.17. Reboot (riavvia u pruduttu)
Reboot u pruduttu.
Sintassi: (vede Struttura di cumanda)Se u paràmetru di watchdog hè inclusu, u sistema si bloccherà in un ciclu infinitu, senza risposta mentre u timer di watchdog scade. A scadenza dura parechji sicondi, dopu chì u sistema riavviarà.
Se u cumandamentu di reboot hè emessu senza un paràmetru, u cumandamentu di reboot hè eseguitu immediatamente.
Risposta: (vede 'Struttura di risposta)U cumandamentu di reboot hè un reset soft chì affetterà solu u software. Per fà un resettore cumpletu di u produttu, avete bisognu di accende u ciculu di u hub.
Rebooting stabilisce a bandiera "R" (riavviata), chì hè informata da i cumandamenti di salute è statali.

3.18. remote (Controllu à distanza)
Certi prudutti anu dispusitivi d'interfaccia cum'è indicatori, interruttori è display chì ponu esse aduprati per interagisce direttamente cù u hub. A funzione di sti interfacce pò esse cuntrullata via cumandamenti. Stu cumandamentu disattiva a funzione normale, è permette u cuntrollu via cumandamenti invece.

Entra in u modu di cuntrollu remoto
L'indicatori seranu disattivati ​​quandu entra in u modu di cuntrollu remoto. A visualizazione ùn serà micca affettata è u testu precedente resterà. Aduprate clcd per sguassà a visualizazione. Per disattivà u cuntrollu di a cunsola da u firmware, è permettenu di esse cuntrullatu via cumandamenti, emette u cumandamentu remotu senza parametri:
Sintassi: (vede Struttura di cumanda)Per abbandunà u modu di cuntrollu remoto, è permettenu a cunsola per esse cuntrullata da u firmware, emette un paràmetru di cumanda di uscita.

Parameteexit	Descrizzione
esce	I LED seranu resettati è u LCD sguassatu quandu abbandunà u modu di cuntrollu remoto.
kexit	Dice à u hub per entre in u modu di cuntrollu remoto, ma esce automaticamente quandu una chjave di cunsola hè pressata:

Notes

1. In u modu di kexit remoto, u cumandamentu di i tasti ùn restituverà micca l'eventi di stampa di chjave.
2. Pudete passà da u modu remoto à u modu kexit remoto, è vice-versa.
3. A carica, a sincronizazione è a sicurità operanu sempre in modu remoto. In ogni casu, u so statutu ùn serà micca infurmatu à a cunsola, è l'utilizatore hà bisognu di sondaghju i bandieri di statutu (usendu i cumandamenti di u statu è di a salute) per determinà u statu di u sistema.
4. Se u tasti, lcd, clcd, leds or ledb I cumandamenti sò emessi quandu ùn sò micca in modalità di kexit remota o remota, allora un missaghju d'errore serà mostratu, è u cumandamentu ùn serà micca eseguitu.

3.19. sef (Set Flag d'errore)
Pò esse utile per stabilisce i bandieri d'errore per esaminà u cumpurtamentu di u sistema quandu si trova un errore.
Sintassi: (vede Struttura di cumanda)

flags hè unu o più di i paràmetri sottu, quandu invià parechji bandieri un spaziu hè necessariu trà ogni paràmetru.

Parametru	Descrizzione
3 UV	Ferrovia 3V sottu voltage
3 OV	3V rail over-voltage
5 UV	Ferrovia 5V sottu voltage
5 OV	5V rail over-voltage
12 UV	Ferrovia 12V sottu voltage
12 OV	12V rail over-voltage
OT	PCB over-temperature

Example
Per stabilisce e bandiere 5UV è OT:

Notes

1. Chjama sef senza parametri hè validu, è ùn stabilisce micca bandieri d'errore.
2. I bandieri d'errore ponu esse stallati cù sef nantu à qualsiasi pruduttu ancu s'è a bandiera ùn hè micca pertinente à u hardware.

3.20. statu (Lista statu portu)
Dopu chì un portu hè piazzatu in un modu particulari (per esempiu, u modu di carica) pò passà in una quantità di stati. U cumandamentu di u statu hè utilizatu per liste u statu di ogni portu. Mostra ancu l'attuale chì hè mandatu à u dispositivu, qualsiasi bandiera d'errore, è a carica profile impiegatu.
Sintassi: (vede Struttura di cumanda)[p] hè u numeru di portu.
Risposta: (vede a struttura di Risposta)
Paràmetri separati da virgola, una fila per portu.
Formatu di fila: p, current_mA, flags, profile_id, tempu_caricamentu, tempu_caricatu, energia

Parametru	Descrizzione
p	U numeru di portu pertinenti à a fila
current_mA	A currente esse furnita à u dispositivu mobile, in mA (milliamperes)
bandiere	Vede i tabelle sottu
profile_id T	L'unicu profile numeru ID. "0" s'ellu ùn hè micca carica o prufilu
tempu_caricamentu	Tempu in seconde chì u portu hè stata carica
tempu_caricatu	Tempu in seconde chì u portu hè statu fattu per (x significa micca validu ancu).
energia	Energia chì u dispusitivu hà cunsumatu in wattora (calculata ogni seconda)

Nota : Vede u manuale di u produttu per a risoluzione di misurazione attuale.
Bandiere per a gamma di firmware Universale

Lista di caratteri di bandiera sensible à u casu, siparati da spazii. O, S, B, I, P, C, F sò mutualmente esclusivi. A, D sò mutualmente esclusivi.
Bandiera	Descrizzione
O	U portu hè in modu OFF
S	U portu hè in modu SYNC
B	Port hè in modu Biased
I	Port hè in modu di carica, è hè IDLE

P	Port hè in modu di carica, è hè PROFILING
C	Port hè in modu di carica, è hè CARICA
F	U portu hè in modu di carica, è hà finitu a carica
A	U dispusitivu hè ATTACHED à stu portu
D	Nisun dispusitivu hè attaccatu à stu portu. U portu hè STANZATU
T	U dispusitivu hè statu arrubatu da u portu: THEFT
E	ERRORI sò prisenti. Vede u cumandamentu di salute
R	U sistema hà riavviatu. Vede u cumandamentu crf
r	Vbus hè stata resettata durante u cambiamentu di modu

Bandiere per a gamma di firmware PDSync è TS3-C10
3 bandieri sò sempre tornati per u firmware Powerync

Lista di caratteri di bandiera sensible à u casu, siparati da spazii. I bandieri ponu significà diverse cose in diverse colonne
1ª bandiera	Descrizzione
A	U dispusitivu hè ATTACHED à stu portu
D	Nisun dispusitivu hè attaccatu à stu portu. U portu hè STANZATU
P	Port hà stabilitu un cuntrattu PD cù u dispusitivu
C	U cable hà un connettore micca di tipu C à l'estremità distanti, nisun dispositivu rilevatu
2ª bandiera
I	U portu hè IDLE
S	Port hè u portu di l'ospite è hè cunnessu
C	U portu hè in carica
F	U portu hà finitu a carica
O	U portu hè in modu OFF
c	A putenza hè attivata nantu à u portu ma ùn hè micca rilevatu un dispositivu
3ª bandiera
_	U modu di carica rapida ùn hè micca permessu

+	U modu di carica rapida hè permessu ma micca attivatu
q	U modu di carica rapida hè attivatu ma micca in usu
Q	U modu di carica rapida hè in usu

Bandiere per a gamma di firmware di Motor Control
Caratteri di bandiera sensible à u casu. Unu di o, O, c, C, U serà sempre presente. T è S sò prisenti solu quandu a so cundizione hè rilevata.

Bandiera	Descrizzione
o	A porta hè aperta
O	A porta hè aperta
c	A porta si chjude
C	A porta hè chjusa
U	A pusizione di a porta hè scunnisciuta, nè aperta nè chjusa è ùn si move
S	Una cundizione di stallazione hè stata rilevata per questa porta quandu era l'ultima cumanda di spustà
T	Una cundizione di timeout hè stata rilevata per questa porta quandu era l'ultima cumanda di spustà. vale à dì chì u cancellu ùn hà micca finitu di muvimenti in un tempu raghjone nè stallò.

Examples
Un dispositivu cunnessu à u portu 5, chì carica à 1044mA cù profile_id 1Un altru dispusitivu attaccatu à u portu 8. Questu hè esse profiled usendu profile_id 2 prima di carica:Un errore di u sistema glubale rappurtatu da a bandiera EE:3.21. sistema (View paràmetri di u sistema)
À view paràmetri di u sistema, emette u cumandamentu di u sistema.
Sintassi: (vede Struttura di cumanda)Risposta: (vede a struttura di Risposta)
Prima fila: testu di u titulu di u sistema.
Righe successive: paràmetru: coppia di valori, una coppia per fila.

Parametru	Descrizzione	I valori pussibuli
Hardware	Numeru di parte
Firmware	Stringa di versione di firmware	In un furmatu "n.nn", n hè un numeru decimale 0..9
Cumpilatu	Ora è data di liberazione di u Firmware
gruppu	Lettera di gruppu letta da i ponti di PCB	1 caratteru, 16 valori: "-", "A" .. "O" "-" significa chì ùn hè micca installatu un jumper di gruppu
ID di u pannellu	U numeru ID di u pannellu di u pruduttu di u pannellu frontale	"Nisunu" se ùn hè statu rilevatu nisun pannellu Altrimenti "0" .. "15"
LCD	Presenza di display LCD	"Assente" o "Present" Se u pruduttu pò sustene un LCD

Notes

1. U testu di u titulu di u sistema pò cambià in e versioni di firmware.
2. U "Panel ID" hè aghjurnatu à l'accensione o reboot.
3. U paràmetru "LCD" pò diventà solu "Present" à l'accensione o riavvia. Pò esse "Assente" durante u run-time se u LCD ùn hè più rilevatu. Applicabile solu à i prudutti cù display amovibile.

3.22. bip (Fà un bip di u pruduttu)
Emette un bip per un tempu specificatu. U bip hè realizatu cum'è un travagliu di fondo - cusì u sistema pò processà altri cumandamenti mentre u bip hè pruduttu.
Sintassi: (vede Struttura di cumanda)

Parametru	Descrizzione
ms	a durata di u bip in millisecondi (range 0..32767)

Risposta: (vede a struttura di Risposta)Notes

1. U tempu [ms] hà una risoluzione di 10ms
2. Un bip ùn sarà micca interrotta da un bip più brevi o di lunghezza zero.
3. U bip da una alarme hè annullatu da u tonu cuntinuu da un cumandamentu bip. quandu u bip continuu cumpleta, u sistema tornerà à u bip di alarme.
4. Mandatu da u terminal pruvucarà un brevi bip per esse generatu.
5. I bip sò solu audibili nantu à i prudutti cù sirene.

3.23. clcd (Clear LCD)
A lcd hè sguassata usendu u cumandamentu clcd.
Sintassi: (vede Struttura di cumanda)Risposta: (vede a struttura di Risposta)

Notes

1. Questu hè applicabile solu à i prudutti dotati di display.

3.24. get_profiles (acquistà u portu profiles)
Per piglià u profiles assignati à un portu, utilizate u get_profiles cumanda. Per più infurmazione nantu à profiles vede Charging profiles
Sintassi: (vede Struttura di cumanda)p: hè u numeru di portu
Risposta: (vede Struttura di Risposta')
Port profiles sò listati è definiti s'ellu sò attivati ​​o disattivati
Example
Per piglià u profiles assignati à u portu 1:3.25. set_profiles (set port profiles)
Per assignà profiles à un portu individuale, utilizate u set_profiles cumanda. Per più infurmazione nantu à profiles vede Charging profiles
Sintassi: (vede Struttura di cumanda)

Parametru	Descrizzione
p	Numero di portu
cp	Carica profile

Per assignà tuttu u sistema profiles à un portu, issu set_profiles senza una lista di profiles.
Risposta: (vede a struttura di Risposta)Example
Per stabilisce profiles 2 è 3 per u portu 5:Per assignà tutti i profiles à u portu 8:

Notes

1. Utilizà get_profiles pè ottene una lista di profilehè stallatu nantu à ogni portu.

3.26. list_profiles (Lista globale profiles)
A lista di profiles pò esse acquistatu usendu u list_profiles command: Per più infurmazione nantu à profiles vede Charging profiles
Sintassi: (vede Struttura di cumanda)Risposta: (vede a struttura di Risposta)
Ogni profile listatu hà 2 paràmetri separati da una virgola: profile_id, enabled_flag.
U profile_id hè un numeru unicu chì currisponde sempre à un profile tipu. Hè un integer pusitivu chì principia da 1. A profile_id di 0 hè riservatu per quandu l'assenza di un profile hè da esse indicatu.
enabled_flag pò esse attivatu o disattivatu sicondu u profile hè attivu nantu à u pruduttu.
Example3.27. fr_profile (Attivà / disattivate profiles)
L'en_profile cumanda hè utilizatu per attivà è disattivà ogni profile. L'effettu s'applica à tutti i porti.
Sintassi: (vede Struttura di cumanda)

Parametru	Descrizzione	Valore
i	Profile paràmetru	vede u tavulu sottu
e	Attivà a bandiera	1 = attivatu 0 = disabilitatu

Profile paràmetru	Descrizzione
0	Algoritmu di carica intelligente chì selezziunà un prufessiunalefile 1-6
1	2.1A (Apple è altri cù tempu di rilevazione brevi)
2	BC1.2 Standard (Questu copre a maiò parte di i telefoni Android è altri dispositi)
3	Samsung
4	2.1A (Apple è altri cù longu tempu di rilevazione)
5	1.0A (Tipicamenti usatu da Apple)
6	2.4A (Tipicamenti usatu da Apple)

Risposta: (vede a struttura di Risposta)

Example
Per disattivà un profile per tutti i porti utilizate u cumandimu:Funzionamentu senza pro attivatufiles
Sè tutti profiles per un portu sò disattivati, u portu sarà transizione in u statu portu Biased. Questu permette a detezzione di u dispositivu attaccatu è staccate à u travagliu, ma ùn ci sarà micca carica. Sicurezza (deteczione di furtu) serà sempre operatu se tutti profiles sò disattivati, cum'è l'attache (AA) è staccate (DD) bandiere riportate da u cumandamentu statale.

Notes

1.  Stu cumanda hà un effettu immediata. Se u cumandamentu hè emessu mentre un portu hè prufilu, allora u cumandimu avarà un effettu solu se quellu profile ùn hè ancu ghjuntu.

3.28. chjavi (stati chjave)
U pruduttu pò esse furnitu cù finu à trè buttoni. Quandu un buttone hè pressatu, una chjave "cliccate" bandiera hè stabilita.
Questa bandiera ferma finu à ch'ella hè lettu. Per leghje i bandieri di cliccà chjave, utilizate u cumandimu di chjave. U risultatu hè una lista separata da virgola, cù una bandiera per chjave:
Sintassi: (vede Struttura di cumanda)

I tasti A, B è C sò elencati rispettivamente. Un '1' significa chì a chjave hè stata premuta da quandu u cumandamentu di e chjave hè stata chjamata l'ultima volta. I bandieri sò sbulicati dopu chì e chjave sò eseguite:
Notes

• U cumandamentu di e chjave funziona solu in modu remoto. Ùn funziona micca in modalità kexit remota
• Stu cumandimu funziona solu nantu à i prudutti cù i buttoni installati.

3.29. lcd (Scrivi à u LCD)
Se un LCD hè attaccatu, pò esse scrittu cù stu cumandamentu.
Sintassi: (vede 'Struttura di cumandamenti)

Parametru	Descrizzione
fila	0 hè a prima fila, 1 hè per a seconda fila
col	U numeru di a colonna, cuminciendu da 0
stringa	Affissatu nantu à u LCD. Puderia cuntene spazii prima, dentru è dopu.

Example
Per scrive "Hello, world" à l'estrema manca di a seconda fila:Visualizza icone
In più di i caratteri ASCII, u LCD pò visualizà parechje icone persunalizate. Quessi sò accessu mandendu a sequenza di scappata c, induve c hè u caratteru "1" .. "8":

c	Icona
1	Batteria vuota
2	Batteria animata continuamente
3	Cambrionix riempiva il glifo 'o'
4	Batteria piena
5	Luttu
6	Timer d'ova
7	Numeru persunalizatu 1 (allineatu à a diritta di u bitmap)
8	Numeru persunalizatu 1 (allineatu à mezu à u bitmap)

3.30. sec (securità di u dispositivu)
U pruduttu pò logà se un dispositivu hè statu cacciatu inaspettatamente da un portu. U cumandamentu sec pò esse usatu per mette tutti i porti in un statu di sicurità "armatu". Se un dispositivu hè sguassatu in u statu armatu, allora una alarma pò esse attivata, è a bandiera T hè mostrata.
Sintassi: (vede Struttura di cumanda)Risposta à nisun paràmetru: (vede Struttura di Risposta)Risposta à arm|disarm parameter: (vede a struttura di Risposta)Examples
Per armà u sistema:

Per disarmà u sistema:Per ottene u statu armatu:

Notes

• Se a rilevazione di u furtu hè necessariu, ma ùn hè micca desideratu micca a carica di u dispositivu o a sincronizazione, stabilisce i porti in u modu Biased. Sè aduprate u modu Biased è a bateria di u dispositivu si esaurisce allora l'alarma sarà risuscitata
• Per sguassate tutti i pezzi di furtu è silenziu una alarme chì sona, disarmate poi riarmate u sistema.

3.31. serial_speed (Imposta a velocità seriale)
Stabilisce a velocità seriale.
Sintassi: (vede Struttura di cumanda)

Parametru	Descrizzione
prova	Pruvate se u pruduttu supporta un aumentu di a velocità seriale da a velocità attuale
prestu	Aumentà a velocità seriale
lentu	Reduce a velocità seriale

Risposta: (vede a struttura di Risposta)

Risposta	Descrizzione
OK	U pruduttu sustene un aumentu di a velocità
Errore	U pruduttu ùn sustene micca un aumentu di a velocità

Duvete lavà u buffer seriale dopu u primu "serial_speed fast" prima chì a velocità hè cambiata à 1Mbaud. Se durante u funziunamentu à 1Mbaud, ogni errore seriale hè rilevatu, a velocità hè automaticamente cascata à 115200baud senza avvisu. U codice di l'ospiti deve esse cuscenti di questu è piglià l'azzione adattata. Se u ligame falla regularmente, ùn pruvate micca di aumentà a velocità di novu.
Example
Per aumentà a velocità seriale à 1 Mbaud, utilizate a sequenza seguente:Se ogni errore hè rilevatu in a sequenza sopra, l'aumentu di a velocità ùn si verificarà o serà resettatu.
Prima di esce da l'ospite, deve rinvià a velocità à 115200baud cù u cumandimu seguituIn casu di fà cusì, i primi caratteri saranu persi finu à chì u hub rileva a velocità di baud incorrecta cum'è errori seriali è torna à 115200baud.

3.32. set_delays (Imposta ritardi)
Stabilisce i ritardi interni
Sintassi: (vede Struttura di cumanda)

Parametru	Descrizzione	Valori predeterminati
port_reset_delay_ms	U tempu lasciatu senza putere quandu cambiate modi. (ms)	400
attach_blanking_ ms	A rilevazione di l'attache di u dispositivu di u tempu serà ritardata per evità un inserimentu rapidu è a rimozione. (ms)	2000
deattach_count	Riservatu per usu futuru.	30
deattach_sync_ count	Un valore numericu per stabilisce a prufundità di filtrà un avvenimentu di deattach in modu di sincronia	14

Risposta: (vede a struttura di Risposta)

Notes

• L'usu di stu cumandamentu pò impedisce a carica curretta.
• ADET_PIN dà un falsu pusitivu (mostra chì un dispositivu hè attaccatu quandu nimu hè presente). Resta in stu statu erratu per circa 1 secondu dopu avè lasciatu PORT_MODE_OFF.

3.33. boot (Intra in boot-loader)
U modu di boot hè utilizatu per aghjurnà u firmware in u hub. Ùn furnisce micca infurmazione publica nantu à l'usu di u hub in modu di boot.
Se truvate u pruduttu in u modu di boot, pudete turnà à u funziunamentu normale mandendu u cumandamentu di reboot o da u putere di u sistema.
Sintassi: (vede Struttura di cumanda)Risposta: (vede a struttura di Risposta)

3.34. porta (cumanda di porta)
U cumandamentu di a porta hè utilizatu per cuntrullà u muvimentu di e porte.
Sintassi: (vede Struttura di cumanda)

Parametru	Descrizzione
pusizioni	U cumandamentu di a porta desiderata (stop|open|close)
portu	O u numeru di portu o "tutti" per tutti i porti
forza	Un interu chì altera a velocità di u muvimentu (0-2047)

Risposta: (vede a struttura di Risposta)

3.35. proxy
Per distingue i cumandamenti destinati à u Cunsigliu di cuntrollu di u Motore da quelli per l'unità di l'ospite stessu, ci hè un "proxy" di cumandamentu di l'unità ospitante chì piglia cum'è argumenti i cumandamenti per u Cunsigliu di cuntrollu di u Motore.
L'utilizatore deve prefissà tutti i cumandamenti significati per u cuntrollu di u Motore cù "proxy" quandu sò mandati à l'interfaccia di linea di cumanda di l'unità host.
Sintassi: (vede Struttura di cumanda)3.36. interruttore à chjave
Per mustrà a pusizione attuale di l'interruttore di chjave emette u cumandamentu di l'interruttore di chjave.
Sintassi: (vede Struttura di cumanda)Risposta: (vede a struttura di Risposta)

Parametru	Descrizzione
Apertu	U keyswitch hè in a pusizione aperta.
Chjusu	U keyswitch hè in a pusizione chjusa.

3.37. rgb
U cumandamentu rgb hè utilizatu per stabilisce unu o più porti in u modu di override LED. Per stabilisce i livelli individuali di LED RGB in un portu, u portu deve esse prima stabilitu in u modu di override LED chì impedisce a mirroring di i LED di l'unità host in quellu portu. À l'entrata in u modu di override LED, i LED di quellu portu seranu tutti spenti.
Sintassi: (vede Struttura di cumanda)

Override parametru	Descrizzione
principià	Adupratu per entre in u modu di override RGB
lascià	Adupratu per esce da u modu di override

p hè u numeru di portu.
Risposta: (vede a struttura di Risposta)3.38. rgb_led
U cumandamentu rgb_led hè utilizatu per stabilisce i livelli LED RGB nantu à unu o più porti à u valore specificatu.
Sintassi: (vede Struttura di cumanda)

Override parametru	Descrizzione
p	Un portu unicu o una gamma di porti.
livellu	Un numeru hex di ottu cifre chì rapprisenta i livelli da stabilisce per i LED RGB. in u formatu 'aarrggbb'

paràmetri di livellu	Descrizzione
aa	Stabbilisce u livellu massimu per i LED in questu portu, l'altri LED sò tutti scalati da questa paràmetra
rr	Stabilisce u livellu per u LED Rossu
gg	Stabilisce u livellu per u LED verde
bb	Stabilisce u livellu per u LED Blue

Risposta: (vede Struttura di Risposta

3.39. stalla
U cumandamentu di stallazione hè utilizatu per stabilisce u currente à quale hè determinatu chì una porta hè stallata.
Sintassi: (vede Struttura di cumanda)

Parametru	Descrizzione
currente	U valore in mA chì serà utilizatu cum'è u livellu di corrente di u mutore sopra à quale hè determinatu chì una porta hè stallata.

Risposta: (vede a struttura di Risposta)

Errori

I cumandamenti falluti risponderanu cù un codice d'errore di a forma sottu.

"nnn" hè sempre un numeru decimale di trè cifre.
Codici d'errore di cumandamentu

Codice di errore	Nome di errore	Descrizzione
400	ERR_COMMAND_NOT_RECOGNISED	U cumandamentu ùn hè micca validu
401	ERR_EXTRANEOUS_PARAMETER	Troppu paràmetri
402	ERR_INVALID_PARAMETER	U paràmetru ùn hè micca validu
403	ERR_WRONG_PASSWORD	Password invalida
404	ERR_MISSING_PARAMETER	U paràmetru obligatoriu manca
405	ERR_SMBUS_READ_ERR	Errore di lettura di cumunicazione di gestione di u sistema internu
406	ERR_SMBUS_WRITE_ERR	Errore di scrittura di cumunicazione di gestione di u sistema internu
407	ERR_UNKNOWN_PROFILE_ID	Pro invalidufile ID
408	ERR_PROFILE_LIST_TOO_LONG	Profile lista supera u limitu
409	ERR_MISSING_PROFILE_ID	Pro necessariufile ID mancante
410	ERR_INVALID_PORT_NUMBER	U numeru di portu ùn hè micca validu per stu pruduttu
411	ERR_MALFORMED_HEXADECIMAL	Valore esadecimale invalidu
412	ERR_BAD_HEX_DIGIT	Cifra esadecimale invalida
413	ERR_MALFORMED_BINARY	Binariu invalidu
414	ERR_BAD_BINARY_DIGIT	Cifre binariu invalidu
415	ERR_BAD_DECIMAL_DIGIT	Cifra decimale invalida
416	ERR_OUT_OF_RANGE	Micca in un intervallu definitu
417	ERR_ADDRESS_TOO_LONG	L'indirizzu supera u limitu di caratteri
418	ERR_MISSING_PASSWORD	Manca a password necessaria
419	ERR_MISSING_PORT_NUMBER	Manca u numeru di portu necessariu

420	ERR_MISSING_MODE_CHAR	Manca u caratteru in modu necessariu
421	ERR_INVALID_MODE_CHAR	Carattere in modu invalidu
422	ERR_MODE_CHANGE_SYS_ERR_FLAG	Errore di sistema nantu à u cambiamentu di modu
423	ERR_CONSOLE_MODE_NOT_REMOTE	Modu remoto necessariu per u pruduttu
424	ERR_PARAMETER_TOO_LONG	U paràmetru hà troppu caratteri
425	ERR_BAD_LED_PATTERN	Un mudellu LED invalidu
426	ERR_BAD_ERROR_FLAG	Bandiera d'errore invalida

Example
Specificà un portu inesistente à u cumandamentu di modu:4.1. Errori fatali
Quandu u sistema scontra un errore fatale, l'errore hè signalatu immediatamente à u terminal in u seguente formatu:

"nnn" hè un numeru di riferimentu di errore di trè cifre.
"Spiegazione" descrive l'errore.
Quandu un errore fatale hè accadutu u CLI solu risponde à è . Se unu di questi sò ricevuti, u sistema entrerà in modu di boot. Se o ùn sò micca ricevuti in u periodu di timeout di watchdog (circa 9 seconde), allora u sistema riavviarà.

Impurtante
Se si verifica un errore fatale mentre un cumandamentu manda a o ENTER caratteru à u hub, allura u modu di boot sarà entrata. Se u pruduttu entra in u modu di boot allora avete bisognu di mandà u cumandamentu di reboot per vultà à u funziunamentu normale.
U modu di boot hè indicatu ricevendu a risposta sottu (inviata nantu à una nova linea) In u modu di boot, i cumandamenti chì ùn sò micca bootloader seranu risposti cù:Per scopi di prova, u modu di boot pò esse inseritu usendu u cumandamentu di boot.

Carica profiles

Quandu un dispositivu hè attaccatu à un hub, u pruduttu pò furnisce una varietà di diversi livelli di carica.
Ciascuna di queste variazioni differenti hè chjamata "pro".file'. Certi dispusitivi ùn vi carica bè, salvu prisintatu cù u pro currettufile. Un dispositivu chì ùn hè micca prisentatu cù un pro di caricafile ricunnosce tirarà menu di 500mA secondu e specificazioni USB.
Quandu un dispositivu hè attaccatu à u pruduttu, è hè in "modu di carica", prova ogni profile à u so tornu. Una volta tutti i profiles sò stati pruvati, u hub selezziunà u profile chì tirava a più alta corrente.
In certi casi, pò esse micca desiderate per u hub per scansà tutti i profiles in stu modu. Per esample, s'è solu i dispusitivi da un fabricatore sò attaccati, allura solu chì specifichi profile duverà esse attivu. Questu reduce u ritardu di tempu quandu un utilizatore attacca un dispositivu, è vede evidenza di u dispusitivu chì si carica bè.
U hub furnisce i mezi per limità u profiles pruvatu, sia à u livellu "globale" (in tutti i porti) è in una basa portu per portu.

Profile paràmetru	Descrizzione
0	Algoritmu di carica intelligente chì selezziunà un prufessiunalefile 1-6
1	2.1A (Apple è altri cù tempu di rilevazione brevi)
2	BC1.2 Standard (Questu copre a maiò parte di i telefoni Android è altri dispositi)
3	Samsung
4	2.1A (Apple è altri cù longu tempu di rilevazione)
5	1.0A (Tipicamenti usatu da Apple)
6	2.4A (Tipicamenti usatu da Apple)

Modi portu

I modi portu sò definiti da i cumandamenti "host" è "mode".

Carica	Turnate porti specifichi o tuttu u centru in modu di carica
Sincronizza	Turnate porti specifichi o tuttu u hub per u modu di sincronia (dati è canali di putenza aperti)
Biased	Detectà a presenza di un dispositivu ma ùn hà micca sincronizatu o carica.
Off	Accende o spegne porti specifichi o accende o spegne tuttu u hub. (senza putenza è senza canali di dati aperti)

Micca tutti i prudutti anu ogni modu dispunibule, verificate i manuali di l'utilizatori di u produttu individuali per i modi chì sò supportati.

Cuntrollu LED

Ci hè dui metudi per cuntrullà i LED in modu di cuntrollu remoto: ledb è leds. Prima, però, u funziunamentu di i LED serà discrittu.
U mudellu flash hè un byte di 8-bit. Ogni bit hè scansatu ripetutamente in sequenza da MSB à LSB (vale à dì da sinistra à diritta). Un bit '1' accende u LED, è un '0' spegne. Per esample, un mudellu di bit di decimali 128 (binariu 10000000b) avissi pulse u LED brevemente. Un mudellu di bit di decimale 127 (binariu 01111111b) vede u LED per a maiò parte di u tempu, solu spegnendu brevemente.

Carattere di mudellu	Funzione LED	Modellu di flash
0 (numeru)	Off	00000000
1	On continuamente (micca lampeggiante)	11111111
f	Flash veloce	10101010
m	Flash à velocità media	11001100
s	Flash lentamente	11110000
p	Pulsu unicu	10000000
d	Doppiu pulse	10100000
O (lettre majuscule)	Off (nessun cumandamentu remoto necessariu)	00000000
C	On (ùn hè necessariu un cumandamentu remoto)	11111111
F	Flash veloce (nessun cumandamentu remoto necessariu)	10101010
M	Velocità media flash (senza cumanda remota necessaria)	11001100
S	Flash lentamente (nessun cumandamentu remoto hè necessariu)	11110000
P	Impulsu unicu (nessun cumandamentu remoto necessariu)	10000000
D	Doppiu impulsu (nessun cumandamentu remoto necessariu)	10100000
R	Rilasciate "nessun cumandamentu remoto necessariu" LED torna à l'usu normale
x	senza cambià	senza cambià

In u modu automaticu, i valori predeterminati ponu esse vistu in a tavula sottu, alcuni prudutti ponu varià cusì per piacè vede i manuali di l'utilizatori di u produttu individuale per cunfirmà e funzioni LED.
www.cambrionix.com/product-user-manuals

Tipu di LED	Sensu	Cundizioni	Indicatore di Luce Indicatore
putenza	Power Off	● Soft power off (standby) o senza putenza	Off
putenza	Power On No Host Connected	● Power on ● Nisuna culpa cù u pruduttu	Verde
putenza	Power On Host Connected	● Power on ● Nisuna culpa cù u pruduttu ● Host cunnessu	Turchinu
putenza	Culpa cù u codice	● Cundizione di difettu maiò	Rossu lampeggiante (modulu di codice di errore)
Portu	Dispositivu Disconnected / Port Disabled	● Disconnected disconnected o portu disattivatu	Off
Portu	Micca pronta / Avvertimentu	● Resetting Dispositivu, principiatu, cambià u modu di funziunamentu o aghjurnamentu firmware	Ghjallu
Portu	Profiling Mode di carica	● Culpa cù u dispusitivu culligatu	Verde lampeggiante (on/off in intervalli di una seconda seconda)
Portu	Modu di carica Carica	● Port in modu di carica ● Dispositivu cunnessu è carica	Pulsazione verde (scura / si illumina in intervalli di una seconda)
Portu	Modu di carica Charged	● Port in modu di carica ● Dispositivu cunnessu, è u sogliu di carica incontra o scunnisciutu	Verde
Portu	Modu Sync	● Port in modu sync	Turchinu
Portu	Culpa	● Culpa cù u dispusitivu culligatu	Rossu

Impostazioni hub internu

8.1. Introduzione
I prudutti Cambrionix anu paràmetri interni chì sò usati per almacenà e paràmetri chì anu bisognu di mantene ancu dopu chì u pruduttu hà rimossu u putere. Questa sezione descrive cumu applicà i cambiamenti di l'impostazione di u hub internu cù u so effettu nantu à u pruduttu à u quale sò applicati.
Ci hè dui metudi per cambià i paràmetri di u produttu:

1. Ingressu i paràmetri di cumandamentu necessariu.
2. Cambia i paràmetri nantu à u LiveViewa so applicazione.

	ATTENZIONE
	A mudificazione di i paràmetri di u hub internu nantu à un pruduttu Cambrionix pò causà à u produttu à funziunà in modu incorrectu.

8.2. I paràmetri di u hub internu è u so usu currettu.
Note:

• Solu se un cumandamentu riesce, ci sarà una risposta visibile in a finestra di u terminal.
• U cumandimu settings_unlock deve esse inseritu prima di un cumandamentu settings_set o settings_reset

Paràmetru	Usu
paràmetri_ sbloccare	Stu cumandamentu sblocca a memoria per a scrittura. Stu cumandamentu deve precede direttamente settings_set è settings_reset. Ùn hè micca pussibule di cambià i paràmetri NV RAM senza inserisce stu cumandamentu.
settings_ display	Mostra i paràmetri NV RAM attuali in una forma chì pò esse copiata è incollata in u terminal seriale. Hè ancu utile per creà un .txt file copia di salvezza di i vostri paràmetri per riferimentu futuru.
paràmetri_ reset	Stu cumanda resetta a memoria torna à i paràmetri predeterminati. Stu cumandamentu deve esse precedutu da settings_unlock. I paràmetri esistenti sò visualizati prima di esse resettati. Solu s'è u cumandamentu riesce, ci sarà una risposta.
nome di a cumpagnia	Definisce u nome di a cumpagnia. U nome ùn pò micca cuntene '%' o '\'. A lunghezza massima di u nome hè 16 caratteri. Stu cumandamentu deve esse precedutu da settings_set
default_ profile	Stabilisce u pro predeterminatufile per esse usatu da ogni portu. hè una lista di spazii separati di i profile numeru da esse appiicata à ogni portu in ordine crescente. Specificà un profile di '0' per ogni portu significa chì ùn ci hè micca un pro predeterminatufile applicatu à quellu portu, questu hè u cumpurtamentu predeterminatu nantu à u reset. Tutti i porti devenu avè una entrata in a lista. Stu cumandamentu deve esse precedutu da settings_set 1 = Apple 2.1A o 2.4A se u pruduttu supporta a carica 2.4A (tempu di rilevazione breve). 2 = BC1.2 chì copre una quantità di dispusitivi standard. 3 = Samsung charging profile. 4 = Apple 2.1A o 2.4A se u pruduttu sustene a carica 2.4A (longu tempu di rilevazione). 5 = Apple 1A profile. 6 = Apple 2.4A profile.
remap_ porti	Stu paràmetru vi permette di mapà i numeri di porti nantu à i prudutti Cambrionix à i numeri di portu nantu à u vostru propiu pruduttu, chì ùn pò micca avè u listessu ordine numericu. Stu cumandamentu deve esse precedutu da settings_set
porti_on	Stabilisce un portu per esse sempre alimentatu indipendentemente da u statutu di attache. Questu deve esse usatu solu in cunghjunzione cù un pro predeterminatufile. hè una lista di bandieri separati da u spaziu per ogni portu in ordine crescente. Un '1' denota chì u portu serà sempre alimentatu. Un '0' denota un cumpurtamentu predeterminatu chì hè chì u portu ùn serà micca alimentatu finu à chì un dispositivu attaccatu hè rilevatu. Stu cumandamentu deve esse precedutu da settings_set
sync_chrg	"1" denota chì u CDP hè attivatu per un portu. CDP ùn pò esse disattivatu cù i prudutti ThunderSync. Stu cumandamentu deve esse precedutu da settings_set
charged_ threshold <0000>	Stabilisce u charged_threshold in passi 0.1mA deve avè i zeri principali per fà un numeru di quattru cifre. Stu cumandamentu deve esse precedutu da settings_set

8.3. Esamples
Per resettate un pruduttu Cambrionix à i valori predeterminati di fabbrica:À view i paràmetri attuali nantu à un pruduttu Cambrionix:Per cunfigurà un PowerPad15S per eseguisce in una manera simile à u pruduttu BusMan discontinuatu (vale à dì, ùn ci hè micca cambiamentu automaticu trà i modi di carica è di sincronia se un host hè cunnessu o disconnected)Per cambià a soglia di attache in un pruduttu Cambrionix à 30mAPer stabilisce u nome di a Cumpagnia è di u Produttu nantu à un pruduttu Cambrionix per currisponde à u vostru propiu (applicabile solu à i prudutti OEM): 

Prudutti supportati

Quì pudete truvà una tavula cù tutti i cumandamenti è per quale prudutti sò validi.

	U8S	U16S Spade	PP15S	PP8S	PP15C	SS15	TS2-16	TS3-16	TS3- C10	PDS- C4	ModIT- Max
bd	x	x	x	x	x	x	x	x	x	x	x
cef	x	x	x	x	x	x	x	x	x	x	x
cls	x	x	x	x	x	x	x	x	x	x	x
crf	x	x	x	x	x	x	x	x	x	x	x
salute	x	x	x	x	x	x	x	x	x	x	x
host	x	x	x	x		x	x	x	x	x	x
id	x	x	x	x	x	x	x	x	x	x	x
l	x	x	x	x	x	x	x	x	x	x	x
ledb	x	x					x	x	x	x	x
leds	x	x					x	x	x	x	x
limiti	x	x	x	x	x	x	x	x	x	x	x
scatula	x	x	x	x	x	x	x	x	x	x	x
modu	x	x	x	x	x	x	x	x	x	x	x
riavvia	x	x	x	x	x	x	x	x	x	x	x
luntani	x	x					x	x	x	x	x
sef	x	x	x	x	x	x	x	x	x	x	x
statu	x	x	x	x	x	x	x	x	x	x	x
sistema	x	x	x	x	x	x	x	x	x	x	x
bip	x	x	x	x	x	x	x	x	x	x	x
clcd	x	x					x
fr_profile	x	x	x	x	x	x	x	x			x
get_ profiles	x	x	x	x	x	x	x	x			x
chjavi	x	x					x
lcd	x	x					x

lista_ profiles	x	x	x	x	x	x	x	x			x
logc	x	x	x	x	x	x	x	x			x
sec	x	x					x
vitezza serial_	x	x	x	x	x	x	x	x			x
set_delays	x	x	x	x	x	x	x	x			x
set_ profiles	x	x	x	x	x	x	x	x			x
dettagliu	x	x	x	x	x	x	x	x	x	x	x
logp									x	x
putenza									x	x
qcmode										x
porta											x
interruttore à chjave											x
proxy											x
stalla											x
rgb											x
rgb_led											x

Tabella ASCII

dic	hex	utt	char	Ctrl char
0	0	000		ctrl-@
1	1	001		ctrl-A
2	2	002		ctrl-B
3	3	003		ctrl-C
4	4	004		ctrl-D
5	5	005		ctrl-E
6	6	006		ctrl-F
7	7	007		ctrl-G
8	8	010		ctrl-H
9	9	011		ctrl-I
10	a	012		ctrl-J
11	b	013		ctrl-K
12	c	014		ctrl-L
13	d	015		ctrl-M
14	e	016		ctrl-N
15	f	017		ctrl-O
16	10	020		ctrl-P
17	11	021		ctrl-Q
18	12	022		ctrl-R
19	13	023		ctrl-S
20	14	024		ctrl-T
21	15	025		ctrl-U
22	16	026		ctrl-V
23	17	027		ctrl-W
24	18	030		ctrl-X
25	19	031		ctrl-Y

26	1a	032		ctrl-Z
27	1b	033		ctrl-[
28	1c	034		ctrl-\
29	1d	035		ctrl-]
30	1e	036		ctrl-^
31	1f	037		ctrl-_
32	20	040	spaziu
33	21	041	!
34	22	042	“
35	23	043	#
36	24	044	$
37	25	045	%
38	26	046	&
39	27	047	‘
40	28	050	(
41	29	051	)
42	2a	052	*
43	2b	053	+
44	2c	054	,
45	2d	055	–
46	2e	056	.
47	2f	057	/
48	30	060	0
49	31	061	1
50	32	062	2
51	33	063	3
52	34	064	4
53	35	065	5

54	36	066	6
55	37	067	7
56	38	070	8
57	39	071	9
58	3a	072	:
59	3b	073	;
60	3c	074	<
61	3d	075	=
62	3e	076	>
63	3f	077	?
64	40	100	@
65	41	101	A
66	42	102	B
67	43	103	C
68	44	104	D
69	45	105	E
70	46	106	F
71	47	107	G
72	48	110	H
73	49	111	I
74	4a	112	J
75	4b	113	K
76	4c	114	L
77	4d	115	M
78	4e	116	N
79	4f	117	O
80	50	120	P
81	51	121	Q

82	52	122	R
83	53	123	S
84	54	124	T
85	55	125	U
86	56	126	V
87	57	127	W
88	58	130	X
89	59	131	Y
90	5a	132	Z
91	5b	133	[
92	5c	134	\
93	5d	135	]
94	5e	136	^
95	5f	137	_
96	60	140	`
97	61	141	a
98	62	142	b
99	63	143	c
100	64	144	d
101	65	145	e
102	66	146	f
103	67	147	g
104	68	150	h
105	69	151	i
106	6a	152	j
107	6b	153	k
108	6c	154	l
109	6d	155	m

110	6e	156	n
111	6f	157	o
112	70	160	p
113	71	161	q
114	72	162	r
115	73	163	s
116	74	164	t
117	75	165	u
118	76	166	v
119	77	167	w
120	78	170	x
121	79	171	y
122	7a	172	z
123	7b	173	{
124	7c	174	|
125	7d	175	}
126	7e	176	~
127	7f	177	DEL

Terminulugia

Terminu	Spiegazione
dispusitivi U8	Ogni dispusitivu in a sub-serie U8. Per esempiu, U8C, U8C-EXT, U8S, U8S-EXT
dispusitivi U16	Ogni dispusitivu in a sub-serie U16. Per esempiu U16C, U16S Spade
VCP	Port COM virtuale
/dev/	Directory di i dispositi in Linux® è macOS®
IC	Circuit integratu
PWM	Modulazione di larghezza di impulsu. U ciculu duty hè u percentuale di u tempu chì u PWM hè in u statu altu (attivu).
Modu di sincronizazione	Modu di sincronizazione (u hub furnisce una cunnessione USB à u computer host)
Portu	Socket USB in u fronte di u hub chì hè utilizatu per cunnette i dispositi mobili.
MSB	U più significativu
LSB	U pocu impurtante
Hub internu	RAM non volatile

Licenza

L'usu di Command Line Interface hè sottumessu à l'accordu di Licenza Cambrionix, u documentu pò esse scaricatu è viewed usendu u ligame seguente.
https://downloads.cambrionix.com/documentation/en/Cambrionix-Licence-Agreement.pdf

Usu di Marchi, Marchi Registrati, è altri Nomi Protetti è Simbuli
Stu manuale pò fà riferenza à marchi, marchi registrati, è altri nomi protetti è o simboli di cumpagnie di terze parti chì ùn sò micca ligati in alcun modu à Cambrionix. Induve si verificanu, sti riferimenti sò solu per scopi illustrativi è ùn rapprisentanu micca un appruvamentu di un pruduttu o serviziu da Cambrionix, o un appruvamentu di u pruduttu (s) à quale stu manuale si applica da a cumpagnia di terzu in quistione.
Cambrionix ricunnosce chì tutti i marchi, marchi registrati, marchi di serviziu, è altri nomi protetti è / o simboli cuntenuti in stu manuale è documenti cunnessi sò a pruprietà di i so rispettivi titulari.
"Mac® è macOS® sò marchi di Apple Inc., registrati in i Stati Uniti è in altri paesi è regioni".
"Intel® è u logu Intel sò marchi di Intel Corporation o di e so filiali".
"Thunderbolt™ è u logu Thunderbolt sò marchi di Intel Corporation o di e so filiali."
"Android™ hè una marca di Google LLC"
"Chromebook™ hè una marca di Google LLC."
"iOS™ hè una marca o marca registrata di Apple Inc, in i Stati Uniti è in altri paesi è hè utilizatu sottu licenza".
"Linux® hè a marca registrata di Linus Torvalds in i Stati Uniti è in altri paesi"
"Microsoft™ è Microsoft Windows™ sò marchi di u gruppu di cumpagnie Microsoft".
"Cambrionix® è u logo sò marchi di Cambrionix Limited."

© 2023-05 Cambrionix Ltd. Tutti i diritti riservati.

Cambrionix Limited
L'edificiu Maurice Wilkes
Cowley Road
Cambridge CB4 0DS
Regnu Unitu
+44 (0) 1223 755520
enquiries@cambrionix.com
www.cambrionix.com
Cambrionix Ltd hè una cumpagnia registrata in Inghilterra è Galles
cù u numeru di cumpagnia 06210854

Documenti / Risorse

Interfaccia di linea di comando Cambrionix 2023 [pdfManuale d'usu 2023 Command Line Interface, 2023, Command Line Interface, Line Interface, Interface

Referenze

• Manuale d'usu