sconsole

bare bones linux serial console tool
git clone http://frotz.net/git/sconsole.git
Log | Files | Refs

readme.md (1574B)


      1 # sconsole (simple serial console)
      2 
      3 I wrote this when I got sick of fighting with minicom, not getting reasonable
      4 scrollback from it, and having it constantly corrupting its terminal whenever
      5 some junk characters got spat out the serial port during a target reboot.
      6 
      7 It's a very very simple serial console -- just run it in your xterm or 
      8 Terminal or whatnot. It'll display data from the serial port and send
      9 characters you type to the serial port.
     10 
     11 By default it squashes most non-printables to '.' to avoid mucking up your
     12 terminal state, but you can pass `-t` (transparent) to turn that off if
     13 the other end is spitting out ANSI color or providing interactive curses
     14 style interfaces.
     15 
     16 ## Usage
     17 ```
     18 sconsole [ <option> ]* [ <serialdevice> [ <baudrate> ] ]
     19 
     20 options:  -t  transparent mode (allow non-printable characters)
     21           -c  convert NL to CR on transmit
     22           -x  display characters in hex
     23           -l  log serial data:   -l<filename> (default: console.log)
     24           -b  litex serial boot: -b<filename>[@<hexaddr>]
     25 
     26 serialdevice defaults to /dev/ttyUSB0
     27 baudrate defaults to 115200
     28 ```
     29 
     30 ### Litex Serial Boot
     31 
     32 sconsole can send binaries to the Litex serial bootloader. Use the `-b`
     33 option to list one or more binaries to download.  They will be downloaded
     34 to the target in the order listed and then the target will be told to jump
     35 to the *first* binary's base address.  The default download address is
     36 0x40000000 or you can specify an address after the filename with @:
     37 
     38 ```
     39 $ sconsole -bbios.bin@0x40000000 -bapp.bin@0x40008000 /dev/ttyUSB0 1000000
     40 ```
     41