1. Introduction

1.1 What is FizziQ Web?

FizziQ Web is a free web application that supports students throughout their scientific and experimental process. From data capture to communicating results, FizziQ Web provides all the tools needed to run a complete experimentation session on a computer.

1.2 The three pillars of FizziQ Web

FizziQ Web is organized around three main features that correspond to the three stages of the scientific process:

Experiment: capturing data

FizziQ Web offers five data sources, all compatible with one another:

• Audio analysis: recording and analyzing sound through the computer's microphone (sound level, frequency, spectrum, spectrogram)
• Kinematic analysis: tracking videos and chronophotographs to study motion (positions, velocities, accelerations)
• External sensors: connection to FizziQ Connect or microcontrollers (Arduino, micro:bit) via Bluetooth or USB
• Manual entry: creating data tables filled in by the student
• Simulations: virtual experiments (pendulum, spring, ballistics, circuits, waves, ideal gas...) generating usable data

Analyze: organizing and understanding data

All captured data arrives in the experiment notebook as observation cards. The student can:

• Organize their data in tables
• Add columns and create calculated quantities (formulas)
• Define the units of each quantity
• Create graphs with different scales
• Perform modeling and curve fitting

Share: communicating your results

Once the analysis is complete, the student can create a final report that summarizes their research:

• Writing explanatory text
• Inserting photos and diagrams
• Integrating tables and graphs from the experiment notebook
• Adding mathematical formulas (LaTeX syntax)
• Exporting to PDF, Word, or image

1.3 Detailed features

1.3 Browser compatibility

1.4 Differences from FizziQ mobile

FizziQ Web complements the mobile application:

• No built-in sensors: a computer has no accelerometer or GPS (use FizziQ Connect for external sensors)
• Advanced audio analysis: high-resolution spectrogram, detailed analysis
• Complete video analysis: kinematic tracking, calculation of velocities and accelerations
• Physics simulations: pendulum, spring, ballistics, circuits, waves, ideal gas, inclined plane, centrifuge
• Larger screen: ideal for data analysis, graphs, and reports
• Document editor: scientific reports with LaTeX formulas

1.5 Privacy and free access

2. Getting started

2.1 Accessing FizziQ Web

1. Open your Chrome or Edge browser
2. Go to fizziqweb.web.app
3. Click Experiment to access the tools

2.2 General interface

The FizziQ Web interface is organized around a left-hand side menu:

• Home: home page and quick access
• Experiment: access to the analysis and simulation modules
  • Audio analysis
  • Video analysis
  • Chronophotographs
  • External sensors (FizziQ Connect)
  • Data table
  • Simulations
• Analyze: data analysis tools
• Share: screen sharing and export
• Discover: educational activities and resources
• Tools: additional tools (calculator, synthesizer...)
• Settings: application settings

2.3 Your first measurement: analyzing a sound

Here is how to carry out your first audio analysis:

1. Click Experiment → Audio analysis
2. Click Audio Source → Sound library
3. Select Tuning fork A3 (440 Hz)
4. Observe the waveform and the frequency spectrum
5. Use the scroll wheel or the Zoom buttons to see the details
6. Click Add to notebook to export the analysis

3. Audio analysis - Experiment

3.1 Audio sources

You can analyze sound in several ways:

• Record with the computer's microphone
• Load an audio file (WAV, MP3, OGG, FLAC, M4A)
• Built-in sound library

Sound library

The built-in library offers many educational sounds:

• 440 Hz tuning fork: pure reference tone
• Musical instruments: piano, guitar, flute, violin...
• White noise: all frequencies
• Siren: frequency variation
• Doppler effect: demonstration of the frequency shift
• Risset bells: auditory illusion of an endless rise
• Beats: interference of two nearby frequencies

3.2 Analysis modes

3.3 Reading the spectrogram

The spectrogram displays the evolution of the frequency spectrum over time. It is a powerful tool for analyzing complex sounds.

Color code:

