<h3>Contribution description</h3>
<p>This PR provides stdio over USB to all Arduino MKR boards and setup the reset in bootloader mode like it's done with Arduino IDE.</p>
<p>In Arduino, the application reset in bootloader mode when the stdio is opened at 1200 baud.<br>
In this PR, the hook function is implemented in <code>board.c</code> but the actual connection with <code>cdc_acm_stdio</code> is done in the <code>cdc_acm_stdio</code> when the RESET_IN_BOOTLOADER module is loaded. This might not be the cleanest but it works. Any better suggestion is welcome of course.</p>
<p>To be able to reset in bootloader, there are other tricks:</p>
<ul>
<li>open the serial at 1200 baud with stty</li>
<li>force the bootloader mode: this code is taken from <a class="user-mention" data-hovercard-type="user" data-hovercard-url="/hovercards?user_id=43848" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/ynezz">@ynezz</a> who commented about it in <a class="issue-link js-issue-link" data-error-text="Failed to load issue title" data-id="252599020" data-permission-text="Issue title is private" data-url="https://github.com/RIOT-OS/RIOT/issues/7510" data-hovercard-type="pull_request" data-hovercard-url="/RIOT-OS/RIOT/pull/7510/hovercard" href="https://github.com/RIOT-OS/RIOT/pull/7510">#7510</a>. His code is  <a href="https://github.com/ynezz/RIOT/commit/9ca8afc4dffdf583824a0d01b19da3dda3529714#diff-970cb2802ea5c7c9ca519a80fe0b1327">here</a>. I just readapted it for this PR.</li>
<li>Adapted the build system in order to add delay after preflash command (to let some time for the application to reset in bootloader)</li>
</ul>
<p>I'm testing this PR with arduino-mkrfox1200 but it should work the same with other mkr boards. It's also probably adaptable to SODAQ boards as well.</p>

<h3>Testing procedure</h3>
<p>Just build/flash/term any application with an Arduino MKR board plugged via USB : the board is automatically flashed and stdio is printed (shell works as well).</p>

<h3>Issues/PRs references</h3>
<p>Based on <a class="issue-link js-issue-link" data-error-text="Failed to load issue title" data-id="415817391" data-permission-text="Issue title is private" data-url="https://github.com/RIOT-OS/RIOT/issues/11085" data-hovercard-type="pull_request" data-hovercard-url="/RIOT-OS/RIOT/pull/11085/hovercard" href="https://github.com/RIOT-OS/RIOT/pull/11085">#11085</a> to get the stdio feature.</p>


<hr>

<h4>You can view, comment on, or merge this pull request online at:</h4>
<p>  <a href='https://github.com/RIOT-OS/RIOT/pull/12304'>https://github.com/RIOT-OS/RIOT/pull/12304</a></p>

<h4>Commit Summary</h4>
<ul>
  <li>usb cdc acm: add common defines for cdc acm</li>
  <li>usbus: Add cdc acm function</li>
  <li>USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! usbus: Add cdc acm function</li>
  <li>fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>test/usbus_cdc_acm_stdio: USB CDC ACM STDIO test</li>
  <li>fixup! test/usbus_cdc_acm_stdio: USB CDC ACM STDIO test</li>
  <li>fixup! usb_cdc: Add common defines and message structs</li>
  <li>fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! fixup! usb_cdc: Add common defines and message structs</li>
  <li>fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! fixup! fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! test/usbus_cdc_acm_stdio: USB CDC ACM STDIO test</li>
  <li>fixup! fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! fixup! fixup! fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! fixup! fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! fixup! fixup! USBUS cdc acm: Add STDIO wrapper for CDC ACM</li>
  <li>fixup! fixup! fixup! fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! fixup! fixup! fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! usbus: Add cdc acm function</li>
  <li>fixup! fixup! test/usbus_cdc_acm_stdio: USB CDC ACM STDIO test</li>
  <li>boards/arduino-mkr: use USB CDC-ACM for stdio</li>
  <li>makefiles: sys/cdc-acm-stdio: provide a reset in bootloader hook</li>
  <li>boards/arduino-mkr: implement reset in bootloader feature</li>
  <li>Makefile.include: add preflash-with-delay target</li>
  <li>tools/bossa: use preflash-with-delay when required</li>
  <li>boards/arduino-mkr: setup preflash and term delays</li>
  <li>boards/arduino-mkrfox1200: update doc about flash and stdio</li>
