Important: Upcoming Change to Parameter Naming Validation
We've identified an inconsistency in how flespi handles parameter names containing minus signs (-) that we need to address.
Current Situation:
- Device messages currently accept parameter names with minus signs (e.g., "engine-rpm", "custom-value")
- However, device telemetry doesn't support minus signs in parameter names
- This causes parameters with minus signs to be missing from telemetry, even though they appear in messages
What's Changing:
To ensure consistency across the platform, we will synchronize the validation rules. After this update, device messages will no longer accept parameter names containing minus signs.
Impact:
- Any existing parameters with minus signs will need to be renamed
- This affects custom parameters sent via HTTP/MQTT channels or created by plugins
- Standard flespi parameters are not affected (they already follow the correct naming convention)
Recommended Actions:
- Review your device configurations and custom integrations for parameter names containing minus signs
- Replace minus signs with underscores (e.g., "engine-rpm" → "engine_rpm") or dots for hierarchy (e.g., "engine-rpm" → "engine.rpm")
- Update any applications or scripts that send data to flespi with the new parameter names
- If using plugins that create parameters with minus signs, update their configuration
Best Practice Reminder:
Parameter names should only contain:
- letters (a-z)(A-Z)
- Numbers (0-9)
- Dots (.) for hierarchy
- Underscores (_) as separators
This change ensures that all parameters visible in messages will also be available in telemetry, providing a more consistent and reliable experience.