microcontroller-111 0.1.0__py3-none-any.whl

microcontroller_111/__init__.py

@@ -0,0 +1,4 @@
+from .core import list_files, get_path, read_file, data_dir
+
+__all__ = ["list_files", "get_path", "read_file", "data_dir"]
+__version__ = "0.1.0"

microcontroller_111/core.py

@@ -0,0 +1,25 @@
+from importlib.resources import files
+from pathlib import Path
+
+
+def data_dir() -> Path:
+    """Folder where the bundled .txt files live after install."""
+    return Path(str(files("microcontroller_111") / "data"))
+
+
+def list_files() -> list:
+    """Names of all bundled .txt files."""
+    return sorted(p.name for p in data_dir().iterdir() if p.suffix == ".txt")
+
+
+def get_path(name: str) -> str:
+    """Full filesystem path to one bundled file."""
+    path = data_dir() / name
+    if not path.exists():
+        raise FileNotFoundError(f"{name} not found in {data_dir()}")
+    return str(path)
+
+
+def read_file(name: str) -> str:
+    """Contents of one bundled file."""
+    return Path(get_path(name)).read_text(encoding="utf-8")

microcontroller_111/data/01_8051_Timer_0_1_kHz_Square_Wave.txt

@@ -0,0 +1,24 @@
+#include <reg51.h>
+
+sbit wave = P1^0;          // Output pin for the square wave
+
+void delay_500us(void)
+{
+    TH0 = 0xFE;            // Load count for 500 us
+    TL0 = 0x33;
+    TR0 = 1;               // Start Timer 0
+    while (TF0 == 0);      // Poll until the overflow flag is set
+    TR0 = 0;               // Stop Timer 0
+    TF0 = 0;               // Clear the overflow flag
+}
+
+void main(void)
+{
+    TMOD = 0x01;           // Timer 0, Mode 1 (16-bit timer)
+
+    while (1)
+    {
+        wave = ~wave;      // Toggle P1.0
+        delay_500us();     // Wait half a period
+    }
+}

microcontroller_111/data/02_8051_Timer_1_500_Hz_and_1_kHz_Sequential.txt

@@ -0,0 +1,47 @@
+#include <reg51.h>
+
+sbit wave = P1^0;              // Output pin
+
+void delay_1ms(void)           // Half period for 500 Hz
+{
+    TH1 = 0xFC;
+    TL1 = 0x66;
+    TR1 = 1;                   // Start Timer 1
+    while (TF1 == 0);          // Poll overflow flag
+    TR1 = 0;                   // Stop Timer 1
+    TF1 = 0;                   // Clear flag
+}
+
+void delay_500us(void)         // Half period for 1 kHz
+{
+    TH1 = 0xFE;
+    TL1 = 0x33;
+    TR1 = 1;
+    while (TF1 == 0);
+    TR1 = 0;
+    TF1 = 0;
+}
+
+void main(void)
+{
+    unsigned int i;
+
+    TMOD = 0x10;               // Timer 1, Mode 1 (16-bit)
+
+    while (1)
+    {
+        // 500 Hz for about 1 second (500 cycles = 1000 half periods)
+        for (i = 0; i < 1000; i++)
+        {
+            wave = ~wave;
+            delay_1ms();
+        }
+
+        // 1 kHz for about 1 second (1000 cycles = 2000 half periods)
+        for (i = 0; i < 2000; i++)
+        {
+            wave = ~wave;
+            delay_500us();
+        }
+    }
+}

microcontroller_111/data/03_8051_Hybrid_Waveform_400_Hz_900_Hz.txt

@@ -0,0 +1,46 @@
+#include <reg51.h>
+
+sbit wave = P1^0;              // Output pin
+
+void half_400Hz(void)          // 1.25 ms delay
+{
+    TH0 = 0xFB;
+    TL0 = 0x80;
+    TR0 = 1;                   // Start Timer 0
+    while (TF0 == 0);          // Poll overflow flag
+    TR0 = 0;                   // Stop timer
+    TF0 = 0;                   // Clear flag
+}
+
+void half_900Hz(void)          // 555.6 us delay
+{
+    TH0 = 0xFE;
+    TL0 = 0x00;
+    TR0 = 1;
+    while (TF0 == 0);
+    TR0 = 0;
+    TF0 = 0;
+}
+
+void main(void)
+{
+    unsigned char i;
+
+    TMOD = 0x01;               // Timer 0, Mode 1 (16-bit)
+    wave = 0;                  // Start LOW
+
+    while (1)
+    {
+        for (i = 0; i < 4; i++)    // 2 cycles of 400 Hz
+        {
+            wave = ~wave;
+            half_400Hz();
+        }
+
+        for (i = 0; i < 4; i++)    // 2 cycles of 900 Hz
+        {
+            wave = ~wave;
+            half_900Hz();
+        }
+    }
+}