• Black: silence
• Blue: low intensity
• Yellow: medium intensity
• Red: maximum intensity

Examples of spectrogram uses

• Melody: observe the successive notes
• Voice: analyze formants and harmonics
• Doppler effect: visualize the frequency shift
• Instruments: compare timbres

3.4 Measurement tools

• Interactive cursor: click on the graph to measure a precise point
• Zoom: scroll wheel or +/- buttons to enlarge
• Synchronization: audio playback synchronized with the display
• Min/max display: visualize the envelope of the signal

3.5 Exporting audio data

Depending on the analysis mode, you can export:

• Amplitude mode: Time (s), Amplitude
• Frequency mode: Time (s), Frequency (Hz)
• Spectrum mode: Frequency (Hz), Magnitude
• Spectrogram: data table or image

4. Video analysis - Experiment

FizziQ Web includes a complete kinematic video analysis module, allowing you to study the motion of objects from videos.

4.1 Importing videos

Supported formats: MP4, WebM, MOV, AVI, and most common video formats.

1. Click Experiment → Video analysis
2. Click Load a video
3. Select your video file
4. The video appears in the tracking interface

4.2 Scale calibration

Before tracking, you must calibrate the scale to convert pixels into meters:

1. Click Calibrate the scale
2. Click on the two ends of a reference object (ruler, meter stick...)
3. Enter the actual length of the object
4. The scale is set for the entire analysis

4.3 Tracking positions

Tracking consists of recording the position of an object frame by frame:

1. Select the point to track (center of the object)
2. Click on the object in the first frame
3. Advance to the next frame (button or arrow)
4. Click on the new position of the object
5. Repeat until the end of the motion

4.4 Automatically calculated quantities

From the tracked positions, FizziQ Web automatically calculates:

4.5 Calculation methods

FizziQ Web offers several methods to calculate derivatives (velocity, acceleration):

• Linear interpolation: simple method, suited to slow motion
• Quadratic interpolation: more accurate method, reduces noise
• Smoothing: attenuation of measurement noise

4.6 Examples of video experiments

• Free fall: verify that a = g ≈ 9.8 m/s²
• Projectile launch: study the trajectory, verify that v_x = constant
• Circular motion: analyze the rotation, calculate the centripetal acceleration
• Oscillations: study a filmed pendulum or spring
• Collisions: verify the conservation of momentum

5. Chronophotographs - Experiment

A chronophotograph is an image showing the successive positions of a moving object, superimposed on a single image. FizziQ Web lets you analyze these images and also create them from videos.

5.1 Importing a chronophotograph

1. Click Experiment → Chronophotographs
2. Click Load an image
3. Select your image file (PNG, JPG...)
4. Calibrate the scale as for video
5. Track the successive positions of the object

5.2 Creating a chronophotograph from a video

FizziQ Web can convert a video into a chronophotograph:

1. Go to Tools → Video → chronophotograph converter
2. Load your video
3. Select the time interval between frames
4. Choose the number of frames to superimpose
5. Export the resulting image

5.3 Kinematic analysis

Analyzing a chronophotograph gives the same quantities as video analysis:

• Positions x(t) and y(t)
• Velocities v_x(t) and v_y(t)
• Accelerations a_x(t) and a_y(t)
• Trajectory in the (x, y) plane

5.4 Examples of chronophotographs

• Ball in free fall: increasing spacing (acceleration)
• Uniform motion: constant spacing
• Projectile: visible parabola
• Bounce: analysis of the phases before and after the impact

6. Physics simulations - Experiment

FizziQ Web offers eight interactive simulations that generate data usable in the experiment notebook. Each simulation lets you place virtual sensors and record measurements in real time.

6.1 Pendulum simulation

Objective: Study the oscillatory motion of a simple pendulum.

Parameters

Measurable quantities

• Tangential acceleration: a_t = -g sin(θ)
• Centripetal acceleration: a_n = L ω²
• Angle θ as a function of time
• Angular velocity ω
• Kinetic and potential energy

