Actions

Difference between revisions of "Software Setup For Linux"

From The RadioReference Wiki

 
(49 intermediate revisions by 3 users not shown)
Line 14: Line 14:
 
The following applications do connect to the scanner and will allow upload and downloads. Additional features may be affected with the use in Wine as noted below.
 
The following applications do connect to the scanner and will allow upload and downloads. Additional features may be affected with the use in Wine as noted below.
  
===Uniden- Working===
+
===Uniden - Updated 12/22/2023===
  
 
====[[ARC-XT-Pro_Install_Under_Linux|ARC-XT-Pro]]====
 
====[[ARC-XT-Pro_Install_Under_Linux|ARC-XT-Pro]]====
:Slow to authenticate to RR.com. Need to answer no / continue as Ubuntu wants to close it down.  
+
#Slow to authenticate to RR.com. Need to answer no / continue as Ubuntu wants to close it down.  
:Also receives HTTP timeouts while connecting.
+
#Also receives HTTP timeouts while connecting.
  
 
====[[Freescan_Install_Under_LINUX|FreeScan]]====
 
====[[Freescan_Install_Under_LINUX|FreeScan]]====
:Functions as intended.
+
#Functions as intended.
  
 
====[[ScanControl_Install_Under_Linux|ScanControl]]====
 
====[[ScanControl_Install_Under_Linux|ScanControl]]====
:Functions as intended. Also compatable with some Radio Shack Models.
+
#Functions as intended. Also compatable with some Radio Shack Models.
  
 
====[[ProScan_Install_Under_Linux|ProScan]]====
 
====[[ProScan_Install_Under_Linux|ProScan]]====
:Doesn't find its User Manual from the toolbar.
+
#Doesn't find its User Manual from the toolbar.
:*Testers choice*
+
#Unable to use FTP to connect to SDS series.
 +
 
 +
====[[Sentinel_(Uniden_software)#Installing_Sentinel_on_Linux|Uniden Sentinel]]====
 +
#Must change SDS to a floppy disk in order for Sentinel to see it as a mass storage device.
  
 
===Radio Shack- Worked===
 
===Radio Shack- Worked===
Line 39: Line 42:
 
:Details on this linked page go back to .NET Framework v1.1 (Year 2003). There is a very good chance it will work with a current installation of Wine as described below, just need someone with the hardware to test it and report back. Last release was 2015 and is current in 2016.
 
:Details on this linked page go back to .NET Framework v1.1 (Year 2003). There is a very good chance it will work with a current installation of Wine as described below, just need someone with the hardware to test it and report back. Last release was 2015 and is current in 2016.
  
==Serial Port Setup==
+
==Wine Installation Process - Ubuntu - (Updated 4/9/2016)==      
  
===Serial Port Permission===
+
Note: Tested on Ubuntu Studio 15.10 & 16.04 Beta 2.
  
:Any applications requiring access to the serial port(s) must have the current user added to the "dialout" user group.  
+
===Install Wine 1.6===
  
:1) Copy and Paste the following in a Terminal window. Replace <Your_User_Name_Here> with your user name:
+
:1) Install Wine 1.6 from your package manager.
<pre>
 
sudo adduser <Your_User_Name_Here> dialout
 
</pre>
 
  
:2) Logout then back in to complete the user group addition.
+
:Notes:
  
===Identifying Your Serial Port===
+
:*Wine 1.7 isn't available for Willy. During one of the tests got it to load and at that point FreeScan was able to communicate to the RR.DB. Subsequent tests on a clean OS was not able to install Wine 1.7.
 +
:*These applications will not currently run with Wine 1.8. Tests also showed the only way to revert back to 1.6 was to reload the OS. If one wants to test 1.7 or 1.8 it is recommended to do it on a Virtual Machine.
  
* RS-232 connections will be identified as ttyS0-3 and will be assigned to Com 1-4 later.
+
===Create a 32-bit Wine Prefix===
  
* USB / RS-232 Adapters will be identified as ttyUSB0-3 and will be assigned to Com 1-4 later.
+
:Run each line below separately to:
 +
