1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
# Welcome to KuttyPy's documentation
The [kuttyPy (/kʊtipʌɪ/)](https://csparkresearch.in/kuttypyplus) Microcontroller training software allows live manipulation of the registers
in microcontrollers via a connected computer through a Python library or Graphical interface.
The kuttyPy hardware is an ATMEGA32 microcontroller development board developed by the [ExpEYES](http://expeyes.in) project, and is
currently supported. The hardware contains the kuttyPy firmware, but can also be used to run other
programs via its bootloader functionality.
setReg and getReg Python function calls act as debugging and monitoring tools, and combined with Python's visualization
and analytical utilities, this approach has immense pedagogical potential for beginners to the microcontroller world.
```python
from kuttyPy import * #Import the library. also automatically connects to any available kuttypy hardware.
setReg('DDRD',160) #0b10100000 PD7(BLUE LED) and PD5(GREEN LED) made output type
setReg('PORTD',160) # PD5 and PD7 set to HIGH. Both LEDs start glowing
```
!!! info "The KuttyPy ATMEGA32 hardware"
!!! info "And its companion Python software"
!!! tip "Atmega32 Datasheet"
[Download](http://ww1.microchip.com/downloads/en/devicedoc/doc2503.pdf) the datasheet before diving
into learning how to use microcontrollers
---
## What can I use it for?
+ It's an atmega development board with a bootloader supporting the 'arduino' protocol
+ The bootloader also allows real-time manipulation of registers through commmands sent via the serial port.
+ This is done by the associated Python library and companion GUI
+ You can monitor every input
+ Toggle every output
+ Deal with Peripherals such as PWMs and Counters
+ View ADC readings via an analog gauge
+ Scan for sensors connected to the I2C Bus
+ Monitor readings from [sensors](sensors)
+ Compile code to hex with the avr-gcc compiler
+ Upload hex via the built-in uploader
+ Rapidly prototype and debug educational projects. For example, you can verify ADC input values before handing over control to the uploaded hex file which will likely have very limited debugging capabilities.
+ Learn how registers are the key to microcontroller operation, as opposed to the Arduino ecosystem which prefers obfuscation of these details underneath abstraction layers.
## Python library and Graphical utility
The graphical window featured in the cover animation allows exploring the functions of each pin of the hardware live, and also
viewing the corresponding register manipulations executed for each change. This knowledge can then be applied while writing C programs.
The python library has setReg and getReg functions calls to manipulate and read registers, in addition to a host of high level functions
to access sensors, ADC etc.
```python
from kuttyPy import * #Import the library. also automatically connects to any available kuttypy hardware.
setReg('DDRD',160) #0b10100000 PD7(BLUE LED) and PD5(GREEN LED) made output type
setReg('PORTD',160) # PD5 and PD7 set to HIGH. Both LEDs start glowing
```
## Monitor I2C Sensors
You can plug and play a variety of supported I2C sensors such as accelerometers, pressure sensors etc via the I2C pins (PC0:SCL, PC1:SDA).
[Details here](sensors)
Data from a 6 DOF inertial measurement unit MPU6050 shown with beautiful analog gauges. A data logger is also built-in, and
this includes analytical functions to select plot regions and fit against sinusoidal or damped sinusoidal functions for
feature extraction and physics experiments.
!!! info "Everyone loves robots!"
<video controls >
<source src="images/robot.mp4"
type="video/mp4">
Sorry, your browser doesn't support embedded videos.
</video>
## 7 channel voltmeter [ 0-5000mV without analog frontend ]
PA0 - PA7 are ADC enabled pins. The graphical utility allows for their monitoring. This makes it easy to record expected input
values from analog sensors before hard-coding them into C programs. You can also use plotting libraries such as matplotlib to monitor variations.
Hall Sensor|Servo Motor
---|---
 | 
Plug and play various accessories such as this Hall Sensor, & servo motor.
Add custom register blocks, twiddle bits, and observe!
In this demo, the ADC is read by first setting the bits in the ADCSRA(control and status register), then reading back ADCL(8LSB)+ADCH(2MSB), and also checking the new status of ADCSRA after the operation.
## [C Code compilation and uploading](programming/c)
---
The kuttyPy also has standalone operation similar to an Arduino, or any other development board.
You can [compile C code with avr-gcc](programming/c), and upload via avrdude by selecting the 'arduino' bootloader type, and a 38400 BAUD rate. All
this can be easily carried out via pre-configured buttons in the KuttyPy GUI.
!!! tip "Seamless switching between the KuttyPy monitor, and user uploaded hex file."
The KuttyPy monitor code is part of the bootloader. This allows users to upload their own Hex files without losing the training utility features.
This example shows how to skip back and forth to an LED scanning code (which also prints letters to the serial port) written in C and uploaded.
In the animation, after fiddling a little with the PWM controls on the monitor, the 'user app' button is clicked. This triggers the following
* Within a few ten milliseconds the user uploaded hex file starts executing
* The console turns into a serial monitor, and shows any text sent by the user uploaded hex.
The user can switch back to the monitoring utility in a snap!
!!! tip "Persistence of vision display"
A persistence of vision display made with C code! Write text in thin air using 8 LEDs on PORTB.
## Contributions:
+ Special thanks to Georges Khazanadar for Debianizing efforts.
We welcome packaging efforts for other linux distributions.
## Supporting KuttyPy
kuttypy-gui is an open source project. Its ongoing development is made possible thanks to the support by
people purchasing the hardware. We do not yet have a Patreon campaign or equivalent.
---
Developed by Jithin B.P @CSpark Research
|
