
    Welcome to PSPSSH

Original Author of DropBear

  Matt Johnston (see http://matt.ucc.asn.au/dropbear/dropbear.html)

Author of the PSP port version 

  Ludovic.Jacomme also known as Zx-81 (zx81.zx81@gmail.com)


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.

  Special thanks to Delight1 for her feedback. 

  Big thanks to NeXuS for his very nice music !
  ( see http://www.jamendo.com/en/artist/nexus )

  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. 

  See LICENSE.txt file for all details and information about it.

2. INSTALLATION
   ------------

  Unzip the zip file, and copy the content of the directory fw1.5 or fw5.x
  (depending of the version of your firmware) on the psp/game, or psp/game5XX
  if you use custom firmware 5.0-M33.

  It has been developped on linux using Firmware 5.0-M33.

  For any comments or questions on this version, please visit 
  http://zx81.zx81.free.fr, http://www.dcemu.co.uk, or 
  http://pspupdates.qj.net

3. CONTROL
   ------------

3.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.

3.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

4. HOW DOES-IT WORK ?
   ------------

4.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 :

4.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.

  If you Gip_enc (provide with the archive , read README in gip_enc to know how it works) is running on your server you can hit Triangle to get IP server (before that, be sure to config url.txt writing the url where is your ip.txt, for exemple if your ip is uploaded to http://toto.fr/ip.txt write : http://toto.fr/ in your url.txt).

  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.
  
4.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 example), 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.

  If you have already an openssh id_rsa file, you need to do 
  a convertion to use it with PSPSSH using dropbearconvert 
  tool (available on the Dropbear web site). 

  The id_rsa file should be then stored in the ssh directory 
  of pspssh and called id_rsa (without any extention).

4.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.

4.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.

5. 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.
  

6. COMPILATION
   ------------

  It has been developped under Linux using gcc with PSPSDK. 
  To rebuild the homebrew run the Makefile in the src archive.

7. KNOWN BUGS
   ------------

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

