KURAGE GCS Operations Manual

KURAGE GCS 運用マニュアル — 接続設定・飛行手順・トラブルシューティング
BROWSER-BASED GROUND CONTROL STATION / ARDUPILOT & PX4 / MAVLINK

1. Requirements必要なもの

KURAGE GCS runs entirely in a browser. Nothing is installed on the operator's computer. You need an ArduPilot or PX4 aircraft, a telemetry path from that aircraft to the machine running the browser, and a KURAGE account.

KURAGE GCS はブラウザだけで動作します。操作端末へのインストールは不要です。ArduPilot または PX4 の機体、機体から操作端末までのテレメトリ経路、KURAGE アカウントの 3 点を用意してください。

2. Connection setup接続設定

Enter the connection string in the CONNECTION panel on the left of the dashboard, then select CONNECT. The status turns to CONNECTED once the aircraft heartbeat arrives. If no heartbeat arrives, the connection fails with NO HEARTBEAT rather than appearing to succeed.

ダッシュボード左の CONNECTION パネルに接続文字列を入力し、CONNECT を選択します。機体からハートビートが届くと CONNECTED になります。届かない場合は成功したように見えることはなく、NO HEARTBEAT で失敗します。

Choosing the connection string — 接続文字列の選び方

Situation 状況Connection string 接続文字列Notes 補足
Aircraft sends telemetry to this machine
機体側から送信してくる場合
udpin:0.0.0.0:14550 Listens for incoming telemetry. Use this for MAVProxy links and VPN tunnels.
受信待ち受け。MAVProxy 経由・VPN 経由はこちら。
GCS connects out to a known address
GCS から接続しにいく場合
udp:AIRCRAFT_IP:14550 Only when the aircraft is listening on a fixed address.
機体側が固定アドレスで待ち受けている場合のみ。
TCP link or simulator
TCP 接続・シミュレータ
tcp:127.0.0.1:5760 Standard ArduPilot SITL port.
ArduPilot SITL の標準ポート。
Serial or USB on the same machine
同一機での USB / シリアル
/dev/ttyACM0:115200 Device path and baud rate.
デバイスパスとボーレート。
UDPIN VS UDP

udpin: waits for telemetry to arrive; udp: sends to a destination. If the aircraft-side MAVProxy pushes telemetry to the server, the GCS must use udpin:0.0.0.0:14550. Using udp: in that situation produces no heartbeat and the connection is rejected.

udpin: は受信待ち受け、udp: は送信先指定です。機体側 MAVProxy から送りつける構成では、GCS 側は必ず udpin:0.0.0.0:14550 を使ってください。ここで udp: を指定するとハートビートが届かず接続は拒否されます。

Aircraft-side MAVProxy — 機体側 MAVProxy

Forward the flight controller's serial link to the ground station address:

フライトコントローラのシリアル接続を地上局のアドレスへ転送します。

mavproxy.py --master=/dev/ttyACM0 --baudrate=115200 --out=udp:GCS_ADDRESS:14550

On Windows, use the COM port instead: --master=COM3

Windows では COM ポートを指定します: --master=COM3

Selecting the aircraft profile — 機体プロファイル

Below the connection field, select the firmware (ArduPilot or PX4) and the airframe type (COPTER or PLANE). Flight mode numbering differs between them, so an incorrect selection sends the wrong mode to the aircraft.

接続欄の下でファームウェア (ArduPilot / PX4) と機体種別 (COPTER / PLANE) を選択します。両者でフライトモード番号が異なるため、誤った選択は誤ったモード指令になります。

3. Pre-flight checks飛行前点検

Confirm each item in the header bar and the left panel before arming.

アーム前に、ヘッダーバーと左パネルで各項目を確認してください。

Indicator 表示Required state 必要な状態
CONNECTEDGreen. Telemetry is flowing. / 緑。テレメトリ受信中。
GPSFIX. WAIT means no position lock yet. / FIXWAIT は測位未完了。
MODEMatches what you selected. / 選択したモードと一致していること。
ARMEDDISARMED before you begin. / 開始時点では DISARMED
BatterySufficient for the mission plus reserve. / 任務 + 予備を満たす残量。
AIRSPACE CHECKOutside controlled and restricted zones. / 管制空域・制限空域の外。
LIVE WEATHERWind and gust within the aircraft's limits. / 風速・突風が機体の限界内。

Open AIRSPACE CHECK and LIVE WEATHER by selecting their titles in the right panel. Both are collapsed by default to keep the flight controls in view.

AIRSPACE CHECKLIVE WEATHER は右パネルのタイトルを選択すると開きます。操縦系を画面内に保つため、既定では畳まれています。

4. Flight procedure飛行手順

