bladeRF-cli - 클라우드 온라인

프로그램:

이름

bladeRF-cli - 명령줄 인터페이스 및 테스트 유틸리티

개요

블레이드RF-cli

기술

XNUMXD덴탈의 블레이드RF-cli 유틸리티는 펌웨어 파일을 플래시하고, FPGA 비트스트림을 로드하고, 수행하는 데 사용됩니다.
nuand bladeRF 소프트웨어 정의 무선 시스템의 다른 작업.

펌웨어 파일 및 FPGA 비트스트림을 얻거나 구축하는 방법에 대한 자세한 내용은
방문 http://nuand.com/.

bladeRF 명령줄 인터페이스 및 테스트 유틸리티(1.3.1-0.2016.01~rc1-3)

옵션

-d, --장치
지정된 bladeRF 장치를 사용하십시오.

-f, --플래시 펌웨어
제공된 FX3 펌웨어 파일을 플래시에 씁니다.

-l, --로드-FPGA
제공된 FPGA 비트스트림을 로드합니다.

-L, --플래시 fpga
자동 로딩을 위해 제공된 FPGA 이미지를 플래시에 씁니다. 사용 -L X 또는 --플래시 fpga X
FPGA 자동 로딩을 비활성화합니다.

-p, --조사
장치를 검색하고 결과를 인쇄한 다음 종료합니다. XNUMX이 아닌 반환 상태는
사용 가능한 장치가 없으면 반환됩니다.

-e, --exec
지정된 대화형 모드 명령을 실행합니다. 다수의 -e 플래그는
지정된. 명령은 제공된 순서대로 실행됩니다.

-s, --스크립트
제공된 스크립트를 실행합니다.

-i, --인터렉티브
대화식 모드로 들어갑니다.

--lib-버전
libbladeRF 버전을 인쇄하고 종료합니다.

-v, --다변
libbladeRF 상세 수준을 설정합니다. 점점 더 자세한 수준으로 나열된 수준은 다음과 같습니다.

위험, 오류, 경고,
정보, 디버그, 상세 정보

--번역
CLI 버전을 인쇄하고 종료합니다.

-h, --도움
이 도움말 텍스트를 표시합니다.

--help-interactive
모든 대화형 명령에 대한 도움말 정보를 인쇄합니다.

배송 시 요청 사항:
XNUMXD덴탈의 -d 옵션은 장치 지정자 문자열을 사용합니다. bladerf_open() 설명서를 참조하십시오.
이 문자열의 형식에 대한 자세한 내용은

경우 -d 매개변수가 제공되지 않으면 사용 가능한 첫 번째 장치가 다음에 사용됩니다.
제공된 명령을 사용하거나 대화식 모드로 들어가기 전에 열립니다.

명령은 다음 순서로 실행됩니다.

명령줄 옵션, -e , 스크립트 명령, 대화식 모드 명령.

스크립트에서 또는 다음을 통해 'rx/tx start'를 실행할 때 -e, 이 명령이 나중에 있는지 확인하십시오.
프로그램이 종료를 시도하지 않도록 하기 위해 'rx/tx wait [timeout]'이 뒤따릅니다.
수신/전송이 완료되기 전에.

인터렉티브 명령

bladeRF-cli는 스크립트 가능한 대화형 모드를 지원합니다. 달리다 블레이드RF-cli --인터렉티브 에
이 모드를 입력하십시오. 유형 "도움" 모든 명령 목록을 보려면 "도움 " 이상
에 대한 정보 .

보정하다
용법: 보정 [옵션]

지정된 트랜시버 교정 작업을 수행합니다.

사용 가능한 작업:

· LMS 내부 DC 오프셋 자동 보정

· lms 보정 [show]

· lms 튜닝 [값] 보정

· lms txlpf [ ] 보정

· lms rxlpf [ ] 보정

· lms rxvga2 보정 [ ]

지정된 자동 보정을 수행하거나 제공되지 않은 경우 모두 수행합니다. 언제
값이 제공되면 자동 보정 결과 대신 사용됩니다.
절차. lms show를 사용하여 현재 LMS 보정 값을 읽고 인쇄합니다.

rxvga2의 경우 I1 및 Q1은 각각 1단계 I 및 Q 구성 요소이고 I2 및 Q2는
Stage 2 I 및 Q 구성 요소.

