Open Aceinna Navigation Platform

Description

Open-ANS is a highly-efficient software stack for the development of navigation systems:

• Powerful cross-platform and open-source IDE
• Effiecient source code control
• Affordable debugging tool (ST-Link)

Table of Contents

• Hardware requirements
• Software requirements
• Installation
• Build firmware
• Firmware upgrade
• Debug
• Data Record
• Contributions
• License

Hardware requirements

• Aceinna's Dev Kit
• ST-Link V2

Software requirements

• Windows, Mac or Linux OS
• VSCode source code editor (open source)
• Aceinna Navigation Studio (extension for VSCode)
• ST-Link driver
• Aceinna's utility based upon Python

Installation

• Install VSCode source code editor
• Install Aceinna Navigation Studio extension for VSCode
• Install ST-link V2 driver (Windows only)

Build firmware

• Open VSCode source code editor
• Click "Home" button on the bottom of Aceinna Navigation Studio
• Choose "Open Project" (if you have already Aceinna IMU project) or import pre-configured project from "Custom IMU examples"
• Click "Build" button on the bottom of Aceinna Navigation Studio

Firmware upgrade

• Click "Upload" button on the bottom of Aceinna Navigation Studio.

Debug

• Create a PlatformIO Account using "Home" button and "PIO Home > Account" menu
• Press "F5" or choose "Debug" in VSCode menu
• Open "Debug" view at left bar.

Data Record

• Install Git
• Install Python Interpreter
• Open system terminal and install Aceinna's utilities

  git clone https://github.com/Aceinna/python-imu380

• Install Python dependencies

  pip install pyserial tornado azure-storage-blob

• Connect IMU Dev board to PC
• Change current directory to cd python-imu380
• Run python demo.py

Contribution

Please refer to each project's style guidelines and guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow.

• Fork the repo on GitHub
• Clone the project to your own machine
• Commit changes to your own branch
• Push your work back up to your fork
• Submit a Pull request so that we can review your changes

License

ANS open source projects is licensed under the Apache 2.0 license.

ANS does not require you to assign the copyright of your contributions, you retain the copyright. ANS does require that you make your contributions available under the Apache license in order to be included in the main repo.

If appropriate, include the Apache 2.0 license summary at the top of each file along with the copyright info. If you are adding a new file that you wrote, include your name in the copyright notice in the license summary at the top of the file.

Copyright (C) 2018 Aceinna Navigation System Open Source Project

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.