:1) Delete the directory ~/.wine (if still present from a previous installation) and
 +
:2) Create the new 32-bit prefix.
 +
<pre>
 +
rm ~/.wine
  
::PL2303 type adapters work very well on Linux and don't require drivers like Windows.
+
WINEARCH=win32 WINEPREFIX=~/.wine winecfg
 +
</pre>
  
::[[Connecting_scanners_via_USB#Generic_USB_to_RS-232_serial_converters|See details here about about different models available]]
+
:3) Close the Wine Configuration window at any time by selecting “OK”.
  
::For the purpose of this testing a TRENDnet TU-S9 was used.
+
===Prerequisites for .NET Framework 4.5===
  
 +
====Create 2 Folders====
  
:1) Connect Your Scanner to the Computer
+
:1) ~/.cache/winetricks/dotnet30/
  
:2) Copy and Paste the following in a Terminal window to detect your port:
+
:2) ~/.cache/winetricks/msxml3/
<pre>
 
dmesg | grep tty
 
</pre>
 
  
 +
====Download and Copy 2 Files====
  
:Example of a RS-232 connection showing that you will be linking ttyS0 to Com1 in the next step:
+
:1) Download .NET Framework 3.0 from:
<pre>
+
:http://www.oldversion.com/windows/download/net-framework-3-0
[    1.058530] 00:06: ttyS0 at I/O 0x3f8 (irq = 4, base_baud = 115200) is a 16550A
 
</pre>
 
  
 +
:2) Copy netframework3.exe to ~/.cache/winetricks/dotnet30
  
:Example of a USB to RS-232 connection showing that you will be linking ttyUSB0 to Com1 in the next step:
+
:3) Download MS XML Parser 3.0 SP 7:
<pre>
+
:http://download.cnet.com/Microsoft-XML-Parser-MSXML-3-0-Service-Pack-7-SP7/3000-7241_4-10731613.html
[32499.503662] usb 9-5: pl2303 converter now attached to ttyUSB0
 
</pre>
 
  
:*If you have another connected device and either ttyS1 or ttyUSB1 display as your new device you will want to link it to Com2 below instead of Com1. The same holds true when adding it to the registry.
+
:4) Copy  msxml3.msi to ~/.cache/winetricks/msxml3/
  
:*Now we can assume you have figured out how to Run a command using "Copy and Paste into a Terminal window".
+
===Install .NET Framework 4.5===
  
===Create symbolic link to the serial port===
+
:1) Run:
 
 
:1) For RS-232 Run:  
 
 
<pre>
 
<pre>
ln -s /dev/ttyS0 ~/.wine/dosdevices/com1
+
bash winetricks -q dotnet45 corefonts
 
</pre>
 
</pre>
  
:::::OR
 
  
:1) For USB to RS-232 Adapter Run:
+
Note: Installation take about 35 minutes but your milage may vary
<pre>
 
ln -s /dev/ttyUSB0 ~/.wine/dosdevices/com1
 
</pre>
 
  
===Adding The Port To The Registry===
+
===Check the .NET Framework v4.5 Install===
 +
:1) Download the tool from here:
  
:1) Open the file with:
+
::https://blogs.msdn.microsoft.com/astebner/2008/10/13/net-framework-setup-verification-tool-users-guide/
<pre>
 
gedit ~/.wine/system.reg
 
</pre>
 
  
:2) Add the following 2 lines at the beginning of the file right under “#arch=win32”:
+
:2) Run the tool:
 
<pre>
 
<pre>
[Hardware\\Devicemap\\Serialcomm] 1131331688
+
wine ~/Downloads/netfx_setupverifier_new/netfx_setupverifier.exe
"COM1"="COM1"
 
 
</pre>
 
</pre>
  
::Note: The above lines were found in [http://onetransistor.blogspot.com/2015/12/wine-serial-port-linux.html this article] as an example of what worked for that author. While it also worked for this author it may not work for you. Other examples are referenced, if needed.
+
:3) In the "Product to Verify" pull down select ".NET Framework 4.5"
  