Usage

1. Set the length and the initial angle
2. Place the desired virtual sensors
3. Click REC then START to record
4. Click STOP to stop
5. The data is automatically added to the notebook

6.2 Spring oscillator simulation

Objective: Study the oscillations of a mass-spring system.

Parameters

Measurable quantities

• Position (elongation) x
• Velocity dx/dt
• Acceleration a = -(k/m)x - (b/m)v
• Kinetic energy and elastic potential energy

6.3 Ballistics simulation

Objective: Study the trajectory of a projectile.

Parameters

Equations (without friction)

• Horizontal position: x(t) = v₀ cos(α) t
• Vertical position: y(t) = v₀ sin(α) t - ½ g t²
• Maximum range at 45°: R = v₀² sin(2α) / g

With air resistance

Enable drag to observe:

• Reduction of the range
• Asymmetry of the trajectory
• Dependence on the mass

6.4 Electrical circuit simulation

Objective: Build and analyze electrical circuits.

Available components

• Sources: battery (DC voltage), AC generator (variable voltage)
• Elements: wires, resistors, lamps, switches, diodes
• Instruments: ammeter (in series), voltmeter (in parallel)

Building a circuit

1. Click a component in the toolbar
2. Move it into the work area
3. Connect the terminals by dragging them
4. The circuit works as soon as it is closed

6.5 Inclined plane simulation

Objective: Study uniformly accelerated rectilinear motion.

Parameters

Physics

• Acceleration: a = g sin(θ) - μ g cos(θ)
• At 90°: motion = free fall
• Galileo's principle: slow down free fall to observe it better

6.6 Waves on a lake simulation

Objective: Study the propagation of waves on the surface of water.

Parameters

Features

• Source: generates the waves
• Floats: measure the height of the water at their position
• Table mode: displays the float data
• Float animation: individual control of the motion

Observable phenomena

• Circular propagation of waves
• Relationship λ = v / f (wavelength = speed / frequency)
• Phase shift between two points
• Interference (with several sources)

6.7 Ideal gas simulation

Objective: Study the laws of ideal gases.

Parameters

Verifiable laws

• Boyle-Mariotte's law: PV = constant (at constant T)
• Gay-Lussac's law: P/T = constant (at constant V)
• Charles's law: V/T = constant (at constant P)
• Equation of state: PV = nRT

6.8 Centrifuge simulation

Objective: Study circular motion and centrifugal forces.

Measurable quantities

• Angular velocity ω
• Centripetal acceleration a_c = ω²R
• Apparent centrifugal force F = mω²R
• Rotation period T = 2π/ω

7. External sensors - Experiment

FizziQ Web lets you connect external sensors to take real physical measurements. Two options are available to you:

7.1 FizziQ Connect: overview

FizziQ Connect is a data acquisition box (computer-assisted experimentation) that lets you connect external sensors to FizziQ Web. Based on the ESP32 microcontroller, it uses standard Grove sensors.

7.2 Compatible sensors

7.3 Bluetooth connection

Advantages: wireless, mobility, field measurements.

Connection steps

1. Turn on FizziQ Connect and check that Bluetooth is enabled
2. Open FizziQ Web in Chrome or Edge
3. Click Experiment → External sensors
4. Click Bluetooth
5. Select your box from the list
6. Click Pair
7. The detected sensors appear automatically

7.4 USB connection

Advantages: stable connection, long-duration measurements, no battery.

Connection steps

1. Turn on FizziQ Connect
2. Connect it to the computer with a data USB-C cable
3. Open FizziQ Web
4. Click Experiment → External sensors
5. Click USB Serial
6. Select the corresponding port
7. Click Connect

7.5 Recording measurements

1. Once connected, select the sensors to use
2. Click REC to start recording
3. The data is displayed in real time
4. Click STOP to stop
5. The data is added to the experiment notebook

