Lab 1: Artemis and Bluetooth

2026-01-23T00:00:00+00:00

This lab introduces programming the RedBoard Artemis Nano and explores communicating with the board via Bluetooth.</p>

Lab 1A</h2>
The first part of this lab demostrates how to program the RedBoard Artemis Nano and explores some of the features via demo code files.</p>

Basic Setup</h3>
To start this lab, the Artemis Redboard Nano is connected to a laptop. We use the Arduino IDE to program it.</p>

Running Blink</h3>
Like with most microntroller projects, we start with making the onboard led blink. The demo code initializes the built-in led as the output, then repeated turns it on and off with a second delay in between each action.</p> </iframe>

Running Serial</h3>
Next, we run the Serial demo code to demonstate communication with the Artemis via the serial port. The serial monitor allows us to send and recieve messages when the Artemis is connected to a serial port on our laptop. The demo code takes a message you sent and echos it back as demontrated in the video below.</p> </iframe>

Testing the Temperature Sensor</h3>
The “analog read” demo code allows us to read the output of the Artemis builtin temperature sensor.</p>

Testing the Microphone</h3>
Finally, the Microphone Ouptut demo allows use to see the loudest frequency detected by the onboard microphone. You can see the result of my high pitch whisper screaming into the microphone below.</p>

Grad Task: Frequency Detector</h3>

The grad task for this assignment builds on the Microphone and Serial demos to create a electronic tuner that can detect 3 different frequencies. I chose to detect the musical notes A, C and F. I did this by playing the middle pitches of these notes (A4, C4, and F4) and setting the standard to the output of the program. To detect the pitch, I tranform the heard pitch to be in the correct octave (by multiplying or dividing by 2), then find the pitch it is closest to and print that as the note.</p>

void</span> pitch_analysis</span>(</span>uint32_t</span> real_pitch</span>) {</span></span>
</span>
  // standard frequencies to match </span></span>
  uint32_t</span> freq_A </span>=</span> 434</span>;</span></span>
  uint32_t</span> freq_C </span>=</span> 263</span>;</span></span>
  uint32_t</span> freq_F </span>=</span> 343</span>;</span></span>
</span>
  uint32_t</span> pitch </span>=</span> real_pitch</span>;</span></span>
</span>
  // We normalize the pitch to be in the middle octave</span></span>
  while</span> (</span>pitch </span><</span> 256</span>) {</span></span>
    pitch </span>*=</span> 2</span>;</span></span>
  }</span></span>
</span>
  while</span> (</span>pitch </span>></span> 512</span>){</span></span>
    pitch </span>/=</span> 2</span>;</span></span>
  }</span></span>
</span>
  uint32_t</span> diff_A </span>=</span> (</span>uint32_t</span>)</span> abs</span>((</span>int</span>)</span> pitch </span>-</span> (</span>int</span>)</span> freq_A</span>);</span></span>
  uint32_t</span> diff_C </span>=</span> (</span>uint32_t</span>)</span> abs</span>((</span>int</span>)</span> pitch </span>-</span> (</span>int</span>)</span> freq_C</span>);</span></span>
  uint32_t</span> diff_F </span>=</span> (</span>uint32_t</span>)</span> abs</span>((</span>int</span>)</span> pitch </span>-</span> (</span>int</span>)</span> freq_F</span>);</span></span>
</span>
  // We choose the closest pitch and print it</span></span>
  if</span> (</span>diff_A </span><</span> diff_C</span>) {</span></span>
    if</span> (</span>diff_F </span><</span> diff_A</span>) {</span></span>
      Serial</span>.</span>printf</span>(</span>"THE NOTE IS AN F (%d)         </span>\n</span>"</span>,</span> real_pitch</span>);</span></span>
    }</span></span>
    else</span> {</span></span>
      Serial</span>.</span>printf</span>(</span>"THE NOTE IS AN A (%d)         </span>\n</span>"</span>,</span> real_pitch</span>);</span></span>
    }</span></span>
  }</span></span>
  else if</span> (</span>diff_F </span><</span> diff_C</span>) {</span></span>
    Serial</span>.</span>printf</span>(</span>"THE NOTE IS AN F (%d)         </span>\n</span>"</span>,</span> real_pitch</span>);</span></span>
  }</span>  </span></span>
  else</span> {</span></span>
    Serial</span>.</span>printf</span>(</span>"THE NOTE IS A C (%d)         </span>\n</span>"</span>,</span> real_pitch</span>);</span></span>
  }</span></span>
}</span></span></code></pre></iframe>
Lab 1B</h2>
The second part of this lab works on communicated with the Artemis via bluetooth. Since we won’t have a serial connection with the board when it is in a robot, our primary communication method will be Bluetooth. In this lab, we experiement with thie bluetooth connection and create commands to use for communication.</p>
Prelab</h3>
We set up bluetooth connection with the Artemis board. The board has a unique MAC address that we search for to create a bluetooth connection to our laptop. We also generate a unique UUID to prevent any unplanned connections. Through the bluetooth library, we are able to communicate in many ways, as explored in the lab below.</p>

