カテゴリー
お知らせ リリース 機能使用方法

hsbox1.3.1リリース 日時指定プッシュやDDNSの動的IP情報の自動更新に対応

2023年5月21日にhoscmは、hsbox1.3.1.0をリリースしました。日時指定で繰り替えしまたは1回のみのプッシュ通知機能を追加しました。これにより指定した任意のYouTube動画やインターネット上のmp3、mp4コンテンツや、家庭内LAN上に置いたコンテンツを、特定の時刻に再生できます。 つまり、 任意の音声や楽曲等でアラーム通知できます。
 また、DDNSを利用している場合、動的に変化するIP情報を更新する必要がありますが、これを自動的に更新する機能を追加しています。

日時指定呼出設定機能

「日時指定呼出設定」タブ → 「新規追加」で、下の設定項目が表示されます。” 操作対象”、”URL”、”パラメータ”、”文面”で設定する項目は「コマンドボタン」機能と同じです。詳細は「コマンドボタン機能」のページを参照してください。呼び出し可能なコンテンツはコマンドボタン機能と同じで、動画(mp4)、音声(mp3)、画像(jpeg)、YouTube動画、任意の文字列で指定した音声を指定できます。
 ”日時指定呼出設定”では、繰り返し実行するか、1回だけ実行するかを選択します。
 ”繰り返し”実行の場合は、日時指定は”*”を使用できます。*はすべての数値の指定の意味です。たとえば毎日午後18:50に実行したい場合は、”*月*日18時50分*曜日”と設定します。”1回”実行の場合は、曜日以外はすべての数値を設定してください。

DDNS 動的IP情報更新の設定機能

DDNS反映機能では、 IP情報を反映するためにアクセスURLを指定します。 指定するのはhttp:// 以降の URLです。
 また、反映するために指定するアカウント、パスワードを指定します。※上の設定場面参照
  この設定を行うとAM2:00からAM5:59の間のランダムで設定した時刻に毎日動的IP反映処理が行われます。

日時指定呼出設定およびDDNS更新設定の削除機能

日時指定呼出設定やDDNS更新設定を行うと、下の画面のとおり「設定一覧」に設定した項目が表示されます。
  設定が未反映で表示されない場合があります。このときは「更新」ボタンを押して、表示を更新してください。表示に時間がかかることがあります。
 各設定を削除したい場合は、右側の「削除」ボタンを押してください。
※hsboxが動作のために使用する設定項目(2項目)もありますが、これらは削除できません。(削除ボタンがグレーアウトされて使用できません)

詳細の強化・修正項目

※1.03.01.00および1.03.01.01では、前回リリース1.03.00.03から以下の変更があります。

hsbox1.03.01.00

hsbox1.03.01.01
カテゴリー
お知らせ システム 機能使用方法

hsboxでのWiFi接続、ネットワーク接続のトラブルシューティング

ここではhsboxでのネットワーク関連のトラブルのパターンとその対策について扱います。

■1. はじめに

このWebページのURLは、hsboxがインターネットに接続できない状態のときQRコード(赤色)でhsboxのコンソールに表示します。このページでは、そのトラブルの原因と対策を示し、問題解消を支援します。

■2.原因・要因

 直接的な問題は、「hsboxからインターネット上サーバに向けたpingへの応答がない。」ことです。 ルータなどのネットワーク機器が原因のこともあります。まず、他の機器からインターネットへのアクセスができているか確認してください。家庭内LAN上の他の機器がインターネットにアクセスできている場合は、hsboxが家庭内LANに接続できていません。以降は、hsboxが家庭内LANに接続できていない問題を扱います。

●2.1. 有線LANでご利用の場合
物理的な原因:
・hsboxが動作するPCと家庭内LANが接続できていない。
 A)LANケーブルが抜けている、抜けかかっている。
 B)LANケーブルの接触不良。
 C)LANケーブルの種類を間違えている(クロスケーブルとストレートケーブルなど)。
ネットワークシステム的な要因:
 D)DHCPが起動していない。
 E)複数のDHCPが起動している。 

 
●2.2. WiFi環境でご利用の場合
  WiFiでネットワークに接続できていません。