7.6 Connection troubleshooting

8. Experiment notebook - Analyze

8.1 Overview

The experiment notebook is the central space where you organize your data, graphs, and observations. All measurements (audio, video, simulations, sensors) are automatically added to it.

8.2 Structure of the notebook

The notebook is organized into numbered observations:

• Each observation can contain data, graphs, images, and text
• Observations can be reordered by drag-and-drop
• Click + Add to insert an observation into the document

8.3 Content types

• Data tables: raw measurement data
• Graphs: visualization of relationships between quantities
• Images: screenshots, photos, spectrograms
• Text: comments, analyses, conclusions
• Formulas: mathematical equations (see document editor)

8.4 Working with data

• Variable selection: choose which columns to display
• Calculated columns: add derived quantities (formulas)
• Sorting and filtering: organize the data
• Copy-paste: to Excel, Google Sheets...

8.5 Graphs

Graphs are generated automatically from the data:

• Curves: time evolution, relationships between quantities
• Scatter plots: discrete data
• Histograms: statistical distribution

Graph options

• Selection of the X and Y axes
• Linear or logarithmic scale
• Adding trend lines (modeling)
• Legend and title

8.6 Modeling and curve fitting

FizziQ Web lets you fit mathematical models to the data:

9. Tables and graphs - Analyze

Captured data is represented as tables. Each table contains columns called quantities (time, distance, velocity...) and lets you view, edit, or enrich the experimental data.

9.1 Accessing tables

Table in the experiment notebook:

Each time you capture data (audio analysis, video, simulation, external sensor...), a table is automatically created in the experiment notebook. You can open it to view and edit the data.

Create a blank table:

1. Open your experiment notebook
2. Click + → Data table
3. Enter your data manually

9.2 Quantities (columns)

Each column represents a quantity with:

• Name: e.g. Time, Distance, Velocity
• Unit (optional): in parentheses (m, s, m/s...)
• Type: manual entry or calculated
• Decimals: 0 to 6 for the display

Create a quantity: Click + new quantity to the right of the columns.

9.3 Entering data

Accepted formats:

• Whole numbers: 42, -15
• Decimals: 3.14 or 3,14 (comma converted automatically)
• Scientific notation: 1.5e-3, 6.02e23

Navigation: Tab (right), Shift+Tab (left), Enter (confirm and move down), Esc (cancel).

9.4 Formulas

All formulas begin with = and use column names as variables.

Operators

Mathematical functions

Constants: pi (3.14159...), e (2.71828...)

Statistical functions

Differentiation functions

Note: the first and last rows display #N/A (not enough points).

Reference to other rows

Example: =position - prec(position) calculates the difference between two measurements.

9.5 Graphs

Click the graph icon in the toolbar to switch between table and graph.

Configuration (3 tabs)

Data tab:

• X axis: choose a column or "Index" (1, 2, 3...)
• Y axes: add up to 5 curves

Display tab:

Scales tab: Automatic adjustment or manual scales (Min/Max).

9.6 Integration with Python

Define functions in the Python interpreter and use them in the tables:

# In Python
def energie_cinetique(m, v):
    return 0.5 * m * v * v

# In the table (column formula)
=energie_cinetique(mass, velocity)

9.7 Import/Export

• CSV export: Export button → file with semicolon separator
• CSV import: Open button → automatic format detection
• Export to notebook: copies the table as a new observation
• Graph export: PNG or insertion into the editor

9.8 Error messages

9.9 Keyboard shortcuts

10. Final report - Share

The final report is the third pillar of FizziQ Web: Share. After capturing data (Experiment) and organizing and understanding it (Analyze), the student can now communicate their results by creating a complete scientific document.

The FizziQ Web report editor is designed to be simple and effective. The student can:

• Write formatted text (headings, bold, italic...)
• Insert images and photos
• Directly integrate the cards from their experiment notebook (tables and graphs)
• Add mathematical formulas in LaTeX syntax
• Export the report to PDF, Word, or image to share it with the teacher