· RX 및 TX I/Q DC 오프셋 보정 매개변수 교정

· DC 보정 [ ]

· DC 보정

현재 주파수 및 게인에 대한 DC 오프셋 보정 매개변수를 보정합니다.
설정. I/Q 값이 제공되면 바로 적용됩니다. cal rxtx는
cal rx 다음에 cal tx가 오는 약어입니다.

· RX 및 TX I/Q 균형 수정 매개변수 교정

· iq 보정

지정된 IQ 게인 또는 위상 밸런스 매개변수를 설정합니다.

· RX 또는 TX I/Q DC 보정 매개변수 테이블 생성

· 테이블 dc 보정 [ [f_inc]]

I/Q 보정 매개변수 테이블을 생성하고 현재 작업 디렉토리에 씁니다.
라는 파일에서 _dc_ .tbl. f_min 및 f_max는 최소 및 최대 주파수입니다.
표에 포함하십시오. f_inc는 주파수 증분입니다.

기본적으로 테이블은 전체 주파수 범위에서 2MHz 단계로 생성됩니다.

선명한
용법: 명확한

화면을 지웁니다.

에코
사용법: echo [인수 1] [인수 2] ... [인수 n]

각 인수를 새 줄에 에코합니다.

삭제
용법: 지우다

지정된 지우기 블록 SPI 플래시를 지웁니다.

· - 블록 오프셋 지우기

· - 지울 지우기 블록 수

플래시백업
사용법: flash_backup ( | )

지정된 파일에 플래시 데이터를 백업합니다. 이 명령은 XNUMX개 또는 XNUMX개를 사용합니다.
인수. 두 인수 호출은 일반적으로 비개발 용도로 권장됩니다.

매개 변수 :

· - 백업 유형.

이렇게 하면 선택한 유형에 따라 적절한 주소 및 길이 값이 선택됩니다.

유효한 옵션은 다음과 같습니다.

옵션 설명
───────────────────────────────────────────────── ──────────────────
cal 교정 데이터
fw 펌웨어
fpga40 40kLE FPGA용 메타데이터 및 비트스트림
fpga115 115kLE FPGA용 메타데이터 및 비트스트림

· - 백업할 데이터의 주소. 소거 블록 정렬이어야 합니다.

· - 백업할 지역의 길이. 소거 블록 정렬이어야 합니다.

참고: 주소와 길이가 제공되면 이미지 유형은 기본적으로 raw로 설정됩니다.

예 :

· flash_backup cal.bin 칼

교정 데이터 영역을 백업합니다.

· flash_backup cal_raw.bin 0x30000 0x10000

보정 영역을 원시 데이터 이미지로 백업합니다.

flash_image
사용법: flash_image [출력 옵션]

플래시 이미지의 메타데이터를 인쇄하거나 새 플래시 이미지를 만듭니다. 이름을 제공하는 경우
플래시 이미지 파일의 유일한 인수로 이 명령은 메타데이터 내용을 인쇄합니다.
이미지의.

다음 옵션을 사용하여 새 플래시 이미지를 만들 수 있습니다.

· 데이터=

이미지에 저장할 데이터를 포함하는 파일입니다.

· 주소=

플래시 주소. 기본값은 유형 매개변수에 따라 다릅니다.

· 유형=

플래시 이미지의 유형. 기본적으로 원시입니다.

유효한 옵션은 다음과 같습니다.

옵션 설명
───────────────────────────────────────────────── ──────────────────
cal 교정 데이터
fw 펌웨어
fpga40 40kLE FPGA용 메타데이터 및 비트스트림
fpga115 115kLE FPGA용 메타데이터 및 비트스트림
원시 원시 데이터. 주소 및 길이 매개변수는 다음과 같아야 합니다.
이 유형이 선택된 경우 제공됩니다.

· 시리얼=

이미지에 저장할 일련 번호. 기본값은 XNUMX입니다.

flash_init_cal
사용법: flash_init_cal [ ]

새 교정 데이터 영역을 생성하고 현재 열려 있는 장치 또는
파일. 이 명령을 실행하기 전에 교정 데이터를 백업해야 합니다. (참조
flash_backup 명령.)

·

장치 모델에 따라 40 또는 115입니다.

