1TWINSTAR(8)           User Contributed Perl Documentation          TWINSTAR(8)
2
3
4

NAME

6       twinstar - Control the Twinstar feature of a Xorcom Astribank
7

SYNOPSIS

9       twinstar {status|jump|enable-wd|disable-wd|ports}
10

DESCRIPTION

12       twinstar is a tool to control the Twinstar (dual USB port) of a Xorcom
13       Astribank. There is a single and mandatory argument which is the
14       command to run. That command operates on all the Astribanks connected
15       to the system.
16
17       Technically all the commands are implemented using Dahdi::Xpp::Mpp
18       which in turn uses astribank_tool. Thus using thus tool will require
19       root permissions or otherwise read/write permissions to the USB device.
20
21       The twinstar may be in watchdog mode, which means that it will jump to
22       the remote host if it loses contact with the local host. This can
23       happen if the machine is powered down or hangs or even if the xpp
24       drivers are unloaded. Which is why the standard twinstar scripts put
25       the Astribanks in twinstar mode on startup and remove it on normal
26       shutdown.
27
28       An Astribank will only jump to the other host (either if asked
29       explicitly or by the watchdog) only if there is a different Astribank
30       connected to the other port and running. Which is why all of this has
31       no effect on systems that don't need this functionality.
32
33       The command are:
34
35   status
36       Shows the current status of all Astribanks. Note that it only shows
37       Astribanks whose current active USB port is the one connected to this
38       computer.
39
40       Example output:
41
42        DEVICE          PORT       WATCHDOG        POWER0     POWER1
43        usb:001/010     0          on              yes        yes
44        usb:001/011     0          on              yes        yes
45
46       For each Astribank on the system that has Twinstar support we get:
47
48       Device
49           The address of the device. This is the bus address, e.g. the
50           address you see in lsusb / dahdi_hardware.
51
52       Port
53           The active USB port on the Astribank. This should be always '0' on
54           the master and always 1 on the slave.
55
56       Watchdog
57           on if the watchdog is triggered in the Atribank or off otherwise.
58
59       Power0, Power1
60           Shows which ports of this Astribank are connected to a USB port of
61           a running computer. This only shows whether or not the USB host
62           provides power.
63
64   ports
65       Shows the same 'Port' column of the status command.
66
67   jump
68       Command all the Astribanks to jump to the other port. This works
69       regardless the watchdog mode is enabled or not. But requires that there
70       is power on the other port.
71
72   enable-wd
73       Enables watchdog mode.
74
75   disable-wd
76       Disables watchdog mode.
77

FILES

79       twinstar mostly uses astribank_tool which in turn mostly uses USB files
80       under /dev/bus/usb .
81
82
83
84perl v5.32.0                      2020-07-27                       TWINSTAR(8)
Impressum