Crate sevseg_3642bs

Driver crate for the 3642BS 4 digit 7 segment display

[Datasheet link]

How to use

Create a new display object by calling .new() and passing the GPIO pins the display is connected to. It is necessary for your HAL to use embedded_hal::digital::v2::OutputPin

let mut display = SevenSeg::new(
pins.gpio16.into_push_pull_output(), // Segment A
pins.gpio17.into_push_pull_output(), // Segment B
pins.gpio18.into_push_pull_output(), // Segment C
pins.gpio19.into_push_pull_output(), // Segment D
pins.gpio20.into_push_pull_output(), // Segment E
pins.gpio21.into_push_pull_output(), // Segment F
pins.gpio22.into_push_pull_output(), // Segment G

pins.gpio26.into_push_pull_output(), // Dots segment

pins.gpio15.into_push_pull_output(), // Digit 0 common anode
pins.gpio14.into_push_pull_output(), // Digit 1 common anode
pins.gpio13.into_push_pull_output(), // Digit 2 common anode
pins.gpio12.into_push_pull_output(), // Digit 3 common anode

delay // Your HAL's delay object 
);

Once the display has been defined, the other methods can be called, for example:

display.clear().unwrap();
display.number(1234).unwrap();
display.hex(0xAB12).unwrap();

.number(), .hex() and .time() Will return a DisplayErr result which can be matched:

if let Err(err) = display.time(13, 37) {
    match err {
        DisplayErr::PinFail => info!("Failed to write to a pin!");
        DisplayErr::OutOfRange => info!("One of the numbers is too large!")
    }
}

You can make your own custom charcaters by specifying which segments should turn on on a bitwise or operation:

let letter_c = SEG_A | SEG_F | SEG_E | SEG_D;
let letter_o = SEG_G | SEG_C | SEG_D | SEG_E;
let letter_l = SEG_F | SEG_E | SEG_D;

(The segment names are indicated on the datasheet)

.custom() takes an array with 4 values, each corresponding to one digit. The following example demonstrates how to write CooL to the display:

let text_cool = [letter_c, letter_o, letter_o, letter_l];
display.custom(text_cool).unwrap();

Structs

• Display
  To use the display you’ll need to pass the microcontroller’s pins and the delay object in your HAL.

Enums

• DisplayErr
  Error type returned by the .number(), .hex() and .time() methods

Constants

• SEG_A
  Will turn on the segment A when used in .custom(). Can be used in combination with other segment constants combining them with the or ( | ) operator
• SEG_B
  Will turn on the segment B when used in .custom(). Can be used in combination with other segment constants combining them with the or ( | ) operator
• SEG_C
  Will turn on the segment C when used in .custom(). Can be used in combination with other segment constants combining them with the or ( | ) operator
• SEG_D
  Will turn on the segment D when used in .custom(). Can be used in combination with other segment constants combining them with the or ( | ) operator
• SEG_E
  Will turn on the segment E when used in .custom(). Can be used in combination with other segment constants combining them with the or ( | ) operator
• SEG_F
  Will turn on the segment F when used in .custom(). Can be used in combination with other segment constants combining them with the or ( | ) operator
• SEG_G
  Will turn on the segment G when used in .custom(). Can be used in combination with other segment constants combining them with the or ( | ) operator
• SEG_SD
  Will turn on the two dots when used in .custom(). Can be used in combination with other segment constants combining them with the or ( | ) operator. Note that only one of the common anodes connects to the two dots.