diff --git a/examples/usart1.rs b/examples/usart1.rs
index 0b1b245d0ef798fee6da417c678091fb09f4dc81..0ea9954b2b2b59fe6414fdb7e6c28e8f75653246 100644
--- a/examples/usart1.rs
+++ b/examples/usart1.rs
@@ -1,8 +1,12 @@
-//! Test the USART1 instance
+//! A simple echo server for the Nucleo 64, stm32f401re
 //!
-//! Connect the TX and RX pins to run this test
+//! The jumpers on the board should be in their default position.
+//! This setting tunnels RX/TX over a VCP on the onboard stlink2-1.
 //!
-//! PA2 (TX), PA3(RX) on the MCU is connected to the pin header CN3
+//! Connect to the VCP at dev/ttyACM0 (or similar) 115200 8N1.
+//!
+//! Todo:
+//!  info on pin header CN3 (TX/RX), howto use
 //#![deny(unsafe_code)]
 #![deny(warnings)]
 //#![allow(warnings)]