:3) Save and close the file.
+
:4) Press "Verify Now"
  
==Wine Installation Process==     
+
:5) When complete press "View Log"
  
:*Using your Package Manager install the latest version of wine. This was tested using v1.8.0 (2016).
+
::*You should see the following line. '''If so the hard part is over, good job!''' Exit the window.
  
===Add the Wine PPA (Ubuntu)===
+
:::'''[DATE,TIME] Install state for .NET Framework 4.5: installed with no service packs.'''
  
:1) Open Software & Updates.
+
==Wine Installation Process - Arch - (Updated 12/22/2023)==     
  
:2) Select the "Other Software Tab", add.
+
===Install Wine===
  
:3) Enter the line below into the "APT line:" field:
+
:1) Enable 32-bit repositories by uncommenting the following two lines in /etc/pacman.conf:
 
<pre>
 
<pre>
ppa:ubuntu-wine/ppa
+
[multilib]
 +
Include = /etc/pacman.d/mirrorlist
 
</pre>
 
</pre>
  
:4) Allow system to update.
+
:2) Update pacman:
 +
<pre>
 +
# pacman -Syu
 +
</pre>
  
:5) Open your package manager and install Wine.
+
:3) Install wine, winetricks, and lib32-gnutls (for .NET support):
 +
<pre>
 +
# pacman -S wine-mono winetricks lib32-gnutls
 +
</pre>
  
===Create a 32 Bit Wine Prefix===
+
===Create a 32-bit Wine Prefix===
  
 
:Run each line below separately to:
 
:Run each line below separately to:
:1) Delete the directory ~/.wine (If still present from a previous installation) and
+
:1) Delete the directory ~/.wine and create a new 32-bit prefix:
:2) Create the new 32 Bit Prefix.
 
 
<pre>
 
<pre>
rm ~/.wine
+
$ rm -fr ~/.wine
 
+
$ WINEARCH=win32 winecfg
WINEARCH=win32 WINEPREFIX=~/.wine winecfg
 
 
</pre>
 
</pre>
  
:3) Close the Wine Configuration window by selecting “OK”.
+
:3) Close the Wine Configuration window at any time by selecting “OK”.
  
===Install Winetricks===
+
===Install .NET Framework 3.0 SP1===
  
:Run each line below separately to:
+
:1) Run:
:1) Install winetricks and then
 
:2) Make it executable:
 
 
<pre>
 
<pre>
wget http://www.kegel.com/wine/winetricks
+
$ winetricks dotnet35sp1
 
 
chmod +x winetricks
 
 
</pre>
 
</pre>
  
===Prerequsites for .NET Framework 4.5===
+
==Serial Port Setup==
  
:'''Note:''' .NET Framework 3.0 and XML Parser are prerequisites for .NET Framework 4.5. If they are not found in their respective ~/.cache directories the .NET Framework 4.5 installation will fail.
+
===Port Permission===
  
:1) Using your File Manager create 2 folders:
+
:Any applications requiring access to the serial port(s) must have the current user added to the "dialout" user group.
  
::~/.cache/winetricks/dotnet30/
+
:1) Copy and Paste the following in a Terminal window. Replace <Your_User_Name_Here> with your user name:
 +
<pre>
 +
sudo adduser <Your_User_Name_Here> dialout
 +
</pre>
  
::~/.cache/winetricks/msxml3/
+
:2) Logout then back in to complete the user group addition.
  
:2) Download .NET Framework 3.0 from:
+
===Port ID===
  
::http://www.oldversion.com/windows/download/net-framework-3-0
+
* RS-232 connections will be identified as ttyS0-3 and will be assigned to Com 1-4 later.
  
::Copy netframework3.exe to ~/.cache/winetricks/dotnet30
+
* USB / RS-232 Adapters will be identified as ttyUSB0-3 and will be assigned to Com 1-4 later.
  
:3) Download MS XML Parser 3.0 SP 7 from:
+
::PL2303 type adapters work very well on Linux and don't require drivers like Windows.
  
