PC ble ドライバーのダウンロード - PC ble ドライバーのソースコードのダウンロード

[非推奨]

このライブラリは現在保守されておらず、このライブラリの後継となる予定はありません。既存の nRF5 SDK ユーザーは引き続きアクセスできますが、それ以上のアップデートやサポートは受けられません。利用可能なファームウェア (.hex ファイル) は古い SoftDevice バイナリを使用しているため、このライブラリを使用して新しいプロジェクトを開始しないことをお勧めします。

PC-BLEドライバー

pc-ble-driver Bluetooth Low Energy nRF5 SoftDevice シリアル化用の C/C++ ライブラリを提供します。

概要
建築
サポートされている環境
- オペレーティング·システム
- ソフトデバイスとIC
デバイスドライバーのインストール
- ドライバーのインストール
- ドライバーの検証
ツールのインストール
依存関係のインストール
- Windows へのインストール
- Ubuntu Linux へのインストール
- macOS にインストールする
ソースからの pc-ble-driver のコンパイル
- Windows でコンパイルする
- Ubuntu Linux または macOS でのコンパイル
接続 HEX ファイルのコンパイル
- Windows でコンパイルする
- Ubuntu Linux または macOS でのコンパイル
プログラミング接続 HEX ファイル
例
既知の問題
ライセンス

概要

pc-ble-driver SoftDevice および接続ソフトウェアを実行する nRF5 接続チップとのシリアルポート通信を介してアプリケーションに SoftDevice 機能を提供する静的ライブラリと共有ライブラリのセットで構成されており、ここでは単一の .hex ファイルとして含まれています。 SoftDevice のシリアル化の詳細については、「シリアル化」を参照してください。

C/C++ ライブラリは直接インターフェイスできますが、制御の低下を犠牲にして開発を容易にする上位レベルのバインディングとしても提供されます (ほとんどの場合許容可能)。

pc-ble-driver-js Node.JS バインディング
pc-ble-driver-py Python バインディング

建築

ここで「アプリケーションチップ」は単なる一般的なハードウェア (つまり、Windows、Linux、または macOS デバイス) ですが、たとえば Arduino や Raspberry Pi などの場合もあります。

サポートされている環境

オペレーティング·システム

Windows 7、8、10、32 および 64 ビット (Windows 7 でテスト済み)
Ubuntu Linux LTS 64 ビット (Ubuntu 18.04 でテスト済み)
macOS 64 ビット (10.14 Mojave でテスト済み)

ソフトデバイスとIC

pc-ble-driver を使用するには、開発キットに正しいファームウェアが必要です。必要なファームウェアはhex/sd_api_vフォルダーにあり、 pc-ble-driverとの通信に必要な SoftDevice および接続ファームウェアが含まれています。

生成されたライブラリは、次の SoftDevice API バージョンおよび nRF5x IC と互換性があります。

SoftDevice s130 API バージョン 2: connectivity__1m_with_s130_2.xx (nRF51 および nRF52 シリーズ IC)
SoftDevice s132 API バージョン 3: connectivity__<1m|*usb>_with_s132_3.xx (nRF52 シリーズ IC のみ)
SoftDevice s132 API バージョン 5: connectivity__<1m|*usb>_with_s132_5.xx (nRF52 シリーズ IC のみ)
SoftDevice s132 API バージョン 6: connectivity__<1m|*usb>_with_s132_6.xx (nRF52 シリーズ IC のみ)
SoftDevice s140 API バージョン 6: connectivity__<1m|*usb>_with_s140_6.xx (nRF52 シリーズ IC のみ)

*usb) USBD ペリフェラルを備えた nRF52 シリーズ IC のみ

サポートされている開発キット

PCA	正式名称	品番	注意事項
PCA10028	nRF51開発キット	nRF6824
PCA10031	nRF51ドングル	nRF6825
PCA10040	nRF52開発キット	nRF6827
PCA10056	nRF52840 { 開発キット }	nRF6828	*)
PCA10059	nRF52840 { ドングル }	nRF6829	Nordic USB CDC シリアルポートをサポートする接続ファームウェアのみを使用できます