microcontroller_111/data/04_8051_UART_Transmit_Name.txt

@@ -0,0 +1,45 @@
+#include <reg51.h>
+
+void serial_init(void)
+{
+    TMOD = 0x20;        // Timer 1, Mode 2 (8-bit auto-reload)
+    TH1  = 0xFD;        // 9600 baud at 11.0592 MHz
+    SCON = 0x50;        // Mode 1, 8-bit UART, REN enabled
+    TR1  = 1;           // Start Timer 1
+}
+
+void send_char(unsigned char ch)
+{
+    SBUF = ch;          // Load character into the serial buffer
+    while (TI == 0);    // Wait until transmission completes
+    TI = 0;             // Clear transmit flag
+}
+
+void send_string(unsigned char *str)
+{
+    while (*str != '\0')
+    {
+        send_char(*str);
+        str++;
+    }
+}
+
+void delay(void)
+{
+    unsigned int i, j;
+    for (i = 0; i < 500; i++)
+        for (j = 0; j < 100; j++);
+}
+
+void main(void)
+{
+    serial_init();
+
+    while (1)
+    {
+        send_string("Ishaan Vaidya");
+        send_char('\r');    // Carriage return
+        send_char('\n');    // New line
+        delay();            // Small gap between repeats
+    }
+}

microcontroller_111/data/05_8051_UART_Transmit_Name_and_Roll_Number.txt

@@ -0,0 +1,45 @@
+#include <reg51.h>
+
+void serial_init(void)
+{
+    TMOD = 0x20;        // Timer 1, Mode 2 (8-bit auto-reload)
+    TH1  = 0xFD;        // 9600 baud at 11.0592 MHz
+    SCON = 0x50;        // Mode 1, 8-bit UART, REN enabled
+    TR1  = 1;           // Start Timer 1
+}
+
+void send_char(unsigned char ch)
+{
+    SBUF = ch;          // Load character into the serial buffer
+    while (TI == 0);    // Wait for transmission to complete
+    TI = 0;             // Clear transmit flag
+}
+
+void send_string(unsigned char *str)
+{
+    while (*str != '\0')
+    {
+        send_char(*str);
+        str++;
+    }
+}
+
+void delay(void)
+{
+    unsigned int i, j;
+    for (i = 0; i < 500; i++)
+        for (j = 0; j < 100; j++);
+}
+
+void main(void)
+{
+    serial_init();
+
+    while (1)
+    {
+        send_string("Name: Ishaan Vaidya, Roll No: 2024200134");
+        send_char('\r');    // Carriage return
+        send_char('\n');    // New line
+        delay();            // Gap between repeats
+    }
+}

microcontroller_111/data/06_PIC_Addition_of_Two_8_bit_Numbers.txt

@@ -0,0 +1,17 @@
+PROCESSOR 18F4550
+#include <xc.inc>
+
+PSECT mycode
+
+    MOVLW   025H        ; W = 25H  (first 8-bit value)
+    MOVWF   20H, a      ; store first value at 20H
+
+    MOVLW   037H        ; W = 37H  (second 8-bit value)
+    MOVWF   21H, a      ; store second value at 21H
+
+    MOVF    20H, W, a   ; W = 25H
+    ADDWF   21H, W, a   ; W = 25H + 37H = 5CH
+    MOVWF   22H, a      ; store result at 22H
+
+HERE:
+    GOTO    HERE        ; stay here so the result can be observed

microcontroller_111/data/07_PIC_Subtraction_of_Two_8_bit_Numbers.txt

@@ -0,0 +1,23 @@
+PROCESSOR 18F4550
+#include <xc.inc>
+
+PSECT mycode
+
+    MOVLW   050H        ; W = 50H
+    MOVWF   20H, a      ; first number  A = 50H at 20H
+
+    MOVLW   030H        ; W = 30H
+    MOVWF   21H, a      ; second number B = 30H at 21H
+
+    ; ---- Case 1: A - B = 50H - 30H (no borrow) ----
+    MOVF    21H, W, a   ; W = B = 30H
+    SUBWF   20H, W, a   ; W = A - W = 50H - 30H = 20H
+    MOVWF   22H, a      ; store result at 22H
+
+    ; ---- Case 2: B - A = 30H - 50H (borrow) ----
+    MOVF    20H, W, a   ; W = A = 50H
+    SUBWF   21H, W, a   ; W = B - W = 30H - 50H = E0H
+    MOVWF   23H, a      ; store result at 23H
+
+HERE:
+    GOTO    HERE        ; stay here to observe results