Creating a report is done in two steps:

1. Enrich the experiment notebook: add text and photos, organize the cards
2. Create the final report: format it with the text editor, then export

10.1 Enriching the experiment notebook

Before creating the final report, enrich your experiment notebook with explanatory text and photos.

Adding text to a card

1. Open the relevant card in the experiment notebook
2. Click Edit at the top right of the card
3. Write your text in the text area
4. Click Confirm to save

Adding photos

1. From the experiment notebook, click + Add an observation
2. Select Photo
3. Choose an image from your computer or take a photo with the webcam
4. Optionally add descriptive text

Editing the title of a card

1. Click the title of the card
2. Edit the text
3. Press Enter to confirm

Organizing the cards

The cards appear in the report in the order in which they are arranged in the notebook:

• Move: drag a card to change its position
• Delete: click the trash can to remove an unneeded card
• Duplicate: create a copy to make variations

10.2 Accessing the report editor

1. From the experiment notebook, click Edit the report
2. Or go to Share → Final report

10.3 Editor interface

The report editor consists of three areas:

• Central area: the report being written
• Left sidebar: three buttons to insert elements
• Contextual toolbar: appears when text is selected

Sidebar: the 3 insertion buttons

10.4 Formatting the text

Select text to bring up the contextual toolbar:

• Font size: from 8pt to 72pt
• Bold (B): makes the text bold
• Italic (I): makes the text italic
• Alignment: left, center, right, justified
• Formula (Σ): inserts a LaTeX mathematical formula

10.5 Inserting mathematical formulas

FizziQ Web supports LaTeX syntax for scientific formulas. Two insertion methods:

Method 1: Σ button (recommended)

1. Place the cursor at the desired location
2. Click the Σ button in the toolbar
3. Enter your formula in LaTeX syntax
4. Click Insert

Method 2: Direct syntax with $...$

Type directly in the text:

• $E = mc^2$ for an inline formula
• The formula is automatically converted into a mathematical rendering

Examples of LaTeX formulas

10.6 Inserting images

1. Click the Image button in the sidebar
2. Select an image from your computer
3. The image is inserted at the cursor position
4. Resize it by dragging the corners if necessary

Useful image types:

• Photos of the setup: experimental assembly
• Screenshots: simulations, measurements
• Diagrams: explanatory drawings
• Chronophotographs: motion analysis

10.7 Integrating notebook observations

1. Click the Observations button in the sidebar
2. The list of all your notebook cards is displayed
3. Click the desired card to insert it
4. The table, graph, and text are automatically added

10.8 Structure of a scientific report

A quality scientific report generally includes:

10.9 Finalizing the report

Before exporting, you must finalize your report:

1. Check that all the elements are correctly placed
2. Reread the text to correct any errors
3. Click the Finalize button

10.10 Exporting the report

Once finalized, several export formats are available:

PDF export (recommended)

1. Click Export to PDF
2. The PDF file is generated and downloaded
3. Ideal for printing and sharing by email

Word export (.docx)

1. Click Export to Word
2. A .docx file is generated
3. You can open and edit it in Microsoft Word, Google Docs, or LibreOffice

FizziQ file (.fiz)

The .fiz file contains all of your work:

• The complete experiment notebook
• All the tables and graphs
• The final report
• The inserted images

1. Go to Share → Export the file
2. A .fiz file is downloaded
3. This file can be re-imported into FizziQ Web to continue the work

10.11 Frequently asked questions about the report

Can I edit the report after finalizing it?

Yes, click Unfinalize to return to edit mode. You will have to finalize again before you can export once more.

How do I change the order of the elements in the report?

Click an element and drag it to the desired position. You can also reorganize the cards in the experiment notebook before inserting them.

My LaTeX formula does not display correctly

Check the LaTeX syntax. Common errors are: missing braces, a forgotten backslash before commands (\frac, \sqrt...), or extra spaces.