ECHO Command</h3>
The ECHO</code> command takes in a string s</code> and prints “Robot says: s</code> :)” on the serial port.</p>
case ECHO:</span></span>
    char</span> char_arr</span>[</span>MAX_MSG_SIZE</span>];</span></span>
</span>
    // Extract the next value from the command string as a character array</span></span>
    success </span>=</span> robot_cmd.</span>get_next_value</span>(</span>char_arr</span>);</span></span>
    if</span> (</span>!</span>success</span>)</span></span>
        return</span>;</span></span>
</span>
    Serial.</span>print</span>(</span>"Robot says: "</span>);</span></span>
    Serial.</span>print</span>(</span>char_arr</span>);</span></span>
    Serial.</span>println</span>(</span>" :)"</span>);</span></span>
    </span></span>
    break</span>;</span></span></code></pre>
SEND_THREE_FLOATS command</h3>
The SEND_THREE_FLOATS</code> command takes in an input of 3 floats each separated by a |</code>. The robot prints to the serial port Three floats: [float1], [float2], [float3]</code>.</p>
case SEND_THREE_FLOATS:</span></span>
    float</span> float_a</span>,</span> float_b</span>,</span> float_c</span>;</span></span>
</span>
    // Extract the next value from the command string as a float</span></span>
    success </span>=</span> robot_cmd.</span>get_next_value</span>(</span>float_a</span>);</span></span>
    if</span> (</span>!</span>success</span>)</span></span>
        return</span>;</span></span>
</span>
    // Extract the next value from the command string as a float</span></span>
    success </span>=</span> robot_cmd.</span>get_next_value</span>(</span>float_b</span>);</span></span>
    if</span> (</span>!</span>success</span>)</span></span>
        return</span>;</span></span>
</span>
    // Extract the next value from the command string as a float</span></span>
    success </span>=</span> robot_cmd.</span>get_next_value</span>(</span>float_c</span>);</span></span>
    if</span> (</span>!</span>success</span>)</span></span>
        return</span>;</span></span>
</span>
    Serial.</span>print</span>(</span>"Three Floats: "</span>);</span></span>
    Serial.</span>print</span>(</span>float_a</span>);</span></span>
    Serial.</span>print</span>(</span>", "</span>);</span></span>
    Serial.</span>print</span>(</span>float_b</span>);</span></span>
    Serial.</span>print</span>(</span>", "</span>);</span></span>
    Serial.</span>println</span>(</span>float_c</span>);</span></span>
    </span></span>
    break</span>;</span></span></code></pre>GET_TIME_MILLIS command</h3>
The GET_TIME MILLIS</code> command takes in no parameters, gets the time since Artemis boot in milliseconds, and writes T: [time]</code> to the string characteristic and the serial port.</p>
case GET_TIME_MILLIS:</span></span>
    tx_estring_value.</span>clear</span>();</span></span>
    tx_estring_value.</span>append</span>(</span>"T:"</span>);</span></span>
    tx_estring_value.</span>append</span>((</span>int</span>)</span> millis</span>());</span></span>
    tx_characteristic_string.</span>writeValue</span>(</span>tx_estring_value.</span>c_str</span>());</span></span>
</span>
    Serial.</span>println</span>(</span>tx_estring_value.</span>c_str</span>());</span></span>
    break</span>;</span></span></code></pre></iframe>
