Example MikroBus Rotary on the DEV-IOT6U - Revision history

Btisler: Added login info to this page as well

2020-09-15T15:29:53Z

Added login info to this page as well

Btisler at 20:02, 14 September 2020

2020-09-14T20:02:54Z

Btisler at 18:38, 14 September 2020

2020-09-14T18:38:46Z

Btisler at 18:08, 14 September 2020

2020-09-14T18:08:33Z

Btisler at 17:51, 14 September 2020

2020-09-14T17:51:12Z

Btisler at 17:49, 14 September 2020

2020-09-14T17:49:52Z

Btisler at 17:47, 14 September 2020

2020-09-14T17:47:41Z

Btisler at 17:19, 14 September 2020

2020-09-14T17:19:04Z

Btisler at 17:04, 14 September 2020

2020-09-14T17:04:28Z

Btisler at 16:52, 14 September 2020

2020-09-14T16:52:33Z

@@ Line 33: / Line 33: @@
 *Open a terminal session with the DEV-IOT6U through Minicom
 * Login to the DEV-IOT6U and run command "ifconfig" to retrieve the device's IP Address
 *In a second terminal window, navigate to where the dev-iot6u_mikrobus_demo.c file was saved
 *Run the following commands with the device's IP and SDK version substituted:

← Older revision		Revision as of 20:02, 14 September 2020
Line 58:		Line 58:

	This example is a demonstration of the use of the Mikro Bus on the DEV-IOT6U.		This example is a demonstration of the use of the Mikro Bus on the DEV-IOT6U.
		+
		+	===Related Links===
		+	* [[DEV-IOT6U \| DEV-IOT6U Hardware Main Page]]
		+	* [[Getting_Started_with_the_DEV-IOT6U\|Getting Started with the DEV-IOT6U]]

@@ Line 36: / Line 36: @@
 *Run the following commands with the device's IP and SDK version substituted:
 <syntaxhighlight lang="text">
-source /opt/emac/5.X/environment-setup-armv5e-emac-linux-gnueabi        // update SDK version
+source /opt/emac/5.X/environment-setup-armv5e-emac-linux-gnueabi        // update SDK version (found with "ls /opt/emac")
 $CC dev-iot6u_mikrobus_demo.c -o dev-iot6u_mikrobus_demo -lgpiod
 scp dev-iot6u_mikrobus_demo root@xxx.x.x.xxx:                           // update IP address
@@ Line 52: / Line 52: @@
 ./dev-iot6u_mikrobus_demo
 </syntaxhighlight>
-The MikroBus Rotary dial may then be turned, and with each click, the lights will increment in binary. One side of the card's lights are associated with one of the card's registers, likewise for the other set of lights. </br>
+The MikroBus Rotary dial may then be turned, and with each click, the lights will increment in binary. One side of the card's lights are associated with one of the card's registers, likewise for the other set of lights. The terminal window will also display back the number of "clicks" that have been registered by the card</br></br>
-The MikroBus Rotary B click™ carries a 15-pulse incremental rotary encoder with detents, surrounded by  a  ring  of  16  blue  LEDs.  It  communicates  with  the  target  board  through  mikroBUS™SPI  lines  (CS,  SCK,  MISO,  MOSI),  and  three  additional  lines  for  outputting  the  Encoder  info:  ENCB  OUT,  ENCA  OUT  and  SW  (in  place  of  the  standard  AN,  RST  and  INT  pins,  respectively). Rotary B click™ can be used with either a 3.3V or 5V power supply.
+Whenever the rotary dial is turned, each "click" produces a pulse that is sent through its encoder A (ENC_A) pin and is registered as an event by the program. The demo program tracks the number of clicks received, incrementing a value that is seen in the terminal. The number of ticks is then used as data to control the number of LEDs that are turned on. In the program, the number of clicks goes through a modulus 128 operation before being output as data for the LEDs. The handling of events and assignment of the data are accomplished in the handle_event() function in the demo .c file.
 ==Summary==
 This example is a demonstration of the use of the Mikro Bus on the DEV-IOT6U.

@@ Line 15: / Line 15: @@
 * The DEV-IOT6U Development Kit
 ===Software Requirments===
@@ Line 24: / Line 23: @@
 * GNU <code>make</code>
 * CMake
-* Putty (Windows) or Minicom (Linux/MacOS)
+* Minicom
 === Setup ===
@@ Line 32: / Line 31: @@
 *Open a text editor and copy paste the provided .c file: [http://git.emacinc.com/OE/qt-creator-example-projects/raw/master/mikrobus_iot6u/dev-iot6u_mikrobus_demo.c dev-iot6u_mikrobus_demo.c]
 *Save as "dev-iot6u_mikrobus_demo.c"
-*Open a terminal session with the DEV-IOT6U through your preferred serial monitoring program:
+*Open a terminal session with the DEV-IOT6U through Minicom
 * Login to the DEV-IOT6U and run command "ifconfig" to retrieve the device's IP Address
 *In a second terminal window, navigate to where the dev-iot6u_mikrobus_demo.c file was saved

@@ Line 46: / Line 46: @@
 *Enter the device password: emac_inc
 *The terminal will give a a success message to let you know that the file was securely copied.
-*A "ls" command on the device will show that the executable is there.
+*The "ls" command on the device will show that the executable exists on the device.
 ==Usage and Behavior==

@@ Line 30: / Line 30: @@
 *Follow the setup described in the [[Getting_Started_with_the_DEV-IOT6U|getting started page for the DEV-IOT6U]]
-*Download the dev-iot6u_mikrobus_demo.c
+*Open a text editor and copy paste the provided .c file: dev-iot6u_mikrobus_demo.c
 *Open a terminal session with the DEV-IOT6U through your preferred serial monitoring program:
 ** Putty on Windows https://www.putty.org/
 ** Minicom on Linux/Mac
 * Login to the DEV-IOT6U and run command "ifconfig" to retrieve the device's IP Address
-*In a second terminal window, navigate to where the dev-iot6u_mikrobus_demo.c file was downloaded.
+*In a second terminal window, navigate to where the dev-iot6u_mikrobus_demo.c file was saved
 *Run the following commands with the device's IP substituted:
 <syntaxhighlight lang="text">
@@ Line 56: / Line 57: @@
 The MikroBus Rotary dial may then be turned, and with each click, the lights will increment in binary. One side of the card's lights are associated with one of the card's registers, likewise for the other set of lights. </br>
 The MikroBus Rotary B click™ carries a 15-pulse incremental rotary encoder with detents, surrounded by  a  ring  of  16  blue  LEDs.  It  communicates  with  the  target  board  through  mikroBUS™SPI  lines  (CS,  SCK,  MISO,  MOSI),  and  three  additional  lines  for  outputting  the  Encoder  info:  ENCB  OUT,  ENCA  OUT  and  SW  (in  place  of  the  standard  AN,  RST  and  INT  pins,  respectively). Rotary B click™ can be used with either a 3.3V or 5V power supply.
 ==Summary==
 This example is a demonstration of the use of the Mikro Bus on the DEV-IOT6U.