Actions

Difference between revisions of "Software Setup For Linux"

From The RadioReference Wiki

 
(38 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)==      
  
===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:
  
===Port ID===
+
:*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 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>
 
  
:2) Reboot
+
===Check the .NET Framework v4.5 Install===
 +
:1) Download the tool from here:
  
===Adding The Port To The Registry===
+
::https://blogs.msdn.microsoft.com/astebner/2008/10/13/net-framework-setup-verification-tool-users-guide/
  
:1) Open the file with:
+
:2) Run the tool:
 
<pre>
 
<pre>
gedit ~/.wine/system.reg
+
wine ~/Downloads/netfx_setupverifier_new/netfx_setupverifier.exe
 
</pre>
 
</pre>
  
:2) Add the following 2 lines at the beginning of the file right under “#arch=win32”:
+
:3) In the "Product to Verify" pull down select ".NET Framework 4.5"
<pre>
 
[Hardware\\Devicemap\\Serialcomm] 1131331688
 
"COM1"="COM1"
 
</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.
+
:4) Press "Verify Now"
  
:3) Save and close the file.
+
:5) When complete press "View Log"
  
==Wine Installation Process==     
+
::*You should see the following line. '''If so the hard part is over, good job!''' Exit the window.
  
:*Using your Package Manager install the latest version of wine. This was tested using v1.6.2 (2016).
+
:::'''[DATE,TIME] Install state for .NET Framework 4.5: installed with no service packs.'''
  
Note- 3/25/16- Below procedure works fine using 1.6.2 then removing after .NET FW4.5 is installed and installing 1.8 later. Found issues again with failing .NET FW 2.0 if you start of with 1.8. Checking 1.7.- RJL
+
==Wine Installation Process - Arch - (Updated 12/22/2023)==     
  
===Add the Wine PPA (Ubuntu)===
+
===Install Wine===
  
:1) Open Software & Updates.
+
:1) Enable 32-bit repositories by uncommenting the following two lines in /etc/pacman.conf:
 +
<pre>
 +
[multilib]
 +
Include = /etc/pacman.d/mirrorlist
 +
</pre>
  
:2) Select the "Other Software Tab", add.
+
:2) Update pacman:
 +
<pre>
 +
# pacman -Syu
 +
</pre>
  
:3) Enter the line below into the "APT line:" field:
+
:3) Install wine, winetricks, and lib32-gnutls (for .NET support):
 
<pre>
 
<pre>
ppa:ubuntu-wine/ppa
+
# pacman -S wine-mono winetricks lib32-gnutls
 
</pre>
 
</pre>
  
:4) Allow system to update.
+
===Create a 32-bit Wine Prefix===
 
 
:5) Open your package manager and install Wine.
 
 
 
===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) When prompted to install a Mono package select "Install".**** MAY BE A BAD THING when using 1.8
+
:3) Close the Wine Configuration window at any time by selecting “OK”.
  
:4) Close the Wine Configuration window at any time by selecting “OK”.
+
===Install .NET Framework 3.0 SP1===
  
:5) When prompted to install a Gecko package select "Install".
+
:1) Run:
 +
<pre>
 +
$ winetricks dotnet35sp1
 +
</pre>
  
:6) Wait for the "Wine Gecko Installer" to complete.
+
==Serial Port Setup==
  
:7) When prompt returns "wine: configuration in '/home/$user/.wine' has been updated" you are finished
+
===Port Permission===
  
===Install Winetricks===
+
:Any applications requiring access to the serial port(s) must have the current user added to the "dialout" user group.
  
:Run each line below separately to:
+
:1) Copy and Paste the following in a Terminal window. Replace <Your_User_Name_Here> with your user name:
:1) Install winetricks and then
 
:2) Make it executable:
 
 
<pre>
 
<pre>
wget http://www.kegel.com/wine/winetricks
+
sudo adduser <Your_User_Name_Here> dialout
 
 
chmod +x winetricks
 
 
</pre>
 
</pre>
  
===Prerequsites for .NET Framework 4.5===
+
:2) Logout then back in to complete the user group addition.
  