Notification Handler</h3>
The notification handler takes in a function with the UUID and a bytearray as inputs. It is set up to call the function when the string characteristic is written. This notification handler waits for the time to be written, parsed the data, and prints it.</p>
def</span> time_extractor</span>(</span>uuid</span>,</span> byte_time</span>):</span></span>
    str_time</span> =</span> ble</span>.</span>bytearray_to_string</span>(</span>byte_time</span>)</span></span>
    i</span> =</span> str_time</span>.</span>find</span>(</span>"T:"</span>)</span></span>
    if</span> i</span>  == -</span>1</span>:</span></span>
        print</span>(</span>f</span>"Time is </span>{</span>str_time</span>}</span>"</span>)</span></span>
    else</span>:</span></span>
        print</span>(</span>f</span>"Time is </span>{</span>str_time</span>[</span>i</span>+</span>2</span>:]</span>}</span>"</span>)</span> </span></span>
</span>
ble</span>.</span>start_notify</span>(</span>ble</span>.</span>uuid</span>[</span>'</span>RX_STRING</span>'</span>],</span> time_extractor</span>)</span></span></code></pre></iframe>
Sending Time in a Loop</h3>
We start by sending time in a loop. I do this by making a command that gets the time and transmits it in a loop. From there, the notification handler parses and prints the data.</p>
case LOOP_TIME:</span></span>
    Serial.</span>println</span>(</span>"Sending Loop Time"</span>);</span></span>
    for</span> (</span>i </span>=</span> 0</span>;</span> i </span><</span> TIME_ARR_SIZE</span>;</span> i</span>++</span>) {</span></span>
        tx_estring_value</span>.</span>clear</span>();</span></span>
        tx_estring_value</span>.</span>append</span>((</span>int</span>)</span> millis</span>());</span></span>
        tx_characteristic_string</span>.</span>writeValue</span>(</span>tx_estring_value</span>.</span>c_str</span>());</span></span>
    }</span></span>
    Serial.</span>println</span>(</span>"Loop Complete"</span>);</span></span>
    break</span>;</span></span></code></pre></iframe>
SEND_TIME_DATA (Sending Time in and Array)</h3>
Next, we transmit the data by storing the values in an array, then transmitting all at once.</p>
case SEND_TIME_DATA:</span></span>
    Serial.</span>println</span>(</span>"Filling Time"</span>);</span></span>
    for</span> (</span>i </span>=</span> 0</span>;</span> i </span><</span> TIME_ARR_SIZE</span>;</span> i</span>++</span>) {</span></span>
        time_stamps</span>[</span>i</span>]</span> =</span> (</span>int</span>)</span> millis</span>();</span></span>
    }</span>            </span></span>
    Serial.</span>println</span>(</span>"Time Array Complete"</span>);</span></span>
    Serial.</span>println</span>(</span>"Sending Array Time"</span>);</span></span>
    for</span> (</span>i </span>=</span> 0</span>;</span> i </span><</span> TIME_ARR_SIZE</span>;</span> i</span>++</span>) {</span></span>
        tx_estring_value</span>.</span>clear</span>();</span></span>
        tx_estring_value</span>.</span>append</span>(</span>time_stamps</span>[</span>i</span>]);</span></span>
        tx_characteristic_string</span>.</span>writeValue</span>(</span>tx_estring_value</span>.</span>c_str</span>());</span></span>
    }</span>            </span></span>
    Serial.</span>println</span>(</span>"Array Complete"</span>);</span></span>
    break</span>;</span></span></code></pre></iframe>
GET_TEMP_READINGS (Sending Temperature)</h3>
Similar to SEND_TIME_DATA</code>, we fill 2 arrays with data for the time stamp and the current temperature reading. Then, we transmit the data.</p>
case GET_TEMP_READINGS:</span></span>
    Serial.</span>println</span>(</span>"Filling Readings"</span>);</span></span>
    for</span> (</span>i </span>=</span> 0</span>;</span> i </span><</span> TIME_ARR_SIZE</span>;</span> i</span>++</span>) {</span></span>
        float</span> temp_f </span>=</span> getTempDegF</span>();</span></span>
        time_stamps</span>[</span>i</span>]</span> =</span> (</span>int</span>)</span> millis</span>();</span></span>
        temp_readings</span>[</span>i</span>]</span> =</span> getTempDegF</span>();</span></span>
    }</span>            </span></span>
    Serial.</span>println</span>(</span>"Time Array Complete"</span>);</span></span>
    Serial.</span>println</span>(</span>"Sending Array Time"</span>);</span></span>
    for</span> (</span>i </span>=</span> 0</span>;</span> i </span><</span> TIME_ARR_SIZE</span>;</span> i</span>++</span>) {</span></span>
        tx_estring_value</span>.</span>clear</span>();</span></span>
        tx_estring_value</span>.</span>append</span>(</span>time_stamps</span>[</span>i</span>]);</span></span>
        tx_estring_value</span>.</span>append</span>(</span>":"</span>);</span></span>
        tx_estring_value</span>.</span>append</span>(</span>temp_readings</span>[</span>i</span>]);</span></span>
        tx_characteristic_string</span>.</span>writeValue</span>(</span>tx_estring_value</span>.</span>c_str</span>());</span></span>
    }</span>            </span></span>
    Serial.</span>println</span>(</span>"Array Complete"</span>);</span></span>
    break</span>;</span></span></code></pre></iframe>
