<commit_before># A-Shaky-Start-Talk-Timer

This is a BBC micro:bit count down talk timer to tell you how much time you have left to complete your talk. You start the timer by shaking the micro:bit. It gives you a visual indication as to the time left to give your talk. It starts counting down when you stop shaking it. Initially it lights all LEDs, and as time passes it progressively switches then off. When your time is up it displays a clock animation :-)  

To set the duration of the talk press button A.  You can then increment the talk length in 1 min steps by pressing button B, and button A decrements the talk length by 1 minute. To exit this mode, press Button A for more than 2 seconds. It will then tell you the length of the talk.

If you have other micro:bits with the "A-Shaky-Start-Talk-Timer" program it broadcasts a start message plus talk duration, which causes them to count down in the same way too - cool eh!

To abandon a count down, press button A.

This is written in MicroPython.

If you press button B for more than 2 seconds whilst not counting down, this sets the timer into debug mode which sets the talk duration to 15 seconds. This will display as a single dimly lit LED. To exit debug mode, use button A to set a new talk duration.

The radio message being sent has the format "asstt COMMAND PAYLOAD" as it sent as a string. For the COMMAND start, the PAYLOAD is the talk length/25 i.e. the delay to switch off each LED. The other COMMAND is stop and it has no PAYLOAD.

A little trivia - the first submit was made from a Chromebook when on a train journey between Cromford to Nottingham when approaching Derby. Just after Derby saw the Britian’s rarest train the “Flying Banana” aka the New Measurement Train.



<commit_msg>Make help clearer (#21)<commit_after># A-Shaky-Start-Talk-Timer

This is a BBC micro:bit count down talk timer to tell you how much time you have left to complete your talk. 

**You start the timer** by **shaking** the micro:bit. It gives you a visual indication as to the time left to give your talk. It starts counting down when you stop shaking it. Initially it lights all LEDs, and as time passes it progressively switches then off. When your time is up it displays a clock animation :-)  

**To abandon a count down**, press button A when it is timing a talk.

**To set the duration** of the talk press button A.
  * You **increment the talk length** in 1 min steps by pressing button B; and 
  * You **decrement the talk length** in 1 min setps by pressing button A. 
  * To **exit** this mode, press Button A for more than 2 seconds. It will then tell you the length of the talk, with 1 LED being lit per minute of the talk.

**When waiting to be shaken** it will tell you the length of the talk by lighting 1 LED per minute of the talk.

**Broadcasting to other microbits** - If you have other micro:bits with the "A-Shaky-Start-Talk-Timer" program it broadcasts a start message plus talk duration, which causes them to count down in the same way too - cool eh!

This is written in MicroPython.

**Debug mode** - If you press button B for more than 2 seconds whilst not counting down, this sets the timer into debug mode which sets the talk duration to 15 seconds. This will display as a single dimly lit LED. To exit debug mode, use button A to set a new talk duration.

**The radio message** being sent has the format "asstt COMMAND PAYLOAD" as it sent as a string. For the COMMAND start, the PAYLOAD is the talk length/25 i.e. the delay to switch off each LED. The other COMMAND is stop and it has no PAYLOAD.

**A little trivia** - The first submit was made from a Chromebook when on a train journey between Cromford to Nottingham when approaching Derby. Just after Derby saw the Britian’s rarest train, the “Flying Banana” aka the [New Measurement Train](https://en.wikipedia.org/wiki/New_Measurement_Train). Improvements to this help were subsquently made just after leaving Paddington having seen InterCity 125 43003 (still looking out of 43002 which has the BR livery).
{'fraction_non_alphanumeric': 0.04671280276816609, 'fraction_numerical': 0.008156203657933762, 'mean_word_length': 3.88768115942029, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 1, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1480380', 'n_tokens_mistral': 1101, 'n_tokens_neox': 1007, 'n_words': 706}