The controls are ordered top to bottom in the order you use them: emergency stop, flight mode, then flight control.

操縦系は使用順に上から並んでいます: 緊急停止、フライトモード、フライトコントロール。

  1. Connect — enter the connection string, select CONNECT, wait for CONNECTED and GPS FIX.
    接続 — 接続文字列を入力し CONNECT、CONNECTED と GPS FIX を待つ。
  2. Select a flight mode — for autonomous control select GUIDED. Wait for the green confirmation before continuing.
    モード選択 — 自律制御は GUIDED。緑の確定表示を待ってから次へ。
  3. Arm — select ARM. The aircraft refuses to arm if its own pre-arm checks fail, and the reason is shown.
    アーム — ARM を選択。機体側のプリアームチェックに失敗すると拒否され、理由が表示される。
  4. Set the target altitude — enter metres in the field above TAKEOFF.
    目標高度 — TAKEOFF の上の欄にメートルで入力。
  5. Take off — select TAKEOFF and watch the altitude readout climb.
    離陸 — TAKEOFF を選択し、高度表示の上昇を確認。
  6. Fly — right-click the map to send the aircraft to a point (see section 7), or change flight mode as needed.
    飛行 — 地図を右クリックして目標地点へ移動 (7 章)、または必要に応じてモード変更。
  7. Land — select LAND to descend in place, or RTL to return to the launch point and land.
    着陸 — その場で降下は LAND、離陸地点へ戻って着陸は RTL。
  8. Disarm — after the aircraft is on the ground and the motors have stopped.
    ディスアーム — 着地しモーターが停止してから。
ALTITUDE REFERENCE

The ALT readout is height above the launch point, not height above sea level. Terrain that rises under the aircraft reduces actual ground clearance.

ALT 表示は離陸地点からの相対高度で、海抜高度ではありません。機体の下の地形が上がれば、実際の対地高度はその分減ります。

5. Reading command results結果表示の読み方

Every command produces a message in the AI EVENT TIMELINE and a toast on screen. The colour tells you how far the command got. This distinction matters: a command that was transmitted is not the same as a command the aircraft accepted.

すべてのコマンドは AI EVENT TIMELINE に記録され、画面にトーストが出ます。色が「どこまで進んだか」を表します。送信できたことと機体が受理したことは別である、という区別が重要です。

Display 表示Meaning 意味Action 対応
ARM SENT Transmitted to the aircraft. No verdict yet.
機体へ送信済み。可否はまだ不明。
Wait a moment for the result.
結果表示を待つ。
ARM OK The aircraft accepted and executed it.
機体が受理し実行した。
Continue.
次へ進む。
ARM FAILED The aircraft refused. The reason follows when the aircraft reports one.
機体が拒否。理由が届けば続けて表示される。
Resolve the reason before retrying.
理由を解消してから再試行。

If a command stays yellow and then turns red with a timeout message, the aircraft never answered. Treat that as a link problem, not as a command that quietly succeeded.

黄色のままタイムアウトで赤に変わった場合、機体から応答がなかったということです。黙って成功したのではなく、通信経路の問題として扱ってください。

6. Why a button is disabledボタンが押せない理由

Flight controls are enabled only when the aircraft state allows the command. A dimmed button is not a fault. Hold the pointer over it to see the requirement.

操縦ボタンは、機体の状態がその指令を受け付けられるときだけ有効になります。薄く表示されているのは故障ではありません。ポインタを重ねると条件が表示されます。

Control 操作Enabled when 有効になる条件
ARMConnected and disarmed / 接続済みかつディスアーム状態
DISARM, LAND, RTLConnected and armed / 接続済みかつアーム状態
TAKEOFFArmed and in GUIDED / アーム済みかつ GUIDED
Flight modesConnected / 接続済み
EMERGENCY STOPConnected / 接続済み
Map right-click GOTOArmed and in GUIDED / アーム済みかつ GUIDED

7. Sending the aircraft to a point目標地点への移動

Right-click the map at the destination. A confirmation shows the coordinates and the altitude, taken from the waypoint altitude field. Confirm to transmit. A green marker marks the target and the result appears in the timeline.

目的地で地図を右クリックします。座標と高度 (ウェイポイント高度欄の値) の確認ダイアログが出ます。確定すると送信され、緑のマーカーが目標地点に置かれ、結果がタイムラインに表示されます。

Left-click is reserved for adding waypoints, so it never sends a command to the aircraft.

左クリックはウェイポイント追加用で、機体への指令は送りません。

GOTO BLOCKED — 遮断された場合

The aircraft must be armed and in GUIDED to accept a position target. If it is not, the command is blocked before transmission and the requirement is shown.

位置指令を受け付けるには、機体がアーム済みかつ GUIDED である必要があります。条件を満たさない場合は送信前に遮断され、必要な条件が表示されます。

