No Results Found
We couldn't find any documentation or troubleshooting articles matching your query.
Introduction
What is ThrustVault
ThrustVault is a high-performance, enterprise-grade aerospace propulsion intelligence platform designed for systems engineers, flight test teams, and UAV designers. By serving as a single source of truth, the platform manages, analyzes, and compares propulsion component specifications and real-world test telemetry logs. From stator configuration structures to dynamic load cell results, ThrustVault helps teams optimize multirotor performance, validate powertrain choices, and comply with safety and security regulations.
Why ThrustVault Exists
UAV developers face significant data fragmentation and process gaps that compromise engineering quality. ThrustVault solves these common problems:
- Scattered Spreadsheets: Telemetry logs, KV specs, and battery parameters are often stored in individual local files, making global database searches impossible.
- Lost Validation Reports: Crucial reports mapping ESC heat limits to specific propeller sizes are often lost across engineering teams.
- Inconsistent Test Records: Different test benches yield non-standardized logs, which limits comparative analysis.
- Duplicate Testing: Teams duplicate load cell runs because they cannot search for historical motor logs.
- Lack of Engineering Traceability: Hardware modifications are made without audit trails, exposing teams to export compliance risks.
Key Benefits & Users
By consolidating files into a structured relational schema, ThrustVault enables:
- Traceability: Track component modifications, ingestion dates, and validation state logs.
- Searchability: Locate optimal component sets using filter sliders.
- Integrity: Prevent runtime desync and component failure with automated safety margin verification.
Our typical users include:
- Drone Engineers: Design flight control laws and select powertrains.
- Test Engineers: Set up load cells and ingest bench files.
- UAV Manufacturers: Track production runs and quality logs.
- Aerospace Researchers & University Teams: Conduct aerodynamic study and compare telemetry curves.
- R&D Departments: Build and validate propulsion systems.
Platform Vision
ThrustVault turns raw propulsion data into accessible engineering intelligence. Instead of manually reviewing legacy spreadsheets, engineers can query historical test logs, verify safety margins, and evaluate powertrain efficiency immediately, creating a reliable foundation for aerospace development.
Understanding UAV Propulsion Systems
Motors
UAV platforms use Brushless DC (BLDC) outrunner motors. The stator volume determines magnetic flux capacity, and the casing (rotor bell) rotates with permanent magnets to drive the propeller shaft.
- KV Rating: Defines the RPM a motor spins per Volt without load (RPM/V). Higher KV motors spin faster but generate less torque, while lower KV motors turn larger propellers more efficiently.
- Selection Criteria: Select motors based on continuous current limits, power-to-weight ratio, winding resistance, and stator heat dissipations.
Electronic Speed Controllers (ESCs)
The ESC switches DC power from the battery to three-phase AC, controlling motor RPM. - Communication Protocols: DShot (digital, noise-resistant), PWM (analog, legacy), UAVCAN (packetized CAN bus). - Ratings: Must clear continuous and burst current limits, plus battery voltage range limits (S-rating).
Propellers
Propellers convert motor torque into thrust. - Diameter: Outer rotational diameter. Larger diameters sweep more air, improving efficiency but increasing torque requirements. - Pitch: Theoretical travel distance per rotation. Higher pitch speeds up the UAV but risks aerodynamic stalling. - Blade Count: 2-blade designs are most efficient, while 3-blade options provide responsiveness in tight spaces.
Batteries
Lithium-Polymer (LiPo) and Lithium-Ion packs provide power. - Cell Count (S): Each cell adds 3.7V nominal. Higher voltage reduces current draw for the same power, limiting heat loss. - Discharge Rate (C-Rating): Multiplier of nominal capacity defining safe current limits ($C \times \text{Ah}$).
The Propulsion Chain
The system operates as an interdependent chain: Battery → ESC → Motor → Propeller → Aircraft. A change to any component impacts the entire system. For example, a larger propeller increases motor torque load, raising current draw from the ESC, which in turn causes voltage sag in the battery.
Getting Started
Account Setup & Roles
Create credentials via the onboarding form. Users are assigned one of three role tiers:
- Guest: Read-only access to browse the catalog and view metrics.
- Flight Engineer: Full access to import logs, register motors, and build comparison groups.
- Systems Administrator: Full clearance to manage requests, toggle auto-approvals, and view audit trails.
Dashboard & Navigation
Log in to view: - Top NavBar: Quick links to features, the version catalog, documentation, and your profile toggle. - Main Dashboard Grid: Displays performance cards, search fields, Kv filter sliders, and rotrix CSV upload triggers.
New User Checklist
Complete these initial steps:
- Step 1: Register your engineer account on the onboarding form.
- Step 2: Log in and explore the Motor Catalog Grid.
- Step 3: Select two motors and click Compare Selected.
- Step 4: Download the CSV template, populate it, and upload it to test the ingestion system.
Motor Intelligence Database
Motor Records & Schemas
Each motor record contains structural specifications, with mandatory verification fields to maintain database reliability:
| Parameter | Unit / Format | Type | Validation Rule |
|---|---|---|---|
| Motor Model | String (e.g. U8 II) | Required | Unique alphanumeric code. |
| KV Rating | RPM/V | Required | Integer between 10 and 3000. |
| Stator Weight | grams | Required | Decimal greater than 0. |
| Coil Resistance | milliohms | Optional | Decimal greater than 0. |
| JSONB extra_data | Key-Value Object | Optional | Valid JSON object. |
Best Practices & Data Ingestion
To avoid schema rejection, follow these guidelines:
- Verify units: Stator weights must be in grams, coil resistance in milliohms.
- Search before adding: Check historical records to prevent duplicate model names.
- Include extra metrics: Add slot-pole configurations (12S14P) in the JSON payload to improve filtering.
ESC Compatibility Management
Database & Compatibility Rules
The system validates compatibility using safety margins to prevent component failures:
- Peak Current Margin: The ESC's continuous current rating must be at least 1.2x (preferably 1.5x) the motor's peak rated current.
- Voltage Tolerance: The ESC's voltage limit (S-rating) must match or exceed the battery's maximum voltage output.
- Signal Check: The flight controller's output protocol must match the ESC's input settings (e.g., DShot vs. UAVCAN).
Safety Calculations Example
// Safety Calculation: Peak Current validation
const motorMaxCurrent = 45.0; // Amps
const safetyMargin = 1.25; // 25% overhead
const targetESCRating = motorMaxCurrent * safetyMargin; // 56.25A
if (esc.continuous_amps < targetESCRating) {
throw new Error("ERR_ESC_011: Insufficient ESC current headroom.");
}
Propeller Intelligence
Geometry & Material Science
Aerodynamic performance is determined by propeller geometry:
- Diameter (D): Increasing diameter increases static thrust but requires more motor torque.
- Pitch (P): Higher pitch drives air faster but risks aerodynamic stall under static loads.
- Material Choice: Carbon-fiber offers high rigidity and resists deflection under load, while nylon composites are quieter and absorb impact.
Motor Matching & Testing
Match propellers to motors using stator volume guidelines: - Stator size 2306 pairs with 5" to 6" props (small quads). - Stator size 8318 pairs with 28" to 32" props (heavy lift). Avoid oversized props, which can overload coils and cause thermal degradation.
Battery Intelligence
Battery Cell & Discharge Metrics
The battery pack must deliver sufficient voltage and current without excessive sag:
- Cell Count (S): nominal voltage = $S \times 3.7\text{V}$, max charge = $S \times 4.2\text{V}$ (4.35V for LiHV).
- Continuous Current Delivery: Calculated as: $$\text{Max Current (Amps)} = \text{Capacity (Ah)} \times \text{C-Rating}$$
Safety Guidelines
Observe these precautions:
- Thermal Limits: Do not exceed $60^\circ\text{C}$ during flight or test bench runs.
- Voltage Limits: Never discharge cells below 3.0V under load to avoid irreversible damage.
- Storage: Store packs at 3.8V to 3.85V per cell in a fireproof container.
Test Run Management
Bench Setup & Records
Test runs validate propulsion performance before flight. Standard bench setups require:
- Calibration: Calibrate the load cell before each test run.
- Environment Logs: Record ambient temperature, humidity, and atmospheric pressure.
- Safety Rules: Clear all personnel from the prop plane and enable automated thermal shutdown limits.
Quality Assurance & Sign-off
Uploaded test files undergo an review process before approval. This workflow ensures data integrity:
- Submission: The test operator uploads the telemetry file, creating a pending run record.
- Automated Scan: The database engine checks for data anomalies (e.g., negative currents or missing timestamps).
- Engineer Review: A Flight Engineer reviews the curves and signs off on the test run.
Telemetry and Performance Data
Data Sources & Ingestion
ThrustVault ingests raw metrics from several sources:
- Bench Sensors: High-precision load cells and torque transducers.
- ESC Telemetry: Real-time RPM, voltage, current, and temperature data.
- Ingestion Formats: Data can be uploaded as standard CSV or Excel files, mapped via the columns mapper.
Analysis Metrics
Key metrics calculated by the analytics engine:
- Electrical Power ($P_e$): Current (A) $\times$ Voltage (V).
- Mechanical Power ($P_m$): Torque (Nm) $\times$ Angular Velocity (rad/s).
- Propulsion Efficiency: thrust (g) / Electrical Power (W). Peak target values exceed $10\text{g/W}$ at hover throttle.
Analytics and Insights
Dashboards & Telemetry Curves
The analytics module processes telemetry logs to generate performance charts:
- Thrust vs. Current: Maps motor torque characteristics.
- Efficiency ($g/W$) vs. Throttle: Locates optimal hover nodes.
- Temperature Rise vs. Time: Evaluates winding thermal performance.
Engineering Forecasts & Decisions
The system models lifecycle changes over time, helping engineers plan maintenance and replace components before failure.
Engineering Workflows
Workflow 1: Selecting a propulsion system for a heavy-lift drone
- Objective: Identify a motor, ESC, prop, and battery combination to hover a 40kg drone (10kg per rotor) for 30 minutes.
- Steps: Open the simulator widget, select a 10kg payload and 12S battery, review recommendations, click *Compare specs*, and confirm safety margins.
- Expected Results: System outputs KV120 motor, 80A ESC, and 30" carbon prop specifications.
Workflow 2: Validating a newly released motor
- Objective: Add and approve specs for a new motor.
- Steps: Check the database for duplicates, create the record, upload the test bench CSV, and submit for review.
- Expected Results: Winding resistance and KV ratings are validated.
Workflow 3: Finding the most efficient configuration
- Objective: Find the powertrain combo with the highest g/W efficiency at $6\text{kg}$ thrust.
- Steps: Search historical data for $6\text{kg}$ runs, compare overlay curves, and identify the highest efficiency node.
- Expected Results: System identifies a low-KV motor paired with high-voltage packs.
Workflow 4: Comparing ESC manufacturers
- Objective: Compare timing advance efficiency across two different ESC brands.
- Steps: Run identical test sequences on both ESCs, upload the logs, and compare the telemetry curves.
- Expected Results: Chart overlays identify the ESC with lower thermal losses.
Workflow 5: R&D Prototype Validation
- Objective: Validate motor thermal limits under cyclical thrust loads.
- Steps: Run a variable thrust sequence on the bench, upload logs, and check the temperature curves.
- Expected Results: Identifies limits to prevent motor demagnetization.
Workflow 6: Flight Readiness Powertrain Sign-off
- Objective: Sign off on components before flight.
- Steps: Verify component models against database entries and review the QA checklist.
- Expected Results: Validated clearance checklist output.
Workflow 7: Academic Propulsion Research Study
- Objective: Analyze the effect of blade count on aerodynamic efficiency.
- Steps: Test 2-blade and 3-blade props on the same motor, upload the data, and compare thrust curves.
- Expected Results: Outputs comparative charts showing performance differences.
Workflow 8: Factory Quality Validation
- Objective: Check production motor KV consistency.
- Steps: Run a no-load spin test on batch motors and upload the logs.
- Expected Results: Flags motors outside the $\pm 3\%$ KV range.
Troubleshooting & Diagnostics Center
Use the search input at the top of the sidebar or browse this directory to diagnose and resolve propulsion system anomalies, interface glitches, and data integration errors.
ERR_AUTH_001: ACCESS_UNAUTHORIZED
High
Description:
Your session lacks authorized permissions to perform edits, upload files, or view protected dashboard panels.
Resolution Strategy:
Log out and sign back in to refresh your token. Contact your administrator to request a role upgrade if you need write access.
ERR_DB_002: READ_ONLY_DEMO
Medium
Description:
Attempted database edits are disabled within the read-only guest workspace.
Resolution Strategy:
Submit an onboarding request for active clearances, then sign in with your approved profile.
ERR_FILE_003: INGESTION_FORMAT_MISMATCH
Medium
Description:
The uploaded CSV or Excel file header format does not map correctly to database categories.
Resolution Strategy:
Download the official template file from the dashboard, copy your columns without modifying header strings, and re-upload.
ERR_SYS_004: SYNCHRONIZATION_DELAY
Low
Description:
A temporary synchronization delay exists between the Postgres primary DB and the sqlite local mirror cache.
Resolution Strategy:
Wait 30 seconds and refresh the dashboard. Cache databases sync automatically.
ERR_MAIL_005: NOTIFICATIONS_PAUSED
Low
Description:
Automatic email notifications for access approval or system updates are temporarily paused.
Resolution Strategy:
System notifications are currently suspended. Please contact your administrator to verify request approvals manually.
ERR_NET_006: GATEWAY_TIMEOUT
Medium
Description:
The database server timed out while processing a complex comparison query.
Resolution Strategy:
Reduce the number of selected motors or filter by a smaller KV range, then try the comparison again.
ERR_VAL_007: SCHEMA_CONSTRAINT_VIOLATION
Medium
Description:
The data you attempted to submit contains schema constraint violations, such as negative weights or invalid KV ranges.
Resolution Strategy:
Check your inputs. Ensure that motor values are positive and required fields are populated.
ERR_LIM_008: EXPORT_LIMIT_EXCEEDED
Low
Description:
You have exceeded the maximum row limit for a single CSV/Excel export, which is restricted to 100 rows for guest profiles.
Resolution Strategy:
Filter the catalog to reduce the number of rows, or upgrade to a Flight Engineer account to remove export limits.
TS_MTR_001: STATOR_OVERHEATING
High
Description:
The motor stator temperature exceeds the thermal limit ($85^\circ\text{C}$) during static hover testing.
Resolution Strategy:
Reduce throttle immediately to prevent damage. Check winding health, verify current draws, and ensure the prop is not oversized for the motor's KV rating.
TS_MTR_002: INSULATION_BREAKDOWN
High
Description:
Short-circuit detected between motor windings and the stator core, causing erratic startup behavior.
Resolution Strategy:
Disconnect the motor from power. Check continuity using a multimeter, inspect coil enamel for damage, and replace the motor if windings are shorted.
TS_MTR_003: MAGNET_DEMAGNETIZATION
High
Description:
Permanent rotor magnets degrade due to thermal limit violations, reducing motor torque.
Resolution Strategy:
Replace the damaged rotor bell. Set up automated thermal warning thresholds on your dashboard to prevent overheating in future runs.
TS_MTR_004: BEARING_AXIAL_PLAY
Medium
Description:
Wear in motor bearings creates axial play, resulting in noise and high vibration levels.
Resolution Strategy:
Check the shaft assembly for play and replace worn bearings. Clean the motor bell to prevent dust contamination.
TS_MTR_005: COGGING_TORQUE_MISMATCH
Low
Description:
Uneven resistance when manually rotating the bell, suggesting magnet misalignment or winding defects.
Resolution Strategy:
Inspect magnet spacing inside the bell. If magnets are loose, replace the rotor bell to ensure correct spacing.
TS_MTR_006: PHASE_RESISTANCE_IMBALANCE
Medium
Description:
Winding resistance differs by more than $5\%$ between phases, causing uneven motor heating.
Resolution Strategy:
Measure phase-to-phase resistance. Check solder joints on lead wires and reflow cold solder points to restore balance.
TS_MTR_007: SHAFT_SLIPPAGE
High
Description:
The motor shaft slips relative to the bell casing under high loads, losing propulsion control.
Resolution Strategy:
Tighten the shaft retention screws on the rotor bell casing, using medium-strength threadlocker to prevent loosening.
TS_MTR_008: PHASE_SHORT_CIRCUIT
High
Description:
Short-circuit between phase lines triggers ESC overcurrent protection.
Resolution Strategy:
Inspect lead wire insulation for cracks. Apply heat shrink tubing to exposed conductors, or replace lead lines if necessary.
TS_MTR_009: BELL_UNBALANCE
Medium
Description:
Imbalance in the rotor bell causes high vibrations, raising accelerometer noise.
Resolution Strategy:
Balance the motor using a dynamic balancer. Apply small weights to the inner rim of the bell until vibrations drop below standard thresholds.
TS_MTR_010: BASE_THREAD_STRIP
Low
Description:
Stripped mounting hole threads prevent secure motor attachment.
Resolution Strategy:
Install a helicoil insert in the stripped hole, or mount the motor using alternative mounting points with correct screw lengths.
TS_ESC_011: DESYNCHRONIZATION
High
Description:
The ESC loses synchronization with rotor position during rapid acceleration.
Resolution Strategy:
Reduce acceleration ramps in the flight controller or ESC settings. Increase timing advance configuration slightly in the ESC manager.
TS_ESC_012: THERMAL_SHUTDOWN
High
Description:
The ESC's internal temp exceeds thermal safety limits ($110^\circ\text{C}$), triggering thermal shutdown.
Resolution Strategy:
Improve airflow to the ESC. Add a larger aluminum heatsink or select an ESC with higher continuous current ratings.
TS_ESC_013: VOLTAGE_RIPPLE_SHUTDOWN
Medium
Description:
Excessive voltage ripple in power lines trigger ESC low-voltage protection.
Resolution Strategy:
Add low ESR electrolytic capacitors across the ESC power inputs to smooth out voltage ripple. Keep battery leads as short as possible.
TS_ESC_014: SIGNAL_JITTER
Medium
Description:
Signal jitter in control lines causes erratic motor speed changes.
Resolution Strategy:
Use shielded signal cables and route them away from power lines to reduce EMI. Verify output protocols in flight controller configurations.
TS_ESC_015: CAN_ADDRESS_CLASH
Low
Description:
Multiple ESCs share the same address on the CAN bus, preventing individual node discovery.
Resolution Strategy:
Connect each ESC individually to assign unique node IDs using the configuration manager.
TS_ESC_016: TIMING_MISMATCH
Low
Description:
Suboptimal motor timing settings lower efficiency and raise heat production.
Resolution Strategy:
Set timing advance to default or auto. For high-pole-count motors, set timing to $20^\circ$ or higher for stable commutation.
TS_ESC_017: BEC_VOLTAGE_DROP
Medium
Description:
The ESC's internal BEC voltage drops under load, causing flight controller brownouts.
Resolution Strategy:
Use a dedicated external UBEC to power flight controllers and avionics, keeping electronics isolated from propulsion power draws.
TS_ESC_018: BOOTLOADER_MISMATCH
Low
Description:
Incompatible bootloader version prevents firmware updates.
Resolution Strategy:
Flash the matching bootloader version using an external programmer, or restore default factory firmware to re-enable communication.
TS_ESC_019: BRAKING_CURRENT_SPIKE
High
Description:
Regenerative braking current spikes exceed battery acceptance limits, triggering overvoltage protection.
Resolution Strategy:
Lower regenerative braking power in ESC configurations, or use active load resistors to absorb excess energy.
TS_ESC_020: PACKET_DROP_RATE
Medium
Description:
Loss of control packets in DShot signal lines causing motor response lag.
Resolution Strategy:
Verify signal cable shielding and ground connections. Lower DShot speeds (e.g., from DShot600 to DShot300) to improve signal integrity.
TS_PRP_021: HUB_STRUCTURAL_FAILURE
High
Description:
Micro-cracks in the propeller hub lead to blade separation at high RPMs.
Resolution Strategy:
Inspect hubs for fatigue cracks before test runs. Replace damaged propellers immediately and do not exceed rated RPM limits.
TS_PRP_022: DYNAMIC_IMBALANCE
Medium
Description:
Propeller weight mismatch causes dynamic imbalance, increasing vibration.
Resolution Strategy:
Balance blades using a magnetic balancer. Apply thin layers of clear tape or sand blade tips to correct imbalances.
TS_PRP_023: TRACKING_ERROR
Medium
Description:
Blades rotate in different horizontal planes due to hub pitch errors.
Resolution Strategy:
Inspect blade pitch angles and hub alignment. Replace deformed propellers and check adapter concentricity.
TS_PRP_024: STATIC_PITCH_STALL
Low
Description:
High-pitch propeller blades stall under static conditions, lowering static thrust efficiency.
Resolution Strategy:
Use props with lower pitch-to-diameter ratios for high static thrust requirements, or evaluate performance dynamic conditions.
TS_PRP_025: MOISTURE_ABSORPTION
Low
Description:
Nylon composite blades absorb humidity, causing blade softening and shape deformation.
Resolution Strategy:
Store nylon composite blades in sealed bags with desiccant packs. Switch to carbon-fiber blades for consistent performance in humid environments.
TS_PRP_026: TIP_CAVITATION
Medium
Description:
Propeller tip velocities approach Mach 0.7, causing flow separation and reduced efficiency.
Resolution Strategy:
Reduce motor voltage or switch to lower KV motors. Select smaller propeller diameters to maintain tip speeds below safety margins.
TS_PRP_027: UV_DEGRADATION
Low
Description:
UV exposure degrades composite plastics, making propeller blades brittle.
Resolution Strategy:
Inspect blade surfaces for discoloration or micro-cracks. Store propellers away from direct sunlight.
TS_PRP_028: HINGE_BINDING
Medium
Description:
Hinge bolts on folding propellers are over-tightened, preventing smooth blade deployment.
Resolution Strategy:
Loosen hinge bolts slightly and apply threadlocker. Ensure blades fold and deploy freely without resistance.
TS_PRP_029: BLADE_DEFLECTION
Medium
Description:
Flexible plastic blades deflect under heavy aerodynamic load, causing efficiency losses.
Resolution Strategy:
Replace flexible props with carbon-fiber or rigid carbon-reinforced nylon blades to maintain aerodynamic shapes under load.
TS_PRP_030: ADAPTER_RUNOUT
Low
Description:
Adapter concentricity error causes prop wobble during rotation.
Resolution Strategy:
Measure runout with a dial indicator. Re-seat the propeller adapter hub or replace the adapter assembly to restore concentricity.
TS_BAT_031: VOLTAGE_SAG
High
Description:
Excessive voltage sag under load suggests high internal resistance.
Resolution Strategy:
Verify individual cell internal resistance. Keep packs warm in cold weather and use high C-rated batteries for peak current loads.
TS_BAT_032: CELL_IR_SPIKE
High
Description:
Internal resistance spike in a single cell causes unbalanced discharge.
Resolution Strategy:
Retire packs with high cell-to-cell resistance imbalances. Use balance charging for all charge cycles.
TS_BAT_033: CELL_SWELLING
High
Description:
Gas generation swells the battery pack, posing a fire risk.
Resolution Strategy:
Discontinue use of swollen battery packs. Discharge safely using a salt bath and dispose of them according to local environmental regulations.
TS_BAT_034: BALANCE_LEAD_DISCONNECT
Medium
Description:
Loose balance wire contacts cause charger cell reading errors.
Resolution Strategy:
Inspect the JST-XH balance connector and reflow loose solder points. Re-seat connector pins inside the plug housing.
TS_BAT_035: CAPACITY_DEGRADATION
Low
Description:
Battery capacity drops rapidly after repeated discharge cycles.
Resolution Strategy:
Avoid discharging cells below 3.0V. Cycle batteries at moderate rates to extend operational lifespan.
TS_BAT_036: THERMAL_RUNAWAY
High
Description:
Rapid battery temperature rise ($65^\circ\text{C}$) under load poses risk of thermal runaway.
Resolution Strategy:
Disconnect the load and place the battery in a fireproof container. Inspect for external damage or internal short-circuits.
TS_BAT_037: CHARGE_REJECTION
Medium
Description:
Charger rejects low-temperature packs ($<0^\circ\text{C}$) to prevent lithium plating.
Resolution Strategy:
Warm battery packs to room temperature ($18^\circ\text{C}-25^\circ\text{C}$) before charging.
TS_BAT_038: SELF_DISCHARGE_SPIKE
Low
Description:
Packs lose significant charge when stored for short periods.
Resolution Strategy:
Measure self-discharge rates. Isolate and replace cells with high self-discharge to prevent pack imbalances.
TS_BAT_039: CONNECTOR_SHORT
High
Description:
Damaged insulation on battery connectors leads to short-circuits.
Resolution Strategy:
Insulate exposed wires with electrical tape. Replace damaged connectors using insulated tools to prevent shorts.
TS_BAT_040: CHARGER_ERROR
Low
Description:
Charger displays error code indicating cell count mismatch.
Resolution Strategy:
Verify charger cell count settings. Check balance lead connections and select the matching S-rating configuration.
TS_TEL_041: LOAD_CELL_DRIFT
Medium
Description:
Thermal expansion causes load cell zero-point drift during test runs.
Resolution Strategy:
Tare the load cell before every run. Use temperature-compensated load cells to minimize drift.
TS_TEL_042: ESC_CLOCK_DESYNC
Medium
Description:
Clock desynchronization between flight controller and ESC causes telemetry logging gaps.
Resolution Strategy:
Update the flight controller firmware. Set DShot telemetry settings to match native speed limits.
TS_TEL_043: SERIAL_PACKET_DROP
High
Description:
EMI in serial data lines causes packet drop rate issues.
Resolution Strategy:
Use shielded twisted-pair cables for serial data, and ground shielding to the system ground. Keep cables short.
TS_TEL_044: THROTTLE_COMMAND_LAG
High
Description:
Propagation delay in throttle signals, causing slow motor responses.
Resolution Strategy:
Verify signal path connections and lower protocol filtering delays. Switch to faster update rates (e.g. DShot600).
TS_TEL_045: THERMOCOUPLE_NOISE
Low
Description:
Electrical noise from motor phases causes erratic thermocouple readings.
Resolution Strategy:
Use shielded, grounded thermocouple extensions. Apply digital signal filtering in the test manager to smooth data.
TS_TEL_046: TACHOMETER_INTERFERENCE
Low
Description:
Flickering ambient lights cause tachometer RPM measurement errors.
Resolution Strategy:
Shield optical tachometer sensors from ambient light. Use high-contrast reflective tape on the rotor bell.
TS_TEL_047: CURRENT_SENSOR_OFFSET
Medium
Description:
Thermal drift causes Hall-effect current sensor offset errors.
Resolution Strategy:
Calibrate current sensor zero offsets prior to each run. Add cooling air ducts to the sensor enclosure.
TS_TEL_048: GROUND_LOOP
Medium
Description:
Different ground reference voltages cause ground loops, corrupting sensor signals.
Resolution Strategy:
Use a single point star grounding scheme. Opto-isolate digital signal lines between the bench and controllers.
TS_TEL_049: INGEST_BUFFER_OVERFLOW
Medium
Description:
Data rates exceed processing limits, causing buffer overflow errors.
Resolution Strategy:
Optimize database write procedures. Set telemetry logging rates to standard levels (e.g. 50Hz) to prevent overload.
TS_TEL_050: TIMESTAMP_RESOLUTION
Low
Description:
Timestamp mismatch between load cell and ESC logs prevents dataset alignment.
Resolution Strategy:
Synchronize logs using start-pulse triggers. Use time-alignment scripts to match files before importing.
TS_ANL_051: OVERLAY_LATENCY
Low
Description:
Overlay graph rendering delays when comparing multiple datasets.
Resolution Strategy:
Downsample datasets before displaying them in UI charts. Select fewer compare runs to speed up rendering.
TS_ANL_052: EFFICIENCY_MISCALCULATION
Medium
Description:
Calculation errors in propulsion system efficiency due to incorrect parameter units.
Resolution Strategy:
Ensure input units are correct (thrust in grams, power in Watts). Verify calculation logic before saving metrics.
TS_ANL_053: POWER_CONVERSION_ERR
Medium
Description:
Mismatch between active and apparent power values in three-phase calculations.
Resolution Strategy:
Apply the correct motor power factor ($\approx 0.85$) to three-phase AC calculations, or use ESC DC input values.
TS_ANL_054: PLOT_OVERLAP
Low
Description:
Overlapping data points in scatter plots reduce chart readability.
Resolution Strategy:
Adjust opacity and point sizing settings. Use color-coded legends to differentiate motor datasets.
TS_ANL_055: TORQUE_CALC_OFFSET
Medium
Description:
Torque offset errors skew calculated mechanical power outputs.
Resolution Strategy:
Calibrate torque transducers under static conditions. Apply compensation formulas to correct data offsets.
TS_ANL_056: CURVE_FIT_ERROR
Low
Description:
Polynomial curve fitting algorithms fail to resolve outlier telemetry points.
Resolution Strategy:
Filter out invalid sensor spikes before running curve fitting algorithms. Use regression parameters to optimize curves.
TS_ANL_057: THERMAL_LOOKUP_FAIL
Low
Description:
Thermal properties lookup fails due to missing copper resistivity parameters.
Resolution Strategy:
Verify material constant tables in the database. Ensure temperature coefficients are populated for copper windings.
TS_ANL_058: TREND_DISCREPANCY
Medium
Description:
Changes in parameters skew historical performance trend analyses.
Resolution Strategy:
Normalize telemetry metrics to standard ISA atmospheric conditions before analyzing trends.
TS_ANL_059: REPORT_FORMAT_ERR
Low
Description:
Formatting errors in generated PDF reports due to chart sizing issues.
Resolution Strategy:
Resize charts to fit standard page layouts. Use print stylesheets to keep PDF outputs aligned.
TS_ANL_060: CHART_EXPORT_FAIL
Low
Description:
Chart export fails due to browser memory limits when rendering large datasets.
Resolution Strategy:
Downsample datasets before exporting. Use SVG or PNG output formats to reduce file size.
TS_SCH_061: QUERY_LATENCY
Medium
Description:
Search queries run slowly on large databases without indices.
Resolution Strategy:
Limit search results using filter options. Contact your database administrator to create indices on searched columns.
TS_SCH_062: CASING_MISMATCH
Low
Description:
Case-sensitive search filters exclude matching lowercase database records.
Resolution Strategy:
Convert search inputs and target strings to lowercase before running comparison checks.
TS_SCH_063: MONOSPACE_INDEX
Low
Description:
Database fails to index monospace characters, causing search misses.
Resolution Strategy:
Normalize text encoding in ingestion scripts. Strip out hidden formatting tags before saving records.
TS_SCH_064: CHAR_REJECTION
Low
Description:
Queries with special characters are rejected by input sanitization filters.
Resolution Strategy:
Use alphanumeric characters in search fields. Escape special characters to prevent sanitization blocks.
TS_SCH_065: HIGHLIGHT_DISPLACE
Low
Description:
Search term highlights displace text alignment in the results view.
Resolution Strategy:
Verify highlight display styles. Use CSS tags that do not change block layout dimensions.
TS_SCH_066: FUZZY_FALSE_POSITIVE
Low
Description:
Fuzzy search logic matches unrelated components, cluttering results.
Resolution Strategy:
Increase the search term length or raise search matching thresholds to filter out irrelevant results.
TS_SCH_067: SLIDER_MISMATCH
Low
Description:
Dynamic filter sliders fail to register changes when adjusted quickly.
Resolution Strategy:
Add small input validation delays to update queries once slider movements stop.
TS_SCH_068: CACHE_OUT_OF_SYNC
Medium
Description:
New components are not searchable due to search index sync delays.
Resolution Strategy:
Refresh the search index manually, or wait for the automatic sync cycle to complete.
TS_SCH_069: CATEGORY_OMISSION
Low
Description:
Category filter exclusions drop matching motors from the catalog view.
Resolution Strategy:
Check your active filter parameters. Reset all category filter settings to display the full catalog.
TS_SCH_070: FOCUS_LOSS
Low
Description:
The search input loses focus on mobile devices when dynamic results reload.
Resolution Strategy:
Adjust input event listeners to run in the background, updating results without resetting focus on active inputs.
TS_PRM_071: GUEST_WRITE_BLOCKED
Medium
Description:
Write operations are blocked for guest profiles to protect the demo catalog.
Resolution Strategy:
Log in with a Flight Engineer account to add, update, or delete catalog records.
TS_PRM_072: TOKEN_REFRESH_DELAY
Medium
Description:
Delays in token refresh loops result in unauthorized errors on active pages.
Resolution Strategy:
Sign out and log in again to manually refresh your session token.
TS_PRM_073: UPLOAD_DENIED
Medium
Description:
Import actions are blocked due to insufficient user authorization clearances.
Resolution Strategy:
Confirm your account permissions. Upgrade your profile to Flight Engineer to enable import tools.
TS_PRM_074: ROUTING_LOOP
High
Description:
Redirect loops affect users with unconfirmed profile registrations.
Resolution Strategy:
Clear your browser cookies and cache. Contact your administrator to manually confirm your account registration.
TS_PRM_075: API_KEY_REJECTED
Medium
Description:
The API gateway rejects the provided security token.
Resolution Strategy:
Verify your API key format. Re-issue the security token from your profile settings page.
TS_PRM_076: SESSION_CONFLICT
Low
Description:
Multiple concurrent administrator logins close active sessions.
Resolution Strategy:
Use individual administrator credentials. Avoid sharing logins across sessions.
TS_PRM_077: MFA_SMS_DELAY
Medium
Description:
Delays in delivering MFA codes block portal access.
Resolution Strategy:
Request a new code, or use an authenticator app for MFA confirmation.
TS_PRM_078: APPROVAL_FILTER_BYPASS
Low
Description:
Auto-approval rules fail to process requests from non-whitelisted email domains.
Resolution Strategy:
Enter corporate email addresses exactly. Request manual confirmation from the admin portal if domain issues persist.
TS_PRM_079: CLEARANCE_CONFLICT
Medium
Description:
Assigned user clearance conflicts block access to high-payload records.
Resolution Strategy:
Check your profile clearance status and request required clearances from your administrator.
TS_PRM_080: ITAR_DOWNLOAD_BLOCK
High
Description:
Downloads of ITAR-protected specifications are blocked for non-US IP addresses.
Resolution Strategy:
Verify your connection. Access ITAR-regulated data only from secure, authorized networks.
TS_IMP_081: HEADER_MISMATCH
Medium
Description:
Import actions fail because Excel headers do not match target categories.
Resolution Strategy:
Open the column mapping interface to match spreadsheet headers to target database columns before uploading.
TS_IMP_082: PARSING_EXCEPTION
Medium
Description:
CSV float parsing errors occur due to non-numeric characters in data columns.
Resolution Strategy:
Verify your data cells. Remove non-numeric units (e.g. "g" or "V") from cells, leaving only clean numerical values.
TS_IMP_083: MISSING_STATOR_WEIGHT
Medium
Description:
Ingestion fails because the mandatory stator weight column is empty.
Resolution Strategy:
Fill in the missing weight parameters in your source file and run the ingestion process again.
TS_IMP_084: ROW_LENGTH_CONSTRAINT
Low
Description:
Import fails because the number of fields in a row exceeds structural limits.
Resolution Strategy:
Check for and remove extra columns at the end of the spreadsheet before uploading.
TS_IMP_085: DIALECT_UNRECOGNIZED
Low
Description:
The CSV parser fails due to unrecognized separators (e.g., semicolons instead of commas).
Resolution Strategy:
Convert your file to standard comma-separated format before uploading.
TS_IMP_086: UNIQUE_ID_CLASH
Medium
Description:
Ingestion fails because motor model codes conflict with existing database records.
Resolution Strategy:
Change model codes in your spreadsheet to ensure uniqueness, or select the overwrite option.
TS_IMP_087: FILE_SIZE_OVERFLOW
Medium
Description:
The uploaded file size exceeds the database limit of $10\text{MB}$ per upload.
Resolution Strategy:
Split your dataset into smaller files and upload them sequentially.
TS_IMP_088: BLANK_ROWS_EXCEPTION
Low
Description:
Empty rows at the end of the spreadsheet trigger validation errors.
Resolution Strategy:
Open the file, delete empty rows at the bottom, save, and retry the upload.
TS_IMP_089: JSONB_MAPPING_ERROR
Low
Description:
Formatting errors in nested key-value cells prevent conversion to JSONB.
Resolution Strategy:
Ensure extra parameter columns are populated with standard text or numbers to allow correct JSON serialization.
TS_IMP_090: EXCEL_PARSING_CRASH
Medium
Description:
Macro-enabled spreadsheets (.xlsm) trigger security and parsing errors.
Resolution Strategy:
Save the worksheet as a standard Excel file (.xlsx) or CSV, then re-upload.
TS_EXP_091: BULK_EXPORT_DENIED
Low
Description:
Guest profiles are restricted from performing bulk exports of the database.
Resolution Strategy:
Filter search results to show fewer than 100 rows, or log in with an engineering account to remove export limits.
TS_VAL_092: STATOR_OUT_OF_BOUNDS
Medium
Description:
Stator dimensions exceed logical parameters (e.g. width values $> 150\text{mm}$).
Resolution Strategy:
Verify stator width and height inputs. Correct typos to ensure values fit physical constraints.
TS_VAL_093: NEGATIVE_RESISTANCE
Medium
Description:
Negative coil resistance values are rejected by database constraints.
Resolution Strategy:
Enter positive resistance values in milliohms. Check your sensor measurements if errors persist.
TS_API_094: RATE_LIMIT_REACHED
Medium
Description:
API call rates exceed standard limits (max 100 requests/min per client IP).
Resolution Strategy:
Reduce request rates. Batch telemetry uploads to minimize API traffic.
TS_API_095: SERIALIZATION_ERROR
Low
Description:
Malformed custom fields cause API payload serialization to fail.
Resolution Strategy:
Ensure all custom values are mapped as standard strings or numbers before sending API requests.
TS_PRF_096: GRID_LOAD_LATENCY
Low
Description:
Displaying too many records at once slows down catalog loading times.
Resolution Strategy:
Enable pagination or apply filters to limit the number of active display rows.
TS_PRF_097: SYNC_MIRROR_LATENCY
Low
Description:
Delayed synchronization updates on the local SQLite mirror after writing to PostgreSQL.
Resolution Strategy:
Wait 30 seconds for automatic synchronization, or refresh the page to force a cache reload.
TS_USR_098: ACTIVATION_DELAY
Low
Description:
Delays in sending email verification links after registration.
Resolution Strategy:
Check your spam folder. If email notifications are paused by administrator policy, contact support to manually activate your account.
TS_USR_099: STATUS_MISMATCH
Medium
Description:
Account status errors block portal access for active users.
Resolution Strategy:
Contact system administrators to verify your profile status. Ensure your account is set to active in the database.
TS_SYS_100: MEMORY_LIMIT_WARNING
High
Description:
High system memory usage warnings on the administrative dashboard dashboard.
Resolution Strategy:
Close unused dashboard views, clear active query memory, and limit the size of concurrent comparison queries.
Engineering Academy
Drone Motor Fundamentals
Brushless motors operate using electronic commutation. By sequencing currents through stator coils, magnetic fields rotate and pull permanent magnets on the bell, driving shaft rotation. Key concepts include:
- KV Constant ($K_v$): Defines the RPM generated per Volt ($V$). Under load, actual RPM is lower due to copper and aerodynamic losses.
- Torque Constant ($K_t$): Defines torque generated per Ampere ($A$). Crucially: $$K_t \propto \frac{1}{K_v}$$ Therefore, low KV motors provide higher torque, ideal for spinning larger propellers.
- Copper Losses: Heat generated in winding resistance, calculated as $I^2 R$. Reducing current or winding resistance minimizes these losses.
- Iron Losses: Losses from hysteresis and eddy currents in stator laminations. These rise rapidly with RPM and frequency.
UAV Design Concepts
Selecting propulsion components requires a balanced approach. To optimize a design:
- Determine Thrust Requirements: A multirotor needs a thrust-to-weight ratio of at least 2:1 for stable flight. The hover thrust per rotor equals the total UAV weight divided by the number of motors.
- Calculate Power Loading: Lower pitch propellers driven by low KV motors generate thrust more efficiently (g/W), extending flight times.
- Thermal Management: Maintain winding temperatures below $80^\circ\text{C}$ to protect wire insulation and prevent magnets from demagnetizing.
Platform Architecture
System Overview
ThrustVault uses a multi-tier, cache-synchronized architecture to provide fast query performance while maintaining write integrity:
- Frontend Layer: A single-page application built with HTML, CSS Variables, and JavaScript, displaying real-time metrics and dynamic comparison charts.
- API Gateway: An Express.js backend server handling security, authorization middleware, input validation, and query processing.
- Data Layer: A primary PostgreSQL database for writes and transaction logs, synchronized with a local SQLite cache mirror to speed up dashboard queries.
Data Flow Schema
[Test Bench Ingest] ──> [Express API Gateway] ──> [PostgreSQL Primary DB]
│
(Auto-Sync / 30s Loop)
▼
[Dashboard UI] <────── [Read Operations] <────── [SQLite Cache Mirror]
Security and Governance
Authentication & RBAC
User authentication uses encrypted sessions. Role-Based Access Control (RBAC) enforces clearances (Guest, Flight Engineer, and Systems Administrator) at the API gateway layer, protecting database records from unauthorized modifications.
Audit Logging & ITAR Compliance
The platform maintains detailed logs for compliance auditing: - **Audit Logs:** The database logs all additions, updates, and deletions of motor, ESC, and propeller specs. - **ITAR Compliance:** Data residency rules restrict high-payload UAV motor specs to classified US networks. Automated filters block access from unauthorized external IP addresses.
REST API Documentation
REST Endpoints
Authorized external services can interact with ThrustVault using these API endpoints:
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/motors | Browse the complete motor catalog. Supports pagination and KV filters. |
| POST | /api/motors | Register a new motor record in the database. (Requires Flight Engineer role). |
| GET | /api/motors/:id | Fetch full parameters for a specific motor by UUID. |
| POST | /api/test-runs | Ingest a new Rotrix test run log. |
API Ingestion Example
POST /api/motors HTTP/1.1
Host: localhost:8000
Content-Type: application/json
Authorization: Bearer api_key_secure_token
{
"model_name": "T-Motor U8 II",
"kv_rating": 120,
"weight_g": 240.0,
"resistance_mohm": 186.0,
"max_current_a": 50.0,
"extra_data": {
"poles": 24,
"slots": 18,
"configuration": "12S"
}
}
// Success Response
HTTP/1.1 201 Created
Content-Type: application/json
{
"status": "success",
"message": "Motor registered successfully",
"motor_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d"
}
Release Notes and Changelog
v2.0.0 (Beta) - System Integration
Released on June 21, 2026. Key updates:
- Admin Portal: Independent Express server running on port 8001.
- Dual Database: Introduced the synchronized SQLite cache mirror to speed up dashboard queries.
- Security: Expanded validation schemas and added detailed error codes.
v1.5.0 - Telemetry & Analysis
Released on June 11, 2026. Key updates:
- Ingestion: Added automated column mapping for Rotrix CSV telemetry logs.
- Charts: Added overlay charts for side-by-side motor comparisons.
v1.0.0 - Database Launch
Released on June 8, 2026. Initial database MVP release including motor catalog grids, user sessions, and access request workflows.