4 ms·

I'm happy to take the criticism for the overall documentation. However I believe JP did a great job with the library's doco. Please show me an Arduino library

I'm happy to take the criticism for the overall documentation. However I believe JP did a great job with the library's doco. Please show me an Arduino library with more documentation than: http://learn.microview.io/doco/html/index.html http://learn.microview.io/doco/html/index.html

monstermonster 12y ago
http://www.nongnu.org/avr-libc/user-manual/ http://www.nongnu.org/avr-libc/user-manual/ This is a slightly sarcastic point. I find the Arduino programming environment is horrible. I had to revert to straight-up C in the end and use the Arduino as a convenient ICSP package.
- joshvm 12y ago
  My preferred platform is a Sparkfun Pro Micro (or clone) with the DFU bootloader on it. Just the right number of pins for most projects and programmable with a common micro-USB cable. Tried to poke around with Arduino, but I like using my own libraries.
  - monstermonster 12y ago
    That looks like a pretty nice platform. I may have to grab one to play with.
    - joshvm 12y ago
      I went with a clone because they're about £4/$6 and that seemed like a no brainer. I haven't had any duds yet! They only come in the 5V option from what I've seen, but it's simple enough to swap out the crystal and the regulator to make it a 3.3V/8MHz. Only issue I had was to modify the LUFA DFU bootloader to automatically start the micro if there isn't a programming request within 5 seconds. The default code will sit in the bootloader forever until something happens - fine for prototyping, but a problem if you have it in a semi-permanent place and the power goes.
      - monstermonster 12y ago
        Thanks for the info. Where do you get them at £4 a pop? Not worried about the bootloader problems as these would be prototype only and the voltage is ok as I'm replacing a PLC implementation with some homebrew kit so it's just switching relays and reading opto-isolated inputs, neither which are voltage sensitive.
        joshvm 12y ago
        http://www.ebay.co.uk/itm/Hot-New-Pro-Micro-5V-16MHz-ATMega-32U4-Module-with-2-row-pin-header-For-Leonardo-/400514883558 http://www.ebay.co.uk/itm/Hot-New-Pro-Micro-5V-16MHz-ATMega-... You'll be waiting a while for shipping, so I'd recommend ordering a few ;)
        monstermonster 12y ago
        Perfect - thanks :) Ordered loads of stuff from HK so know about the wait. Have usually forgotten about it by the time it arrives!
melq 12y ago
Please show me an Arduino library with significantly less documentation for a device of similar price and functionality. Revision: I didn't intend for that to come off quite as snarky as it reads. You're certainly entitled to price your product however you see fit, but I don't think it's fair to praise the documentation simply because it's no worse than that of existing libraries. Particularly when (anecdotally) the vast majority of such libraries have no financial motivations.
userbinator 12y ago
more Quality is not quantity; I think that's what the parent and the reviewer was trying to say - there's certainly plenty of documentation, but it's not particularly easy to use that documentation effectively. E.g. I have learned that you need uView.begin() in your setup, but I only figured that out because it’s in every one of the examples, not because I read documentation anywhere that said, “This is how you structure a MicroView compatible sketch.” (Also brings to mind the absolutely overwhelming amount of documentation available for some of the modern smartphone SoCs, but with no easy way to find out e.g. the relationship between one peripheral module and many others sharing the same resources.)
- joshvm 12y ago
  Right, this is my point. Having lovely hookup diagrams, interactive code editors and Doxygen output for the API is nice, but... What's needed is a mid-level introduction to the library once you've gotten past the basic tutorials and solid examples for the commonly used API calls (most of which are simple, but still).

monstermonster 12y ago

http://www.nongnu.org/avr-libc/user-manual/ http://www.nongnu.org/avr-libc/user-manual/ This is a slightly sarcastic point. I find the Arduino programming environment is horrible. I had to revert to straight-up C in the end and use the Arduino as a convenient ICSP package.

joshvm 12y ago
My preferred platform is a Sparkfun Pro Micro (or clone) with the DFU bootloader on it. Just the right number of pins for most projects and programmable with a common micro-USB cable. Tried to poke around with Arduino, but I like using my own libraries.
- monstermonster 12y ago
  That looks like a pretty nice platform. I may have to grab one to play with.
  - joshvm 12y ago
    I went with a clone because they're about £4/$6 and that seemed like a no brainer. I haven't had any duds yet! They only come in the 5V option from what I've seen, but it's simple enough to swap out the crystal and the regulator to make it a 3.3V/8MHz. Only issue I had was to modify the LUFA DFU bootloader to automatically start the micro if there isn't a programming request within 5 seconds. The default code will sit in the bootloader forever until something happens - fine for prototyping, but a problem if you have it in a semi-permanent place and the power goes.
    - monstermonster 12y ago
      Thanks for the info. Where do you get them at £4 a pop? Not worried about the bootloader problems as these would be prototype only and the voltage is ok as I'm replacing a PLC implementation with some homebrew kit so it's just switching relays and reading opto-isolated inputs, neither which are voltage sensitive.
      - joshvm 12y ago
        http://www.ebay.co.uk/itm/Hot-New-Pro-Micro-5V-16MHz-ATMega-32U4-Module-with-2-row-pin-header-For-Leonardo-/400514883558 http://www.ebay.co.uk/itm/Hot-New-Pro-Micro-5V-16MHz-ATMega-... You'll be waiting a while for shipping, so I'd recommend ordering a few ;)
        monstermonster 12y ago
        Perfect - thanks :) Ordered loads of stuff from HK so know about the wait. Have usually forgotten about it by the time it arrives!

melq 12y ago

Please show me an Arduino library with significantly less documentation for a device of similar price and functionality. Revision: I didn't intend for that to come off quite as snarky as it reads. You're certainly entitled to price your product however you see fit, but I don't think it's fair to praise the documentation simply because it's no worse than that of existing libraries. Particularly when (anecdotally) the vast majority of such libraries have no financial motivations.

userbinator 12y ago

more Quality is not quantity; I think that's what the parent and the reviewer was trying to say - there's certainly plenty of documentation, but it's not particularly easy to use that documentation effectively. E.g. I have learned that you need uView.begin() in your setup, but I only figured that out because it’s in every one of the examples, not because I read documentation anywhere that said, “This is how you structure a MicroView compatible sketch.” (Also brings to mind the absolutely overwhelming amount of documentation available for some of the modern smartphone SoCs, but with no easy way to find out e.g. the relationship between one peripheral module and many others sharing the same resources.)

joshvm 12y ago
Right, this is my point. Having lovely hookup diagrams, interactive code editors and Doxygen output for the API is nice, but... What's needed is a mid-level introduction to the library once you've gotten past the basic tutorials and solid examples for the commonly used API calls (most of which are simple, but still).