|
|
| (115 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| The AXIOM Beta Manual (ABM) can be downloaded in full, in various languages from [[AXIOM Beta/AXIOM Beta Manual/Versions]]
| |
|
| |
|
| Note: In some instances the instructions we have prepared are written in a manor that can be followed by people without a deep technical knowledge. If you are an advanced user please keep this in mind.
| |
|
| |
| Notes on Userspace: Arch Linux comes with systemd, which has one advantage that the boot process is incredibly fast. Standard tools such as sshd and dhcpcd have been preinstalled.
| |
|
| |
| One idea to store camera relevant parameters inside the camera and provide access from most programming languages is to use a database like [http://en.wikipedia.org/wiki/Berkeley_DB http://en.wikipedia.org/wiki/Berkeley\DB]
| |
|
| |
|
| |
| =General Information=
| |
|
| |
| ==AXIOM Beta Connector Overview==
| |
|
| |
| ToDo
| |
|
| |
|
| |
| ==Mountpoints==
| |
|
| |
| ToDo
| |
|
| |
|
| |
| ==Accessories and Connected Devices==
| |
|
| |
| ToDo
| |
|
| |
|
| |
|
| |
| =Operating Basics=
| |
| ==Getting Started==
| |
|
| |
| ===Prepare Your AXIOM Beta Camera for Use===
| |
| # Use a micro-USB cable to connect the camera's MicroZed development board (USB UART) to a computer. The MicroZed board is the backmost, red PCB. (There is another micro-USB socket on the Power Board, but that is the JTAG Interface.)
| |
| # Connect the ethernet port on the MicroZed to an ethernet port on your computer. You might have to use an ethernet adapter on newer, smaller machines which come without a native ethernet port.
| |
| # Connect the AC adapter to the camera's Power Board. (The power cord plugs into an adapter that connects to the Power Board; to power the camera off at a later point, you need not disconnect the adapter from the board but can just unplug the cord from the adapter.)
| |
|
| |
|
| |
| ===Prep your computer for use with your camera===
| |
|
| |
| [[File:BetaGuide.jpg | 500px| thumb | 550px]]
| |
|
| |
| To communicate with your AXIOM Beta camera, you will send it instructions via your computer's command line.
| |
|
| |
| In case you have not worked with a shell (console, terminal) much or ever before, we have prepared detailed instructions to help you get you set up. The steps which need to be taken to prepare your machine sometimes differ between operating systems, so pick the ones that are applicable to you(r system).
| |
|
| |
| Note that dollar signs <code>$</code> placed in front of commands are not meant to be typed in but denote the command line prompt (a signal indicating the computer is ready for user input). It is used in documentation to differentiate between commands and output resulting from commands. The prompt might look different on your machine (e.g. an angled bracket <code>></code>) and be preceded by your user name, computer name or the name of the directory which you are currently inside.
| |
|
| |
|
| |
| ====USB to UART drivers====
| |
| For the USB connection to work, you will need drivers for bridging USB to UART (USB to serial). (Under Linux this works out of the box in most distributions) for other operating systems they [https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx can be downloaded] from e.g. Silicon Labs' website – pick the software provided for your OS and install it.
| |
|
| |
|
| |
| ====Serial console====
| |
| The tool we recommend for connecting to the AXIOM Beta camera via serial port with Mac OS X or Linux is [http://linux.die.net/man/1/minicom minicom]; for connections from Windows machines, we have used [http://www.putty.org Putty].
| |
|
| |
|
| |
| =====Linux setup=====
| |
|
| |
| Check if you already have minicom installed on your system by trying to run it:
| |
| $ minicom
| |
|
| |
| Your system will respond with a message like <code>bash: command not found: minicom</code> if it's not installed.
| |
|
| |
| '''Install minicom'''
| |
|
| |
| Install the minicom package like you'd install other software on your system – which could be via a GUI tool or using <code>aptitude</code> or <code>apt-get</code> (for wich you might need super user rights), e.g.:
| |
|
| |
| $ apt-get install minicom
| |
| or
| |
| $ sudo apt-get install minicom
| |
|
| |
|
| |
| =====Mac OS X setup=====
| |
|
| |
| You will want to have [http://brew.sh/ Homebrew] installed on your system to use <code>minicom</code> for serial communication as it is more convenient than using <code>screen</code>.
| |
|
| |
| '''Note:''' Homebrew is a package manager for Mac - a piece of software that helps you install other software on your Mac machine, particularly software which is readily available on Linux but which does not come in the form of Mac "applications", which you can download via your web browser and simply drop into your Applications folder.
| |
|
| |
| Open Terminal.app (or your preferred terminal emulator if you have another installed). Terminal can be found via e.g. Spotlight search or via the Finder menu: <code>Go > Utilities > Terminal.app</code>.
| |
|
| |
| Check if you already have brew installed by entering the brew command:
| |
| $ brew
| |
|
| |
| If you don't have Homebrew installed, your shell will reply with something like <code>bash: command not found: brew</code>. Otherwise, it will spit out a list of <code>brew</code> commands.
| |
|
| |
|
| |
| '''Installing Homebrew'''
| |
|
| |
| To install Homebrew, go to the [http://brew.sh/ Homebrew] website and follow the install instructions there. You can simply copy the command used for installing Homebrew from their website and paste it into your terminal.
| |
|
| |
|
| |
| '''Installing minicom'''
| |
|
| |
| With brew installed, you want to install minicom:
| |
| $ brew install minicom
| |
|
| |
| Homebrew will tell you if you already have minicom installed on your system (e.g. <code>Warning: minicom-2.7 already installed</code>), otherwise it will install it for you.
| |
|
| |
|
| |
|
| |
| =====minicom configuration=====
| |
|
| |
| Once you have minicom installed, you need to configure it in order to talk to the camera. You can either use the configuration file we prepared or configure it yourself, following our step-by-step instructions.
| |
|
| |
| '''Linux'''
| |
|
| |
| Go to the minicom setup page:
| |
|
| |
| <pre>$ minicom -s</pre>
| |
|
| |
| In the "Serial port setup" subpage, check that "Serial Device" 's name is the good one (usually /dev/ttyUSB0 on Linux) and check the baud rate (115200).
| |
|
| |
|
| |
| '''Mac'''
| |
|
| |
| Download [[Media:Minirc.USB0_Mac.zip|the settings file for Mac]], unzip it and place it in the <code>etc</code> directory of your minicom install.
| |
|
| |
| The minicom installation can be found in the standard directory used by homebrew, <code>/usr/local/Cellar</code>, in a subdirectory based on the minicom version number, e.g. <code>/usr/local/Cellar/minicom/2.7/etc
| |
| </code>.
| |
|
| |
| You can also use Homebrew's <code>info</code> command to find minicom on your hard disk:
| |
|
| |
| <pre>$ brew info minicom</pre>
| |
|
| |
| which will output general information on the installed package, including its install directory e.g.:
| |
|
| |
| <pre>
| |
| minicom: stable 2.7 (bottled)
| |
| Menu-driven communications program
| |
| https://alioth.debian.org/projects/minicom/
| |
| /usr/local/Cellar/minicom/2.7 (17 files, 346.6K) *
| |
| Poured from bottle on ...</pre>
| |
|
| |
|
| |
|
| |
| ====Serial connection (via USB)====
| |
|
| |
| '''Note:''' You will not be able to use the terminal window you initiate the serial connection in for anything else (it needs to remain open while you access the camera), so it might make sense to open a separate window just for this purpose.
| |
|
| |
| ===== Connect using minicom =====
| |
|
| |
| With minicom installed and properly [[/minicom_configuration/|configured]], all you need to do is run the following command to start it with the correct settings:
| |
|
| |
| <pre>$ minicom -8 USB0</pre>
| |
|
| |
| On successful connection, you will be prompted to enter user credentials (which are needed to log into the camera).
| |
|
| |
| If your terminal remains blank except for the minicom welcome screen/information about your connection settings, try pressing enter. If this still does not result in the prompt for user credentials – while testing, we discovered the ''initial'' connection with minicom does not always work – disconnect the camera from the power adapter, then reconnect it: in your minicom window you should now see the camera's operating system booting up, followed by the login prompt. (From then on, connecting with minicom should work smoothly and at most require you to press enter to make the login prompt appear.)
| |
|
| |
| The default credentials are:
| |
| <pre>user: root
| |
| password: beta</pre>
| |
|
| |
| '''Alternatives'''
| |
|
| |
| Before you can use any tool to initiate a serial connection with your Beta camera you need to know through which special device file it can be accessed.
| |
|
| |
| Once the Beta is connected and powered on (and you installed the necessary drivers), it gets listed as a USB device in the <code>/dev</code> directory of your file system, e.g.<br>
| |
| <code>/dev/ttyUSB0</code> (on Linux)<br>or<br>
| |
| <code>/dev/cu.SLAB_USBtoUART</code><br>
| |
| <code>/dev/tty.SLAB_USBtoUART</code> (on Mac).
| |
|
| |
| You can use a command such as:
| |
| <pre>$ ls -al /dev | grep -i usb</pre>
| |
| to list all USB devices currently connected to your machine.
| |
|
| |
|
| |
| ===== Connect using screen =====
| |
|
| |
| To connect to the camera, use the command:
| |
| <pre>$ screen file_path 115200</pre>
| |
|
| |
| where <code>file_path</code> is the full path to the special device file (e.g. <code>/dev/ttyUSB0</code> or <code>/dev/cu.SLAB_USBtoUART</code>).
| |
|
| |
| You might have to run the command with superuser rights, i.e.:
| |
| <pre>$ sudo screen file_path 115200</pre>
| |
|
| |
| On successful connection, you will be prompted to enter user credentials needed for logging into the camera.<br>
| |
| If your terminal remains blank, try pressing enter.
| |
|
| |
| The default credentials are:
| |
| <pre>user: root
| |
| password: beta</pre>
| |
|
| |
| =====Disconnect=====
| |
| To exit the camera's operating system, use:
| |
| <pre>$ exit</pre>
| |
|
| |
| The result will be a logout message followed by a new login prompt.
| |
|
| |
| To suspend or quit your <code>screen</code> session (and return to your regular terminal window) use one of the following commands:
| |
| <pre>CTRL+a CTRL+z</pre>
| |
| <pre>CTRL+a CTRL+\</pre>
| |