初めてhsboxを利用される場合は、WiFiの設定が必要です。

●2.3. 一時的に赤色QRコードが表示される場合
起動の過程で一時的に赤色QRコードが表示されることがありますが、これはネットワーク関連の準備が完了する前に、インターネット接続確認を行ったことによるものです。十数秒で赤色QRコード場消える場合は問題ありません。
  通常運用中に赤色QRコードが一時的に表示される場合は、一時的にネットワーク接続が切れている可能性があります。頻繁に発生する場合は、ネットワークに問題がある可能性があります。ネットワークの管理者等にご相談ください。

■3.原因の確認、切り分け

●3.1.LANケーブル接続
LANケーブルのコネクタ部のLEDが点灯・点滅していなければ、A)~C)のいずれかが原因であることが濃厚です。

LANケーブルを抜き差しして、カチッと音がするところまで押し込んでください。
 それでも、LEDが点灯・点滅しない場合は、C)の可能性があります。そのほかのパターンとして「ネットワーク機器の電源が入っていないか故障している」、「LANケーブルが断線している」、も考えられます。

●3.2.WiFi接続
 始めて利用するWiFiの場合など、設定をしていないときは接続できません。一度設定済みの場合は、WiFiルータの設定が変わったなどが考えられます。
hsbox1.03.01以降は wifiコマンドなどで状況を確認できます。hsbox1.03.00.03以前はGUIモードに切り替えて確認してください。

 ●3.2.1. hsbox1.03.01以降

 URLの赤のQRコード

— hsbox cannot reach to the internet. —
ubuntu login:

と表示されたら、

ubuntu login:ubuntu

と入力後に「Enter」を押下し、Ubuntuにログインします。

ubuntu@ubuntu:~$

と表示されることを確認します。

ubuntu@ubuntu:~$ /home/hsbox/sh/wifi.sh 

と入力後に「Enter」を押下し、Wi-Fiの設定を確認します。

ubuntu@ubuntu:~$ /home/hsbox/sh/wifi.sh 
----------------------------
--- WiFi Setting       ---
----------------------------
Usage:
/home/hsbox/sh/wifi.sh <SSID>  <PASSWORD>
/home/hsbox/sh/wifi.sh <SSID>  DEL

WiFi Status:
DEVICE          TYPE      STATE     CONNECTION
enp1s0          ethernet  接続済み  有線接続 1
wlp2s0          wifi      切断済み  --
p2p-dev-wlp2s0  wifi-p2p  切断済み  --
lo              loopback  管理無し  --


Avarable SSID:
IN-USE  BSSID              SSID            MODE        
        FA:8F:CA:XX:XX:XX  --             インフラ    6     
        00:90:FE:XX:XX:XX  elecom2g-XXXX  インフラ    1    
        80:22:A7:XX:XX:XX  DE587XXXXXXXX  インフラ    1

日本語部分が文字化けして読めない場合は次のようにLANG=Cを前に追加して実行してください

ubuntu@ubuntu:~$ LANG=C  /home/hsbox/sh/wifi.sh 

 「WiFi Status:」の”TYPE”欄が wifiのものが、WiFi接続の状態です。 ”接続済み”になっていれば、WiFi接続できています。”切断済み”であれば、WiFi設定を行い接続しください。
「Avarable SSID:」に利用可能なWiFiのSSIDが表示されます。



●3.2.2. hsbox1.03.00.03以前
有線LAN環境と同じ手順で、起動します。

hssの Q&Aも参考にしてください。

起動にある程度時間がかかります。

左上に 「hsbox login:」と表示されるまで待ちます。

1.左上にhsboxの表示が出るまで待ちます
  プロンプトがhsboxになったら Ubuntuにログインします
  アカウント ubuntu パスワード なし

2. GUIモードに変更します
sudo systemctl isolate graphical.target

3.GUIモードが起動するのを待ちます。 ちょっと時間がかかります

 左下の「アプリケーション」を選択します(3x3の点のマーク)

4. 「設定」を選択します  (歯車のマーク 右側にあります)

5. 設定で WiFiを選択します。