::http://download.cnet.com/Microsoft-XML-Parser-MSXML-3-0-Service-Pack-7-SP7/3000-7241_4-10731613.html
+
::[[Connecting_scanners_via_USB#Generic_USB_to_RS-232_serial_converters|See details here about about different models available]]
  
::Copy  msxml3.msi to ~/.cache/winetricks/msxml3/
+
::For the purpose of this testing a TRENDnet TU-S9 was used.
:
 
:
 
  
===Install .NET Framework v4.5:===
 
  
:1) Start the install by running:
+
:1) Connect Your Scanner to the Computer
 +
 
 +
:2) Copy and Paste the following in a Terminal window to detect your port:
 
<pre>
 
<pre>
bash winetricks -q dotnet45 corefonts
+
dmesg | grep tty
 
</pre>
 
</pre>
  
:'''Note:''' The installation takes ~35 minutes but your mileage may vary. Wait until it finishes with a command prompt.
 
  
===Check the .NET Framework v4.5 Install===
+
:Example of a RS-232 connection showing that you will be linking ttyS0 to Com1 in the next step:
:1) Download the tool from here:
+
<pre>
 +
[    1.058530] 00:06: ttyS0 at I/O 0x3f8 (irq = 4, base_baud = 115200) is a 16550A
 +
</pre>
  
::https://blogs.msdn.microsoft.com/astebner/2008/10/13/net-framework-setup-verification-tool-users-guide/
 
  
:2) Run the tool:
+
:Example of a USB to RS-232 connection showing that you will be linking ttyUSB0 to Com1 in the next step:
 
<pre>
 
<pre>
wine ~/Downloads/netfx_setupverifier_new/netfx_setupverifier.exe
+
[32499.503662] usb 9-5: pl2303 converter now attached to ttyUSB0
 
</pre>
 
</pre>
  
:3) In the "Product to Verify" pull down select ".NET Framework 4.5"
+
:*If you have another connected device and either ttyS1 or ttyUSB1 display as your new device you will want to link it to Com2 below instead of Com1. The same holds true when adding it to the registry.
 +
 
 +
:*Now we can assume you have figured out how to Run a command using "Copy and Paste into a Terminal window".
 +
 
 +
===Create Symbolic Link To The Port===
  
:4) Press "Verify Now"
+
:1) For RS-232 Run:
 +
<pre>
 +
ln -s /dev/ttyS0 ~/.wine/dosdevices/com1
 +
</pre>
  
:5) When complete press "View Log"
+
:::::OR
  
::*You should see the following line. '''If so the hard part is over, good job!''' Exit the window.
+
:1) For USB to RS-232 Adapter Run:  
 +
<pre>
 +
ln -s /dev/ttyUSB0 ~/.wine/dosdevices/com1
 +
</pre>
  
:::'''[DATE,TIME] Install state for .NET Framework 4.5: installed with no service packs.'''
+
:2) Reboot
  
::*If not return to step 2 above by deleting the ~/.wine directory and starting over.
+
===Adding The Port To The Registry===
  
 +
:1) Open the file with:
 +
<pre>
 +
gedit ~/.wine/system.reg
 +
</pre>
  
 +
:2) Add the following 2 lines at the beginning of the file right under “#arch=win32”:
 +
<pre>
 +
[Hardware\\Devicemap\\Serialcomm] 1131331688
 +
"COM1"="COM1"
 +
</pre>
  