:'''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 ID===
  
:1) Using your File Manager create 2 folders:
+
* RS-232 connections will be identified as ttyS0-3 and will be assigned to Com 1-4 later.
  
::~/.cache/winetricks/dotnet30/
+
* USB / RS-232 Adapters will be identified as ttyUSB0-3 and will be assigned to Com 1-4 later.
  
::~/.cache/winetricks/msxml3/
+
::PL2303 type adapters work very well on Linux and don't require drivers like Windows.
  
:2) Download .NET Framework 3.0 from:  
+
::[[Connecting_scanners_via_USB#Generic_USB_to_RS-232_serial_converters|See details here about about different models available]]
  
::http://www.oldversion.com/windows/download/net-framework-3-0
+
::For the purpose of this testing a TRENDnet TU-S9 was used.
  
::Copy netframework3.exe to ~/.cache/winetricks/dotnet30
 
  
:3) Download MS XML Parser 3.0 SP 7 from:
+
:1) Connect Your Scanner to the Computer
  
::http://download.cnet.com/Microsoft-XML-Parser-MSXML-3-0-Service-Pack-7-SP7/3000-7241_4-10731613.html
+
:2) Copy and Paste the following in a Terminal window to detect your port:
 +
<pre>
 +
dmesg | grep tty
 +
</pre>
  
::Copy  msxml3.msi to ~/.cache/winetricks/msxml3/
 
:
 
:
 
  
===Install .NET Framework v4.5:===
+
:Example of a RS-232 connection showing that you will be linking ttyS0 to Com1 in the next step:
 +
<pre>
 +
[    1.058530] 00:06: ttyS0 at I/O 0x3f8 (irq = 4, base_baud = 115200) is a 16550A
 +
</pre>
 +
 
  
:1) Start the install by running:
+
:Example of a USB to RS-232 connection showing that you will be linking ttyUSB0 to Com1 in the next step:
 
<pre>
 
<pre>
bash winetricks -q dotnet45 corefonts
+
[32499.503662] usb 9-5: pl2303 converter now attached to ttyUSB0
 
</pre>
 
</pre>
  
:'''Note:''' The installation takes ~35 minutes but your mileage may vary. Wait until it finishes with a command prompt.
+
:*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.
  
===Check the .NET Framework v4.5 Install===
+
:*Now we can assume you have figured out how to Run a command using "Copy and Paste into a Terminal window".
:1) Download the tool from here:
 
  
::https://blogs.msdn.microsoft.com/astebner/2008/10/13/net-framework-setup-verification-tool-users-guide/
+
===Create Symbolic Link To The Port===
  
:2) Run the tool:
+
:1) For RS-232 Run:  
 
<pre>
 
<pre>
wine ~/Downloads/netfx_setupverifier_new/netfx_setupverifier.exe
+
ln -s /dev/ttyS0 ~/.wine/dosdevices/com1
 
</pre>
 
</pre>
  
:3) In the "Product to Verify" pull down select ".NET Framework 4.5"
+
:::::OR
 +
 
 +
:1) For USB to RS-232 Adapter Run:
 +
<pre>
 +
ln -s /dev/ttyUSB0 ~/.wine/dosdevices/com1
 +
</pre>
  
:4) Press "Verify Now"
+
:2) Reboot
  
:5) When complete press "View Log"
+
===Adding The Port To The Registry===
  
::*You should see the following line. '''If so the hard part is over, good job!''' Exit the window.
+
:1) Open the file with:
 +
<pre>
 +
gedit ~/.wine/system.reg
 +
</pre>
  
:::'''[DATE,TIME] Install state for .NET Framework 4.5: installed with no service packs.'''
+
:2) Add the following 2 lines at the beginning of the file right under “#arch=win32”:
 +
<pre>
 +
[Hardware\\Devicemap\\Serialcomm] 1131331688
 +
"COM1"="COM1"
 +
</pre>
  
::*If not return to step 2 above by deleting the ~/.wine directory and starting over.
+
::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) Save and close the file.
  
  
 
===Select an Application===
 
===Select an Application===
[[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==   
 
: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.
 
 
: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.
 
 
  
===Wine .NET Framework Version Support Table===
 
  
:https://appdb.winehq.org/objectManager.php?sClass=application&iId=2586
+
[[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.
  
  

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.