*) Nordic USB CDC シリアルポート版と SEGGER J-Link-OB (VCOM) 版の両方を使用できます。 PCA10056 で Nordic USB CDC シリアルポートバージョンを使用するには、ピン P0.18 と P0.24 を接続する必要があります。 QSPI チップへのピンも配置する必要があります (デフォルトで配置されています)。 PCA10056 か PCA10059 かを検出するアルゴリズムは、QSPI チップと通信できるかどうかを確認することです。 PCA10059 には QSPI チップがありません。この検出は、DFU モードとアプリケーションモードの間で変更するときにデバイスのリセットにどのピンを使用するかを決定するために、nRF Connect DFU トリガーによって使用されます。

デバイスドライバーのインストール

ドライバーのインストール

この通信ライブラリは、あらゆる種類のシリアルポート (UART) 上で動作しますが、最もよく使用されるのは Segger J-Link USB CDC UART 上です。必要な J-Link ドライバーをセットアップするには、オペレーティングシステムに一致するバージョンをダウンロードしてインストールするだけです。

セガー J-リンク

必要なドライバーをインストールし、J-Link 対応ボード (Nordic 開発キットなど) を接続すると、ポートが使用可能になります。

さらに、 pc-ble-driver使用してデバイスと通信するには、 Mass Storage Deviceを無効にする必要があります。 data corruption or drops issueを参照してください。

ドライバーの検証

Windows での検証

シリアルポートはCOMxxとして表示されます。デバイスマネージャーの「ポート (COM および LPT)」セクションを確認してください。

Ubuntu Linux での検証

シリアルポートは/dev/ttyACMxとして表示されます。

デフォルトでは、すべてのユーザーがポートにアクセスできるわけではありません。以下のコマンドを入力してユーザーをdialoutグループに追加し、シリアルポートへのアクセスを許可します。これを有効にするには再ログインが必要であることに注意してください。

    $ sudo usermod -a -G dialout < username >

modemmanager サービスが CDC ACM シリアルポートに接続しようとするのを防ぐには、次の手順を実行します。

    $ systemctl stop ModemManager.service
    $ systemctl disable ModemManager.service

macOS での検証

シリアルポートは/dev/tty.usbmodemXXXXとして表示されます。

既知の問題があります。問題が発生した場合は、ここで確認してください。

ツールのインストール

nRF5x コマンドラインツール

接続ファームウェアをプログラムするには、nRF5x コマンドラインツールにバンドルされているnrfjprogが必要です。これは次からダウンロードできます。

Windows 用の nRF5x コマンドラインツール
Linux 32 ビット用の nRF5x コマンドラインツール
Linux 64 ビット用の nRF5x コマンドラインツール
macOS 用の nRF5x コマンドラインツール

Linux および macOS のPATHにnrfjprogとmergehex追加します。

nRF コネクトプログラマ (オプション)

あるいは、 nRF Connect Programmer使用すると、UI サポートを備えた接続ファームウェアをプログラムできます。

nRF Connect Desktop をダウンロードし、そこにnRF Connect Programmerインストールします。

依存関係のインストール

pc-ble-driverコンパイルするには、次のツールが必要です。

AC/C++ ツールチェーン
Git (>=2.19)
CMake (>=3.11)
vcpkg

ソースから`pc-ble-driver`をコンパイルする

connectivity HEX ファイルをコンパイルするには、追加のツールが必要です。

チョコレートティ
忍者
Arm 用の GNU 組み込みツールチェーン
パイソン
ピップ
nrfutil

`connectivity` HEX ファイルのコンパイルに移動します

特定のプラットフォームに依存関係をインストールするには、次の手順に従います。

Windows への依存関係のインストール

Visual Studio 15以降のバージョンをダウンロードしてインストールします。

Chocolateyをインストールします。 cmd.exeでインストール (管理者として実行)

 # Copy everything below
@ " %SystemRoot%System32WindowsPowerShellv1.0powershell.exe " -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command " iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1')) " && SET " PATH=%PATH%;%ALLUSERSPROFILE%chocolateybin "

Chocolateyが上記のようにすでにインストールされているが、PATH に追加されていない場合は、次を実行します。

$ SET " PATH=%PATH%;%ALLUSERSPROFILE%chocolateybin "

Gitをインストールします。
```
$ choco install -y git
```
CMakeをインストールします。
```
$ choco install -y cmake
```
vcpkgをインストールします。
```
$ git clone https://github.com/Microsoft/vcpkg.git
$ cd vcpkg
$ git checkout tags/2020.04
$ . b ootstrap-vcpkg.bat
```
次に、vcpkg の場所をPATHに追加し、それをVCPKG_ROOT環境変数として設定します。

