eadkp 0.20.0

Rust library for developing applications for NumWorks calculators running Epsilon OS. Provides low-level hardware interaction and high-level abstractions for display, input, battery, storage, and more.
Documentation 
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

#![cfg_attr(target_os = "none", no_std)]

/*!
# eadkp
A Rust library to facilitate the development of external applications for NumWorks Epsilon (features and abstractions). 

## More information

For more information, visit the [eadkp repository on GitHub](https://github.com/Oignontom8283/eadkp).
*/

extern crate alloc;

#[macro_use]
pub mod r#macro;

mod color;
mod image;
pub mod backlight;
pub mod utils;
pub mod display;
pub mod timing;
pub mod random;
pub mod battery;
pub mod input;
pub mod storage;
pub mod epsilon;
mod errors;

// Module builder uniquement disponible pour les build scripts (OS hôte, pas embarqué)
#[cfg(all(not(target_os = "none"), feature = "build-tools"))]
pub mod builder;

// Réexportations du contenu des modules
pub use utils::*;
pub use color::*;
pub use image::*;
pub use errors::*;
// Note: Le panic handler et l'allocateur global sont définis par la macro eadkp_setup!
// L'application n'a pas besoin de les définir manuellement



// ~~   Déclarations des symboles de début et de fin du heap, définis dans le script de linkage   ~~
// En gros, le début des trucs compliqués, mais obligatoire sinon, bah ça marche pas.

unsafe extern "C" {
    pub static mut _heap_start: u8;
    pub static mut _heap_end: u8;
}

pub static mut HEAP_START: *mut u8 = core::ptr::addr_of_mut!(_heap_start);
pub static mut HEAP_END: *mut u8 = core::ptr::addr_of_mut!(_heap_end);

pub fn heap_size() -> usize {
    (unsafe { HEAP_END.offset_from(HEAP_START) }) as usize
}

// Stub requis par l'ARM EABI pour le unwinding de pile (inutilisé en no_std)
#[cfg(target_os = "none")]
#[unsafe(no_mangle)]
pub unsafe extern "C" fn __aeabi_unwind_cpp_pr0() {}

// Désactive les interruptions et retourne l'état précédent (section critique)
#[cfg(target_os = "none")]
#[unsafe(no_mangle)]
pub unsafe extern "C" fn _critical_section_1_0_acquire() -> u8 {
    let primask: u32;
    
    unsafe {
        core::arch::asm!(
            "mrs {}, PRIMASK",  // Lire l'état actuel des interruptions (0=activées, 1=désactivées)
            "cpsid i",          // Désactiver les interruptions
            out(reg) primask,
            options(nomem, nostack, preserves_flags)
        );
    }
    
    primask as u8  // Retourner l'état pour restauration ultérieure
}

// Restaure l'état des interruptions à partir du token (fin de section critique)
#[cfg(target_os = "none")]
#[unsafe(no_mangle)]
pub unsafe extern "C" fn _critical_section_1_0_release(token: u8) {
    if token & 1 == 0 {  // Si les interruptions étaient activées avant
        unsafe {
            core::arch::asm!(
                "cpsie i",  // Réactiver les interruptions
                options(nomem, nostack, preserves_flags)
            );
        }
    }
    // Sinon ne rien faire (les interruptions restent désactivées)
}