{"action":"created","issue":{"url":"https://api.github.com/repos/libopencm3/libopencm3-examples/issues/111","labels_url":"https://api.github.com/repos/libopencm3/libopencm3-examples/issues/111/labels{/name}","comments_url":"https://api.github.com/repos/libopencm3/libopencm3-examples/issues/111/comments","events_url":"https://api.github.com/repos/libopencm3/libopencm3-examples/issues/111/events","html_url":"https://github.com/libopencm3/libopencm3-examples/issues/111","id":123521220,"number":111,"title":"stm32f429 demos descriptions are terse","user":{"login":"J-Dunn","id":9969512,"avatar_url":"https://avatars.githubusercontent.com/u/9969512?v=3","gravatar_id":"","url":"https://api.github.com/users/J-Dunn","html_url":"https://github.com/J-Dunn","followers_url":"https://api.github.com/users/J-Dunn/followers","following_url":"https://api.github.com/users/J-Dunn/following{/other_user}","gists_url":"https://api.github.com/users/J-Dunn/gists{/gist_id}","starred_url":"https://api.github.com/users/J-Dunn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/J-Dunn/subscriptions","organizations_url":"https://api.github.com/users/J-Dunn/orgs","repos_url":"https://api.github.com/users/J-Dunn/repos","events_url":"https://api.github.com/users/J-Dunn/events{/privacy}","received_events_url":"https://api.github.com/users/J-Dunn/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":11,"created_at":"2015-12-22T17:15:23Z","updated_at":"2015-12-26T06:34:55Z","closed_at":null,"body":"I've just started diving into opencm3 and I'm pretty impressed. I quickly got a few demos built and flashed. I started with the stm32f429i-discovery which has quite a lot of good stuff. \r\n\r\nHowever, I quickly got stuck because the readme's are so terse.\r\n\r\nThe top level readme has: \r\n>>\r\n2. usart\\_console - Program a USART on the board as a console (requires\r\n   clonsing jumpers on your discovery board connecting USART1 to the\r\n   programmer)\r\n>>\r\n\r\nWell I guess clonsing is closing but they are already in the closed position to use the STLINK to flash the board. Did this mean open? But that does not work either. :(\r\n\r\n\r\nThe full readme for that demo says: \r\n>>\r\nSimple USART Example\r\n--------------------\r\n\r\nThis example sets up a USART port and provides a few simple\r\ncharacter handling functions to that a short interactive program\r\ncan be demonstrated. It re-uses the clock setup from systick_blink\r\nand that means you could do times delays but that aspect isn't used.\r\n>>\r\n\r\nSo what should I expect / do  ? \r\n\r\nIf I get nothing is there a problem? I would not know because there is so little about what this demo is supposed to do. \r\n\r\nIn fact this whole jumper story is completely opaque, even in the ST user manual . On or off I never get a ACM device showing. There seems to be more to it but some explicit instructions are needed to get the demo to run. \r\n\r\nSome of the readme's in the other branches are pretty good but this branch is a little too light to of much help.\r\n\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/libopencm3/libopencm3-examples/issues/comments/167284777","html_url":"https://github.com/libopencm3/libopencm3-examples/issues/111#issuecomment-167284777","issue_url":"https://api.github.com/repos/libopencm3/libopencm3-examples/issues/111","id":167284777,"user":{"login":"ChuckM","id":532407,"avatar_url":"https://avatars.githubusercontent.com/u/532407?v=3","gravatar_id":"","url":"https://api.github.com/users/ChuckM","html_url":"https://github.com/ChuckM","followers_url":"https://api.github.com/users/ChuckM/followers","following_url":"https://api.github.com/users/ChuckM/following{/other_user}","gists_url":"https://api.github.com/users/ChuckM/gists{/gist_id}","starred_url":"https://api.github.com/users/ChuckM/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ChuckM/subscriptions","organizations_url":"https://api.github.com/users/ChuckM/orgs","repos_url":"https://api.github.com/users/ChuckM/repos","events_url":"https://api.github.com/users/ChuckM/events{/privacy}","received_events_url":"https://api.github.com/users/ChuckM/received_events","type":"User","site_admin":false},"created_at":"2015-12-26T06:34:55Z","updated_at":"2015-12-26T06:34:55Z","body":"Actually the given the way the debug port works you can't brick it, you can always use another board to reprogram the factory firmware."}}