Discussion</h3>
Loop vs Array</h4>
We can clearly see that the time stamps are much closer together when the data is first stored in array, and then transmitted, like in SEND_TIME_DATA</code>. The LOOP_TIME</code> transmission shows a delay of about 66.6 ms. Meanwhile, all 10 datapoints from SEND_TIME_DATA</code> and in the same millisecond. This shows that if we want to collect data quickly, we should be storing it in an array. But, if we want to transmit the most up-to-date data, then sending data in a loop makes more sense.</p>
Amount of Data</h4>
We transmit time as an int</code> which is 4B. If all the Artemis RAM is used to store time, we could store at most 96000 time values. This is assuming no other data is in RAM and no other overhead is needed be to stored.</p>
Effective Data Rate, Overhead, and Reliablility</h3>
To observe the data rate of messages of different sizes, I observe the time between transmitting and recieving a string of various lengths. Since each character is 1 byte, the string length is the same as the byte size of the message. I form the string first, record the start time, then transmit. I tested 100 transmission of each byte size and then graphed the average time.</p>

From this graph, we see that smallest and largest packet size show a similar transmission time. This indicates the small packets do introduce a lot of overhead. We see the round trip time spike when the data packets are 100-120 bytes. Overall, the data rate doesn’t seem to change too much when the data size changes, showing that there is limited overhead on the messages in general.</p>
Even as the data rate changed, no packets were dropped at any point. This shows that the computer does read all the data from the Artemis.</p>
Implementation</h4>
This command was used to send back the recieved data.</p>
case DATA_RATE_ANALYSIS:</span></span>
    char</span> message_arr</span>[</span>MAX_MSG_SIZE</span>];</span></span>
    // Extract the next value from the command string as a character array</span></span>
    success </span>=</span> robot_cmd.</span>get_next_value</span>(</span>message_arr</span>);</span></span>
    if</span> (</span>!</span>success</span>)</span></span>
        return</span>;</span></span>
    </span></span>
    tx_estring_value.</span>clear</span>();</span></span>
    tx_estring_value.</span>append</span>(</span>message_arr</span>);</span></span>
    tx_characteristic_string.</span>writeValue</span>(</span>tx_estring_value.</span>c_str</span>());</span></span>
    break</span>;</span></span></code></pre>
On the python side, we choose to take 100 samples of strings from 1 byte to 140 bytes.</p>
max_byte_size</span> =</span> 141</span></span>
samples</span> =</span> 100</span></span>
</span>
start_times</span> =</span> [[]</span> for</span> _</span> in</span> range</span>(</span>max_byte_size</span>)]</span></span>
end_times</span> =</span> [[]</span> for</span> _</span> in</span> range</span>(</span>max_byte_size</span>)]</span></span></code></pre>
A notification handler is set up to recieve messages and add the end time to the appropiate array spot.</p>
def</span> recieved_time_getter</span>(</span>uuid</span>,</span> byte_message</span>):</span>    </span></span>
    end_time</span> =</span> time</span>.</span>time</span>()</span></span>
    mess</span> =</span> ble</span>.</span>bytearray_to_string</span>(</span>byte_message</span>)</span></span>
    end_times</span>[</span>len</span>(</span>mess</span>)].</span>append</span>(</span>end_time</span>)</span></span>
 </span></span>
        </span></span>
