1. Introduction
------------

Dropbear is a small SSH2 Server and Client running on
a variety of POSIX-based platforms. It has been
mainly developped by Matt Johnston 
(see http://matt.ucc.asn.au/dropbear/dropbear.html).

PSPSSH is a port on PSP of the version 0.48.1. The
terminal Vt100 emulation part of PSPSSH is based on
the work of Danzel for his Telnet client for PSP.

Many thanks to Matt Johnston for this nice SSH
client, thanks to Danzel for his Virtual kerboard and
his Vt100 stuff and to all PSPSDK developpers.

This software is distributed under several
open-source/free software licenses, such as MIT/X
Consortium License, and some other part are
distributed under GNU V2 License. 

Special thanks to Delight1 for her feedback. 

Big thanks to NeXuS for his very nice music !


2. Control
------------

2.1 - Virtual keyboard

In the console window, press Start to open/close
the On-Screen keyboard

The On-Screen Keyboard of "Danzel" and "Jeff Chen"

Use Analog stick to choose one of the 9 squares, and
use Triangle, Square, Cross and Circle to choose one
of the 4 letters of the highlighted square.

2.2 - IR keyboard

You can also use IR keyboard. Edit the pspirkeyb.ini
file to specify your IR keyboard model, and modify
eventually layout keyboard files in the keymap
directory.

The mapping is the following in PSPSSH menus  :

IR-keyboard   PSP

  Cursor        Digital Pad

  Tab           Start
  Ctrl-W        Start

  Escape        Select
  Ctrl-Q        Select

  Ctrl-E        Triangle
  Ctrl-X        Cross
  Ctrl-S        Square
  Ctrl-F        Circle
  Ctrl-Z        L-trigger
  Ctrl-C        R-trigger

  Ctrl-L        Clear


3. How does-it work ?
------------

3.1 - Generate random seed 

The first time you launch PSPSSH, you will have to
press PSP keys randomly, to generates random numbers
that would be stored in file (random.bin). 
Those numbers will then be used for your ssh
connections.

After choosing your wifi access point in the "Wifi
connection" menu, you will then have to enter ssh
connection parameters :
 
3.2 - Create a connection with user/password :

Host : The name of the host you want to connect to

User / Password : The login and password for this
connection

Port : By default it's set to 22, which is the
standard SSH port but you can change it.

All those parameters can be easily entered using the
Virtual Keyboard (Press Start to display the
keyboard)

You can save your parameters in a binary encoded file
if you want using the "Save" menu.

3.3 - Create a connection with rsa key pairs :

If you prefer to use RSA keys/pair authentication,
you can put your binary rsa key file id_rsa
(generated by the dropbear tool called dropbearkey
for exampel), in the ssh directory of PSPSSH. 
Then you have to add the public ascii key in the
authorized_keys file on the server side. 
(please have a look to the dropbear, or any ssh
clients for details).

Enter the host, user and password (using a rubbish
password if you want, because it won't be used, but
it can't be empty).

Then enable the option "Local id_rsa key". You will
then able to connect to host using your id_rsa key
file.

3.4 - Connect to the server

Then you can connect to the host you've specified
using the "Connect" menu.

If everything is going right, you should see a
console with a shell prompt few seconds after.

3.5 - Enter commands in the console window

In the console window you can use the Virtual
Keyboard to enter unix command. 

When the Virtual Keyboard is displayed the D-pad is
mapped as follows :

Up    : /
Down  : <ENTER>
Left  : <Backspace>
Right : <Space>

When the Virtual Keyboard is off, then keys are
mapped as follows :

Cross    : <ENTER>
Triangle : <TAB>
Square   : <Backspace>
Circle   : <Space>

Up       : Up
Down     : Down
Left     : Left
Right    : Right

Using LTrigger and RTrigger you can scroll the
console window.  Using the start button you can use
the Virtual keyboard.

Press the Select key to enter in the Console menu.
You will then be able to choose unix commands in a
list. Use the Virtual Keyboard to specify the first
letter of the command.

If you press the same letter several time then all
commands beginning with this letter will be displayed
sequentially.

All those commands are written in file command.txt
that can be edited using the built-in editor (Edit
Command).  You can also use any ASCII-text editor on
your PC, and add your own custom commands.

It might be better to have all commands
alphabetically sorted !

You have the same kind of feature with word.txt file
to enter sentenses or any common words.


4. Save snapshots and log files
   ------------

You can save snapshot in PNG format using the
snapshot option.  Files would be saved in the scr
directory.

You can also save the vt100 terminal window as a text
file. Files would be saved in the log directory.

5. Known Bugs
   ------------

The vt100 emulation is not really polished, and many
bugs still remain.

  Enjoy,

            Zx

