Difference between revisions of "Getting Started With Minicom"

From wiki.emacinc.com
Jump to: navigation, search
Line 10: Line 10:
 
<!-- /****************************************  Page Description Text  ****************************************/ -->
 
<!-- /****************************************  Page Description Text  ****************************************/ -->
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*********************************************************************************************************/ -->
<!-- <span style="background:#00FF00;color:#FF0000;font-size:300%">'''''Put the page description text here.'''''</span> --?
+
<!-- <span style="background:#00FF00;color:#FF0000;font-size:300%">'''''Put the page description text here.'''''</span>
  
 
__TOC__
 
__TOC__
Line 18: Line 18:
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*********************************************************************************************************/ -->
 
{{:Templateimpl:bg | initials=JJ | title=Getting Started With Minicom | desc=Description for SEO | project=OE 5.0 }}
 
{{:Templateimpl:bg | initials=JJ | title=Getting Started With Minicom | desc=Description for SEO | project=OE 5.0 }}
<code>minicom</code> is a serial communication program that connects to devices through a GNU/Linux PC's serial ports. If run my calling its name without any additional arguments, it uses whatever settings have been saved for its defaults in <code>/etc/minicom/minirc.dfl</code>. For those using a Windows, PuTTY is a great application to make such connections. More information about PuTTY can be found at http://wiki.emacinc.com/wiki/PuTTY.
+
<code>minicom</code> is a serial communication program that connects to devices through a GNU/Linux PC's serial ports. If run by calling its name without any additional arguments, it uses whatever settings have been saved for its defaults in <code>/etc/minicom/minirc.dfl</code>. For those using a Windows, PuTTY is a great application to make such connections between a Windows PC and one of our EMAC devices. More information about PuTTY can be found at http://wiki.emacinc.com/wiki/PuTTY.
  
 
<!-- Pulling a lot of this information from the LifeRay 'Using Minicom' and 'iPac-9x25 Getting Started' pages -->
 
<!-- Pulling a lot of this information from the LifeRay 'Using Minicom' and 'iPac-9x25 Getting Started' pages -->
Line 26: Line 26:
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*********************************************************************************************************/ -->
 
{{:Templateimpl:geninfo | initials=JJ | title=Getting Started With Minicom | desc=Description for SEO | project=OE 5.0 }}
 
{{:Templateimpl:geninfo | initials=JJ | title=Getting Started With Minicom | desc=Description for SEO | project=OE 5.0 }}
The use of <code>minicom</code> is required when connecting to and EMAC board for testing purposes. This pages sets out to provide general information about using <code>minicom</code> as well as a guide to demonstrate using <code>minicom</code> to connect with EMAC devices.
+
The use of <code>minicom</code> is required when connecting to and EMAC board for testing purposes. This pages sets out to provide general information about using <code>minicom</code> as well as a guide to demonstrate using it to connect with EMAC devices.
  
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*********************************************************************************************************/ -->
Line 32: Line 32:
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*********************************************************************************************************/ -->
 
{{:Templateimpl:using | initials=JJ | title=Getting Started With Minicom | desc=Description for SEO | project=OE 5.0 }}
 
{{:Templateimpl:using | initials=JJ | title=Getting Started With Minicom | desc=Description for SEO | project=OE 5.0 }}
Hey!!! Create a nice intro type thing for the procedure.
 
 
<cl>1. If <code>minicom</code> has yet to be installed on your development Linux machine, use <code>apt-get</code> to install the <code>minicom</code> package
 
<cl>1. If <code>minicom</code> has yet to be installed on your development Linux machine, use <code>apt-get</code> to install the <code>minicom</code> package
 
{{clo|indent=1}}
 
{{clo|indent=1}}
Line 40: Line 39:
 
* The <code>minicom</code> settings will need to be changed so that the application will be able to find your device. Pull up the settings using the <code>-s</code> option.
 
* The <code>minicom</code> settings will need to be changed so that the application will be able to find your device. Pull up the settings using the <code>-s</code> option.
 
{{clo|indent=1}}
 
{{clo|indent=1}}
{{clio|minicom -s|hostname=developerpc|username=user}}
+
{{clio|sudo minicom -s|hostname=developerpc|username=user}}
 
{{clos}}
 
{{clos}}
  
 
* The first thing that will need to be configured is the '''Serial port setup'''. Arrow down to the title and press the Enter key.<br/>[Screenshot?]
 
* The first thing that will need to be configured is the '''Serial port setup'''. Arrow down to the title and press the Enter key.<br/>[Screenshot?]
  
* To modify the different configurations, press the key corresponding to the setting. For example, press the 'A' key to modify the '''Serial Device'''. Press the 'Enter' key to save the parameters for the setting. The EMAC devices will require the '''Bps/Par/Bits''', and flow control settings. Set '''Bps/Par/Bits''' to 115200 baud, 8 data bits and no priority. Set both flow control settings to ''''No''''. Press the 'Esc' key to save the settings and to be be brought back to the configurations page.<br /> [definitely use a screenshot here]
+
* To modify the different configurations, press the key corresponding to the setting. For example, press the 'A' key to modify the '''Serial Device'''. Press the 'Enter' key to save the parameters for the setting. The EMAC devices will require the '''Bps/Par/Bits''', and flow control settings. Set '''Bps/Par/Bits''' to 115200 baud, 8 data bits and no priority. Set both flow control settings to ''''No''''. <br /> [[File:Minicomserialport.png| Serial Port Setup for minicom]]
 +
 
 +
