5.5. Devices

5.5. Devices
	Chapter 5. Command language

5.5.1. D DEV (Display Devices)

This command shows cards and hardware devices configured and their state (active/inactive).

[11:38:04] ABILIS_CPX:d dev

--------------- Active Watchdog and MFxx Resources (read only): ---------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
MF          Yes Mf . . . . . . . . . . . . . . . . . . . . .      -  AC00   19
MFIO        No  MfIo . . . . . . . . . . . . . . . . . . . .      -  AC00   19

------------------ Active PCI Devices and Physical Resources: -----------------
Device(s)   Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
ASY-1       Yes Async-1  . . . . . . . . . . . . . . . . . .      -   3F8    4
ETH-1       Yes Eth-1  . . . . . . . . . . . . . . . . . . .     64  PCIe ( 18)
ETH-2       Yes Eth-2  . . . . . . . . . . . . . . . . . . .     96  PCIe ( 17)
ETH-3       Yes Eth-3  . . . . . . . . . . . . . . . . . . .    128  PCIe ( 16)
BRI4-2      Yes 35..38 . . . . . . . . . . . . . . . . . . .    161   PCI ( 22)
POTS-1      Yes 101..116 . . . . . . . . . . . . . . . . . .    160   PCI ( 21)
POTS-2      Yes 117..132 . . . . . . . . . . . . . . . . . .    162   PCI ( 23)
VPOTS-5     Yes 165..180 . . . . . . . . . . . . . . . . . .      -     - (  -)
CELL32-1    Yes 501..532 . . . . . . . . . . . . . . . . . .      -     - (  -)

------------------ Active USB Devices and Physical Resources: -----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
UPS-1       Yes No  Ups  . . . . . . . . . . . . . . . . . NONE
DSLUSB-1    Yes Yes Dsl-1  . . . . . . . . . . . . . . . . 0.2
CELLBOX-1           501..502 . . . . . . . . . . . . . . .
 CELL-1     Yes Yes .  . . . . . . . . . . . . . . . . . . 1.1.0
 CELL-2     Yes Yes .  . . . . . . . . . . . . . . . . . . 1.1.1
 CODEC-1    Yes Yes .  . . . . . . . . . . . . . . . . . . 1.1.2
 CONTROL-1  Yes Yes .  . . . . . . . . . . . . . . . . . . 1.1.3
GPIO-1      Yes Yes Gpio-1 . . . . . . . . . . . . . . . . 3.1
GPIO-2      Yes No  Gpio-2 . . . . . . . . . . . . . . . . 6.0
BLUSB-1     Yes No  Blusb-1  . . . . . . . . . . . . . . . -


-------------- Inactive Watchdog and MFxx Resources (read only): --------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE WATCHDOGs PRESENT ***

----------------- Inactive PCI Devices and Physical Resources: ----------------
Device(s)   Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE PCI CARDs PRESENT ***

----------------- Inactive USB Devices and Physical Resources: ----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
CELLBOX-2           503..504 . . . . . . . . . . . . . . .
 CELL-3     No  No  .  . . . . . . . . . . . . . . . . . . 1.1.0
 CELL-4     No  No  .  . . . . . . . . . . . . . . . . . . 1.1.1
 CODEC-2    No  No  .  . . . . . . . . . . . . . . . . . . 1.1.2
 CONTROL-2  No  No  .  . . . . . . . . . . . . . . . . . . 1.1.3

To view a specified HW device (e.g. BRI4-2), type following command:

[11:36:58] ABILIS_CPX:d dev:bri4-2

Parameter:    | Value:
--------------+----------------------------------------------------------------
DEV:            BRI4-2
TYPE:           PCI                                                 <Read Only>
RUN:            YES                                                 <Read Only>
CTIP:           35..38                                              <Read Only>
SLOTID:         161
IRQ:            (22)
DSP0...DSP3:    ENABLED    ENABLED    ENABLED    ENABLED    
DSP4...DSP7:    ENABLED    ENABLED    ENABLED    ENABLED    
DSP8...DSP11:   ENABLED    ENABLED    ENABLED    ENABLED    
DSP12..DSP15:   ENABLED    ENABLED    ENABLED    ENABLED    
-------------------------------------------------------------------------------

