pull/58/head
fhdm-dev 2022-03-01 18:28:04 +11:00
rodzic 6ca9cd9e0e
commit 1bdf456a70
10 zmienionych plików z 104 dodań i 24 usunięć

Wyświetl plik

@ -11,7 +11,7 @@ The aim of the Scoppy project is to give electronics novices and hobbyists acces
* A Rasperry Pi Pico board
> Important
> Please use the latest versions of the App (v1.016) and Firmware (v8). Older versions of the firmware may not work with the latest version of the app and vice versa
> Please use the latest versions of the App (v1.017) and Firmware (v9). Older versions of the firmware may not work with the latest version of the app and vice versa
## Quick Start
@ -21,7 +21,7 @@ Install the [Scoppy Android app](https://play.google.com/store/apps/details?id=x
### 2. Install the firmware onto your Pico
Download the firmware onto your computer. It is here: [pico-scoppy-v8.uf2](https://fhdm-dev.github.io/downloads/scoppy-pico-v8.uf2). Alternatively you can [build the uf2 file](https://github.com/fhdm-dev/scoppy-pico) from the sources.
Download the firmware onto your computer. It is here: [pico-scoppy-v9.uf2](https://fhdm-dev.github.io/downloads/scoppy-pico-v9.uf2). Alternatively you can [build the uf2 file](https://github.com/fhdm-dev/scoppy-pico) from the sources.
Press the bootsel button on your Pico and connect it to your computer. Copy the uf2 file onto your Pico. The onboard LED should start blinking.

Wyświetl plik

@ -60,5 +60,6 @@ exclude:
#
# - index.md
# - none.markdown
# If this points to a real page an Index link is inserted at the top of each page
header_pages:
- TOC.md
- none.md

Wyświetl plik

@ -3,14 +3,29 @@ title: Signal Generator
---
Scoppy includes a very basic (PWM) signal generator. This is accessed by tapping the SIGNAL GENERATOR
button on the menu panel.
button on the menu panel. The signal is ouput on GPIO 22.
You can choose from a 50% duty cycle square wave at various frequencies and a PWM encoded sine wave.
Using a low pass filter the PWM encoded sine wave can
be used to generate an analog signal.
When the Pico is powered on the signal defaults to a 1kHz square wave.
### Signal Type
#### Square Wave
Generates a square wave between 100Hz and 1.25MHz with a 50% duty cycle.
#### Sine Wave (PWM)
Generates a square wave where the duty cycle changes according to the sine function. The frequency
of the sine wave is 1kHz.
This PWM signal can be converted to a sine wave by the addition of a low pass filter.
A filter using a 1k resistor and 0.1uF capacitor should work.
See this [All About Circuits](https://www.allaboutcircuits.com/technical-articles/low-pass-filter-a-pwm-signal-into-an-analog-voltage/) article for more information.
#### None
Turns off signal generation.
<br>
[App Help](.)
[All Documentation](../TOC)
[All Documentation](../)
[Scoppy on GitHub](https://github.com/fhdm-dev/scoppy)

Wyświetl plik

@ -0,0 +1,48 @@
---
title: XY Mode
---
The XY display plots the values of CH1 against CH2. This is different to the normal (YT) mode where voltage is plotted as a
function of time. CH1 is used for the deviation along the X axis and CH2 for the Y axis.
<br>
### How to enable XY mode
From the menu tap the Display button. Tap either:
* XY to display just the XY plot
* XY + YT to display the XY plot and the normal YT scope output
To hide the XY display, tap the Display button and then select YT (Default)
<br>
### Channel Volts/Div and Position
The Channel Volts/Div and Position settings can be used as normal in XY mode. Changing the values for
CH1 will affect the scale and postion in the X direction. Changing the values for CH2 will affect the scale
and position in the Y direction.
Tip: To quickly set the Volts/Div or Position of a channel back to its default value, tap and hold the appropriate button.
<br>
### Horizontal Time/Div and Position
Only the samples visible in YT display window are used to generate the XY plot. ie. The entire sample record is not used unless
the Time/Div has been adjusted so that the traces visible on the YT screen include all sample points.
This allows you to control which part of the sample record is used to generate the XY plot.
A maximum of 1000 samples are displayed in the XY plot.
<br>
### Dots vs Lines
The points in the XY plot can be displayed as either unconnected dots or as lines connecting adjacent (in time) values.
<br>
[App Help](.)
[All Documentation](../TOC)
[Scoppy on GitHub](https://github.com/fhdm-dev/scoppy)

Wyświetl plik

@ -15,6 +15,7 @@ title: App Help Index
* [Channels - Logic Analyzer Mode](Channels-Logic-Analyzer)
* [Measurements](Measurements)
* [Cursors](Cursors)
* [XY Mode](XY)
* [Sample Rate - Auto vs Fixed](Sample-Rate)
* [Signal Generator](Signal-Generator)
* [Release Notes](../wiki/ReleaseNotes)

Wyświetl plik

@ -27,3 +27,5 @@ title: Scoppy
* Experiments, tutorials and examples using Scoppy
[Release Notes](./wiki/ReleaseNotes)
[Scoppy on GitHub](https://github.com/fhdm-dev/scoppy)

Wyświetl plik

@ -7,7 +7,7 @@ title: Installation
Install the [Scoppy Android app](https://play.google.com/store/apps/details?id=xyz.fhdm.scoppy) from the Play Store.
### 2. Install the Firmware
Download the [pico-scoppy-v8.uf2](https://fhdm-dev.github.io/downloads/scoppy-pico-v8.uf2) file to your computer.
Download the [pico-scoppy-v9.uf2](https://fhdm-dev.github.io/downloads/scoppy-pico-v9.uf2) file to your computer.
Alternatively you can [build the uf2 file](https://github.com/fhdm-dev/scoppy-pico) from the sources.
Push and hold the BOOTSEL button on the Pico, then connect it to your computer using a micro USB cable. Release BOOTSEL once the drive RPI-RP2 appears on your computer. Copy the uf2 file to your Pico.

Wyświetl plik

@ -2,6 +2,24 @@
title: Release Notes
---
### Android App v1.017 - Pico Firmware v9
#### XY Mode
To enable XY mode, tap Menu and then Display. The XY plot can be displayed on its own or together with the normal YT grid.
#### Other improvements
- In the signal generator screen you can now specify an exact frequency value. Tap the frequency dropdown menu
and then tap Custom. Enter the frequency.
- The app will now show a warning if you've set the Time/Div to a value that would cause the waveform to not be visible
- Voltage ranges can be compiled in the firmware and uploaded to the app automatically. Useful if you use the same Android Device with different front ends.
#### Bugs fixed
- Y cursor info showing incorrect value
- Not enough precision in trigger level dialog
- Tapping Help in the on-screen measurements dialog would actually change the settings
- App would sometimes crash when connecting/disconnecting the Pico
- The disabled channel would be used for the horizontal cursor info
### Android App v1.016 - Pico Firmware v8
#### On-screen measurement configuration

Wyświetl plik

@ -0,0 +1,10 @@
<!DOCTYPE html>
<html>
<head>
<title>HTML Meta Tag</title>
<meta http-equiv = "refresh" content = "0; url = https://oscilloscope.fhdm.xyz/app-help/Signal-Generator" />
</head>
<body>
<p></p>
</body>
</html>

Wyświetl plik

@ -1,15 +0,0 @@
---
title: Signal Generator
---
### Square Wave
Generates a square wave on GPIO 22. The frequency defaults to 1kHz.
### Sine Wave (PWM)
Generates a square wave on GPIO 22 where the duty cycle changes according to the sine function. The frequency
of the sine wave is 1kHz.
This PWM signal can be converted to a sine wave by the addition of a low pass filter.
A filter using a 1k resistor and 0.1uF capacitor should work.
See this [All About Circuits](https://www.allaboutcircuits.com/technical-articles/low-pass-filter-a-pwm-signal-into-an-analog-voltage/) article for more information.