·

VCTCXO/DAC 트림 값(0x0-0xffff)

·

교정 데이터를 쓸 파일입니다. 이 인수가 제공되면 데이터가 제공되지 않습니다.
장치의 플래시에 기록됩니다.

플래시_복원
사용법: flash_restore [ ]

파일에서 플래시 데이터를 복원하고 선택적으로 이미지 메타데이터의 값을 재정의합니다.

·

제공된 플래시 이미지 파일에 지정된 주소가 기본값입니다.

·

제공된 이미지 파일의 데이터 길이를 기본으로 합니다.

fw_log
사용법: fw_log [파일 이름]

장치의 펌웨어 로그 내용을 읽고 지정된 파일에 씁니다. 아니오인 경우
파일 이름이 지정되면 로그 내용이 stdout에 기록됩니다.

도움
사용법: 도움말 [ ]

모든 명령에 대해 이와 같은 확장된 도움말을 제공합니다.

정보
용법: 정보

열린 장치에 대한 다음 정보를 인쇄합니다.

· 일련번호

· VCTCXO DAC 교정 값

· FPGA 크기

· FPGA 로딩 여부

· USB 버스, 주소 및 속도

· 백엔드(사용 중인 장치 인터페이스 코드를 나타냅니다.)

· 인스턴스 번호

Jump_to_boot
사용법: jump_to_boot

플래시에서 FW 서명 단어를 지우고 FX3 부트로더로 이동합니다.

장치는 새 전원이 켜질 때까지 전원을 껐다 켜도 FX3 부트로더로 계속 부팅됩니다.
펌웨어가 장치에 기록됩니다.

하중
용법: 짐

FPGA 비트스트림을 로드하거나 FX3의 SPI 플래시를 프로그래밍합니다.

xb
용법: xb [매개변수]

확장 보드를 활성화하거나 구성합니다.

board_model에 유효한 값:

100

XB-100 GPIO 확장 보드

200

XB-200 LF/MF/HF/VHF 변환기 확장 보드

일반적인 하위 명령:

· 할 수있게하다

XB-100 또는 XB-200 확장 보드를 활성화합니다.

XB-200 하위 명령:

· 필터 [rx|tx] [50|144|222|custom|auto_1db|auto_3db]

XB-200 보드에서 지정된 RX 또는 TX 필터를 선택합니다. 아래는 에 대한 설명입니다.
각 필터 옵션.

50

50-54MHz(6미터 대역) 필터를 선택합니다.

144

144-148MHz(2미터 대역) 필터를 선택합니다.

222

222-225MHz(1.25미터 대역) 필터를 선택합니다. 현실적으로
이 필터 옵션은 실제로 약간 더 넓습니다.
206MHz - 235MHz.

· 관습

사용자 지정 필터 경로를 선택합니다. 사용자는 필터를 연결해야 합니다.
사용할 때 해당 FILT 및 FILT-ANT 연결을 따라
이 옵션. 또는 FILT 및 FILT-ANT를 점퍼할 수 있습니다.
수신을 위해 "필터 없음"을 달성하기 위한 연결. (그러나 이것은
전송에는 _매우_ 권장하지 않습니다.)

· auto_1db

빈도에 따라 위의 선택 항목 중 하나를 자동으로 선택합니다.
필터의 1dB 포인트. 사용자 지정 경로는 사례에 사용됩니다.
온보드 필터와 연결되지 않은

· auto_3db

빈도에 따라 위의 선택 항목 중 하나를 자동으로 선택합니다.
필터의 3dB 포인트. 사용자 지정 경로는 사례에 사용됩니다.
온보드 필터와 연결되지 않은

예 :

· xb 200 활성화

XB-200 트랜스버터 확장 보드를 활성화하고 구성합니다.

· xb 200 필터 rx 144

XB-144 변환기 확장 보드에서 148-200MHz 수신 필터를 선택합니다.

미모
사용법: mimo [마스터 | 노예]

장치 MIMO 작업을 수정합니다.

열 수
사용법: [장치 식별자] 열기

연속 명령과 함께 사용하기 위해 지정된 장치를 엽니다. 이전에 열었던 장치
폐쇄됩니다.

장치 식별자 문자열의 일반적인 형식은 다음과 같습니다.