microcontroller_111/data/08_PIC_Block_Data_Transfer.txt

@@ -0,0 +1,33 @@
+PROCESSOR 18F4550
+#include <xc.inc>
+
+PSECT mycode
+
+    ; ---- Step 1: put 5 data bytes in the source block (20H-24H) ----
+    LFSR    0, 020H         ; FSR0 -> 20H
+    MOVLW   011H
+    MOVWF   POSTINC0, a     ; 20H = 11H, FSR0 -> 21H
+    MOVLW   022H
+    MOVWF   POSTINC0, a     ; 21H = 22H
+    MOVLW   033H
+    MOVWF   POSTINC0, a     ; 22H = 33H
+    MOVLW   044H
+    MOVWF   POSTINC0, a     ; 23H = 44H
+    MOVLW   055H
+    MOVWF   POSTINC0, a     ; 24H = 55H
+
+    ; ---- Step 2: set up pointers and counter ----
+    LFSR    0, 020H         ; FSR0 -> source start (20H)
+    LFSR    1, 040H         ; FSR1 -> destination start (40H)
+    MOVLW   5
+    MOVWF   30H, a          ; counter = 5 bytes, kept at 30H
+
+    ; ---- Step 3: copy loop ----
+COPY_LOOP:
+    MOVF    POSTINC0, W, a  ; W = source byte, FSR0++
+    MOVWF   POSTINC1, a     ; destination = W, FSR1++
+    DECFSZ  30H, F, a       ; counter--, skip next if counter = 0
+    BRA     COPY_LOOP       ; repeat until all bytes are copied
+
+HERE:
+    GOTO    HERE

microcontroller_111/data/09_PIC_Timer_Delay_LED_Toggle.txt

@@ -0,0 +1,37 @@
+#include <xc.h>
+
+#define _XTAL_FREQ 20000000UL
+
+/* Timer0 delay of 500 ms
+   Fosc = 20 MHz  ->  Timer clock = Fosc/4 = 5 MHz
+   Prescaler 1:256 -> 1 tick = 256 / 5 MHz = 51.2 us
+   Counts needed  = 500 ms / 51.2 us = 9766
+   Preload value  = 65536 - 9766 = 55770 = 0xD9DA          */
+void Timer0_Delay_500ms(void)
+{
+    TMR0H = 0xD9;               // load high byte first
+    TMR0L = 0xDA;               // then low byte
+    INTCONbits.TMR0IF = 0;      // clear overflow flag
+    T0CONbits.TMR0ON = 1;       // start timer
+
+    while(INTCONbits.TMR0IF == 0);   // wait for overflow
+
+    T0CONbits.TMR0ON = 0;       // stop timer
+    INTCONbits.TMR0IF = 0;      // clear flag
+}
+
+void main(void)
+{
+    ADCON1 = 0x0F;              // make pins digital
+
+    TRISB = 0x00;               // PORTB = output (LEDs)
+    LATB  = 0x00;               // all LEDs OFF
+
+    T0CON = 0x07;               // 16-bit, internal clock, prescaler 1:256, timer OFF
+
+    while(1)
+    {
+        LATBbits.LATB0 = !LATBbits.LATB0;   // toggle LED1 (RB0)
+        Timer0_Delay_500ms();
+    }
+}

microcontroller_111/data/10_PIC_Up_Down_Counter_on_LEDs.txt

@@ -0,0 +1,45 @@
+#include <xc.h>
+
+#define _XTAL_FREQ 20000000UL
+
+unsigned char count = 0;
+
+void main(void)
+{
+    ADCON1 = 0x0F;              // make PORTA/PORTB pins digital
+
+    TRISB = 0x00;               // PORTB = output (LEDs)
+    LATB  = 0x00;               // all LEDs OFF
+
+    TRISAbits.TRISA2 = 1;       // RA2 = input (SW18, UP)
+    TRISAbits.TRISA3 = 1;       // RA3 = input (SW19, DOWN)
+
+    while(1)
+    {
+        // UP button
+        if(PORTAbits.RA2 == 0)
+        {
+            __delay_ms(30);                 // debounce
+            if(PORTAbits.RA2 == 0)
+            {
+                count++;                    // increment count
+                LATB = count;               // show on LEDs
+                while(PORTAbits.RA2 == 0);  // wait for release
+                __delay_ms(30);
+            }
+        }
+
+        // DOWN button
+        if(PORTAbits.RA3 == 0)
+        {
+            __delay_ms(30);                 // debounce
+            if(PORTAbits.RA3 == 0)
+            {
+                count--;                    // decrement count
+                LATB = count;               // show on LEDs
+                while(PORTAbits.RA3 == 0);  // wait for release
+                __delay_ms(30);
+            }
+        }
+    }
+}