Is the PDF export of good quality for printing?

Yes, the generated PDF is high-resolution, suitable for paper printing.

Can I insert several graphs from the same card?

When you insert an observation, all the associated graphs are automatically included. To insert only one, duplicate the card in the notebook and delete the unwanted graphs.

How do I add a caption below an image?

Insert a text area just below the image, reduce the font size, and center the text to create a caption.

Does the report keep the colors when exported?

Yes, the colors of the graphs, text, and images are preserved in the PDF and Word exports.

11. Exporting data - Share

FizziQ Web lets you export data at three levels:

• A single observation: export an individual card from the notebook
• The complete notebook: export the entire set of observations
• The final report: export the summary document

11.1 Exporting an observation (notebook card)

From the experiment notebook, you can export each observation card individually:

1. Open the observation card in the notebook
2. Click the Export button
3. Choose the export format

Formats available for an observation

Python export

The Python export generates a script containing:

• The data as numpy arrays
• The code to generate the graphs
• The curve fits

11.2 Exporting the complete experiment notebook

To export the entire experiment notebook:

1. Scroll all the way to the top of the experiment notebook
2. Click the Export button
3. Choose the export format

Formats available for the complete notebook

11.3 Exporting the final report

To share all of your experimental work, use the final report:

1. Create your report by integrating the notebook observations
2. Click Finalize
3. Choose the export format

Formats available for the report

11.4 Export summary

11.5 Privacy

12. Additional tools

12.1 Scientific calculator

A full calculator for quick computations:

• Basic operations (+, -, ×, ÷)
• Scientific functions (sin, cos, tan, log, exp...)
• Physical constants (π, e, c, g...)
• Calculation history

12.2 Sound synthesizer

Generate sounds at precise frequencies:

• Frequency: 20 Hz - 20,000 Hz
• Waveform: sine, square, triangle, sawtooth
• Volume: adjustable
• Beats: two simultaneous frequencies

Educational uses

• Study of audible frequencies
• Beat phenomenon
• Tuning instruments
• Doppler effect (with movement of the source)

12.3 Color synthesizer (RGB)

Mix the primary colors of light:

• RGB sliders: Red, Green, Blue (0-255)
• Display: resulting color
• Codes: RGB and hexadecimal values

Educational uses

• Additive color synthesis
• Color coding in computing
• Complementary colors

12.4 Video → chronophotograph converter

Transform a video into a chronophotographic image:

1. Load a video
2. Define the interval between frames
3. Choose the number of frames to superimpose
4. Adjust the transparency
5. Export the resulting image

12.5 Python interpreter

A built-in Python environment for advanced analyses:

• Code editor: syntax highlighting
• Libraries: numpy, matplotlib available
• Data import: access to the notebook data
• Export: graphs and results to the notebook

Example script

import numpy as np
import matplotlib.pyplot as plt

# Notebook data
t = np.array([0, 0.1, 0.2, 0.3, 0.4])
y = np.array([0, 0.05, 0.20, 0.44, 0.78])

# Quadratic fit
coeffs = np.polyfit(t, y, 2)
print(f"Acceleration: {2*coeffs[0]:.2f} m/s²")

# Graph
plt.plot(t, y, 'o', label='Measurements')
t_fit = np.linspace(0, 0.4, 100)
y_fit = np.polyval(coeffs, t_fit)
plt.plot(t_fit, y_fit, '-', label='Fit')
plt.xlabel('Time (s)')
plt.ylabel('Position (m)')
plt.legend()
plt.show()

12.6 Screen sharing

Project FizziQ Web for the whole class:

• Full-screen display
• Presentation mode
• Synchronization with the students' devices

13. Settings

The settings let you configure and customize FizziQ Web to suit your needs: language, accessible tools, advanced parameters, and configuration sharing.

13.1 Accessing the settings

In the left sidebar, click Settings. The settings home page presents three sections:

13.2 Changing the language