===Select an Application===
+
::Note: The above lines were found in [http://onetransistor.blogspot.com/2015/12/wine-serial-port-linux.html this article] as an example of what worked for that author. While it also worked for this author it may not work for you. Other examples are referenced, if needed.
[[Software_Setup_For_Linux#Windows_Scanner_Applications_Tested_Using_Wine|Select a link to one of the Windows applications above and install.]] Happy scanning. BTW, love that ProScan.
 
  
==Remaining Current and Going Forward==   
+
:3) Save and close the file.
:As of this date, March 2016, Microsoft is up to .NET Framework 4.6.1, Wine 1.8.1 (Stable version). Of course application and wine developers will lag behind. As they catch up it will be important to be running the most current version of wine that your Ubuntu Package Manager has to offer. Doesn't necessarily  have to be the latest WineHQ has stable.
 
  
:Equally important is to stay up to date with the most current version of .NET Framework that Wine and your Ubuntu distribution will handle. As an example today Wine advertises that .NET Framework 4.5.2 has been successfully tested with Ubuntu LTS 14.04. I happen to have been running Ubuntu Non-LTS 15.10 and after starting the .NET FW 4.5.2 Update I received the warning that it wasn't supported by my operating system. So I'll stick with 4.5.
 
  
:These current releases are only updates from either 4.0 or 4.5. When Microsoft releases what will no longer be an update but full release it would be advisable to perform the new installation before any .NET FW is installed above. This page will need to be updated when that occurs.
+
===Select an Application===
  
  
===Wine .NET Framework Version Support Table===
+
[[Software_Setup_For_Linux#Windows_Scanner_Applications_Working_.2F_Worked_Using_Wine|Select a link to one of the Windows applications above and install.]] Happy scanning. BTW, love that ProScan.
  
:https://appdb.winehq.org/objectManager.php?sClass=application&iId=2586
 
  
  

Latest revision as of 10:57, 22 December 2023

Linux Scanner Applications Tested

Uniden

BCProgTool

Cross platform scanner application and the easiest to set up in Linux. No Wine required by Linux.

Radio Shack

None

Windows Scanner Applications Working / Worked Using Wine

The following applications do connect to the scanner and will allow upload and downloads. Additional features may be affected with the use in Wine as noted below.

Uniden - Updated 12/22/2023

ARC-XT-Pro

  1. Slow to authenticate to RR.com. Need to answer no / continue as Ubuntu wants to close it down.
  2. Also receives HTTP timeouts while connecting.

FreeScan

  1. Functions as intended.

ScanControl

  1. Functions as intended. Also compatable with some Radio Shack Models.

ProScan

  1. Doesn't find its User Manual from the toolbar.
  2. Unable to use FTP to connect to SDS series.

Uniden Sentinel

  1. Must change SDS to a floppy disk in order for Sentinel to see it as a mass storage device.

Radio Shack- Worked

PSREdit300

Details on this linked page go back to Ubuntu 8.10, support ending 2010, so it was probably written around then. There is a very good chance it, or other versions of PSREdit work with a current installation of Wine as described below. Last but current release was 2013. This user has no RS scanners to test it with.

Win500

Details on this linked page go back to .NET Framework v1.1 (Year 2003). There is a very good chance it will work with a current installation of Wine as described below, just need someone with the hardware to test it and report back. Last release was 2015 and is current in 2016.

Wine Installation Process - Ubuntu - (Updated 4/9/2016)

Note: Tested on Ubuntu Studio 15.10 & 16.04 Beta 2.

Install Wine 1.6

1) Install Wine 1.6 from your package manager.
Notes:
  • Wine 1.7 isn't available for Willy. During one of the tests got it to load and at that point FreeScan was able to communicate to the RR.DB. Subsequent tests on a clean OS was not able to install Wine 1.7.
  • These applications will not currently run with Wine 1.8. Tests also showed the only way to revert back to 1.6 was to reload the OS. If one wants to test 1.7 or 1.8 it is recommended to do it on a Virtual Machine.

Create a 32-bit Wine Prefix

Run each line below separately to:
1) Delete the directory ~/.wine (if still present from a previous installation) and
2) Create the new 32-bit prefix.
rm ~/.wine

WINEARCH=win32 WINEPREFIX=~/.wine winecfg
3) Close the Wine Configuration window at any time by selecting “OK”.

Prerequisites for .NET Framework 4.5

Create 2 Folders

1) ~/.cache/winetricks/dotnet30/
2) ~/.cache/winetricks/msxml3/

Download and Copy 2 Files

1) Download .NET Framework 3.0 from:
http://www.oldversion.com/windows/download/net-framework-3-0
2) Copy netframework3.exe to ~/.cache/winetricks/dotnet30
3) Download MS XML Parser 3.0 SP 7:
http://download.cnet.com/Microsoft-XML-Parser-MSXML-3-0-Service-Pack-7-SP7/3000-7241_4-10731613.html
4) Copy msxml3.msi to ~/.cache/winetricks/msxml3/

