PiHPSDR Controller Users Guide Pi HPSDR V1.1.3
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 91
- 1. Introduction 5
- 2. Controller connection requirements 6
- 3. Front panel controls 8
- 4. Front Panel Display 9
- 5. Side panel connections 10
- 6. Quick Start Instructions 11
- 7. Discovery Menu 12
- 8. Main Menu 14
- 9. On-Screen Controls and toolbar Buttons 34
- 10. Tuning 56
- 11. TUNE/SWR/FWD Power 56
- 12. Appendix 57
- 13. Reference materials 60
- 14. Steve Wilson KA6S special addition for Fldigi 61
- 15. Supported CAT Commands 69
- 16. Apache Support 74
- 17. Apache Service and Repair 74
- Early prototypes by John Melton G0ORX (circa: 2015) 75
- 1. Introduction
- 2. Controller connection requirements
- Network LAN Connection
- Controller Hardware requirements
- Controller software requirements:
- 3. Front panel controls
- Default assignments of switches and rotary encoders
- Power ON/OFF – switches external 12vdc 2A power to the Controller
- TUN – MOX/TUNE
- S1 – Band
- S2 – Band Stack
- S3 – Mode
- S4 – Filter
- S5 – Noise Blanker
- S6 – AGC
- FN – Function switch to toggle 8 on screen touch buttons such as TUNE or MOX
- E1 – push encoder knob for selection from Encoder Assignment menu of 11 functions
- E2 – push encoder knob for selection from Encoder Assignment menu of 11 functions
- E3 – push encoder knob for selection from Encoder Assignment menu of 11 functions
- E4 – VFO – main tuning knob
- 4. Front Panel Display
- 5. Side panel connections
- 6. Quick Start Instructions
- Hardware Setup
- Software Setup
- 7. Discovery Menu
- Discover Ethernet Connections to RPi
- Pihpsdr program START button
- 8. Main Menu
- Menu → Exit piHPSDR
- E1, E2, E3 Click-Set Assignments
- Menu → Radio
- Menu → Rx
- Note that if one receiver’s audio is set to output to the plughw device the other receiver cannot be connected to the dmix device for that audio output.
- Menu → Rx (continued)
- Menu → TX with USB Input Source
- Menu → TX Transceiver MIC input
- Menu → PA Gain by Band
- Menu → CW
- Weight – sets the dot/dash weighting.
- Menu → ANT
- Menu → DSP
- Menu → OC Open Collector Aux I/O connectors
- Menu → Display
- Menu → Display (continued)
- Menu → XVTR
- Menu → Equalizers
- Menu → Step
- Menu → Meter
- Menu → VOX
- 9. On-Screen Controls and toolbar Buttons
- Touch Direct Frequency Entry
- Toolbar – Function button
- There are eight (8) switches on the pihpsdr Controller. Switches S1 through S6 change function as you push the FN key
- Four Toolbar menus – select with Function button or front panel switch
- Toolbar – MOX
- Toolbar – Band selection
- Toolbar – Bandstack for each VFO selected
- Toolbar – Mode
- Toolbar – Filter
- Toolbar – NOISE
- Toolbar – AGC
- AGC default value is Medium
- Toolbar – Function button
- Toolbar VFO Lock
- Toolbar CTUN – Click Tuning
- Toolbar A>B A<B A<>B
- Toolbar SPLIT
- Toolbar FREQ
- Toolbar MEM
- Toolbar RIT
- RIT – Receiver Incremental Tuning
- Tapping the RIT OFF/ON enables or disables Receiver Incremental Tuning
- Tapping on the RIT+ (plus) or RIT- (minus) button will
- Tapping the RIT OFF or ON toggles the RIT function
- Tapping RIT CL = RIT CLEAR
- Note: RIT offset shown in YELLOW TEXT below VFO-A
- Toolbar → TUNE
- Note: the FWD power and SWR measurements are indicated in the upper right
- AF Gain Slider
- MIC Gain Slider
- PA Drive Slider
- Tune Drive Slider
- AGC Gain Slider
- Receive Attenuation Slider
- Main screen HIDE
- Menu or Toolbar → Meter
- 10. Tuning
- VFO Encoder
- Touch Screen
- Mouse
- 11. TUNE/SWR/FWD Power
- 12. Appendix
- Encoders and Switches
- Encoders and Switches (continued)
- Switch or Encoder
- E1 E2 E3 click set 11 assignments
- GPIO pin Assignments (RaspberryPi)
- 13. Reference materials
- G0ORX Friedrichshaven pdf and video
- 14. Steve Wilson KA6S special addition for Fldigi
- Using PiHPSDR with other applications:
- Mapping a Serial Port to TCP/IP port in Linux
- Example: Set up GRIG to talk to PiHPSDR
- Example: Connect FLDIGI to PiHPSDR
- Also – check the PTT via CAT button in the lower left corner.
- Now Choose Config/Setup/TCPIP
- Setting up rigctld
- Multi-Client Support
- Running applications with the latest version of Hamlib
- KA6S Summary
- 15. Supported CAT Commands
- 6. Quick Start Instructions
- 5. Side panel connections
!
by
John Melton GØORX/N6LYT
This document contains references to the Apache Labs Transceiver products
http://www.apache-labs.com
"#$%&'()$'*+*'%+,'%&
!,!#!-#.
/00!1
21!2 - !!#2-#
!3
pihpsdr showing two receivers (20M USB + WWV) + waterfalls + on screen sliders + menu toolbar
TWO
RECEIVER
Version
-Classification: General Business
!
"! 456),70(&89+
(#:(&
!#; 2&
-#; 2/<
- 12-#!4!=
#,(0,>>?#@3!3#=
9(?6,709(A=
?B!=
3?B!:=
C?6!=
D?>=
+?(B:=
&?=
>(?> #11= 9(A6,7 =
A? !:--2A!122 -
- =
A3? !:--2A!122 -
- =
AC? !:--2A!122 -
- =
AD?$>,?2 1:=
!
"#
!#
-#
$%&
A3
!1299 C
&&
6 EA@+
A'A3'AC:12&
6 E!<
6 E@=
6 E@ !F
6 E97#B" 3
6 E9796" 3
6 E4B!33
6 E*3C
*1?!0!#113C
6 E(93D
3 !3
-Classification: General Business
6 E3+
6 E,, @"0,3&
6 E43<
6 E4 !3=
6 E7$93F
6 EA; GC
6 EC
6 E6C3
6 E$,7CC
'( )*
9 >; 4A4C+
9?> C&
91=#!# 1&
1- 4 >(:4C&
> 92 ?#> -#C&
9?6,7C<
9?B!C<
9?B!:-$>,!C=
9?6!CF
9?>CF
9?(,"AD
9?D
!- 6! 2D
9?> D
9$>,:D3
99(?:9 1DC
9HBIBIHBDD
9"9D+
9>AJD&
96A6D<
9"9D=
"9?"29 1D=
91"9,>>0,(!"29 1D=
91"9K "92 #D=
91"9,>>,(11"9- D=
91"9L"9AD=
(/"9M#8A,*9A79#$>,D=
9E9(ADF
(/>*#!*2 2!! 1
DF
>!+
6"!+
!+3
9 !+3
!+C
!+C
6"A+D
6 9E6++
!+,
C !3
-Classification: General Business
$>,A!+&
9 +&
6 +&
+-./0 12013
9(A0*0>*#+&
45 $
A!!#+<
A!!# !+=
#A!+=
AA3AC:12+F
",124&
26!
,7>!!-!!&
%174 6,
1#/&
6190" @&
A@2/ ":&3
A@2/>""&3
?:999 #-&C
(#N10 09"&D
1 1!&+
6 &+
1#-2&<
%& 224&=
4+
48 $
" <D
8 <D
, <D
$48 %2$
/)98&:!'2;<=!>$
D !3
-Classification: General Business
)98&:?'2;0.@A+
Thu Aug 5, 2016 12:52 am (PDT) .
Posted by: "John Melton" g0orx
":2#2-;
2:1 !
"!4# !9 1! !2
!!'##12!'-; 4!2
9!-#41 !12
*" !"!:1#42!32 !!
!"!!4!* @!1!1$4
-"!
2-23("'%.%:1-24!!!# ! 4
#!4 !!42# "!2 244
!2#:4!!.11!4
9!# !110!14-# !21
! !#242%.1 !442
12! 2#4#2!C
1!.!#! !4#
20- 4##24222-2
'##!49-#!2!#- 1
!!!# 11N@!"!1! #!'2
9!4 ! ! ! " 4
!4 24 #! 1B !
!!"#!!1 -12#
9##:*> 1 91; 4#!2#
2# 9!1A!4! 1
#A' ##: 1#*>#'!
1B1A!1!!#:5 22# 1
2
":!2#- 1!2 ' #4"
2#22-",'# !- !
!
* 14O< 9 -=@D=#
111#
9#:1 24"9#;
1!!4 19
#2 !! 2-2##:1!"
!241!C. - #1!1-!1
>4'-# "# 4# 0!
"# @42!" !! 16,7"
! !*!#"!*!#42
51@0&4
Note: This Note: this document assumes familiarity with the Apache Transceiver and
standard software such as PowerSDR or Thetis. The Apache Transceiver Users Guides are
located here: https://apache-labs.com/al-downloads/1001/ANAN-USER-GUIDES.html
+ !3
-Classification: General Business
.3#@4.
1-4B9A#-
D='F&'!F3%2
9#!!44 ((9! #
2: -"12-"!!
9+9&!!22!!-(
B3
C=!3+22 23!3#
B9(4 9
(/# 1! -!'4 24!:
!(4CB2!- -2 2#
1!-!4
::/
/00###2!242010#:4
/00###2D2022 4022 404
04P.0103&0C0C04C1:!
/00###2G20!!4: 2 2
:0!0BJ9"D0-L!PPD<PPP3Q
P!1L9>=RLR-"L&D(F6*++8FC+$3&
& !3
9
"
; !
9
2(#:
B9
1
#
-Classification: General Business
-#; 2/
!,142!12-4!
!
"-4 !%"9'4 #!!
!#4142!!
" -"--#!!"!-! 2
/
/001 201@0!0#0200! 20!!-
"-4 #1-! !'@ '!
! 2 /
/001 201@0!0#0200! 20! !!-
.=1!!2:: -4 ,142!-#
46 EE! 4#!-2
41
94! 1B?!!0#!1 11!-B
-!-
4682),
)
< !3
-Classification: General Business
6,638
3,(0,>>?#@3!3#
+-.?6,709(A
?B!
?B!:
?6!
?>
?(B:
?
.?> #11= 9(A6,7
/? !:--2A!122 --
/? !:--2A!122 --
/? !:--2A!122 --
/?$>,?2 1:
.=451+#'A!'!9
!
./-4 1 !4'4 24#!-2
4 - @428 $(
2 0:4!-4
= !3
38
/
-Classification: General Business
F !3
VFO-B Receiver Rx1
VFO-A Receiver Rx0
Status Lines above and below VFO frequency
Meter displays S-Meter and ALC displays
Main MENU on screen control
1
2
1 2
3
3
4
4
5
5
Panadapter display Rx0
6
6
7Waterfall Rx0
7
8
8
Panadapter display Rx1
8
9
9
6 Slider controls
10 Function Menu
activation
10
-Classification: General Business
!3
B
B
3!
#
(
-Classification: General Business
"#
--!:
B3
- 4 :
4+0/8)#(.:#
4 9'1#' (#:(
1F
!#6%4C=!
2 !# 4
48+%&C7/ACB8
63
9-#-2!,142!!
4
-#N1 !!4
-2#14224#2!-4 !
-! 1 @-1
(/!, "-4 # !:212 @42'
''!! 2!
/001 201@0!00200! 2
!3
-Classification: General Business
$%&
%/82
*N!'#4!2!
#:"#:-! 11!!#A#
6+%6683)D)8
%C-#'"!!!6!!-!
"-!- !4 !:4#!!#:
!91,%#4!4191
#@:4!:
9##!!!-4
2 "-' #!!!@!#
)9222 -2 4!
1!!!!- !-1!"!!'!
"!!2
3 !3
-Classification: General Business
!1299
+,8 )38E8/8
6
"@24 )81!/8!
#!!4
!14 *(!( '##:##!
6#:; 2*88248+%)
8)
N1 -:' !- #1$
C !3
-Classification: General Business
&&
91&)1 2 !1
8 2 416 416
1
!?1&
7?1<
97?1F
?13
*?133
?13C
?13D
,?13+
4?13&
7$9?13=
A; G?13F
?1C
6?1C
$,7?1C3
D !3
-Classification: General Business
&F/5B 2
9A@ #1 !1#14 !
2-#4/
E!1@
/5?@:4:
2)?4
83? !#4# 2
1!
8 6 1A@6 !1 6
+ !3
-Classification: General Business
/C/C/#( 4,
:12
& !3
G'
-Classification: General Business
&F2
" 6 E2,8.3
2%(11!3
2+ H?9 2G-"9!2
# 1
G'/%-4+
+' -&!LD:G0
1A!C#$>,A! 13:G0
1A!<!$>,A! 1F:G0
9 #6 E!# 1,<- *>
< !3
-Classification: General Business
&F25
<%%,>
18884.44+/28,8G'82;
8,625!25
292#!-!!4!
9#8 !!
-&6G 2!-29
(/,14!-!2-'#
6 E!
S(#ATB!! 2'#
6 E@
"-4 9 !!3<N2#'4 1
2-!!49- -S(#AT
N2#"!!222!> 4
3<!-#
.=$#7%)2
8 - -91933=1
1!-#N!!9
2!2 - -91933=
11!-#N!!9
@4'?9 2!N ! !
1G#
B4!- ! -2:!-
!!
= !3
-Classification: General Business
8 ! ! 4
B! !!
9 !!:@4':@9
#!!!!
,83=!C!)4@ 44 !
,83=!C)4@ 44 6"-
,83=!- *4'/B! !!
,4 2!!!!' !
42 !2@2 2 1!
5=42I4@ 4C/GI!2@-,83=!C!)4@ 4
5=42I4@ 4C/GI2@-,83=!C)4@ 4
5=42I'/C/GI!2@-,83=!- *4'/
C@6C2,8C&38%
"-4 25!-' -2#2@!
!!8 '-
1 !9# !#
-!0:!1!0:
9&38%#!#2 !#4
!
.86%J8,83%88
%)85%68
F !3
-Classification: General Business
&F25<>
" !! 2##A
(/,14!-!2-'#
6 E!
S(#ATB!! 2'#
6 E@
3 !3
-Classification: General Business
&F+;38- *
@&8? !- !!6"#
B
>! !#-; -92!#!
!,A#@B !.-+!!
>697A224; !-2; 422 4>6
4 1
3 !3
-Classification: General Business
&F+;+%&
*6" :!'972 1 #
4 49
33 !3
-Classification: General Business
&F4:)*
1-!4!. 1!9!. 2#4
9-2@2 2!92
1!9!. 2-
2@2 2! >2N
/9 !-# -1#099
!N19(A,*A6@2 2!, #!. 1
1,4 !!!. -#
#?-@2#!12N
(=+6)?2 !-2!- !!
3C !3
-Classification: General Business
&F1
N2#*%4
1 *6?!-!0!1#6!6!B
1*#?#!!422!#1
17/A/2 +24:B+?:4!#1:4
17/A/2&'/4?!!:4 16!
17/A/2&'/*?!!:4 16!B
7%?#!!0!!!!
@%? !-!!, -
9
?-; 4-!!, -
9
1,8?!0!#11
3D !3
-Classification: General Business
&F4.+
92 # !-!2!
96 #!M!!1N96!9
# - C!929A79
!A793((0B003
3+ !3
-Classification: General Business
&F
9--
4:B,+88?19!-
.20.204.?#1! -
-2!09!- !1
?-2!
?-2!
.2:&8?2! !-119!-
22
! '2 !
1 ! '12 !
2222!
.2./&8?(#A22!9!- ,6
,6,22162 2
66A62 26; A
.24/A-2- !
3& !3
-Classification: General Business
&F''450'
9 N1 , -!-92!
9 !@! !N@
2N!9!- !
- !-!!2- 1,>A9
*@9 !9 !19
- 9!- S!T
+?N1 , !#9@!
- !-#1,
+?N2,!#9 1
&+?:4!#2-9(A# 1@ 2
9
3< !3
-Classification: General Business
&F
?#!!1#N!*!
#!#- !
?!-!!*-
B,86@2 21!4!!
(/# !! 2 -A'A3'ACA!- 12
@3?62 21!4!!
(/# !! 2 -A'A3'ACA!- 12
164?*!*-1!*-#!. !
24
16B,8?6 2@2 21 !#-
16@3E6 22 21 !#-
3= !3
-Classification: General Business
&F<>
3F !3
-Classification: General Business
?:'-'12-!!4
4%,,?2!-11!!4
?#!!!4!2
16?#!*-!4!4!2
?#!!!4!2
C !3
-Classification: General Business
&F;G+2
N1 =
+?2B!'!,2
&?922 2-; 4G
&5?92@2 2-; 4G
@'?9,-; 4G
)4?*:!'9#2N#!!2
(-; 4! !!-; 42 ,-; 4"
@2DD6GD&6G9-; 4# !3=6GC6G
!
*29N1 !4#!!1!
(92 !2
C !3
-Classification: General Business
&F/H
C!1H22!-)8+2%/
@3?DG!!B
&?D+G!!B
B,8?+&G!!B
9! +;/H!2;/H# !4!
9; G!4:@/)+;/H/)25/H
C3 !3
-Classification: General Business
&F
2-G'+,9 $>,ADA!'!6
*
CC !3
-Classification: General Business
&F&
6:!1
:1"(
6 1!-!4
8 !!. 4 6!B!!@!G
:
CD !3
-Classification: General Business
&FG';
11!@!&8@%4 :!. 9!!1
+88-$,7
B,-#1!$,7##!#:1
C+ !3
-Classification: General Business
'( )*
9 -G'(4@
9 -G'(*@
C& !3
-Classification: General Business
C< !3
-Classification: General Business
C= !3
-Classification: General Business
CF !3
-Classification: General Business
D !3
-Classification: General Business
.=,,,8,38D,8,G'6
D !3
-Classification: General Business
+8/
9 6 $>,$>,B!11 >; 4A42
@2 DC3%UDC32GLDC36G36
.=868G'
2+ "29 1
G' >; 412-$>,A!
D3 !3
-Classification: General Business
+)E)
91=#!# 1&1-
4 >(:4
9- 4 D- !!
+)E38)638
DC !3
,
>
B
4
>
S>(TB
-Classification: General Business
+)E&';
+)E*
DD !3
-Classification: General Business
+)E*#68G'
D+ !3
-Classification: General Business
+)E&
+)E
D& !3
-Classification: General Business
+)E.' /
+)E4:
!- 6! 2
D< !3
-Classification: General Business
+)E)
9- 4 - -2
- !!
> > 92 ?#> -#
(/D> 6 # !> 92!6292-2,6
-
D= !3
-Classification: General Business
+)G'@#
9$>,:!41 >!41
-!-$>,!49 :>! 1
-!-$>,!4
*$>,:!'!@#@#!4!$>,
DF !3
-Classification: General Business
+)+-.E#+,
.=83D+36+-./8
)A3
919( #!: 1- *
- !9( @##4#
*9(!' 1!! 4!4!9 !
-; 4!N2#1 !!4# 21
!#--1
+ !3
-Classification: General Business
+)4K*4L*4LK*
9#4 4$>,-; 4/
G'(4G'(*<4K*>
G'(*G'(4<4L*>
G'(4338G'(*<4LK*>
+ !3
-Classification: General Business
+) @+
9- #4 $>,-!$>,B-929
#2$>,B922##:1
'7'!
+3 !3
-Classification: General Business
+)2/"
6 1 !4!4N1$>,4
#1'! 1-; 4:G2G9 #
-<33=BD6
2+2G-"9K!"9#1D=
G'2G-$>,%AD6 *
+C !3
-Classification: General Business
+)&/&
1!-N--;
+D !3
-Classification: General Business
+)2+
2+E2%+,
91"9,>>0,(!"29 1
91"9K "92 #
91"9,>>,(11"9-
91"9L"9A
.=2+M83A/@@'1+/;+)3G'(4
++ !3
-Classification: General Business
+)F+-./
99(A91; ::411*!19(A#
.=813 128,8
#*>#!#!</*
+& !3
-Classification: General Business
91!-- !!-
,> 9 !6249 22
+< !3
-Classification: General Business
4:
>!!4! 1> :4-# -A!A
&:
6"!!4! 1> :4-# -A!A
+= !3
-Classification: General Business
4%
!!4! 1> :4-# -A!A
+%
9(A!!4! 1> :4-# -A!A3
+F !3
-Classification: General Business
4::
!! 1> %4!1AC
2%4
!! 1> %4!1AC
& !3
-Classification: General Business
&B/
9 -"A22G!#!#!
!44142!!4
>!1
& !3
-Classification: General Business
&+)F&
916#!4-- !12
&3 !3
-Classification: General Business
!+,
G'/
9$>,!: ! !B4 1!:#!
:#-; 4#2!242 -
96 N! -!
+8
9 1!!111!#-#2-; 4 !#(
#22
91-; 4!#-#2-; 4
&
-!#!!1!111#!#-#2-; 4
!#
-:1#2!-; 4
61##2!2-; 44
+-./0 12013
+-./0 12013
*> !'119(A06,7 -->*#
!*!-!#!#
&C !3
-Classification: General Business
45
/ 38
>4#0A!09
38/ +8 ",
",
B
#,(0,>> #0M #0M
9(?9(A 1#
9 #!
1#9
#!
3<
6,7?6,7 11-99
6,7
11-99
6,7 3<
?B! >B!K
1K**$K>K
7$9
>B!K1
K**$K>K7$9 C
3?B!: > !-; > !-;
3
C?6! BBB**
>6(66>$%
BBB**>6(6
6>$%
&
D?> ">>#! ">>#! +
+?( +(! 2! +(! 2! 3D
&? +41 +41 3C
&D !3
-Classification: General Business
38/ +8 ",
",
B
>(?> > #11
9(A6,7
!4!2
--
> #119(A
6,7!-A'A3'AC
:
33
A1 1 3 3&
A3?1 1
& F
AC?1 1 D 3
AD?$>,6 1
: < =
/ 38<>
38/ +8 :'
4
:'
*
6 66 C
6 EB! !
6 EB!:
C+; :-;
1
C+; :-;
1 3
6 E6! 6! 6! &
6 E> ">>#! ">>*! +
6 E( (B:2! (B:6! 3D
6 E 2 2 D 3
:! 1:$>,>; 4
11>; 4:
9 $>,>; 4
11>; 4:
6 1:6- 9 6-6
&+ !3
-Classification: General Business
38/ +8 :'
4
:'
*
6!:01 !:01
///#,
A'A3'AC:
V",- 12
&& !3
-Classification: General Business
:'4,<2)>
(/8 24#%86+,8G'A!9"",
#99-!#@4>@2'$>,!-
9("(41!4#1",-2<='!",B-2=<
26
,7>!!-!!
>!-3&
/00###!@200-+!+2FCFC;0&!B6$%AF+5+"Q
!L
53A-2#-!
%.%3("-242
*3,2#/00# 3!4!10# 3PPD2
BG%F72#! 2
>W-!8 9 /
/00###4 20#QL<J-3=8.#
, !1$!-2>X-3&#%$A!1/00!10!
&< !3
-Classification: General Business
%174 6,
-,B 2388=
PiHPSDR emulates several commands available in the CAT control found in the TS-2000. However, it
receives commands over TCP/IP instead of through an RS-232 connection. For some applications this
is trivial – for others some internet plumbing is required.
The Basics
FFFF3-90""93
22!!#!4"(,9- 2221!W
2:'4- !#93!,
22!
Note: The latest version of Hamlib has a radio definition for the PiHPSDR, thus any application that
uses Hamlib will be able to talk to PiHPSDR in its native manner, i.e. directly through TCP/IP without
using the serial port. (Thanks to Jae, K5JAE for the hamlib port!) The serial port methodology is
presented here for older iterations of Hamlib. To get access to to native support you will need to
compile Hamlib from source and install it. That is beyond the scope of this manual.
&, +0@5
Perhaps the easiest way to do this is via the utility “socat” available in
most Linux distributions. This utility is sort of a swiss army knife for interconnectivity, and one its
abilities is to map Linux Serial ports to TCP/IP ports.
To obtain “socat” and install it on an Ubuntu system type:
sudo apt-get install socat
&= !3
Raspberry PI
Linux/Windows
Application
Use the Raspberry PI
TCP/IP Address
And set for Port 19090
Ethernet
PiHPSDR
-Classification: General Business
To use it – first start PiPHSDR. You need to know the TCP/IP address of your Raspberry Pi. This will
be a 32 bit number formated as XX.XX.XX.XX. I'll use 192.168.1.73 in my examples – since that
happens to be what I have my Raspberry Pi set too.
To run it – type:
socat pty,link=/tmp/vtty,raw tcp:192.168.1.73:19090&
This will do two things. It creates a fake serial port called /tmp/vtty that can be opened by most
applications and acts just like a serial port.
The next step is to point your application at /tmp/vtty where you would normally choose a serial port
and set it to talk to a TS-2000. It really is that simple!
This allows applications that are built to use Hamlib to talk to PiHPSDR.
/5= :2:#B 2
grig –-model=214 –-rig-file=/tmp/vtty *
/tmp/vtty is a temporary file – it disappears as soon as socat ends.
Grig is built around the Hamlib radio access library. The TS-2000 is model 214 in Hamlib. Any
application that uses Hamlib should be able to communicate with PiHPSDR by using /dev/vtty and
choosing model 214 as the radio.
Something else to realize is that only one application can talk to PIHPSDR at a time on a given port.
PiHPSDR can use any of 19090-19092 as the CAT port, and supports 3 simultaneous connections.
If you have the latest version of Hamlib that supports PiHPSDR natively – the command to start grig
would be:
grig –model=240 –rig-file=192.168.1.73:19090 &
/5=@:B 2
FLDIGI can be connected to PiHPSDR using the native PiHPSDR interface built into the latest version
of Hamlib. However, it polls PiHPSDR way to fast.
Have no fear – FLRIG is here. FLRIG is a companion application to FLDIGI that can act as a server
&F !3
-Classification: General Business
for FLDIGI.
You can install FLRIG on with:
sudo apt-get install flrig
You can install FLDIGI with:
sudo apt-get install fldigi
Start FLRIG first with
flrig
No need to start it with sudo since it talks directly to PiHPSDR.
To set up FLRIG – Hit the Config button on the top of the application and Choose
Config/Setup/Transceiver – the Window below will pop up.
Use the arrow to the right of the Rig: box and slide it to TS-2000.
4E8#8++%4+)836
< !3
-Classification: General Business
Hit Close
.38D,0 0+
The window below will pop up.
Select the TCPIP tab. Enter the TCPIP address of your Raspberry Pi – in our example you see
192.168.1.73. Type in the TCPIP box 19090 and that should do it. Hit the “Use tcpip” button. If the
connected light isn't green – hit the Init button in the upper right portion of the window.
Hit Close and you should have FLRIG up and controlling your PiHPSDR.
The Frequency should work by using the scroll wheel over the digit you want to change.
The volume, RF, PWR, and MIC sliders should all work.
The PTT should cause the radio to transmit.
The S Meter should register.
Now get FLDIGI running.
Type:
fldigi
Choose Configure/Rig Control
Hit the flrig tab and the window below will pop up.
Hit the “Enable flrig xcvr control with fldigi as client” button.
< !3
-Classification: General Business
Note that the TCP/IP address is 127.0.0.1 – which is the same as the machine you are running flrig and
fldigi on. The TCP/IP port 12345 should already be configured.
Also hit the “Flrig PTT keys modem”
That is it.
You need to use actual audio cables from the Radio to your Linux computer for the audio as of now –
but this should be all that is necessary for FLDIGI to talk to your radio!
,,
The Hamlib system must be installed to use some packages – specifically to run the rigctld daemon.
On Ubuntu:
sudo apt-get install libhamlib-utils
sudo apt-get install libhamlib2
Note: These packages don't yet have PiHPSDR supported natively. It is necessary to compile the latest
version from source and that is beyond the scope of this manual.
&(
22 # C!!2 4@2-
21 1>"0>""#11112J,
First – make sure you have CQLOG installed.
On Ubuntu:
<3 !3
-Classification: General Business
sudo apt-get install CQLOG
We need do three things to get cqrlog running.
1) Create a virtual terminal – see the instructions above about running cqrlog. There is one change here.
We're going to aim the virtual serial port /tmp/vtty at TCP/IP port 19091 instead of 19090.
2) Start up the hamlib rigctld – this is a “daemon” in Unix parlance that is responsible for interfacing
between applications and the virtual terminal using the internal hamlib protocol. Note that SOME
applications have the hamlib software built in, while others use the daemon – cqrlog uses the daemon.
The rigctld must be started using “sudo”
3) Start up cqrlog. Specifically do NOT use “sudo” for this command.
In a single xterm – you can start up both socat AND the rigctld daemon. Note again the use of “sudo”
prior to the command AND note that the first program can be put into the background safely. Rigctld
doesn't work if you do that..
In another xterm – start up cqrlog
Enter: cqrlog &
This will start up cqrlog talking the PiHPSDR radio using port 19091. Note that this can be safely put
into the background using the ampersand operator.
Configure cqrlog as shown in the picture below:
<C !3
-Classification: General Business
Note that we are choosing to NOT launch rigctld when the program starts – but rather starting it by
hand.
Next – start up flrig as you have previously using port 19090. It should be configured correctly from
the first time you used it. Since cqrlog spouts messages – you may need to use another xterm…
% flrig &
And this you can start up FLDIGI using the same xterm..
%fldigi
The picture below shows all applications running – using the two TCP/IP ports.
1#-2
The biggest advantage of running applications through latest version of Hamlib is that the whole virtual
terminal concept is removed! Applications can talk directly to PiHPSDR without any middleware. I'll
use CQRLOG to illustrate the setup.
The first trick is to make rigctld runnable without being root. THIS IS A SECURITY HOLE – Proceed
at your own risk! The following command allows rigctld to be run without being root…
sudo chown pi /usr/local/bin/rigctld
This makes the user “pi” owner of the rigctld daemon.
Next – start up cqrlog and set up its preferences as shown in the next picture.
<D !3
-Classification: General Business
Things to note:
Rig Model is OpenHPSDR PiHPSDR – radio model 240.
Device: Use the TCP/IP/Port number – so 192.168.1.73:19090
The “Run rigctld when program starts” is checked – since we don't have to root to run rigctld.
It is also possible to start cqrlog on OTHER than the Raspberry Pi. The settings would be the SAME
since the device entry is what actually aims the communications at the PiHPSDR TCP/IP port. Rigctld
can be started on another machine and it will be able to communicate via TCP/IP directly to the
PiHPSDR application.
74
PiHPSDR provides 3 separate TCP/IP channels on ports 19090, 19091, and 19092 which can
communicate with other applications using an emulation of the TS-2000 command set.
Some applications require a virtual serial port – use the socat command run to create the virtual serial
port.
The very latest version of Hamlib supports PiHPSDR natively. Radio model is 240, and uses TCPIP
Address/Port Number instead of the serial port.
Other applications require the hamlib rigctld to be present – start /usr/bin/rigctld with sudo.
To run FLDIGI – use FLRIG as the server for FLDIGI since FLDIGI has issues talking to the virtual
serial port.
<+ !3
-Classification: General Business
4+
<& !3
AG Command Sets/Reads AF Slider
1 2 3 4 5 6 7 8 9 10
Set A G P1 P2 P2 P2 ; Notes:
Read A G ; P1 Ignored
Response A G P1 P2 P2 P2 ; P2 000-255 linearly mapped to 0-100 range
FA Command Sets VFO A Frequency
1 2 3 4 5 6 7 8 9 10
Set F A P1 P1 P1 P1 P1 P1 P1 P1 Frequency in Hertz ( 11- digits)
P1 P1 P1 ; Note that blank digits should be 0
Read F A ; Always reads VFO_A
Response F A P1 P1 P1 P1 P1 P1 P1 P1
P1 P1 P1 ;
FB Command Sets VFO B Frequency
1 2 3 4 5 6 7 8 9 10
Set F B P1 P1 P1 P1 P1 P1 P1 P1 Frequency in Hertz ( 11- digits)
P1 P1 P1 ; Note that blank digits should be 0
Read F B ; Reads VFO_A when one receiver operation
Response F B P1 P1 P1 P1 P1 P1 P1 P1 is selected.
P1 P1 P1 ;
FR Command Sets/Reads which VFO is active receiver
1 2 3 4 5 6 7 8 9 10
Set F R P1 ; P1=0 – VFO A 1=VFO B
Read F R ; Only in 2 receiver mode will cause
Response F R P1 ; frequency swapping to between
VFO A and VFO B and if Transmit != Receive
VFO – Split will set.
FT Command Sets/Reads which VFO is active transmitter
1 2 3 4 5 6 7 8 9 10
Set F T P1 ; P1=0 – VFO A 1=VFO B
Read F T ; Sets Split if Active Transmitter not the same
Response F T P1 ; as active receiver
FW Command Sets/Reads receive filter width (Only for CW mode)
1 2 3 4 5 6 7 8 9 10
Set F W P1 P1 P1 P1 ; P1 – (0000-9999 in Hz)
Read F W ; Frequency are mapped from TS2000 to PiHPSDR
Response F W P1 P1 P1 P1 ; CW 25/50→50 100→100 250→300 400->400
500→500 600→600 750→1000 800→1000
-Classification: General Business
<< !3
GT Command Set/Read AGC constant values
1 2 3 4 5 6 7 8 9 10
Set TS-2000 legal values 000-020
Read G T ; PiHPSDR = 000 = Off, 005=Fast, 010=Medium
Response G T P1 P1 P1 ; 010=Medium, 015=Slow, 020=Long
Note: Hamlib will send values as N*84 -
PiHPSDR can detect commands using
this scale and SET its internal state
accordingly – but can only read back legal
values according to the 000-020 mapping.
ID Command Read the transceiver ID number
1 2 3 4 5 6 7 8 9 10
Set P1 = 019: TS-2000
Read I D ;
Response I D P1 P1 P1 ;
IF Command Sets VFO A Frequency
1 2 3 4 5 6 7 8 9 10
Set P1 = Frequency in Hz (11 digits)
Read I F ; P2 = Step in Hertz (5 digits)
Response I F P1 P1 P1 P1 P1 P1 P1 P1 P3 = Active Receiver RIT in Hertz (5 digits)
P1 P1 P1 P2 P2 P2 P2 P3 P3 P3 P4 = 0: Rit Off 1: Rit On
P3 P3 P3 P4 P5 P6 P7 P7 P8 P9 P5 = 0: Rit Off 1: Rit On
P10 P11 P12 P13 P14 P14 P15 ; P8 = 0: Mox=0 1: Mox=1
P9 = Radio Mode ( See MD command)
P12 = 0: Split off 1: Split on
All other parameters are 0.
KS Command Sets and reads keyer speed
1 2 3 4 5 6 7 8 9 10
Set K S P1 P1 P1 ; P1 – 010 (min) – 060 (max) in WPM
Read K S ;
Response K S P1 P1 P1 ;
LK Command Sets/reads the lock function
1 2 3 4 5 6 7 8 9 10
Set L K P1 P2 ; Notes:
Read L K ; P1 = 0: Unlock 1: Lock
Response L K P1 P2 ; P2 ignored
-Classification: General Business
<= !3
MD Command Sets/Reads radio Mode
1 2 3 4 5 6 7 8 9 10
Set M D P1 ; P1 = 1: LSB 2: USB 3: CWU 4: FMN 5: AM
Read M D ; 6: DIGL 7: CWL 9: DIGU
Response M D P1 ;
MG Command Sets/Reads Mic Gain Slider
1 2 3 4 5 6 7 8 9 10
Set M G P1 P1 P1 ; P1 – 000 (min) – 100 (max)
Read M G ;
Response M G P1 P1 P1 ;
NB Command Sets/Reads the Noise Blanker function status
1 2 3 4 5 6 7 8 9 10
Set N B P1 ; P1 = 0: Off 1: On
Read N B ;
Response N B P1 ;
NR Command Sets/Reads the Noise Blanker function status
1 2 3 4 5 6 7 8 9 10
Set N R P1 ; P1 = 0: Off 1: NR On 2: NR2 On
Read N R ;
Response N R P1 ;
NT Command Sets ANF bit (Autonotch in TS2000)
1 2 3 4 5 6 7 8 9 10
Set N T P1 ; P1= 0: ANF Off 1: ANF On
Read N T ;
Response N T P1 ;
PC Command Sets/Reads Drive Slider
1 2 3 4 5 6 7 8 9 10
Set P C P1 P1 P1 ; P1 – 005 (min) – 100 (max)
Read P C ;
Response P C P1 P1 P1 ;
RD Command Move RIT off frequency Down
1 2 3 4 5 6 7 8 9 10
Set R D P1 P1 P1 P1 P1 ; P1,P2 ignored
Read R D ; decrements rit_frequency by rit_increment
Response R D P2 ;
-Classification: General Business
<F !3
RG Command Sets/Reads AGC slider
1 2 3 4 5 6 7 8 9 10
Set R G P1 P1 P1 ; P1 = 000 (min) to 255 (max) linearly scaled to
Read R G ; -20 to 140 range of slider
Response R G P1 P1 P1 ;
RT Command Sets/Read the RIT function status
1 2 3 4 5 6 7 8 9 10
Set R T P1 ; P1 – 0: Off 1: On
Read R T ; Returns state of active receiver RIT
Response R T P1 ;
RU Command Move RIT off frequency Up
1 2 3 4 5 6 7 8 9 10
Set R U P1 P1 P1 P1 P1 ; P1,P2 ignored
Read R U ; increments rit_frequency by rit_increment
Response R U P2 ; of active receiver
RX Command Set Mox to 0 (turn off transmitter)
1 2 3 4 5 6 7 8 9 10
Set R X ;
Read
Response
SD Command Set /Read CW Breakin Delay
1 2 3 4 5 6 7 8 9 10
Set S D P1 P1 P1 P1 P1 ; P1 = 0000-1000 ms Breakin delay
Read S D ; 0000= Set Full Breakin
Response P1 P1 P1 P1 P1 ; If PiHPSDR has values above 1000 internally
a value of 1000 is reported
SM Command Reads the S Meter
1 2 3 4 5 6 7 8 9 10
Set P1 – 0: Main, 1: Sub
Read S M P1 ; P2 = 0000 (min) to 0030 (max) main xcvr
Response S M P1 P2 P2 P2 P2 ; 0000 (min) to 0015 (max) sub xcvr
-Classification: General Business
= !3
ST Command Sets/reads the frequency step
1 2 3 4 5 6 7 8 9 10
Set S T P1 P1 ; Note that internal value is categorized into
Read S T ; These slots for the read operation, Set uses
Response S T P1 P1 ; the assigned value.
P1 – SSB 00-1 KHz 01: 2.5KHz 02 5KHz
03: 10KHz
AM/FM: 00: 5KHz 01: 6.25KHz
02: 10KHz 03: 12.5KHz
04: 15KHz 05: 20KHz 06: 25KHz 07: 30KHz
08: 50KHz 09: 100KHz
TX Command Set the transmitter MOX
1 2 3 4 5 6 7 8 9 10
Set T X ;
Read
Response
VD Command Set/Read Vox Delay
1 2 3 4 5 6 7 8 9 10
Set V D P1 P1 P1 P1 ; P1 – 0000 (min) to 1000 (max)
Read V D ; Values are limited to these boundaries
Response V D P1 P1 P1 P1 ;
VG Command Set/Read Vox Threshold (Vox GAIN on TS2000)
1 2 3 4 5 6 7 8 9 10
Set V D P1 P1 P1 ; Set Vox Threhold
Read V D ; P1 = (ooo) min to (oo9) max
Response V D P1 P1 P1 ;
-Classification: General Business
48
48@)
9 -((-2-48
8=00,80,08()0
!42LN8()K
48A8 :
8=00,80,08()0
'B 2:
" 1.1, Y/
8=008,06,08(8,
9,24!/
8=008,08,08(8,
9-,6 !-2
/00!10! 2 2$%&
$48 %2
3C9#BD'G"9:
DF'!
133
4'"!
9/F3DD3D+<C0D0+6&6"9Z
/=N8()
*/http://www.apache-labs.com
= !3
-Classification: General Business
(,9A
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
=C !3
-Classification: General Business
"!@
"! +
9 1+&
B9 &
B9(&
9(A0*0>*#+&
3!@+<
3!@+<
C-2&
C=!3+&
& <D
<!<D
C!1; GC
C>=
+!
&J :"
<46 3
=66 D
F,!B CD
IHB DD
IBDD
HBDD
>!+
!+C
19!3+
!@!G:C3
:1"(C3
" <D
!<D
<D
8 <D
" &
!@ +<
!,A3
29 3&
11 3=
: -4 ,142<
BG%F7&
9+0&A
12=
=D !3
-Classification: General Business
:12&
+
6 D
!1@+
2
N10 09"&D
N1 =3F
>""&3
-#; 2/<
J,&+
*B:"3C
*%43C
*%A8A6,A3C
*%A8A6,AB3C
*%A8A9"93C
*!3C
- 12-#!4!=
3=
!>;4-$>,C+
-; 44D&
>; 4A42 C+
3F
3
A3
3
46 3
4!3=
4!3=
4*-3=
=
! 2<'
A=
AA3AC:12+F
A'A3'AC:+F
A'A3'AC:12&
A3=
AC=
AD=
A44<+
A!!#+<
; G!C
@ <
A@+
=+ !3
-Classification: General Business
@:4:+
A@ +
>4#0A!09 +<
>!3<
> 3
>""? >"&=
>"&C
>697A23
>( =
> > 92 D
>2!3<
>4 F
> 92!6292D
> 9 2!3&
> +<
> D
- C&
- !3!
,7>!!-!!&
22 3+
", +<
",!- C
",124&
11&3
2&
1 CC
!#
"A +D
1C
!1!111+&
"!-! 2<
53A&
56),70(&89
%+,
%&
%& 224&=
%4!3C
%.%3("&
-! !<
3+
@
,>; 3F
!, =
=& !3
-Classification: General Business
6" 3
1 3+
#C
6"A+D
6190" @&
6@>;3F
6249 2!3&
6 E3
6 E(93D
6 E*3C
6 E4 3<
6 E3+
6 EA; GC
6 EA@+
6 E6C3
6 E, 3&
6 E4B!33
6 E<
6 E!<
6 E@=
6 EC
6 E973
6 E9796" 3
6 E97#B" 3
6 E$,7 CC
6 E7$93F
6 D
6 9E6++
6 1!-!4 C3
6"!+
6!BC3
6CC
6! C
6>;3F
22G!#!#+D
22 23!3&
66A 3+
6 +&
2 0:4!-4=
61#+&
6,7 +&
6 &+
6 #=
=< !3
-Classification: General Business
(#A=
(,9A <&
(0(30(>3+
(3A>3+
(36!3+
(3(A6!3+
()$
,CD
, @"0,3&
,6 D
, 3&
,<D
, <D
,!#!-#.
,
,63+
!+3
!13<
!#3<
FFFF3-90"&
!1299 C
3+
# =
3+
2C
999 &C
J :"
! 1(#<
!2=
$(=
+
4+
!+C
"29 1C+'D=
!-9 1$>,&
"9 D=
"9AD=
"9,>>,(D=
"9,>>0,(!D=
"9M#8A,*9A79D=
"9 C+'D&
"9K "92 D=
== !3
-Classification: General Business
1#-2&<
6:!1C3
=
3 =
C =
D =
+ =
& =
2 =
*3, &
":&3
1 1!&+
#*>#!#!</*DF
!# +
!#4+
!>;3C
!3C
&
-#
#!C
#!?!A- C
C
*%&!!-&
*%&!!->!1&
1!D<
3
!1Y!1&C
!1Y1&C
!1&
#A!+<
9$>,!:+&
9!CC
9 3F
11"9- D=
9$>,:D3
9?D
9?B!C<
9?B!:C=
9?B!:-$>,!C=
9?>CF
9?> C&'D
9?6!CF
=F !3
-Classification: General Business
9?6,7 C<
9?(,"AD
9HBIBIHBDD
99(DC
99(?:9 1DC
9>AJ D&
96A6 D<
9"9D=
9"9D+
9 C+
9 >; 4A4C+
9 +&
9 -$>,@CD
9 -$>,B@CD
9 1!!111!+&
9-3
9#2N#!!23F
92!#! 3
92 -!33
93&
9( =
9(A 3&'+&
9 !+3
9(A9DF
9(A0*0>*#+&
97A; G!7A; GC
!#-; 3
B !"(9!3
!
1#/&
$>,A!+&
$>,C+'D&
$>,9 1C
$>, C+
$>,B C+
$!-2>X-3&&
$%&
*+*
*- 23<
*-13<
*-#3<
*1 3C
*1?!0!#113C
F !3
-Classification: General Business
*!AC
+'='CD'+=
!! 1=
B CD
> 43<!-#=
6 D
' &
V",- 12+F
F !3
