README

   1 This is a very small Scheme system designed to run on small
   2 microcontrollers, currently the PIC microcontroller.
   3
   4 It consists of
   5
   6 * a bytecode compiler which compiles Scheme source code to bytecode.
   7   The bytecode compiler is run using the Gambit-C Scheme system,
   8   usually on a PC/workstation.
   9
  10 * a bytecode interpreter which can be either compiled to run on a
  11   microcontroller, or to be run on some common operating systems, at
  12   least GNU/Linux (Windows support hasn't been tested in a while,
  13   though, and especially the networking part might not work out of the
  14   box).
  15
  16
  17 USAGE:
  18
  19 1. Install the dependencies:
  20
  21   * Gambit-C: needed to run the bytecode compiler.
  22     See http://www.iro.umontreal.ca/~gambit/
  23
  24   * libpcap: optional, to test networking on PC's (GNU/Linux)
  25     Be sure to also install the package containing the headers
  26     (libpcap-dev or similar).
  27     (TODO: add to makefile somehow)
  28
  29 2a. Targetting a PC/workstation for testing:
  30
  31   * Build the VM: run
  32      make
  33
  34   * Compile and run a Scheme program: run
  35      ./p schemefile-without-suffix
  36
  37 2b. Compile and run a Scheme program on PIC:
  38
  39   <TODO>
  40
  41
  42 SEE ALSO:
  43
  44   * S3 (Small Scheme Stack) : A Scheme TCP/IP Stack Targeting Small
  45     Embedded Applications
  46     http://www-etud.iro.umontreal.ca/~stamourv/sw08-tcp.pdf
  47
  48   * Slides from the presentation given at the 2008 Workshop on Scheme
  49     and Functional Programming
  50     http://www-etud.iro.umontreal.ca/~stamourv/s3.pdf
  51
  52  and maybe you find the papers about the BIT and PICBIT systems
  53  interesting, which have been written before PICOBIT and share some
  54  common concepts:
  55
  56     http://w3.ift.ulaval.ca/~dadub100/