---
title: "Message queue in Rust"
canonical_url: https://developer.repebble.com/pebbleos/docs/samples/rust/kernel/msgq/
last_updated: 2026-11-18
sdk_version: 4.44
---
# Message queue in Rust

Source: https://developer.repebble.com/pebbleos/docs/samples/rust/kernel/msgq/

The [message queue sample](https://developer.repebble.com/pebbleos/docs/samples/kernel/msgq.md) written in [Rust](https://developer.repebble.com/pebbleos/docs/development/build_system/rust.md), on the `pebbleos` crate.

`MsgQueue<T, N>` holds `N` messages of type `T`, any `Copy` type, which `put()` and `get()` copy in and out.

Run:

`pbl samples samples/rust/kernel/msgq`

Boards:

every board

## Sources

src/lib.rs

```
#![no\_std]use core::time::Duration;use pebbleos::msgq::MsgQueue;use pebbleos::thread::{self, Priority, Thread};use pebbleos::time::Timeout;use pebbleos::{Errno, Result, println};const NUM\_SAMPLES: u32 = 5;#[derive(Clone, Copy)]struct Sample {seq: u32,value: i32,}// Messages are copied in and out, so the queue owns all the storage it needs.static SAMPLES: MsgQueue\<Sample, 2\> = MsgQueue::new();static PRODUCER: Thread = Thread::new();fn produce() {for seq in 0..NUM\_SAMPLES {let sample = Sample {seq,value: seq as i32 \* 10,};// Blocks while the queue is full: a slow consumer slows the producer// down.if let Err(e) = SAMPLES.put(sample, Timeout::FOREVER) {println!("producer: put failed ({e})");return;}}}fn consume() -\> Result\<()\> {let mut received = 0;loop {match SAMPLES.get(Duration::from\_millis(100)) {Ok(sample) =\> {println!("consumer: sample {} = {}", sample.seq, sample.value);received += 1;}Err(Errno::EAGAIN) =\> break,Err(e) =\> return Err(e),}}println!("consumer: no sample for 100 ms, {received} received");if received == NUM\_SAMPLES {Ok(())} else {Err(Errno::EIO)}}fn jump\_the\_queue() -\> Result\<()\> {let routine = Sample { seq: 100, value: 0 };let urgent = Sample { seq: 999, value: 0 };SAMPLES.put(routine, Timeout::NO\_WAIT)?;SAMPLES.put\_front(urgent, Timeout::NO\_WAIT)?;// The queue is full: without waiting, a third message is refused.let ret = SAMPLES.put(routine, Timeout::NO\_WAIT);println!("main: put on a full queue returns {ret:?}");let sample = SAMPLES.get(Timeout::NO\_WAIT)?;println!("main: sample {} was put last and comes out first",sample.seq);SAMPLES.purge();Ok(())}#[pebbleos::main]fn main() -\> Result\<()\> {PRODUCER.spawn(c"producer", Priority::MAIN.lower(1), produce)?;// Let the producer run until the queue stops it.thread::sleep(Duration::from\_millis(50));println!("main: producer is blocked with {} of {} samples queued",SAMPLES.len(),NUM\_SAMPLES);let sample = SAMPLES.peek()?;println!("main: sample {} is next, and still queued", sample.seq);consume()?;jump\_the\_queue()?;println!("Sample done");Ok(())}
```

## Output

```
main: producer is blocked with 2 of 5 samples queued
main: sample 0 is next, and still queued
consumer: sample 0 = 0
consumer: sample 1 = 10
consumer: sample 2 = 20
consumer: sample 3 = 30
consumer: sample 4 = 40
consumer: no sample for 100 ms, 5 received
main: put on a full queue returns Err\(EBUSY\)
main: sample 999 was put last and comes out first
Sample done
```

Generated from PebbleOS [7753e801d](https://github.com/coredevices/pebbleos/commit/7753e801d93d20f2d37534ce2fa69d9952015237). This page is maintained in the pebbleos repository: [docs/samples/rust/kernel/msgq.md](https://github.com/coredevices/pebbleos/blob/7753e801d93d20f2d37534ce2fa69d9952015237/docs/samples/rust/kernel/msgq.md).
