pte_users_guide.html 2.5 KB

123456789101112131415161718192021222324252627282930313233
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
  2. <html><head><meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>PTE User's Guide</title></head><body><br><big style="font-weight: bold;"><big>PTE Users Guide</big></big><br><br>Since
  3. PTE is designed to be cross platform, and embedded OS's vary widely in
  4. their build methodology, there is no "high level" build structure
  5. included. &nbsp;Rather, each port is responsible for providing this.
  6. &nbsp;The sections below describe using PTE for a specific platform.<br><br>While
  7. pthreads is strictly speaking a C API, PTE does include limited support
  8. for C++ specific features, specifically exceptions. &nbsp;This
  9. functionality was primarily inherited from the original code base
  10. (Pthreads-win32) and has been only preliminarily tested.<br><br>An
  11. important component of PTE is the test library that is included.
  12. &nbsp;Each platform contains build files as described below to build
  13. the test suite.<br><big style="font-weight: bold; font-style: italic;"><br>DSP/BIOS</big><br>Texas
  14. Instruments provides DSP/BIOS as a RTOS to be used on their series of
  15. digital signal processors. &nbsp;Two project files are included: one
  16. for the library itself and one for the test suite. &nbsp;These projects
  17. (and CDB/TCF files) were targeted towards the C6000 simulator, as this
  18. is where I did all of the development. &nbsp;When building applications
  19. that use the PTE library, you will need to include pthreads.h and will
  20. also need to provide a path to pte-types.h (originally located in
  21. platforms/dspbios/pte-types.h). &nbsp;This file contains definitions of
  22. structures and types (e.g. pid_t) that are required by pthreads but not
  23. supplied by DSP/BIOS<br><big style="font-weight: bold; font-style: italic;"><br>PSP OS</big><br>This
  24. is the operating system used by the Sony PSP. &nbsp;The PSP toolchain
  25. is gcc based and thus shares many similarities with a "typical" UNIX
  26. system, including the build system. &nbsp;PTE includes Makefiles for
  27. the library itself as well as the test suite. &nbsp;Note that these
  28. Makefiles are pretty rudimentary as I am not anywhere close to being a
  29. Makefile expert. &nbsp;Thus, once the library is built it will be
  30. necessary to copy the library itself, pthread.h and pte-types.h to the
  31. appropriate places in your projects build structure. &nbsp;The PSP
  32. toolchain includes a pthread.h header in the base distribution (why,
  33. I'm not sure) - it is important that you use the pthread.hsupplied with PTE rather than the one in the toolchain. <br><br></body></html>