6. 自分が使用するWiFiを選択し、 セキュリティパスワードを設定ます。
   WiFiで接続します。

7. 少し時間がたつと、 CUIモードに変わり、QRコードが表示されます。

8. QRコードか、表示されたURLにアクセスするとhsboxが使えるようになり、有線LANを接続して起動したのと同じ状態になります。

※この状態、WiFiだけの接続で、hsboxのライセンス登録ができること確認済みです

■4.対策

●4.1.LANケーブル接続
A)~B) LANケーブルを接続・抜き挿しし、LEDが点灯・点滅していることを確認して、hsboxを再起動してください。
C)LANケーブルを交換(ストレートケーブル)し、LEDが点灯・点滅していることを確認して、hsboxを再起動してください。

電源ボタンを押してシャットダウンするか、 3.2.2.および4.2.2記載の手順でシャットダウンして、hsboxを起動します。


●4.2.WiFi接続
 ●4.2.1. hsbox1.03.01以降の場合
①上記の手順で、WiFiコマンドを次のように実行します

ubuntu@ubuntu:~$ /home/hsbox/sh/wifi.sh (Wi-FiのSSID) (Wi-Fiのパスワード)

と入力後に「Enter」を押下し、Wi-Fiの設定を完了します。

②URL及びQRコード表示

①のWi-Fi設定後、hsboxトップメニューのURL及びQRコードが表示されます。

※URL及びQRコードが表示されない場合、

ubuntu@ubuntu:~$ sudo shutdown -h now

と入力後に「Enter」を押下し、シャットダウン、再起動してください。

●4.2.2. hsbox1.03.00.03以前の場合
  3.2.2.記載の手順で設定してください

■5.補足、解説

③hsboxトップメニュー表示

表示されているURLにアクセスまたはQRコードをスキャンすると、hsboxトップメニューが表示され、有線LAN接続時と同様に使用可能になります。

カテゴリー
お知らせ リリース 機能使用方法

hsbox1.1最終イメージリリースと今後の予定

2022年3月5日にhoscmは、hsbox1.1.4.1をリリースしました。hssのダウンロードページでhsbox1.1.4.1はUSBイメージを公開しております。

このバージョンのイメージをhsbox1.1系の最終公開イメージとする予定です。今後のhsbox1.1系はパッチモジュールのみを公開します。

本イメージモジュールでは、初回起動時にスマートディスプレイもしくはGoogleTVおよびGoogle TV機能搭載テレビにて下のYouTubeコンテンツを再生します。

hoscmのYouTubeチャンネルへのリンクも用意していますので登録をお願いします。 今後、同チャンネルにてhsboxの活用例や設定方法などの紹介動画を公開する予定です。また、YouTube向けコンテンツを作成していただける方を募集しております。参加希望の方はhssのお問い合わせフォームにてお問い合わせください。


今後の予定:

 hsboxがベースOSとして採用しているUbuntuの更新をおこないます。2022年4月に開発者向けにUbuntu21.10ベースのhsbox1.2をリリースする予定です。ベース更新の事前検証として各モジュールの開発に活用してください。このバージョンは開発者向けのため、一般向けにはリリースの予定はありません。

 その後、Ubuntu22ベースに更新したhsbox1.3の開発を行う予定です。hsbox1.3のリリーススケジュールは、2022年5月にアナウンスする予定です。

カテゴリー
システム 機能使用方法

設定を反映するために再起動が必要な設定項目

hsboxの設定項目には設定変更を反映するのにマシン再起動が必要な項目があります。

固定IP: 仮想サーバ機能を特定のIPでサービスする場合などに使用します。

ルーティング設定: 別のネットワークセグメントにあるスマートデバイスを制御する場合などで使用します。

カテゴリー
システム 機能使用方法

システム情報 ホスト名指定機能

hsbox1.01.03より、ホスト名を指定する機能を追加しました。

「システム情報」タブ → ホスト名変更で、指定します。

変更の反映には時間がかかります。

hsbox1.01.03よりでホスト名指定のデフォルトを”hsbox”に変更しています。上図のようにホスト名未設定の場合、ホスト名として”hsbox”を使用します。
 設定を削除する場合は、”DEL”とだけ入力して設定変更してください。

