Tahoe WAN PCI Card configuration using the sethdlc utility

The sethdlc utility is used to configure the Tahoe WAN PCI Card. After downloading the archive, you should unpack it, compile and install:

root@linux /usr/src # tar -zxvf sethdlc-1.16t.tar.gz
root@linux /usr/src # cd sethdlc-1.16t
root@linux /usr/src/sethdlc-1.16t # make
root@linux /usr/src/sethdlc-1.16t # make install

Now you can select the protocol used on the WAN link:

• transparent HDLC:
  sethdlc hdlc0 hdlc [encoding] [parity]
  
  where:
  • encoding is one of: nrz, nrzi, fm-mark, fm-space, manchester
  • parity: no-parity, crc16, crc16-pr0, crc16-itu, crc16-itu-pr0, crc32-itu

• HDLC treated as an Ethernet interface:
  sethdlc hdlc0 hdlc-eth [encoding] [parity]
  
  parameters same as above

• Cisco^®HDLC:
  sethdlc hdlc0 cisco [interval value] [timeout value]
  
  where:
  • interval value is the time between subsequent keepalive packets sent through the interface
  • timeout value is the time, after which in case of no reception of keepalive frames the link is treated as unusable

• Frame Relay:
  sethdlc hdlc0 fr [lmi type [parameter]]
  
  where:
  • type is the LMI type: none, ansi, ccitt
  • parameter is a Frame Relay protocol parameter: dce, t391 value, t392 value, n391 value, n392 value, n393 value
  Moreover in case of Frame Relay protocol you can create and delete PVCs (Permanent Virtual Channels) with given DLCI values:
  sethdlc hdlc0 create 99
  sethdlc hdlc0 delete 99
  After creating a PVC, a new interface is created - pvc0, pvc1 and so on.

• Synchronous PPP:
  sethdlc hdlc0 ppp
  

In case of Tahoe 971/972 cards you also have to specify, which timeslots are used for transmission. Timeslots can be given in two ways - as a list of numbers (from 1 to 32) and ranges separated by commas or as a string of zeros and ones (where '0' means an unused slot and '1' - an used one, with the first slot at the beginning of the string):

• sethdlc hdlc0 slotmap 2-8,20-21,25
  
• sethdlc hdlc0 slotmap 01111111000000000001100010000000
  

Use of the first timeslot automaticaly enables unframed mode, where whole 2048 kbps are used for data transfer. Otherwise the first timeslot is used for framing synchronization.

The command below enables and disables, respectively, transmission of the CRC4 checksum:

• sethdlc hdlc0 crc4 on
  
• sethdlc hdlc0 crc4 off
  

• sethdlc hdlc0 short
  
• sethdlc hdlc0 long
  

After configuring a card using the sethdlc utility you can proceed to regular interface configuration (using hdlc0, hdlc1 or pvc## interfaces), routing setup, etc.

Return to the beginning