IO Properties

Introduction

Most embedded components will require some form of connection to the real world. This is usually done via the standard input/output pins of the microcontroller.

You could simply use Input and Output flowchart icons to do this but this fixes the functionality to specific pins.

To allow the pin connections to be changed by the user we need a way to dereference the input/output commands from the pin connections.

This topic will deal with creating properties to allow your component macro code to interact with the microcontroller pins as specified by the user of the component.

Single Digital Pin

The first type of pin connection we will look at is a single digital pin, this can be used for input or output purposes and is the most common type of pin connection.

Creating a property

First click on a blank area of the 2D or 3D panels to select the root "Panel" object. You can also use the drop down menu at the top of the Properties window.

Open up the properties window and click the drop down arrow next to the Properties item in the window.

Select Add New from the menu.

Give the property a cosmetic name, we have used Pin Connection

Select single digital pin from the drop down list

Give the property a property variable, we have used Pin

Next click the drop down arrow next to the cosmetic name.

Enter a detailed description of what the pin will be used for.

This defines the property tooltip that is shown to inform the user the purpose of the property.

Click OK and OK again to close the Detailed Description and Edit Property windows.

You should now have a new pin connection available on the properties window complete with tooltip.

Referencing the property

To reference the property simply use the variable name inside a calculation icon.

To output a logic low to the pin connection simply use an equals character to assign the value 0 to the pin.

To output a logic high to the pin connection simply use an equals character to assign 1 to the pin.

To read the logic level of an input voltage connected to the pin simply use an equals character to assign the pin to a variable.

Digital Port Byte

The next type of pin connection we will look at is a digital port byte, this can be used for input or output purposes and allows 8 pins from the same port byte to be utilized in a single command.

Creating a property

First click on a blank area of the 2D or 3D panels to select the root "Panel" object. You can also use the drop down menu at the top of the Properties window.

Open up the properties window and click the drop down arrow next to the Properties item in the window.

Select Add New from the menu.

Give the property a cosmetic name, we have used Port Connection

Select digital port byte from the drop down list

Give the property a property variable, we have used Port

Next click the drop down arrow next to the cosmetic name.

Enter a detailed description of what the port will be used for.

This defines the property tooltip that is shown to inform the user the purpose of the property.

Click OK and OK again to close the Detailed Description and Edit Property windows.

You should now have a new port connection available on the properties window complete with tooltip.

Referencing the property

To reference the property simply use the variable name inside a calculation icon.

To output a logic low to the port pins simply use an equals character to assign the value 0 to the port.

To output a logic high to the port pins simply use an equals character to assign 255 to the port.

To read the logic level of an input voltage connected to the port pins simply use an equals character to assign the port to a variable.