NOTICE: The Processors Wiki will End-of-Life in December of 2020. It is recommended to download any files or other content you may need that are hosted on processors.wiki.ti.com. The site is now set to read only.
Pin Setup Tool for AM18xx ARM Microprocessors
Return to the Sitara Linux Software Developer's Guide
- 1 Introduction
- 2 Software Installation
- 3 Starting the PinSetup Program
- 4 Using the PinSetup Program
- 4.1 Main Window Features
- 4.1.1 Device Selecter Radio Buttons
- 4.1.2 Registers Display
- 4.1.3 Clear All Button
- 4.1.4 Close Button
- 4.1.5 Details Grid
- 4.2 Menu Items
- 4.1 Main Window Features
The Pin Setup Tool for AM18xx ARM Microprocessors is a Windows-based software tool for configuring pin
multiplexing settings for the AM1802, AM1806, AM1808 and AM1810 devices.
Pin Setup provides a graphical user interface for selecting the peripherals that will be used in the system design
and for resolving pin multiplexing conflicts. Results are saved as a C header file that includes a list of all selected
signals and settings for the pin mux registers.
The Pin Setup program is a Windows application. It can be obtained from:
1. Download ZIP archive containing the executable and associated data from here Pin Setup for AM18xx. This is most frequently updated.
To install, simply unzip this archive to any directory on a PC running the Windows OS. For this document, we have unzipped this
to a directory named C:\PinSetup.
2. If the above link does not work, you can obtain the same ZIP archive on www.ti.com on any of the AM18xx product pages in the Application Notes
section. Look for "AM18xx Pin Muxing Utility".
3. The program is installed on your Ubuntu Linux host when an AM18x SDK is installed. Copy the entire directory structure from your Ubuntu Linux host
to a PC running the Windows O/S (which could be the same PC if you are running a virtual Linux machine under the Windows O/S). You would need
to transfer the directory structure by copying it under a virtual machine shared folder or by using a Samba server.
Copy the entire directory structure at the location below to any directory on the Windows side (suggest: C:\PinSetup\*.*).
4. Running in Linux with wine (tested on Ubuntu 10.04 LTS with wine 1.2.2 and Windows mono 2.10.8):
Install the *Windows* version of mono by downloading and running the installer with wine.
Add C:\Program Files\Mono-VERSION\bin to your wine/windows by editing the registry key 'HKEY_CURRENT_USER/Environment/PATH'. This can be done by running
Run the pin setup utility through wine with windows mono by running:
wine mono Pin_Setup_AM18XX/bin/PinSetup.exe
Starting the PinSetup Program
To start running Pin Setup, open the bin subdirectory and run the program named PinSetup.exe.
Using the PinSetup Program
Main Window Features
Device Selecter Radio Buttons
The device selecter initially shows nothing selected (it defaults to AM1808 / AM1810). AM1808 and
AM1810 have the same pin muxing options and represent the superset device which uses all peripherals
in the peripheral check box area. If AM1806 or AM1802 is selected, the peripheral check boxes that do
not apply will be greyed out. Also, the signals in the details grid that are associated with the unavailable
peripherals will have a grey background and will not be selectable. If there are unsaved pin mux selections,
they can be saved using the File - Save - Pin Selections menu item before clicking a Device Selecter
The registers display is specific to the pin mux architecture of the AM18xx (and similar) devices. There
are 20 pin mux registers. Each register is 32-bits wide and programs the signal selection for 8 device
balls. Each device ball in the details grid has up to 5 different multiplexed signals and controls one nibble
of the registers display. The signal selection is programmed with a 4-bit code as shown in the table below.
|Pin Mux Selection||Mux1||Mux2||Mux3||Mux4||Mux5|
Clear All Button
The Clear All Button clears all pin mux selections that have been made. Use File - Save - Pin Selections
before doing this to save work, if neccessary. All pin mux registers will be set to zero, and all device balls
in the details grid will indicate disabled.
The Close Button exits the program. This can also be done using the File - Exit menu item, or by double-
clicking the title bar icon, or by clicking the title bar X icon. Unsaved work must be saved first using the
File - Save - Pin Selections menu item.
Each row of the details grid represents a programmable device ball. Device balls that only have a single
signal definition are not shown in the tool. Each device ball has up to 5 selectable signal definitions
shown in the Mux1 - Mux5 columns. The status column indicates "Enabled" if a signal is selected,
"Disabled" if no signal is selected or "Conflict" if a previously selected signal was unselected due
to a conflict (conflicts are shown with a red background). The details grid view can be scrolled up and
down using the vertical scrollbar.
Enable Collision Warnings
If Enable Collision Warnings is checked, a collision warning dialog box will open each time a signal
selection is attempted and another signal in the same row of the details grid is already selected. The option is given to
either not select the new signal or to unselect the existing signal and select the new signal. In the
later case, the newly selected signal changes to green (selected) and the previously selected signal
changes to red (conflict) and the status column indicates "Conflict".
If Enable Collision Warnings is not checked, the collision warning dialog box does not appear. When the program
attempts to select new signals, the selection will only occur if there is no conflict.
Changing Pin Mux Selections
Pin Mux selections and unselections can be made in several ways.
Using Peripheral Check Boxes
The peripheral check boxes are used to select or unselect a group of signals that comprise a peripheral interface.
When a peripheral is checked, the program attempts to select all member signals of the interface.
When a peripheral is unchecked, the program unselects all member signals of the interface.
Double-Clicking Individual Cells
An individual signal in the details grid can be selected or unselected by double-clicking its cell.
Using the Context Menu
The details grid contains a context menu with the menu items shown below. Click on a cell first, to select it,
before using the context menu.
|Context Menu Item||Function|
|Select Pin||Selects the signal|
|Unselect Pin||Unselects the signal|
|Clear Collision||Removes collision status and red background.|
|Find...||Open signal finder dialog box|
|Clear All||Clears all pin mux selections|
As an example of conflict resolution, first select the SPI0 peripheral, then the UART0 peripheral. A collision dialog box appears
indicating a conflict. The decision to select the new signal or not can be made on a signal-by-signal basis or you can click
Yes to All or No to All.
If Yes to All is selected, the UART0 signals will get selected as shown below. Note that the PINMUX3 register is selecting Mux2
for the UART0 signals. The conflicting SPI0 signals are no longer selected but are shown in red to indicate that a conflict occurred there.
If No to All is selected, the UART0 signals do not get selected and no change is made as shown below. Note that the
PINMUX3 register is selecting Mux1 for the SPI0 signals.
File - Save - Header File
The File - Save - Header File manu item saves a list of the selected signals and #define constants
for the Pin Mux register values. The default location is the My Documents folder. A file save dialog
allows you to specifiy where to save the header file and to give the file a name.
File - Save - Pin Selections
The File - Save - Pin Selections menu item is used to save your work. The saved file can be read in
using the File - Load - Pin File menu item. This file contains a list of all currently selected signals.
saves the list of the selected signals and #define constants. Save your work before exiting the
program, changing the device selecter radio buttons or clicking the Clear All button.
File - Load - Pin File
The File - Load - Pin File loads a file that was saved using the File - Save Pin Selections menu item.
File - Exit
The File - Exit menu item closes the program. Program can also be closed by double-clicking the title bar icon at
in upper left corner or by clicking the X icon. Save work using the File - Save - Pin Selections before exiting the
Edit - Find
The Edit - Find menu item open the Find Pin dialog. A signal name is entered. A asterisk "*" may be used
as a wild card character. The is the option to search for the matching signal(s) or to select or unselect the
Below is the result of searching for the RMII* signals.
Help - About
The Help - About menu item displays the program version information.