カテゴリー
システム 機能使用方法

hsboxスマホ向けコマンドボタン実行/生成ページ


下の画面は、降雨レーダの画像を特定のスマートディスプレイ(下の例ではChromecast Ultraをつないだテレビ)に表示するメニューボタンを作成した直後の表示です。

 ”操作対象”を選択し、”URL”に表示するjpeg画像、mp3、mp4のURLを入力します。つぎに”動作選択”で、テスト「実行」するか、ボタン「作成」するか選択します。この状態で下の「実行」ボタンを押すと、 テスト実行もしくはボタン生成することができます。
 なお、ボタン生成する場合は、”文面”に、ボタンに表示する文面を入力してください。
 「実行」すると、”操作対象”の入力枠の右側に選択されたスマートデバイス名を表示します。このスマートデバイス名は各スマートデバイ側で設定した名称を使用します。
選択肢の枠内に表示するスマートデバイスコードは、hsbox内で使用するコードです。自動探索の場合、探索ごとにスマートデバイスに紐付けられるコードが変わることがあります。※再探索にはついては設定ページの説明を参照してください。

※YouTube動画を再生する指定
 ”URL”には何も入力せず、”パラメータ”にYouTubeの パラメータ、 つまり「 https://www.youtube.com/watch?v=aNraec5iEBk 」というURLの場合、「aNraec5iEBk」の部分です。 この文字列を、”パラメータ”に入力して、 「実行」ボタンを押します。

※任意の文面をしゃべらせる指定
 ”URL”および”パラメータ”には何も入力せず、 ”文面”に、しゃべらせたい任意の文面を入力して、「実行」ボタンを押します。
 入力した文面を日本語として認識して、指定した操作対象のスマートデバイスで再生します。下は、サンプルの音声です。



カテゴリー
システム 機能使用方法

hsboxスマホ向け設定ページ

下の画面は、スマートデバイスの探索が完了した後の初期設定の表示です。

認証有無
 スマホ向けページの認証有無指定です。認証あり(ON)にするとスマホ向けページへのアクセスでログイン画面を表示します。この認証はPC向けページと共通です。一度ログインするとPC向けページとシームレスに遷移できます。
デフォルトは、「OFF」です。セキュリティ対策が必要な場合は「ON」にしてください。なお、本設定のON/OFFに関係なくPC用ページには認証が必要です。本設定が「OFF」でも、PC用ページで認証した後、スマホ向けページに遷移すると認証済み状態で利用できます。
※上はログイン認証済みの状態です。ログイン済みの場合「デバイス更新」ボタンを押せます。

QRコード表示
 hsboxが動作するマシンのコンソールにスマホ向けページのURLをQRコード表示します。この機能のON/OFFを指定します。

メニューバー表示
 PC用と共通のメニューバーの表示のON/OFFを指定します。メニューバーをOFFした場合は、オレンジ色のボタンに「PC用トップメニュー」ボタンを表示します。
下は、メニューバー表示をOFFにした場合の表示です。

再スキャン
 スマートデバイスを再探索します。スマートデバイスを追加したり、スマートデバイスに接続できないときに再スキャンしてください。
※DHCP等でスマートデバイスのIPアドレスが変わったときは再スキャンが必要となります。IPアドレス固定の設定を推奨します。

「デバイスリスト更新」ボタンは次の条件がすべて満たされるときに表示されます。
①デバイスリストを作成済みである
 デバイスイスト未作成や作成中の場合、ボタンが表示されません。未作成の場合、スマホ向けトップメニューボタンを押すとスマートデバイスを探索してデバイスリストを作成します。
 スマートデバイスの探索には数分時間がかかります。数分時間をおいて再表示してください。
②ログイン認証済みである
 PC用ページに遷移するなどしログイン認証したうえで「設定」ページに「■スマートフォン」→「設定」と遷移して戻ってください。
※ブラウザの「戻る」ボタンは、ログイン認証状態を維持しません。
③hsboxライセンス未適用である
 hsboxライセンス適用済みの場合は、PC用の「スマートサービス連携 → グループ設定」で設定してください。
