RadioPhotonic_PCB_software/Examples/SD_Card/README.md

SD card example layout

Firmware expects a plain FAT volume handled by FatFs. In this project exFAT is disabled in ffconf.h, so the safe choice is FAT32 with a standard MBR partition.

Recommended card preparation:

1. Format the card as FAT32.
2. Copy the files from this directory to the root of the SD card, or keep the same relative folder structure.
3. Make sure profiles.csv is present at the root path expected by the firmware.

Expected file set:

• profiles.csv
• profiles/profile_1_saw.ini
• profiles/profile_2_custom_wave.ini
• waves/wave_custom.csv

profiles.csv format:

• One profile per line.
• Columns: display_name, profile_ini_path, optional_waveform_csv_path
• Empty lines are ignored.
• Lines starting with # or ; are ignored.

Example:

Factory Saw,profiles/profile_1_saw.ini,
Custom SRAM,profiles/profile_2_custom_wave.ini,waves/wave_custom.csv

Profile .ini format:

• One key=value pair per line.
• Empty lines are ignored.
• Lines starting with # or ; are ignored.
• Unknown keys are ignored.
• The whole file must be smaller than 4096 bytes; a larger profile fails to load instead of being truncated.

Additional profile-controlled devices:

• AD9102 waveform settings are stored through the waveform_* keys.
• AD9833 settings are stored through ad9833_enable, ad9833_triangle, and ad9833_frequency_word.
• STM32 internal DAC settings are stored through stm32_dac_enable and stm32_dac_code.
• TEC drive modulation is stored through tec_modulation_enable, tec_modulation_laser, tec_modulation_frequency_hz, and tec_modulation_amplitude_code.
• DS1809 is stored as an absolute target above the minimum tap using ds1809_apply and ds1809_position_from_min.
• Laser 2 current and STM32 DAC sweeps are stored through the laser2_current_sweep_* and stm32_dac_sweep_* keys: _enable, _min_code, _max_code, _step_code, _step_period_us, and _pause_ms.

Notes:

• ad9833_frequency_word uses the same raw 28-bit tuning word that the old serial command accepted.
• tec_modulation_laser is 1 or 2; accepted TEC modulation frequency is 50..2000 Hz, and peak amplitude is 0..27900 external TEC DAC codes (further limited by the headroom around the PID output).
• A sweep steps from _min_code up to _max_code (inclusive) by _step_code every _step_period_us (at least 10, rounded down to a multiple of 10 us), then holds _min_code for _pause_ms before repeating.
• Sweep codes are raw DAC codes: the laser current DAC uses the same units as laser2_current, the STM32 DAC 0..4095.
• The laser 2 current sweep only runs in auto_run=true profiles, because it needs the laser to be driven.
• ds1809_position_from_min is clamped to the valid 0..63 range by the firmware.
• When ds1809_apply=true, the firmware first drives the potentiometer fully down and then steps it up to the requested absolute position.

Waveform file format:

• The firmware scans the file with strtol().
• Any integer token found in the file becomes one AD9102 SRAM sample.
• Separators may be commas, spaces, tabs, or newlines.
• Do not put comments or stray digits into the waveform file, because any parsed integer will be treated as a sample.

Supported waveform_mode values:

• saw
• generated_sram
• custom_sram

Minimal boot behavior:

• On startup the firmware loads the first valid line from profiles.csv.
• It then loads the referenced profile .ini.
• If boot_enabled=true, the profile is activated.
• If auto_run=true, the board immediately enters WORK mode.