</ul>

<h4>File Changes</h4>
<ul>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-0">Makefile.dep</a>
    (12)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-1">Makefile.include</a>
    (3)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-2">boards/arduino-mkrfox1200/doc.txt</a>
    (13)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-3">boards/common/arduino-mkr/Makefile.dep</a>
    (8)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-4">boards/common/arduino-mkr/Makefile.include</a>
    (15)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-5">boards/common/arduino-mkr/board.c</a>
    (32)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-6">makefiles/pseudomodules.inc.mk</a>
    (3)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-7">makefiles/tools/bossa.inc.mk</a>
    (6)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-8">sys/auto_init/usb/auto_init_usb.c</a>
    (8)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-9">sys/include/usb/cdc.h</a>
    (61)
  </li>
  <li>
    <strong>A</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-10">sys/include/usb/usbus/cdc/acm.h</a>
    (165)
  </li>
  <li>
    <strong>M</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-11">sys/usb/usbus/Makefile</a>
    (3)
  </li>
  <li>
    <strong>A</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-12">sys/usb/usbus/cdc/acm/Makefile</a>
    (7)
  </li>
  <li>
    <strong>A</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-13">sys/usb/usbus/cdc/acm/cdc_acm.c</a>
    (328)
  </li>
  <li>
    <strong>A</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-14">sys/usb/usbus/cdc/acm/cdc_acm_stdio.c</a>
    (103)
  </li>
  <li>
    <strong>A</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-15">tests/usbus_cdc_acm_stdio/Makefile</a>
    (27)
  </li>
  <li>
    <strong>A</strong>
    <a href="https://github.com/RIOT-OS/RIOT/pull/12304/files#diff-16">tests/usbus_cdc_acm_stdio/main.c</a>
    (33)
  </li>
</ul>

<h4>Patch Links:</h4>
<ul>
  <li><a href='https://github.com/RIOT-OS/RIOT/pull/12304.patch'>https://github.com/RIOT-OS/RIOT/pull/12304.patch</a></li>
  <li><a href='https://github.com/RIOT-OS/RIOT/pull/12304.diff'>https://github.com/RIOT-OS/RIOT/pull/12304.diff</a></li>
</ul>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/RIOT-OS/RIOT/pull/12304?email_source=notifications&email_token=ABE7WYEBZIXOEXU4W4SUPTTQLRJPNA5CNFSM4I2VU3JKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4HNZLU5A">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/ABE7WYDU343RRYQRHE4KXMLQLRJPNANCNFSM4I2VU3JA">mute the thread</a>.<img src="https://github.com/notifications/beacon/ABE7WYEKFBRQ3HUG3Q5TXTLQLRJPNA5CNFSM4I2VU3JKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4HNZLU5A.gif" height="1" width="1" alt="" /></p>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/RIOT-OS/RIOT/pull/12304?email_source=notifications\u0026email_token=ABE7WYEBZIXOEXU4W4SUPTTQLRJPNA5CNFSM4I2VU3JKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4HNZLU5A",
"url": "https://github.com/RIOT-OS/RIOT/pull/12304?email_source=notifications\u0026email_token=ABE7WYEBZIXOEXU4W4SUPTTQLRJPNA5CNFSM4I2VU3JKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4HNZLU5A",
"name": "View Pull Request"
},
"description": "View this Pull Request on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>