※グループ設定ではスマートデバイスの「再探索」に加えてデバイスリストの編集が可能です。スマートデバイス探索では検出できないルータ越えのスマートデバイスも操作対象リストに入れることができます。

カテゴリー
システム 機能使用方法

hsboxスマホ向けトップページ

スマホ向けページは、スマホで簡単操作を実現するために提供するページ群です。スマホ向けトップメニュー、コマンドボタン実行/生成、設定のページがあります。以下は、スマホ向けのトップページです。

このページの初回アクセス時にスマートデバイスの探索を行います。この探索には数分時間がかかります。デバイスの探索が完了すると「操作対象」プルダウンメニューで選択可能となります。


下の画面は、「コマンドボタン」で2つのメニューボタン(青色のボタン)を作成した状態です。
上部のメニュータブ「システム情報」「ライセンス」「ステータス情報」はPC用と共通です。このメニュータブは非表示にすることができます。
 オレンジ色の各ボタンによりスマホ向けの「トップメニュー(このページ)」「コマンドボタン」実行/生成「設定」の各ページを遷移することができます。「ヘルプ」はhsboxサイトに遷移します。

メニューボタンを押すと、「コマンドボタン」で各ボタンに設定した機能を起動することができます。上の例では朝日新聞の「関東の雨雲の様子」で公開されている最新の降雨レーダー画像をスマートディスプレイに表示します。

 メニューボタンは、それぞれのボタンの右側の「x」をクリックすることで削除することができます。なお、「x」削除ボタンは、ログイン認証した状態でのみ表示します。

カテゴリー
機能使用方法

グループリスト、ターゲットリストの書き方

外部からのリクエストつまりboxapiで受け付けたコマンドをどのスマートデバイスで処理するかをしわ決定する仕組みです。

明示的にどのデバイスで処理するかをtgtパラメータで指定する方法もありますが、指定しない場合、デフォルトグループから処理可能なデバイスを選んで処理する仕組みです。
 グループは、複数設定することが可能で、これはGoogle Homeの部屋、グループに相当します。

■グループリスト

”グループ識別キー”には英数字のみ使えます
”グループ名”、”コメント”は2バイト文字も使用可能です

設定フォーマット:

<グループ識別キー>,<グループ名>, コメント

■ターゲットリスト

”グループ識別キー”は、グループリストの中のものを使用します。
”キャストタイプ”に使用できる文字は下の表を参照してください
下のフォーマットのように、2つの形式でターゲットを登録できます。

設定フォーマット:

<グループ識別キー>, <キャストタイプ> ,<ターゲット識別キー> , <IP>,- ,<ターゲット名> , コメント 固定IPか別ネットワークの場合
<グループ識別キー>, <キャストタイプ> , <ターゲット識別キー> , ー,MAC ,<ターゲット名> , コメント 同一ネットワーク内の浮動IPの場合

※ターゲット識別キーはグループ識別キーと完全一致する名称を使用しないこと、また重複しないこと *重複している場合は先に見つけたデバイスを使用します

●キャストタイプ

機器タイプ表記mp3
トーク
mp4jpegyoutube
Googlehome/miniaudio◎1
nest cast◎2
Chromecast UltracastTV

◎1 最優先
◎2次優先
〇可能
x対象外

カテゴリー
機能使用方法

メニューファイルの書き方

メニューの概要とメニューファイルアップロード、ダウンロードも参照してください。
設定のベースとなるファイルは、メニューファイルのページでダウンロードしてください。

参考;初期設定(テンプレート)の例:

000,-,該当メニューはありません,トップメニュー,メニュー,-
003,010,-,001: hsboxヘルプメニュー,メニュー,-
003,020,-,002: hsbox紹介メニュー,メニュー,-

上の例のように、メニューファイルは1メニュー1行で、カンマ区切り、6フィールドで表記しています。
・コメント行はなく、1から1000行目までが有効な設定です。行の位置が、メニュー番号に相当します。1行目が「メニュー 0」、1000行目が「メニュー 999」に相当します。

