PASM Intro and Tutorial book [updated - now with C and cogc chapters]

Comments

• Francis Bauer Posts: 353

  2016-10-27 04:53

  I read through your free sample, it looks/looked very good. I always like to see that LaTeX is still alive and well. I used LaTeX a lot back in my days at Hewlett-Packard on HP-UX (UNIX) writing documentation for our automated test engineering software group.
  
  I went ahead and purchased the full e-book from leanpub and downloaded the example code files from git hub. Purchasing from leanpub was easy and quick.
  
  I look forward to going through the whole book. If I spot anything that needs correcting, I'll let you know.
  
  Keep up the good work.
  
  
• Tor Posts: 2,010

  2016-10-27 08:40

  I noticed a '32Kb' in the sample where it's likely that '32KB' was meant.. as RAM and EEPROM and the like is sold in _bits_ (e.g. the 27C512 which is 512 kilobits, i.e. 64KB), it's best to use the proper terms.
• geo_leeman Posts: 190

  2016-10-27 11:24

  Excellent stuff Sridhar! Really nice looking book so far, will send PR's if I stumble on anything.
• sanandak Posts: 18

  2016-10-27 13:51

  Dear Francis, Tor, geo_leeman - thanks for the comments and kind words. I'll fix those things.
  
  Latex is still very much in use. The ebook sites (leanpub, gitbook, overleaf, softcover) prefer markdown, but I found it difficult to integrate the diagrams into the text.
  Sincerely,
  Sridhar
• Tor Posts: 2,010

  2016-10-27 14:03

  LaTeX is great. I write all my documentation in LaTeX. I have automatic translators from other formats, that I wrote, e.g. from good old FrameMaker MIF (Maker Interchange Format). The nice thing is that you can extract the exact content, but leave out the formatting - so by simply applying your own \document{style} any old document can be brought up to the company's (or whoever's) current style.
  Combine it with revision control like Git (not possible with binary formats, or messed-up XML formats), and Perl or other scripting to transform text, and LaTeX is unbeatable.
  
  Those first chapters look good btw. I may buy it, haven't decided yet.
• MacTuxLin Posts: 821

  2016-10-27 14:23

  In page VII, point 2.2 it states "....M9 Tohuki earthquake". It ought to be "... M9 Tohoku ..."
• sanandak Posts: 18

  2016-11-10 19:45

  Friends, I have updated the book on the leanpub site.
  I added 4 chapters on programming the propeller with C.
  
  Here is a table of contents to the book.
  
  
  https://leanpub.com/propellerassemblerpasmintroduction
  
  Sincerely,
  Sridhar
  

  pdf

  pdf

  toc.pdf

  1M

  toc.pdf 1.2M
• Tracy Allen Posts: 6,656

  2016-11-10 20:47 edited 2016-11-10 20:48

  That's great Sridhar. I received the notification from Leanpub and downloaded the new version. Thank you, it is nicely done, clearly written, good for explanation of both the programming tools and the methods to achieve the goals.
  
  Curious, are you Sridhar Anandakrishnan, Professor of Geosciences at Penn State? Oh, I see you say so on your Leanpub page. Seismology, Glaciology, that explains a lot about the keen focus on data compression. But what about the trains?
  
• sanandak Posts: 18

  2016-11-11 12:44

  Dear Tracy - thanks for the comments on the book (and if/when you find any errors, please let me know).
  
  We used to go on a train to visit my grandmother every summer - it was the highlight of the year for me. I have loved trains ever since!
  
  Sincerely,
  Sridhar
• Erlend Posts: 612

  2016-11-12 07:51

  sanandak,
  
  I've just purchased and have started reading your book. Great! Although I am a fan of Spin, easily gets lost in C, and are in the wild with PASM - I am curious to learn, and your book is very clear, concise and educational. I look forward to enjoy reading it all. Thanks.
  
  Erlend
• Erlend Posts: 612

  2016-11-12 10:34 edited 2016-11-12 10:36

  I am not sure I agree to this, though:
  Parallax is encouraging new users to learn to use C to program the propeller, and encouraging existing users to migrate.
  and I do hope it will not become true any time soon. On project-to-completion speed, nothing beats Propeller+Spin.
  
  Erlend
