TinySHell - david-macmahon/wiki_convert_test GitHub Wiki
TinySHell is a minimalistic remote shell providing a command prompt. Its original authors presumably had other (non-radio astronomy) uses in mind, but it is GPL licensed, so members of the CASPER group stripped it down even further so that it would run on our radio astronomy hardware.
We only use TinySHell on IBOBs, since later boards all run a full-featured Debian GNU/Linux operating system. For information on controlling IBOBs with TinySHell, see Interacting with CASPER Instruments.
From the source website:
- This is a lightweight client/server clone of the standard remote shell tools (rlogin, telnet, ssh), which can act as a backdoor and provide remote shell execution as well as file transfers. It is 8-bit clean, has full support for pseudo-terminal pairs (pty/tty), and uses strong 128-bit AES encryption. Tiny SHell can also operate in "connect-back" (aka, "reverse-connect") mode in order to bypass firewalls that block incoming connections.
There are really only two things to remember about TinySHell.
? list all available commands
<CMD> ? display help specifically for CMD
Everything else can be derived from there.
Board control commands:
IBOB % ?
help display help
clkmeasure measure the frequency of the user clock
clkreset reset the DLL on the user clock
clkphase set the phase of the DLL on the user clock
listdev lists the devices available in the design
read reads words from memory
write writes data to memory
readb reads words from memory using base address
writeb writes data to memory using a base address
setb sets a base address
adcreset resets an ADC board
adcsetreg sets the value of an ADC register
adcgetphase get the clock phase between the two ADCs
bramwrite writes a value in a bram
bramread reads a value from a bram
bramdump dumps the content of a bram
ifconfig Displays network interface configuration
regwrite writes the value of a register
regread reads the value of a register
tengbinfo retreives the current parameters of a core
Shell meta-commands:
IBOB % help
? display help on given or available commands
<TAB> auto-completion
<cr> execute command line
CTRL-P recall previous input line
CTRL-N recall next input line
<any> treat as input character
number format :
123 : integer
0x7b : hexadecimal (x7b is also accepted)