Deprecating old radio APIs and fixing docs (#289)
This commit is contained in:
committed by
Peli de Halleux
parent
ba69563bf4
commit
ec404e5887
@ -1,20 +1,20 @@
|
||||
# Seismograph Challenge
|
||||
# Seismograph Challenge
|
||||
|
||||
Coding challenges for the seismograph.
|
||||
Coding challenges for the seismograph.
|
||||
|
||||
|
||||
### ~avatar avatar
|
||||
|
||||
Engineering: In this project, you will build a remote control based on the seismograph micro:bit activity using a second micro:bit and micro USB cable.
|
||||
Engineering: In this project, you will build a remote control based on the seismograph micro:bit activity using a second micro:bit and micro USB cable.
|
||||
|
||||
### ~
|
||||
|
||||
## What you'll need:
|
||||
## What you'll need:
|
||||
|
||||
* BBC micro:bits (2)
|
||||
* micro USB cables (2)
|
||||
* Plate
|
||||
* Tape
|
||||
* micro USB cables (2)
|
||||
* Plate
|
||||
* Tape
|
||||
* Scissors
|
||||
|
||||

|
||||
@ -30,14 +30,14 @@ basic.forever(() => {
|
||||
|
||||
```
|
||||
|
||||
### ~avatar avatar
|
||||
### ~avatar avatar
|
||||
Computer Science: Welcome! The activity will teach you how to code the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. Let's get started!
|
||||
### ~
|
||||
|
||||
# Computer Science Steps
|
||||
|
||||
## 1.
|
||||
We want to simply detach the blocks from the recent activity. We will use blocks from the activity to create a brand new program to show the way micro:bit devices communicate through the BLE (Bluetooth low energy) radio.
|
||||
We want to simply detach the blocks from the recent activity. We will use blocks from the activity to create a brand new program to show the way micro:bit devices communicate through the BLE (Bluetooth low energy) radio.
|
||||
|
||||
```shuffle
|
||||
basic.forever(() => {
|
||||
@ -46,10 +46,10 @@ basic.forever(() => {
|
||||
|
||||
```
|
||||
|
||||
## 2.
|
||||
## 2.
|
||||
Let's measure `acceleration (mg)` and then `send number`. `Acceleration` is measured in **milli-gravities**, so a value of -1000 is equivalent to -1g or -9.81m/s^2. We will be able to get the acceleration value (g-force), in the specified "x" dimension. `Send number` will broadcast a number data packet to other micro:bits connected via radio.
|
||||
|
||||
We need add send number block found in the Radio drawer. We will attach send number to acceleration and subtract the gravity from acceleration strength.
|
||||
We need add send number block found in the Radio drawer. We will attach send number to acceleration and subtract the gravity from acceleration strength.
|
||||
|
||||
Your finished code will look like this:
|
||||
|
||||
@ -57,8 +57,8 @@ Your finished code will look like this:
|
||||
radio.sendNumber(input.acceleration(Dimension.Strength) - 1023);
|
||||
```
|
||||
|
||||
## 3.
|
||||
We want to display the acceleration forever. In order to do so, we need a `forever` loop. A forever loop will repeat code in the background forever. We need attach forever loop to send number.
|
||||
## 3.
|
||||
We want to display the acceleration forever. In order to do so, we need a `forever` loop. A forever loop will repeat code in the background forever. We need attach forever loop to send number.
|
||||
|
||||
Your finished code will look like this:
|
||||
|
||||
@ -69,7 +69,7 @@ basic.forever(() => {
|
||||
|
||||
```
|
||||
|
||||
## 4.
|
||||
## 4.
|
||||
We want to register code to run when a packet is received over radio. We can implement this code by adding `on data received`block found in the radio drawer.
|
||||
|
||||
Your finished code will look like this:
|
||||
@ -78,12 +78,12 @@ Your finished code will look like this:
|
||||
basic.forever(() => {
|
||||
radio.sendNumber(input.acceleration(Dimension.Strength) - 1023);
|
||||
});
|
||||
radio.onDataReceived(() => {
|
||||
radio.onDataPacketReceived(() => {
|
||||
});
|
||||
|
||||
```
|
||||
|
||||
## 5.
|
||||
## 5.
|
||||
Finally, we want to chart the acceleration. So we must first implement `plot bar graph`. `Plot Bar Graph` will display a vertical bar graph based on the value and high value. In order to transfer the receive the number from the 1st micro:bit, we must implement `receive number` to constantly display a vertical bar graph based on the value. Remember, the value will equal to the micro:bit's acceleration in the "x" direction.
|
||||
|
||||
Your finished code will look like this:
|
||||
@ -92,25 +92,25 @@ Your finished code will look like this:
|
||||
basic.forever(() => {
|
||||
radio.sendNumber(input.acceleration(Dimension.Strength) - 1023);
|
||||
});
|
||||
radio.onDataReceived(() => {
|
||||
led.plotBarGraph(radio.receiveNumber(), 0);
|
||||
radio.onDataPacketReceived(({ receivedNumber }) => {
|
||||
led.plotBarGraph(receivedNumber, 0);
|
||||
});
|
||||
```
|
||||
|
||||
### ~avatar avatar
|
||||
### ~avatar avatar
|
||||
Science: Welcome! The activity will teach you how to chart the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. Let's get started!
|
||||
### ~
|
||||
|
||||
# Science Steps
|
||||
|
||||
## 6.
|
||||
## 6.
|
||||
First, notice that moving the 1st micro:bit in the simulator in any direction, you will change the acceleration value of the 2nd micro:bit. Also, notice that by moving the micro:bit simulator, there is a changing acceleration value of the second micro:bit. Second, the flat colored horizontal line will start a waving line on the 2nd micro:bit to display the value of the strength as measured in milli-gravities. Finally, notice that the LED display will fluctate based on the movement of the 2nd micro:bit simulator.
|
||||
|
||||

|
||||
|
||||
## 7.
|
||||
|
||||
Connect the 2nd micro:bit to your computer using your USB cable. We should have two micro:bit devices attached to the computer.
|
||||
## 7.
|
||||
|
||||
Connect the 2nd micro:bit to your computer using your USB cable. We should have two micro:bit devices attached to the computer.
|
||||
|
||||

|
||||
|
||||
@ -118,7 +118,7 @@ Connect the 2nd micro:bit to your computer using your USB cable. We should have
|
||||
|
||||
Click or tap the **Download** button for the seismograph program to run the program on the 1st micro:bit and 2nd micro:bit.
|
||||
|
||||
## 9.
|
||||
## 9.
|
||||
|
||||
The black lines should appear directly beneath the colored lines. The black lines measure the micro:bit acceleration. And the colored lines measures micro:bit simulator acceleration.
|
||||
|
||||
@ -134,34 +134,34 @@ Every time the micro:bit moves in any direction, you generate data points that c
|
||||
|
||||
Now we are ready to graph or chart the accceleration of the micro:bit. We want a printout of the micro:bit acceleration graphed in Excel.
|
||||
|
||||
## 10.
|
||||
## 10.
|
||||
|
||||
In order to receive the the data plotted by Excel, click or tap anywhere in the on the chart data.
|
||||
|
||||

|
||||
|
||||
## 11.
|
||||
## 11.
|
||||
|
||||
You have two options to Analyze Data:
|
||||
You have two options to Analyze Data:
|
||||
|
||||
* Local File: Save the data to your local Downloads folder and open it in Excel.
|
||||
* Stream to Cloud: Upload your data to Microsoft Azure to analyze it.
|
||||
* Local File: Save the data to your local Downloads folder and open it in Excel.
|
||||
* Stream to Cloud: Upload your data to Microsoft Azure to analyze it.
|
||||
|
||||
Click or tap Download data
|
||||
|
||||

|
||||
|
||||
## 12.
|
||||
## 12.
|
||||
|
||||
A CSV file will be generated to display the data points collected by the micro:bit. Click or tap on the data Excel file that was downloaded to your local Downloads Folder.
|
||||
A CSV file will be generated to display the data points collected by the micro:bit. Click or tap on the data Excel file that was downloaded to your local Downloads Folder.
|
||||
|
||||

|
||||
|
||||
## 13.
|
||||
|
||||
Select the data that you want to include in your chart. The chart should include the first two columns: time and acceleration.
|
||||
Select the data that you want to include in your chart. The chart should include the first two columns: time and acceleration.
|
||||
|
||||
Click or tap on the first two columns (A, B) to include time and acceleration data from the micro:bit. We only need the first two columns (A, B) because the 2nd micro:bit changes have been communicated by the 1st micro:bit. So the data points of the seismograph are being recorded on the 1st micro:bit.
|
||||
Click or tap on the first two columns (A, B) to include time and acceleration data from the micro:bit. We only need the first two columns (A, B) because the 2nd micro:bit changes have been communicated by the 1st micro:bit. So the data points of the seismograph are being recorded on the 1st micro:bit.
|
||||
|
||||
## 14.
|
||||
|
||||
@ -169,23 +169,23 @@ Click or tap on Insert then select Recommended Charts. We can select a chart tha
|
||||
|
||||

|
||||
|
||||
On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
|
||||
On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
|
||||
|
||||
We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time.
|
||||
We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time.
|
||||
|
||||
Click on the chart type to see how your data will look in that format. When you find the chart type that you want, click it, and then click OK.
|
||||
Click on the chart type to see how your data will look in that format. When you find the chart type that you want, click it, and then click OK.
|
||||
|
||||

|
||||
|
||||
Tip: If you don’t see the line chart, click the All Charts tab to see the line chart.
|
||||
|
||||
## 15.
|
||||
## 15.
|
||||
|
||||
Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
|
||||
|
||||
Alternatively, click or tap on the Design Ribbon.
|
||||
Alternatively, click or tap on the Design Ribbon.
|
||||
|
||||
Let's select Style 10 as an example.
|
||||
Let's select Style 10 as an example.
|
||||
|
||||

|
||||
|
||||
|
Reference in New Issue
Block a user