• sanandak Posts: 18

  2016-11-12 13:20

  Dear Erlend, thanks for your encouragement, and I hope you find the book useful (please point out errors and suggest areas for improvement).
  
  In terms of spin vs C - I am somewhat agnostic. In my opinion, C is almost as easy to use as Spin. The part that makes most people's head explode (including mine!) is pointers. In fact, there is an obfuscation contest to see how maddening one can make pointers! However, for most things you can use the simplest form of pointers...
  
  Because I come from a unix/C background, and now that simpleIDE is available, I think I will tend towards C. (note that simpleIDE isn't as stable as the propeller tool or propellerIDE). I find that it will lock up very often and needs to be killed and restarted.
  
  I am working on a Makefile solution where the compile and linking is done in the makefile so I can use command line tools to do my work (which I much prefer - using emacs to edit the code; a makefile to compile and link; and a command line tool to download the code to the propeller and a terminal to see the output - my idea of heaven!).
  
  Spin and PASM work together very easily in terms of launching new cogs (either new pasm cogs or new spin cogs).
  
  C can launch new C cogs easily enough. However, launching new cogC cogs or new PASM cogs is an intricate dance. C is faster than Spin, which may not matter for many projects...
  
  The fact that new users are learning C hopefully means that the tools for using C will continue to improve and existing users *can* migrate if they wish to!
  
  Cheers,
  Sridhar
  
  
• DavidZemon Posts: 2,973

  2016-11-12 14:30

  sanandak wrote: »

  I am working on a Makefile solution where the compile and linking is done in the makefile so I can use command line tools to do my work (which I much prefer - using emacs to edit the code; a makefile to compile and link; and a command line tool to download the code to the propeller and a terminal to see the output - my idea of heaven!).

  
  Have you discovered PropWare yet? You may find its build system exactly what you're looking for. As an emacs user, you may also like this suite of plugins: https://github.com/atilaneves/cmake-ide
• David Betz Posts: 14,511

  2016-11-12 16:17

  sanandak wrote: »

  In terms of spin vs C - I am somewhat agnostic. In my opinion, C is almost as easy to use as Spin. The part that makes most people's head explode (including mine!) is pointers. In fact, there is an obfuscation contest to see how maddening one can make pointers! However, for most things you can use the simplest form of pointers...

  Spin has pointers too. The LONG[x] syntax treats x as a pointer. And @y takes the address of y (a pointer).
  
  
• JonM Posts: 318

  2017-07-06 06:42

  Dr. Sridhar Anandakrishnan was featured on recent eps of the Embedded.fm / Don't Panic Geocast podcast ( it was a combo effort) and mentioned his book as well as how he using the Propeller in his Geo Device.
  
  He gave some very cool Props to Parallax and the folks on the forum for their assistance with his device as well as his book.
  
  It's certainly worth a listen.
  
  
  embedded.fm/episodes/206
  
  dontpanicgeocast.com/?p=484
  
  
• frank freedman Posts: 1,975

  2017-07-07 03:46

  Sanandak,
  
  Just previewed the book. Looks good, just purchased. This is going to be most useful addition.
  
  Thanks,
  
  Frank
• Mickster Posts: 2,603

  2017-07-08 13:45

  frank freedman wrote: »

  Sanandak,
  
  Just previewed the book. Looks good, just purchased. This is going to be most useful addition.
  
  Thanks,
  
  Frank

  
  +1
  
  
• frank freedman Posts: 1,975

  2017-07-23 03:04

  Just finishing up the SPIN part of the book. The examples he uses really help make the topic pop. Had to think about a couple things he did, but it was good to go through in detail. This is shaping up to be an excellent read so far. I have seen variants of TDD. I like the way he presents that as well. Now on to PASM.
• sanandak Posts: 18

  2017-08-05 13:46

  JonM and Frank - thanks for the shoutout to the book - and to the podcasts - it was a lot of fun doing it.
  
  Any feedback you have after spending some time reading the book would be welcome.
  Thanks,
  Sridhar
• frank freedman Posts: 1,975

  2017-08-05 18:20

  PMd a couple notes, more to follow. So far so good. Book has been very useful.