README.txt 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. 30.3.2013/Kustaa Nyholm
  2. README.TXT for USB CDC ACM v 1.1 for PIC18F4550
  3. This is a self contained example code that implements
  4. a USB CDC ACM aka Virtual Serial Port.
  5. Brought up to date and improved thanks to Ron Musgrave's
  6. pestering, thank's Ron, I enjoyed the whole process.
  7. As delivered the main program reads characters sent
  8. to the virtual serial port (COMn on Windows, /dev/ttyACM0
  9. on Linux and /dev/tty.tty.usbmodem1411 on Mac OS X, exact names
  10. may vary) and sends back the decimal value of the ASCII
  11. character sent to the terminal. In other words if you do
  12. for example on Mac OS X Terminal:
  13. screen /dev/tty.tty.usbmodem1411
  14. and type 'hello' you should see on the screen:
  15. Wellcome!
  16. 104
  17. 101
  18. 108
  19. 108
  20. 111
  21. (The 'Wellcome' text will only appear the first time
  22. you try this after pluging in the device).
  23. This version (1.1) compiles with SDCC 3.2.0 and supports
  24. the optional GET_LINE_CODING CDC ACM message without
  25. which some overzealous Windows software things the
  26. COM port is not working.
  27. This version has been tested on Mac OS X 10.8.2 and
  28. Ubuntun 9.04 with 'screen' and on Windows XP (SP2)
  29. and Windows 7 Ultimate 32 bit with 'putty' 0.62,
  30. Tera Term Pro 2.3 and HyperTerminal Private Edition 7.0.
  31. The code works with PIC18F4550 with 4 MHz Xtal.
  32. The Makefile has some hardcoded paths that are specific
  33. to my installation because I need to maintain several
  34. parallel SDCC installations. You need to modify those
  35. to suit your installation.
  36. For standard SDCC installation it probably is enough to
  37. change SDCC setting to:
  38. SDCC = /usr/local/bin/sdcc
  39. and remove from the SDCCFLAGS setting this:
  40. -L /Users/nyholku/sdcc-3.2.0/share/sdcc/non-free/lib/pic16
  41. have not tested that though.
  42. The Makefile calls script 'load' which expects to find
  43. 'pk2cmd' on the PATH (augmented in the Makefile) and
  44. which of course assumes that a PICKit2 is available.
  45. The code was developed on Mac OS X so may need some
  46. tweaking to get the compiling to work on other operating
  47. systems.
  48. All Linux and Windows testing was performed under
  49. Parallels Desktop 7.0.15107.
  50. Thats all folks, Kusti