I wonder having a tutorial or user guide for the newt will help. What we have today for http://mynewt.apache.org/newt/newt_mac/ <http://mynewt.apache.org/newt/newt_mac/> is only how to build it (on platform of your choice) not how to use its extensive commands and subcommands.
Noted that in doing Blinky projects you get a flavor or taste of its range and scope, but having a user guide, in addition to reference manual, does help the developer whose primary interface to build, package, debug, and test Mynewt OS apps is using newt. Just thinking out loud…. Cheers Jules -- "Developers Are the New Kingmakers." Jules Damji [email protected] > On Mar 1, 2016, at 6:53 PM, Sterling Hughes <[email protected]> wrote: > > Generally, I think we want the guides to track major blocks of functionality > in Mynewt. To me, the major blocks are: > > - OS > - Bluetooth Stack > - Bootloader, Flash & FS > - Console & Shell > - HAL > - Newtmgr > > For the OS, I think we want: > > - How to define a task that uses event queues to manage multiple events > - How to use memory pools and heap, and how to layout memory on embedded > systems > > For the Bluetooth Stack: > > - How do we create an endpoint device, and define a GATT attribute > - How do we create a beacon device using the Bluetooth stack > - Connecting to a remote device, and reading attributes using the Bluetooth > stack > > Bootloader, Flash & FS > > - How do we create a flash image, including bootloader and images > - How do you create, size and install NFFS on a device's flash > - How do you read & write files with the FS APIs > > Console & Shell > > - How do you initialize the console and shell, and log messages to the console > - How do you create custom shell commands > > HAL > > - The HAL is relatively undeveloped at the moment, I think we should add HAL > tutorials in the next release. > > Newtmgr > > - How do you access a device using Newtmgr over BLE and Serial > - How do you do an image upgrade with Newtmgr > - How do you add a custom Newtmgr command > >>> With the first release of Apache Mynewt poised to be unleashed to the >>> world, I’d like to brainstorm some tutorial topics to get people trying out >>> the OS and seeing how easy it is to use. Let’s try to come up with 10 >>> tutorial topics. >>> >>> Here are a few I thought of. I’d like us to come up with at least 10 >>> additional tutorials. And yes, it would mean doing them and documenting >>> them. Feel free to pick the list apart and suggest your own ideas. And we >>> can come up with a final list and vote. >>> >>> 1. How to create a custom LED blink pattern on the STM32F Discovery board >>> from STMicro >>> 2. Turn on the LED x mins after specified wall clock time (like security >>> lights that automatically on after 6 pm) >>> 3. How to define a new event or statistic (e.g. available memory is less >>> than a specified threshold) and log an alert (or read it with newtmgr) >>> 4. How to write a test utility for a pkg > > +1 > >>> 5. How to plug in a different file system instead of nffs (say, yaffs ?) > > I'd say this one should go in the later bucket. > >>> 6. Connect a digital sensor to a board (Arduino?) via GPIO or UART, detect >>> and log level changes. > > +1 > >>> 7. Quiz buzzer - scan the push button input and display the corresponding >>> number on a display > > I think this one may be on the complicated side for what we can get done. > But it would be nice to have. > >>> 8. Build a BLE beacon that broadcasts some internal information >>> (manufacturing specific info or firmware info) >>> 9. Query your Mynewt BLE device (board) remotely via console terminal > > +1 > >>> 10. Slinky - this is already there but could do with some embellishment >>> esp. in the documentation. >>> > > Yeah. Slinky right now has too many things initialized for testing purposes. > This needs to be stripped down. > > > Sterling