If you're likely to use the same serial port when connecting to your device with minicom, modify the '''Serial Device''' setting to have the path to the port. This way, you'll be able to run the command without any options or commands. Press the 'Esc' key to save the settings and to be be brought back to the configurations page
  
 
* The next setting that needs to be configure is the '''Modem and dialing'''. Press the 'A" key and delete its content. Hit the 'Enter' key to save the setting as blank. Do this for B-K, and H. Hit the 'Esc' key when finished deleting the content of these settings. That's all the modifications that need to be done to get <code>minicom</code> set up. Arrow down to '''Exit from Minicom''' and press 'Enter'.
 
* The next setting that needs to be configure is the '''Modem and dialing'''. Press the 'A" key and delete its content. Hit the 'Enter' key to save the setting as blank. Do this for B-K, and H. Hit the 'Esc' key when finished deleting the content of these settings. That's all the modifications that need to be done to get <code>minicom</code> set up. Arrow down to '''Exit from Minicom''' and press 'Enter'.
Line 52: Line 53:
  
 
== Running Minicom ==
 
== Running Minicom ==
Now that everything is configured, let's make the connection to the device. Run the <code>minicom</code> command with the option <code>-D</code> and the path to the device as an argument.
+
Now that everything is configured, let's make the connection to the device.
 +
<cl>1. Run the <code>minicom</code> command with the option <code>-D</code> and the path to the device as an argument.
 
{{clo|indent=1}}
 
{{clo|indent=1}}
 
{{clio|minicom -D /dev/ttyS10|hostname=developerpc|username=user}}
 
{{clio|minicom -D /dev/ttyS10|hostname=developerpc|username=user}}
 
{{clos}}
 
{{clos}}
 +
Using the <code>-o</code> option will allow <code>minicom</code> to make the connection more quickly by not sending AT commands to initialize a modem.
 +
 +
* Log in to the device as the root user
 +
{{clo}}
 +
{{clos}}
 +
</cl>
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*********************************************************************************************************/ -->
 
<!-- /*****************************************      Examples        *****************************************/ -->
 
<!-- /*****************************************      Examples        *****************************************/ -->

Revision as of 18:01, 2 November 2015

TODO: {{#todo: InProgress (10.28.2015-16:36->JJ+)|Jeffrey Jung|OE 5.0,InProgress,JJ,MD}}

Background

minicom is a serial communication program that connects to devices through a GNU/Linux PC's serial ports. If run by calling its name without any additional arguments, it uses whatever settings have been saved for its defaults in /etc/minicom/minirc.dfl. For those using a Windows, PuTTY is a great application to make such connections between a Windows PC and one of our EMAC devices. More information about PuTTY can be found at http://wiki.emacinc.com/wiki/PuTTY.


General Information

The use of minicom is required when connecting to and EMAC board for testing purposes. This pages sets out to provide general information about using minicom as well as a guide to demonstrate using it to connect with EMAC devices.

Getting Started With Minicom

  1. If minicom has yet to be installed on your development Linux machine, use apt-get to install the minicom package

    user@developerpc:~# sudo apt-get install minicom
  2. The minicom settings will need to be changed so that the application will be able to find your device. Pull up the settings using the -s option.

    user@developerpc:~# sudo minicom -s
  3. The first thing that will need to be configured is the Serial port setup. Arrow down to the title and press the Enter key.
    [Screenshot?]

  4. To modify the different configurations, press the key corresponding to the setting. For example, press the 'A' key to modify the Serial Device. Press the 'Enter' key to save the parameters for the setting. The EMAC devices will require the Bps/Par/Bits, and flow control settings. Set Bps/Par/Bits to 115200 baud, 8 data bits and no priority. Set both flow control settings to 'No'.
    Serial Port Setup for minicom

    If you're likely to use the same serial port when connecting to your device with minicom, modify the Serial Device setting to have the path to the port. This way, you'll be able to run the command without any options or commands. Press the 'Esc' key to save the settings and to be be brought back to the configurations page

  5. The next setting that needs to be configure is the Modem and dialing. Press the 'A" key and delete its content. Hit the 'Enter' key to save the setting as blank. Do this for B-K, and H. Hit the 'Esc' key when finished deleting the content of these settings. That's all the modifications that need to be done to get minicom set up. Arrow down to Exit from Minicom and press 'Enter'.


Running Minicom

Now that everything is configured, let's make the connection to the device.

  1. Run the minicom command with the option -D and the path to the device as an argument.

    user@developerpc:~# minicom -D /dev/ttyS10

    Using the -o option will allow minicom to make the connection more quickly by not sending AT commands to initialize a modem.

  2. Log in to the device as the root user

Examples

Conclusion

Further Information

Where to Go Next
Pages with Related Content