Skip to content
This repository has been archived by the owner on Nov 25, 2024. It is now read-only.

Commit

Permalink
Update USER_GUIDE.MD
Browse files Browse the repository at this point in the history
  • Loading branch information
KierPalin authored Sep 6, 2024
1 parent 850c2d3 commit 534a8f5
Showing 1 changed file with 8 additions and 2 deletions.
10 changes: 8 additions & 2 deletions USER_GUIDE.MD
Original file line number Diff line number Diff line change
Expand Up @@ -17,17 +17,23 @@ The latest stable release of MicroData is available ![here](https://github.com/K
* 020: Out of memory! Your program is so big that it does not fit in memory anymore… or we have a memory leak somewhere. Try resetting the micro:bit. This could occur if the datalog has a huge number of entries. You could try copying the MY_DATA.HTM file from the Microbit onto your PC and then resetting the datalog - either via MicroData or by deleting the MY_DATA.HTM file that is on the Microbit.

# Real-time graphing
MicroData can be used to see the readings of multiple sensors at once in real-time. The image below shows the accelerometer and temperature readings. You can scoll up and down to see information about these sensors, pressing A allows you to enable or disable them. Pressing A on the main graph will alow you to zoom in for a better view. ![live_data_viewer](https://github.com/KierPalin/MicroData/blob/main/resources/live_data_viewer.png?raw=true)
MicroData can be used to see the readings of multiple sensors at once in real-time. The image below shows the accelerometer and temperature readings. You can scoll up and down to see information about these sensors, pressing A allows you to enable or disable them. Pressing A on the main graph will alow you to zoom in for a better view.

![live_data_viewer](https://github.com/KierPalin/MicroData/blob/main/resources/live_data_viewer.png?raw=true)

Selecting the analog pins as sensors and connecting a wire to the pins of the Arcade Shield will allow you to see the flow of current in real-time.

# Recording data
MicroData allows you to select and independently configure multiple sensors to log at once. The information about the sensor, the time the reading was taken and the value of the sensor are stored in flash storage. This means that the information persists even when unpowered, and that you can see them on device. These logs can be viewed in a tabular format without the need of an connection to an external device. Connecting the microbit to a computer also allows you to get the MY_DATA.HTM file that contains these logs. Below are images of the tabular data viewer - which shows the logs for the 3 accelerometers.

![tabular_data_viewer_1](https://github.com/KierPalin/MicroData/blob/main/resources/tabular_data_viewer_1.png?raw=true)

You can scroll left and right to see the other columns:

![tabular_data_viewer_2](https://github.com/KierPalin/MicroData/blob/main/resources/tabular_data_viewer_2.png?raw=true)

MicroData also supports recording events. You can configure a sensor to only record readings that match an inequality condition - such as only taking a log of the temperature when the reading is > 20. The screen below shows the configuration screen for the Accelerometer on the X dimension. This screen is entered after pressing 'Done' on the sensor select screen().

![configuration_selection](https://github.com/KierPalin/MicroData/blob/main/resources/configuration_selection.png?raw=true)


Expand All @@ -38,4 +44,4 @@ There is only ever one Commander, it controls multiple Target microbits. The Com
1. See a list of the connected Targets
2. Select & configure sensors to log and make the Target microbits log them.
3. Select & configure sensors to log and make the Target microbits log them + send a copy of that log back to the Commander to log.
4. View a real-time data stream of the data that the Target's are logging.
4. View a real-time data stream of the data that the Target's are logging.

0 comments on commit 534a8f5

Please sign in to comment.