次の手順は、独自のconnectivity HEX ファイルをコンパイルする場合にのみ必要です。

ninjaをインストールします。
```
$ choco install -y ninja
```
GNU Embedded Toolchain for Armダウンロードしてインストールします
この場所からダウンロードします。
インストール手順に従ってください。
インストールパスを環境変数にGNUARMEMB_TOOLCHAIN_PATHとして設定します。例えば：
```
$ set GNUARMEMB_TOOLCHAIN_PATH=c: g ccarmemb
```

Pythonとpipインストールしてから、 nrfutilをインストールします

$ pip install nrfutil

# Reboot if installation succeeds but validation fails

Ubuntu Linux への依存関係のインストール

build-essentialをインストールします。
```
$ sudo apt-get -y install build-essential
```
Gitをインストールする
```
$ sudo apt-get -y install git
```
インストールされているGitのバージョンが必要なバージョンより低い場合は、次のようになります。
```
$ sudo add-apt-repository ppa:git-core/ppa
$ sudo apt update
$ sudo apt install git
```
CMakeをインストールします。
```
$ sudo apt-get -y install cmake
```
バージョンが必要なバージョンより低い場合は、ソースからCMakeインストールします。
vcpkgをインストールします。
```
$ git clone https://github.com/Microsoft/vcpkg.git
$ cd vcpkg
$ git checkout tags/2020.04
$ ./bootstrap-vcpkg.sh
```
次に、vcpkg の場所をPATHおよびVCPKG_ROOT環境変数に追加します。
Ninjaをインストールします。
```
$ sudo apt-get install ninja-build
```

次の手順は、独自のconnectivity HEX ファイルをコンパイルする場合にのみ必要です。

GNU Embedded Toolchain for Armをインストールします。
- ここからダウンロード
- 抽出する
- その場所を環境変数のGNUARMEMB_TOOLCHAIN_PATHとして設定します。

Pythonとpipインストールしてから、 nrfutilをインストールします。

$ pip install nrfutil

# Reboot if installation succeeds but validation fails
# If errors persist, try updating pip itself.

macOS への依存関係のインストール

Xcode (>=10.1)をインストールします。
HomeBrew を使用してgcc6インストールします。
```
$ brew install gcc6
```
HomeBrew を使用してCMakeインストールします。
```
$ brew install cmake
$ brew upgrade cmake
```
バージョンが必要なバージョンより低い場合は、ソースからCMakeインストールします。
vcpkgをインストールします。
```
$ git clone https://github.com/Microsoft/vcpkg/
$ cd vcpkg
$ git checkout tags/2020.04
$ ./bootstrap-vcpkg.sh
```
次に、vcpkg の場所をPATHおよびVCPKG_ROOT環境変数に追加します。

次の手順は、独自のconnectivity HEX ファイルをコンパイルする場合にのみ必要です。

GNU Embedded Toolchain for Armをインストールします。
- ここからダウンロード
- 抽出する
- その場所を環境変数のGNUARMEMB_TOOLCHAIN_PATHとして設定します。

Pythonとpipインストールしてから、 nrfutilをインストールします

$ pip install nrfutil

# Reboot if installation succeeds but validation fails

ソースからの pc-ble-driver のコンパイル

まだ依存関係をインストールしていない場合は、依存関係のインストールに進みます。

Windows での pc-ble-driver のコンパイル

vcpkg の依存関係をインストールします。

 # cd 

# Make sure %VCPKG_ROOT% is set and added to %PATH%
$ mkdir build && cd build
$ vcpkg install asio catch2 spdlog

CMake この記事に従って使用する Visual Studio コンパイラを選択します: コマンドラインで C/C++ コードをビルドする
```
$ cmake -G Ninja ..
```
コンパイル
```
$ cmake --build .
```
必要に応じて、 --configオプションを使用してビルド構成を選択します。通常、 Debug 、 Release 、 MinSizeRel 、およびRelWithDebInfoが使用可能です。例えば：
```
$ cmake --build . --config Debug
```

Ubuntu Linux または macOS での pc-ble-driver のコンパイル

vcpkg の依存関係をインストールします。

 # cd 

# Make sure $VCPKG_ROOT is set and added to $PATH
$ mkdir build && cd build
$ vcpkg install asio catch2 spdlog