5.5.1.1. D PCIDEV (Display PCI Devices)

It displays information about PCI devices currently present and active in the system.

[11:38:04] ABILIS_CPX:d pcidev

PCI Server Overview:

ID Vendor          Device                    CardName         Slot/F   Ver Irq
-------------------------------------------------------------------------------
0  1106 VIA        3123 BRIDGE HOST                              0/0  0.00   -
1  1106 VIA        B091 BRIDGE PCI NORMAL                        1/0  0.00   -
2  3388 HINT CORP  0021 BRIDGE PCI NORMAL                        8/0  1.05   -
3  104C TEXAS INST AC56 BRIDGE CARDBUS                           9/0  0.00  15
4  1106 VIA        3038 USB HOST UHCI                           16/0  8.00  15
5  1106 VIA        3038 USB HOST UHCI                           16/1  8.00  11
6  1106 VIA        3038 USB HOST UHCI                           16/2  8.00  12
7  1106 VIA        3104 USB HOST EHCI                           16/3  8.02  10
8  1106 VIA        3177 BRIDGE ISA                              17/0  0.00   -
9  1106 VIA        0571 STORAGE IDE                             17/1  0.06 255
10 1106 VIA        3059 MULTIMEDIA AUDIO                        17/5  5.00  12
11 1106 VIA        3065 NETWORK ETHERNET     ETH-VT6102         18/0  7.04  15
12 1106 VIA        3122 DISPLAY VGA                             32/0  0.03  15
13 10EC REALTEK    8139 NETWORK ETHERNET     ETH-RTL8139        72/0  1.00  15
14 10EC REALTEK    8139 NETWORK ETHERNET     ETH-RTL8139        73/0  1.00  11
15 10B5 PLX TECHNO 9030 NETWORK OTHER        CTI-BSE17 4-2-32   74/0  2.00  12
16 1283 ITE        8872 NETWORK OTHER        MFPCIGT            75/0  0.01  10

Tip

Interesting chapters:

Section 2.9, “Abilis PCI boards and extension boards”;

Section 73.9.1, “How to recognize PCI cards model”.

5.5.1.1.1. D PCIDEVE (Display PCI Devices, extended)

It displays extended information about PCI devices, including Bus type (BT) and Abilis Device (DEV:).

[13:09:00] ABILIS_CPX:d pcideve

PCI Server Overview:

ID Vendor          Device                    CardName         Slot/F   Ver Irq    B/D/F BT   DEV:
--------------------------------------------------------------------------------------------------------
0  8086 INTEL      29A0 BRIDGE HOST                              0/0  0.02   -    0/0/0 -    -
1  8086 INTEL      2834 USB HOST UHCI                           26/0  0.02  16   0/26/0 -    -
2  8086 INTEL      2835 USB HOST UHCI                           26/1  0.02  21   0/26/1 -    -
3  8086 INTEL      283A USB HOST EHCI                           26/7  0.02  18   0/26/7 -    -
4  8086 INTEL      284B AUDIO DEVICE                            27/0  0.02  22   0/27/0 -    -
5  8086 INTEL      283F BRIDGE PCI NORMAL                       28/0  0.02  17   0/28/0 -    -
6  8086 INTEL      2830 USB HOST UHCI                           29/0  0.02  23   0/29/0 -    -
7  8086 INTEL      2831 USB HOST UHCI                           29/1  0.02  19   0/29/1 -    -
8  8086 INTEL      2832 USB HOST UHCI                           29/2  0.02  18   0/29/2 -    -
9  8086 INTEL      2836 USB HOST EHCI                           29/7  0.02  23   0/29/7 -    -
10 8086 INTEL      244E BRIDGE PCI SUBTR.                       30/0 15.02   -   0/30/0 -    -
11 8086 INTEL      2810 BRIDGE ISA                              31/0  0.02   -   0/31/0 -    -
12 8086 INTEL      2820 STORAGE IDE                             31/2  0.02  19   0/31/2 -    -
13 8086 INTEL      283E SMBUS                                   31/3  0.02  18   0/31/3 -    -
14 8086 INTEL      2825 STORAGE IDE                             31/5  0.02  19   0/31/5 -    -
15 1106 VIA        3403 IEEE 1394 OHCI                          32/0  0.00  19    1/0/0 -    -
16 1106 VIA        0415 STORAGE IDE                             32/1 10.00  19    1/0/1 -    -
17 10EC REALTEK    8168 NETWORK ETHERNET     ETH-RTL8168/8111   64/0  0.03  18    2/0/0 PCIe ETH-1
18 10EC REALTEK    8168 NETWORK ETHERNET     ETH-RTL8168/8111   96/0  0.07  17    3/0/0 PCIe ETH-2
19 10EC REALTEK    8168 NETWORK ETHERNET     ETH-RTL8168/8111  128/0  0.07  16    4/0/0 PCIe ETH-3
20 1283 ITE        8872 SERIAL 16550         CTI-POTS          160/0  0.01  21    5/0/0 PCI  POTS-1
21 10B5 PLX TECHNO 9050 BRIDGE OTHER         CTI-HFC3-4P       161/0  0.02  22    5/1/0 PCI  BRI4-2
22 1283 ITE        8872 NETWORK OTHER        CTI-POTS          162/0  0.01  23    5/2/0 PCI  POTS-2

