embedded_fat/filesystem/
attributes.rs

Help
1/// Indicates whether a directory entry is read-only, a directory, a volume
2/// label, etc.
3#[cfg_attr(feature = "defmt-log", derive(defmt::Format))]
4#[derive(Copy, Clone, PartialOrd, Ord, PartialEq, Eq)]
5pub struct Attributes(pub(crate) u8);
6
7impl Attributes {
8    /// Indicates this file cannot be written.
9    pub const READ_ONLY: u8 = 0x01;
10    /// Indicates the file is hidden.
11    pub const HIDDEN: u8 = 0x02;
12    /// Indicates this is a system file.
13    pub const SYSTEM: u8 = 0x04;
14    /// Indicates this is a volume label.
15    pub const VOLUME: u8 = 0x08;
16    /// Indicates this is a directory.
17    pub const DIRECTORY: u8 = 0x10;
18    /// Indicates this file needs archiving (i.e. has been modified since last
19    /// archived).
20    pub const ARCHIVE: u8 = 0x20;
21    /// This set of flags indicates the file is actually a long file name
22    /// fragment.
23    pub const LFN: u8 = Self::READ_ONLY | Self::HIDDEN | Self::SYSTEM | Self::VOLUME;
24
25    /// Create a `Attributes` value from the `u8` stored in a FAT16/FAT32
26    /// Directory Entry.
27    pub(crate) fn create_from_fat(value: u8) -> Attributes {
28        Attributes(value)
29    }
30
31    pub(crate) fn set_archive(&mut self, flag: bool) {
32        let archive = if flag { 0x20 } else { 0x00 };
33        self.0 |= archive;
34    }
35
36    /// Does this file has the read-only attribute set?
37    pub fn is_read_only(self) -> bool {
38        (self.0 & Self::READ_ONLY) == Self::READ_ONLY
39    }
40
41    /// Does this file has the hidden attribute set?
42    pub fn is_hidden(self) -> bool {
43        (self.0 & Self::HIDDEN) == Self::HIDDEN
44    }
45
46    /// Does this file has the system attribute set?
47    pub fn is_system(self) -> bool {
48        (self.0 & Self::SYSTEM) == Self::SYSTEM
49    }
50
51    /// Does this file has the volume attribute set?
52    pub fn is_volume(self) -> bool {
53        (self.0 & Self::VOLUME) == Self::VOLUME
54    }
55
56    /// Does this entry point at a directory?
57    pub fn is_directory(self) -> bool {
58        (self.0 & Self::DIRECTORY) == Self::DIRECTORY
59    }
60
61    /// Does this need archiving?
62    pub fn is_archive(self) -> bool {
63        (self.0 & Self::ARCHIVE) == Self::ARCHIVE
64    }
65
66    /// Is this a long file name fragment?
67    pub fn is_lfn(self) -> bool {
68        (self.0 & Self::LFN) == Self::LFN
69    }
70}
71
72impl core::fmt::Debug for Attributes {
73    fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
74        if self.is_lfn() {
75            write!(f, "LFN")?;
76        } else {
77            if self.is_directory() {
78                write!(f, "D")?;
79            } else {
80                write!(f, "F")?;
81            }
82            if self.is_read_only() {
83                write!(f, "R")?;
84            }
85            if self.is_hidden() {
86                write!(f, "H")?;
87            }
88            if self.is_system() {
89                write!(f, "S")?;
90            }
91            if self.is_volume() {
92                write!(f, "V")?;
93            }
94            if self.is_archive() {
95                write!(f, "A")?;
96            }
97        }
98        Ok(())
99    }
100}
embedded_fat/filesystem/attributes.rs

embedded_fat/filesystem/
attributes.rs
