BOSSAC(1)

💖 BOSSAC(1) — the bossa girlie manual 💖

okay so bestie, welcome to the bossac manual page, straight out of the BOSSA manual, no cap 🫶

---

✨ NAME ✨

bossac — command line programmer for Atmel SAM ARM microcontrollers 🦋

---

🌸 SYNOPSIS 🌸

bossac [OPTIONS] [FILE]

---

👑 DESCRIPTION 👑

so, BOSSA — that's the Basic Open Source SAM-BA Application — is a flash programmer for Atmel SAM microcontrollers. iconic, i know 💅

this is the command line interface for writing binary images to the target microcontroller's FLASH or ROM over a USB or serial connection. that's the main character job, fr fr.

secondarily (like, side quest energy) bossac may be used to dump binary data that's already chillin' on the target microcontroller, or to display diagnostic information about the device. 🌈

---

🎀 OPTIONS 🎀

• -e, --erase — erase the target's entire flash memory before doing any read or write operations. like a full reset of the vibe 💀
• -w, --write — write FILE to the target's flash memory. this operation can be expedited immensely if you use it in conjunction with the --erase option. dynamic duo behavior ✨
• -r, --read[=SIZE] — read SIZE bytes from the target's flash memory and store the contents in FILE. if SIZE isn't specified, the entire contents on the target's flash memory will subsequently be read and written to disk. give it nothing and it takes everything, periodt 🍓
• -v, --verify — verify that FILE matches the contents of flash on the target, or vice-versa if you prefer. both directions are valid, she's flexible 💅
• -p, --port[=PORT] — use the serial port PORT to communicate with the device. by default this program will automatically scan all serial ports looking for a supported device. she'll go find her own friends 🦋
• -b, --boot[=BOOL] — boot from ROM if BOOL is 0. boot from FLASH if BOOL is 1. (the latter is default.) this option is completely disregarded on unsupported devices. sorry bestie, no effect there 😭
• -c, --bod[=BOOL] — disable brownout detection if BOOL is 0. enable brownout detection if BOOL is 1. (the latter is default.) 🧚
• -t, --bor[=BOOL] — disable brownout reset if BOOL is 0. enable brownout reset if BOOL is 1. (the latter is default.) 🧚
• -l, --lock[=REGION] — lock the flash region REGION. multiple regions may be specified as a comma-separated list. all regions will be locked if no REGION is given (default). lock her down 🔒
• -u, --unlock[=REGION] — unlock the flash region REGION. multiple regions may be specified as a comma-separated list. all regions will be unlocked if no REGION is given (default). freedom era ✨
• -s, --security — set the flash security flag. 🛡️
• -U, --force_usb_port[=BOOL] — enable automatic detection of the target's USB port if BOOL is false. disable USB port autodetection if BOOL is true. (the former is default.) 🙈
• -R, --reset — reset the CPU after writing FILE to the target. this option is completely disregarded on unsupported devices. 💀
• -i, --info — display diagnostic information identifying the target device. get to know her 👀
• -d, --debug — print verbose diagnostic messages for debug purposes. yapper mode activated 🗣️
• -h, --help — display short command line help information. 🫶

---

🔥 EXAMPLES 🔥

bossac -e -w -v -b image.bin                              # Erase FLASH,
write image.bin to FLASH, verify the write, and set boot from FLASH
bossac --port=ttyACM0 -U false -e -w -v -b -R image.bin   # Do the same
thing as the previous example, except forceably write to the device
connected to ttyACM0 and reset the CPU after verifying the write
bossac -r0x10000 image.bin                                # Read 64KB
from FLASH on the target device, then write it out to image.bin on your
hard disk

like, erase FLASH, write image.bin to FLASH, verify the write, and set boot from FLASH — all in one line. ate and left no crumbs 👑

---

💜 AUTHOR 💜

this manual page was written by Karl Lenz <xorangekiller@gmail.com> for the Debian project (but may be used by others). shoutout to him 🫶

---

🌈 COPYRIGHT 🌈

Copyright (c) 2011-2013 ShumaTech <http://www.shumatech.com>

copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

Bossac is provided "as is" with no warranty. this program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. on Debian systems, the complete text of the GNU General Public License version 3 can be found in "/usr/share/common-licenses/GPL-3". 📜

---

⭐ SEE ALSO ⭐

bossa(1), bossash(1)

---

ngl if you got this far you're literally a systems girlie now. go flash something 💅

okay that's the whole thing bestie — this was bossac 1.3a, from February 2014, and you read it all. so proud of you 🥹💖✨