5.5.1.2. D USBDEV (Display USB Devices)

It displays information about USB devices currently active and connected to Abilis.

[11:38:04] ABILIS_CPX:d usbdev

USB Server Overview:

ID  VendorId/Manufacturer     ProductId/Product                Ver Sp UsbPortId 
-------------------------------------------------------------------------------
1   0000 On Time              0000 EHCI Virtual Root Hub      0.00 -  0         
2   0000 On Time              0000 EHCI Virtual Root Hub      0.00 -  1         
3   0000 On Time              0000 UHCI Virtual Root Hub      0.00 -  2         
4   0000 On Time              0000 UHCI Virtual Root Hub      0.00 -  3         
5   0000 On Time              0000 UHCI Virtual Root Hub      0.00 -  4         
6   0000 On Time              0000 UHCI Virtual Root Hub      0.00 -  5         
7   0000 On Time              0000 UHCI Virtual Root Hub      0.00 -  6         
8   1E0E Android              9001 Android                    2.28 H  1.5       
9   1E0E Android              9001 Android                    2.28 H  0.1       
10  04D8 Abilis               000C USB IO-BOX                 3.01 F  3.1  
11  0B95 ASIX Elec. Corp.     772B AX88772B                   0.01 H  1.0 
12  0B95 ASIX Elec. Corp.     1790 AX88179                    1.00 S  0.9

The speed can be:

S = Superspeed (5 or 10 Gbps);

H = High Speed (480 Mbps);

F = Full Speed (12 Mbps);

L = Low Speed (1.5 Mbps).

Tip

Interesting chapter:

Section 2.10, “USB devices”.

5.5.2. A DEV (Add Device)

This command adds a new card or a new device in the configuration. Device identifier must be indicated in the form: “type-nnn”, where: “type” has to be one of the device's mnemonics that are allowed by the system (e.g. ETH, ESB, etc); “nnn” must be a digit in the interval [1 - 255].

[16:32:01] ABILIS_CPX:a dev: ?

A DEV:type-n                  Add CPX HW device of the selected type
A DEV:type-n CTIP-NUM:val     Add a CTI card, setting active only the
                              specified number of CTI ports.
                              By default, all ports are set active.

DEV:       HW device identifier 'type-n', where 'n' can be [1..255] <Mandatory>
CTIP-NUM:  Number of CTI ports to be set active [1..40]              <Optional>

Available hardware device's types:

- PCI devices:
  BRI4     4 Basic Rate (BRI).
  BRI8     8 Basic Rate (BRI).
  QPRI     4 E1 Primary Rate (PRI).
  PB22     2 PRI and 2 BRI.
  PB44     4 PRI and 4 BRI.
  CTIHA    Card for HDLC controllers and DSPs. No PRI, no BRI.
  POTS     Up to 16 POTS interfaces for analog telephones.
  POTSHUB  4 ELTI for up to 4 POTSBOX (total up to 128 POTS).
  POTSBOX  Up to 32 POTS via 1 ELTI.
  VPOTS    Up to 16 PCPHONE clients.
  BSE      8 BRI and up to 40 POTS (on board and/or ELTI).
  ESB      From 1 to 4 synchronous serial ports.
  ASY      Asynchronous serial port.
  ETH      Ethernet 10/100/1000 Mbit/sec.
  CELL32   Fake device for 32 CELL devices (GSM, UMTS, LTE).
- USB devices:
  UPS      Uninterruptable Power Supply device.
  ETHUSB   USB Ethernet.
  DSLUSB   DSL modem with USB interface.
  ASYNCU   Asynchronous serial USB device.
  CELL     UMTS or GSM device.
  CODEC    Audio codec for every 2 UMTS or GSM devices.
  CONTROL  Device that controls and supervises the CELLBOX components.
  CELLBOX  Container device for 2 CELL, 1 CODEC, 1 CONTROL.
  CELLKEY  GSM/UMTS/LTE standalone device.
  RJS      RJ45 Switchboard USB device.
  GPS      GPS USB device.
  GPIO     General purpose input/output USB device.
  BLUSB    USB Boot Loader device.

For example, to add a POTS card:

[16:59:21] ABILIS_CPX:a dev:pots-1

COMMAND EXECUTED

Tip

Adding an ISDN card (QPRI, BRI8, BRI4, POTS,…) or synchronous card (ESB), also the correlated ports will be activated.

[23:59:39] ABILIS_CPX:a dev:bri4-1

COMMAND EXECUTED

[23:59:50] ABILIS_CPX:d dev

- Not Saved (SAVE CONF) -------------------------------------------------------
--------------- Active Watchdog and MFxx Resources (read only): ---------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
MF          Yes Mf . . . . . . . . . . . . . . . . . . . . .      -  AC00   19
MFIO        No  MfIo . . . . . . . . . . . . . . . . . . . .      -  AC00   19

---------------- Active PCI Cards and Physical Resources: --------------------
Card(s)    Run Physical Resource(s)/CTI Port(s)              SlotId  Addr  Irq
-------------------------------------------------------------------------------
ASY-1      Yes Async-1  . . . . . . . . . . . . . . . . . . .     -   3F8    4
ETH-1      Yes Eth-1 . . . . . . . . . . . . . . . . . . . . . .  8   PCI ( 12)
BRI4-1     No  31..34 . . . . . . . . . . . . . . . . . . . .  NONE   PCI (  -)
POTS-1     Yes 101..116 . . . . . . . . . . . . . . . . . . .    10   PCI ( 12)

------------------ Active USB Devices and Physical Resources: -----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
ETHUSB-1    Yes Yes EthUsb-1 . . . . . . . . . . . . . . . 0.4
UPS-1       Yes No  Ups  . . . . . . . . . . . . . . . . . NONE
DSLUSB-1    Yes No  Dsl-1  . . . . . . . . . . . . . . . . 0.1
CELLKEY-1   Yes No  501  . . . . . . . . . . . . . . . . . 0.0


-------------- Inactive Watchdog and MFxx Resources (read only): --------------
Device(s)   Run Physical Resource(s)                         SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE WATCHDOGs PRESENT ***                     

----------------- Inactive PCI Devices and Physical Resources: ----------------
Device(s)   Run Physical Resource(s) or CTI Port(s)          SlotId  Addr  Irq
-------------------------------------------------------------------------------
                     *** NO INACTIVE PCI CARDs PRESENT ***                     

----------------- Inactive USB Devices and Physical Resources: ----------------
Device(s)   Run Con Physical Resource(s) or CTI Port(s)    USBPORTID
-------------------------------------------------------------------------------
                    *** NO INACTIVE USB DEVICEs PRESENT ***    

[23:59:54] ABILIS_CPX:d p ctip:31

