Subsections


1.1 OPT_CPANEL

1.1.1 Introduction

This packet allows to connect up to four buttons to the serial port of the fli4l router. Pressing one key triggers a system command, for example halt or reboot. The buttons can be freely configured. There are 14 variations possible (theoretically there are 15 possibilities, but with the 15th the hardware does not work).

The power / status LED (LED2) glows green as soon as the circuit is ready. During processing a command, the LED blinks. LED1 can be freely configured (further details below).

1.1.2 Key Mapping

The keys match the following values:

If multiple keys are pressed simultaneously the values are added together. This gives the function number for the command.

The commands to be executed are inserted into these lines:: OPT_CPANEL_FUNKTION1='command' Some commands require the full pathname.

Some Examples:

fli4lctrl dial pppoe		Dial in into DSL
fli4lctrl hangup pppoe		Drop the DSL connection 
isdnctrl dial ippp0		Dial in into ISDN
isdnctrl hangup ippp0		Drop the ISDN connection
/sbin/reboot			Reboot router
/sbin/halt			Shutdown router

1.1.3 Configuring The Status Display

There are four possibilities to map the status LED.

DSL:

Determine and show only the DSL status.

ISDN:

Determine and show the ISDN status. All circuits are sumarized. If at least one ISDN circuit is online, the LED1 glows.

DSLISDN:

Determine and show both DSL and ISDN status of all circuits.

SCRIPT:

Establish an own query. Take care of the following:

Example:

This entry queries the DSL status:

echo off > /var/run/cpanel.status
fli4lctrl status | grep online >/dev/null && echo on > /var/run/cpanel.status
Hint: Use only if you know what you do. A faulty entry can cause that cpanel doesn't start at all or does not work as expected.

1.1.4 Troubleshooting

1.1.4.1 Hardware

If it doesn't work instantly, check your circuit. Take care of the right pins of your PC plug. If your router still has a 25 pin serial port the pinout is different to the one in the circuit drawing! If there is no error in your circuit, check the cable from your mainboard to the plug at the case. As there is no standard by the mainboard manufacturers there are different cables available. In doubt, check your mainboard user guide.

1.1.4.2 Software

First check if cpanel starts at boottime. Near the end of the boot should appear a message. You can look at the process list by typing 'ps ax' at the console. If there is no cpanel in the list, you probably configured in config/cpanel.txt the item OPT_CPANEL to 'no'. The graphics card could be a further source of errors. If you don't have a graphics card in your router, the first serial port (COM1) is used for the console. If so, you have to configure CPANEL_PORT='/dev/ttyS0' to '/dev/ttyS1'. Of course the circuit has to be connected to COM2.

1.1.5 Miscellaneous

Figure 1.1: Wiring Plan
Image schematic


Important: There is no liability of any kind for any damages!

Any problems, stories of success and suggestions for improvement may be posted to the newsgroup slpine.fli4l.opt.

Thank you for reading this documentation. Have fun with cpanel!

© 2001-2015 The fli4l-Team - 25 October 2015