8. Waypoint missionsミッション

Open the MISSION tab, enable ADD WP MODE, and left-click the map to place waypoints. Set the altitude before placing each point. Survey Grid and Orbit patterns generate waypoints automatically over an area.

MISSION タブを開き ADD WP MODE を有効にして、地図を左クリックでウェイポイントを配置します。高度は配置前に設定してください。Survey Grid と Orbit は指定範囲のウェイポイントを自動生成します。

MISSION START IS A SIMULATION

MISSION START previews the route on screen. It does not transmit the mission to the aircraft, and its progress messages describe the preview only. Never use those messages to judge where the aircraft is or whether it has landed — read the telemetry: ALT, MODE, and ARMED.

MISSION START は画面上で経路をプレビューする機能です。機体へミッションを送信することはなく、進捗表示もプレビューについてのものです。機体の位置や着陸の有無をこの表示で判断しないでください。ALTMODEARMED のテレメトリで確認します。

9. Emergency stop緊急停止

EMERGENCY STOP cuts the motors immediately. An airborne aircraft will fall. Use it when continued flight is more dangerous than an immediate descent — for example a fly-away toward people or an obstacle strike in progress. To end a flight normally, use LAND or RTL.

EMERGENCY STOP はモーターを即時停止します。飛行中の機体は落下します。飛行の継続が即時落下より危険な場合 — 人の方向への暴走、障害物への接触進行中など — に限って使用してください。通常の飛行終了は LAND または RTL です。

10. Troubleshootingトラブルシュート

Message 表示Cause and fix 原因と対処
NO HEARTBEAT No telemetry reached the GCS. Check the connection string form (udpin: vs udp:), that MAVProxy is running, the port number, and firewall rules.
テレメトリが届いていません。接続文字列の形式 (udpin:udp:)、MAVProxy の起動、ポート番号、ファイアウォールを確認。
NO VEHICLE LINK The command was issued with no aircraft connected. Connect first.
未接続の状態で指令が出されました。先に接続してください。
Link lost Telemetry stopped for 15 seconds. Check radio range, antennas, battery, and the aircraft-side link.
15 秒間テレメトリが途絶えました。電波到達範囲、アンテナ、バッテリー、機体側の接続を確認。
PreArm: ... The aircraft's own pre-arm check failed. The text names the failing check — GPS lock, compass calibration, or a mode that cannot be armed.
機体側のプリアームチェックに失敗。文言が該当項目を示します — GPS 測位、コンパス校正、アーム不可のモードなど。
Mode requires mission AUTO was selected with no mission loaded on the aircraft. Upload a mission or select another mode.
機体にミッションが無い状態で AUTO が選択されました。ミッションを投入するか別モードを選択。
Mode change times out
モード変更がタイムアウト
The aircraft did not enter the requested mode. Common causes: the mode needs a GPS fix, or the airframe type selection is wrong.
機体が要求モードに入りませんでした。GPS 測位が必要なモードである、機体種別の選択が誤っている、が主因です。
Position command rejected
位置指令が拒否された
The aircraft was not in GUIDED, was not armed, or had no position lock.
GUIDED でない、アームされていない、測位できていない、のいずれかです。
A control cannot be clicked
操作できないボタンがある
Either the state gate has disabled it (section 6), or the browser window is too narrow and the layout has collapsed. Maximise the window.
状態ゲートによる無効化 (6 章) か、ウィンドウが狭くレイアウトが崩れているかです。最大化して確認。

11. Supported hardware対応機器

Flight controllerFirmwareLink
KURAGE FC H7 Anti-JammingArduPilot / PX4UDP / USB
KURAGE FC H7 StandardArduPilot / PX4UDP / USB
KURAGE FC F722 AgileArduPilotUDP / USB
Pixhawk 1 / 2 / 4 / 6ArduPilot / PX4UDP / USB
Cube Orange / BlackArduPilot / PX4UDP / USB
Matek F405 / H743ArduPilotUDP / USB
Holybro KakuteArduPilot / PX4UDP / USB

Any MAVLink-compatible flight controller running ArduPilot or PX4 should connect. Companion computers forward telemetry over the network with MAVProxy.

ArduPilot または PX4 が動作する MAVLink 対応フライトコントローラであれば接続できます。コンパニオンコンピュータは MAVProxy でテレメトリをネットワークへ転送します。

12. Support問い合わせ

Report a defect through BUG REPORT in the dashboard, or contact us for deployment and integration questions.

不具合はダッシュボードの BUG REPORT から報告してください。導入・連携に関するお問い合わせは下記へお願いします。

Contact お問い合わせ  ·  KURAGE GCS  ·  KURAGE Vision  ·  KURAGE FC