Skip to content

docs: clarify that serial_number field requires device Unit ID - #68

Merged
jat255 merged 1 commit into
mainfrom
docs/unit_id_not_serial
Feb 1, 2026
Merged

docs: clarify that serial_number field requires device Unit ID#68
jat255 merged 1 commit into
mainfrom
docs/unit_id_not_serial

Conversation

@jat255

@jat255 jat255 commented Feb 1, 2026

Copy link
Copy Markdown
Owner

Updates documentation and UI prompts to explain that Garmin's FIT file "serial_number" field must contain the device's Unit ID (found in Settings → About → Copyright Info) rather than the actual serial number. This distinction is critical for Garmin Connect to properly recognize activities and apply Training Effect calculations.

Changes:

  • Add visual guides showing where to find Unit ID on Android app and Edge devices
  • Update all references from "serial number" to "Unit ID" in critical sections
  • Clarify that FIT file serial_number field stores Unit ID, not Serial Number
  • Update config prompts to emphasize Unit ID vs Serial Number distinction
  • Add note that Garmin Connect method may not work for all device types

@codecov-commenter

codecov-commenter commented Feb 1, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (6192294) to head (d595f51).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##              main       #68   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            6         6           
  Lines         1235      1237    +2     
=========================================
+ Hits          1235      1237    +2     
Flag Coverage Δ
unittests 100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

…erial Number

Updates documentation and UI prompts to explain that Garmin's FIT file
"serial_number" field must contain the device's Unit ID (found in Settings →
About → Copyright Info) rather than the actual serial number. This distinction
is critical for Garmin Connect to properly recognize activities and apply
Training Effect calculations.

Changes:
- Add visual guides showing where to find Unit ID on Android app and Edge devices
- Update all references from "serial number" to "Unit ID" in critical sections
- Clarify that FIT file serial_number field stores Unit ID, not Serial Number
- Update config prompts to emphasize Unit ID vs Serial Number distinction
- Add note that Garmin Connect method may not work for all device types
@jat255
jat255 force-pushed the docs/unit_id_not_serial branch from b6fba99 to d595f51 Compare February 1, 2026 18:52
@jat255
jat255 merged commit d5553ce into main Feb 1, 2026
9 checks passed
@jat255
jat255 deleted the docs/unit_id_not_serial branch February 1, 2026 18:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants