Radio/Kenwood/TS570S - Revision history

Admin: /* Control Software */

2016-06-22T06:18:47Z

Control Software

← Older revision		Revision as of 06:18, 22 June 2016
Line 284:		Line 284:
	All examples: https://twistedmatrix.com/documents/16.2.0/core/examples/index.html		All examples: https://twistedmatrix.com/documents/16.2.0/core/examples/index.html

	=Control ~~Software~~=		=Python TS-570S Control Program=

	~~In the previous section we were able to string together some serial commands to control the radio. Now let's stitch some more fancy code together to control this thing in some more interesting ways.~~


			In this section we'll stitch together some code to control the radio in a more comprehensive/sophisticated way.

	=Links=		=Links=

Admin: /* Links */

2016-06-22T05:31:17Z

Links

← Older revision		Revision as of 05:31, 22 June 2016
Line 283:		Line 283:

	All examples: https://twistedmatrix.com/documents/16.2.0/core/examples/index.html		All examples: https://twistedmatrix.com/documents/16.2.0/core/examples/index.html

			=Control Software=

			In the previous section we were able to string together some serial commands to control the radio. Now let's stitch some more fancy code together to control this thing in some more interesting ways.



	=Links=		=Links=

Admin at 05:29, 22 June 2016

2016-06-22T05:29:52Z

← Older revision		Revision as of 05:29, 22 June 2016
Line 7:		Line 7:
	I found just about all the information I needed in the excellent and comprehensive TS-570S manual.		I found just about all the information I needed in the excellent and comprehensive TS-570S manual.

	==Serial Port (Hardware)==		=Serial Port (Hardware)=

	===Radio Serial Port Photo===		==Radio Serial Port Photo==

	There is an RS-232 serial port on the back of the radio, pictured below:		There is an RS-232 serial port on the back of the radio, pictured below:
Line 15:		Line 15:
	[[Image:KenwoodTS570S_Serial.jpg\|500px]]		[[Image:KenwoodTS570S_Serial.jpg\|500px]]

	===Radio Serial Port Pinout===		==Radio Serial Port Pinout==

	The radio's manual gives the pinout for this port, and some information on how to communicate with the radio using the serial connection:		The radio's manual gives the pinout for this port, and some information on how to communicate with the radio using the serial connection:
Line 30:		Line 30:
	[[Image:KenwoodTS570S_SerialSchematic3.png\|400px]]		[[Image:KenwoodTS570S_SerialSchematic3.png\|400px]]

	===Computer Serial Port===		==Computer Serial Port==

	I am connecting to the Kenwood radio's serial port using a MacBook Pro. I used a USB to RS-232 cable. Unfortunately, it was a USB to male RS232, and the radio also had a male RS232 connection in the back, so I used some tiny female-female wires to connect each of the individual pins:		I am connecting to the Kenwood radio's serial port using a MacBook Pro. I used a USB to RS-232 cable. Unfortunately, it was a USB to male RS232, and the radio also had a male RS232 connection in the back, so I used some tiny female-female wires to connect each of the individual pins:
Line 78:		Line 78:
	On the MacBook, I will be using Python together with the pyserial library [https://github.com/pyserial/pyserial] to send serial commands out and over the wire.		On the MacBook, I will be using Python together with the pyserial library [https://github.com/pyserial/pyserial] to send serial commands out and over the wire.

	==Serial Communication (Software)==		=Serial Communication (Software)=

	The pyserial library can be used to communicate with devices using a serial port/protocol. The pyserial library is available on Github: https://github.com/pyserial/pyserial		The pyserial library can be used to communicate with devices using a serial port/protocol. The pyserial library is available on Github: https://github.com/pyserial/pyserial

	===Serial Command Format===		==Serial Command Format==

	The Kenwood TS-570S manual details the pinout of the serial cable, and what hardware connections need to be made. But it also covers the specifics of how to send commands from a computer to the radio. The commands are classified as follows:		The Kenwood TS-570S manual details the pinout of the serial cable, and what hardware connections need to be made. But it also covers the specifics of how to send commands from a computer to the radio. The commands are classified as follows:
Line 125:		Line 125:
	This indicates that the frequency of VFO A is set to 7 MHz.		This indicates that the frequency of VFO A is set to 7 MHz.

	===Alphabetical Commands===		==Alphabetical Commands==

	The following is a table of alphabetical commands given in the appendix of the TS-570S user manual:		The following is a table of alphabetical commands given in the appendix of the TS-570S user manual:
Line 133:		Line 133:
	A good "Hello World" command is the ID command, which returns the model number of the radio. I'll be using this to demonstrate basic serial communication with the TS-570S.		A good "Hello World" command is the ID command, which returns the model number of the radio. I'll be using this to demonstrate basic serial communication with the TS-570S.

	===Finding the Serial Device===		==Finding the Serial Device==

	No matter what library we happen to choose to communicate with the serial device, we will need to specify the device file associated with the serial device. This will be a file in the <code>/dev/</code> folder that shows up when we plug in the USB-RS232 cable.		No matter what library we happen to choose to communicate with the serial device, we will need to specify the device file associated with the serial device. This will be a file in the <code>/dev/</code> folder that shows up when we plug in the USB-RS232 cable.

	====Finding the USB to Serial Device====		===Finding the USB to Serial Device===

	Trying to find the device file associated with the USB-RS232 adapter.		Trying to find the device file associated with the USB-RS232 adapter.
Line 153:		Line 153:
	No luck - there were no devices that showed up when I plugged in the serial cable.		No luck - there were no devices that showed up when I plugged in the serial cable.

	==== Installing Drivers ====		===Installing Drivers===

	My next step was to try installing a driver for the USB-RS232 cable from the manufacturer (in this case, CableMatters). Their drivers page [http://www.cablematters.com/cs-Downloads.aspx] provided a link to a Mac driver. Specifically, the page with the driver listed it as "Smart I/O > USB to UART/Serial/Printer > PL2303 Mac OS X Driver Download".		My next step was to try installing a driver for the USB-RS232 cable from the manufacturer (in this case, CableMatters). Their drivers page [http://www.cablematters.com/cs-Downloads.aspx] provided a link to a Mac driver. Specifically, the page with the driver listed it as "Smart I/O > USB to UART/Serial/Printer > PL2303 Mac OS X Driver Download".
Line 159:		Line 159:
	I downloaded version 1.6.0, which was a zipped up pkg file. It was only 94 KB, but required a restart. oooookay, annoying driver software, let's reboot.		I downloaded version 1.6.0, which was a zipped up pkg file. It was only 94 KB, but required a restart. oooookay, annoying driver software, let's reboot.

	====Finding the USB to Serial Device Redux====		===Finding the USB to Serial Device Redux===

	After installing the driver, trying again.		After installing the driver, trying again.
Line 188:		Line 188:
	</pre>		</pre>

	===Pyserial Library===		==Pyserial Library==

	An excellent tutorial on the essentials of the pyserial library is here: http://www.zilogic.com/blog/tutorial-pyserial.html		An excellent tutorial on the essentials of the pyserial library is here: http://www.zilogic.com/blog/tutorial-pyserial.html
Line 274:		Line 274:
	Excellent, this means that we are in business!		Excellent, this means that we are in business!

	===Twisted Library===		==Twisted Library==

	The Twisted library also allows for asyncronous communication with a serial device. Twisted is an event-driven Python library. Examples are provided with the Twisted documentation.		The Twisted library also allows for asyncronous communication with a serial device. Twisted is an event-driven Python library. Examples are provided with the Twisted documentation.
Line 294:		Line 294:
	Connecting to Kenwood (DXLab): http://www.dxlabsuite.com/dxlabwiki/ConnectingKenwood		Connecting to Kenwood (DXLab): http://www.dxlabsuite.com/dxlabwiki/ConnectingKenwood

	==Flags==		=Flags=

	{{RadioFlag}}		{{RadioFlag}}

Admin at 05:28, 22 June 2016

2016-06-22T05:28:33Z

← Older revision		Revision as of 05:28, 22 June 2016
Line 5:		Line 5:
	TS-570 has a male 9-pin RS-232 port in the back. I connected this to a USB-to-RS-232 cable that I bought online.		TS-570 has a male 9-pin RS-232 port in the back. I connected this to a USB-to-RS-232 cable that I bought online.

	~~=Manual=~~		I found just about all the information I needed in the excellent and comprehensive TS-570S manual.

	~~The following~~ information ~~is from~~ the TS-570S manual.

	==Serial Port (Hardware)==		==Serial Port (Hardware)==
Line 296:		Line 294:
	Connecting to Kenwood (DXLab): http://www.dxlabsuite.com/dxlabwiki/ConnectingKenwood		Connecting to Kenwood (DXLab): http://www.dxlabsuite.com/dxlabwiki/ConnectingKenwood

	=Flags=		==Flags==

	{{RadioFlag}}		{{RadioFlag}}

Admin at 05:27, 22 June 2016

2016-06-22T05:27:36Z

← Older revision		Revision as of 05:27, 22 June 2016
Line 3:		Line 3:
	[[Image:KenwoodTS570S.jpg\|500px]]		[[Image:KenwoodTS570S.jpg\|500px]]

	TS-570 has a ~~straight-through female~~ 9-pin ~~RS232~~ to ~~female RS232~~ cable ~~[http://www.dxlabsuite.com/dxlabwiki/ConnectingKenwood]~~.		TS-570 has a male 9-pin RS-232 port in the back. I connected this to a USB-to-RS-232 cable that I bought online.

	=Manual=		=Manual=
Line 293:		Line 293:
	Manual for the TS-590S transceiver: http://www.kenwood.com/i/products/info/amateur/pdf/ts_590_pc_command_e.pdf		Manual for the TS-590S transceiver: http://www.kenwood.com/i/products/info/amateur/pdf/ts_590_pc_command_e.pdf
	-->		-->

			Connecting to Kenwood (DXLab): http://www.dxlabsuite.com/dxlabwiki/ConnectingKenwood

	=Flags=		=Flags=

Admin: /* Pyserial Library */

2016-06-22T05:26:21Z

Pyserial Library

← Older revision		Revision as of 05:26, 22 June 2016
Line 273:		Line 273:
	FA00014000000;		FA00014000000;
	</pre>		</pre>

			Excellent, this means that we are in business!

	===Twisted Library===		===Twisted Library===

Admin: /* Pyserial Library */

2016-06-22T05:26:04Z

Pyserial Library

@@ Line 225: / Line 225: @@
 print a
-# Close the serail connection
+# Close the serial connection
 ser.close()
 </pre>
@@ Line 236: / Line 236: @@
 reading
 ID018;
 </pre>

Admin: /* Pyserial Library */

2016-06-22T04:15:06Z

Pyserial Library

← Older revision		Revision as of 04:15, 22 June 2016
Line 201:		Line 201:

	Now you can import pyserial by adding <code>import serial</code> to your Python code, and create a serial device corresponding to the device file.		Now you can import pyserial by adding <code>import serial</code> to your Python code, and create a serial device corresponding to the device file.

			Our first script is a "hello world" script. It asks the radio for its ID:

	<pre>		<pre>
	~~$ python~~		import serial
	~~>>>~~
	~~>>> import serial~~		# Set the device file
	~~>>>~~ ser = serial.Serial('/dev/tty.usbserial')		ser = serial.Serial('/dev/tty.usbserial')
	~~>>>~~ ser
	~~Serial<id=0x1018750d0~~, ~~open=True>~~(~~port='~~/~~dev/tty~~.~~usbserial', baudrate=9600, bytesize=8, parity~~='N'~~, stopbits=1, timeout=None, xonxoff=False, rtscts=False, dsrdtr=False~~)		# Timeout is 5 seconds
	~~</pre>~~		ser.timeout=5

			# Yes, we will be using RTS and CTS (ready to send/clear to send)
			ser.rtscts = True

			# Give the command to the radio that asks for its ID
			print "Writing id"
			ser.write('ID;')

	~~Start by setting~~ the ~~timeout, so if you aren't sending~~ the ~~commands correctly you don't have to sit around and wait forever:~~		# Read the response from the radio
			print "reading"
			a = ser.read(16)
			print a

	~~<pre>~~		# Close the serail connection
	~~>>>~~ ser.~~timeout=3~~		ser.close()
	</pre>		</pre>

	~~Not working... probably because RTS and CTS are not enabled. So enable them~~:		When this script is run, you get the ID of the radio, which is <code>018</code>:

	<pre>		<pre>
	~~>>>~~ ser.~~rtscts=True~~		$ python ser.py
			Writing id
			reading
			ID018;
	</pre>		</pre>

	~~Check with this: http://www.tldp.org/HOWTO/Serial-HOWTO-19.html~~

	===Twisted Library===		===Twisted Library===

Admin: /* Pyserial Library */

2016-06-22T02:38:46Z

Pyserial Library

← Older revision		Revision as of 02:38, 22 June 2016
Line 204:		Line 204:
	<pre>		<pre>
	$ python		$ python
	~~Python 2.7.10 (v2.7.10:15c95b7d81dc, May 23 2015, 09:33:12)~~		>>>
	~~[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin~~
	~~Type "help", "copyright", "credits" or "license" for more information.~~
	>>> import serial		>>> import serial
	>>> ser = serial.Serial('/dev/tty.usbserial')		>>> ser = serial.Serial('/dev/tty.usbserial')
Line 216:		Line 214:

	<pre>		<pre>
	>>> ser.timeout=1		>>> ser.timeout=3
	</pre>		</pre>

Admin: /* Computer Serial Port */

2016-06-22T02:34:15Z

Computer Serial Port

← Older revision		Revision as of 02:34, 22 June 2016
Line 40:		Line 40:
	This site has more information about serial pin numberings: http://www.tldp.org/HOWTO/Serial-HOWTO-19.html		This site has more information about serial pin numberings: http://www.tldp.org/HOWTO/Serial-HOWTO-19.html

	~~It is important~~ to ~~make sure that~~ the		You must be careful to connect the correct pins the correct way. If you have a female-female RS-232 crossover cable, you're all set (it will cross the TX and RX lines), but if you're manually sticking wires between pins, you have to pay close attention.

	<pre>		<pre>
Line 49:		Line 49:
	</pre>		</pre>

	The five pins that will be connected on the Kenwood side are:		The five pins that will be connected on the Kenwood side are (WARNING: THESE ARE SWAPPED FROM THE COMPUTER):
	* ~~RXD~~ - ~~receive~~ data - pin 2 on the Kenwood - ~~receives~~ bytes into the radio		* TXD - transmit data - pin 2 on the Kenwood - transmits bytes into the radio
	* ~~TXD~~ - ~~transmit~~ data - pin 3 on the Kenwood - receives bytes ~~into~~ the ~~transmitter~~		* RXD - receive data - pin 3 on the Kenwood - receives bytes from the radio
	* GND - ground - pin 5 on the Kenwood		* GND - ground - pin 5 on the Kenwood
	* ~~RTS~~ - (~~request~~ to send) ~~transmit~~ enable - pin 7 on the Kenwood - radio ~~is allowed to transmit if~~ this pin is ~~high~~		* CTS - (clear to send) receive enable - pin 7 on the Kenwood - radio sets this pin high when it is ready to receive
	* ~~CTS~~ - (~~clear~~ to send) ~~receive~~ enable - pin 8 on the Kenwood - radio ~~sets~~ this pin high ~~when it is ready to receive~~		* RTS - (request to send) transmit enable - pin 8 on the Kenwood - radio is allowed to transmit if this pin is high

	The five pins that will be connected on the computer side are:		The five pins that will be connected on the computer side are:
Line 63:		Line 63:
	* CTS - (clear to send) receive enable - pin 8 on the computer - computer sets this pin high when it is ready to receive		* CTS - (clear to send) receive enable - pin 8 on the computer - computer sets this pin high when it is ready to receive

	To connect the two, we need to ~~cross~~ the RX and TX pins~~, so that~~ the radio ~~and computer aren't both transmitting on the same line~~, ~~and receiving on the same line~~.		To connect the two, we need to connect pin 2 to pin 2, pin 3 to pin 3, pin 5 to pin 5, pin 7 to pin 7, and pin 8 to pin 8. No crossover is necessary, because the RX and TX pins are swapped internally in the radio, to make it easier.

	We want to connect the radio and the computer as follows:		We want to connect the radio and the computer as follows:
Line 69:		Line 69:
	<pre>		<pre>
	Radio Pin Computer Pin		Radio Pin Computer Pin
	2 ~~RXD~~ --------- ~~3 TXD~~		2 TXD --------- 2 RXD
	3 ~~TXD~~ --------- ~~2 RXD~~		3 RXD --------- 3 TXD

	5 GND -------- 5 GND		5 GND -------- 5 GND

	7 ~~RTS~~ --------- ~~8 CTS~~		7 CTS --------- 7 RTS
	8 ~~CTS~~ --------- ~~7 RTS~~		8 RTS --------- 8 CTS
	</pre>		</pre>