CTIP:31  - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Act     DESCR:
        card:BRI4-1<1>                  USER:#
        OPSTATE:UP        LOG:NO        side:TE      LINE:MP   TYPE:USER
        signalling:DSS1   TEI:STANDARD  HOLD:NO                SS:NO 
        mode:Bri          L12-ACT:UP    BUS:SHORT    
        NUM:*                           ADDRBOOK-NUM:NUM
        BCHANS:ALL-BID

	Tip
	The “Not Saved (SAVE CONF)” message is displayed every time the configuration is modified but not saved with the save conf command. The “Not Refreshed (INIT)” message is displayed every time the port configuration is modified but not refreshed with the init ctisys command. These messages will disappear after save conf or init ctisys commands.

5.5.3. S DEV (Set Device)

This command sets one or more configuration parameters of the specified device to the specified value.

For PCI devices, the command allows the user to set the PCI slot identifier of the board (SLOTID parameter) or to enable/disable a DSP (DSP0:..DSP15).

For ISA devices, the command sets the memory address (ADDR parameter) and interrupt (IRQ parameter) of the device.

For USB devices, the command allows the user to set the USB port identifier of the device, i.e. USBPORTID parameter.

[17:30:52] ABILIS_CPX:s dev: ?

S [P[E]] DEV:type-n par:val [par:val]             Set the parameter(s) of the
                                                  specified HW device

DEV:       HW device identifier 'type-n', where 'n' can be [1..255] <Mandatory>

HW device's parameters:

ADDR:              Base Address value                                <ASY only>
IRQ:               Interrupt value                                   <ASY only>
SLOTID:            Slot Id value [0..65534, NONE = Unassigned]       <PCI only>
USBPORTID:         Port Id value: from 1 up to 7 decimal values in the range
                   [0..14] joined by '.' (dot) or "NONE" (i.e. Unassigned)
                                                                     <USB only>
DSP0:..DSP15:      Enable/disable DSP [ENABLED, DISABLED]            <PCI only>

	Tip
	Interesting chapter: Section 73.10, “How to automatically reassign the USBPORTID”.

If you have a bad DSP, but your CTI card has more DSP, type the following command to disable a DSP.

[12:54:58] ABILIS_CPX:s dev:bri4-2 dsp0:disabled

COMMAND EXECUTED 

[12:55:03] ABILIS_CPX:d dev:bri4-2

- Not Saved (SAVE CONF) -------------------------------------------------------
Parameter:    | Value:
--------------+----------------------------------------------------------------
DEV:            BRI4-2
RUN:            YES                                                 <Read Only>
CTIP:           35..38                                              <Read Only>
SLOTID:         161
CUR-SLOTID:     161                                                 <Read Only>
CUR-ADDR:       PCI                                                 <Read Only>
CUR-IRQ:        (22)                                                <Read Only>
DSP0...DSP3:    DISABLED   ENABLED    ENABLED    ENABLED    
DSP4...DSP7:    ENABLED    ENABLED    ENABLED    ENABLED    
DSP8...DSP11:   ENABLED    ENABLED    ENABLED    ENABLED    
DSP12..DSP15:   ENABLED    ENABLED    ENABLED    ENABLED    
------------------------------------------------------------------------------

	Warning
	To have a running card/resource or activate the changes made on the card/resource, it's needed to save the configuration (use the command save conf ) and restart the system (use the command warm start ).

	Tip
	Interesting chapter: Section 5.15.4, “DSPs test”.

5.5.4. C DEV (Clear Device)

This command allows to delete a device present in Abilis. A device, before being deleted, must be inactive. To inactive a device type the command s inact dev: and reboot the Abilis with the command warm start.

For example:

[12:45:38] ABILIS_CPX:c dev:bri4-1

COMMAND NOT ALLOWED FOR THAT DEVICE, BECAUSE IT IS RUNNING

[12:45:38] ABILIS_CPX:s inact dev:bri4-1

COMMAND EXECUTED

After Abilis restart, it's possible to delete the device.

[18:17:04] ABILIS_CPX:c dev:bri4-1

THE SELECTED DEVICE AND THE RELATED PHYSICAL RESOURCE(s) WILL BE DELETED.
PROCEED (N/Y)?y

PROCEEDING WITH DEVICE DELETION...

COMMAND EXECUTED


5.4. System accessing commands		5.6. Resources or Ports