microcontroller_111/data/11_PIC_Start_Reset_8_bit_Up_Counter.txt

@@ -0,0 +1,60 @@
+#include <xc.h>
+
+#define _XTAL_FREQ 20000000UL
+
+unsigned char count   = 0;      // 8-bit counter
+unsigned char running = 0;      // 1 = counting, 0 = stopped
+unsigned char ticks   = 0;      // counts 10 ms steps
+
+void main(void)
+{
+    ADCON1 = 0x0F;              // make pins digital
+
+    TRISB = 0x00;               // PORTB = output (LEDs)
+    LATB  = 0x00;               // all LEDs OFF
+
+    TRISAbits.TRISA2 = 1;       // RA2 = input (SW18, START)
+    TRISAbits.TRISA3 = 1;       // RA3 = input (SW19, RESET)
+
+    while(1)
+    {
+        // START button
+        if(PORTAbits.RA2 == 0)
+        {
+            __delay_ms(30);                 // debounce
+            if(PORTAbits.RA2 == 0)
+            {
+                running = 1;                // start counting
+                while(PORTAbits.RA2 == 0);  // wait for release
+            }
+        }
+
+        // RESET button
+        if(PORTAbits.RA3 == 0)
+        {
+            __delay_ms(30);                 // debounce
+            if(PORTAbits.RA3 == 0)
+            {
+                running = 0;                // stop counting
+                count = 0x00;               // reset count
+                ticks = 0;
+                LATB = count;               // LEDs show 00H
+                while(PORTAbits.RA3 == 0);  // wait for release
+            }
+        }
+
+        // Up-counter: increment every 50 x 10 ms = 500 ms
+        if(running == 1)
+        {
+            __delay_ms(10);
+            ticks++;
+
+            if(ticks >= 50)
+            {
+                ticks = 0;
+                count++;                    // 00H -> FFH -> 00H ...
+                LATB = count;               // show count on LEDs
+            }
+        }
+    }
+}

microcontroller_111/data/12_PIC_Shifting_LED_LSB_MSB.txt

@@ -0,0 +1,63 @@
+#include <xc.h>
+
+#define _XTAL_FREQ 20000000UL
+
+// LED moves RB0 -> RB7
+void Shift_LSB_to_MSB(void)
+{
+    unsigned char led = 0x01;           // start at LSB (RB0)
+    for(unsigned char i = 0; i < 8; i++)
+    {
+        LATB = led;                     // only one LED ON
+        __delay_ms(300);
+        led = led << 1;                 // shift left: 01 -> 02 -> 04 ... -> 80
+    }
+    LATB = 0x00;                        // all OFF after shifting
+}
+
+// LED moves RB7 -> RB0
+void Shift_MSB_to_LSB(void)
+{
+    unsigned char led = 0x80;           // start at MSB (RB7)
+    for(unsigned char i = 0; i < 8; i++)
+    {
+        LATB = led;                     // only one LED ON
+        __delay_ms(300);
+        led = led >> 1;                 // shift right: 80 -> 40 -> 20 ... -> 01
+    }
+    LATB = 0x00;                        // all OFF after shifting
+}
+
+void main(void)
+{
+    ADCON1 = 0x0F;                      // make pins digital
+
+    TRISB = 0x00;                       // PORTB = output (LEDs)
+    LATB  = 0x00;
+
+    TRISAbits.TRISA2 = 1;               // RA2 = input (SW18)
+    TRISAbits.TRISA3 = 1;               // RA3 = input (SW19)
+
+    while(1)
+    {
+        if(PORTAbits.RA2 == 0)          // SW18 pressed
+        {
+            __delay_ms(30);             // debounce
+            if(PORTAbits.RA2 == 0)
+            {
+                while(PORTAbits.RA2 == 0);   // wait for release
+                Shift_LSB_to_MSB();
+            }
+        }
+
+        if(PORTAbits.RA3 == 0)          // SW19 pressed
+        {
+            __delay_ms(30);             // debounce
+            if(PORTAbits.RA3 == 0)
+            {
+                while(PORTAbits.RA3 == 0);   // wait for release
+                Shift_MSB_to_LSB();
+            }
+        }
+    }
+}

