README 1.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. Protothreads are extremely lightweight stackless threads designed for
  2. severely memory constrained systems such as small embedded systems or
  3. sensor network nodes. Protothreads can be used with or without an
  4. underlying operating system.
  5. Protothreads provides a blocking context on top of an event-driven
  6. system, without the overhead of per-thread stacks. The purpose of
  7. protothreads is to implement sequential flow of control without
  8. complex state machines or full multi-threading.
  9. Main features:
  10. * No machine specific code - the protothreads library is pure C
  11. * Does not use error-prone functions such as longjmp()
  12. * Very small RAM overhead - only two bytes per protothread
  13. * Can be used with or without an OS
  14. * Provides blocking wait without full multi-threading or
  15. stack-switching
  16. * Freely available under a BSD-like open source license
  17. Example applications:
  18. * Memory constrained systems
  19. * Event-driven protocol stacks
  20. * Small embedded systems
  21. * Sensor network nodes
  22. The protothreads library is released under an open source BSD-style
  23. license that allows for both non-commercial and commercial usage. The
  24. only requirement is that credit is given.
  25. The protothreads library was written by Adam Dunkels <adam@sics.se>
  26. with support from Oliver Schmidt <ol.sc@web.de>.
  27. More information and new versions can be found at the protothreads
  28. homepage:
  29. http://www.sics.se/~adam/pt/
  30. Documentation can be found in the doc/ subdirectory.
  31. Two example programs illustrating the use of protothreads can be found
  32. in this directory:
  33. example-small.c A small example showing how to use protothreads
  34. example-buffer.c The bounded buffer problem with protothreads
  35. example-codelock.c A code lock with simulated key input
  36. To compile the examples, simply run "make".
  37. Adam Dunkels, 3 June 2006