:[장치= : ] [인스턴스= ] [직렬= ]

전체 장치 지정자는 libbladeRF의 bladerf_open() 설명서를 참조하십시오.
형식입니다.

몰래 엿보다
용법: 엿보기 [num_addresses]

peek 명령은 다음을 포함하는 FPGA에 매달려 있는 모든 장치를 읽을 수 있습니다.
LMS6002D 트랜시버, VCTCXO 트림 DAC 또는 Si5338 클록 생성기 칩.

num_addresses가 제공되면 주소가 1씩 증가하고 또 다른 엿보기가 수행됩니다.
많은 주소에 대해 수행됩니다.

유효한 주소 범위:

장치 주소 범위
────────────────────────
dac 0 ~ 255

lms 0 ~ 127
시 0 ~ 255

예:

· 픽 시 ...

찌름
용법: 찌르다

poke 명령은
LMS6002D 트랜시버, VCTCXO 트림 DAC 또는 Si5338 클록 생성기 칩.

유효한 주소 범위:

장치 주소 범위
────────────────────────
dac 0 ~ 255
lms 0 ~ 127
시 0 ~ 255

예:

· 찌르다 lms ...

인쇄
사용법: print [매개변수]

인쇄 명령은 인쇄할 매개변수를 사용합니다. 사용 가능한 매개변수는 다음과 같습니다. 만약에
매개변수가 지정되지 않으면 모든 매개변수가 인쇄됩니다.

매개 변수 설명
───────────────────────────────────────────────── ──────────────────────
대역폭 대역폭 설정
주파수 주파수 설정
gpio FX3 <-> FPGA GPIO 상태
루프백 루프백 설정
ln다시 RX LNA의 게인 설정(dB)
rx_mux FPGA RX FIFO 입력 mux 설정
rxvga1 RXVGA1의 게인 설정(dB)
rxvga2 RXVGA2의 게인 설정(dB)
txvga1 TXVGA1의 게인 설정(dB)
txvga2 TXVGA2의 게인 설정(dB)
샘플링 외부 또는 내부 샘플링 모드
샘플레이트 샘플레이트 설정
trimdac VCTCXO 트림 DAC 설정
vctcxo_tamer 현재 VCTCXO 테이머 모드.
xb_gpio 확장 보드 GPIO 값
xb_gpio_dir 확장 보드 GPIO 방향(1=출력, 0=입력)

탐침
사용법: 프로브[엄격]

연결된 bladeRF 장치를 검색하고 결과 목록을 인쇄합니다.

strict를 지정하지 않으면 사용 가능한 장치가 부족해도 오류로 간주되지 않습니다.

선택적 strict 인수가 제공되면 이 명령은 그렇지 않은 상황을 처리합니다.
장치가 오류로 발견되어 -e 명령을 통해 스크립트 또는 명령 목록이 제공됨
즉시 종료할 명령줄 인수입니다.

종료
사용법: 종료

CLI를 종료합니다.

복구
사용법: 복구 [ ]

부트로더 모드에서 실행 중인 장치에 펌웨어를 로드하거나 현재 부트로더 모드에 있는 모든 장치를 나열합니다.
부트로더 모드.

인수 없이 이 명령은 FX3 기반 장치의 USB 버스 및 주소를 나열합니다.
부트로더 모드에서 실행 중입니다.

펌웨어 파일에 대한 버스, 주소 및 경로가 제공되면 지정된 장치는
제공된 펌웨어를 로드하고 실행을 시작합니다.

대부분의 경우 장치의 RAM에 펌웨어를 성공적으로 로드한 후 사용자는 다음을 수행해야 합니다.
"열기" 명령으로 장치를 열고 다음을 통해 플래시에 펌웨어를 씁니다.
"로드 fx3 "

운영
용법: 실행

제공된 스크립트를 실행합니다.

rx
용법: rx

IQ 샘플을 수신하고 지정된 파일에 씁니다. 수신이 제어되고
다음 중 하나로 구성됩니다.

명령 설명
───────────────────────────────────────────────── ──────────────────────
샘플 접수 시작
중지 샘플 수신 중지
wait 샘플 전송이 완료될 때까지 기다리거나
지정된 시간 경과
config 샘플 수신을 구성합니다. 매개변수가 없는 경우
제공된 경우 현재 매개변수가 인쇄됩니다.

