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