ESP32-S3-WROOM-1-N16R8を搭載した99L Mission Board firmwareです。Vault 00〜07/04aに基づくMission FSM、CAN codec、command lifecycle、sensor continuity、制御pipeline、パラシュート安全coreをproduction moduleとして実装し、既存bring-up firmwareも明示選択できる形で維持しています。
既定production buildは、MotorProfileValid=falseのため通常StartSequenceを拒否します。ForceStartSequenceでbit3をbypassした場合も、flight sequence中の動翼はBrake固定で、ZeroHold/Roll制御へ未認定motor profileを接続しません。パラシュートのHold/Open/retry/離床+25秒電源遮断経路は継続します。飛行認定済みfirmwareではなく、Forceはqualificationの代替ではありません。
現在の99L source contractはdocs/99l_source_contract.jsonに固定しています。Control rollは離床相対の連続・unwrapped推定値からentry時に一度だけreferenceをcaptureし、full-turn差をそのまま制御・0x10A telemetryへ渡します。
対象基板はtemp_new.kicad_sch / temp_new.kicad_pcbです。現行board_config.hppのGPIO38/39/40/41/42/44はこの基板と一致しています。
詳細な試験順序はdocs/bringup.md、実施結果はdocs/bringup_results.mdを参照してください。
2026-08-14にMission /dev/ttyACM1、ComBoard /dev/ttyACM0、Ground /dev/ttyUSB0を同時接続し、bring-upとproductionを実機確認しました。Mission productionはICM42688、AS5047D health gate/pipeline、CAN、AirData、Parachuteの各taskを起動し、panic/reset loopなしで動作しました。CommandReceive中のproduction CANは、修正後30秒で0x100/0x109を各3,000 frame、0x108を750 frame、0x102を301 frame、0x103/0x107を各300 frame、0x012を30 frame受信側で確認し、sequence gapとdecode errorは0でした。安全なGround commandとActuatorEmergencyのend-to-end結果も確認済みです。数値と判定はdocs/bringup_results.mdに記録しています。
src/protocol: Classic CAN 11-bit/125 kbit/sのlittle-endian codec、04a量子化、ID別sequence/schedulesrc/mission: 5状態FSM、flight epoch、reset/Deep Sleep recovery、16件transaction cacheとreplaysrc/sensors: liftoff/apex detector、freshness、ICM timestamp continuity、1 sample欠落補間src/control: Roll/ZeroHold、60〜180 m/s gain interpolation、quadratic N=3、TorqueMapper、stopper判定src/actuators: power cutoff latch、パラシュートstall retry/global deadlinesrc/runtime: fixed task/queue allocationとhardware owner。FSMはMissionRealtimeTaskだけが更新し、CAN/CommandWorkerからmessageで遷移要求を受けます。
優先順はSafety→Parachute→MissionRealtime→AirData→CAN→persistenceです。SPI2/SPI3とmotorはMissionRealtime、I2CはAirData、CAN controllerはCanTask、STS UARTとパラシュート設定はParachuteTask、NVSはInternalFlashTaskがそれぞれ唯一ownerです。SafetyTaskはflight epoch/離床時刻を独立監視し、離床+25秒でUART taskに依存せずGPIO40/44を遮断します。
ICM42688のfreshnessは取得時のhost_timestamp_usとesp_timer_get_time()を同じhost clock domainで比較します。ICM sensor timestampはhistory/姿勢計算用に保持しますが、clock driftを含むsensor時刻とhost時刻を直接比較して再初期化を繰り返してはいけません。CAN送信はTX完了callbackまで1枠を占有するため、production telemetryは5 msの有限timeoutで直列化します。Emergencyのstate判定はCanTaskのmutex noWait snapshotに依存せず、nonzero transactionをlatchしてMissionRealtimeTaskへ渡します。
未確定値を空欄のまま残すと、状態機械だけが進み、実出力は常時coastするという検証不能な状態になります。そこで、暫定値をsrc/config/flight_config.hppとsrc/config/board_config.hppへ集約し、値の根拠がsimulationかhardware testかをTODOで区別しています。
| 対象 | 暫定値 | 確定方法 |
|---|---|---|
| motor極性 | 正torqueでIN1 PWM | TODO(HW_TEST)で回転方向を確認 |
| motor抵抗 / torque定数 / 無負荷速度 | 3.48 Ω / 0.00855 N·m/A / 1120 rpm | TODO(HW_TEST)で個体同定 |
| drivetrain効率 / motor電流 / 出力torque上限 | 0.60 / 2.0 A / 1.21208 N·m | TODO(HW_TEST)で効率・温度・機構負荷を確認 |
| 用途別requested torque | HoldPosition 0.30 / ZeroHold 0.80 / Roll Gentle 1.21208 / High-authority comparator 3.0 N·m | generic limitとして共用せず、実機同定後に再評価 |
| motor bus / PWM duty上限 | 9.0 V / production追加clamp 100%(bring-up 15%) | TODO(HW_TEST)でADC実測と安全上限を確定。productionはTorqueMapperのcurrent/torque/angle制限を維持 |
| fin software limit | ±14° | TODO(HW_TEST)でstopper余裕を確認 |
| fin zero | SetFinZero正常完了時だけ現在のmotor-side AS5047D位置を0°とする |
boot時の最初のsampleから自動設定しない。機械zero手順はTODO(HW_TEST)で確定 |
| para Open / Close / 許容差 | NVSに保存するoptionalな1回転絶対角 / ±2° | Open/CloseはSetParaOpen / SetParaCloseで実機位置を設定し、許容差はTODO(HW_TEST)で確定 |
| para速度 / 加速度 / torque | 180°/s / 360°/s² / 20% | TODO(HW_TEST)で開放時間とstall余裕を確認 |
| para電源安定 / 初期化目安 / retry | 100 ms / 1.5 s / 飛行中20 ms・CommandReceive再接続1 s | TODO(HW_TEST)で電源立上り分布を確認 |
| 差圧zero / 平均窓 / 負圧許容 | 400 sample / 8 sample / 5 Pa | TODO(SIMULATION)とTODO(HW_TEST)でfilterと実測noiseを確認 |
| Saint-Venant係数 | firmware assumed 0.92 / robustness true range 0.60〜1.20 | true/assumedを共用せずTODO(SIMULATION/AERO_VALIDATION)で照合 |
| encoder pipeline | acquisition 1 kHz / consumer 1 kHzの暫定config | 1/2 kHzの最終選択はsystem ID後にconfig差替え |
| Roll gain | 60〜180 m/sの全点で{0.08, 2.32, 0.04, 0.296} |
TODO(SIMULATION)でSpica/HIL同定値へ置換 |
config_flagsはbit0=MotorProfile、bit1=fin zero取得、bit2=para Open/Closeの両方設定済み、bit3=SSC zero取得を示します。bit7は暫定値を含みflight qualification未完了であることを常時示します。SSC zeroはCommandReceive中にrolling更新せず、RunPreflightCalibration開始時に旧値をinvalid化し、そのattempt中に取得した400 sampleだけから再取得して完了後freezeします。最新attemptの失敗項目を古い成功値へrollbackしません。通常StartSequenceはpreflight readinessのmissing bitが残っていれば拒否し、ForceStartSequenceだけが仕様で定めたbitをbypassします。
Control遷移時には、同じtickで最新かつ未来時刻ではないunwrapped roll角を一度だけ基準角として取得します。角度偏差は最短角へwrapしません。flight epoch更新、CancelSequence、DisableFinControl、LiftoffDetectionEmergencyStop、reset/recovery rollbackで基準角を無効化します。Control input喪失後の再entryは禁止し、保持した基準角を再取得しません。
- 起動直後、他のdriverやtaskより先にGPIO38、39、40、44をLOWへ設定します。TB67H450は停止、+5 Vとpara電源はOFFです。
- production buildではパラシュートactuatorが動作し得ます。 機体へ接続する前にpara電源を物理遮断できるfixture上で確認してください。現行launch safety lockでは未認定motor profileによるflight中の動翼出力をBrake固定にしますが、CommandReceiveの明示motor試験は別経路として残ります。
- bring-up buildのactuator試験は自動実行しません。USB consoleから対応commandを明示的に入力した場合だけ実行します。
- production motorはcommand_receive、reset/recovery無効化、ActuatorEmergency、sensor/config不正時にcoastまたはbrakeへ移ります。±14°のsoftware limitでstopper方向またはzero torqueが要求された場合は、back-EMF補償PWMを残さず明示brakeとし、中心方向のtorqueだけを許可します。ActuatorEmergencyではmotorをcoast、Paraをtorque OFFかつGPIO44 OFFのFreeへ移し、差圧系GPIO40は維持します。driver APIが失敗した場合はmotor unavailableをlatchし、coastへ退避します。
- production paraはCommandReceive起動後に現在位置Holdを要求し、SafetyTaskがGPIO44へのON適用に成功したことをParachuteTaskが観測してから100 msの電源安定待ちを開始します。AirDataTaskのGPIO40要求はPara railを上書きしません。CommandReceiveでSTSが未接続なら1秒周期で再接続し、明示
ParaHold成功時はHold成立状態を保持します。ActuatorEmergency後はGPIO44をOFFへ安全化したうえでrequested modeをFreeのまま維持し、再接続後も自動Holdへ戻しません。通常StartSequenceではfreshな現在位置をHoldし、Close位置へは移動しません。Open/Closeを検証して成功時にflight RAM snapshotへfreezeし、Descent/OpenとretryはそのsnapshotのOpenだけを使用します。5秒のOpen試行deadline後も+25秒の絶対cutoffまではHold要求を維持し、SafetyTaskが離床+25秒でGPIO40/44の両方をUART taskと独立に遮断して再投入不能にラッチします。 - bring-up motor PWMは
motor-arm後だけ許可されます。arm状態はRAMだけに保持され、resetで必ず解除されます。試験中でもmotor-disarmを受理し、通常は即時、出力lock競合時も5 ms以内に安全停止を再試行します。production経路はbring-upのarm状態を使用せず、Mission FSMと安全gateで出力を管理します。 - bring-upでmotor単体を接続する場合は動翼・stopperが無いため、飛行用software limitを使いません。bring-up専用上限はduty 15%、速度100 rad/s、command時間45秒です。速度上限は実測前の暫定値で、
combined-motor-imu-testの実行時間は41秒です。 - bring-upのSTS UART1はshell初期化時、Para電源OFFのまま一度だけopenし、shell lifetime中は保持します。
sts-*command時だけPara電源をONにして100 ms待機し、起動中のtimeoutだけを1.5秒のdeadline内で再PINGしてからSTS3215を初期化します。終了時はtorqueを無効化してPara電源をOFFにしますが、UARTはcloseしません。最初の移動はsts-small-moveで絶対値3度以下に限定します。 aux5v-onはGPIO40をHIGHにし、aux5v-offまたはresetまで+5 Vを保持します。必要な試験中だけ明示的にONにし、終了後は必ずOFFへ戻します。pio device monitorとbinary captureを同時に開かないでください。同じUSB deviceを同時利用できません。- motor capture中に
Ctrl-Cを入力するとhost toolはportを閉じる前にmotor-disarmを送ります。ただしUSB通信不能時には届かないため、物理resetまたはmotor電源遮断を直ちに行える状態を必ず確保してください。 - CAN診断前に
statusでmotor disarm、IN1/IN2 LOW、AUX5V OFF、Para電源OFFを確認します。CAN診断中はmotor arm/test、STS hold/move、AUX5V ON、actuator出力commandを実行しません。
新規cloneでは次を実行します。
git clone --recurse-submodules https://github.com/CREATE-ROCKET/Avi_99L_MissionBoard.git
cd Avi_99L_MissionBoard既存cloneでは次を実行します。
git submodule sync --recursive
git submodule update --init --recursive
git submodule status
git -C lib/Avi_ESP_Libs status --short
git -C lib/Avi_ESP_Libs branch --show-current
git -C lib/Avi_ESP_Libs rev-parse HEADlib/Avi_ESP_Libsはrefactor branchから取得し、親repositoryのgitlinkでrevisionを固定します。Mission側へdriverをvendor化しません。
PlatformIOとespressif32@7.0.1、指定されたtool packageを初回だけnetwork経由で取得します。
AVI_99L_MOTOR_PROFILE_ID=1 pio pkg install -e avi_99l_missionboard
AVI_99L_MOTOR_PROFILE_ID=1 pio run -e avi_99l_missionboardAVI_99L_MOTOR_PROFILE_IDはbuildごとに明示指定必須です。現行catalogは1=kFlightMotorA、2=kSpareMotorBで、未指定または未知IDではbuildを失敗させます。active profileはruntime/NVS/CAN/LoRa/USBから変更できません。
既定environmentはMISSION_BRINGUP_SHELL=0のproduction runtimeです。既存bring-up shellはAVI_99L_MOTOR_PROFILE_ID=1 pio run -e avi_99l_missionboard_bringupでbuildします。既知のdriver panicを再現し得るCAN比較診断は、専用environmentだけに隔離しています。
AVI_99L_MOTOR_PROFILE_ID=1 pio run -e avi_99l_missionboard_can_diagavi_99l_missionboard_can_diagだけがMISSION_CAN_UNSAFE_DIAG=1を定義します。通常のproduction/bring-up buildではcan-testとraw ESP-IDF lifecycle試験をESP_ERR_NOT_SUPPORTEDで拒否します。2026-08-13のbuild logで実際にcompileされたESP-IDFは6.0.1であり、PlatformIO platform versionから推測した値ではありません。現行production buildはmotor profile未認定のため通常Startを拒否し、Force Startでもflight中の動翼をBrake固定にします。
host testはworkspace外の実行可能なbuild directoryを指定します。
cmake -S host_test -B /tmp/avi-99l-mission-host
cmake --build /tmp/avi-99l-mission-host --parallel
ctest --test-dir /tmp/avi-99l-mission-host --output-on-failure
python3 tools/capture_bringup.py --self-test共通golden vectorはtestdata/99l_protocol_golden_vectors.txtです。Mission/ComBoard/Groundでbyte-identicalに保ちます。
次の条件を満たせば、通常のpio runにnetworkは不要です。
lib/Avi_ESP_Libsをsubmoduleとして取得済みplatformio.iniで指定するplatform/toolchain/ESP-IDF/esptool packageをPlatformIO cacheへ取得済み- remote
lib_depsに依存していない
project-local board manifestはboards/avi_99l_missionboard.json、partition tableはpartitions.csvです。設定はESP32-S3、Flash 16 MiB、Octal PSRAM 8 MiB、QIO 80 MHzです。
実機data取得専用buildはproductionと別entry pointです。起動時は必ずmotor coast/disarmで、profileを自動開始しません。
AVI_99L_MOTOR_PROFILE_ID=1 pio run -e avi_99l_missionboard_characterization
pio test -e native
python3 tools/capture_characterization.py --self-test
python3 tools/verify_characterization.py --self-test
python3 tools/package_spica_characterization.py --self-test対象board・portを確認し、人間がcharacterization firmwareのuploadを明示許可した場合に限り、専用environmentを指定します。
AVI_99L_MOTOR_PROFILE_ID=1 pio run -e avi_99l_missionboard_characterization -t upload \
--upload-port "$MISSION_PORT"campaign順序、console command、M0のcold-power gate、abort条件、V5 wire contract、取得・検証・package手順はdocs/characterization_campaign.mdを参照してください。1000 Hz fullは全stageで必須、2/5 kHzは先に静止rate-checkを行い、unsupportedの場合も理由と分母をraw logへ残します。
2026-08-15時点では、搭載計器審査書のAS5048A/20 kHzと現行code・実機記録のAS5047D/30 kHzが衝突し、motor極性も未確定です。buildと非駆動確認はできますが、この衝突をoperatorが解消するまでchar armとchar run fullを実行してはいけません。upload、motor arm、stage変更、fin取り外しは自動化しません。
drive gateの既定値はhardware approval 0、command-to-fin sign 0です。両方を実機確認済みの値へ明示設定しない限り、firmwareはarmを拒否します。
raw .binを検証してから、全stageのUART logとconditionsをまとめます。
python3 tools/verify_characterization.py capture.bin --integrity integrity.json
python3 tools/package_spica_characterization.py captures \
"99l_characterization_<session-id>" \
--conditions conditions.json --operator-label "<operator-label>" \
--uart FV=FV_uart.log --uart FH_positive=FH_positive_uart.log \
--uart FH_negative=FH_negative_uart.log --uart M0=M0_uart.log --csvbinaryが正本で、CSVはlosslessな確認用です。validator/importerがrejectした値を手修正せず、writerまたはreaderの契約違反を直して新しいartifactを取得します。model fitとparameter採用は今回の範囲外です。
/dev/ttyACM<N>のNを推測せず、接続のたびに候補とchipを確認します。以下のMISSION_PORTには、その場で確認したdevice pathを入力してください。
pio device list
ls -l /dev/ttyACM*
read -r MISSION_PORT
test -c "$MISSION_PORT"
pio pkg exec -p tool-esptoolpy -c "esptool.py --chip esp32s3 --port $MISSION_PORT chip_id"確認後に同じ変数を使います。upload_portはrepositoryへ固定しません。次はproduction専用であり、characterization firmwareには使いません。
pio run -t upload --upload-port "$MISSION_PORT"次はhardware reviewとoperatorの明示許可後だけ使うcharacterization専用uploadです。
AVI_99L_MOTOR_PROFILE_ID=1 pio run -e avi_99l_missionboard_characterization -t upload \
--upload-port "$MISSION_PORT"uploadしたenvironmentに対応するmonitorを開始します。
pio device monitor --port "$MISSION_PORT" --baud 115200 --eol LF以下はMISSION_BRINGUP_SHELL=1でのみ有効です。production runtimeのUSB console commandではありません。
全commandは1行ずつ送ります。不正な引数、未初期化、timeout、driver error、別testの実行中をshellが明示します。
| command | 内容 |
|---|---|
help |
command一覧を表示 |
status |
初期化、busy、arm、安全出力、stream状態を表示 |
spi-test |
encoder用SPI2とIMU用SPI3のbegin/device count/endを確認 |
encoder-test |
AS5047Dのstatus、通常read、pipeline、error flagを確認 |
encoder-stream <seconds> |
AS5047Dを1 kHzでbinary stream出力 |
imu-selftest |
FIFO無効状態でICM42688 self-testを実行 |
imu-stream <seconds> |
ICM42688 FIFOを1 kHzでbinary stream出力 |
imu-static <seconds> |
stationary raw dataをbinary stream出力 |
can-lifecycle-test <count> |
TXせずCANCREATEの生成/begin/status/no-data read/end/破棄を1〜1000回確認 |
can-test |
CANCREATEのACK/self-loopback診断。can_diag buildだけで許可されるが、Avi_ESP_LibsはESP-IDF 6以上を既知safe release確認まで安全拒否 |
can-idf-lifecycle-test |
CANCREATEを使わずpublic ESP-IDF TWAI APIだけでself-test TX/node削除を比較。can_diag build専用 |
can-load-test <hz> <seconds> |
test ID 0x7FEの負荷試験。ESP-IDF 6以上では既知safe release確認まで実行拒否 |
sts-probe |
persistent UARTで明示PING、servo begin、設定read後に安全cleanup |
sts-read |
STS3215 telemetryを約50 Hzで取得 |
sts-free |
torqueを無効化し、終了時にpara電源OFF |
sts-hold |
現在位置保持を明示実行 |
sts-small-move <deg> |
低速・低torqueで相対移動。abs(deg) <= 3 |
i2c-probe |
0x28、0x5C、0x5Dの有限timeoutとLPS transport latencyを確認。物理値は評価しない |
sd-test |
SDMMC 4-bitで1 MiB write/flush/fsync/readback/CRC/unmount |
flash-test |
label検証済みflightlogの試験範囲をwrite/read/再起動検証/erase |
adc-stream <seconds> |
logic/motor電圧をcalibrated ADCで100 Hz取得 |
aux5v-on |
+5 V enableをON。aux5v-offまたはresetまで保持 |
aux5v-off |
+5 V enableをOFF |
calibrate |
最新attemptのgyro bias、gravity、tilt、差圧zero validityを更新 |
calibration-repeat <count> |
calibrationを指定回数繰り返す |
motor-arm |
motor試験をRAM上でarm |
motor-disarm |
PWM=0、IN1/IN2 LOWへ戻しdisarm |
motor-polarity |
2、4、6、8、10%の短いpulseで回転方向を実測 |
motor-step |
正負5、10、15%の短いstep responseを取得 |
motor-prbs |
固定seed、band-limited PRBSで同定dataを取得 |
motor-coast |
加速後にHi-Zとし速度減衰を取得 |
motor-brake-test |
加速後にshort brakeとし速度減衰を取得 |
combined-motor-imu-test |
30秒motor-off baseline、10秒±5% PRBS、1秒coastを1回で同時取得 |
host toolはPython標準libraryだけを使います。まずparserとCRC、sequence gap処理のself-testを実行します。
python3 tools/capture_bringup.py --self-test取得時間にはfirmware側commandより数秒の余裕を持たせます。pio device monitorを閉じてから実行してください。
python3 tools/capture_bringup.py "$MISSION_PORT" data/bringup \
--duration 65 --command "encoder-stream 60"
python3 tools/capture_bringup.py "$MISSION_PORT" data/bringup \
--duration 305 --command "imu-static 300"record type 1〜5をすべてCSVへ変換します。
| type | CSV | payload size |
|---|---|---|
| 1 | encoder | 23 byte |
| 2 | IMU | 69 byte |
| 3 | ADC | 41 byte |
| 4 | motor identification | 78 byte |
| 5 | calibration | 57 byte |
出力はbyte列をそのまま保存する.raw、capture統計とsequence gapを記録する_summary.json、record種別ごとのCSVです。IMU recordについてはgyroの平均・標本標準偏差・時間drift、accelerationの平均・norm・標本標準偏差、1/3/10秒window biasのばらつきもsummaryへ逐次集計します。
Ctrl-C時はmotor-disarm送信を最大0.5秒試行し、成否をemergency_disarm_attemptedとemergency_disarm_errorへ記録します。これは物理resetまたは電源遮断の代替ではありません。data/bringup/は.gitignore対象で、結果の要約だけをdocs/bringup_results.mdへ残します。詳細なwire formatはdocs/bringup.mdを参照してください。
CANはstandard 11-bit、125 kbit/s、DLC 8以下、multi-byteはlittle-endianです。0x001/002 Emergency、0x008/105 Recovery、0x010/011 generic request/result、0x012/013 Time、0x020 MissionEvent、0x100..109 telemetryを実装します。Emergencyはgeneric commandへ統合しません。transaction ID 0は禁止、pending ID再利用禁止、同一requestはreplay、同一ID異payloadはProtocolErrorです。
100 HzはKinematics/Control/AirspeedとDescent中のDescentCore、25 HzはLPS、10 HzはMissionStatus/PowerTime/Tiltです。AirData power cutoff後はLPS/Airspeedを停止します。未取得物理値は04aのsemantic error rawを送信し、0として偽装しません。
- ICM42688とAS5047Dは各独立SPI busで1 kHz acquisition候補
- LPS25HB/SSCは外部pull-upのI2C0 300 kHz。SSC未接続は正常な起動条件で、Controlだけをinhibitします。
- 現在のLPS25HB個体はpressure/temperatureの妥当性を保証できません。bring-upではtransport/config/read/cleanupとread latencyだけを評価し、物理値、実効ODR、freshness、離床・頂点判定を合格扱いしません。
- 2026-08-13のaddress probeでは100 ms以上安定後も未使用
0x5Dへ1/3,200のintermittent false ACKがありました。logic analyzerでwire ACK/NACKを確認するまでI2C address検出も未解決です。 - STS3215とactive/flightパラシュート設定は
ParachuteTaskが唯一ownerです。Open/Closeは0..4095 countの1回転絶対角として独立にNVSへ保存し、方向は保存しません。絶対Open/Closeは共通の最短円周経路を使い、exact 180 deg(2048 count)は方向を選ばず拒否します。signed相対角をそのまま使うのはParaMoveRelativeだけです。 - bring-upのSTS tx/response timeout 100 msと起動deadline 1.5秒は
TODO(HW_TEST)暫定値です。2026-08-13の実機ではPara電源ON後の最初の6回がtimeoutし、7回目のPING、STS3215初期化、50回のtelemetry read、cleanupが成功しました。個体差・電源条件を測定後に安全に短縮します。 - MotorProfile polarity/個体値、fin software limit、para位置・速度・torqueは暫定値を設定し、
TODO(HW_TEST)を保持します。 - Roll gain table、freshness/debounce、quadratic estimator、差圧filter、torque scaleは暫定値を設定し、
TODO(SIMULATION)を保持します。
- NVS para設定は
InternalFlashTaskを唯一ownerとして接続済みです。SetParaOpen/SetParaCloseはfreshなSTS絶対角を保存・commit・readback検証した後だけactive設定を更新します。flight中はOpen target取得のためにNVSを読みません。Internal Flash append logとSD production loggerはowner taskの安全stubまでで、flight pathへ未接続です。software/watchdog reset用checkpointはversion/CRC付きRTC memoryで復旧し、POR後の絶対時刻復旧は未接続のため安全側に飛行再開しません。 - production runtimeは暫定flight設定で有効ですが、値はsimulation/HIL/実機で未確定です。bit7が立っているbuildを飛行認定済みとして扱ってはいけません。
- ICM history/replay、AS5047D unwrap、quadratic fin rate、ZeroHold/Roll、TorqueMapper、TB67H450 PWMは接続済みです。FinZeroは起動時に自動設定せず、
SetFinZero正常完了時だけ現在のmotor-side AS5047D位置をzero referenceとして設定します。 - productionの手動Para commandは接続済みです。
SetParaOpen/SetParaCloseは全argumentを0とし、現在位置だけを保存します。通常StartSequenceは両endpointとhalf-turn条件を検証します。ForceStartSequenceとForce用optional snapshot、未設定Openのfail-safe処理も接続済みです。productionのFinFree/SetFinZero/StartFinZeroHold/FinMoveRelativeと明示RunPreflightCalibrationも接続済みで、SSC zeroはCalibration attempt中だけ取得し完了後freezeします。 - ADCによるmotor/logic電圧監視とbattery present threshold/debounceはproduction flight gateへ未接続です。
- AS5047DではDIAG/AGC/magnitudeが全て0の応答を一度確認しましたが、最終再試験では
offset_done=1、AGC 61、magnitude 4616で正常化しました。bring-upとproduction startupは共通health判定でall-zeroをESP_ERR_INVALID_RESPONSEとし、productionはpipelineを開始せずfin angle/rateをunavailable、motorをcoastに保ちます。角度0度そのものは故障条件ではありません。実機productionでは正常status時のpipeline開始と、一時診断buildでall-zeroを注入した際のstatus拒否/pipeline未開始を確認しました。確認を妨げていたMissionRealtimeTaskのstack overflowは、task専有の大型history/FIFO wrapperをstatic storageへ移して解消し、startup時点の最小空き2,504 byteを実測しています。このgateはstartupと明示reinitialize時だけで、1 kHz loopへ周期的なpipeline停止を追加していません。飛行中にMISOがstuck-lowへ遷移した場合のDIAG検出は残TODOです。 - ESP-IDF 6.0.1のlocal
esp_twai_onchip.cにはEspressif issue #18803の修正がありません。TX完了通知のevent-group更新がtimer taskへ遅延したままnodeを削除するuse-after-freeを実機で再現したため、Avi_ESP_LibsのCANCREATE::test()はESP-IDF 6以上を既知safe release確認までESP_ERR_NOT_SUPPORTEDで拒否します。常駐ownerを使うproduction CANとはlifecycleが異なります。 - Deep SleepはRTC marker/wake causeを検証した専用task subsetで10秒周期wakeします。Internal Flash/SD log reader未接続のためlog dump要求は
SourceUnavailableです。2秒command windowはTODO(HW_TEST)です。 - 3基板実機でMission→ComBoard CAN、ComBoard↔Ground LoRa、Ground→Missionの安全なcommand round-tripは確認済みです。今回接続したproduction motor motion、STS収納保持/Open、差圧zero、Control遷移、5秒/25秒cutoffは未検証であり、成功扱いしません。
- Mission基板上のmicroSDはbring-up
sd-testで1 MiB write/read/CRCをPASSしていますが、Mission production loggerは未接続です。今回BLOCKEDとなったCAN.CSVlogging/readbackはComBoard側microSDの初期化問題であり、Missionのbring-up microSD PASSを取り消す結果ではありません。