Install .NET Framework 4.5

1) Run:
bash winetricks -q dotnet45 corefonts


Note: Installation take about 35 minutes but your milage may vary

Check the .NET Framework v4.5 Install

1) Download the tool from here:
https://blogs.msdn.microsoft.com/astebner/2008/10/13/net-framework-setup-verification-tool-users-guide/
2) Run the tool:
wine ~/Downloads/netfx_setupverifier_new/netfx_setupverifier.exe
3) In the "Product to Verify" pull down select ".NET Framework 4.5"
4) Press "Verify Now"
5) When complete press "View Log"
  • You should see the following line. If so the hard part is over, good job! Exit the window.
[DATE,TIME] Install state for .NET Framework 4.5: installed with no service packs.

Wine Installation Process - Arch - (Updated 12/22/2023)

Install Wine

1) Enable 32-bit repositories by uncommenting the following two lines in /etc/pacman.conf:
[multilib]
Include = /etc/pacman.d/mirrorlist
2) Update pacman:
# pacman -Syu
3) Install wine, winetricks, and lib32-gnutls (for .NET support):
# pacman -S wine-mono winetricks lib32-gnutls

Create a 32-bit Wine Prefix

Run each line below separately to:
1) Delete the directory ~/.wine and create a new 32-bit prefix:
$ rm -fr ~/.wine
$ WINEARCH=win32 winecfg
3) Close the Wine Configuration window at any time by selecting “OK”.

Install .NET Framework 3.0 SP1

1) Run:
$ winetricks dotnet35sp1

Serial Port Setup

Port Permission

Any applications requiring access to the serial port(s) must have the current user added to the "dialout" user group.
1) Copy and Paste the following in a Terminal window. Replace <Your_User_Name_Here> with your user name:
sudo adduser <Your_User_Name_Here> dialout
2) Logout then back in to complete the user group addition.

Port ID

  • RS-232 connections will be identified as ttyS0-3 and will be assigned to Com 1-4 later.
  • USB / RS-232 Adapters will be identified as ttyUSB0-3 and will be assigned to Com 1-4 later.
PL2303 type adapters work very well on Linux and don't require drivers like Windows.
See details here about about different models available
For the purpose of this testing a TRENDnet TU-S9 was used.


1) Connect Your Scanner to the Computer
2) Copy and Paste the following in a Terminal window to detect your port:
dmesg | grep tty


Example of a RS-232 connection showing that you will be linking ttyS0 to Com1 in the next step:
[    1.058530] 00:06: ttyS0 at I/O 0x3f8 (irq = 4, base_baud = 115200) is a 16550A


Example of a USB to RS-232 connection showing that you will be linking ttyUSB0 to Com1 in the next step:
[32499.503662] usb 9-5: pl2303 converter now attached to ttyUSB0
  • If you have another connected device and either ttyS1 or ttyUSB1 display as your new device you will want to link it to Com2 below instead of Com1. The same holds true when adding it to the registry.
  • Now we can assume you have figured out how to Run a command using "Copy and Paste into a Terminal window".

Create Symbolic Link To The Port

1) For RS-232 Run:
ln -s /dev/ttyS0 ~/.wine/dosdevices/com1
OR
1) For USB to RS-232 Adapter Run:
ln -s /dev/ttyUSB0 ~/.wine/dosdevices/com1
2) Reboot

Adding The Port To The Registry

1) Open the file with:
gedit ~/.wine/system.reg
2) Add the following 2 lines at the beginning of the file right under “#arch=win32”:
[Hardware\\Devicemap\\Serialcomm] 1131331688
"COM1"="COM1"
Note: The above lines were found in this article as an example of what worked for that author. While it also worked for this author it may not work for you. Other examples are referenced, if needed.
3) Save and close the file.


Select an Application

Select a link to one of the Windows applications above and install. Happy scanning. BTW, love that ProScan.