추가 명령 없이 rx를 실행하는 것은 rx config의 유효한 줄임말입니다.

대기 명령은 선택적 제한 시간 매개변수를 사용합니다. 이 매개변수의 기본 단위는
밀리초(ms). 타임아웃 단위는 ms 또는 s 접미사를 사용하여 지정할 수 있습니다. 이 경우
매개변수가 제공되지 않으면 명령은 수신이 완료될 때까지 기다리거나 Ctrl-C
가 눌려 있습니다.

구성 매개변수는 param=value 형식을 취하며 단일 또는
여러 rx 구성 호출. 다음은 사용 가능한 매개변수 목록입니다.

매개 변수 설명
───────────────────────────────────────────────── ──────────────────────
n 수신할 샘플 수. 0 = 이하
file 받은 샘플을 쓸 파일 이름
형식 출력 파일 형식. 다음 중 하나:
csv: SC16 Q11 샘플의 CSV
빈: 원시 SC16 Q11 DAC 샘플
샘플에서 사용할 버퍼당 샘플 수
비동기 스트림. 1024로 나눌 수 있어야 하며
>= 1024.
buffers 비동기식에서 사용할 샘플 버퍼의 수
개울. 최소값은 4입니다.
xfers 동시 전송 수
사용할 비동기 스트림입니다. 이 덜해야
버퍼 매개변수보다
시간 초과 데이터 스트림 시간 초과. 접미사가 없으면 기본
단위는 ms입니다. 기본값은 1000ms(1초)입니다.
유효한 접미사는 ms 및 s입니다.

예:

· rx 구성 파일=/tmp/data.bin 형식=bin n=10K

(10240 = 10 * 1024) 샘플을 수신하여 바이너리 DAC의 /tmp/data.bin에 씁니다.
형식입니다.

배송 시 요청 사항:

· n, 샘플, 버퍼 및 xfers 매개변수는 접미사 K, M 및 G를 지원합니다.
1024의 배수이다.

· rx 중지 다음에 rx 시작이 있으면 샘플 파일이 잘립니다. 만약에
이것은 바람직하지 않습니다. 다시 시작하기 전에 rx config를 실행하여 다른 파일을 설정하십시오.
rx 스트림.

· 더 높은 샘플 속도의 경우 이진 출력 형식을 사용하는 것이 좋습니다.
출력 파일을 RAM에 쓸 수 있습니다(예: / TMP, /dev/shm), 공간이 허용하는 경우. 더 큰 경우
더 높은 샘플 속도로 캡처하려면 HDD 대신 SSD를 사용하는 것이 좋습니다.

tx
용법: 텍사스

지정된 파일에서 IQ 샘플을 읽어 전송합니다. 전송이 제어되고
다음 중 하나로 구성됩니다.

명령 설명
───────────────────────────────────────────────── ──────────────────────
시작 샘플 전송 시작
중지 샘플 전송 중지
wait 샘플 전송이 완료될 때까지 기다리거나
지정된 시간 경과
config 샘플 전송을 구성합니다. 매개변수가 없는 경우
제공된 경우 현재 매개변수가 인쇄됩니다.

추가 명령 없이 tx를 실행하는 것은 tx config의 유효한 줄임말입니다.

대기 명령은 선택적 제한 시간 매개변수를 사용합니다. 이 매개변수의 기본 단위는
밀리초(ms). 타임아웃 단위는 ms 또는 s 접미사를 사용하여 지정할 수 있습니다. 이 경우
매개변수가 제공되지 않으면 명령은 전송이 완료될 때까지 기다리거나
Ctrl-C를 눌렀습니다.

구성 매개변수는 param=value 형식을 취하며 단일 또는
다중 tx 구성 호출. 다음은 사용 가능한 매개변수 목록입니다.

