timvideos / flterm

flterm

Tool for loading data over serial.

It seems to work well with really crappy / partially working serial ports.

Allows firmware to be loaded onto the soft-CPU found inside MiSoC or LiteX FPGA SoCs.

Serial boot program for MiSoC - v. 2.4
Copyright (C) 2007, 2008, 2009, 2010, 2011 Sebastien Bourdeauducq
Copyright (C) 2011 Michael Walle
Copyright (C) 2004 MontaVista Software, Inc

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 of the License.

Usage: flterm --port <port>
              [--speed <speed>] [--gdb-passthrough] [--debug]
              [--kernel <kernel_image> [--kernel-adr <address>]]
              [--cmdline <cmdline> [--cmdline-adr <address>]]
              [--initrd <initrd_image> [--initrd-adr <address>]]
              [--log <log_file>]

Default load addresses:
  kernel:  0x40000000
  cmdline: 0x41000000
  initrd:  0x41002000

License

flterm is released under the GPLv3.0 license

flterm's Issues

Add xmodem support to flterm

Xmodem is horrible, but everything else supports it.

Configurable exit flterm sequence

As of #7 (Ctrl-C) and #8 (Ctrl-D) it is possible to exit flterm cleanly (0 exit code), which is useful when using, eg, make firmware-connect in https://github.com/timvideos/litex-buildenv/.

However both of these sequences are commonly used in, eg, the Linux console, so a flterm session connected to a system with a Linux console will now be unable to send either of these sequences.

We should probably (a) make the exit sequence configurable, and (b) consider making the default sequence a less common character sequences. Ctrl-] is conventional for terminal programs, telnet, etc for this reason.

Add ability to send sequence after connecting

Frequently people don't know to press enter after flterm connects, so they sit there waiting for something to happen.

If we could send an enter after connecting, people would see the prompt.

An expect script would be even better. That would allow us to issue a reboot command.

Fix the sfl commands above 0x3

As identified in litex-hub/wishbone-utils#22, litex-term + bios have diverged from what flterm is using. We should fix that.