===== Troubleshooting =====
Below are some (hopefully) helpful bits of information to help get things going with 10LC and help with some common issues.

==== Missing .NET Framework ====
The 10LC compiler requires that .NET Framework version 4.6.1 or greater be installed.  If you get an error message about 4.6.1 being required, you can [[https://dotnet.microsoft.com/download/dotnet-framework/net461 |download the installers from Microsoft]] if you need to install it on your system.

==== Exceptions Saving Files ====
After 10LC compiles a source file, it tries to place the generated MRec file in the same location, just with a different extension.  10LC needs to be able to write to this location and will emit an exception if it is unable to write or save the MRec file.  Currently, there is no way to generate the MRec file in a user-specified location.



==== Serial Port Adapters ====
If you need to use a USB serial port adapter because your PC does not have a serial port, I can recommend two of them that I purchased from Amazon and personally tested.  **//Full disclosure - the links below are affiliate links to the products//** - if I am gonna personally recommend them, why not get something for it if I can?  

First is a **DTECH** adapter that uses an FTDI chipset.  The second is a **Gearmo** adapter that also uses a FTDI chipset.  One is being used with my desktop for development of 10LC with a 9010A unit on my desk, the other is used with my laptop for testing scripts on actual arcade hardware with a 9010A unit.

Both adapters work great set at 9600 baud, N81, with everything else in the driver set to the defaults.

[[https://amzn.to/3bZenyP | DTECH 10 Feet USB 2.0 to RS232 DB9 Serial Port Adapter Cable with FTDI Chipset Supports Windows 10 8 7 and Mac Linux]] 

[[https://amzn.to/2PfyfnG | Gearmo USB to Serial Adapter RS232 with LED Indicators Windows 10, 8, 7, Vista, XP, 2000 Support]]

=== Serial Errors on the 9010A ===
If you are getting errors (like Framing errors) on the 9010A unit when trying to transmit/upload to it, try adjusting the serial driver settings a bit.  One thing you can do is slow down the overall performance of the serial adapter.  Go to Device Manager, find the **USB Serial Port** device, raise its **Properties**, select the **Port Settings** tab, and click the **Advanced...** button.

On the dialog that comes up, change both the ''Receive (bytes)'' and ''Transmit (bytes)'' sizes to ''64'', and the ''Latency Timer (msec)'' to ''30''.  That helped me with one system that just could not talk to the 9010A correctly.