microcontroller_111/data/13_PIC_LCD_Name_and_Roll_Number.txt

@@ -0,0 +1,67 @@
+#include <xc.h>
+
+#define _XTAL_FREQ 20000000UL
+
+#define LCD_RS LATAbits.LATA0
+#define LCD_E  LATAbits.LATA1
+
+void LCD_Command(unsigned char cmd)
+{
+    LATB = cmd;
+    LCD_RS = 0;                 // RS = 0 -> command
+    LCD_E = 1;
+    __delay_ms(2);
+    LCD_E = 0;                  // high-to-low pulse latches data
+    __delay_ms(2);
+}
+
+void LCD_Data(unsigned char data)
+{
+    LATB = data;
+    LCD_RS = 1;                 // RS = 1 -> data (character)
+    LCD_E = 1;
+    __delay_ms(2);
+    LCD_E = 0;
+    __delay_ms(2);
+}
+
+void LCD_String(const char *str)
+{
+    while(*str != '\0')         // send characters until end of string
+    {
+        LCD_Data(*str);
+        str++;
+    }
+}
+
+void LCD_Start(void)
+{
+    __delay_ms(20);             // LCD power-up delay
+    LCD_Command(0x38);          // 8-bit mode, 2 lines, 5x7 font
+    LCD_Command(0x0C);          // display ON, cursor OFF
+    LCD_Command(0x01);          // clear display
+    __delay_ms(5);
+    LCD_Command(0x06);          // auto-increment cursor
+}
+
+void main(void)
+{
+    ADCON1 = 0x0F;              // make pins digital
+
+    TRISB = 0x00;               // PORTB = LCD data (output)
+    TRISAbits.TRISA0 = 0;       // RA0 = RS (output)
+    TRISAbits.TRISA1 = 0;       // RA1 = E  (output)
+
+    LATA = 0x00;
+    LATB = 0x00;
+
+    LCD_Start();
+
+    LCD_Command(0x80);          // line 1, position 1
+    LCD_String("ISHAAN VAIDYA");
+
+    LCD_Command(0xC0);          // line 2, position 1
+    LCD_String("2024200134");
+
+    while(1);                   // keep display
+}

microcontroller_111/data/14_PIC_LCD_MICROCONTROLLER_LAB_ESE.txt

@@ -0,0 +1,67 @@
+#include <xc.h>
+
+#define _XTAL_FREQ 20000000UL
+
+#define LCD_RS LATAbits.LATA0
+#define LCD_E  LATAbits.LATA1
+
+void LCD_Command(unsigned char cmd)
+{
+    LATB = cmd;
+    LCD_RS = 0;                 // command mode
+    LCD_E = 1;
+    __delay_ms(2);
+    LCD_E = 0;
+    __delay_ms(2);
+}
+
+void LCD_Data(unsigned char data)
+{
+    LATB = data;
+    LCD_RS = 1;                 // data mode
+    LCD_E = 1;
+    __delay_ms(2);
+    LCD_E = 0;
+    __delay_ms(2);
+}
+
+void LCD_String(const char *str)
+{
+    while(*str != '\0')
+    {
+        LCD_Data(*str);
+        str++;
+    }
+}
+
+void LCD_Start(void)
+{
+    __delay_ms(20);
+    LCD_Command(0x38);          // 8-bit, 2 lines
+    LCD_Command(0x0C);          // display ON, cursor OFF
+    LCD_Command(0x01);          // clear display
+    __delay_ms(5);
+    LCD_Command(0x06);          // auto-increment cursor
+}
+
+void main(void)
+{
+    ADCON1 = 0x0F;              // make pins digital
+
+    TRISB = 0x00;               // LCD data
+    TRISAbits.TRISA0 = 0;       // RS
+    TRISAbits.TRISA1 = 0;       // E
+
+    LATA = 0x00;
+    LATB = 0x00;
+
+    LCD_Start();
+
+    LCD_Command(0x80);          // line 1, position 1
+    LCD_String("MICROCONTROLLER");
+
+    LCD_Command(0xC0);          // line 2, position 1
+    LCD_String("LAB ESE");
+
+    while(1);                   // keep display
+}