各フィールドの内容は次の通りです
・ 1列目: 数字3桁 コマンド番号 
・2列目: 可変コマンドパラメータ
・3列目: 拡張可変コマンドパラメータ
・4列目: メニュー表示用メッセージ
・5列目: コメント(説明用メッセージ)
・6列目: 予備、 拡張用(一部は音声応答メッセージに使用)

デフォルトで使用できるコマンドと設定方法は以下の通りです。※プログラミングして追加する方法は開発者サイトで扱います。開発者サイトへはhssから入ってください。
 

■0番台  メニュー用
000:表示用メニュー
P1:- なし
p2: 該当メニューはありません(応答メッセージ:メニューがない場合0行目のみ指定、その他はなし)
m1:メニュー 
m2:メニュー
m3:-

001:無設定 : 何も設定がない状態
P1:- なし
p2: – なし
m1:- 
m2:-
m3:-

003: リンクメニュー(基本は表示メニューと同じだが、リンク先のメニューを表示)
P1:010 リンク先のメニュー番号(3桁)
p2: – なし
m1:画面表示用メニュー 
m2:メニュー
m3:-

■2番台:音声制御関連
201:設定した文面の発話 (casts )
P1:発話 文面(可変文字 使用可能)
p2: – なし 言語 (ない場合は日本語で発音)
m1:xxxxxx/xxxx 
m2:-
m3:-

203: 指定URLの音声ファイルの、 再生 (cast mp3)
P1: URL
p2: – なし
m1: 指定URL の内容など メニュー表示文面 
m2:-
m3:-

■3番台: 動画、画像制御関連
301:hsbox内の画像表示 (cast image:jpeg) nest優先
P1: パス
p2: – なし (コンテントタイプ)
m1: 指定パス の内容など メニュー表示文面 
m2:-
m3:- ’TV’ といれた場合 TV優先

302:指定URL の画像表示 (cast image:jpeg) TV優先
P1: URL
p2: – なし (コンテントタイプ)
m1: 指定URL の内容など メニュー表示文面 
m2:-
m3:- ‘nest’ の場合は nest優先

303:指定URLの動画表示 ( cast image :mp4 ) TV優先
P1: URL
p2: – なし (コンテントタイプ)
m1: 指定URL の内容など メニュー表示文面 
m2:-
m3:- ‘nest’ の場合は nest優先

304:youtube パラメータ ( yt パラメータ ) TV優先
P1: パラメータ
p2: – なし
m1: 指定URL 先の内容など メニュー表示文面 
m2:-
m3:- ‘nest’ の場合は nest優先

■9番台: hsbox制御用
XX0:メニュー表示用
901:メニュー表示画像の更新
P1: メニュー表示画像の更新 します(応答メッセージ)
p2: –
m1:メニュー表示用の画像ファイルを再作成します
m2:Create menu image file.
m3:-

951:特殊コード(-4)呼び出し オプション設定 ユーザ指定
P1:指定なし
p2: 指定なし
m1:予約 特殊呼び出し(表示用メッセージ)
m2:指定なし
m3:全角4文字のオプション設定 ※特殊コード(-4)参照

991:デフォルトグループの指定
P1:グループ
p2: デフォルトグループをxxxに切り替えます(応答メッセージ)
m1:デフォルトのグループをxxxに切り替える
m2:チェンジグループ
m3:-

■特殊コード: 外部Webサービス等 連携用

ー3:メニューの検索呼び出し

w:検索キーワード   (キーワードが含まれる最初に一致したメニューを実行する)


ー4:スケジューラ連携 :音声プッシュ通知 、メニュー検索
w: スケジューラ設定文字列
m3オプション設定は”P●■×”固定 全角です
スケジューラ設定文字列の1文字目(マーク)とm3オプション設定を比較し動作を切り替える
 m3:1文字目: マークが無い場合の動作指定
P: 音声読み上げ
M:メニューの検索実行
X:なにもしない
2文字目:マークがこの文字なら音声読みあげ
    3文字目:マークがこの文字ならメニュー実行
4文字目:マークがこの文字なら何もしない


w:通知する音声メッセージ 

※本仕様は、順次追加更新します。
強化提案等も受け付けますので、hssの開発者サイトにて提案してください。