FizziQ Web is available in 21 languages: French, English, Spanish, Portuguese, German, Italian, Dutch, Swedish, Norwegian, Danish, Finnish, Hungarian, Estonian, Polish, Romanian, Ukrainian, Russian, Turkish, Arabic, Malagasy.

1. In the settings, click Language
2. Select the desired language from the list
3. The interface updates automatically

13.3 Customization (Restricted mode)

Restricted mode lets teachers simplify the interface for their students by displaying only the tools needed for an activity.

Two display modes

Enabling custom mode

1. In the settings, click Customization
2. Click Custom mode
3. Check the tools to make accessible
4. Uncheck the tools to hide

Available tools

General: Experiment notebook, My notebooks, Final report

Experiment: Audio Analysis, Video Analysis, Chronophotograph, External Sensors, Data Entry

Simulations: Waves on a lake, Ballistics, Centrifuge, Pendulum, Inclined plane, Spring, Electrical circuit, Ideal gas, Optics, Three-body

Tools: Text editor, Spreadsheet, Python, Calculator, Sound synthesizer, Color synthesizer, Video chronophotograph

13.4 Sharing a configuration

Teachers can generate a link so that their students access a custom configuration directly.

1. Configure Custom mode with the desired tools
2. Click Generate a link
3. Copy the link with the Copy button
4. Share the link with your students (email, learning platform, QR code...)

When a student opens the link, FizziQ Web loads automatically with the custom configuration.

13.5 Advanced parameters

In the settings, click Parameters to access the advanced options.

Kinematic fitting (quadratic)

• Enabled: Velocity and acceleration calculations use a quadratic interpolation over 3 points (recommended)
• Disabled: Calculation by simple finite differences

USB connection speed (Baud Rate)

Configures the communication speed with external USB sensors (FizziQ Connect, Arduino).

In case of problems: Corrupted data → lower the Baud Rate. Data too slow → raise the Baud Rate.

13.6 Configuring the AI assistant

FizziQ Web includes an AI assistant to help users. In the settings, expand the AI Chat section to configure:

13.7 Saving the settings

13.8 Typical configurations for teachers

14. Troubleshooting

14.1 Common problems

14.2 Recommended browsers

For an optimal experience:

• Chrome (version 89+): all features
• Edge (version 89+): all features
• Firefox: audio, video, simulations (no Bluetooth/USB)
• Safari: audio, video, simulations (no Bluetooth/USB)

14.3 Chromebook

FizziQ Web works perfectly on a Chromebook:

• Use Chrome (installed by default)
• All features are available
• Ideal for institutions equipped with Chromebooks

14.4 Performance

If the application is slow:

• Close unnecessary tabs
• Clear the browser cache
• Reduce the size of the imported videos
• Limit the number of points in the simulations

14.5 Support

For any question: [email protected]

Complete documentation: fizziq.org/post/documentation-fizziq-web

Appendix: Connecting microcontrollers

This appendix details how to program a microcontroller (Arduino, ESP32, micro:bit...) to transmit sensor measurements to FizziQ Web via USB. The microcontroller sends lines of text in a specific format that FizziQ Web recognizes automatically.

A.1 Compatible hardware

Any microcontroller with a USB port or a USB serial port:

• Arduino: Uno, Nano, Mega
• ESP32 or ESP8266
• micro:bit
• Teensy
• Raspberry Pi Pico

A.2 USB format expected by FizziQ Web

Each line of data must follow this format:

FZ[CHANNEL]:[LABEL]:[VALUE]

Example messages

FZ0:tem:25.3
FZ0:hum:65.2
FZ1:pre:1013.25
FZ2:lum:450

Structure of a message

A.3 Recognized sensor labels

FizziQ Web recognizes these standardized abbreviations (not case-sensitive):

A.4 Using multiple channels

FizziQ Web handles 6 channels (0 to 5) to distinguish several sensors of the same type:

FZ0:tem:25.3    // Temperature sensor 1
FZ1:tem:22.1    // Temperature sensor 2
FZ2:tem:28.5    // Temperature sensor 3

A.5 Serial port configuration

For a stable USB connection:

• Baud rate: 115200 (recommended)
• Data bits: 8
• Stop bit: 1
• Parity: none

A.6 Programming an Arduino

First test with a fixed value

void setup() {
  Serial.begin(115200);
}

void loop() {
  Serial.println("FZ0:tem:25.3");
  delay(1000);
}

Example with a real sensor (DHT22)

#include <DHT.h>

#define DHTPIN 2
#define DHTTYPE DHT22

DHT dht(DHTPIN, DHTTYPE);

void setup() {
  Serial.begin(115200);
  dht.begin();
}

void loop() {
  float temp = dht.readTemperature();
  float hum = dht.readHumidity();

  if (!isnan(temp)) {
    Serial.print("FZ0:tem:");
    Serial.println(temp, 2);
  }
  delay(100);

  if (!isnan(hum)) {
    Serial.print("FZ0:hum:");
    Serial.println(hum, 1);
  }
  delay(400);
}

Example with multiple sensors

#define TEMP_PIN A0
#define LIGHT_PIN A1

void setup() {
  Serial.begin(115200);
}

void loop() {
  int rawTemp = analogRead(TEMP_PIN);
  int rawLight = analogRead(LIGHT_PIN);

  float temperature = rawTemp * (5.0 / 1023.0) * 100.0;
  float lux = map(rawLight, 0, 1023, 0, 1000);

  Serial.print("FZ0:tem:");
  Serial.println(temperature, 2);
  delay(100);

  Serial.print("FZ0:lum:");
  Serial.println(lux, 1);
  delay(400);
}

A.7 Programming an ESP32

#define TEMP_PIN 34
#define LIGHT_PIN 35

void setup() {
  Serial.begin(115200);
}

void loop() {
  int rawTemp = analogRead(TEMP_PIN);
  int rawLight = analogRead(LIGHT_PIN);

  float voltage = (rawTemp / 4095.0) * 3.3;
  float temperature = voltage * 100.0;
  float lux = map(rawLight, 0, 4095, 0, 1000);

  Serial.print("FZ0:tem:");
  Serial.println(temperature, 2);
  delay(100);

  Serial.print("FZ0:lum:");
  Serial.println(lux, 1);
  delay(400);
}

A.8 Programming a micro:bit

JavaScript (MakeCode)

basic.forever(function () {
    let temp = input.temperature()
    serial.writeLine("FZ0:tem:" + temp)
    basic.pause(100)

    let lum = input.lightLevel()
    serial.writeLine("FZ0:lum:" + lum)
    basic.pause(400)
})

Python (micro:bit)

from microbit import *

while True:
    print("FZ0:tem:" + str(temperature()))
    sleep(100)
    print("FZ0:lum:" + str(display.read_light_level() * 4))
    sleep(400)

A.9 Recommended sending frequency

A.10 Connecting to FizziQ Web

1. Plug the microcontroller into the computer with a data USB cable
2. Upload your program (Arduino IDE, PlatformIO, MakeCode...)
3. Close the programming environment
4. Open FizziQ Web in Chrome or Edge
5. Click Experiment → External sensors
6. Click USB Serial
7. Select the port corresponding to the microcontroller
8. The detected sensors appear automatically

A.11 Microcontroller troubleshooting

A.12 Activity example: weather station

Build a small weather station with a microcontroller and a few sensors:

• Temperature sensor
• Humidity sensor
• Light sensor

The program sends:

FZ0:tem:23.4
FZ0:hum:58.1
FZ0:lum:420

In FizziQ Web, students can:

• Visualize the measurements in real time
• Record the data over a period of time
• Plot evolution graphs
• Compare different experimental conditions
• Export the data for analysis

Serial.println("# Sensor initialized");
Serial.println("# ERROR: Sensor not found");