CMake
```
$ cmake 
    -G Ninja 
    ..
```
必要に応じて、 -DCMAKE_BUILD_TYPEオプションを使用してビルド構成を選択します。通常、 Debug 、 Release 、 MinSizeRel 、およびRelWithDebInfoが使用可能です。
必要に応じて、 -DARCHオプションを使用してターゲットアーキテクチャ (32 ビットまたは 64 ビット) を選択します。値はx86_32 、 x86_64 、 x86_32,x86_64です。例えば：
```
$ cmake 
    -G Ninja 
    -DCMAKE_BUILD_TYPE=Debug 
    -DARCH=x86_32,x86_64 
    ..
```
コンパイル
```
$ cmake --build . 
```

接続 HEX ファイルのコンパイル

まだ依存関係をインストールしていない場合は、依存関係のインストールに進みます。

まだ実行していない場合は、ソースから`pc-ble-driver`をコンパイルします。

次の環境変数が設定されていることを確認してください。

VCPKG_ROOT
GNUARMEMB_TOOLCHAIN_PATH

次のパスが PATH に追加されていることを確認してください。

VCPKG_ROOT
mergehex

特定のプラットフォームに依存関係をインストールするには、次の手順に従います。

Windows での接続 HEX ファイルのコンパイル

環境を設定する

 # cd 
$ SET " PATH=%PATH%;%ALLUSERSPROFILE%chocolateybin "

# Make sure environment variables have been set
# as described at beginning of this section

CMake
```
$ mkdir build && cd build

# Modify -DCONNECTIVITY_VERSION=a.b.c
$ cmake -G Ninja -DCOMPILE_CONNECTIVITY=1 -DCONNECTIVITY_VERSION=1.0.0 ..
```
COMPILE_CONNECTIVITYを 1 に設定すると、接続ファームウェアのコンパイルが有効になります。
CONNECTIVITY_VERSIONコンパイルされた接続ファームウェアのバージョンを定義します。
Windows での pc-ble-driver のコンパイル時にその他のオプションを確認してください
コンパイル
```
$ cmake --build . --target compile_connectivity
```
HEX ファイルは、コンパイル後にhex/sd_api_vフォルダーで使用できます。これらには、SoftDevice と接続アプリケーションが含まれます。

Ubuntu Linux または macOS での接続 HEX ファイルのコンパイル

環境を設定する

 # cd 
$ export TMP=/tmp

# Make sure environment variables have been set
# as described at beginning of this section

CMake
```
$ mkdir build && cd build

# Modify -DCONNECTIVITY_VERSION=a.b.c
$ cmake 
    -G Ninja 
    -DCOMPILE_CONNECTIVITY=1 
    -DCONNECTIVITY_VERSION=1.0.0 
    ..
```
COMPILE_CONNECTIVITYを 1 に設定すると、接続ファームウェアのコンパイルが有効になります。
CONNECTIVITY_VERSIONコンパイルされた接続ファームウェアのバージョンを定義します。
Ubuntu Linux または macOS での pc-ble-driver のコンパイル時にその他のオプションを確認してください
コンパイル
```
$ cmake --build . --target compile_connectivity
```
HEX ファイルは、コンパイル後にhex/sd_api_vフォルダーで使用できます。これらには、SoftDevice と接続アプリケーションが含まれます。

プログラミング接続 HEX ファイル

SEGGER J-Link-OB ベースのキット

nRF5x コマンドラインツールがまだインストールされていない場合は、ツールのインストールに進みます。

このライブラリを使用するには、nRF5x IC 上の接続ファームウェアをプログラムする必要があります。

nRF5x コマンドラインツールを使用して IC を消去およびプログラムします。

 $ nrfjprog -f NRF5 -e
$ nrfjprog -f NRF5 --program hex/sd_api_v/connectivity___with_s_...hex

あるいは、nRF Connect Programmer を使用して IC を消去およびプログラムします。

 nrfutil dfu usb-serial -pkg connectivity_x.x.x_usb_with_s_.._dfu_pkg.zip -p

プルリクエストを受け入れるには、コントリビューターライセンス契約 (CLA) に署名する必要があります。最初のプルリクエストを送信した後、これを行う手順が表示されます。

フィードバック

バグを見つけた場合、または一般的に質問やその他のフィードバックがある場合は、Nordic DevZone ポータルに投稿してください。バグレポートには、バグを再現する方法を十分に詳細に説明する必要があることに注意してください。

ライセンス

詳細については、ライセンスファイルを参照してください。

拡大する

PC ブルドライバー

[非推奨]