/* * This file is part of the Micro Python project, http://micropython.org/ * * The MIT License (MIT) * * Copyright (c) 2015 Daniel Campora * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ #include "py/mpconfig.h" #include MICROPY_HAL_H #include "py/obj.h" #include "py/runtime.h" #include "inc/hw_types.h" #include "inc/hw_gpio.h" #include "inc/hw_ints.h" #include "inc/hw_memmap.h" #include "rom_map.h" #include "pin.h" #include "prcm.h" #include "gpio.h" #include "sdhost.h" #include "pybpin.h" #include "pybsd.h" #include "ff.h" #include "simplelink.h" #include "debug.h" #include "mpexception.h" #if MICROPY_HW_HAS_SDCARD #define PYBSD_FREQUENCY_HZ 15000000 // 15MHz typedef struct { mp_obj_base_t base; FATFS *fatfs; pin_obj_t *pin_d0; pin_obj_t *pin_clk; pin_obj_t *pin_cmd; pin_obj_t *pin_sd_detect; byte af_d0; byte af_clk; byte af_cmd; bool pinsset; bool enabled; bool inpath; } pybsd_obj_t; /****************************************************************************** DECLARE PRIVATE DATA ******************************************************************************/ STATIC pybsd_obj_t pybsd_obj; /****************************************************************************** DECLARE PRIVATE FUNCTIONS ******************************************************************************/ STATIC mp_obj_t pybsd_make_new (mp_obj_t type_in, mp_uint_t n_args, mp_uint_t n_kw, const mp_obj_t *args); STATIC mp_obj_t pybsd_disable (mp_obj_t self_in); STATIC mp_obj_t pybsd_enable (mp_obj_t self_in); /****************************************************************************** DECLARE PUBLIC FUNCTIONS ******************************************************************************/ __attribute__ ((section (".boot"))) void pybsd_init0 (void) { // allocate memory for the sd file system ASSERT ((pybsd_obj.fatfs = mem_Malloc(sizeof(FATFS))) != NULL); } bool pybsd_is_present(void) { if (pybsd_obj.pin_sd_detect) { return pybsd_obj.enabled && MAP_GPIOPinRead(pybsd_obj.pin_sd_detect->port, pybsd_obj.pin_sd_detect->bit); } return pybsd_obj.enabled; } void pybsd_deinit (void) { pybsd_disable ((mp_obj_t)&pybsd_obj); pybsd_obj.pin_sd_detect = NULL; } /******************************************************************************/ // Micro Python bindings // /// \classmethod \constructor() /// Configure the pins used for the sd card. /// May receive 0, 6 or 7 arguments. The 7th optional argument is the card detect pin. /// this pin needs no external pull-up and must be low when the sdcard is inserted. /// /// Usage: /// sd = pyb.SD() //// /// sd = pyb.SD(d0_pin, d0_af, clk_pin, clk_af, cmd_pin, cmd_af) /// /// and: /// /// sd = pyb.SD(d0_pin, d0_af, clk_pin, clk_af, cmd_pin, cmd_af, card_detect_pin) /// STATIC mp_obj_t pybsd_make_new (mp_obj_t type_in, mp_uint_t n_args, mp_uint_t n_kw, const mp_obj_t *args) { mp_arg_check_num(n_args, n_kw, 0, 7, false); if (n_args >= 6) { // get pins and afs pybsd_obj.pin_d0 = (pin_obj_t *)pin_find(args[0]); pybsd_obj.af_d0 = mp_obj_get_int(args[1]); pin_verify_af (pybsd_obj.af_d0); pybsd_obj.pin_clk = (pin_obj_t *)pin_find(args[2]); pybsd_obj.af_clk = mp_obj_get_int(args[3]); pin_verify_af (pybsd_obj.af_clk); pybsd_obj.pin_cmd = (pin_obj_t *)pin_find(args[4]); pybsd_obj.af_cmd = mp_obj_get_int(args[5]); pin_verify_af (pybsd_obj.af_cmd); // configure the sdhost pins // TODO: all pin configs must go through pin_config() MAP_PinTypeSDHost(pybsd_obj.pin_d0->pin_num, pybsd_obj.af_d0); MAP_PinTypeSDHost(pybsd_obj.pin_clk->pin_num, pybsd_obj.af_clk); MAP_PinDirModeSet(pybsd_obj.pin_clk->pin_num, PIN_DIR_MODE_OUT); MAP_PinTypeSDHost(pybsd_obj.pin_cmd->pin_num, pybsd_obj.af_cmd); // enable pull-ups on data and cmd // TODO: all pin configs must go through pin_config() MAP_PinConfigSet(pybsd_obj.pin_d0->pin_num, PIN_STRENGTH_4MA, PIN_TYPE_STD_PU); MAP_PinConfigSet(pybsd_obj.pin_cmd->pin_num, PIN_STRENGTH_4MA, PIN_TYPE_STD_PU); // card detect pin was provided if (n_args == 7) { pybsd_obj.pin_sd_detect = (pin_obj_t *)pin_find(args[6]); pin_config (pybsd_obj.pin_sd_detect, PIN_MODE_0, GPIO_DIR_MODE_IN, PIN_TYPE_STD_PU, PIN_STRENGTH_4MA); } pybsd_obj.pinsset = true; } else if (n_args == 0) { if (!pybsd_obj.pinsset) { nlr_raise(mp_obj_new_exception_msg(&mp_type_TypeError, mpexception_num_type_invalid_arguments)); } } else { nlr_raise(mp_obj_new_exception_msg(&mp_type_TypeError, mpexception_num_type_invalid_arguments)); } // TODO: register with the sleep module!! pybsd_obj.base.type = &pyb_sd_type; return &pybsd_obj; } /// \method enable() /// Enables the sd card and mounts the file system STATIC mp_obj_t pybsd_enable (mp_obj_t self_in) { pybsd_obj_t *self = self_in; // Enable SD peripheral clock MAP_PRCMPeripheralClkEnable(PRCM_SDHOST, PRCM_RUN_MODE_CLK | PRCM_SLP_MODE_CLK); // Reset MMCHS MAP_PRCMPeripheralReset(PRCM_SDHOST); // Initialize MMCHS MAP_SDHostInit(SDHOST_BASE); // Configure the card clock MAP_SDHostSetExpClk(SDHOST_BASE, MAP_PRCMPeripheralClockGet(PRCM_SDHOST), PYBSD_FREQUENCY_HZ); self->enabled = true; // try to mount the sd card on /SD if (FR_OK != f_mount(self->fatfs, "/SD", 1)) { nlr_raise(mp_obj_new_exception_msg(&mp_type_OSError, mpexception_os_operation_failed)); } mp_obj_list_append(mp_sys_path, MP_OBJ_NEW_QSTR(MP_QSTR__slash_SD)); mp_obj_list_append(mp_sys_path, MP_OBJ_NEW_QSTR(MP_QSTR__slash_SD_slash_LIB)); self->inpath = true; return mp_const_none; } STATIC MP_DEFINE_CONST_FUN_OBJ_1(pybsd_enable_obj, pybsd_enable); /// \method disable() /// Disables the sd card and unmounts the file system STATIC mp_obj_t pybsd_disable (mp_obj_t self_in) { pybsd_obj_t *self = self_in; if (self->enabled) { self->enabled = false; // unmount the sd card f_mount (NULL, "/SD", 1); // remove sd paths from mp_sys_path if (self->inpath) { mp_obj_list_remove(mp_sys_path, MP_OBJ_NEW_QSTR(MP_QSTR__slash_SD)); mp_obj_list_remove(mp_sys_path, MP_OBJ_NEW_QSTR(MP_QSTR__slash_SD_slash_LIB)); self->inpath = false; } // disable the peripheral MAP_PRCMPeripheralClkDisable(PRCM_SDHOST, PRCM_RUN_MODE_CLK | PRCM_SLP_MODE_CLK); } return mp_const_none; } STATIC MP_DEFINE_CONST_FUN_OBJ_1(pybsd_disable_obj, pybsd_disable); STATIC const mp_map_elem_t pybsd_locals_dict_table[] = { { MP_OBJ_NEW_QSTR(MP_QSTR_enable), (mp_obj_t)&pybsd_enable_obj }, { MP_OBJ_NEW_QSTR(MP_QSTR_disable), (mp_obj_t)&pybsd_disable_obj }, }; STATIC MP_DEFINE_CONST_DICT(pybsd_locals_dict, pybsd_locals_dict_table); const mp_obj_type_t pyb_sd_type = { { &mp_type_type }, .name = MP_QSTR_SD, .make_new = pybsd_make_new, .locals_dict = (mp_obj_t)&pybsd_locals_dict, }; #endif // MICROPY_HW_HAS_SDCARD