ble</span>.</span>start_notify</span>(</span>ble</span>.</span>uuid</span>[</span>'</span>RX_STRING</span>'</span>],</span> recieved_time_getter</span>)</span></span></code></pre>
Then, we transmit messages of various sizes. We record the time they’re transmitted and sleep to ensure transmissions don’t conflict with eachother.</p>
for</span> i</span> in</span> range</span>(</span>1</span>,</span> max_byte_size</span>-</span>1</span>):</span></span>
    for</span> _</span> in</span> range</span>(</span>samples</span>):</span></span>
        message</span> =</span> "a"</span>*</span>i</span></span>
        start</span> =</span> time</span>.</span>time</span>()</span></span>
        ble</span>.</span>send_command</span>(</span>CMD</span>.</span>DATA_RATE_ANALYSIS</span>,</span> message</span>)</span></span>
        start_times</span>[</span>i</span>].</span>append</span>(</span>start</span>)</span></span>
        time</span>.</span>sleep</span>(</span>.05</span>)</span></span>
print</span>(</span>"done"</span>)</span></span></code></pre>
Finally, we compute the rtt and graph the mean.</p>
ble</span>.</span>stop_notify</span>(</span>ble</span>.</span>uuid</span>[</span>'</span>RX_STRING</span>'</span>])</span></span>
</span>
start</span> =</span> np</span>.</span>array</span>(</span>start_times</span>[</span>1</span>:</span>max_byte_size</span>-</span>1</span>])</span></span>
end</span> =</span> np</span>.</span>array</span>(</span>end_times</span>[</span>1</span>:</span>max_byte_size</span>-</span>1</span>])</span></span>
</span>
durations</span> =</span> end</span> -</span> start</span></span>
rtt</span> =</span> durations</span>.</span>mean</span>(</span>axis</span>=</span>1</span>)</span></span>
</span>
plt</span>.</span>plot</span>(</span>rtt</span>)</span></span>
plt</span>.</span>xlabel</span>(</span>"Message Size (bytes)"</span>)</span></span>
plt</span>.</span>ylabel</span>(</span>"Round Trip Time (ms)"</span>)</span></span>
plt</span>.</span>show</span>()</span></span></code></pre>Collaboration</h2>
This lab was complete with discussion with Dyllan Hofflich and Shao Stassen. Lab writeups from previous students such as Lucca Correia, Aiden McNay, and Sana Chawla were refferenced.</p>

Ananya's Portfolio - Bluetooth

Lab 1: Artemis and Bluetooth

Lab 1A</h2> The first part of this lab demostrates how to program the RedBoard Artemis Nano and explores some of the features via demo code files.</p>

Basic Setup</h3> To start this lab, the Artemis Redboard Nano is connected to a laptop. We use the Arduino IDE to program it.</p>

Running Blink</h3> Like with most microntroller projects, we start with making the onboard led blink. The demo code initializes the built-in led as the output, then repeated turns it on and off with a second delay in between each action.</p> </iframe>

Testing the Temperature Sensor</h3> The “analog read” demo code allows us to read the output of the Artemis builtin temperature sensor.</p>

Testing the Microphone</h3> Finally, the Microphone Ouptut demo allows use to see the loudest frequency detected by the onboard microphone. You can see the result of my high pitch whisper screaming into the microphone below.</p>

Discussion</h3>

Collaboration</h2> This lab was complete with discussion with Dyllan Hofflich and Shao Stassen. Lab writeups from previous students such as Lucca Correia, Aiden McNay, and Sana Chawla were refferenced.</p>

Lab 1A</h2>
The first part of this lab demostrates how to program the RedBoard Artemis Nano and explores some of the features via demo code files.</p>

Basic Setup</h3>
To start this lab, the Artemis Redboard Nano is connected to a laptop. We use the Arduino IDE to program it.</p>

Running Blink</h3>
Like with most microntroller projects, we start with making the onboard led blink. The demo code initializes the built-in led as the output, then repeated turns it on and off with a second delay in between each action.</p> </iframe>

Testing the Temperature Sensor</h3>
The “analog read” demo code allows us to read the output of the Artemis builtin temperature sensor.</p>

Testing the Microphone</h3>
Finally, the Microphone Ouptut demo allows use to see the loudest frequency detected by the onboard microphone. You can see the result of my high pitch whisper screaming into the microphone below.</p>

Collaboration</h2>
This lab was complete with discussion with Dyllan Hofflich and Shao Stassen. Lab writeups from previous students such as Lucca Correia, Aiden McNay, and Sana Chawla were refferenced.</p>