매개 변수 설명
───────────────────────────────────────────────── ──────────────────────
file 샘플을 읽을 파일 이름
형식 입력 파일 형식. 다음 중 하나:
csv: SC16 Q11 샘플의 CSV([-2048, 2047])
빈: 원시 SC16 Q11 DAC 샘플([-2048, 2047])
repeat 파일 내용이 반복되어야 하는 횟수
전송. 0은 중지될 때까지 반복을 의미합니다.
지연 사이에 지연할 마이크로초 수
파일 내용 재전송. 0은 지연이 없음을 의미합니다.
샘플에서 사용할 버퍼당 샘플 수
비동기 스트림. 1024로 나눌 수 있어야 하며
>= 1024.
buffers 비동기식에서 사용할 샘플 버퍼의 수
개울. 최소값은 4입니다.
xfers 동시 전송 수
사용할 비동기 스트림입니다. 이것은 <
버퍼 매개변수.
시간 초과 데이터 스트림 시간 초과. 접미사가 없으면 기본
단위는 ms입니다. 기본값은 1000ms(1초)입니다.
유효한 접미사는 'ms' 및 's'입니다.

예:

· tx 구성 파일=data.bin 형식=bin 반복=2 지연=250000

data.bin의 내용을 두 번 전송하고 사이에 ~250ms 지연
전송.

배송 시 요청 사항:

· n, 샘플, 버퍼 및 xfers 매개변수는 접미사 K, M 및 G를 지원합니다.
1024의 배수이다.

· 더 높은 샘플 속도의 경우 입력 파일을 RAM에 저장하는 것이 좋습니다(예: / TMP,
/dev/shm) 또는 HDD가 아닌 SSD에 있습니다.

· CSV 데이터를 제공할 때 이 명령은 먼저 데이터를 이진 형식으로 변환하고 저장합니다.
현재 작업 디렉토리의 파일에서. 이 과정에서 범위를 벗어난 값
클램핑됩니다.

· 바이너리 형식을 사용하는 경우, 사용자는 제공된 데이터를 보장할 책임이 있습니다.
값이 허용 범위 내에 있습니다. 이 전제 조건은 이에 대한 필요성을 완화합니다.
시간에 민감한 콜백에서 범위 검사를 수행하는 프로그램.

세트
용법: 세트

set 명령은 매개변수와 해당 특정 항목에 대한 임의 개수의 인수를 사용합니다.
매개변수. 매개변수는 다음 중 하나입니다.

매개 변수 설명
───────────────────────────────────────────────── ──────────────────────
대역폭 대역폭 설정
주파수 주파수 설정
gpio FX3 <-> FPGA GPIO 상태
루프백 루프백 설정. 모드를 나열하려면 'set loopback'을 실행하십시오.
ln다시 RX LNA의 게인 설정(dB). 값: 0, 3, 6
rxvga1 RXVGA1의 게인 설정(dB). 범위: [5, 30]
rx_mux FPGA RX FIFO 입력 먹스 모드. 옵션은 다음과 같습니다.
베이스밴드_LMS, 12BIT_COUNTER, 32BIT_COUNTER,
디지털 루프백
rxvga1 RXVGA1의 게인 설정(dB). 범위: [5, 30]
rxvga2 RXVGA2의 게인 설정(dB). 범위: [0, 30]
txvga1 TXVGA1의 게인 설정(dB)입니다. 범위: [-35, -4]
txvga2 TXVGA2의 게인 설정(dB)입니다. 범위: [0, 25]
샘플링 외부 또는 내부 샘플링 모드
samplerate 샘플 속도 설정
trimdac VCTCXO 트림 DAC 설정
vctcxo_tamer VCTCXO 테이머 모드. 옵션: 비활성화, 1PPS, 10MHz
xb_gpio 확장 보드 GPIO 값
xb_gpio_dir 확장 보드 GPIO 방향(1=출력, 0=입력)

버전
사용법: 버전

호스트 소프트웨어 및 현재 장치에 대한 버전 정보를 인쇄합니다.

사용 예

$ bladeRF-cli -l hostx40.rbf

hostx40.rbf라는 이름의 FPGA 이미지를 bladeRF의 FPGA에 로드합니다.

주의 사항: --load-fpga로 로드된 FPGA 이미지는 전원이 꺼지면 손실됩니다.

$ bladeRF-cli -f 펌웨어.img

bladeRF의 펌웨어에 firmware.img를 플래시합니다.

$ bladeRF-cli -L hostx40.rbf

hostx40.rbf라는 이름의 FPGA 이미지를 bladeRF에 플래시합니다.
전원을 켤 때 자동으로 로드됩니다.

onworks.net 서비스를 사용하여 온라인에서 bladeRF-cli 사용